DSS - Dynamic Loyalty Cron

Written By Devin O'Neill ()

Updated at April 24th, 2025

1.Cron Job Overview

Cron is a tool for scheduling jobs to run on a specific day of the week or month. Cron is a tool that automates system maintenance and scheduled tasks. Cron is a widely used elemental automation tool.

Cron can be used to run applications such as storing data, database systems, or information, rearranging the structure with automatic updates, verifying disc space utilization, and sending messages.

  • You can execute as many cron tasks as you like from a single crontab file.
  • Cron jobs can be scheduled to start every half hour, minute, day after the month, quarter, or week of the year, or a combination of these intervals.
  • You can use a specified structure to set up a Cron job to handle code or other instructions right away.

2.Connectivity Settings

If we want to implement some functionality at the client site, there we need connectivity between Client and Annex Cloud Server ESPs.

Navigation: Data Sync Dashboard > Connectivity Settings.

Data Sync Dashboard displays the following attributes.

  • Connection Name: Name of the connection name.
  • Platform: Select the ESP platform in the drop-down list.
  • Verification Status: It shows whether the connection is established through credential
  • Status: Displays the status ON or OFF
  • Action: Action items contain Edit and Delete options.
  • Edit: Edit the existing connection.
  • Delete: Delete the connection details.

Click on Add New and enter the Connection Name and select the platform from the drop-down list. Click on the Test connection button and save it.

2.1.Add New ESP Connection

Set up a new ESP connection by providing the following details. Click on the Add New button.

  • Connection Name: Provide connection name.
  • Platform: Name of the platform. Depending on the platform you select, one or more fields will be listed:
  • Secret Key: Secret key provided by the client / Annex Cloud.
  • API Key: API key provided by the client / Annex Cloud
  • Access Token: Access Token provided by the client / Annex Cloud.
  • Token ID: Token id provided by the client / Annex Cloud.

The secret key, Access Token, and Token ID fields change according to the platform selected.

First Test connection and then Save - if you are establishing a connection right away. If not, save it and come back later for a Test connection.

Once test connection is done and the connection is established, the verification status shows Verified.

3.Email Template

Email template helps to set up various templates for Success and Failure emails.

You can add, edit, and delete the email template as required.

Navigation to create a new email template for a cron job alert.

Navigation: Options > Data Sync > Email Template > Add New

Click on the Add New tab, and enter the required fields.

  • Template Name: Provide the template name as required.
  • Type: Select the success or failure. You will get an email notification if you select the success message for a successful cron run.
  • Email Subject: Enter the email subject as you require.
  • Email Message: Add the body of the email message.

Select the update button to add the details to the email template.

You can also export the email template information in Excel, CSV, and PDF formats.

4.Loyalty

Establishing the connection for the Loyalty Program with the client site.

        Click on the Add New button and Select ESP where you get the various sections shown in the following image.

The Loyalty module contains Sync Details, Email Notification, Scheduler, and Field Mapping.

4.1.Sync Details

Sync details contain the following fields.

  • Choose Cron Server: They are multiple servers in cron execution. So Choose any one Cron Server 1 for the Loyalty module and Cron Server 2 for the rest of the modules.
  • Data Sync Name: Name of the configuration.
  • Connection: Select a platform /ESP to create the sync with. This platform is reflected from under Connectivity Settings.
  • List Name: According to the connection selected, the client ESP sends the list. Some ESPs may not have a list concept so for them, List fields will be hidden.
  • Use Delta Dataset: Here you can run the cron jobs from starting to till date then set the toggle button ON. If you need the latest information then set the toggle button OFF.
  • Sync Enabled: Sync is ON means it is active. Sync is OFF meant inactive

Click on the Save and Select Next button to continue to the next section Email Notification.

4.2.Email Notification

Whenever a Crontab job is executed, an email regarding the execution of that job is sent to the email address of the user i.e. the email ID that you have provided while configuring your Cron job.

You may also need to confirm that the job you have added to your Crontab file is executing successfully or not.

The Email Notification section contains the following fields.

  • Enable Email Notification: Set the toggle ON to enable the Email Notifications.
  • Email From Name: Get the email notification from the Annex Cloud or Client name.
  • Notification From Email: Get the email notification from the Annex Cloud or Client email address. We can add multiple email notifications.
  • Notification Email List: Receiver Email id. Can be multiple
  • Notification For Success: If you select the success notification for the successful cron jobs you will get notifications.
  • Notification For Failure: If you select the Failure notification, for the failure cron jobs you will get notifications.

The template comes from Email Template settings, Subject and Message are not editable here.

Click on the Save and Select Next button to continue to the next section Scheduler.

4.3.Scheduler

Cron is a task scheduler that executes tasks at regular intervals. Cron jobs are a type of task that is used to automate system maintenance and administration.

Frequency: Cron tasks can be set to run every minute, hour, day of the month, month, weekday, or any combination of these frequencies.

4.4.Field Mapping

If you want to push any specific fields from any module here you can use Field Mapping functionality.

Click on Add Field configuration button to pull the specific fields from required modules.

Field Type, From Property, and To Property fields are common fields. These fields may change module-wise.

  • Field Type: Choose between Static and Dynamic data.
  • From Property: Select the list of the properties from Annex Cloud which are shown in the drop-down list.
  • To Property: ESP Platform field is nothing but a To Property.

Click on the Save button to complete the Field Mapping configuration and Click on the Finish button to complete the task.