Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Back to Notifications Main Page

Excerpt
hiddentrue

Learn how you can configure and execute Notification Runs

What does this section cover?

to configure Notification Run Definitions that will determine the overall behaviour of Notification Runs

Panel
nameblue

Table of Contents

Table of Contents
minLevel2

Navigating to Notification Run Definitions

Info

What are Notification Runs?

Notification Runs are used to log the execution of notification run definitions, that were performed in order to generate notifications and all the information that the notification is referring to.

Notification Runs can be performed only within an effective notification run definition.

A new Notification Run is created each time a recurring Notification Run Definitions is submitted. Whenever a run has been submitted, the notification run added to the scheduler to be executed based on the specified run definition scheduling.

In order to modify the scheduling information of a submitted Notification Run you can Edit the definition. 

Creating, Editing & Deleting

CRM > NOTIFICATIONS > PERFORM NOTIFICATION RUNS

What are Notification Run Definitions?

Notification Run Definitions are used to define the rules by which Notification Runs, responsible for creating Notifications will be executed. The two Classifications of Notification Run Definitions are 'Financial' and 'Customer Care'.  Each Classification supports separate Entities which result in the generation of different types of information.  The Classification also determines the conditions available to be set on/by? each Run Definition.

 

  • Financial Classification
    This is related to Financial information of the supported entities, such as balances and outstanding debts. 
    • Subscription
    • Bills
    • Wallets
    • Wallet Product Consumption
  • Customer Care Classification
    This is related to Customer Care information of the supported entities, such as confirmation of payments, award points earned, redeemed or expired and Goods and Services added to a Subscription.
    • Subscriptions
    • Jobs
    • Activities
    • Leads
    • Service Requests
    • Rewards Participants
    • Award Transactions
    • Spend Transactions
    • Award Expiration Transaction
    • Payment Gateway Cards
    • Payment Gateway Requests
    • Payments
    • Buy in Advance Request
  • Status
    colourBlue
    titleAvailable from CRM.COM R12.0.0
     Reward Offers Classification
    This is related to Reward Offers Information.
    • Reward Offers

Run Definitions must be submitted once created and will be executed once or on a recurring basis, based on the defined scheduling settings. Once a Definition is executed, a Process Run is logged, and once the Run is completed, the log information is available in the respective section.
The user has the option to delete the specific Run as long as it is not yet executed (still in 'Draft' state).
A Definition must be in an 'Effective' Life Cycle State to be submitted.  The state can be changed between 'Effective' and 'Not Effective' using a dedicated action.

  • Navigate to Notification Run Definitions and explore existing entries via the Summary page
  • Click on the link (Name or Number) of the entry of your interest to access the Data Entry page and see more detail, or submit the Definition. 

  • Select a Classification ('Financial' or 'Customer Care') and use the Actions Menu to create a NEW Definition.

  • Use the Actions Menu to modify (EDIT), or DELETE an existing one.

  • Use BACK to return to the Summary page and CANCEL to revert any unwanted changes made to the Definition.

  • Click on the Audit Log button to view a log of changes performed on the displayed Notification Run Definition.

Check the Validations & Restrictions Table below for a list of available Actions when working with Notification Run, including each Action's related validations, restrictions and additional information. View the Attributes Table for a comprehensive description of the Notification Run Definition fields.

Notification RunsImage Added

Anchor
validations
validations
Validations & Restrictions

ActionValidationsRestrictionsAdditional Information
General   
Create   
Edit   
Delete   

Notification Run attributes 

Description

Name

Create
  • Mandatory Fields must be defined
    • Notification Type
      • Customer Care Notifications:
        At least one Segment MUST be defined (in 'Included' or 'Excluded')
      • Financial Notifications:
        At least one of the available criteria MUST be defined
  • Name and Alternative Code must be unique
  • Selected Notifications Type
    should be associated to a Communication Template including  Tags of the following Types exclusively:
    • For Financial Notifications
      • Notification Tags
      • Contact Information Tags
      • Accounts Receivable Tags
    • For Customer Care Notifications
      • Notification Tags
      • Contact Information Tags
      • Entity Tags of the Entity that is included in the related Notification Item
    • Status
      colourBlue
      titleAvailable from CRM.COM R12.0.0
      For Reward Offers Notifications
      • Reward Offers Tags
  • On creating a new Notification Run, there is the option to select between two separate Classifications of Notification Run Definitions, depending on which different criteria are made available.
    • Financial
      • Accounts Receivable
      • Wallet
      • Subscription
      • Notification
      • Segment
      • Notification History
    • Customer Care
      • Segments
      • Notification History
    • Status
      colourBlue
      titleAvailable from CRM.COM R12.0.0
      Reward Offers
      • Reward Offers
Edit
  • Mandatory Fields must be defined
  • Name and Alternative Code must be unique
  • Selected Notifications Type
    should be associated to a Communication Template including Tags of the following Types exclusively:
    • For Financial Notifications
      • Notification Tags
      • Contact Information Tags
      • Accounts Receivable Tags
    • For Customer Care Notifications
      • Notification Tags
      • Contact Information Tags
      • Entity Tags of the Entity that is included in the related Notification Item
    • Status
      colourBlue
      titleAvailable from CRM.COM R12.0.0
      For Reward Offers Notifications
      • Reward Offers Tags
  • If there is one or more scheduled Run using the same Definition, then a new Run Definition instance is created.  The new Definition will have the same values and Unified Code as the first one, an augmented version number and all the modified information.
Delete
  • Not Applicable
  • Run Definitions cannot be deleted if there exists at least one scheduled or completed Run for that Definition.
  • Not Applicable

 

Anchor
attributes
attributes
Attributes

An * indicates a field is mandatory 

Criteria - Criteria - Criteria - Criteria - Notification CriteriaCriteria - Subscription Criteria

Name

Description

Main Information
 Name*The name of the notification run definitionNotification Run Definition.
Alternative CodeThe alternative code of the notification run definitionthe Notification Run Definition. Unless otherwise specified, the Alternative Codes for new entries default to the Name initials in capital letters.
DescriptionA description of the notification run definitionNotification Run Definition.
Life Cycle State*The life cycle state Life Cycle State of the notification run definitionNotification Run Definition. The supported values are effective and not effective. Only effective notification run definitions 'Effective' and 'Not Effective'. Only 'Effective' Notification Run Definitions can be used to generate notificationsNotifications.
Unified Code*An auto-generated code which is used to group the various instances of the notification run definitionsNotification Run Definitions
Version*

An auto-generated number which is used to specify the version of each

notification run definition. New notification run definition versions are created each time they are edited, if they are already been used to generate notifications

Run Definition. If the version is already in use by a Run, a new Run Definition Version is created each time the Definition is edited.

The VIEW PREVIOUS VERSIONS link enables the user to search and view previous versions of the Definition.

Scheduled DateThis is a Read-only field which is available once a Run is scheduled. The date provided shows the latest date that the Run is scheduled to be executed on.
Notification Type*

The

type

Type of

notification

Notification that will be created

whenever the notification run definitions

when the Notification Run Definitions are used to generate

notifications
Scheduling Settings*

Determines when the process run definition should be applied. Process run definitions can be applied ad hoc or on a recurring basis. Scheduling settings hold the following information:

  • Method: It provides the following options. For each option different settings are provided:
    • Run now
    • Run on specific Date / Time
      • Specific Date / Time
    • Repeat
      • Start at
      • End by Date / Time
      • Every X UOT
    • Advanced Repeat
      • Start at
      • End Date
      • Recurrent Mode Settings
  • Start at: It determines the date and time that the process run definition should be applied. If the run now option is selected then the date / time is read only and set to 30 seconds after saving the record. Two options are available
    • Specific Date / Time
    • After X UOT: measured in seconds, minutes, hours, days, weeks or months
  • End by Date / Time: It determines the latest date and time that the process run definition should be applied. This is available only if the repeat option is selected. Three options are available
    • No End Date
    • Specific Date / Time
    • After X UOT: measured in seconds, minutes, hours, days, weeks or months
  • Every X UOT: It determines how often the process should be generated. The process run definitions can be scheduled to be applied per seconds, minutes, hours, days, weeks or months. This is available only if the repeat option is selected.
  • Recurrent Mode Settings: It determines specific recurrence settings that can be applied per day, week, month or year. This is available only if the advanced repeat option is selected
  • Throttling:  It determines the maximum number of processed records that should be affected per each run and the interval between each iteration. This is available only if the repeat and advanced repeat options are selected. Throttling settings include the following
    • Maximum batch size
    • Start again after X UOT (seconds, minutes,hours, days)

Notifications.
The list of available Notification Types will be filtered according to the Classification selected on creating a new Notification Definition.

  • Customer Care Process
  • Financial Process

Status
colourBlue
titleAvailable from CRM.COM R12.0.0
Existing Notification Type can be selected but a new one can also be created through the Notification Run Definitions.

Logging Method

Status
colourBlue
titleAvailable from CRM.COM R12.0.0

Defines the method to be used for logging process run's results. Two options are available:

  • Log Processed Successfully and Processed with Errors: If selected, both entities successfully processed and failed ones will be logged in the Process Run Log.
  • Log Only Processed with Errors: If selected then only entities which failed to be processed will be logged in the Process Run Log.

Criteria

Note

Status
colourBlue
titleDEPRECATED FROM CRM.COM-R12.0.0 ONWARDS
From R12.0.0 onwards, the Criteria section is removed from Notification Run Definitions and moved to Notification Types.

 

Segment Criteria
Included in Segment

A list of segments Segments which are used to filter in the contact information or the accounts receivable the Contact Information, Accounts Receivable or Notification Item that will be notified, and optionally the notification information. The criteria consist .

Note

Segments with one of the following

:
  • Filtered entity: A select box displaying the main notification entity (i.e. contact information or Accounts receivable) and the entity which is selected in the notification information. The specified entity will be filtered while evaluating the results
  • Segment: A select box with all the segments having the selected filtered entity as the segment entity
Not Included in Segment

A list of segments which are used to excluded the contact information or the accounts receivable that will be notified, and optionally the notification information. Its criteria consist the same as in "Included in Segment"

main entities are available:

  • Contact Information
  • Accounts Receivable
  • An entity included in the related Notification Item, determined by the Notification Type.
Excluded from Segments

A list of Segments which are used to prevent Contact Information, Accounts Receivable or Notification Items from being notified.

Note

Available options are the same as those of "Included in Segments".

Notification History Criteria
Notified Previously

Defines a list of notifications Notifications that should have already be been generated in the pastfor the criterion to be considered as met. It consist of includes the following valuesoptions:

  • Notification Type: The type of the notificationTyp
  • Life Cycle State: The life cycle state of the notification. The default value is the completed.
  • Created less than X UOT ago : measured (measured in minutes, days, weeks, months or years)
  • Created more than X UOT ago : measured (measured in minutes, days, weeks, months or years)
Not Notified Previously

Defines a list of notifications Notifications that should not already exist. Its values ; i.e. the customers have not been sent these Notifications previously.

Available options are the same as in those of "Notified Previously".

Accounts Receivable Criteria

Note

Only available for Financial Notification Run Definitions

 

Accounts Receivable Balance

It filters the accounts receivable Filters the Accounts Receivable based on their balanceBalance. Two options are available, which can be used combinedin tandem:

  • More than:checks for a value that is more than or equal to the one specified (≥).
  • Less than: checks for a value that is less than the one specified (<).
Accounts Receivable Outstanding Amount

It filters the accounts receivable based on their outstanding amount Filters the Accounts Receivable based on Outstanding Amount and a specific due date. Two options are available, which can be used combinedin tandem:

  • More than:checks for a value that is more than or equal to the one specified (≥).
  • Less than: checks for a value that is less than the one specified (<).

The due date can be specified in one of the following ways:

  • Due in X Days: The System checks for Accounts whose outstanding amount is due up to a date equal to the current date + X (a user-defined integer representing a number of days). For example, if the current date is the 23rd of the month and X is set as 5, the System retrieves accounts with outstanding amounts due up to the 28th.
  • Due X days ago: The System checks for Accounts whose outstanding amount was due up to a date equal to the current date - X (a user-defined integer representing a number of days). For example, if the current date is the 23rd of the month and X is set as 5, the System retrieves accounts that were due up to the 18th.
Accounts Receivable ClassificationIt filters the accounts receivable Filters the Accounts Receivable based on a list of accounts receivable classificationsAccounts Receivable Classifications.

Status
colourYellow
titleDeprecated from CRM.COM-R11.0.0 onwards

Accounts Receivable Credit Rating

It filters the accounts receivable Filters the Accounts Receivable based on a list of accounts receivable credit ratingsAccounts Receivable Credit Ratings.

Notification Criteria

Note

Only available for Financial Notification Run Definitions

 

Total Outstanding Amount per Notification

It filters the notifications that will Filters the Notifications to be created based on the total outstanding amount of each notificationNotification, as calculated based on the related calculated using associated respective invoices. Two options are available, which can be used combinedin tandem:

  • More than:checks for a value that is more than or equal to the one specified (≥).
  • Less than
Criteria - Wallet Criteria
  • : checks for a value that is less than the one specified (<).

Wallet Criteria

Note

Only available for Financial Notification Run Definitions

 

Wallet Balance

It filters the accounts receivable Filters the Accounts Receivable based on the wallet balance Balance of wallets Wallets owned by that account.  Two options are available, which can be used combinedin tandem:

  • More than:checks for a value that is more than or equal to the one specified (≥).
  • Less than: checks for a value that is less than the one specified (<).
Wallet Estimated Consumption Days

It filters the accounts receivable Filters the Accounts Receivable based on the wallet estimated consumption days of wallets Wallets owned by that account.  Two options are available, which can be used combinedin tandem:

  • More than:checks for a value that is more than or equal to the one specified (≥).
  • Less than: checks for a value that is less than the one specified (<).
Wallet Product Estimated Consumption Days

It filters the accounts receivable Filters the Accounts Receivable based on the wallet product Product estimated consumption days of wallets Wallets owned by that account.  Two options are available, which can be used combinedin tandem:

  • More than:checks for a value that is more than or equal to the one specified (≥).
  • Less than: checks for a value that is less than the one specified (<).

Wallet Amount Expiration Up To Date

Status
colourYellow
titleAvailable from CRM.COM R11.1.0

Filters the Wallets based on the amount that will expire by a defined date.

  • Date

Optionally, an amount to be expired by the specified date which is greater than

or equal to a specified minimum (amount) can be used to filter the Wallets.

  • Minimum Expiration Amount
Note

A minimum expiration amount cannot be provided without an expiration date.

Subscription Criteria

Note

Only available for Financial Notification Run Definition

 

Subscription Types

It filters the accounts receivable Filters the Accounts Receivable based on the type Type of subscriptions Subscriptions owned by the accounts receivable. Multiple subscription types can be defined. Accounts Receivable.

Billing Term SchemesIt filters the accounts receivable Filters the Accounts Receivable based on the billing term schemes of subscriptions owned by the accounts receivable. Multiple billing term schemes can be definedBilling Term Schemes of Subscriptions owned by the Accounts Receivable.

Status
colourYellow
titleDeprecated from CRM.COM-R11.0.0 onwards

Price Plans

It filters the accounts receivable Filters the Accounts Receivable based on the price plans Price Plans of subscriptions Subscriptions owned by the accounts receivable. Multiple price plans can be definedAccounts Receivable.
Status
colourYellow
titleDeprecated from CRM.COM-R11.0.0 onwards

Billing Frequencies
It filters the accounts receivable Filters the Accounts Receivable based on the billing frequencies Billing Frequencies of subscriptions Subscriptions owned by the accounts receivable. Multiple billing frequencies can be defined
  
  
  

Configuring a Notification Run tailored to your company's needs

  • Navigate to PATH
     
  • Either search for an existing one or from the Top Menu click on NEW

    MAIN INFORMATION

     
  • CRITERIA

  • SCHEDULING SETTINGS

    Include PageScheduler Task - GlobalScheduler Task - Global 

    LOG INFORMATION

    Include PageWIP:Log Information - GlobalWIP:Log Information - Global
  • From the Top Menu click on Save
  • Executing a Notification Run

    Include PageExecuting Runs - GlobalExecuting Runs - Global

    Modifying a Notification Run

     

    Include PageVersioningVersioning

    Deleting a Notification Run

    Deleting a scheduled job of the specific Run

    Include PageDeleting a run- GlobalDeleting a run- Global

    Changing the Life Cycle State of a Notification Run definition

    Include PageChange Life Cycle State of a Run definition - GlobalChange Life Cycle State of a Run definition - Global

    Reading Notification Run Logs

    Include PageReading Run Logs - GlobalReading Run Logs - Global NoteVisit /wiki/spaces/WIP/pages/10010220 Notification Run for business examples related to Notification Run
    Accounts Receivable.
    Status
    colourYellow
    titleDeprecated from CRM.COM-R11.0.0 onwards

    Binding Periods
    Filters the Accounts Receivable based on the Binding Periods of Subscriptions owned by the Accounts Receivable.
    Status
    colourYellow
    titleDeprecated from CRM.COM-R11.0.0 onwards

    Binding State
    Filters the Accounts Receivable based on the Binding State of Subscriptions owned by the Accounts Receivable.
    Scheduling Setting
    Scheduling SettingsMethod - The following options are available:
    • Run Now
    • Run on Specific Date / Time
    • Run Repeatedly
    • Advanced Scheduling

    Refer to Scheduler Task for configuration guidelines.

    Throttling Settings
    Throttling Settings

    Determines the maximum number of processed entries that should be affected per Run and the interval between each Run. This is available only if the Repeat and Advanced Repeat options are selected. Throttling settings include:

    • Maximum Batch Size 
    • Start Again After X UOT (seconds, minutes, hours, days) 
    Note

    Throttling Settings can be configured only if Logging Method is set to 'Log Processed Successfully and Processed with Errors'.

    Process Runs
    Process RunsDisplays the Runs that were executed for the specific Definition. Each Run includes the Subscriptions that were processed. Incase of an error, the error code and descriptionis displayed.
    Log Information
    Log DetailsThe standard set of Log Details information available in all entities.
    Note

    View Understanding Notifications for business examples related to Notification Runs.

    Panel
    namegrey

    Related Areas

    Filter by label (Content by label)
    showLabelsfalse
    spacesV4Manual
    showSpacefalseexcerpttrue
    labelsmodulenamenotifications-basics-r7,$modulenamenotifications-advanced-r7,modulenamenotifications-admin-r7

    Popular Labels

    heatmap
    Panel
    namegrey
    Popular Labels
    spaceKeyV4Manual
    style

    Helpful Links

    Filter by label (Content by label)
    showLabelsfalse
    spacesV4Manual
    showSpacefalse
    labelsglobal