Adding a Rule

After adding a segment to a group, you can start applying a rule to change your selected segment by adding statements.

Rules

A rule consists of one or more conditional and action statements. Refer to Standard Statements for details.

For example, to replace the field MSH.12 in a message with the value 2.4 if it contains the value 2.5 in the following HL7 message, you would use the following rule consisting of two statements:

1.  If Field MSH.12 Equals 2.5
2.  then Set Field MSH.12 To Value 2.4 

Therefore, the following message:

MSH|^~\&|MIC|820|MEDMADT820|820|20100831102129||ORU^R01|8327689|P|2.5

would be transformed to:

MSH|^~\&|MIC|820|MEDMADT820|820|20100831102129||ORU^R01|8327689|P|2.4

To construct a rule, you can perform the following actions:

• Adding a Statement
• Adding a Statement to a Condition
• Deleting a Statement
• Editing a Statement
• Moving a Statement
• Testing a Rule

Adding a Statement

Adding an Action

To add an (unconditional) action statement to be performed on fields within a segment:

1. Select the segment in the message you want to modify. Refer to Selecting a Segment for details.

2. Click the Action link in the Changes Bar to display a blank form to add an action:

   

3. Fill out the form.

   Refer to Standard Statements for details on how to construct standard statements.

4. Click the Ok link to accept the changes or Cancel to discard them.
5. Use the Sample Message Panel to test your change. Refer to Testing a Rule for details.

Adding a Condition

To add a new blank condition to the changes list:

1. Select the segment in the message you want to modify. Refer to Selecting a Segment for details.

2. Click the Add Condition link in the Changes Bar to display a blank form to add a condition:

   

3. Fill out the form.

   Refer to Standard Statements for details on how to construct standard statements.

4. After you have added a new condition, add a new rule statement to the condition. Refer to Adding a Statement to a Condition for details.

Adding a Statement to a Condition

To add a new rules statement to an existing condition:

1. Select the segment in the message you want to modify. Refer to Selecting a Segment for details.
2. Select an existing condition to which you want to add an action or condition.
3. In the Changes Bar, click one of the following links:
   • Action
   • Condition
   • Otherwise
   • Otherwise If

Adding an Action to Condition

To add an action to a condition:

1. Select the condition which you wish the new action to depend on.
2. Click the Action link in the Changes Bar. Refer to Adding an Action for details.

Adding a Condition to a Condition

To create a nested condition:

1. Select the condition (If, Otherwise If or Otherwise) which you wish the new condition to depend on.
2. Click the Condition link in the Changes Bar. Refer to Adding a Condition for details.
3. Select the newly created condition and add an action to it. Refer to Adding an Action for details.

Adding an Otherwise Condition to a Condition

To add a new Otherwise condition:

1. Select the condition which you wish the Otherwise condition to follow.
2. Click the Otherwise link in the Changes Bar.
3. Select the newly created Otherwise condition and add an action to it. Refer to Adding an Action for details.

Adding an Otherwise If Condition to a Condition

1. Select the condition which you wish the Otherwise If condition to follow.
2. Click the Otherwise If link in the Changes Bar. Refer to Adding a Condition for further instructions.
3. Select the newly created Otherwise If condition and add an action to it. Refer to Adding an Action for details.

Deleting a Statement

Deleting Actions

To delete an action:

1. Select the icon which appears when you hover the mouse over the statement to display the Delete Action confirmation dialog.
2. Select the Delete button to proceed with the deletion, or the Cancel link to abort.

Deleting Conditions

To delete a condition:

1. Select the icon which appears when you hover the mouse over the statement to display the Delete Condition confirmation dialog.

2. If you are deleting a parent conditional statement and want to delete its children statements as well, check the Delete Nested Actions and Conditions checkbox.

   Consequential conditional statements are not deleted (unless explicitly selected) - the first consequential conditional statement becomes the parent statement.

3. Select the Delete button to proceed with the deletion, or the Cancel link to abort.

Editing a Statement

To enter edit mode, click the action or condition.

Moving a Statement

You can drag-and-drop statements by using the Drag indicator icon .

The following restrictions apply:

• You can drag action statements whether they are located to be standalone statements or child statements of conditional statements.
• Conditional statements can only be moved with all of their children statements and consequential statements.
• When you are moving an action or a condition set to a condition, you are limited to a nesting level of two.

Testing a Rule

As you add statements in the Rules Panel, the Sample Result Panel immediately shows a preview of the changes which are highlighted. To test your change, you can edit the values directly in the sample message in the Sample Message Panel by clicking the Quick Edit link.