APM Notification Service

APM Notification Service


Adonis Notification Service is a utility that enables you to set up periodical auto-generated emails or reports and send them to applicable crew members or to fixed email addresses.

Visit the Adonis Reports, Views and Similar space to find pre-defined Notification tasks and reports.


Functionality

In this section, we will walk you through the main principles under which Notification Service works.
By following the guidelines, you will get to know how to configure, create, edit and schedule tasks for sending notifications.

Getting Started

Before starting to work with the Service, make sure the access right for the 824 Notification Service routine is granted to you in Adonis Control Centre.

To access the Notification Service features:

  1. Run Adonis Personnel Manager.

  2. Within the application, switch to the Setup ribbon tab and click Notification service.

As a result, Notification Service becomes active from the Manage tab. Here you can see a set of scheduled notification tasks:

The Notification Service grid includes the most common information about a notification task, such as its name, status, scheduled time, and interval.

The commands that allow managing notification emails are available:

on the Manage ribbon bar

from the context menu when right-clicking anywhere in the grid

 

Сlick New to create a notification task.
Click Open to edit an existing notification task.
Click Delete to remove a selected notification task.

Scheduled Task

The delivery of notifications is handled by the system based on the time and date values that you define.

To schedule a task, click the New button on the ribbon bar. On clicking, the following dialog appears:

In the Task Properties dialog, make the following initial setups:

  • In the Task name field, specify the notification task name.

  • The Task enabled checkbox is selected by default which means that the task is active. If the checkbox is deselected, the task will be added to the list of scheduled tasks, however, it will not be executed.

 

Now, switch to the Task schedule tab to set date and time settings.

Under Time settings, proceed as below:

  • In the Run at the box, you can define the time component for sending a notification. Type or select the part of the timestamp you want to change. By default, the time is set to 00:00.

  • Select the Repeat during the day checkbox if you want to send a notification email more than once a day. On selecting, the feature-specific fields become active. Type or select the interval in minutes and limit the time for sending.

  • In the Last Execution UTC drop-down menu, indicate the date and time when you want to stop sending notification emails.

  • Enter or select Local Time in the drop-down menu.

 

Under Date settings, proceed as detailed below:

  • In the First run on the field, enter or select the date for sending a notification for the first time.

  • In the Repeat on dates drop-down list, set a recurring due date on a Daily, Weekly, Monthly, or Yearly basis as well as a completion date. To avoid sending a notification periodically, select the Do not repeat on other dates option.

 

Select the When finished send the log file to checkbox to enable the possibility to receive a log file after sending a notification. Once enabled, enter the email address.
Besides, you can reschedule the existing task. To do this, simply double-click the task you want to reschedule and define the time and date settings as mentioned above.

Set Email Address

In the Notification E-mail tab, you can define one or more email addresses to which a notification is to be sent.

There are two methods in APM:

  • Create a list of email addresses manually.

  • Use a SQL statement to fetch the required email addresses from the database.

In this section, we will show you how to proceed with the selected method.

Add Emails Manually

To manually enter one or more email addresses, navigate to the Notification E-mails tab in the Task Properties dialog and select the Fixed E-mail list option:

Now, fill in the fields as described below:

  1. Recipients. Enter one or more email addresses of the recipients.

     

  2. E-mail subject. Specify the main idea of the notification.

  3. E-mail body. Type the essence of the message you want to convey.

Retrieve Emails From Database

To enable the possibility to create a SQL statement for fetching email addresses from the database based on a preset condition, switch to the Notification E-mails tab in the Task Properties dialog and select the Dynamic from database option:

Now, fill in the fields as described below:

  1. In the Recipients box, write a SQL statement to fetch the required email addresses from the database. The statement will filter the crew members' emails that fit one or more conditions.

     

  2. In the Field identifying email address field, define one of the aliases that exist in the selection (e.g. #Email).

  3. Specify the main idea of the notification in the E-mail subject field.

  4. In the E-mail body field, type the text of the message to be sent. When entering field alias, wrap them in brackets, e.g. [#Pin]. This will reveal data as real database values corresponding to each selected person.

  5. Select the Distribute checkbox in case you want to send a personal notification (e.g. birthday card). As a result, the notification will be sent as an attachment as well as added to the Enclosed Documents related to a person.

  6. In the Document Type field, click the down caret to make the list of options appear. In the drop-down list, select a document type previously defined in General Codes (Setup > General Codes > Enclosed Documents).