Splitting documents

​

Prerequisites

1. Access Permissions: Ensure that you have the necessary permissions to use the Documents Plugin. The user account used for these operations should have the required access rights.
2. Kafka Configuration: Verify that the Kafka messaging system is properly configured and accessible. The Documents Plugin relies on Kafka for communication between nodes.

• Kafka Topics: Familiarize yourself with the Kafka topics used for these operations (later in this section)

3. Before initiating the splitting process, ensure you have the unique ID of the file in the storage solution. This ensures that the splitting is performed on an already uploaded file.

• Extract the file ID from a Response Message of an upload file request. For more details, refer to the upload process documentation.
• Extract the file ID from a Response Message of a generate from template request. For more details, refer to the document generation reply documentation.

{
  "customId": "119407",
  "fileId": "446c69fb-32d2-44ba-a0b2-02dbb55e7eea",
  "documentType": "BULK",
  "documentLabel": null,
  "minioPath": "flowx-dev-process-id-119407/119407/465_BULK.pdf",
  "downloadPath": "internal/files/446c69fb-32d2-44ba-a0b2-02dbb55e7eea/download",
  "noOfPages": null,
  "error": null
}

​

Configuring the splitting process

1. Create a process that includes a Send Message Task (Kafka) node and a Receive Message Task (Kafka) node:

• Use the Send Message Task node to send the splitting request.
• Use the Receive Message Task node to receive the splitting reply.

2. Configure the first node (Send Message Task) by adding a Kafka Send Action.
3. Specify the Kafka topic where you want to send the splitting request.

To identify your defined topics in your current environment, follow the next steps:

1. From the FLOWX.AI main screen, navigate to the Platform Status menu at the bottom of the left sidebar.
2. In the FLOWX Components list, scroll to the document-plugin-mngt line and press the eye icon on the right side.
3. In the details screen, expand the KafkaTopicsHealthCheckIndicator line and then details → configuration → topic → document → split. Here you will find the in and out topics for splitting documents.

4. Fill in the body of the message request.

​

Message request example

{
  "parts": [
    {
      "documentType": "BULK",
      "customId": "119407",
      "pagesNo": [
        1,
        2
      ],
      "shouldOverride": true
    }
  ],
  "fileId": "446c69fb-32d2-44ba-a0b2-02dbb55e7eea"
}

• fileId: The file ID of the document that will be split
• parts: A list containing information about the expected document parts
  • documentType: The document type.
  • customId: The unique identifier for your document (it could be for example the ID of a client)
  • shouldOverride: A boolean value (true or false) indicating whether to override an existing document if one with the same name already exists
  • pagesNo: The pages that you want to separate from the document

5. Configure the second node (Receive Message Task) by adding a Data stream topic:

​

Receiving the reply

• docs: A list of documents.
  • customId: The unique identifier for your document (matching the name of the folder in the storage solution where the document is uploaded).
  • fileId: The ID of the file.
  • documentType: The document type.
  • minioPath: The storage path for the document.
  • downloadPath: The download path for the document.
  • noOfPages: The number of pages in the document.
• error: Any error message in case of an error during the splitting process.

​

Message response example

{
  "docs": [
    {
      "customId": "119407",
      "fileId": "c4e6f0b0-b70a-4141-993b-d304f38ec8e2",
      "documentType": "BULK",
      "documentLabel": null,
      "minioPath": "flowx-dev-process-id-119408/119407/466_BULK.pdf",
      "downloadPath": "internal/files/c4e6f0b0-b70a-4141-993b-d304f38ec8e2/download",
      "noOfPages": 2,
      "error": null
    }
  ],
  "error": null
}