This section describes the options in the Edit Custom Dialog Node dialog box:
The Custom Dialog Node toolbar controls the creation, ordering, and deletion of steps. There is also undo/redo capability for some operations:
To add a step, click the "plus sign".
To delete a step, select it and click delete. (This operation can be undone.)
To make a copy of an existing step, select it and click the copy button. This is a quick way to create steps that share common features.
When you have created a series of steps, you can reorder them by using the up arrow and down arrows.
Only the following actions can be undone or redone. Any action related to an update of properties cannot be undone.
Addition/Deletion of a step.
Copy/Move of a step.
Addition/Deletion of a widget.
Addition/Deletion of a grid row or column.
Addition/Deletion of a data table column.
The text displayed as the step's name in the Custom Dialog Node panel.
Optional text about the custom dialog node.
User or Group to which this custom dialog node should be assigned for completion.
Allow the process creator or an admin user to change the node's
assignee.
The text displayed as the step's name in the Custom Dialog Node panel.
Optional text.
The specified macro is executed before this step is loaded.
The specified macro is executed when this step is completed.
This widget creates static text anywhere in a step. For example, you can use this to place a label in front of widget that takes input. You can apply the following attributes:
You can bind a widget to an existing variable or create a new variable. If you are creating a new variable as a binding variable, then a variable of type string with the specified properties is created when you click .
The ID of the variable.
The name of the variable. (This is editable only for new variables.)
The type of variable. Default: String
The text that displays.
This area accepts CSS markup that changes the display of the text in the Default value.
You can bind a widget to an existing variable or create a new variable. If you are creating a new variable as a binding variable, then a variable of type Reference is created when you click .
The ID of the variable. Default: reference
The name of the variable. Default: Reference
Default: Reference
Default reference path of an object that is present in repository. This value would appear in text box present in the reference widget.
Enables selection of multiple entries. The XML output will be a comma-separated list.
The base type for the reference.
This area accepts CSS markup that changes the display of the text in the Default value.
A comma-separated list of widget IDs that needs to be refreshed if value of the reference widget changes.
The macro that executes when the user changes the reference path.
This widget provides a drop-down list of items. You can have single or multiple items; the latter setting requires that you specify Multi-Valued. This widget has the following attributes:
You can bind a widget to an existing variable or create a new variable. When you click , you create a variable of Name (label) ID (label) and Type.
The ID of the variable. Default: dropDownList
The name of the variable. Default: DropDownList
Can be of type String, Long, or Double. Default: String
The default item displayed in the drop-down list.
Enables selection of multiple entries. The XML output will be a comma-separated list.
The items to be available in the drop-down list.
This area accepts CSS markup that changes the display of the text in the Default value.
A comma-separated list of widget IDs that needs to be refreshed if the value of the dropdown list changes.
The macro that executes when the user selects a different value in the dropdown list.
This widget displays an image in the step. You can select the image either from your local disk or use a bound variable to reference an image.

Upload image
If you choose the Upload image option, the Open dialog box will appear, enabling you to select an image from your local file system. Once you have selected a file, the image widget will have the following attributes:
The identifier for the image.
The location of the image on the local system.
The location of the image in the repository. When you click to save the custom dialog node, the image specified in the Local Path text box is automatically uploaded to this location in the repository.
Alternatively, you can just give the path of an already existing image in the repository as the value for the Repository path and that will be picked up when the custom dialog task is displayed in the process view.
The size of the image.
This area accepts CSS markup that changes the display of the image.
Use variable to reference image
If you choose the Use variable to reference image option, an image placeholder is displayed, and the image widget will have the following attributes:
You can bind a widget to an existing variable or create a new variable. If you are creating a new variable as a binding variable, then a variable of type reference with a base type of image is created with the specified properties when you click .
The name of the variable that references the image. If creating a new variable, the default is Reference.
The ID of the variable. If creating a new variable, the default is reference.
Default reference path of an image that is present
in repository. For example, /Data/Shared Data/image.png
This area accepts CSS markup that changes the display of the image.
This widget places empty cells between widgets and is used to manage layouts. It has the following attributes:
The identifier for the image. Default: image
The size of the spacer.
This area accepts CSS markup that changes the display of the spacer. For example, a spacer with the display style "border:2px solid blue" would render as a spacer with a blue border of 2px thickness.
These widgets provides a button or a link that, when clicked, executes the specified macro. Each has the following attributes:
The identifier for the command button or link. Default: commandButton, commandLink
The name of the command button or link. Default: Command Button, Command Link
The macro that executes when the button or link is clicked.
A comma-separated list of widget IDs that needs to be refreshed on the click of a command button or a command link.
This area accepts CSS markup that changes the display of the button or link text.
This widget takes text input from the user. That input can be
of type: String, Long, or Double. This widget has the following
attributes:
You can bind a widget to an existing variable or create a new variable. If you are creating a new variable as a binding variable, then a variable of type string with the specified properties is created when you click .
The ID of the variable. Default: textBox
The name of the variable. (This is editable only for
new variables.) Default: Text Box
Can be of type String, Double, or Long. Default: String
Enables you to create a multi-line string in the text box.
The text that displays in the text box by default.
This area accepts CSS markup that changes the display of the text box.
The IDs that need to be updated.
The macro that executes when the user edits the value in the text box.
This widget enables the user to select or clear the associated option. If multivalued, Boolean values are treated as a comma-separated string. This widget has the following attributes:
You can bind a widget to an existing variable or create a new variable. If you are creating a new variable as a binding variable, then a variable of type string with the specified properties is created when you click .
The ID of the variable. Default: checkBox
The name of the variable. (This is editable only for
new variables.) Default: Check Box
Default: Boolean
true or false. If multivalued, multiple Boolean values can be specified in a comma-separated list.
This area accepts CSS markup that changes the display of the check box widget.
The IDs that need to be updated when the value changes.
The macro that executes when the user changes the value of the check box.
This widget enables the user to upload a file. This widget has the following attributes:
The ID of the variable. Default: uploadFile
The name of the variable. Default: Upload
File
This area accepts CSS markup that changes the display of the upload file widget.
This widget enables the user to specify multi-valued variable
columns in a table. A Data Table is generated from the values specified.
Only widgets that can be multi-valued are allowed to be dropped into
data table cells. Every multi-valued variable is rendered as multiple
widgets of the same type in a column where every value of a variable
is bound to the widget rendered. For complete reference information
on this widget, see the example Example-data-table.pt.xml in /Data/Shared Data/Sample Files/process templates/custom-dialog-node-process
templates.
This widget has the following attributes:
The ID of the variable. Default: dataTable
The name of the variable. Default: Data
Table
This area accepts CSS markup that changes the display of the data table widget.