Custom Configuration File

A Bentley Map Mobile Converter custom configuration file can be used to produce Bentley Map Mobile files for your organization's specific needs.

Custom Configuration File Format

The Bentley Map Mobile Converter opens one or more design and reference files, processes each graphical element, creating Bentley Map Mobile feature instances, map layers, categories, view thumbnails, full-text search indexes and more using data conversion settings defined in an XML configuration file based on this "XML Schema Definition (XSD)" with the following general format:

Following are descriptions of data conversion settings that can be defined in a custom configuration file, then specified on the MapMobileConverter.exe command line using the --config-file= option.

Features

This required section defines element search criteria and feature creation settings. The <Features> element that may contain one or more <feature> child elements which define conversion settings used to create Bentley Map Mobile features from Bentley Map or MicroStation data. As elements in the input design or reference file(s) are processed, the <feature> conversion settings are evaluated from top to bottom, with the first conversion setting that matches the specified search criteria being applied. Therefore, the more restrictive search criteria should be specified higher in the list.

The <Features> element may include the optional geospatialSchema="C:\MyProjectPath\MyBentleyGeospatialAdministratorSchema.xml" attribute to load feature name, alias, category, zoom_min and zoom_max settings from a Bentley Geospatial Administrator schema XML file.

MicroStation Element Selection

Please refer to the "MicroStation Element Selection" section of the "Default Configuration File" for basic information.

Also, when defining <feature> elements for MicroStation element conversion, an optional <Symbology> child element can be used to refine element search criteria as illustrated in the following:

Please refer to <Symbology> element in the "XML Schema Definition (XSD)" for more information. 

Bentley Map XFM Feature Selection

Please refer to the "Bentley Map XFM Feature Selection" section of the "Default Configuration File" for basic information.

Business Properties

When defining <feature> elements for Bentley Map XFM feature conversion, an optional <Properties> child element can be used to define which business properties are included as illustrated in the following:

Please refer to <Properties> and <property> elements in the "XML Schema Definition (XSD)" for more information. 

Override Symbology

When defining <feature> elements for MicroStation element conversion, an optional <OverrideSmbology> child element can be used to change element symbology as illustrated in the following:

Please refer to <OverrideSymbology> element in the "XML Schema Definition (XSD)" for more information. 

View Thumbnails

An optional <Views> element with  <View> child elements can be used to create named view thumbnails.

Spatial Filters

An optional <SpatialFilters> element with <View> or <Range> child elements can be used to define spatial filters to limit which data is processed.

Variables

Many data conversion settings support the use of both built-in element and user-defined variables.

Built-In Element Variables

The following built-in element variables can be used in any attribute value when defining <feature> element attribute values.

$(Element.Level)
$(Element.Color)
$(Element.Weight)
$(Element.Style)
$(Element.Cellname)

For example, some of the following <feature> element attributes use the built-in element variables to define feature names and categories.

User-Defined Variables

An optional <Variables> element with  <Variable> child elements can be used to create user-defined variables for use in supported data conversion settings.

When referencing user-defined variables, use $(VariableName) syntax such as illustrated in the name="Text_$(Element.Level)", zoom_max="$(50k)" and color="$(OverrideColor)" attributes of the following:

Options

An optional <Options> element can be used to define MapMobileConverter.exe command line options in a custom configuration file.

Please refer to the "XML Schema Definition (XSD)" section for further details on supported configuration file settings.