Skip to main content

Data Fabric

The Data Fabric acts as a bridge between API data and the user interface, processing and formatting data for seamless integration. Before drawing a diagram, you must create an artifact as the foundation for your design.

Creating a New Artifact

  1. Navigate to 'Select artifact' > 'My Artifacts' > 'App Group' > 'App Name'.
  2. Click on 'Create Artifact' to define your workspace.
  3. The artifact serves as the base for defining and structuring the Data Flow Diagram (DFD).

image.png

The Node Gallery provides key building blocks for data processing pipelines. Each node type serves a specific function:

NodeDescription
startnodeMarks the beginning of a workflow.
endnodeMarks the termination of a workflow.
streamnodeProcesses real-time data from sources like Kafka.
apinodeManages data interactions with APIs.
schedulenodeAutomates scheduled tasks.
filenodeHandles data stored in files.
dbnodeConnects and interacts with database systems.

Each node requires property configuration, accessible through a right-click.

Steps to Create a Data Processing Workflow in Data Fabric

Draw Diagram (Data Processing Flow)

  • Open the Data Fabric workspace.

  • Use the Node Gallery to select and drag data processing nodes onto the canvas.

  • Available nodes include:

    • streamnode (for streaming data)
    • apinode (for API data)
    • schedulenode (for scheduled tasks)
    • filenode (for file data)
    • dbnode (for database data)
    • startnode (default start node)
    • endnode (default end node)
  • Arrange and connect the nodes to define the data processing flow.

  • Configure the properties of each node (e.g., API endpoints, database connections, file paths).

  • Remember that the startnode and endnode do not require configuration.

image.png
image.png

Configure Events and Rules (Logic Center)

  • Open the Logic Center.
  • Navigate to the "Rules" tab.
  • Define data processing rules using the Rule Engine or custom JavaScript in the Expression editor.
  • Navigate to the "Actions" tab, specifically the "Events" section.
  • Use the left-side menu to select the artifact and specific nodes or their properties.
  • Add events to be emitted from data processing nodes.
  • Define how these events will push data to queues (e.g., "Success", "Failure", "Suspicious").
  • Set custom statuses for more granular event handling.

Set Orchestration

  • Click the "Orchestration" icon (top-right corner).
  • Map source data to target data.
  • Transform data as needed (e.g., rename fields, create combined fields).
  • Ensure data flows correctly between the data processing nodes and other systems (UI Fabric, external APIs).

image.png

Configuring Node Properties

Each node has configurable properties available in the "Node Properties" panel.

PropertyDescription
connectorNameDefines the database connection (for dbnode).
linkParamUsed for linking parameters (e.g., primary keys).
operationNameSpecifies the API operation (e.g., get).
Request, Response, ExceptionAllows viewing or modifying request, response, and exception handling.
Node InformationDisplays details such as node type (apinode), name (claims_details), and description.

HTTP Method Selection

The apinode supports multiple HTTP methods:

  • Get
  • GetById
  • Post
  • Put
  • Delete

Each method has a toggle switch (0) to enable or disable it.

Once the workflow is drawn and properties are configured, additional customizations are required, including security settings, event triggers, rules, and custom code.

image.png

Data Mapping

Before designing a workflow, an artifact must be selected or created.

Once an artifact is selected:

  1. Establish data mappings by connecting fields from the Source to the Target.
  2. Drag a link from a field in the Source column to the corresponding Target field.

image.png

Logic center

The Logic Center allows advanced configuration of Security, Events, Actions, Rules, and Custom Code (SEARC).

SEARC Breakdown

ComponentFunction
S - SecurityManage access and authentication.
E - EventsDefine triggers for actions.
A - ActionsSpecify operations for data processing.
R - RulesImplement conditional logic.
C - CodeAdd custom scripts for advanced tasks.

Once inside the design workspace, locate the 'Logic Center' button at the bottom.

The Logic Center enables setting actions and security at both:

  • Node Level
  • Field Level (within Source or Target data)

Setting Up Security Rules

  1. Open the Logic Center.
  2. Navigate to the Security tab.
  3. Select a Source Node (e.g., employee_detail).
  4. Choose 'ALLOW ALL' to grant unrestricted access.

image.png

Configuring Actions & Events

  1. Open the Actions tab in the Logic Center.
  2. Define actions such as:
    • Lock and TTL
    • Pagination (for UI nodes)
  3. Configure Event Triggers:
    • Success
    • Failure
    • Suspicious Activity
    • Custom Status (format: API<Value>)

Defining Rules

Rules control how data is processed. There are two ways to configure rules:

Rule Engine (Visual Builder)

  • Provides a drag-and-drop interface for defining logic.
  • Useful for non-technical users.

image.png

Code Editor (Custom JavaScript)

  • Allows writing custom JavaScript logic for advanced processing.
  • Supports complex rule sets.

image.png

Final Steps

  1. Configure all necessary nodes, mappings, and logic.
  2. Save your workflow.
  3. Run a test deployment to validate functionality.
note

Always click "Save" after making any changes to ensure updates are stored successfully.