Edit HTTP Call Unit

Edit HTTP Call Unit

Overview

An HTTP Call Unit in a flow diagram is used to make HTTP requests to external services or APIs within your workflow. It’s a way to integrate your process with web-based systems.

What it does:
  1. Sends an HTTP request (GET, POST, PUT, DELETE, etc.) to a specified URL.
  2. Receives the response (status code, headers, body) and passes it to the next step in the flow.
How it works:
  1. Configure Request:
    1. Method: GET, POST, PUT, DELETE.
    2. URL: Endpoint of the API or service.
    3. Headers: Authentication tokens, content type, etc.
    4. Body: Data payload (for POST/PUT).
  2. Execute Call:
    1. The unit sends the request over the network.
    2. Waits for the response from the server.
  3. Handle Response:
    1. Captures status code (e.g., 200 OK, 404 Not Found).
    2. Parses response body (JSON, XML, text).
    3. Stores or passes data to the next steps.
  4. Error Handling:
    1. Retry on failure.
    2. Branch based on status code (e.g., success vs. error).
Use case:
  1. Document Workflow: Call an OCR API to process a scanned document.
  2. Integration: Send data to a REST API for storage or analytics.
  3. Notification: Trigger a webhook to alert another system.

Accessing HTTP Call Unit Properties

  1. To view/modify the unit property, click on the HTTP Call unit. Upon clicking the unit, a property panel opens below, and the unit gets highlighted.
  2. The property panel will open and display the following sections:
    1. Input
    2. Processing
    3. Output
  3. By default, all sections are displayed unless you have specified panel settings in the user settings.


Input Section

  1. The Input section provides the details on the inbound message, and the following tabs are provided in the section:
    1. Data section: The Data section provides the name of the processed units of the flow.
    2. Message: The Message section displays the inbound message of the selected unit. 


Data Section

  1. The section provides details on inbound messages and lists units that have already been processed. The following message details will be shown:
    1. Complete Message:
      1. The Complete Message represents the entire message payload, including:
        1. Message Header
        2. Start Message
        3. Input Message
        4. Any additional structural elements
    2. Message Header:
      1. The Message Header contains metadata about the message rather than the message's business data.
      2. It helps the system understand how to handle the message. 
      3. It helps in tracking and tracing, routing, logging, and error handling.
    3. Start Message: 
      1. The Start Message is the initial structure received by the Start Unit when the flow begins.
        1. It defines the expected input format.
        2. It acts as the primary data structure for processing.
        3. It is usually defined using XML or JSON schema.
      2. This message becomes the main working data object throughout the flow.
    4. Input Message:
      1. The Input Message refers to the actual incoming payload provided to the flow at runtime.
        1. In testing → comes from the Test Message (XML).
        2. In production → comes from API, queue, subscription, etc.
      2. It populates the Start Message structure and is then used by downstream units like Mapping, Condition, or API calls.
    5. Already Processed Units:
      1. The units that are processed before the HTTP Call unit will be listed here. The unit will be displayed by its name. 
  2. You can click any unit to view the data processed by that unit. The message will be displayed in the 


  1. A Search option is also provided to search for the unit name from the list.
  2. Enter the unit name in the search field, and the result will be displayed instantly.
  3. To close the search, click on the Clear (x) icon. 


  1. A Sort icon is provided to arrange the list as needed.
  2. You can also arrange the units either in ascending order (A to Z) or descending order (Z to A) using the icon next to the search icon. By default, the units are arranged in ascending order.
  3. Click the Sort icon to switch to descending order.
  4. Click again to return to the default ascending order.

  1. A Collapse icon is provided next to the Sort icon. You can use this function to increase the message's working area for better readability and more space.
  2. Click on the icon to collapse the listing. 


  1. After clicking the Collapse icon, the listing collapses.
  2. However, you will still be able to view the icon of the respective units.
  3. When you hover over the icon, you can view the names of the units. Additionally, you can click any link to view its message.


Message Section

  1. You can view the message of any of the units listed in the Data section.
  2. To view the message of any unit, click on the unit in the Data section. The message will be displayed instantly. 
  3. By default, the message will be displayed in the Tree view. However, you can switch to code view to view more details.
  4. You cannot edit the message in any mode. This is a read-only screen.


Find

  1. A Find option is also provided to find any node in the message.
  2. Enter the node name in the search field, and the result will be displayed instantly and highlighted.
  3. If more than one result is displayed, a navigation icon and a results counter are provided. You can navigate through the search results using the navigation icons.
  4. To close the search, click the 'x' icon. 


Legends

  1. A legend icon is provided to help you understand the message. The color of the nodes indicates their status.
  2. Click the Legend icon to view the details. When you click the icon, the list will show the legend used in the message.


Adjust Message Font Size

  1. A Font Size box is provided to increase or decrease the message's font size.
  2. The current font size will be shown in the box.
  3. Click on the box to increase or decrease the font size. 


  1. After clicking the Font Size box, a slider will appear below it.
  2. Use the slider to increase or decrease the font size. 
  3. As you slide, the change in size will be reflected in the message instantly.  
  4. The supported font size ranges from 8 to 72.


Switch Between Code and Tree View

  1. By default, the message will be displayed in Tree View.
  2. Click on the Switch to Code View icon.


  1. The inbound message gets switched to code view.
  2. Click the icon again to switch back to tree view mode.


Toolbar (Code View)

  1. A toolbar is provided to help you edit the message efficiently. The code view provides the following icons in the toolbar:
    1. Function: Inserts the clipboard content into the current location.
      1. Use Case: Adding previously cut or copied content.
    2. Find:
      1. Function: Searches for specific text or patterns within the document or code.
      2. Use Case: Quickly locating words, phrases, or code snippets.
    3. Replace:
      1. Function: Finds specific text and replaces it with new text.
      2. Use Case: Updating repeated terms or correcting errors throughout a document.
    4. Beautify:
      1. Function: Formats code or text to make it more readable and properly indented.
      2. Use Case: Cleaning up messy code for better readability.
    5. Word Wrap:
      1. Function: Ensures that long lines of text automatically wrap to fit within the visible window without horizontal scrolling.
      2. Use Case: Easier reading and editing of long lines.
    6. Maximize: 
      1. Function: Expands the editor or window to full screen for better focus and visibility.
      2. Use Case: Working without distractions or seeing more content at once.
  2. Once you have modified the message, click the Save button to save the changes.


View Variables

  1. The section will display the defined variables. You can create global or local variables in the section.
  2. To open the Variable section, click on the Variable menu.

  1. A list of the variables gets displayed. The list provides both global and local variables.
    1. Global Variables: 
      1. A global variable is one declared at a higher level and accessible from any part of the flow.
      2. Key Characteristics: 
        1. Accessible throughout the entire flow
        2. Can be used by multiple units
        3. Retains its value during the flow execution
      3. When to Use:
        1. Shared configuration values
        2. Data that must be reused across multiple units
        3. Environment-level settings
    2. Local Variables:
      1. A local variable is declared inside a specific unit or block and can only be accessed within that scope.
      2. Key Characteristics: 
        1. Limited visibility
        2. Exists only within the unit
        3. Not accessible outside the specific unit
      3. When to Use:
        1. Unit-specific logic
        2. Temporary calculations
        3. Intermediate processing values


Add Variables

  1. To add variables, click on the (+) icon as shown on the screen.


  1. An Add Variable pop-up will appear, displaying the following fields. All fields are mandatory.
  2. Variable Name:
    1. It is a text field; you can enter the variable name in this field.
    2. You are free to use any name of your choice.
  3. Scope:
    1. You need to select the variable scope from the drop-down.
    2. The following scopes are provided in the drop-down:
      1. Local: A local variable is declared within a specific unit and can be accessed only by that unit. 
      2. Global: A global variable is one declared at a higher level and accessible to all units from any part of the flow.
  4. Variable Type:
    1. Once you have selected the scope, select the variable type from the drop-down.
    2. The following variable types are available:
      1. Fixed: A fixed variable has a constant value that you manually define, and it does not change during execution. 
      2. User: A user variable gets its value from user input.
      3. Expression: An expression variable is calculated using logic or formulas.
  5. Once you have filled all the fields, click on the Add button.
  6. Click Cancel to close the pop-up.


  1. The newly added variable gets added to the list.
  2. Now you can edit the variable and set the values.


Edit Variables

  1. To edit any variable, hover over the variable band and click on the Edit icon.
  2. Based on the variable type, the edit screen will open.


    Edit Fixed Variable Type

    1. On clicking the edit icon, the Fixed Variable pop-up will open.
    2. You can modify the value in the Value field. This field is mandatory and cannot be left blank.
    3. Once the modification is complete, click the Save button.
    4. Click on the Cancel button to close the pop-up. 



    Edit User Defined Variable Type

    1. On clicking the edit icon, the User Variable pop-up will open. You can modify the following fields:
      1. Label: This field allows you to change the label of the variable.
      2. Description: This field allows you to change the existing description.
      3. Mandatory: Make the variable mandatory or non-mandatory using the Yes or No from the drop-down. 
      4. Data Type: This field allows you to set the data type for the selected variable. 
      5. Default Value: Set the default value for the selected variable. 
    2. Once the modification is complete, click the Save button.
    3. Click on the Cancel button to close the pop-up. 



    Edit Expression Variable Type

    1. On clicking the edit icon, the Expression Variable pop-up will open.
    2. You can modify the existing expression of the variable. You can define the expression in the expression field. If you need any variable in your expression, you can drag and drop it from the list. Please note that you cannot use (drag & drop) the selected variable in your expression. 
    3. Once the modification is complete, click the Save button.
    4. Click on the Cancel button to close the pop-up.


    Delete Variables

    1. To delete any variable, hover over the variable band and click on the Delete icon.


    1. A Delete Variable pop-up will appear.
    2. Click on the Yes button to delete the chosen variable.
    3. Click on the No button close the pop-up.


    Processing Section

    The Processing section provides the configuration details of the selected unit and provides the following tabs. You can switch between the tabs by clicking on them:
    1. Details Tab: The Details Tab contains the general information and basic properties of the flow. Typically includes the unit name and its description.
    2. Configuration Tab: Defines the technical setup and runtime-related settings. Typically includes payload handling, exposed objects, and error-handling settings.
    3. Design: The Design Tab is the visual workspace where you build the actual flow logic. Typically includes request document, key handling, error handling, etc.
    4. Processed: This tab will appear only when the unit is executed. It provides the unit's processing details.



    Details Tab

    The Details tab provides basic details of the HTTP Call unit, including its name and description. The Details tab is displayed by default. It provides the following fields:
    1. Name: 
      1. The unit name is provided in this section, and you may modify the existing name within this field.
      2. Click the field to update the unit's name.
      3. Upon completing the modifications, click the 'Save' button in the action area of the screen.
    2. Description: 
      1. This field describes the processing unit, and you can modify the existing description.
      2. Click the field to edit the unit's description.
      3. Once you are done with the modification, click the Save button in the action area of the screen.

    Configuration Tab

    1. To switch to the Configuration tab, click it. The Configuration tab provides configuration details for the HTTP Call unit.
    2. The following fields will be shown on the tab:
      1. Payload Handling
      2. Continue flow on error
      3. Exposed Object
    3. Click any of the bands to view and modify the settings. 


    Payload Handling

    This setting allows you to define how a flow receives, processes, transforms, and passes message data (payload) between units during execution. In simple terms, it allows you to select the specific payload that you do not want to process.
    1. Expand the band by clicking it. Once expanded, you will see the Remove for further processing field.
    2. Click the field to view the available payload. Select the payload you do not want to process.
    3. You can also type the payload type in the field; the entered payload is listed, and then select it.
    Image

    1. The selected payload is added to the field as a chip. The chip contains the 'X' icon; you can remove the payload by clicking the 'X' icon.
    2. Once you have added the payloads you do not want to process, click the Save button.


    Continue Flow on Error

    Continue Flow on Error is a configuration option that allows a flow to continue executing even if a specific unit encounters an error. Instead of stopping the entire flow, execution moves to the next configured step.
    1. A toggle switch is provided on the band, and by default, it is disabled.
    2. To allow the process to continue despite an error, enable the toggle switch.
    3. Click the Save button to save the configuration.


    Exposed Object

    An Exposed Object is a data structure or variable that is made available outside the flow as part of its output. It defines what information the flow will return to the calling system.
    1. Expand the band by clicking it. Once expanded, you will see the Object drop-down field.


    1. Click the field to view the available objects. Select the required object that you want to process.
    2. Once the object is selected, click the Save button.


    Design Tab

    1. To switch to the Design tab, click it. The Design tab provides configuration details for the System Call unit.
    2. The following fields will be shown on the tab:
      1. End Point
      2. Authentication
      3. Header
      4. Query
      5. Request Document
      6. Key Handling
      7. Extendad Error Handling
      8. HTTP Code Handling
    3. Click any of the bands to view and modify the settings. 


    Endpoint

    An Endpoint is the specific URL or address where a system sends or receives data. It acts as the communication entry or exit point for an application, API, or service. In simple terms, an endpoint is the destination to which a request is sent or from which a response is received.
    1. Expand the band by clicking it. Once expanded, the following fields will be displayed:
      1. URL
      2. Method
      3. Timeout (in ms) 
    2. All fields are mandatory. Please make sure you fill in all the details in all the fields for an error-free process.


    1. The URL field lets you enter the web address, and the unit uses it to send or receive data from an external system.
    2. Copy and paste the full URL in the field. 


    1. To add a method, click on the Method drop-down. The drop-down provides you with the following options:
      1. Synchronous Call: A Synchronous HTTP Call is an HTTP request where the flow waits for a response before continuing to the next unit.
      2. Asynchronous Call via Queue: An Asynchronous HTTP Call via Queue is a pattern where a flow does not wait for an HTTP response. Instead, it places the request message into a queue, and the HTTP call is processed separately in the background. So the main flow continues immediately.
    2. Select the desired option from the list, and it will appear in the drop-down.


    1. The Timeout (in ms) field lets you set the maximum time the system waits for a response before stopping the request and marking it as failed. If the server does not respond within the configured time, the call is cancelled.
    2. The field supports only 0-9 values.
    3. To add a timeout duration in the field, type a value between 0 and 300 in the field. Please note that the timeout value will be configured in seconds.
    4. You can also use the navigation icons to add the time located at the end of the field.
    5. After configuring the URL, Method, and Timeout, click Save to save the configuration.


    Authentication

    HTTP Call Authentication is the process of verifying the identity of a client (user, system, or application) before allowing access to an API or service during an HTTP call. When your flow makes an HTTP request to an external endpoint, authentication ensures that only authorized systems can access that service.
    1. Once expanded, the Method drop-down field will be displayed. Based on the selected authentication from the drop-down, the corresponding fields will be displayed. The following types of authentication are supported:
      1. No Authentication
      2. Basic Authentication
      3. Token Based Authetnication
    2. Select No Authentication from the drop-down. No further field will appear, and the authentication values will be saved automatically.


    1. Select Basic Authentication from the drop-down. The following fields will appear, and both fields are mandatory:
      1. User
      2. Password
    2. Provide the username and password of your external system.
    3. Once provided, click on the Save button provided in the action area of the screen.

    1. Select Token-Based Authentication from the drop-down. 
    2. The Token field will appear; it is mandatory.
    3. Copy and paste the token into the Token field. 
    4. Once provided, click on the Save button provided in the action area of the screen.

    A Header in an HTTP Call Unit is a key-value pair included in the HTTP request. It provides the server with additional information about the request.
    1. Expand the band by clicking it. Once expanded, the following fields will be displayed:
      1. Key
      2. Value 
    2. All fields are mandatory. Please make sure you fill in all the details in all the fields for an error-free process.


    1. This Key field lets you assign a unique key to a header. 
    2. This field is mandatory; it is a text field where you can enter any alphanumeric characters to create a key.  
    3.  You can create header keys using the (+) plus icon.


    1. The Value field lets you enter a valid value for the header key. The field provides both the Fx and A1 (text field) functions. This field is mandatory.
    2. By default, the field will open with the Fx function. You can change the field type using the Fx or A1 from the drop-down.
    3. If Fx is used:
      1. The fx icon indicates that this field accepts an expression or formula.
      2. You can create an expression by dragging a node or nodeset from both inbound and outbound messages into the field. Alternatively, you can write the expression manually, use nodes, or combine both approaches to build it.
      3. You can drag and drop any node set from the inbound and outbound messages. Open the message, then drag the nodeset into the field.
      4. To remove a node, press backspace.
    4. If A1 is used:
      1. The A1 field lets you enter any alphanumeric key to create a value. A maximum of 10 characters, 0-9, A–Z, and special characters are allowed in the field.
      2. This is a mandatory field.
    5. Create a valid value.
    Notes
    Please note that to fill the expression, you can drag and drop the node and nodeset from any Inbound and Outbound messages.




    Delete Key from Header
    1. You can delete any key using the delete option.
    2. To delete any key, click the Delete icon on the right.


    1. When you click the Delete icon, a confirmation pop-up will appear.
    2. Click Yes to delete the key.
    3. Click No to close the pop-up.
    4. Once the key is deleted, click on the Save button.



    Add Multiple Keys in the Header
    1. You can add multiple keys in the header.
    2. Please note that you can add another key after successfully creating the first one. If any placeholder is present and it is empty, you cannot add an additional key unless you fill in the values in the placeholder.
    3. Fill in the Key and Value, then click the (+) Add icon on the right. 


    1. The key will be saved, and a new placeholder will appear.
    2. You can fill in the key details and then add another key.

    Query

    A Query (or Query Parameter) is a key-value pair added to the URL of an HTTP request to send additional data to the server. It is mainly used to: 
    1. Filter data
    2. Search records
    3. Sort results
    4. Pass optional parameters

    1. This Key field lets you assign a unique key to a header. 
    2. This field is mandatory; it is a text field where you can enter any alphanumeric characters to create a key.  


    1. The Value field lets you enter a valid value for the query key. The field provides both the Fx and A1 (text field) functions. This field is mandatory.
    2. By default, the field will open with the Fx function. You can change the field type using the Fx or A1 from the drop-down.
    3. If Fx is used:
      1. The fx icon indicates that this field accepts an expression or formula.
      2. You can create an expression by dragging a node or nodeset from both inbound and outbound messages into the field. Alternatively, you can write the expression manually, use nodes, or combine both approaches to build it.
      3. You can drag and drop any node set from the inbound and outbound messages. Open the message, then drag the nodeset into the field.
      4. To remove a node, press backspace.
    4. If A1 is used:
      1. The A1 field lets you enter any alphanumeric key to create a value. A maximum of 10 characters, 0-9, A–Z, and special characters are allowed in the field.
      2. This is a mandatory field.
    5. Create a valid value.
    Notes
    Please note that to fill the expression, you can drag and drop the node and nodeset from any Inbound and Outbound messages.




    Delete Key from Query
    1. You can delete any key using the delete option.
    2. To delete any key, click the Delete icon on the right.


    1. When you click the Delete icon, a confirmation pop-up will appear.
    2. Click Yes to delete the key.
    3. Click No to close the pop-up.
    4. Once the key is deleted, click on the Save button.



    Add Multiple Keys in the Query
    1. You can add multiple keys in the Query.
    2. Please note that you can add another key after successfully creating the first one. If any placeholder is present and it is empty, you cannot add an additional key unless you fill in the values in the placeholder.
    3. Fill in the Key and Value, then click the (+) Add icon on the right. 


    1. The key will be saved, and a new placeholder will appear.
    2. You can fill in the key details and then add another key.


    Request Document

    A request document is a structured data message sent from one system to another in response to a request. It defines the format and content of the transmitted data. It is usually formatted as XML and JSON.
    1. Expand the band by clicking it. Once expanded, the following fields will be displayed:
      1. Data Source
      2. Payload Type 
    2. Please make sure you fill in all the details in all the fields for an error-free process.


    1. Expand the band by clicking it. Once expanded, you will see the Data Source field.
    2. By default, the Data Source field will include the fx function.
    3. You can drag and drop any nodeset from any message into the Data Source field using the Input and Output sections. Open any message, then drag the nodeset into the field.
    4. Please note that you can only drop one nodeset into the field. If you drop a new nodeset on top of an existing nodeset, the existing nodeset will be replaced by the new one.  You cannot drag and drop the child node into the field. Additionally, no manual input is supported in the field.
    5. Once the data source is defined, click Save to save the configuration.  


    1. Once the data source is defined, select the payload type from the Payload Type drop-down.
    2. The drop-down field will provide the list of payload types.
    3. Choose an appropriate payload type from the drop-down.


    Key Handling

    Key Handling refers to how unique identifiers (keys) are managed, validated, and used within a flow or integration process. A “key” is typically a value that uniquely identifies a record, object, or transaction. It ensures the correct record is identified, tracked, and updated throughout the flow.
    1. Expand the band by clicking it. Once expanded, the following fields will be displayed:
      1. ID
      2. Primary Key
      3. OneEnterprise Message
    2. All fields are mandatory.


    1. This ID field lets you assign a unique ID to each key. You can create multiple keys for key handling. The field provides both the Fx and A1 (text field) functions. This field is mandatory.
    2. By default, the field will open with the Fx function. You can change the field type using the Fx or A1 from the drop-down.
    3. If Fx is used:
      1. The fx icon indicates that this field accepts an expression or formula.
      2. You can create an expression by dragging a node or nodeset from the outbound messages into the field. Alternatively, you can write the expression manually, use nodes, or combine both approaches to build it.
      3. Please note that you can drag and drop any nodeset from the Output section only. Open the output message, then drag the nodeset into the field.
      4. To remove a node, press backspace. 
    4. If A1 is used:
      1. The A1 field lets you enter any alphanumeric key to create an ID. A maximum of 10 characters, 0-9, A–Z, and special characters are allowed in the field.
      2. This is a mandatory field.



    1. This Primary Key field allows you to create a valid expression using the variables, strings, and fields from the Output section. The primary key ensures that each record can be uniquely identified.
    2. This field supports only the Fx function and is mandatory. 
    3. The fx icon indicates that this field accepts an expression or formula.
    4. You can create an expression by dragging a node or nodeset from the outbound messages into the field. Alternatively, you can write the expression manually, use nodes, or combine both approaches to build it.
    5. Please note that you can drag and drop any nodeset from the Output section only. Open the output message, then drag the nodeset into the field.
    6. To remove a node, press backspace.
    Notes
    Please note that to fill the expression, you can drag and drop the nodeset from the Output section.


    1. The OneEnterprise Message field is mandatory. 
    2. Click on the drop-down to view the list of available OE messages. Select an OE message from the drop-down.
    3. Once the message is selected, click on the Save button.



    Delete Key from Key Handling
    1. You can delete any key using the delete option.
    2. To delete any key, click the Delete icon on the right.


    1. Upon clicking the Delete icon, a confirmation pop-up will appear.
    2. Click Yes to delete the key.
    3. Click No to close the pop-up.
    4. Once the key is deleted, click on the Save button.



    Add Multiple Keys for Key Handling
    1. You can add multiple keys for key handling.
    2. Please note that you can add another key after successfully creating the first one. An empty placeholder will always be present. You cannot add an additional key unless you fill in the placeholder values.
    3. Fill the details in the placeholder, and click the (+) Add icon on the right. 


    1. The new key will be saved, and an empty placeholder will appear at the bottom.
    2. Repeat the process to add more keys.


    Extended Error Handling

    Extended Error Handling is an advanced error-management mechanism that enables a flow to detect, capture, process, and respond to errors in a controlled, structured manner. The key functionality of this field is that it does not stop execution; it provides detailed control over how errors are handled.
    1. Expand the band by clicking it. Once expanded, the following fields will be displayed:
      1. Condition
      2. Info
      3. Category
    2. All fields are mandatory.


    1. This Condition field lets you define the condition under which extended error handling applies. 
    2. This field supports only the Fx function and is mandatory. 
    3. The fx icon indicates that this field accepts an expression or formula.
    4. You can create an expression by dragging a node or nodeset from the outbound messages into the field. Alternatively, you can write the expression manually, use nodes, or combine both approaches to build it. 
    5. To remove a node, press backspace.
    6. Please note that you can drag and drop any nodeset from the Output section only. Open the output message, then drag the nodeset into the field.
    7. Create a valid expression.
    Image

    1. The Info field allows you to provide the information for the condition defined in the Condition field.
    2. The field supports both the Fx and A1 (text field) functions. This field is mandatory.
    3. By default, the field will open with the Fx function. You can change the field type using the Fx or A1 from the drop-down.
    4. If Fx is used:
      1. The fx icon indicates that this field accepts an expression or formula.
      2. You can create an expression by dragging a node or nodeset from the outbound messages into the field. Alternatively, you can write the expression manually, use nodes, or combine both approaches to build it.
      3. Please note that you can drag and drop any nodeset from the Output section only. Open the output message, then drag the nodeset into the field.
      4. To remove a node, press backspace.
    5. If A1 is used:
      1. The A1 field lets you enter information manually using the alphanumeric key. A maximum of 10 characters, 0-9, A–Z, and special characters are allowed in the field.
      2. This is a mandatory field.
    6. Create a valid expression.
    Notes
    Please note that to fill the expression, you can drag and drop the nodeset from the Output section.


    1. The Category field is mandatory. 
    2. Click on the drop-down to view the list of available categories. Select an appropriate category from the drop-down.
    3. Once all the fields are filled, click on the Save button.



    Delete Category from Extended Error Handling
    1. You can delete any category using the delete option.
    2. To delete any key, click the Delete icon on the right.


    1. When you click the Delete icon, a confirmation pop-up will appear.
    2. Click Yes to delete the key.
    3. Click No to close the pop-up.
    4. Once the key is deleted, click on the Save button.



    Add Multiple Categories for Extended Error Handling
    1. You can add multiple Categories for Extended Error Handling.
    2. Please note that you can add another key after successfully creating the first one. An empty placeholder will always be present. You cannot add an additional key unless you fill in the placeholder values.
    3. Fill the details in the placeholder, and click the (+) Add icon on the right. 


    1. The new key will be saved, and an empty placeholder will appear at the bottom.
    2. Repeat the process to add more keys.


    HTTP Code Handling

    HTTP Code Handling enables your application to respond to HTTP status codes returned by an API or web service. When your flow makes an HTTP request, the external system returns a status code. Proper handling ensures the flow responds appropriately.
    1. Expand the band by clicking it. Once expanded, you will see the Do not treat as an error field.
    2. This will help you set an HTTP code as an exception during flow execution. If the set HTTP code appears, the flow will not treat it as an error and will continue.
    3. To set a code, click the field. A list of available codes is displayed. 


    1. Selected an appropriate code to make it an exception. Once selected, it will be added as a chip.
    2. You can add one or multiple error codes.
    3. To remove the code, click on the 'x' icon provided on the chip.

    1. You can also search for the error code by typing in the field.
    2. The result will be displayed instantly. 
    3. If the searched code is not found, you can add the code to the list.

    1. To add a new code, click on the (+) Add icon.

    1. An Add Custom HTTP Code pop-up will appear.
    2. You can add your custom code to the field. Certain codes are already handled. If you try to add this code, an error message will be displayed.
    3. Once added, click on the Add button.
    4. Click on the Cancel button to close the pop-up.
    1. The custom code gets added to the field.
    2. Click on the Save button provided in the action area of the screen.

    Output Section

    The Output section displays the unit's final output message. The Output Message of the system call unit is the data generated after the unit completes execution. This final output of the unit is then passed to the next unit in the flow. The Output section provides the message in XML and JSON formats. You can switch between the tabs by clicking on them:
    1. Message Tab
    2. Parameters


    Message Tab

    1. By default, the Message tab is displayed, and the message is shown in tree view mode.


    Find

    1. A Find option is also provided to find any node in the message.
    2. Enter the node name in the search field, and the result will be displayed instantly and highlighted.
    3. If more than one result is displayed, a navigation icon and a results counter are provided. You can navigate through the search results using the navigation icons.
    4. To close the search, click the 'x' icon. 


    Legends

    1. A legend icon is provided to help you understand the message. The color of the nodes indicates their status.
    2. Click the Legend icon to view the details. When you click the icon, the list will show the legend used in the message.


    Adjust Message Font Size

    1. A Font Size box is provided to increase or decrease the message's font size.
    2. The current font size will be shown in the box.
    3. Click on the box to increase or decrease the font size. 


    1. After clicking the Font Size box, a slider will appear below it.
    2. Use the slider to increase or decrease the font size. 
    3. As you slide, the change in size will be reflected in the message instantly.  
    4. The supported font size ranges from 8 to 72.


    Switch Between Code and Tree View

    1. By default, the message will be displayed in Tree View.
    2. Click on the Switch to Code View icon. The message will be displayed in the code view.
    3. To go back to the tree view, click Switch to Tree View icon.



    Parameter Tab

    1. Click the Parameter tab to view the parameter that will be displayed in the message in tree view.
    2. You can view the parameters in the tree/code view.
    3. By default, the parameters will be displayed in tree view. Switch to tree view mode if you are in code view.
    4. Please note that you cannot edit a parameter in tree view mode. The message will be displayed in read-only mode. To edit the message, switch to code view. 
    5. The tree view provides the following icons in the toolbar:
      1. Find: This option allows you to find any parameter in the inbound message.
      2. Font Size: You can set the message font for clearer viewing. The available font size range is from 8 to 24. Select the desired value from the drop-down.
      3. Show Legend: Provide the list of the legend used in the message.


    1. To view the message in code view, switch to code view by clicking on the icon.


      • Related Articles

      • Edit HTTP Call Unit

        Edit HTTP Call Unit

      • Edit HTTP Trigger Unit

        Overview Trigger Units are responsible for starting the execution of a flow. They define how and when a flow is triggered. A flow always begins with a Start Unit, and immediately after that comes a Trigger Unit. The following trigger units are ...

      • Edit System Call Unit

        Overview The System Call Unit is an action unit in the Flow Editor/Designer that enables you to invoke internal system-level services or platform operations during execution. This unit is used to perform predefined system actions, retrieve system ...

      • Edit FTP Call Unit

        Overview The FTP Call Unit is an action unit in the Flow Editor/Designer that enables a flow to connect to an FTP/SFTP server to perform file-based operations during execution. This unit allows automation flows to securely transfer, retrieve, or ...

      • Edit XSLT Unit

        Overview The XSLT Unit is an action unit in the Flow Editor/Designer that enables you to transform XML data using XSLT (Extensible Stylesheet Language Transformations) during execution. It allows complex XML transformations, mappings, and ...