Links

New Canvas (Beta)

Learn more about the new pipeline building environment on the Digibee Integration Platform.
IMPORTANT: Currently, the new version of Canvas is only available in Beta phase. To learn more about this, read the article Beta program.
Canvas is the pipeline development environment of the Digibee Integration Platform. Using Canvas, you can build integration flows by dragging and dropping preconfigured components.
The New Canvas brings improvements in terms of navigation and pipeline building experience.
Note: Both versions of Canvas will be available for users indefinitely. Support will be available for both versions.

How to use New Canvas

To use New Canvas, go to the Build tab and click USE NEW CANVAS.
This warning will also appear in any pipelines created in the old Canvas. If you click USE NEW CANVAS, you will be redirected to New Canvas and the pipeline will be transferred to the new version without losing any components or their configurations, and without having to redeploy the pipeline.
You can also access the New Canvas on the Build tab by clicking +CREATE and Pipeline Beta.
Note: You can copy and paste elements from the old Canvas into the New Canvas.
The New Canvas tag will be highlighted in blue on the header:

Pipeline settings

Before you start creating your integration flow, you need to configure the pipeline. To do this, click the gear icon (
) in the upper right corner of Canvas.
At the pipeline settings, if necessary, configure the following fields:
  • Description: pipeline description.
  • “Is it multi-instance?”: activate this option if the pipeline to be created is multi-instance. To learn more about this feature, read the article Multi-Instance.
  • Sensitive field: data fields that should be hidden during the execution of the flow.
  • InSpec: pipeline input.
  • OutSpec: pipeline output.
Once the pipeline is configured, you can start building the flow

Create a flow

Each pipeline consists of a trigger connected to at least one component. On Canvas, you can organize and configure the trigger and components of your pipeline according to your business needs.

Trigger

To create a flow, first select a trigger. The trigger defines what starts the execution of the pipeline - for example, an event, or scheduling.
To set up the trigger, click the gear icon on the trigger (
) and choose from the listed options, as shown in the example below:

Components

The components represent steps in the integration flow. You should use them according to your business needs. A list of components is available on the right side of the Canvas.
Note: Using this new version of Canvas, you can connect components more easily using the magnetic arrow.
To delete a connection or a specific component of the flow, click the trash can icon (
) and then, the X icon .
To configure the component to be used, click the gear icon (
) to see the configuration form. In the example below, you can see the form for the Google Drive component.
To learn more about each component available on our list, visit our Components documentation.

Pipeline navigation

In addition to the features presented in this article, New Canvas also offers other features that are related to the pipeline navigation experience. To learn more about this, read the article Pipeline navigation.

Pipeline building validation

The New Canvas displays alerts when you’re building a pipeline. These alerts help developers identify and fix common issues faster. To learn more about this, read the article Pipeline building validation.

Test the pipeline

Using Test mode, you can run and test your pipeline directly from the development area. Use this feature to evaluate, debug, and troubleshoot the integration flow. To learn more about this feature, read the article Test mode.

Save the pipeline

After you have created your integration flow, click SAVE in the upper right corner of the screen and specify a name, description (optional) and the project in which the pipeline will be allocated.
Note: If your pipeline is showing Error alerts, the SAVE button will be blocked, so you can not save it.

Additional Information

During the coexistence of the two versions of Canvas, you can move your pipeline back to the old Canvas. To do this, open your pipeline in New Canvas, click the help menu and then, the New Canvas Support option.
Then, simply answer why you would like to use the old Canvas and click CHANGE.
IMPORTANT: disconnected components created in the new Canvas will be lost after you move back to the old Canvas.