Map Structured rules
Use a map structured rule to define a two-way mapping between clipboard properties and a fixed-format record structure or text property value.
The following tabs are available on this form:
At run time, when mapping from clipboard properties to an output file, the rule can convert the characters from the default representation to another character set.
When both sides of the mapping are properties, the map can be performed in either direction.
For fixed-format structures, map structured rules provide a simpler alternative to Parse Structured rules, which are needed when the data structure is complex or varying, or conditional parsing is required. Use Parse Structured rules to parse record structures that contain variable elements, or packed decimal characters, or unusual data representations. For more information, see Parse Structured rules.For an example that uses Map Structured rules, see the Pega Community article How to process structured streams using the Map Structured rule.
In an activity, you can use either two methods to reference and execute a map structured rule:
- The Connect-File method, when data from the clipboard is to be mapped into a fixed structure and output into a file.
- The Map-Structured method, used to break down one property value into one or more other property values, or to assemble the structured value from property values.
Use the Records Explorer to list all Map Structured rules available to you.
Map Structured rules are instances of the Rule-Map-Structured class. They are part of the Integration-Mapping category.
- Creating a Map Structured rule
To define the relationships between a set of properties and a single structured text value, create a Map Structured rule.
- Mapping data for a Map Structured rule
To map data to or from properties that do not belong to the Applies To class (or an ancestor class) of a map structured rule, create a page entry for the appropriate class on the Pages & Classes tab of your Map Structured rule. Then, return to the Mapping tab and use the page name in the property reference (pagename.propertyname).
Previous topic Unit testing a Parse Structured rule Next topic Creating a Map Structured rule