Create a custom action to throw an error

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture

    • Create an action that intentionally throws an error to test flow error handling.

    Avant de commencer

    Role required: flow_designer, action_designer, or admin

    Pourquoi et quand exécuter cette tâche

    This custom action throws an error when the action input value is set to 1. Any other input value allows the action to run without throwing an error. You can add this custom action to a flow to test flow error handling.

    Procédure

    1. Navigate to All > Process Automation > Flow Designer.
      The system displays the Workflow Studio landing page.
    2. Select New > Action
      The system displays the Action Properties dialog.
    3. Enter these sample values.
      Field Value
      Name Throw an error
      Application Global
      Accessible From All application scopes
    4. Select Submit.
      The system displays the Workflow Studio interface.
    5. From the Action Outline, select Inputs > Create Input
      The system displays a new action input.
    6. Configure the action input with these values.
      Field Value
      Label Error Code
      Type Integer
      Mandatory True
    7. From the Action Outline, select Add a new step.
      The system displays a list of available steps.
    8. Select Script step.
    9. From the Input Variables section, select Create Variable.
    10. Configure the variable with these values.
      Field Value
      Name code
      Value Select the data pill [action->Error Code]
    11. In Script, enter this JavaScript code. 
      (function execute(inputs, outputs) {
  if (inputs.code == 1) {
      throw 'My custom error message'
      }
})(inputs, outputs);
    12. Click Save.
      Action outline and configuration of the sample action Throw an error.
    13. Select Test.
      The system displays the Test Action dialog.
    14. Enter the following test value:
      Input Value
      Error Code 1
    15. Select Run Test.
      The system runs the action with the test values provided.
    16. Select Your test has finished running. View the action execution details.
      The system displays the action execution details.
    17. Verify that the action ran the Script step and threw your custom error message.
      The Action Status object should list an error on line 3 and display the text of your custom error message.

      Action execution details for a test run of Throw an error.

    18. Close the action execution details.
    19. Select Cancel to stop testing the action.
    20. Select Publish to make your custom action available to your flows.

    Résultats

    You have a custom action that throws an error when you set the action input Error Code to 1.

    Que faire ensuite

    Add this action to a flow to test the contents of the Error Handler section.