Mapping Functions
A set of functions are used to map from one object to another. These functions may simply create part of the new object (that is, set the acronym), or use information from the object being mapped to create the mapping.
The following table lists the available mapping functions.
Function | Attributes |
<MapObjectAcronym/>
| Acronym="Acronym"
Object acronym is mandatory. |
<UpdateObject/>
| Acronym="Acronym"
Object acronym is mandatory Create="True"
Create is used to indicate that the object should be created if it does not yet exist. Default is Create=True.
|
<SetAttributeValue/>
| Acronym="Acronym"
Attribute acronym is mandatory. Value="Value"
Attribute value is mandatory. Append="True/False"
Append is used to indicate if the value should be appended to an existing value. This allows attribute values to be constructed from multiple sources. If not given, Append=False.
Separator="Separator"
Separator is used in conjunction with Append. The separator is added between attribute values that are being concatenated. If not given, a comma is used for list attributes and a space for text attributes. If no separator is to be used then the value is set to Separator="NONE".
|
<CopyAttributeValue/>
| FromAcronym="acronym"
FromAcronym is mandatory.
ToAcronym="acronym"
ToAcronym is mandatory.
Round="Round/Truncate"
Round applies to conversions to integer or floating point numbers. If it is not specified, Round is assumed.
Precision="number of decimal places"
Precision determines the number of decimal places for conversions to floating point numbers. It is used with Round property to convert the values.
Append="True/False"
Separator="Separator"
|
<CopyConvertibleAttributes/>
| All attributes in the first feature are copied to the second feature. |
<ApplyAttributeMapping/>
| Name="AttributeMappingName"
Name is mandatory.
|
<AssignZValueToAttribute/>
| Acronym="acronym"
Acronym is mandatory.
Negate="True/False"
Negate will multiply the floating point or integer number by –1 to negate. If it is not specified then Negate=False. Negate is used when converting S-57 soundings into VPF soundings (for example).
PositiveValuesOnly="True/false"
PositiveValuesOnly is used to indicate that only positive floating point or integer attributes should be converted. If it is not specified then PositiveValuesOnly=False. This function is used when converting S-57 soundings into VPF soundings (for example).
|
<MapAttribute/>
| Entry tag The MapAttribute tag must contain one or more Entry tags. Each entry tag is made up of zero or one <Filter> tags and one or more attribute mapping tags. |
<SetAttributeValueUnkown/>
| Acronym="Acronym"
Acronym is mandatory.
|
<SetAttributeValueUndefined/>
| Acronym="Acronym"
|