NiFi Ingest 26.1
NiFi Ingest

# Write Failed Documents to Disk

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 each of the processors. This section describes how to route "failed" FlowFiles to a processor that will write the documents to disk in IDX, XML, or JSON format.

To write failed documents to disk

1. Add a WriteDocument processor to the canvas.

2. Create a connection from each of the processors to the WriteDocument processor. Hover the mouse over a processor (such as KeyViewExtractFiles or KeyViewFilterDocument) until you see the connection icon - - and then drag the icon to the WriteDocument processor. When the Create Connection dialog box opens, look for the For Relationships area and select the failure check box. Then repeat this for your other processors.

3. Right-click the WriteDocument processor and click Configure.

   The Configure Processor dialog box opens.

4. Click the Properties tab.

5. Set the following properties:

   IDOL License Service | The name of your License Service.
   Format | The format in which to write the document (for example IDX or XML).
   File in which to write the document | The path of the file to write the documents to. This could be a path to a shared folder.
   Archive Directory | The path in which files are archived when they exceed the maximum size.
   Max file size in bytes before archiving | The maximum size a file can reach before being archived.

6. Click the Relationships tab.
7. In this example, there is nothing to do after writing the failed documents, so select the terminate check box for each relationship (failure, original, and written).

8. Click Apply.

   The pipeline should now look similar to the example described in the introduction.

Copyright 2018-2025 Open Text
Version 26.1 | Last updated January 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.1

Topic Title: Write Failed Documents to Disk