Table of Contents

DataHub Flow List

The DataHub Flow List page presents an overview of all configured data flows in your system. Adjust the default filter for Generic (Flows used by all 3PL customers) or Only Customer. Each row represents a single flow and displays information about its setup, involved parties, and transaction activity. The most important fields you will see here include:

  • Number of Transactions – Shows how many transactions have been processed through the flow. Clicking this number opens a detailed list of the individual transactions.
  • External Party Name – Indicates the external organization or system that receives or sends data for this flow.
  • Bill-To Company Name – Displays the internal or external company responsible for billing associated with this flow.
  • Type – Shows the protocol or mechanism (e.g., HTTP, SFTP, POP3) used to transfer data.
  • Message Type – Describes the type or format of messages (e.g., JSON, XML) being transferred.
  • Invoice Category – Indicates how invoices or billing information are categorized in this flow.
  • Description – Provides a brief overview or purpose of the flow.

By reviewing these fields at a glance, you can quickly gauge which flows are active, how much data they handle, and who is responsible for them. For further analysis, simply click the Number of Transactions to drill down into the details of each transaction associated with that flow.

Edit Flow

You can click the EDIT in the record or click Edit in the top bar to open the Flow itself. The flow itself is an overview of the configured steps related to your integration process.

Note

Please be aware that changing your Flow might lead to disruption of your Business Process. Boltrics is not responsible for any disruptions caused by changes made by 3PL end users. Review the change log to revert back any changes that may cause disruptions.

The DataHub Flow page appears after editing a DataHub Flow. A Flow always contains at least a Trigger, that initiates the execution of the flow, and an Endpoint that ends the execution of a Flow. One or more Actions are added to modify your data or retrieve data from external sources to influence the behavior of a flow. Here you will see an overview of a Generic Flow for Customs. You can always revisit this page yourself in 3PL Dynamics.

Grouping_Card

Flow Details

The Flow Details section provides general information about the current DataHub Flow, including the Flow ID, Bill-To Party, External Party, Message Type, and other high-level parameters. This area helps you understand the overall purpose and configuration of the flow at a glance.

Flow Actions

The Flow Actions section outlines the sequence of Triggers, Actions, and Endpoints that define how data is processed. A Trigger indicates the starting point or condition for the flow, an Action performs a specific processing step (like setting parameters or transforming data), and an Endpoint specifies the final destination or service that handles the data.

Action Properties

The Action Properties section lists detailed settings for each Trigger, Action, or Endpoint in the flow. Here, you can configure individual parameters, decide how data is masked or transformed, and determine the behavior of each processing step to ensure that the flow meets your business requirements.

Trigger Overview

This table contains a list of the Triggers and a brief explanation of their purpose.

TRIGGER Name Explanation
HTTP Starts the flow when an incoming HTTP request is received. Useful for inbound data from external services.
CALLBACK Waits for a callback endpoint request, then returns a direct HTTP response. Ideal for asynchronous flows where another system “calls back” with data or status updates.
FTP Initiates the flow when new files appear on an FTP server. Helps automate file pickup and subsequent processing.
SFTP Similar to FTP but uses secure FTP. Begins the flow when new files arrive at the specified SFTP location.
POP3 Monitors a mailbox using POP3. When new emails are found, the flow triggers and processes the message or attachments.
AFS Triggers the flow based on Azure File Storage events, enabling automatic handling of files added or updated in Azure Files.
SCHEDULE Initiates the flow according to a specified schedule or interval, allowing time-based automation (e.g., nightly or hourly tasks).

Action Overview

This table contains a list of the most regularly used Actions and a brief explanation of their purpose.

ACTION Name Explanation
REPLACE Replaces specified text or patterns in the message or parameters with new values. This is useful for adjusting data before further processing.
XSLT Performs an XSLT transformation on XML data, allowing you to convert or reshape the message into a different XML structure as required by downstream systems.
CONDITION Evaluates certain conditions (e.g., checking values in the message) to decide which path the flow should take—enabling branching logic based on data content.
SETPARAMETERXML Extracts specific XML tags from the message and sets them as Flow Parameters for use by subsequent actions.
SETPARAMETERJSON Extracts specific JSON fields from the message and sets them as Flow Parameters for use by subsequent actions.
SETPARAMETERGUID Generates or sets a GUID (unique identifier) as a Flow Parameter, often used for correlation or tracking.
SETPARAMETERDATETIME Inserts or updates a date/time value as a Flow Parameter—useful for timestamps, scheduling, or logging.
REMOVENAMESPACES Strips namespaces from an XML document, simplifying processing or comparison of XML elements later in the flow.
SLEEP Pauses the flow for a defined number of milliseconds, allowing you to wait before continuing to the next action.
SPLITXML Splits the XML message based on a specified XML tag or XML path, creating multiple smaller messages or records.
CONVERTJSON2XML Takes a JSON payload and converts it into an XML structure, easing integration with systems that require XML.
CONVERTXML2JSON Transforms an XML document into JSON format, useful for consuming XML data in JSON-based applications or APIs.
CONVERTPDF2XML Extracts text from a PDF using Azure AI Document Intelligence and generates an XML structure for further use or analysis.
PLACEBETWEENTAGS Inserts the incoming message between specified XML tags, providing a quick way to wrap raw data in a structured envelope.
BASE64DECODE Decodes a Base64-encoded message back to its original binary or text format, making it available for further actions.
SETSEARCHFIELDS Adds data to predefined Search Fields (1..10), often used for indexing, logging, or advanced searching in subsequent steps.
BASE64ENCODE Encodes a message (binary or text) into Base64 format, enabling safe transport in systems that require plain text.

Endpoint Overview

This table contains a list of the Endpoints and a brief explanation of their purpose.

ENDPOINT Name Explanation
HTTP Posts the input message to an HTTP endpoint, typically used for sending data to a RESTful service or receiving a response from a web server.
FTP Uploads the message as a file to an FTP server, facilitating legacy or basic file-based integrations.
SFTP Similar to FTP but uses SSH encryption for secure file transfer; uploads the message as a file to an SFTP server.
AFS Uploads the message as a file to Azure File Storage (AFS), a managed file-share service within Microsoft Azure.
SCANVIEW Posts the message to 3PL Dynamics Scanview for scanning, indexing, or additional document-based processing.
CALLBACK Sends the message as a callback (e.g., HTTP POST), often used in asynchronous or webhook-style integrations where another system must confirm receipt.
SMTP Sends the message as an email through an SMTP server, allowing email-based integrations or notifications.
TERMINATE Terminates the transaction or flow, signaling that no further processing is required for this message.