Business Events
Business Events
No part of this document may be reproduced or transmitted in any form or by any means, for any purpose, without the express written permission
of TEMENOS HEADQUARTERS SA.
Table of Contents
Introduction 3
Purpose of this Guide 3
Intended Audience 3
Business Events Configuration 4
Architecture of Events 6
Configuring an Account Officer to receive Alerts 10
Configuring customer preferences to manage Alerts 11
Current Defined Event Types 12
Business Events Deal Processing 18
Subscription to an Event by an Account Officer 19
Subscription to an Event for an Account or Arrangement 20
Subscription to Events 21
Delivery 23
Business Event Services 24
TEC Subscribers 25
Delivery 26
AA Arrangement Service 27
AA Linked Arrangement 28
2
Business Events
Introduction
Purpose of this Guide
The Instant Messaging (aka Business Events) User Guide provide a profound insight
into configuration, working and usage of the Core Banking BE module.
Intended Audience
This User Guide is intended for Core Banking Customers, Internal Stakeholders and
those who use and implement the BE module.
3 Introduction
Business Events
Before delving into the details of the Alerts and Notifications functionality, it is
important to understand the significance of ‘Event Types’ or in other words, ‘Pat-
tern’ of events.
The purpose of the ‘Event Type’ is to allow implementations to add more events
without any additional code. At the same time, the Event type should not be at such
a high level and generic as to be able to fit 100 events into one bucket.
It is anticipated that the event types identified here may not cover absolutely every
event that could happen in a banking system and there could certainly be some
exceptions to these patterns.
The rationale is to prevent this minority of exceptions from impeding the per-
formance of the majority of most common events.
An event type is a classical grouping of similar events into a group. For example,
consider the following events.
When an account is credited and the credit amount is greater than 5,000 (“Large
Deposit”)
When an account is credited and the transaction code is a ‘Salary Credit’
Whenever an account is credited
All of these events can be logically grouped under an Event Type called “CR.TXN”
and supplemented with additional criteria based on values in the fields in respective
STMT.ENTRY records.
When an account is debited and the debit amount is greater than 5,000 (“Large
Withdrawal”)
When an account is debited and the Channel is ATM POS (Point Of Sale) purchase.
Whenever an account is debited:
All of these events can be logically grouped under an Event Type called “DR.TXN”
and supplemented with additional criteria based on values in the fields in respective
STMT.ENTRY records.
It is indeed possible to group all the above into one type called “TXN” but that
would move the level of grouping to one level higher, which in turn increases the
unnecessary processing that would be done by TEC every time an event occurs.
l Architecture of Events - how they are defined
l Configuring an Account Officer to receive Alerts
l Configuring customer preferences to manage Alerts
l Current Defined Event Types
Architecture of Events
There are two underlying parameter tables used for Event Definition: these are
EB.EVENT.TYPE and TEC.ITEMS. These two are discussed below:
EB.EVENT.TYPE
EB.EVENT.TYPE is the touchpoint between the actual event happening in T24 and
the TEC.ITEMS configuration. T24 Model Bank supplies a number of ‘touchpoints’
whereby an event can be indicated to have happened.
The majority of touchpoints are instances where a table is updated. However, there
are also some touchpoints, which are not triggered from the update of a table – for
example, Direct Debit and Standing Order executions and failures.
For a list and explanation of these EVENT.TYPEs, click here.
When an EB.EVENT.TYPE is called, it can also supply the delivery instructions that
should result from this event type - an EB.ACTIVITY value is specified, which in turn
links to an EB.ADVICES record, which in turn link to the DE.MESSAGE functionality.
TEC.ITEMS:
This table handles both technical alerts (errors in processing) and business alerts
(information for customers and account officers about business events). As this wiki
relates to business alerts, we can discuss the business related fields here.
It is likely that the overall touchpoint is too high-level to be of use for determining
an event. For example, we may not want to know every time a record changes - but
we want to know when a particular field on that record changes.
Through TEC.ITEMS, the bank can fine-tune the nature of the event – we may not
want an event to be generated every time a ‘touchpoint’ (EB.EVENT.TYPE) is
triggered, but possibly under specific circumstances. It is to these fine-tuned cir-
cumstances that the user then subscribes. TEC.ITEMS clarifies the nature of the
Event through the following settings:
Subscriber
When an event occurs, through which medium should the alert be communicated?
Model Bank comes configured with the functionality to communicate this over the
DELIVERY system. In future, other subscribers such as Process Workflow or a Busi-
ness Activity Monitoring mechanism may be included.
Which Event type is being used? (i.e what is the underlying touchpoint) –
This is set in the EVENT.TYPE field.
Subscription Type
Can this event be monitored by customers, account officers, both, or is it man-
datory for everyone affected?- this is set in the SUBSCRIPTION.LEVEL field. There
are queries in model bank, and validation to ensure that internal subscribers
(account officers) cannot subscribe to external events, and vice-versa.
Precedence
It is likely that some events may take precedence over others – for example, I may
have an event to alert me when my balance falls below 100, and another event,
which alerts me when my overdraft limit is exceeded. In this case, I might want to
only receive the second alert if a single transaction triggers both alerts. This is set
in the PRECEDENCE field.
Event Severity
Severity – Each TEC.ITEMS can be classified with a severity level. This is used for
information/reporting purposes. Can be used to determine the alert carrier.
Active / Inactive
A TEC.ITEMS can be switched on/off for all subscribers through a STATUS field.
When it is set to ‘Inactive’ then this TEC.ITEM does not get triggered.
Keywords
Sometimes, it may not be possible to determine whether an event has happened
purely through looking at the fields that were used, and the values in them.
Examples of these could be an event being raised when:
A record is reversed (so event based on FUNCTION used).
A particular VERSION is used.
After the FIRST authorizer (not necessarily the final authorizer)
A particular CHANNEL is used (so an event occurs if channel A is used, but not chan-
nel B).
A particular APPLICATION is used.
To cover this requirement, it is possible to use Keywords rather than a specific
table. Keywords allowed are :
- !APPLICATION (Application)
- !V$FUNCTION ( Function)
- !PGM.VERSION( Version of the Application)
- !CHANNEL ( Channel defined in ofs.source)
- !AUTH.NO ( No of Authorisers)
Note, in order for events to be processed in order to generate alerts, the relevant
services need to be run. See the SERVICES section for more information.
Learning how to configure and use events is best explained by the following
examples.
For examples of how to use the Events functionality, see the related How To Guides.
As Alerts makes significant use of other T24 functionality, there is significant con-
figuration that can be applied, some of which is specific to Alerts / Events, and
Create a new EB.ALERT.REQUEST record, specify the event that should be linked,
and the Account or the Arrangement that the event is linking to.
Subscription to Events
Subscription occurs through the application EB.ALERT.REQUEST.
The TEC.ITEMS refinement to EB.EVENT.TYPE is placed in the EVENTS field.
If the event is being subscribed to by a customer, either an ACCOUNT or
ARRANGEMENT is placed in the Contract Ref field.
If the event is being subscribed to by an account officer, the account officer is
placed in the ACCOUNT.OFFICER field.
If the TEC.ITEMS record specified in the Event field has one or more fields which
requires an ‘inherited’ value, these need to be provided. The system automatically
multivalues the Value field to reflect the values that must be entered to satisfy the
event definition.
Delivery
Event Management links to DELIVERY through the specification of an EB.ACTIVITY
record in the EB.EVENT.TYPE setting – so when this event type is triggered, this
delivery setting is consulted to determine how the alert should be set.
Delivery module can be set as a Subscriber to an Event (TEC.ITEMS) by setting the
field SUBSCRIBER as DELIVERY.ALERT.
When an Event is Published, the Delivery Alert as a Subscriber converts the Event
data as standard DE Handoff data and hands it off to the Delivery module which
then takes care of formatting and delivering the notification.
For more information about delivery, refer to ‘How to Change a Delivery Alert Mes-
sage’ guide.
23 Delivery
Business Events
TEC Subscribers
This section covers the following sub-topics:
l Delivery
l AA Arrangement Service
l AA Linked Arrangement
25 TEC Subscribers
Business Events
Delivery
Event Management links to DELIVERY through the specification of an EB.ACTIVITY
record in the EB.EVENT.TYPE setting – so when this event type is triggered, this
delivery setting is consulted to determine how the alert should be set.
Delivery module can be set as a Subscriber to an Event (TEC.ITEMS) by setting the
field SUBSCRIBER as DELIVERY.ALERT.
When an Event is Published, the Delivery Alert as a Subscriber converts the Event
data as standard DE Handoff data and hands it off to the Delivery module which
then takes care of formatting and delivering the notification.
For more information about delivery, refer to ‘How to Change a Delivery Alert Mes-
sage’ guide.
TEC Subscribers 26
Business Events
AA Arrangement Service
Services that are offered to Accounts are accessed via T24 Applications. Each
product is defined in T24 using the Application and the Application Type. For
example FT application has FTTC , STO has STO.TYPE, RS has AC.SWEEP.TYPE. There
can be a need to restrict such services being offered to Account.
EB.EVENT.TYPE is created for such services using Application name – SERVICE. For
instance AC.ACCOUNT.LINK – SERVICE. TEC.ITEMS can be created for such Service
events with Inline Subscriber. Such TEC.ITEMS with inline Event types (Application-
SERVICE) are used in AA to evaluate the service in product. Example Maintenance
Sweep allowed or restricted for an account. The TEC items created for Events and
are mapped to AA activity via Activity Mapping. Thus Events on external accounts
are mapped to activities in AA. These Activities can be fully or partially restricted
using Facility Property Class. Facility Property class is used to restrict or provide the
facility as part of a package for the account. To learn in detail please read Facility
property class.
27 TEC Subscribers
Business Events
AA Linked Arrangement
AA Linked Arrangement can be set as a Subscriber to an Event (TEC.ITEMS) by set-
ting the field SUBSCRIBER as LINKED.ARRANGEMENT.
Whenever an Event is raised from an Arrangement the Linked Arrangement Sub-
scriber API checks if the Arrangement is linked to Bundle and if the Bundle is inter-
ested in this Event (that is if this Event is mapped to a Bundle Activity in the
Bundle’s Activity Mapping condition). If there is a mapping then it resolves the Activ-
ity name, builds an OFS for AA Arrangement Activity and hands it off to the AA Pro-
cess Activities Service.
TEC Subscribers 28