2022
Page History
Overview
Organizations might find it hard to keep track of the various processes in progress or errors that might occur. Email notifications for when a process is complete is currently provided as an in-built feature but might not be sufficient to keep track of errors, or start, and finish of a process. Also receiving notification within the server of the company or any communication channel such as Slack can be extremely beneficial to the users to keep track of all events. It is also very essential for the user to be notified about the three most important stages of an activity:
...
There is a specific list of supported expressions which has to be followed for writing the various required parameters in the URL while running the GET method.
These can be found listed under “Supported Expressions”. Various conditions for these parameters can also be listed.
Once you enter all parameters Click SAVE
Click Test Connection
A pop-up confirming webhook connection will appear on the screen
In below image:
A notification stating the process has started has been received
Error count if any
Date and time
...
In both the methods if the user has check-boxes to receive notification when STARTED, immediately when the connection is SAVED and TESTED a notification will be sent to the SERVER or to the communication channel such as SLACK that the process has STARTED.
To get the URL for POST method for a communication channel such as SLACK please refer to the following link https://api.slack.com/messaging/webhooks .
Parameterization (supporting variable injection)
Type: Started, Stopped, Errored
DateTime: Ability to convert into the timezone they want
This can leverage SimpleDateTimeFormat in Java
Records processed : If Error, the error message and Error code
Erroring on the post event should still continue the processing, we need to add it to logs as SEVERE error and email if there is a notification email attached.
Also the below parameters can be run in PAY method:
Headers - textarea ( multiple lines, each line is a separate header) - notification.webhook.header
Content-Type - text - notification.webhook.content-type
Payload (supporting variable injection) -using Code Editor notification.webhook.post.body
Test button - to test the operation of notification
For Post, just post the post body as is
Phase 1 - we will document the parameters available on Wiki
Phase 2 - we will allow them to pick and choose the variables from the UI
All the above values captured will be part of properties and will be saved in config.properties
Supported Expressions:
Option | Expression | Notes |
Current date | $date; format=”dateformat”$ | Format is an optional attribute. However, it is recommended to add one. Do NOT escape quotes in dateformat as it can lead to errors. |
Current event | $event$ | Values: Started, Errored or Completed |
Error count | $errorCount$ | Denotes the number of objects that encountered an error |
Is error in backup | $isError$ | Values: true if event is errored else false |
Profile Name | $profile$ | |
Total records processed | $recordsProcessed$ | Total number of records processed ie. inserted + updated for all objects |
...