Object Mapping

The object mapping parameters are contained between the <ObjectMappings> tags. Each DGN level in this section is mapped to a feature. There must be at least one object mapping in this section.

The structure and syntax of the object mapping section is similar to other mapping files. To find out more about how object mapping works, see Object Mapping.

<And>

</And>

</Filter>

</MapObject>

</Object>

In the above example, the <Object> tag contains the information required to map a DGN to feature to an S-57 feature. The tag must contain a set of mapping rules within the <MapObject> tags, but the filtering rules are optional. The Description attribute contains a brief description of what feature is being mapped. This attribute is also optional.

The following table describes the filters for mapping DGN files. Any of these filters can be applied within the <Filter> tags.

Filter	Attribute	Attribute Value
PrimitiveIsEqualTo PrimitiveIsNotEqualTo	Primitive	Point Line Area Symbol Text
DGNLineWeightIsEqualTo DGNLineWeightIsNotEqualTo	Value	Integer value between 0-31.
DGNLineStyleIsEqualTo DGNLineStyleIsNotEqualTo	Value	Integer value between 0-7. The values represent the following lines styles: 0 - solid 1 - dotted 2 - medium dashed 3 - long dashed 4 - dot dashed 5 -short dashed 6 - dash double-dot 7 - long dash, short-dash
DGNColourNumberIsEqualTo DGNColourNumberIsNotEqualTo	Value	Integer value between 0-255.
DGNCellNameIsEqualTo DGNCellNameIsNotEqualTo	Value	String value that cannot be empty.
ZValueIsEqualTo	Value	Any valid double value
ZValueIsGreaterThan	Value	Any valid double value
ZValueIsGreaterThanOrEqualTo	Value	Any valid double value
ZValueIsLessThan	Value	Any valid double value
ZValueIsLessThanOrEqualTo	Value	Any valid double value

The following table describes the object mapping functions. These must be placed between the <MapObject> tags.

Mapping Function	Attribute	Attribute Value
MapObjectAcronym	Acronym	A string value for the S-57 object acronym. The string value cannot be empty.
SetAttributeValue	Acronym	A string value containing the attribute to be assigned. The string value cannot be empty.
	Value	A string value containing the value to be assigned to the attribute. The string cannot be empty.
	Append	True if values will be appended to the attribute (if attribute already has a value). False if value will be assigned to the attribute. False will be assumed if not explicitly set to True.
	Separator	String to act as a delimit values. This attribute is only valid if Append is set to True.
SetAttributeValueUndefined	Acronym	A string value containing the attribute to be set to undefined.
SetAttributeValueUnknown	Acronym	A string value containing the attribute to be set to unknown.
AssignZValueToAttribute	Acronym	A string value containing the attribute acronym to be set to unknown. The string value cannot be empty.
	Negate	True if the Z value is to be negated. False if the value is not to be negated. Default is false.
	PositiveValuesOnly	True sets the Z value to be assigned only if the value is positive. False sets the Z value to be assigned whether or not the value is positive or negative.
AssignCurrentDateToAttribute	Acronym	A string value containing the attribute acronym that contains the current data. The date must be in CCYYMMDD format.
AssignDataSetNameToAttribute	Acronym	A string value containing the attribute acronym to which the dataset name is assigned.
AssignSourceTypeToAttribute	Acronym	A string value containing the attribute acronym to which the source type will be assigned.
CreateAreaFromClosedShape	N/A	N/A
CreateLinesFromClosedShape	N/A	N/A
AssignDGNLabelToAttribute	Acronym	Attribute acronym to which the DGN label will be assigned.
AssignDGNLabelToAttribute	Acronym	Attribute acronym to which the DGN level will be assigned.
AssignDGNCellNameToAttribute	Acronym	Attribute acronym to which the DGN cell name will be assigned.