Adds a dropdown selector column. The user’s selection triggers a POST request (POST /action/{activityKey}). Populate the dropdown using either options (manually defined) or optionsCodetableKey (codelist reference) — not both. If the action fails, the pipeline error message is shown in the notification toast; a generic error is used as fallback if no message is returned.

Minimal JSON

{
    "type": "customActionSelectBox",
    "activityKey": "",
    "pipelineKey": "",
    "valueKey": ""
}
{
    "type": "customActionSelectBox",
    "activityKey": "my_action_set_method",
    "optionsCodetableKey": "my_action_method",
    "pipelineKey": "my_pipeline",
    "tableIdsToRefresh": ["table_id"],
    "title": "template.my_action.column.method",
    "tooltipKey": "template.my_action.tooltip.set_method",
    "valueKey": "example_column"
}
{
    "type": "customActionSelectBox",
    "activityKey": "my_action_set_method",
    "options": [
        {
            "label": "Method 1",
            "value": "method_1"
        },
        {
            "label": "Method 2",
            "value": "method_2"
        }
    ],
    "pipelineKey": "my_pipeline",
    "tableIdsToRefresh": ["table_id"],
    "title": "template.my_action.column.method",
    "tooltipKey": "template.my_action.tooltip.set_method",
    "valueKey": "example_column"
}

Nested properties

PropertyDescriptionValuesMandatory
activityKeyKey for the triggered action. For more information, see activities.stringYes
pipelineKeyPipeline key. For more information, see pipeline.stringYes
optionsManually defined dropdown options. It also enables the column’s filter dropdown. Mutually exclusive with optionsCodetableKey.arrayYes* (if optionsCodetableKey isn’t defined)
optionsCodetableKeyKey of the codetableValues asset used to generate options. Mutually exclusive with options. For more information, see codetableValues.stringYes* (if options isn’t defined)
valueKeyResult column this dropdown is bound to. Drives the current value display, sorting, and filtering. If the column is not found, the dropdown shows empty.stringYes
tableIdsToRefreshList of table IDs to refresh after a successful action.arrayNo
titleTranslation key of the title. Define the key in translations to specify how the text is displayed in the UI. Unlike the name property, if you use a specific string of text for the title, this text will appear with the package key. For example, Comment Section will be displayed as package_key_comment section.stringNo
tooltipKeyTranslation key of the tooltip that appears when hovering over the property. Define in translations to specify how the text is displayed in the UI.stringNo