Pipelines

• 1 minute to read

A processing pipeline is a set of step-by-step instructions, which defines how to process a personalized design in an order. Each step is called a task. It describes an action that needs to be taken to reach the final result. For example, when processing business cards, you can:

1. Take the personalized design of a card from the project.
2. Then, render it with certain parameters to produce a proper print file.
3. Then, perform imposition by composing multiple copies of a print file in a single page.
4. Finally, we upload the result to the FTP of a printing company.

Configuring a pipeline

You can configure pipelines in your Customer's Canvas account through the user interface. Once configured, a processing pipeline can be attached to both a product specification and a PIM product.

For more details, refer to the How to create pipelines tutorial.

Running the pipelines

When configuring a pipeline, you can choose when it should start. By default, it starts when a project is created, but you can also start it when the project status changes, for example, after the order is confirmed and paid or when it moves to the active status.

Since processing pipelines automatically start executing, you do not need to run them. If, for some reason, a pipeline has stopped, you can then continue execution of the remaining tasks using the endpoint Projects_ResumeProjectProcessing. To restart a stopped pipeline from the beginning, use the endpoint Projects_RestartProjectProcessing.

Viewing pipeline runs

You can only browse pipeline runs in your Customer's Canvas account through the user interface. To do so, navigate to the Projects section, click your project, and scroll the page down to the Pipelines.

Here, you may find useful information like the pipeline creation time, task names and statuses, and the time spent on each task.