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.
| Field | Description | Header field in DI user interface |
|---|---|---|
| COMMENT | Optional, description of the map file. | Comment |
| PCMLOADLOC | The 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. |
| OMNIIN | The directory path and name of the document to be imported. | Source |
| OMNILIB | The 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 path. |
| USER | A 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. |
| PASSWORD | Password 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. |
| Field | Description | Header field in DI user interface |
|---|---|---|
| SERVER | Name 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. |
| DATABASE | Default 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. |
| SOCKET | Value 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. |
| DOCTYPE | User-defined, written to the objects’ Document Type property sheet field. | Document Type |
| SECURITY | Security level, written to objects’ Security property sheet field. Valid data as delivered: | Security |
| XMLOPTS | Select list:
| XML Options |