In this article

What is an Error Pipeline?

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.

Benefits of an Error Pipeline

• Allows you to write the errors of all your Pipelines (in production) to a single document for ease in resolving those errors. 
• Allows you to standardize error handling across your Pipelines. 

Limitation

Nested Pipelines are not supported.

Handling Errors

You can configure the error view in your Snaps to handle errors in one of the following ways:

• Route to Error Pipeline: Select this option to route the errors to an Error Pipeline.
• Discard Error Data and Continue: Discards errors if any and continues with the Snap execution.
• Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

Image RemovedImage Added

Creating an Error Pipeline

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. 

Adding an Error Pipeline to a Parent Pipeline

1. Open the main the main Pipeline and click the the Edit Pipeline Pipeline Properties  icon. By default, the dialog opens the Settings tab.
2. On the Error Pipeline list, select the Error Pipeline to which you want to route the errors.
   
   
3. Enter the Error Pipeline Parameters (key-value pairs) to evaluate and pass to the Error Pipeline. 
4. Click Save to save the Pipeline for reuse. A confirmation prompt appears, informing you that default error behavior will change. Click Yes to confirm and No to close the dialog.

...

Viewing the Error Pipeline from a Main Pipeline

1. In the main Pipeline, click the Edit Pipeline Properties Image Modified icon to open the Edit Pipeline dialog.
   Image Modified
   
2. Click View Error Pipeline.
   Image Modified
   The selected Pipeline is displayed.
   Image Modified
   
   

Linking Output to Error Pipeline

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.
Image ModifiedImage Modified

Verifying the Snap Configuration

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.  

1. Select Edit from the Snap context menu.
2. Verify that Route to Error Pipeline is selected. 

Snaps are automatically updated when you add an Error Pipeline, but you can still add a custom Error View to a Snap.  

Adding Output to an Error Pipeline

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.