Advanced mapping
In some cases, the mapping between fields is more complicated than a one-to-one mapping. This is because a field may require formatting, depend on other values, or it is a fixed value that is not present in the XML. You can use advanced mapping when the field value is more complex than a standard mapping allows.
Using an Advanced Mapping replaces the Field view with the Advanced rule view and the regular toolbar with an Advanced rule toolbar. The XML View remains on the right-hand side of the page.
For advanced mapping, there are seven available rules.
- Constant value
-
A Constant value is a rule where whatever is typed is used as the field value.
- Find related node
-
The Find a related node rule is used when an XML file has multiple nodes for the same XML tag. You can use this rule to ensure that the correct value is returned.
- Find related node (dv)
-
This rule is similar to the "Find a related node" rule. However, you can provide a default value that is used if no result is found.
- Alternative node
-
The Alternative node rule is used when the same field value is found in multiple locations. For example, the same telephone number may be listed in multiple locations. You can choose which of these values is extracted.
- Convert value
-
The Convert value rule is used when the value required by validation rules or back-end processing is different to the value found on a document. In this case, you can specify the value expected on a document and then provide alternative values.
- Keep value
-
The Keep value rule enables you to specify an XML node that is likely to have multiple values. You can specify which of those values you want to keep.
- Find related node 2
-
This rule is similar to the" Find related node" rule, except that you can supply two search values. If one is not found, it looks for the other.
It is possible that an additional template is listed for an advanced mapping. This is because older XML templates are supported, but you can no longer create them.
When you first select the
Advanced rule, the
Constant
value is displayed. If you want to select a different rule, click on the
List
toolbar setting to configure an
Advanced mapping.