Object Mapping

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

Entries are ordered from the most specific to the least specific. 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 elements required to map a DGN to feature to an HPD 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 HPD 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.
`AssignDataSetNameToAttribute`	Acronym	A string value containing the attribute acronym to which the dataset name is assigned.
	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.
`AssignSourceTypeToAttribute`	Acronym	A string value containing the attribute acronym to which the source type will be assigned.
	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.
`CreateAreaFromClosedShape`	N/A	Convert a line that forms a closed shape into an area feature, when mapping from a DGN, Shapefile or GML file to an S-57 or HOB file.
`CreateLinesFromClosedShape`	N/A	Convert a closed shape into a line, using the boundary, when mapping from a DGN, Shapefile or GML file to an S-57 or HOB file.
`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.