In this article
A Pipeline that you can create specifically for handling errors—it processes error documents produced by other Pipelines in your environment. The Error Pipeline runs even if errors are not encountered in the Snaps from the main Pipeline.
Nested Pipelines are not supported.
You can configure the error view in your Snaps to handle errors in one of the following ways:
You can create an Error Pipeline the same way as you create your regular Pipeline. See Creating a Pipeline for more information. However, an Error Pipeline must have a single unlinked document input view. The error documents from the main Pipeline are sent into this view.
When creating an Error Pipeline for an Ultra Pipeline with unlinked views, your Ultra Pipeline must have an unlinked output view and produce output documents that can be used as the response to the original request. |
You can invoke the Error Pipeline from any given Pipeline from the same dialog (similar to the way that child Pipelines are invoked).
|
On the Snap's context menu, click Link Output to Error Pipeline. The Snap displays err in the Snap's connector. Remember to have a single unlinked document input view to allow error documents from the main Pipeline to be sent to this view.
Verify all the Snaps in the Pipeline are configured. Snaps with a default Error View are automatically updated when you add an Error Pipeline, but you can still add a custom Error View to a Snap.
Snaps are automatically updated when you add an Error Pipeline, but you can still add a custom Error View to a Snap.
If you need to customize an error document before sending it to the Error Pipeline, you can change the Snap to Route Error Data to Error View and then add any Snaps needed to do the customizations.
After you add the Snaps, you can then connect their unlinked output views to the Error Pipeline by selecting Route to Error Pipeline from the Snap's context menu.
When you link a Snap output view to the Pipeline Error View, the Integration Assistant is disabled. |
Having Error Pipelines is an efficient way to handle error data of your Pipelines, which enables you to read the errors in a single log and take further action.
This is typically a two step process:
Creating and configuring the main Pipeline.
Creating and configuring the Error Pipeline.
Create a simple Pipeline containing the JSON Generator and Mapper Snaps.
err
in the Mapper connector.Create a Pipeline containing the Mapper, JSON Formatter, and File Writer Snaps.
Next, we connect a JSON Formatter Snap to the Mapper Snap to format the document output into JSON format and write the file to SL database using the File Writer Snap.
Now we have completed the configuration of both the Main and Error Pipelines.
Run the Main Pipeline to route the error data the Error Pipeline.
After you run, you will see the following error in the preview of the Pipeline Execution Statistics.
You can navigate to the SnapLogic Dashboard to view the Pipeline details.