You are on page 1of 4

Bentley DgnDb i-model Importer 1.

5 x64/x86

The Bentley DgnDb i-model Importer converts DGN V8-format packaged i-models (.i.dgn) into
DgnDb-format (.imodel) i-models. The .imodel is compact and particularly optimized for
mobile apps. You can review .imodel files that contain business data and embedded documents
with Navigator Mobile or Bentley Navigator Desktop.

The Bentley DgnDb i-model Importer supports the embedding of non-design files (.pdf, .xls,
.doc) into the .imodel. You have the option of creating a compressed i-model (.imodel) and/or a
decompressed DgnDb (.idgndb). You can review the decompressed .idgndb file using any
SQLite DB file Viewer or Editor for internal business contents and provenance.

The 32-bit version or 64-bit version (like ItgDgnDbImporter_x64.msi or


ItgDgnDbImporter_x86.msi) are available by default with the installation package. The version
that matches your OS configurations is installed.

NOTE: When creating .imodels, the preferred type of input i-model is a packaged V8 i-model.
The Bentley DgnDb i-model Importer does not process the external references of an i-model.
Discoverable non-design files attached to graphical elements with manual design links are
embedded into the .imodel.

Using Bentley DgnDb i-model Importer 1.5 x64/x86 via Command Line

"IDgnToIDgnDb.exe" can be used from command-line to batch process or automate the


publishing of .imodels. The executable is delivered with the Bentley DgnDb i-model Importer
installer and is available at the following location:

For 64-bit OS configurations:


C:\Program Files\Bentley\ItgDgnDbImporter 1.5\ IDgnToIDgnDb.exe

For 32-bit OS configurations:


C:\Program Files (x86)\Bentley\ItgDgnDbImporter 1.5\IDgnToIDgnDb.exe

USAGE:

IDgnToIDgnDb.exe -i <filename> [-e <filename>] ... [--output


<filename>] [-z <filename>] [--config <filename>]
[--reference <regular expression>] [--drmPassword
<password>] [--noAssertDialogs] [--lang1 <language
culture name>] [--lang2 <language culture name>]
[--temp <foldername>] [--noEmbedDgnLinkFiles] [--]
[--version] [-h]
Options may be placed in a response file using the conventional @filename
syntax. OR Options may be placed in an environment variable named
IDgnToIDgnDbOptions.

Where:
-i <filename>, --input <filename>
(required) A packaged i-model (.i.dgn) file to be used as the input
for the conversion to the i-model (.imodel) format.

-e <filename>, --embed <filename> (accepted multiple times)


(optional)An extra file to embed in the resulting i-model (.imodel).

--output <filename>
(required) The filename to use for the resulting uncompressed i-model
(.idgndb) file.

-z <filename>, --zoutput <filename>


(required) The filename to use for the resulting compressed i-model
(.imodel)file.

--config <filename>
The ImportConfig.xsd instance filename to use for DgnDb import
configuration.

--reference <regular expression>


A std::regex pattern that must match the filename for a reference file
embedded in the .i.dgn input for it to be included. If this option is
provided, then non-matching files are excluded.

--drmPassword <password>
A password for enabling access to a protected input i-model file.

--noAssertDialogs
Merely log assertion failures.

--lang1 <language culture name>


A sqlang language pack file suffix such as es, es-ES, es-MX, etc.

--lang2 <language culture name>


A sqlang language pack file suffix such as es, es-ES, es-MX, etc.

--temp <foldername>
The location to use for temporary files during the import process.

--noEmbedDgnLinkFiles
Do not automatically embed non-dgn files that are linked to from the
input dgn i-model file.

--, --ignore_rest
Ignores the rest of the labeled arguments following this flag.
--version
Displays version information and exits.

-h, --help
Displays usage information and exits.

NOTE: Command-line options are applicable for other executables that are available within the
same product installation directory based on your requirements.

• IDgnToIDgnDbGui.exe
• DwgToIDgnDb.exe
• IDgnDbToIModel.exe
• IModelToIDgnDb.exe

Below is a matrix displaying the subset of file format conversions as supported by different
executables. Certain executables can output 1 or 2 (user’s choice) of the formats.

Command-line Parameters
Executables -i --input -z or -o --output Summary
--zoutput
IDgnToIDgnDb.exe .i.dgn .i.dgn .imodel N/A .idgndb Takes one packaged i-
Or model (.i.dgn) as input
IDgnToIDgnDbGui.exe and zero or more
extraneous files and
produces an i-model
(.imodel) and/or a
DgnDb i-model
(.idgndb).
IDgnToIDgnDb.exe
runs in a console
mode.IDgnToIDgnDbG
ui.exe runs in graphical
user-interface mode.
DwgToIDgnDb.exe .dwg .dwg .imodel N/A .idgndb Takes one .dwg input
file and produces an i-
model (.imodel) file
and/or a DgnDb i-model
(.idgndb) file.
IDgnDbToIModel.exe .idgndb N/A N/A .imodel .imodel Takes an .idgndb file
and compresses it into
an .imodel file.
IModelToIDgnDb.exe .imodel N/A N/A .idgndb .idgndb Takes an i-model
(.imodel) file and
decompresses it into an
.idgndb file.
Changing the Import Configuration File

The ImportConfig.xml is located in the “C:\Program Files\Bentley\ItgDgnDbImporter 1.5”


directory. You can edit the XML file to incorporate your design workflows. You can use
ImportConfig.xml for the IDgnToIDgnDb.exe or IDgnToIDgnDbGui.exe. You can use the
DwgImportConfig.ini file for changing options for DwgToIDgnDb.exe.

Logging Mechanism

By default, logging is not enabled for all of the executables shipped with the Bentley DgnDb i-
model Importer. You can define BENTLEY_DGNDBIMPORTER_LOGGING_ENABLE=1 in
your environment to enable it. The detailed log files are generated at the following location:
C:\Users\<UserName>\AppData\Local\Bentley\Logs. If you encounter any issues during
publishing, the *-issues.log file is generated next to the .imodel location.

By default, C:\Program Files\Bentley\ItgDgnDbImporter 1.5\logging.config.xml file is used for


logging. You can override it by specifying a configuration variable in your environment
BENTLEY_DGNDBIMPORTER_LOGGING_CONFIG=<ConfigFilePath>.

Other Configurations & Environment Variables

Variables Descriptions
BENTLEY_DGNDBIMPORTER_PUBLISH2DMODELS If set to 1, converts the 2D seed and non-
seed models to 3D during DgnDb i-model
publishing process. Default setting is 0 or
undefined.
BENTLEY_DGNDBIMPORTER_SEARCH_FONTS If set to 1, enables the search for fonts to
be embedded during DgnDb i-model
publishing process. Default setting is 0 or
undefined.
BENTLEY_DGNDBIMPORTER_RSC_FONT_PATHS With above variable set to 1, specifies the
BENTLEY_DGNDBIMPORTER_SHX_FONT_PATHS directories search paths for RSC, SHX
BENTLEY_DGNDBIMPORTER_TTF_FONT_PATHS and TTF custom fonts respectively.
Multiple paths could be provided
separated by semi-colon.

Online References

You can learn more about Mobile publishers and apps on Bentley Apps page.

For Known Issues or FAQ information, go to the iWare page on Be Communities.