Publication Procedure Content Type

The Publication Procedure content type defines instructions for how to produce a specific file or list of files.

Fields

Identifier - A unique name used to reference this Publication Procedure from #LINK(). It must be unique from all other Publication Procedures used within the same Publication and can only contain letters, numbers and underscores.

Template

List - Optional Publication List that defines the set of items this Publication Procedure will publish individual files for. Each published filename and content is based on the Filename and Script fields.
Filename - Defines the file path (folder, name and extension) where the file(s) will be published within the Publication Path. It may contain cTemplate that will be processed in the context of the Publication. If a List is selected, it will also be processed in the context of each item in the list.
If the Filename is left blank or resolves to FALSE or an empty string, the Script will be processed, but a file will not be published directly. If the Script does not resolve to FALSE, a warning will be logged indicating that output was produced, but could not be written because no filename was specified indicating where to publish it.
Script - Defines the path and filename of the file(s) to publish. It may contain cTemplate that will be processed in the context of the Publication. If a List is selected, it will also be processed in the context of each item in the list.
If the Script is left blank or resolves to FALSE, a file will not be published directly.

Options

Condition - A logic condition evaluated at publish time. If the result is true, the File Production fields below will be processed.
The Condition is evaluated once, before the File Production fields are processed, therefore Publication List content records are not exposed to the Condition the way they are to the Filename and Script.

The following cTemplate may be utilized in the Condition:
- Statements such as #ADJUSTDATE(), #CONTEXT(), #LIST(), etc.
- Global System Variables such as $SystemDate.
- Global Publication Variables such as $VersionFilePath.
- Publication Settings defined for the Publication Destination.
- Publication Values from all folders at or under the Publication Folder.
Dynamic - When checked, a server-side script will be published to the file defined by the Filename. The server-side script will process the result of the Script again as cTemplate at request time.
Only If Modified - Until dependenies are fully functional, this checkbox will cause the publication procedure to short-circuit under the following conditions:
- if the target object has changed since the last publish
- if the publication procedure has changed since the last publish
- if the publication has changed since the last publish
- if the compiled filename does not exist in the file system.
This will also cause Publication Records to be created/updated every time the publish is performed; otherwise these are only updated when filenames change.

This will NOT capture updates to dependent content or templates that are invoked through this procedure, either directly or indirectly, and publication records will need to be manually managed in these cases. Use with caution.
Title - Title for the Publication Procedure. Derived from the Identifier unless explicitly set.
Icon - Optional image that represents the procedure. Typically a 32x32 PNG, but can be any size and standard web image format (GIF, JPEG, PNG or SVG).