Defining Common in Condition Dictionary

About this task

Condition Dictionary is used to centrally manage conditions that are frequently used among many flows, mapping flows, action groups, conditional mapping or ECA rules. In Condition Dictionary, users could just define Common s once and then reference them when needed in different places. Condition editor provides the access to define Common s.

Procedure

  1. Double-click on the Condition Dictionary in BTT Project Explorer to launch Condition editor.
    Note: If the Condition Dictionary is not listed under the Definitions folder, open Project > Properties > BTT > Project Preference and check 'Show Common Condition'.
  2. Right-click on any blank space of editing area and new a Common . Then the defining panel would be displayed on the left.

Fill in the Condition description.

  1. Enter an id and a description for the condition.
    • id should be unique. Do not use duplicated names.
    • description is used as tooltip for the condition.
  2. Select the target environment, client or server side. This option will define which environment the Condition will be used.
    • Client indicates the condition will be used in ECA rules.
    • Server indicates the condition will be used in Condition states or conditional mappings.
  3. Add the variables which would be used to assign different values when reusing the Condition. Click the "add" button on the right side and set the ID and type. You could also use the "minus" button to remove the variable you don't need.
  4. Optional: Add comments.

Define the Condition expression.

  1. Select Condition type and define the entire Condition expression according to the selected type. There are three Condition types, Expression, Global function, and Common .
    Note: The list of possible Global functions and Common s would be restricted to the target environment, such as the server-side, client-side or both.
    • Expression: logical or relational operation defined by users.
      Steps:
      1. Select one of the operators to define Expression type.
      2. Define left and right input elements according to Expression type. Click the 'browse' button on the right. In the pop-up Expression editor, select one of the supported elements and assign the value.
    • Global function: common data manipulation, such as compare and concatenate provided by BTT.
      Steps:
      1. Expand the functions tree to select the Global function. You could use the search bar to find the Global function you want and use Description label to know better about the function. Please refer to Global Functions for detailed information about the function.
      2. Define each parameter. Click the 'browse' button on the right. In the pop-up Expression editor, select one of the supported elements and assign the value.
    • Common : common condition which has been defined by users in Condition Dictionary.
      Steps:
      1. Select the Common from the List panel.
      2. Define each parameter. Click the 'browse' button on the right. In the pop-up Expression editor, select one of the supported elements and assign the value.
  2. Click 'Apply value' button to save the defined condition.
  3. Save the dictionary.