Prerequisites

Before deleting files, ensure:
  1. Access Permissions: Ensure that the user account used has the necessary access rights for updates or deletions.
  2. Kafka Configuration:
  • Verify Kafka Setup: Ensure proper configuration and accessibility of the Kafka messaging system.
  • Kafka Topics: Understand the Kafka topics used for these operations.
  1. File IDs and Document Types: Prepare information for updating or deleting files:
  • fileId: ID of the file to delete.
  • customId: Custom ID associated with the file.
In the example below, we use a fileId generated for a document using Uploading a New Document scenario.
{
  "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
}

Configuring the deletion process

To delete files, follow these steps:
  1. Create a process that includes a Send Message Task (Kafka) node and Message Event Receive (Kafka) node:
  • Use the Send Message Task node to send the delete request.
  • Use the Receive Message Task node to receive the delete reply.
  1. Configure the first node (Send Message Task) by adding a Kafka Send Action.
  1. Specify the Kafka topic for sending the delete request.
To identify defined topics in your environment:
  • Navigate to Platform Status > FLOWX Components > document-plugin-mngt and click the eye icon on the right side.
  • In the details screen, expand the KafkaTopicsHealthCheckIndicator line and then details β†’ configuration β†’ topic β†’ file β†’ delete. Here will find the in and out topics for deleting files.
  1. Fill in the request message body.

Message request example

Example of a message following the custom integration data model:
{
  "customId": "119408",
  "fileId": "c4e6f0b0-b70a-4141-993b-d304f38ec8e2"
}
  • fileId: The ID of the file.
  • customId: The custom ID.
  1. Configure the second node (Receive Message Task) by adding a Data stream topic:
The response will be sent to ..out Kafka topic.

Receiving the reply

The reply body should contain the following values:
  • customId: The unique identifier for your document (it could be for example the ID of a client)
  • fileId: The ID of the file
  • documentType: The document type
  • error: Any error message in case of an error during the deleting process

Message response example

{
  "customId": "119408",
  "fileId": "c4e6f0b0-b70a-4141-993b-d304f38ec8e2",
  "documentType": null,
  "error": null
}