Referencing a dialog definition

Reference to a dialog definition tells the system which dialog it should open when a user executes an action. You can reference your dialog definition from two places.

Referencing from template definitions

Dialogs are used to enter content for pages, areas and components. All three content elements share the same template definition class  ConfiguredTemplateDefinition  and they reference a dialog definition in the same way.

In the page/area/component definition, create a dialog property and set its value using the following format: 

<module name>:<relative path to dialog>

The value has two parts, separated by a colon:

1. Module name. This is the module which contains the dialog definition.
2. Relative path to the dialog definition inside the module.

Example:

standard-templating-kit:/components/content/stkTextImage

The relative path starts from the /modules/<module name>/dialogs folder. In the example above, the stkTextImage dialog definition is in /modules/standard-templating-kit/dialogs/components/content, the relative path is /components/content/stkTextImage.

Here is an example template definition with a dialog reference.

Referencing from action definitions

Dialogs are used in actions to collect information from the user, such as a page name in the Add page action.

In your action definition, create a dialogName property and set its value using the following format:

<module name>:<dialog name>

OpenEditDialogActionDefinition and OpenCreateDialogActionDefinition are examples of repository actions that open a dialog when executed. The dialog asks the user for a node name and creates or edits the node in the repository on submit.

Here is the Add folder action in the Pages app.