SOP-MES0038 Notification & Escalation

42Q Home > Administration > Notification & Escalation

 

 

 

Administration Notification & Escalation Version MES15 Portal 1.0 Work Instruction

 

This Work Instruction is 42Q's corporate standard. This document is under revision control. The latest revision is located on Intranet. Once printed it is an uncontrolled copy. All alterations to this work instruction require approval. Contact the IT Global Education and Training Department to submit suggested alterations and or updates.

This edition applies to MES 15 Portal 1.0 Application and all subsequent releases and modifications until otherwise indicated in new revisions.

 

Introduction

This edition applies to MES15 Portal 1.10 (Notification and Escalation Module) and all subsequent releases and modifications until otherwise indicated in new revisions.

Notification and Escalation was created to simplify the alert process (SMS, e-mail, and portal notification). Corporate Administrators can access a single instance (DB) that contains all previously stored events.

The application is divided into two modules: Notification and Escalation (Administration) and Notification and Escalation Operation (Shop Floor Control > Production Control).

Notification and Escalation can be accessed by the following paths:

1. Administration >

Notification & Escalation

2. Shop Floor Control >

Production Control >

Notification and Escalation – Operation

Notification and Escalation

This module located under the Administration node was developed to create an event template. The event template is configured in the Module, Instance and Rule sub-modules.

1. To access Notification and Escalation, navigate to Administration >

Notification & Escalation.

2. The Notification and Escalation main page displays with the following sub-modules available:

• Module- Defines the application and the version for the notification.
• Instance- Defines which modules to use at a specific site.
• Rule- Defines the parameters for the notification.

Figure 1: Notification and Escalation

Module

The Module portlet defines from where the notification is coming. In this portlet, the user can define the third-party application and its version to be used when the notification or escalation is created. The modules that are created can be assigned to instances in the Instance portlet.

1. To access the Moduleportlet, navigate to Administration >

Notification and Escalation, and then select the Module icon.

Figure 2: Notification and Escalation - Module

2. The Module List displays:

Figure 3: Module List

From the Module List main page, the user can filter by Name or Active status.   Modules can also be configured with the Add, Edit, and Delete functions.

Filter

The Module List displays all created modules. Each module ’

s description and status (Active or Inactive) is also displayed. The user can filter the list by Name or Active status.

1. To filter the list, enter a module name and/or select the active status from the Active drop down box.

2. Select Filter to filter the list, or Clear to clear the fields.

Figure 4: Filter Modules

Add Module

The Add function allows the user to add third-party applications to the Notification and Escalation database. When adding an application, the user must provide a description and version to aid in the module selection process.

1. To add a module, select the Add icon from the tool bar above the Name list.

2. The Module Element form displays:

Figure 5: Add Module

3. Enter the Name and Description of the application into the mandatory fields.

4. Select Active to display the module in the Rule and Instance portlets.

Note: If this flag is not selected, the application and version will not display in the subsequent steps in the Notification and Escalation process.

5. Select Save to create the module. "Are you sure you want to save the changes?" confirmation message displays. Select Yes to confirm or No to cancel.

Add Version

The user can add a version to an application when creating a module. It is important to have versions identified for each application. There can be many versions for a single application. If the version is included in the module, it is easier to identify the specific application to which the notification applies.

1. To add an application version while creating a module, select the Add icon from the Version List panel in the Module Element form.

2. The Version and Description fields become available.

3. Enter the version and the description into the applicable fields, and then select Update.

4. Mark the Active flag to make the version available in the Instance and Rule portlets.

Figure 6: Add Version

Delete Version

If a version is no longer supported or applicable, the user can delete it from the version list. This will remove the version from the application and it will no longer be available in the Instance or Rule portlet.

1. To delete an application version, select the version from the list, and then select Delete.

Figure 7: Delete Version

2. Select Save to confirm the delete action. "Are you sure you want to save the changes?" confirmation message displays. Select Yes to confirm or No to cancel.

Note: If Save is not selected, the version will not be deleted and cannot be re-entered. The following prompt will display:

Figure 8: Error Message

Edit Version

1. To edit a version, double-click on the version in the Version list.

2. Edit the information, and then select Update.

3. Select Save to confirm.

Edit Module

The Edit function allows the user to update any of the module ’

s information (Name, Description, Active status, or Version).

1. To edit a module, select the module from the Name list, and then select Edit.

2. The Module Element form displays:

Figure 9: Edit Module

3. Update the Name and/or Description (or the active status), and add or remove versions, and then select Save.

4. "Are you sure you want to save the changes?" confirmation message displays. Select Yes to confirm or No to cancel.

Delete Module

If a Module is no longer supported or applicable, the user can delete it from the module list. This will remove it from the Notification and Escalation tool, and it will no longer be available in the Instance or Rule portlet.

1. To delete a module, select the module from the Name list and then select Delete.

2. "Are you sure you want to delete (xxxx)?" confirmation message displays. Select Yes to confirm or No to cancel.

Figure 10: Delete Module

Instance

The Instance portlet defines which modules to use at a specific site. In this portlet, the user can choose which third-party application and its version to be used when the notification or escalation is created.

1. To access the Instanceportlet, navigate to Administration >

Notification and Escalation,and then select the Instance icon.

Figure 11: Notification and Escalation - Instance

2. The Instance main page displays:

 

Figure 12: Instance List

Only pre-configured instances will display. The user can add modules (applications/versions) to specific sites from the Instance portlet.

Edit

The edit function allows the user to add modules to specific sites. The modules that are available to the user are pre-configured in the Module portlet. TheApplication andVersion must be set to Active in the Module portlet in order to be displayed in the Instance portlet.

1. To add a module to an instance, select the instance from the Instance list, and then select Edit.

2. The Deployed Element form displays:

Figure 13: Edit Instance

All previously added modules are displayed in the Module drop-down list.  TheVersion of theModule as well as theName can also be selected, and theActive

Add Module

1. To add a module, select the Add icon from the tool bar in the Deployed Element form.

2. A new row will display with a module, version, and name drop down boxes, and an empty radio button for Active status selection.

3. Select a Module and Version, enter theName, and then mark the Active radio button to make the module available for notifications in the Rule portlet.

4. Select Update to add the module.

5. Select Save to confirm the module addition, or Close to exit.

 

Figure 14: Add Module

Delete Module

1. To delete a module, select the module from the list and then select Delete.

2. "Are you sure you want to delete (xxxx)?" confirmation message displays. Select Yes to confirm or No to cancel.

3. Select Save to confirm the delete command, or Close to exit.

Figure 15: Delete Module

Rule

The Rule portlet defines the parameters for the notification. When adding a rule, the user can add Flow Steps, Action Steps and specific parameters to define retry times and quantities. When a notification is created, the parameters set up in the Rule portlet dictate the options that will be available in the Notification and Escalation – Operation portlet.

1. To access the Rule portlet, navigate to Administration >

Notification and Escalation, and then select the Rule icon.

Figure 16: Notification and Escalation - Rule

2. The Rule main page displays:

Figure 17: Rule List

The user can filter, add, edit, delete, or copy rules in this portlet.

Filter

The Rule list can be filtered by Rule Key,Rule ID,Description,Instance,Element,or Active Status.

1. To filter the rule list, enter information into the filter fields and/or select from the drop down boxes provided, and then select Filter.

2. Select Clear to empty all fields and start a new filter.

Figure 18: Filter Rules

3. The results will display in the Rule Key list.

Add Rule

1. To add a rule, select the Add icon from the tool bar.

2. The Rule Template form displays:

Figure 19: Add Rule

3. Enter a Rule ID and a Description.

4. Select and Element from the drop down list provided.

5. Select Save to confirm, or Close to cancel.

6. "Rule Template (Rule ID) was successfully created" message displays.

Add Flow Step

Flow steps need to be defined for each rule. These steps define the parameters that the notification will follow once created.

1. To add a Flow Step, select the Add icon from the Flow Steps panel in the Rule Template.

Figure 20: Add Flow Step

2. The Flow Steps form displays:

Figure 21: Flow Step Form

There are three panels in the Flow Steps form:

• Configuration
• Retry
• Condition

3. Select a Step Number and then enter a Description from the Configuration panel.

4. Select the radio button to the right of Secondary Action or Read Receipt if applicable. Select the radio to the right of Active to make the Rule available in the Notification and Escalation – Operation portlet.

5. In the Retry panel, select the Time (hour) and the Quantity. This defines how often and how many times the notification will be sent before an escalation is required.

6. In the Condition panel, select the Type (Logical or Timed). If Logical is selected, define the Parameter, Logical Operator, and Value of the rule. If Timed is selected, select the Time (hour).

7. Select OK to save the flow step, or Close to exit.

Edit Flow Step

1. To edit a Flow Step, select the step from the list and then select Edit.

Figure 22: Edit Flow Step

2. The Flow Steps form displays. All fields are available to edit.

3. Update the desired information and then select OK.

Delete Flow Step

1. To delete a Flow Step, select the step from the list, and then select Delete.

Figure 23: Delete Flow Step

2. "Are you sure you want to delete Step (n)?" displays. Select Yes to confirm or No to cancel.

Add Action Step

The user has the option to add Action Steps to Flow Steps. Action Steps allow the user to define the notification type (Email/SMS/portal notification), the information that the notification will contain, as well as the recipients.

1. To add an Action Step, select the Add icon from the tool bar under the Action Steps panel in the Flow Steps form.

Figure 24: Add Action Step

2. The Action Steps form displays:

Figure 25: Action Steps Form

3. Select a Type for the action step (Email, SMS, portal notification).

4. Select the Active radio button to make the Action Step available in the Notification and Escalation – Operation portlet.

5. Enter a Description and a Subject.

6. In the Body Template, the user can create and use parameters that will be replaced by the value defined in the Create Event portlet. For example, a parameter could be replaced by a list of users defined. The format for the parameter must be {

&parameter_name }

.

Note: It is allowed to use parameters in any field of the Action Step.

7. Enter recipient credentials into the To: field. Multiple recipients can be added if they are separated by a comma. Add any additional recipients that need to be copied to the notification should be placed into the CC: and Bcc: fields.

Note: Format for phone numbers is: 0 + Country Calling Code + Prefix + 7 digit number (no hyphens and no spaces). Example: 012058384821

8. Select OK to save the Action Step.

9. Select OK from the Flow Steps form to confirm the addition of the Action Step.

Edit Action Step

1. To edit an Action Step, select the step from the Action List from the Flow Steps form, and then select Edit.

2. The Action Steps form displays:

Figure 26: Edit Action Step

3. Update the Action Step and then select OK.

4. Select OK from the Flow Steps form to confirm the editing of the Action Step.

Delete Action Step

1. To delete an Action Step, select the step from the Action List from the Flow Steps form, and then select Delete.

2. Select OK to confirm the delete command of the step from the Flow Steps form.

Figure 27: Delete Action Step

Edit Rule

Rules can be edited or updated when needed. All fields except for the Rule Key can be changed.

1. To edit a rule, select the rule from the Rule Key list on the Rule main page, and then select Edit from the tool bar.

2. The Rule Template form displays:

Figure 28: Edit Rule

3. Edit/update the information, and then select Save to confirm.

Delete Rule

Rules can be deleted when they are no longer needed. All information contained within the Rule will be deleted as well.

1. To delete a Rule, select the rule from the Rule Key list on the Rule main page, and then select Delete from the tool bar.

2. A Confirm pop-up displays. Select Yes to confirm orNo to cancel.

Figure 29: Delete Rule

Copy Rule

Rules can be copied to make the Rule creation process more efficient. When Rules are copied, all information within the Rule will be copied as well. Only the Action Steps have the option to be excluded.

1. To copy a Rule, select the rule from the Rule Key list on the Rule main page, and then select Copy from the tool bar.

2. The Copy Rule form displays:

Figure 30: Copy Rule

3. Enter a Rule ID, and a Description.

4. Select the Action Steps radio button to include all created Action Steps in the new Rule Key.

5. Select Save to confirm or Cancel to exit.

Notification and Escalation – Operation

The Notification and Escalation – Operation portlet allows users to Create, View, Pause, Resume, or Complete events.

1. To access Notification and Escalation – Operation, navigate to Shop Floor Control >

Production Control >

Notification and Escalation – Operation.

Figure 31: Notification and Escalation Operation

Filter

The Event list can be filtered by Event Key,Instance,Element, Rule, or Status.

1. To filter the event list, enter information into the filter fields and/or select from the drop down boxes provided, and then select Filter.

2. Select Clear to empty all fields and start a new filter.

3. The results will display in the Event list.

Figure 32: Notification and Escalation - Operation - Filter

Create Event

When a configured Element triggers a rule, an event is created. This is a real-time instance of a rule which will be executed according to the rule steps and will expire when the Event has been successfully executed one way or another.

1. To create an Event, select the Create icon from the tool bar under the Event List.

Figure 33: Event List

2. The Create Event form displays:

Figure 34: Create Event

3. Select a Rule (already configured) in the combo box.

4. Add the necessary parameters by select Add button.

Note: The created parameter(s) value(s) will be used to replace the parameter(s) defined in the body template.

Figure 35: Add Params Form

5. Enter the parameters name and value (these defined parameters will be used in the body template) and select Update.

6. Select Create to save the Event.

7. The created event is displayed at the Event List as Initializing status. After some minutes, the status becomes Active and the user is able to Pause, complete, or resume the event.

View Event

The View action allows the users to view the event data, as status, creation data, rule, instance, and the event steps previously defined. In this step, the user is not able to update data.

Figure 36: Event Form

Pause or Resume Event

The user is able to pause an event if necessary. To start a paused event, select the event in the list and select Resume.

Figure 37: Pause Events

Select Yes to pause the Event.

Once the event is paused, the user needs to select Resume to start the event again.

Figure 38: Resume Events

Complete Event

An event is completed after all defined steps are executed or the user selects Compete.

Figure 39: Complete Events

 

Glossary

C

Configured Element: A specific user-configured instance of a Deployed Element. For example: a user identifies, for a module (SPC, PTS), a specific set or group of line/part/route/route step which it is monitoring. Or: equally it could be a global rule for a specific business/site/department. This should reference a core element but have its own unique ID for the specific configuration.

Configured Rule: A user creates a specific rule through a combination of Rule Template, Configured Element, and email recipients.

D

Deployed Element: A real-world installed instance of any Master element. Each will have a unique identifier.

E

Event: When a configured Element triggers a rule, an event is created. This is a real-time instance of a rule which will be executed according to the rule steps and will expire when the Event has been successfully executed one way or another.

Event Flow: Series of steps that the deciding logic resides within. In real terms this could be regarded as a series of escalation levels based on timed execution and logical rules.

M

Master Element: A module/Component of 42Q, whether SFDC/PTS/SPC or another element of the product portfolio or a sub-component of each. Each will have a unique identifier and descriptor.

O

Operation: Series of steps which are always executed if the event flow is called.

R

Rule Template: An outline series of steps to be followed when an event occurs. This would be a basic set of rule steps without a configured trigger source; and without email recipients

 

Revision Log

Date	Author	Title	Version	Change Reference
07/04/15	Elaine Fonaro	Technical Writer	v 1.0	This is the first revision of Notification and Escalation User ’ s Guide
19/05/15	Ashley Martin	Technical Writer	v 1.0	Updates Instance and Rules Modules
08/06/15	Elaine Fonaro	Technical Writer	v 1.0	Update Operation Module
04/28/16	Elaine Fonaro	Technical Writer	v 1.0	Converted to 42Q
08/05/16	Molly Kitts	Technical Writer Intern	v 1.0	Converted to Google Docs
11/03/16	Benjamin Cavanaugh	Technical Writer	v 1.10	Minor Edits