Document! X includes a command line console .exe which can be used to build a project as part of an automated build process. The command line .exe outputs any errors or warnings to the console so that they can be logged and returns an exit code to indicate the success or failure of the build.
The command line build .exe can be found in the \bin sub-directory below the Document! X installation directory which by default is c:\Program Files\Innovasys\DocumentX2017\bin\ .
DocumentXCommandLine.exe "c:\path\project.dxp" [/buildconfiguration="buildconfigurationname"]
The BuildConfiguration parameter is optional – by default the first profile will be built.
You can define BuildConfigurations in Document! X Project Settings editor that build different combinations of profiles / locales.
The following exit codes are returned by the command line build .exe:
-1 | Project file missing or not found. The project filename could not be located. Ensure that you enclose any paths containing spaces with quote characters. |
-2 | Build readiness issues exist that prevent the build from executing. Open the project in Document! X and start the build to view the Build Readiness issues. |
-3 | Build Configuration not found. The build configuration name specified using the /buildconfiguration parameter could not be found in the project. |
-10 | An unexpected error was encountered during the build process. |
-100 | Build partially completed (one or more outputs completed with warnings). |
-101 | One or more outputs completed with errors. |