Importer Manual / Version 2404
Table Of Contents
Each importer needs a configuration file named after the importer and with the extension
properties in the directory properties/corem. The Blueprint
example module importer-config contains the file cm-xmlimport.properties,
which serves as a template for such configuration files. For a Docker setup, the module
importer-image contains the corresponding file cm-xmlimport.properties,
again serving as a template for a Docker-based setup.
To install an XML importer, refer to Section 3.3, “Deployment and Operation of a Standalone Importer” and Section 3.4, “Deployment and Operation of an Importer in Docker” for a description of the different deployment modes. The following table describes the general configuration in the properties file.
Note
Any Java classes referenced in the properties configuration file (for
example the multiResultGeneratorFactory or transformers) must be specified
with fully qualified names.
import.user
| |
| Value | String |
| Default | importer |
| Description | The name of the CoreMedia user with which the importer logs on. Make sure that the user has the rights required to carry out operations triggered by the import process, for example, creating a new document, editing, approving, publishing. For this purpose, the standard CoreMedia installation offers a predefined user called importer (password also importer). |
import.password
| |
| Value | String |
| Default | importer |
| Description | The password of the user to log in with. |
import.autoLogoutSeconds
| |
| Value | int |
| Default | -1 |
| Description | This property defines the time of inactivity in seconds after which the importer should log out. When the importer is active again, it will log in at the server automatically. A value of "-1" means that the importer will not log out. |
import.multiResultGeneratorFactory.property.sleepingSeconds
| |
| Value | int |
| Default | -1 |
| Description | This parameter should always be set to "-1". To check
for new files continuously, environment variable IMPORT_SLEEPING_SECONDS can be used
in a Docker setup (see Section 3.4, “Deployment and Operation of an Importer in Docker”). |
Table 3.1. Properties of the cm-xmlimport.properties file
The following configuration deals with the preparation and transformation of source documents. Both are generic, thanks to the importer API. Since this part of the configuration depends on the source format, this part of the configuration should be conducted by the respective developer himself.
import.loginTimeoutSeconds
| |
| Value | long |
| Default | -1 |
| Description | This property defines the timeout for login attempts after which the
importer aborts. If import.loginTimeoutSeconds=-1, the importer tries to login
forever without abortion. |
import.enforceCompleteVersion
| |
| Value | Boolean |
| Default | true |
| Description |
This property handles the processing of XML importer files. See Section 4.1, “The CoreMedia XML Format” for details on the CoreMedia XML format.
|
import.validate-textproperty
| |
| Value | Boolean |
| Default | false |
| Description | If "true" the importer validates all XML text properties against the associated DTD. If a validation fails, no document is created on the server. For big XML properties the validation may take some time. |
import.removeBrokenLinks
| |
| Value | Boolean |
| Default | false |
| Description | If "true" the importer removes broken content links in link list and markup properties. In markup
properties only the link tag (a or img) is removed, not the containing link text.
Be careful when enabling this option, as it may lead to invalid XML in markup properties. |
import.entityResolverClass
| |
| Value | class name |
| Default | see description |
| Description | Configures the name of a class of type org.xml.sax.EntityResolver used to resolve entities
in markup properties during XML validation. The default value is com.coremedia.xml.ClasspathURLEntityResolver. |
Table 3.2. Properties of the cm-xmlimport.properties file
