Documentation Center

The Map File

The Dynamic Import map files are under the Contenta home directory in the ..\encaps\di\MapFiles. For example: d:\XyEnterprise\PE\encaps\di\MapFiles

When you create map files in the Dynamic Import user interface, they are stored in the MapFiles directory. A number of sample map files along with a starter map file (starter.dist) are delivered with the Dynamic Import software. The file contains the fields and data under the Global tab in the Dynamic Import user interface and the database connect information.

  • The distribution map file is copied to a .map filename.
  • The $DI-PROGRAMDIR variable in the distribution file(s) is replaced by dipaths.pl with the Contenta home directory (as stored in the registry) the first time the Dynamic Import tool is executed.

Example:

Delivered map file starter.dist

# Start of file
COMMENT: Header-Only Map File
PCMLOADLOC: /Global/sysadmin/PcmLoadLoc
OMNIIN:
OMNILIB: $DI-PROGRAMDIR/entities/omnilib
USER: UserName
PASSWORD:
SERVER:
DATABASE:
SOCKET:
DOCTYPE: MyDocumentType
SECURITY: secure
XMLOPTS: NA
END GLOBAL
# End of file

A description of the file’s contents, and the relationship to fields in the Dynamic Import user interface are described in the following table. Assume all fields are case-sensitive.

FieldDescriptionHeader field in DI user interface
COMMENTOptional, description of the map file.Comment
PCMLOADLOCThe Contenta hierarchy path into which you want to import the document. Must begin with :/Global/sysadmin. The hierarchical path on the sysadmin’s desktop follows.

Example:

/Global/sysadmin/Config/Pubs
PCM Path

Automatically populated with the path of the object that is selected when the DI tool is executed.

OMNIINThe directory path and name of the document to be imported.Source
OMNILIBThe directory path to the OmniMark library file. The path is under the Contenta home directory in: ../encaps/entities. Edit to include the location of the DTDs for the files you want to import.Catalog

Automatically populated with the Contenta home > entities > omnilib path.

USERA valid Contenta username. The user must have permissions to execute the Dynamic Import tool.

User — when DI is launched independent of Contenta Explorer.

Not displayed if DI is launched from within Contenta Explorer.

Default is user who executed the tool.

PASSWORDPassword for the user identified in the User field. The password is encrypted in the map file.

Password — when DI is launched independent of Contenta Explorer.

Not displayed if DI is launched from within Contenta Explorer.

Default is password of user who executed the tool.

FieldDescriptionHeader field in DI user interface
SERVERName of the Contenta database server.Server — when DI is launched independent of Contenta Explorer. Not displayed if DI is launched from within Contenta Explorer. Default is name of server provided in login options.
DATABASEDefault value for the Contenta database.Database — when DI is launched independent of Contenta Explorer. Not displayed if DI is launched from within Contenta Explorer. Default is the database provided in login options.
SOCKETValue of the Contenta socket number. This is the socket on which Contenta communicates with the database—it is the PcmPortal number.Socket — when DI is launched independent of Contenta Explorer. Not displayed if DI is launched from within Contenta Explorer. Default is the socket provided in the login options.
DOCTYPEUser-defined, written to the objects’ Document Type property sheet field.Document Type
SECURITYSecurity level, written to objects’ Security property sheet field. Valid data as delivered:

sysadmin
secure
nobody
Security
XMLOPTS

Select list:

WELLFORMED—select for well-formed XML document; no DTD.

SCHEMA—select when using a schema with the XML document.

DTD—select when using a DTD with the document; SGML only.

XML Options