Support Files : Mapping : Mapping Functions
 

Mapping Functions

 
Many-to-One Mapping
One-to-Many Mapping

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"

Acronym is mandatory.

<UpdateObject/>

Acronym="Acronym"

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"

Acronym is mandatory.

Value="Value"

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.

<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"