Anatomy of a Mapping

There are different types of mappings that can be applied to properties with varying effects. This section will go over the different types of mappings and how they can be used.  

It is good to be aware of the different settings and filters that can be used in the project properties.

The options in the settings work as follows:

• Hide system properties: Hide any system type properties.
• Show only mapped properties: Filter down the properties shown to only the ones with a mapping rule applied.
• Show only unused properties: After scanning for usage, this will filter down all the properties to only shows those with no usage.
• Show only duplicate properties: After scanning for duplicates, this will filter down all properties to only show those with possible duplicates detected.
• Expand All: Expand all properties in all tabs.
• Collapse All: Collapse all properties in all tabs.
• Show additional mapping insight: Show if applied mappings will rename or map one property to another. If any properties are set to be removed, they will show as [Remove].

• Reset all mappings (session only): Restore any changes made to the mapping rules (either removing or adding new ones) to what was set when the Project Properties dialog was opened.  
• Remove mappings from rules (session only): Temporarily remove any applied mapping rules. After closing and reopening the Project Properties dialog they will be reapplied. This will not delete any mapping rules from your applied mapping configuration.  

When mapping rules are applied to properties, they can either be a map or rename. This will depend on if the destination property is in the current project file. When mapping Family A to Family B, if Family B doesn’t already exist in the current project file, then Family A will just be renamed to Family B. If Family B does exist in the file, then Guardian will convert all instances of Family A to Family B. This is made clear in the project properties by selecting the ‘Show additional mapping insight’ option in the settings.

Mapping rules are typically set in the mapping configurations, but they can also be set temporarily. New mapping rules can be set to ‘One time only’ (designated by the 1 next to the mapping symbol), this will allow the property to be mapped or removed without being remembered by the mapping configuration.  

One-time mappings can be applied in the create/edit dialog by toggling the ‘Remember/Don’t Remember’ option.

The one-time mapping can also be applied in Project Properties by selecting a mapping rule and clicking the ‘Remember/Don’t Remember’ option.