Free cookie consent management tool by TermsFeed a!deployment() Function
a!deployment() Function

Function

a!deployment( deploymentUuid, property )

Returns a specific property of direct and external deployments.

Parameters

Keyword Type Description

deploymentUuid

Deployment

The deployment to retrieve. The UUID is available from the post-deployment process or the deployment's log.

property

Text

The information to retrieve for this deployment. Properties are case-sensitive and the following properties are supported:

  • name (Text): The name of the deployment package.
  • description (Text): The description of the deployment package.
  • uuid (Text): The UUID of the deployment.
  • auditUuid (Text): The common UUID across environments that tracks a direct deployment and any related deployments completed using the Deploy to Another Environment option.
  • status (Text): The status of the deployment. Possible values are "COMPLETED", "COMPLETED_WITH_ERRORS", "FAILED", "IN_PROGRESS", "PENDING_REVIEW", "REJECTED", and "REJECTED".
  • applications (List of Application): The list of applications that the deployments are for.
  • packageType (Text): The type of package (Patch or Application).
  • objectsPackageId (Integer): The document ID for objects package zip file.
  • customizationFileId (Integer): The document ID for Import Customization property file.
  • databaseScriptsIds (List of Integer): The document IDs for database scripts in the order they are executed.
  • pluginsPackageId (Integer): The document ID for the zip file of plug-in JAR files.
  • logId (Integer): The ID of the deployment log.
  • source (Text): The name of the source environment.
  • target (Text): The name of the target environment.
  • objectsDeployed (Integer): The number of objects in the package that have been deployed. This includes successfully deployed objects and skipped objects.
  • objectsFailed (Integer): The number of objects in the package that have failed to deploy.
  • requester (Text): The username of the user who initiated the deployment. Learn more.
  • reviewer (Text): The username of the user who made a decision on the deployment. Learn more.
  • reviewerComment (Text): The comment left by the reviewer. Learn more.
  • decision (Text): The decision on the deployment made by the reviewer. Possible values are "APPROVED", "REJECTED", "PENDING", and "NOT_APPLICABLE". Learn more.

Returns

Returns a specific property of a direct or external deployment which can be used in a post-deployment process.

Usage considerations

Using a!deployment() in environments that don't use governance

If you do not use governance on your environments:

  • The value of the reviewer and reviewerComment properties will be null.
  • The value of the decision property will be "NOT_APPLICABLE".
  • The value of the requester property will frequently be the deployment service account for the target environment.

Using the status property

You can use the status property to tell whether or not governance is enabled for an environment. If the status of a deployment is "PENDING_REVIEW" the deployment is waiting for a reviewer to make a decision on the deployment. Learn more about deployment statuses.

Using the requester property

  • If the deployment was triggered by an external deployment, the value of the requester property will be"EXTERNAL_SYSTEM".
  • If the deployment is a direct deployment from an environment that is no longer reachable, the function may not be able to determine a username and the value of requester may be null.

Example

deployment(101, "reviewedDate") returns 12/21/05 2:28 PM GMT

Feature compatibility

The table below lists this function's compatibility with various features in Appian.
Feature Compatibility Note
Portals Partially compatible

Can be used with Appian Portals if it is connected using an integration and web API.

Offline Mobile Partially compatible

Can be used with offline mobile if it is loaded at the top of the form.

Sync-Time Custom Record Fields Incompatible
Real-Time Custom Record Fields Incompatible

Custom record fields that evaluate in real time must be configured using one or more Custom Field functions.

Process Reports Incompatible

Cannot be used to configure a process report.

Process Events Incompatible

Cannot be used to configure a process event node, such as a start event or timer event.

Open in Github Built: Fri, Feb 23, 2024 (09:14:09 PM)

a!deployment() Function

FEEDBACK