CustomActionType Property

Version: Available or changed with runtime version 10.0.

Sets the type of the custom action.

Applies to

  • Page Custom Action

Property Value

Value Available or changed with Description
Flow runtime version 10.0 An action that can trigger a Power Automate Flow.
FlowTemplate runtime version 11.0 An action that can trigger a Power Automate template editor to create a new Flow from a specific template.
FlowTemplateGallery runtime version 11.0 An action that can trigger a Power Automate template gallery to create a new Flow from a selection of templates.

Remarks

To learn more about Power Automate flows with Business Central, see Power Automate Integration Overview.

Examples

The following examples illustrate the syntax of the three custom action types. The first example extends the Customer Card page with a promoted action that runs a Power Automate flow that has the flow ID 11111111-aaaa-2222-bbbb-333333333333.

pageextension 50100 CustomerCardExt extends "Customer Card"
{
    actions
    {
        
        addlast(processing)
        {
            customaction(MyFlowAction)
            {
                ApplicationArea = All;
                CustomActionType = Flow;
                FlowId = '11111111-aaaa-2222-bbbb-333333333333';
                FlowEnvironmentId = 'Default-44444444-cccc-5555-dddd-666666666666';
            }
        }
        addfirst(Promoted)
        {
            actionref(MyFlowPromoted; MyFlowAction)
            {
            }
        }

    }
}

This next code example extends the Customer Card page with a promoted action that triggers opening a specific Power Automate template wizard directly. The FlowTemplateId property specifies, which template wizard to open.

pageextension 50100 CustomerCardExt extends "Customer Card"
{
    actions
    {
        
        addlast(processing)
        {
            customaction(MyFlowAction)
            {
                ApplicationArea = All;
                CustomActionType = FlowTemplate;
                FlowTemplateId = '11111111-aaaa-2222-bbbb-333333333333';
                FlowCaption = 'Create a Power Automate flow using a template';
            }
        }
        addfirst(Promoted)
        {
            actionref(MyFlowPromoted; MyFlowAction)
            {
            }
        }

    }
}

This third code example likewise extends the Customer Card page with a promoted action, this time it triggers opening the Power Automate template gallery wizard for the user to create a new Flow from a selection of templates. The FlowTemplateCategoryName property sets the category used to filter the list of Power Automate templates shown in the template gallery.

pageextension 50100 CustomerCardExt extends "Customer Card"
{
    actions
    {
        
        addlast(processing)
        {
            customaction(MyFlowAction)
            {
                ApplicationArea = All;
                CustomActionType = FlowTemplateGallery;
                FlowTemplateCategoryName = 'd365bc_approval_generalJournal';
                FlowCaption = 'Select and create a Power Automate flow using a template';
            }
        }
        addfirst(Promoted)
        {
            actionref(MyFlowPromoted; MyFlowAction)
            {
            }
        }

    }
}

See Also

Getting Started with AL
Developing Extensions