Create Webhook Subscription

Create Webhook Subscription Dialog

  1. Open the Webhooks module in the Setup section.

  2. Click Create Webhook Subscriptionin the top right corner.

  3. Fill in all required fields listed below in the Create New Subscription window.

  4. Click Create.

Required fields

Field

Description

User

User to receive the notifications

Object Type

Name of the subscribed Dataloy object

Event Type

Type of event to Object

Alert Script

Subscribe to events based on the result of a DLPAlertScript.

Channel Type

Channel used to send notification

Url

Endpoint to receive the subscription

Field Conditions

A webhook subscription can only have an Object Type and an Event Type or an Alert Script. The corresponding fields are disabled to match this condition.

If the Channel Type chosen is HTTP, then the URL field must also be filled in.

Create Webhook Subscription Dialog

When choosing HTTP as Channel Type, you can also choose whether to add the Password, Access Token or Request Access Token fields.

Expression

This is an optional field to write a Java expression against the object changed.

On this input area, you can also write the expression by choosing in a menu the wanted field.

  1. Press dot ( . ) to see the menu.

  2. You can either scroll through the menu or type the wanted field.

  3. Choose the desired field. If the chosen is an object, the menu will now show the fields of that object.

Menu shown when "." is pressed

A list of operators is also available by pressing the dollar sign ( $ ). Please make sure there is a space before and after the operator.

Operator list menu

You can use the expression to check the previous value of the object.

  1. Press comma ( , ) to see the menu.

  2. You can either scroll through the menu or type the wanted field.

  3. Choose the desired field. Choosing a field from this menu will result in this format: old.chosenField. If the chosen field is an object, the menu will now show the fields of that object. Press "." for this menu and to continue to traverse the fields.

Menu for the old object (after the operator > ) shown when "," is pressed.

The expression created in this walkthrough will result in the following:

Expression built

This expression will be translated in a way that you will get notified if the new voyage result is greater than the old voyage result.