Reviewing and Editing Mapping Rules

Mapping Project Editor displays a list of mapping rules for your review.

The Mapping Project Editor provides the following information:

Mapping rules are displayed in the following format:

Displaying Mapping Rules

You can display mapping rules individually or in a tree view which includes the target element path. Select one of the following options in the Grouped by dropdown list:

• No Grouping - display mapping rules individually
• Segment - display mapping rules in tree view grouped by segment.
• Field - display mapping rules in tree view grouped by field.
• Component - display mapping rules in tree view grouped by component.
• Subcomponent - display mapping rules in tree view grouped by subcomponent.

To expand all target paths, click the Expand All link. To collapse all target paths, select the Collapse All link.

Mapping Rule Types

Mapping rules are used by the Intelligent Mapper filter to generate output messages from input messages. In effect, mapping rules reflect how elements in target (output) messages differ from corresponding elements in source (input) messages in matched message pairs. A mapping rule can be regarded as the inverse of a transformation acting upon a source message:

Custom Rules

The Custom Rules right-click menu enables you to specify custom mapping rules. When selected for inclusion, custom mapping rules are added to the generated code in addition to the automatically generated mapping rules. Every custom mapping rules requires the target (and its path) and the type of mapping to be specified.

You can perform the following actions through the right-click menu having selected a mapping rule:

Adding a Custom Rule

To add a custom mapping rule:

1. Select a mapping rule or path under which you would like to add a custom rule.

2. Select the Add Custom Rule option in the right-click menu to display the Add Custom Rule dialog:

   

3. Enter the appropriate details:

   Field	Description
   ID	The identifier for the mapping rule (automatically added and uneditable).
   Type	The type of mapping rule: Field Constant Delete Segment Add Segment Delete Field
   Target Field/Target Segment	The name of target segment or composite in the mapping rule.
   Source Field/Constant	The name of the source composite or the value of the constant in the mapping rule. Only available when the Type is Field or Constant.

4. Select the OK button to save your new custom rule, or the Cancel button to abort.

Alternatively, to copy and paste a mapping rule:

1. Select an existing mapping rule to copy.
2. Select the Copy Rule option in the right-click menu to copy the mapping rule.
3. Select a mapping rule or path under which you would like to paste a custom rule.
4. Select the Paste Rule option in the right-click menu to display the Add Custom Rule dialog.
5. Edit the relevant details.
6. Select the OK button to paste your new custom rule, or the Cancel button to abort.

Editing a Custom Rule

To edit a custom mapping rule:

1. Select the custom mapping rule you want to modify.

2. Select the Edit Custom Rule option in the right-click menu to display the Edit Custom Rule dialog:

   

3. Edit the appropriate details.
4. Select the OK button to save your changes, or the Cancel button to abort.

Deleting a Custom Rule

To delete a custom mapping rule:

1. Select the custom mapping rule you want to delete.
2. Select the Delete Custom Rule option in the right-click menu button to display the Delete Custom Rule confirmation dialog.
3. Select the Yes button to proceed with the deletion, or the No button to abort.

Filtering Mapping Rules

You can filter the mapping rules to display using the following mapping filters:

Segment Notation

The Intelligent Mapper uses a specific notation to display segment repeats in mapping rules, which is based on the source (input) message. Sequential repeats are denoted by an appended index enclosed in curved brackets whereas non-sequential repeats are denoted by an appended index enclosed in square brackets.

For example, in the sample source message:

OBX|1|NM|150001^HIV-1 ABS-O.D. RATIO^L|||||||N|X

OBX|2|CE|001719^HIV-1 ABS, SEMI-QN^L||HTN|||||N|F|19910123|| 19980729155700|BN 
NTE|1|L|Result: NEGATIVE by EIA screen. 
NTE|2|L|No antibodies to HIV-1 detected. 
OBX|3|CE|169999^.^L||SPRCS|||||N|F|||19980728130600|BN 
NTE|1|L|NOTE: Submission of serum 
NTE|2|L|separator tube recommended 
NTE|3|L|for this test. Thank you 
NTE|4|L|for your cooperation if you 
NTE|5|L|are already doing so. 
OBX|4|CE|169998^.^L||SPRCS|||||N|F|||19980728130600|BN

the segments, in order, are displayed as follows: