Creating Import Tasks

To create an import task:

  1. Create a folder for the import task on the server. You are recommended to create an import folder under your configuration-root/com/escenic/syndication/xml folder, with subfolders for each import task. Each import task folder may have a subfolder for filters. For example:

    configuration-root/com/escenic/syndication/xml
       import
          pub1
             [filters]
          pub2
             [filters]

    This is the folder structure on which subsequent examples and discussions are based. You are free, however, to organize your import configuration files in any way you choose.

  2. Copy a configuration file into the import task folder. You will find a template configuration file called XMLImportConfiguration.properties in the /engine/contrib/import folder.

  3. Rename the configuration file to the same name as the task folder.

  4. Edit the configuration file to meet your requirements. See Editing Task Configuration Files for detailed instructions.

  5. Add a reference to the new import task to the importConfigurations property in the configuration-root/com/escenic/syndication/xml/XMLImportService.properties file. See Editing XMLImportServices.properties for detailed instructions.

The above steps are sufficient for the simplest case where you have "ready to import" content that is already converted to Escenic syndication format. In more complex cases you may also need to create additional filters and or prefilters in order to convert the source data to syndication format before import.