Differenze tra le versioni di "EEM - External Event Management"

Da itm wiki.
(Etichetta: visualeditor)
(Passive channel)
(Etichetta: visualeditor)
Riga 10: Riga 10:
 
=== Passive channel ===
 
=== Passive channel ===
  
In this mode, ''[[Glossary|EEM]]'' makes available web services in order to pass data.''<nowiki/>''   
+
In this mode, ''[[Glossary|EEM]]'' makes available web services in order to acquire data.''<nowiki/>''   
  
 
=== EEM process steps ===
 
=== EEM process steps ===
 
''[[Glossary|EEM]]'' works on inbound messages received by means of the active or passive channel through a three steps process:
 
''[[Glossary|EEM]]'' works on inbound messages received by means of the active or passive channel through a three steps process:
# EEM processes and validates the incoming message
+
# ''[[Glossary|EEM]]'' processes and validates the incoming message
# MB dispatch the message to a subscriber
+
# ''[[Glossary|EEM]]'' passes processed messages to ''[[Glossary|message bus]]'' which, in turn, dispatches them to the recipients (the ''[[Glossary|modules]]'' configured to subscribe to the message)
# itmSUITE® module through''[[Glossary|Action Engine]]''execute the required task
+
# itmSUITE® recipient ''[[Glossary|module]]'' performs the configured tasks for the received message by means of the ''[[Glossary|action engine]]''
  
EEM forwards the received data towards itmSUITE® destination module sending them through the''[[Glossary|message bus]]''component which works as a dispatcher. The final step of the process is performed in the destination itmSUITE®''[[Glossary|module]]''
+
The above mentioned three steps process is illustrated in the figure below.
 
 
means of the action engine which exectues the the MB manage the message queue and dispatch towards the subscriber (other 'modules'' of''itmSUITE® as SM/PM, CMS or EEM)
 
 
 
 itmSUITE®module received the message and based on the rule configured in Action Engine execute tasks (eg.: Ticket creation, ticket updating , sending notification, ect.)
 
 
 
Outbound notification are managed directly the itmSUITE® modules eg. PM/SM
 
 
 
*
 
  
 
[[File:EEM inbound schema v1.0.JPG|centre|thumb|500x500px|EEM inbound schema]]
 
[[File:EEM inbound schema v1.0.JPG|centre|thumb|500x500px|EEM inbound schema]]

Versione delle 07:28, 18 ago 2015

EEM - External Event Management is one of the complementary modules of itmSUITE®. The module is aimed to enable interactions between itmSUITE® and third party applications (interfaces). The supported direction of the data flow is from the external application to itmSUITE® (input). It is possible to define and implement outbound data flow and interfaces by using the action engine component of the itmSUITE®.

The module can receive information (inbound messages) with two modes which may be activated at the same time:

Active channel

In this mode data acquisition is made by means of mails. EEM verifies at regular intervals the existence of mail messages in a configured mailbox and processes them when found.

Passive channel

In this mode, EEM makes available web services in order to acquire data.

EEM process steps

EEM works on inbound messages received by means of the active or passive channel through a three steps process:

  1. EEM processes and validates the incoming message
  2. EEM passes processed messages to message bus which, in turn, dispatches them to the recipients (the modules configured to subscribe to the message)
  3. itmSUITE® recipient module performs the configured tasks for the received message by means of the action engine

The above mentioned three steps process is illustrated in the figure below.

EEM inbound schema


Inbound Comunication

As mention above, this communication can be managed through:

  • Active channel
  • Passive channel

The paragraph below shown the main step necessary to configure them.

Active channel

The activity to perform to correctly set up this configuration are:

  • Define one or more Active configuration channel
  • Implement a validation rule via MSC (Monitoring System Configuration)

Using EEM Menu Active Notification Channels is possible to define the parameter necessary to access, one or more, mailbox.

The image below shown the parameter to insert to configure a mailbox

EEM Active channel

An MSC (Monitoring System Configuration) is composed by General and Parameter informations.

The image below shown the General tab used by the system to validate the incoming data

EEM MSC General Configuration

The image below shown the Parameter tab used by the system to collect information present on a message.

EEM MSC Parameter Configuration

One message is validated if the Identification Strategy is respected and all the parameters are presents into the body of message

Passive channel

When itmSUITE® is called from third parites system is necessary to define the validation rule using the MSC (monitoring sytem configuration) session.

In this case, a client call is accepted if the Request Identification tag and the expected Parameters are properly passed into the SOAP message.

The image below shown a MSC (monitoring sytem configuration) configuration session.

EEM Passive Configuraiton

Action Engine Configuration

When the incoming message is validated by EEM, the informations are sent to MB (Message Bus) that dispatch it to the itmSUITE® Action engine and a configured Action is activated.

Action Engine enabled the user to configured an Action and the activation condition. An action is composed by:

  • General Information
  • Trigger and Activation condition
  • Parameters
  • Tasks to execute

the following images shown the action' user interface and provide some more detail about this functionality

Action Configuration


Condition'tab enable the user to define a Boolean condition that should be verify before activate the action' . Generally the conditions works on input Parameter.

Action Configuration

Tasks tab enable the user to define one or more task that will be executed sequentially if the condition is valid. The system manage different type of task, the most flexible and powerful is Scripting task, based on Javascript framework, enable the user to call itmSUITE® primitive

Action Task Configuration

Outbound Comunication

itmSUITE® module can send information towards third parties software using scripting tasks. This can be performed:

  • Sending a preformatted mail
  • Calling a third parties web services


Action Task Configuration