NiFi Ingest 26.3
NiFi Ingest

# Handle Failed Documents

You cannot start a processor until all of its relationships are connected to other processors, or are auto-terminated. So far, this example has not connected or auto-terminated the "failed" relationship for the new processors that you added.

This section shows how to route failed documents to an output port. If nothing takes data from the output port and the output port remains stopped, any failed documents wait indefinitely in the preceding queue. You can periodically check the queue to determine the cause of the failures and, if necessary, empty the queue.

To handle failed documents

1. Add an output port, by dragging the output port icon from the components toolbar to the canvas.

   The Add Port dialog box opens.

2. In the Output Port Name box, type a name for the output port and click ADD.

   The output port is added to the canvas.

3. Create a connection from the KeyViewRouteOnFileType processor to the output port and select the failure relationship.
4. Create a connection from the AnalyzeMedia processor to the output port and select the failure relationship.

Copyright 2018-2026 Open Text
Version 26.3 | Last updated July 2026

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery NiFi Ingest 26.3

Topic Title: Handle Failed Documents