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
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
optionsManually defined dropdown options. Mutually exclusive with optionsCodetableKey.arrayConditional
optionsCodetableKeyKey of the codetableValues asset used to generate options. Mutually exclusive with options. For more information, see codetableValues.stringConditional
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