Business Layer Components (for FIXEdge C++)

Owned by Yaroslav Melyn
Dec 03, 2022
4 min read

Overview

Business Layer Components or BL components are the main elements of the FIXEdge business layer configuration.

FIXEdge offers a set of BL components, which can be useful to determine message routing, session events, scripting, message modification, plug-in connection, histories management, automatic routing for some types of messages.

BL components
Business Rules (Rules)
  • Rule
  • Default Rule
  • Create Session Handler
  • Destroy Session Handler
  • Notification Handler
  • Undelivered Message Handler
  • Session Level Reject Handler
  • Rule Fail Handler
Configuration elements
  • Plug-in Configuration
  • Handler Configuration
  • History Configuration (ODBC)
  • History Configuration (Memory)
  • History Configuration (File)

BL component manager

To view the server BL components:

  1. Click Configurations > Servers > Show all servers (left menu bar)
  2. Select a server in Servers table view
  3. Click Configurations > Business Layer Components in Details view
  4. BL components table view will be opened in a new tab


Fig. View server BL components

BL components table view

Figure. BL component table view

Filtering pane

Allows to filter the list of BL components by:

  • Name
  • Description
  • Condition
  • Source
  • Component type
  • Enabled

Action pane

Create - Allows creating a new BL component

Clone  - Opens the copy of the selected BL component for editing in a new tab

Edit - Opens the selected BL component for editing in a new tab

Remove - Removes the selected BL component

List of BL components

Contains a filtered list of BL components in the table

You can customize the table or sort it by any attribute

Figure. Table sorting and customization

Create BL component

To create a new BL component:

  1. Click Create on BL component table view
  2. Select a BL component type

Clone BL component

To clone a BL component:

  1. Select a BL component on BL component table view
  2. Click Clone on BL component table view or click Clone on BL component details view

Enable/disable BL component

FIXICC H2 allows disabling BL components. Disabled BL components are not executed 

To enable/disable a BL component:

  1. Select a BL component on BL component table view
  2. Click Enable/disable on BL component details view

Remove BL component

To remove a script:

  1. Select a BL component on BL component table view
  2. Click Remove on BL component table view or click Remove on BL component details view

BL component details view

Contains BL component details:

  • Rule type
  • Name
  • Priority
  • Description
  • FROM, IF, THEN, ELSE sections

Figure. BL component details

Actions

View in tab - Opens the BL component details in a new tab

View matching (for Business rules) - Shows a list of endpoints (FIX sessions and transport adaptors) that are affected by this rule

Figure. Matching endpoints

Edit - Opens the BL component for editing in a new tab

Disable/Enable - Disables/enables the BL component

Remove - Removes the BL component

BL component editor (Business rule)

The appearance of the editor differs depending on the type of BL component

Editor for Business rules contains:

  • Name
  • Description
  • Status (Enabled/disabled)
  • Priority
  • FROM section
  • IF section
  • THEN section
  • ELSE section
  • EXCEPTION section

Figure. Business rule editor

Rule priority

You can specify a priority of a business rule. The rule with the highest priority value is executed first

FROM section

The FROM section contains specified sources. There are different ways to specify a source for a given rule:

  1. FIX session. Specifies a source by SenderComId, TargetCompId, or Session qualifier. 
  2. FIX session by name. Specifies a source by selecting an existing FIX session from the list
  3. FIX session by regex. Specifies a source that matches a regular expression
  4. Transport adaptor by name. Specifies a source by selecting an existing transport adaptor from the list
  5. Transport adaptor by regex. Specifies a source that matches a regular expression

To add a new source click Add > select Source Type

To view a list of endpoints (FIX sessions and transport adaptors) that are affected by this rule click Additional actions > Show matching endpoints 

To clear the list of sources click Additional actions > Remove all sources

IF, THEN, ELSE, and EXCEPTION sections

The business rules may contain 3 sections:

IFCondition section. A set of pre-defined criteriaOptional
THENThe instructions that must be performed when the conditions are metMandatory when ELSE is empty
ELSEThe instructions that must be performed when the conditions are not metMandatory when THEN is empty
EXCEPTIONThe instructions that must be performed when the error occurs during the execution of the instructions in THEN or ELSE sectionOptional

BL component editor (Configuration element)

Editor for Configuration element contains:

  • Name
  • Description
  • Status (Enabled/disabled)
  • Properties
  • Definitions (for the "History" components)

Figure. History editor


Business rule binding

FIXICC H2 allows binding business rules to a given session (endpoint) by name. Also, you can view all rules that affect the given session (e.g. in case a rule is specified by regular expression or CompIDs)

To view the rules bound to a session:

  1. Click Configurations > Servers > Show all servers (left menu bar)
  2. Double-click on a server or click view FIX in the context menu
  3. Select a session
  4. Open Business Layer Configuration tab in session details view

The Business Layer Configuration tab contains:

Session Rules section  - The list of bound rules

Acting Rules section - The list of rules that affect the session

Figure. Business rule binding

Bind rules

To bind rules to a session:

  1. Select a session
  2. Open Business Layer Configuration tab in session details view
  3. Click Bind
  4. Select rules in Server's Rules dialogue
  5. Click Bind Selected

Figure. Rule binding dialogue