Attribute Lists – XFM XAttributes

XML-based Feature Modelling (XFM) data exists in two known versions in version 8 Design files. Both forms consist of element attributes and potential additional elements which may be referenced to provide additional XFM information or details. Both versions are read with the DGNV8 Reader as attributes on elements and reference elements, which provides a normalized form of XFM features.

Note  For a more XFM-oriented representation of the XFM data, the Bentley Map XFM Design format may be preferable. The Bentley Map XFM Design format reader treats the XFM feature names as the feature types for elements with XFM data. It also merges XFM data from reference elements and flattens any XML fragments into user attributes on the features created by the reader.

XFM XAttributes are the second version associated with Bentley Map Select Series 3 and newer. These XAttributes exist on elements, and on potential reference elements of type igds_polygon_collection and igds_nongeom_collection. The primary form of XFM XAttributes contains either Universally Unique Identifier (UUID) values or element identifiers which are used to associate non-graphical XFM feature store elements with other graphical elements.

XFM features may actually be represented by a hierarchy of elements related by XFM XAttributes, and it is the relationship of an element with XFM properties and an associated element that may be a part of this combination of graphics and properties. The focus of the DGNV8 Reader is to read XFM feature stores for the purpose of providing XFM properties with a specific graphical element in an XFM feature hierarchy.

Note  Select Series 3 related XFM XAttributes are currently not supported for writing.

If XFM XAttributes exist, then these attribute list item names are used to specify the values for them:

Linkage Parameter Contents
attr_id An identifier for the Xattribute.

childIds

A comma-separated list containing the attr_ids of the XAttribute’s child attributes. Applies only to Link type XAttributes.

data

A binary encoded string value for the unknown data associated with uninterpreted Xattribute types.

Range: A valid context-specific variable length binary encoded string

Default: No default

data_prefix

A binary encoded string value for the bytes prefixing the core data of an XFM item for an element. This is application-specific.

This attribute has an alias as igds_xfm_data_prefix.

Range: A valid context-specific variable length binary encoded string

Default: No default

feature

This attribute is used when reading an XFM feature element or XFM reference element. It indicates the name of the XFM feature.

This attribute has an alias as igds_xfm_name.

Range: A UNICODE (UTF-16) encoded string

Default: No default

fileName

This attribute represents the file name of a file link type XAttribute.

Range: A UNICODE (UTF-16) encoded string

Default: No default

fullPath

This attribute represents the full path to the file in a file link type XAttribute.

Range: A UNICODE (UTF-16) encoded string

Default: No default

handler_id

This is a number representing a sub-type of an XAttribute handler. For each handler_type these are context-specific values further specify what is stored.

Range: Any positive integer

Default: No default

handler_type

This is a number representing a type of an XAttribute handler. This value is similar to the userId property of User Linkages.

Range: Any positive integer

Default: No default

isValid

The value of the IsValid flag in link type XAttributes.

Range: A Boolean value

Default: No default

linkType

The type of link in a link XAttribute, represented as a string.

Range: Folder Link | File Link

Default: No default

linkName

The name of the link in a link XAttribute.

Range: A UNICODE (UTF-16) encoded string

Default: No default

ref_elem_id

The identifier of an element for referencing XFM data.

Range: Any positive integer

Default: No default

type

This is a string representing the general type of an XAttribute.

Range: xattr_binary_xml | xattr_proxy | xattr_unknown | xattr_xml | xattr_link_node

Default: xattr_unknown

url

The UNICODE (UTF-16) encoded string for an XFM feature URL fragment. This is typically found on an XFM reference feature. However, it may appear on other features that contain XFM data.

Range: Any valid URL String.

Default: No default

xfm_uuid

A UUID for this XFM feature element, acting as an identifier for referencing XFM data.

This attribute has an alias as igds_xfm_uuid.

Range: Any UUID value in string format

Default: No default

xml

A UNICODE (UTF-16) encoded string containing the XML data in a secondary form XFM XML linkage.

Range: Any valid XML string

Default: No default