NiFi Ingest 26.1
NiFi Ingest

# Ingest JSON

Many systems export data in JSON format. This section describes how to ingest JSON using NiFi Ingest.

The steps in this section assume that:

- You have one or more files each of which contains JSON that should be parsed into one or more Knowledge Discovery documents.
- The data is not necessarily in Knowledge Discovery document format.

To ingest data in JSON format

1. Add a GetFileSystem processor to your data flow to retrieve the JSON file(s).

   - Configure the location of your JSON files by setting the property "Directory Paths". If the folder contains other files, you could also set "File name pattern" to `*.json`.
   - If you are running a NiFi cluster, set the dynamic property `adv:FlowFileEmbedFiles` to TRUE. For more information about this property, see Advanced Connector Properties.
2. Add a ConvertJSONToDocuments processor to the data flow.
3. Connect the "success" relationship of the GetFileSystem processor to the ConvertJSONToDocuments processor.

4. Configure the ConvertJSONToDocuments processor.

   1. Right-click the processor and click Configure.

      The Edit Processor dialog box opens.

   2. Click the Properties tab.
   3. Set the JSON Parsing Config property. This accepts a collection of configuration parameters that specify how to construct documents from the JSON data. The parameters that you can use are the same as those in the `[JSONParsing]` section of the CFS configuration file. (When configuring the NiFi processor, do not include the `[JSONParsing]` section header). For more information about these parameters, refer to the Connector Framework Server Reference.
   4. Click APPLY.

5. Connect the "extracted" relationship of the ConvertJSONToDocuments processor to your ingestion pipeline.

   TIP: After they are processed, the original FlowFiles that were routed to the ConvertJSONToDocuments processor are routed to the "processed" relationship.

   To avoid indexing documents representing the original JSON files, you could auto-terminate this relationship. However, if you are using a document registry service to ensure that documents are indexed in the correct sequence, route the "processed" relationship to an UnregisterDocument processor. For more information about the document registry service, see Index Documents in the Correct Sequence.

6. Start the GetFileSystem and ConvertJSONToDocuments processors.

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: Ingest JSON