Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Select Workflows from the menu.


Navigate the workflow tree in the left pane, and click on the workflow to edit. Click the Add button under Workflow Properties to add a property. You can add (reuse) an existing property or create a new property. 

Image RemovedImage Added

From the Add drop down, choose an Existing Property or add a New Property.


If you choose an Existing Property use the drop down in the Select Property window to add the property to the workflow.

Image Added

Clicking OK will add that property to the workflow . Image Removedas read-only.

Image Added


Choosing New Property will add a new row to the properties table with empty fields that need to be populated.

Image Added


Provide the required values for the property. 

The user who last updated definition (read only)

Field Name

Required

Description

Active

Yes

Whether or not the property is active in the system. Defaults to "Yes".

Key Name

Yes

The name of the workflow propertyN/A

Property is always active, whether it is part of Workflow property list or not is what matters.

Code

Yes

User-defined code that identifies this property, which is used in the workflow and/or plugin execution.

Display NameNoDisplay name, which is used on the property pages, etc.

Property Scope

Yes

Whether the property is environment instance or property scoped. Defaults to "Environment Instance"scope is Environment Instance or Project. Default is Environment Instance.

Description

No

A description of for the workflow property.

DatatypeData Type

Yes

The property's data type of the property. Defaults to "String".

Subtype

No

Reserved for future use.

Required

Yes. Default is String.

Sub Data Type

No

Allows the user to get additional validation for Directories, JDBC URLs, and URLs.

Encrypted

No

Whether the property is required or not. Defaults to "Yes".

Encrypted

Yes

Whether the property is encrypted or not. Defaults to "No".

Created On

N/A

The date and time the property was created (read only).

Created encrypted or not. Encrypted property values will not display on the screen or be readable in any of the logs. Default is No.

Display Details

Rows

NoDisplay attribute that defines the number of rows in the input field on the Property page.

Columns

NoDisplay attribute that defines the number of columns in the input field on the Property page.

List Data CSV

NoAllows the user to define a comma-separated list of values that will be displayed in the Workflow Request page. If given, a Drop-down component will be displayed on the Property page.

Multi Select

NoDetermines if multiple of the List Data CSV values can be selected.
Validation Details

Required

NoWhether the Property is required or not. Defaults to No.

Length

NoFor String data type, this controls length of value being entered.

Min Value

NoUser can control the minimum value for data types such as Integer, Float, Double and Long.

Max Value

NoUser can control the maximum value for data types such as Integer, Float, Double and Long.

Default Value

No

Default value can be entered as Groovy script or literal. When using Groovy script, following Groovy variables are available:

  • FD_PROJECT_NAME
  • FD_APPLICATION_NAME
  • FD_ENVIRONMENT_CODE
  • FD_INSTANCE_CODE

Validation Groovy Script

No

Enter Groovy script to define validation for property value. The script should return true or false to indicate validation success or failure.
Groovy script can use these variables:

  • Value – value entered by user for property.
  • ValidationMessage – script can set specific error message in attribute, only used if script returns false.

Updated By

N/A

The user who created last updated the property definition (read-only).

Updated On

N/A

The date and /time in which the property was last updated (read-only).Updated By

ActionsN/AContains the icon to remove the property.


Click the Save button to save any changes.


Next, add the workflow (if it isn't already added) to the Instance by clicking Topology -> Instances. Then select the Instance to be modified and click Edit. Go to the Workflows step. Add the workflow which has the project property assigned to it. Click Save. Now the property will show up in the Project Properties section of the Project and Environment Instance properties page.


Note that adding properties to existing workflows will require you to provide values for any impacted project or environment instance (depending on the scope associated to the property that was changed).