| Panel | |
|---|---|
|
Disclaimer
Your use of this download is governed by Stonebranch’s Terms of Use, which are available at https://www.stonebranch.com/integration-hub/Terms-and-Privacy/Terms-of-Use/at Stonebranch Integration Hub - Terms of Use.
Overview
This Universal Task sends job status notifications to a Slack channel. It also enables users to send interactive messages in Slack for Universal Controller manual task approvals.
Notifies users of job failure, late start/run, and other important events via a Slack channel.
Approval in Slack for Manual task type – users simply click on an approval button in Slack message to run manual tasks to success in Universal Controller, triggering continuation of workflow execution.
Quick reaction time on job failures.
Manual task interruptions in workflows can be handled by the concerned applications/business teamteams, while workflows in Universal Controller can be resumed simply by responding to the approval message in Slack.
...
Version Information
| Template Name | Version |
|---|---|
| 1.2.0 |
Software Requirements
This integration requires an a Universal Agent and a Python runtime to execute the Universal Task against a Slack account with an Incoming webbook enabled for a job notification. Also, in order to cater the approval functionality from slack Slack for an a manual task type in Universal Controller, you will need to have an Interactivity enabled in slack Slack with the request URL which will be used to send the http HTTP POST request for interactive messages by slackSlack.
Software Requirements for Universal Template and Universal Task
This integration requires an a Universal Agent and a Python runtime to execute the Universal Task against.
...
Universal Agent for Windows x64 Version 67.91.0.0 and later with python Python options installed
Universal Agent for Linux Version 67.91.0.0 and later with python Python options installed
Software Requirements for Universal Controller
Universal Controller Version 67.91.0.0 and later
Software Requirements for the Application to be Scheduled
The task can be used against any of your slack Slack account or workspace that is of either free or standard or plus or enterprise grid
...
The request URL provided in Slack could be an end point endpoint either in AWS lambda or Azure Function, GCP function, or your custom API end point endpoint to handle the interactive message from slack Slack and advise universal controller Universal Controller on approval or rejection of the manual task.
Below is the sample python Python code that could be invoked for the slack Slack interactive message handling
Steps to Activate Incoming Webbooks
...
Go to your Browser browser and provide the URL: https://api.slack.com/apps/.
Select or create an application that would be appropriate for sending Universal Controller notifications.
Click on Incoming webhooks on the left menu and activate Incoming webhooks as below.
...
Feature | Description |
Job Notification | This feature can be used to send any job notification to a slack channel; for example, a job failure, Job long-running, or Job held. |
Approval Notification | Typically, Manual task types in universal controller Universal Controller are used, when there is a user manual intervention needed in a workflow task type and the Manual Task is completed successfully in universal controller Universal Controller by clicking on to the manual task command “Set Completed” traditionally. Now this task for slack Slack can notify slack Slack channel when the manual task reaches the status: “Action Required” and the User in slack Slack can simply click on the approve/Reject Button in the slack Slack interactive message that was sent by universal controller Universal Controller and then the manual task in the workflow can either go to success if approved or wait in the same status if rejected |
Import
...
Universal Template
To use this downloadable the Universal Template, you first must perform the following steps:.
This Universal Task requires the Resolvable Credentials feature. Check that the Resolvable Credentials Permitted system property has been set to true.
To import the Universal Template into your Controller, follow
...
...
.
When the files have been imported successfully, refresh the Universal Templates list; the Universal Template will appear on the list.
Configure Slack Notification Universal Task
...
Field | Description |
Slack Function | Approval Notification (ideal to associate with manual tasks) |
Job Name | Name of the job :${ops_task_name} |
Job Status | Status of the job:${ops_status} |
Slack Incoming Webhook | Incoming webhook URL for your slack Slack account |
Execution User | Execution User of the Manual Task:${ops_execution_user} |
Job type | Task type of task instance: ${ops_task_type} |
...
| Message | Large text to pass any message from UAC task execution or any custom info to Slack notifications |
Examples of Slack Notification Universal Tasks
Send a Job Status Notification to slack
...
(Task defintion)
Send a Job Status Notification to Slack (Task Instance)
Calling a
...
Slack Job Status Notification through Action
...
→ System Operations and Launch Task
(Also this could be made generic for a group of jobs or all jobs by calling the slack Slack notification job from the Task monitor job.)
...
Slack Notifications for UAC Job Status
Approval Notification defined in Manual Task Actions ==>System Operations
Send an Approval Notification to
...
Slack
Approval Message in Slack
...
This document references the following documents:
Name | Description |
|---|---|
User documentation for creating Universal Templates in the Universal Controller user interface. | |
User documentation for creating Universal Tasks in the Universal Controller user interface. |
Changelog
ut-slack-notifications-1.2.0 (2023-04-24)
Enhancements
Introduced a new field name called Message (large textbox) for sending additional messages to slack channels as notifications
Color codes in Slack messages for different UAC job status