Notification

The Axon Ivy Engine sends notifications to users such as when a new task is assigned to a user. Different channels can be operated. Built-in channels are the following:

By default, only the web channel is active, which displays all notifications. Each channel can be configured individually.

 1# sample ivy.yaml that configures the web channel
 2SecuritySystems:
 3  default:
 4    Notification:
 5      Cleanup:
 6        # notifications older than this will be deleted on a daily basis
 7        DaysUntilDeletion: 90
 8      #Decision whether a mail notification should be sent to an absent user.
 9      #possible values are 'always', 'never' and 'noActiveSubstitute'
10      NotifyAbsentUser: always
11      Channels:
12        # each channel has it's own identifier
13        web:
14          # name of the channel to identify which channel it is
15          Name: web
16          # each channel can be enabled/disabled
17          Enabled: true
18          # each channel can define which events are subscribed by default
19          Events:
20            # if enabled, all events are subscribed
21            # otherwise, only events mentioned under 'Kinds' are subscribed
22            # possible values are 'enabled' and 'disabled'
23            AllKinds: enabled
24            # array of subscribed events
25            Kinds:
26            - new-task

Notification on absent users

There is a global option to disable notifications if a user is absent; if no property is set, they will act like NotifyAbsentUser:always.

  • Send a notification regardless of the user’s absence: always

  • Does not send a notification if the user is absent: never

  • Send a notification only the absent user does not have an active substitute: noActiveSubstitute

Events

You can configure which events are sent over which channels. If nothing is configured all Events are distributed over the given channel. If you disable Events:AllKinds and specify Events:Kinds for a channel only those events are sent. However, users can individually set the notification settings in Axon Ivy Portal. All available events are:

  • new-task: If a user has a new task assignment (also on delegation)

  • business: If new business relevant event happens or new business information is available

Cleanup

By default, notifications are deleted from the database if they are older than 90 days. This duration can be adjusted using the Cleanup:DaysUntilDeletion property.