Learn how to test your pipelines or capsules using the Execution Panel on the Digibee Integration Platform.
This feature was named "Test mode" until June 2023.
The Execution Panel allows you to test a pipeline or capsule in the test environment while designing the flow. It uses test values from the Globals, Accounts, Relationship, and Multi-Instance services.
This feature helps you validate implementation logic and debug the flow in real time, without needing to deploy it first.
Execution Panel overview
You can open the Execution Panel from the lower-left corner of the Canvas or by pressing Cmd (or Ctrl) + D.
The panel includes four tabs:
Payload: Input test data
Results: Review input, output and test results
Messages: Inspect each connector’s output
Logs: Track events and errors
Learn more about each tab:
Payload tab
In this tab, you can define the test payload used during execution. It allows you to:
Select a specific instance: When a pipeline is configured as multi-instance, the Multi-instance dropdown is displayed so you can choose the instance for the test. For more details, see the Multi-Instance documentation.
Save the payload: You can save a payload for later use. Click the save icon and assign a name to it. Saved payloads are specific to each pipeline or capsule and are not shared across different flows.
Once saved, the payloads appear in the Payloads column. You can Delete or Apply a payload. Saved payloads cannot be edited. If you make changes, you must save them as a new payload.
Format the JSON: For better readability, use the magic wand icon to automatically format the JSON.
When running an execution in a capsule, the Parameters column is displayed. There, you should input the parameters and account values according to the capsule’s configuration.
Results tab
Once the test is executed, the output appears in the Results tab, a read-only view of the pipeline’s input and output data. Here, you can:
Copy the JSON output to your clipboard.
Search specific elements in the JSON output using a JSONPath expression.
This tab is also particularly useful during test case execution, as any assertion failures are shown here for easier validation.
Messages tab
The Messages tab shows the execution result of each connector in the pipeline, up to 5,000 messages. Each connector receives the payload from the previous one, processes it based on its function, and generates a new payload in response.
List of messages: The message list includes the message name, which corresponds to the connector’s Step Name, and the connector’s execution time in milliseconds. You can also search by full or partial message name, or by a connector parameter.
Message preview: In the message preview, you can download the JSON output as a file, copy it to your clipboard, or use a JSONPath expression to filter specific elements in the JSON output.
Logs tab
The Logs tab contains information about the event logs generated during pipeline execution in the Execution Panel. In this tab, you can filter logs by type, copy any log message, and search for specific logs by entering part or all of the message content.
The log list displays the following details:
Log type: The classification of the log, indicated by an icon. Available types:
Info: Informational logs
Warning: Logs that indicate warnings
Error: Logs that capture errors during execution
Timestamp: The date and time the step was executed in the pipeline
Log message: The message content of each log
In addition to running tests, you can also import and export execution files directly from the panel.
Import
Click Import execution to upload a file with execution data.
Imported execution data appears in the panel, but currentFlowSpec and executedFlowSpec are not shown in the Canvas.
You can only re-run the execution if you're in the same pipeline it came from, and the original flow still exists.
Export
Click Export execution to download a file containing the pipeline configuration and execution data. Make sure all data is fully loaded before exporting to avoid missing information.
The exported file includes:
pipelineId and pipelineName
currentFlowSpec: Flow from Canvas as it was at the time of export
executedFlowSpec: Flow as it was at the time of execution
realm: Pipeline realm
execution: Payload, Output, Messages, and Logs
If no execution was run, only pipeline metadata is exported.
Executing the flow
By executing a flow, you can test and validate your pipeline or capsule to make sure it works as expected. You can execute the entire flow or just part of it, depending on your needs.
How to execute the entire flow
You can execute the entire flow using one of the following methods:
Press Cmd (Ctrl) + Enter.
Open the Execution panel and click Play.
Open the Execution panel, click the dropdown next to Play, and select Run pipeline or Run capsule.
Regardless of any selected connectors, these options will always execute the entire flow.
How to execute part of the flow
To execute a specific part of the flow:
Step 1: Select the connectors
Choose the connectors you want to execute using one of these methods:
Hold Shift and drag the mouse over the desired connectors.
Hold Shift and click each connector individually.
For a selection to be valid, the chosen connectors must be connected and in sequence. Skipping a connector in the middle of the sequence will invalidate the selection.
Step 2: Execute the selection
After selecting the connectors, you can execute the flow in two ways:
Press Cmd (Ctrl) + Shift + Enter.
Open the Execution panel, click the dropdown next to Play, and select Run selected steps.
How to execute from a specific step
You can start the pipeline execution from any chosen step, ensuring that all subsequent steps in the flow are executed. To do this, follow these steps:
Click the connector where you want the execution to begin.
Open the Execution panel.
Click the dropdown next to Play and select Run from step. You can also use the shortcut Ctrl + Alt + Enter for Windows or Cmd (⌘) + Option (⌥) + Enter for macOS.
The pipeline is then executed from the selected step and continues with the remaining flow.
Additional information
Below you will find some important details about the Execution panel and useful keyboard shortcuts.
Execution panel inactivity
If you don’t access the Execution panel for 24 hours, it will become inactive. When you reopen the Canvas, it may take up to 3 minutes for the Execution panel to become active again.
Keyboard shortcuts
macOS
⌘ + D: Open or close the Execution Panel
⌘ + Enter: Execute the entire flow
⌘ + Shift + Enter: Execute the selected connectors
⌘ + ⌥ + Enter: Execute from the selected step
Windows
Ctrl + D: Open or close the Execution Panel
Ctrl + Enter: Execute the entire flow
Ctrl + Shift + Enter: Execute the selected connectors
Ctrl + Alt + Enter: Execute from the selected step