Understanding how the DITA-OT Server cooperate with the Componize server

Using an external DITA-OT Server, the Componize server is responsible for providing files to the DITA-OT Server. The DITA-OT Server processes the files and returns result publication file(s) plus a log file to the Componize server.

1. Based on a ditamap, you run an Output Process using Alfresco Share Interface user interface.

   If needed, you add a ditaval file and/or some DITA-OT properties defined in a DITA-OT property file. All theses files are identified in a pipeline configuration file.

2. The Componize server defines all needed files analyzing the ditamap root file and all contained mapref and topicref.

   All of the source files, the ditamap and anything referenced directly or indirectly by the ditamap, are copied to a temporary folder on disk.

   The temp directory of the componize server contains folders named like XProcPipelineService1518958057983166493.

   If you provide a DITA-OT property file in the pipeline configuration, all files identified in the server will also be copied to the temp folder. See "How to parameterize a DITA-OT server standard plugin".

3. The DITA-OT Server runs its own process using all data stored on the filesystem of the Componize server.

   The Componize server temp directory is accessible to the DITA-OT process via the args.input.dir property.

   The DITA-OT Server uses its own temp directory in folders such as :

   /home/componize-temp/dita-ot/jobs/704/builds/1/temp. A result of a DITA-OT process is stored in folder such as or /home/componize-temp/dita-ot/jobs/704/builds/1/out.

4. TheDITA-OT Server output folder is accessible to the Componize server.
5. The Componize server copy result files in the output path defined in the pipeline configuration, using the result option value. It also merges the DITA-OT log with the Componize XProc log and copies the file in the log directory.

All of these steps can be parameterized in many different ways.