Versions Compared

Key

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

To create a new template, click Create or copy an existing out-of-box template or another custom template for an event. 

...

Field

Description

Template Name

The name of the template.

Events

Associate an event for the template (e.g. Workflow Request Completed). You can also assign more than one event to the same template.

Email Subject

The script to be used for email subject for the event(s).

Email Body

The script is to be used for the email body for the event(s).

Payload

The payload is used in the code editor to give suggestions of what variables and methods are available when accessing the $payload variable, as this will vary depending on the event. If more than one event is associated with this template, use this to switch between the selected events.

...

Both Subject and Body will be able to reference the payload object related to an event. Using the shortcuts, you will be able to access all the data associated to an event using the variable $payload. The below table shows the events and associate payload objects.

Events

Payload Object Name

Recipients

Api Token Expiration

TokenExpirationPayload

FlexDeploy users whose API tokens are going to expire in 3 days.

Pipeline Gate Approval Assigned

PipelineGateApprovalAssignedOrRejectedPayload

FlexDeploy users, groups or emails configured in the pipeline role assigned for the Approval Gate.

Pipeline Gate Approval Rejected

PipelineGateApprovalAssignedOrRejectedPayload

Eligible FlexDeploy users who committed the code for the Projects/Packages in a Release Snapshot. Eligibility is by the flag checked for “Notify on Request Rejected” for the profile.

Pipeline Manual Step Assigned

PipelineManualStepAssignedPayload

FlexDeploy users, groups or emails configured in the pipeline role assigned for the Manual Step.

Pipeline Notification Step

PipelineNotificationStepPayload

FlexDeploy users, groups or emails configured in the pipeline roles selected for the Notification Step.

Pipeline Step Execution Failed

PipelineStepExecFailedPayload

FlexDeploy users, groups or emails configured in the pipeline roles selected for On Error option in the Pipeline Steps.

Workflow PreDeploy Review Assigned

ProjectReviewTaskPayload

FlexDeploy groups configured in the Pre-deploy workflow.

Workflow PreDeploy Review Rejected

ProjectReviewTaskPayload

FlexDeploy user who submitted the request, FlexDeploy users who subscribed for “Notify on Request Completed

Workflow Approval Assigned

ProjectApprovalTaskPayload

FlexDeploy users who subscribed for “Notify on Approval Required

Workflow Request Pending Approval

ProjectApprovalTaskPayload

FlexDeploy group responsible for approval of the deployment request.

Workflow Request Failed

Workflow Request Ready

Workflow Request Rejected

Workflow Request Scheduled

ProjectWorkflowRequestPayload

FlexDeploy users who subscribed for the following events “Notify on Request Failed

Notify on Request Deploying

Notify on Request Rejected”

Notify on Request Scheduled”

FlexDeploy user who submitted the request.

Eligible FlexDeploy users who committed the code.

Work Item MentionWorkItemMentionPayload

FlexDeployMentionPayload

FlexDeploy users who were mentioned in a Work Item. The mention could be either from a comment or the Work Item description.

Work Item Subscription

WorkItemSubscriptionPayload

FlexDeploy users who subscribed for Work Item changes, such as field updates, new comments etc.

Saved Query Subscription

SavedQuerySubscriptionPayload

FlexDeploy groups who subscribed for extract of Saved Query result in PDF/ CSV format.

Share Saved Query

SavedQuerySharedPayload

Notification sent when a Saved Query has been shared with a user.

Info

Each payload object of an event holds a different set of data. Please use the link for each payload and go through the methods available to structure your HTML content for the template. You can always use the Preview and Send Test options to test and validate your script using the test data available.

...