Using properties#
You can use properties in deployment plans, REST API endpoints, and external systems, such as ServiceNow®.
Property examples#
Use the following syntax to reference a property: ${propertyName}
. To escape the syntax pattern, use two dollar-sign symbols, $${...}
. You set property values with the deployment plan's Properties page, REST API endpoints, or external systems, such as ServiceNow®.
The following table describes how to properties with task types.
Task type | Usage |
---|---|
ServiceNow | You can use the ServiceNow Output property field in a create change request action to store the change request ID in a property, for example, 'service_now_prod_ticket_id' . Then, with another task, update the change request by referencing the property in the System ID field like this, '${service_now_prod_ticket_id}' . |
You can reference a system property in the email task Subject field, for example, '${sys:release.name}' is complete! . |
|
Delayed | You can reference a delay task property in the Delay property field, for example, '${prodTarget}' . In this example, the task delays until the value in the '${prodTarget}' property is reached. |
System properties#
System properties enable you to access information about the parent release of a deployment plan. System properties can be referenced by any property-enabled task that is part of a release.
The following table contains the available system properties:
Property | Description |
---|---|
${sys:release.name} |
The value in the release's Name field. |
${sys:release.description} |
Contains the content of the release's Description field. |
${sys:release.start} |
Release's Start time. |
$${sys:release.end} |
Contains the content of the release's End time field. |
In the Email message field of an email-type task, you can reference system properties like this example:
Deployment for release
${sys:release.name}-
${sys:release.description}is complete.
You can reference a system property in a ServiceNow task's Short description field like this example:
Staging deployment
${sys:release.name}\
.
Parent topic: Using properties