Comet XML Directory Layout
Comet XML projects for priint:cloud are based on standard Comet XML projects as described elsewhere (see comet on the priint knownledge base ).
On the priint:cloud platform a few requirements exist to work correctly with comet XML. The requirements are related to folder structure and also to the content of a few files.
A comet XML project is stored in one folder on disk. This folder contains all configuration files needed to work with comet. The description of the standard files can be found in the comet documentation. In this document we will only cover those files/folders which must be configured for priint:cloud.
Comet XML projects will be executed on Linux.
Consequentially all file names are case-sensitive!
For priint:cloud we also store additional files in the tree folders:
- /fonts – a directory in which comet pdf renderer will look for (project specific) fonts. Warning! If the tenant must use own fonts, we must store them in this special folder to avoid usages without licence. We want to prevent mixing fonts from different tenants/projects. Our pdf renderer worker is equipped with some Microsoft fonts which are installed in the Linux container. See appendix for details.
- /master-documents – this folder contains master documents for this project in the “.w2ml” format (a format of comet pdf renderer).
- /images – this folder is designed to store any local image for this project. The idea behind this folder is to avoid unnecessary network traffic when obtaining images which are used in almost all rendering processes, e.g. logos or pictograms. Additionally, the risk of retrieval failure is near to zero compared to the HTTP status 404, 401, 500 etc. you may receive and need to handle with access via HTTP. The older name “/static-images” for this folder can still be used.
- /scripts - this folder contains optional build scripts to control the rendering. Typically, at least a
build.pyfile will be existing here.
Example Directory Contents
Only root level shown here.
comet/
├── actions/
├── fonts/
├── images/
├── master-documents/
├── pageitems/
├── pagetemplates/
├── scripts/
├── actions.xml
├── colors.xml
├── comet_setting.mxl
├── conditionmenues.xml
├── conditions.xml
├── datafiles.xml
├── domain.xml
├── findstatements.xml
├── framerules.xml
├── grids.xml
├── gridtypes.xml
├── mandanten.xml
├── pageitems.xml
├── pageitemtypes.xml
├── pagetemplates.xml
├── panelstatements.mxl
├── placeholder.xml
├── previewstatements.xml
├── realtedto.xml
├── settings.xml
├── xentities.xml
└── xindex.xml