SOP-MES0038 Notification & Escalation

42Q Home > Administration > Notification & Escalation
 

 

 

 

Administration Notification & Escalation Version MES15 Revision B1  

 

 

 

 

 

Administration

Administrative privileges in 42Q are located in the Administration menu heading. With the portal, Administrators are able to access privileges from one convenient location. Privileges include User Maintenance, Plant Maintenance, Site Maintenance, Profile Maintenance, and Generic Attribute Maintenance.

This document is intended to guide administrators on how to manage and maintain the 42Q Portal, as well as to provide specific user groups with a common sense of portal operation.

To access any of the Administration functionalities, the user must sign in to the 42Q Portal.

To access any of the Administration Portlet, the user must sign to 42Q and then select the Administration expandable heading located in the menu on the left of the screen. 

Figure 1: User Sign-In

 

Notification and Escalation

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

The application is divided into two modules: Notification & Escalation and Notification and Escalation Operation.

Notification and Escalation (Siren and Operation) can be accessed by the following paths:

1. Administration > Notification & Escalation
2. Shop Floor Control > Production Control > Notification and Escalation – Operation

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 & Escalation main page displays 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 2: 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 & Escalation, and then select the Module icon.

 

Figure 3: Notification and Escalation - Module

Notification and Escalation - Module.png

 

2. The Module List displays:

 

Figure 4: Module List

Module List.png

 

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

 

Filter

The Module List displays all created modules. Each module's description and status (Active or Inactive) are 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 5: Filter Modules

Filter Modules.png

 

Add Module

The Add function allows the user to add third-party applications to the Notification & 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 toolbar above the Name list.

2. The Module Element form displays.

 

Figure 6: Add Module

Add Module.png

 

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.

 

Figure 7: Pop-up message when a module was created

Pop-up message when a module was created.png

 

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

 

The user needs to add a version to an application when creating a module. It is essential 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. 

To add an application version while creating a module, select the Add icon from the Version List panel in the Module Element form.
The Version and Description fields become available.
Enter the version and the description into the applicable fields, and then select Update.
Mark the Active flag to make the version available in the Instance and Rule portlets.
 

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 8: 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 8: Delete Version

 

2. Select Save to confirm the deletion. The '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 10: Error Message

Error.png

 

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 11: Edit Module

Edit Module.png

 

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

4. The '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. The 'Are you sure you want to delete (xxxx)?' confirmation message displays. Select Yes to confirm or No to cancel.

 

Figure 12: 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 13: Notification and Escalation - Instance

Notification and Escalation - Instance.png

 

2. The Instance main page displays:

 

Figure 14: Deployed Element List

 

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

 

Add Deployed Elements

This 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. The Application and Version 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 Add in the Deployed Element page.

2. The Deployed Element form displays:

 

Figure 15: Add Deployed Element

Add a Deployed Element.png

 

All previously added modules are displayed in the Module list.

1. Select a Module and Version, enter the Deployed Element Name, and then mark the Active radio button to make the module available for notifications in the Rule portlet.

2. Select Save to confirm the module addition, or Cancel to exit.

 

Edit Deployed Elements

To Edit a Deployed Element from the list: 

1. Select the element, and then select the Edit button. The user can update the Module, version, or the deployed element name. 
2. The ‘Are you sure you want to save changes?’ confirmation message displays. Select Save to confirm the module edition, or Cancel to exit.

 

Figure 16: Edit a Deployed Element

700px

 

 

Delete Deployed Elements

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

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

 

Figure 17: Delete a Deployed Element

Delete a Deployed Element.png

 

 

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 & Escalation – Operation portlet.

1. To access the Rule portlet, navigate to Administration > Notification and Escalation, and then select the Rule icon.

 

Figure 18: Notification and Escalation - Rule

Notification and Escalation - Rule.png

 

2. The Rule main page displays:

 

Figure 19: 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 19: 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 toolbar.

2. The Rule Template form displays:

 

Figure 20: Add Rule

3. Enter a Rule ID and a Description.

4. Select an 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 21: Add Flow Step

Add Flow Step.png

 

2. The Flow Steps form displays:

 

Figure 22: 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 23: Edit Flow Step

Edit Flow Step.png

 

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 24: 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 toolbar under the Action Steps panel in the Flow Steps form.

 

Figure 25: Add Action Step

 

2. The Action Steps form displays:

 

Figure 26: 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: Country Calling Code + Prefix + 7 digit number (no hyphens and no spaces). Example: 12058384821 with 1 being the international calling code for the United States in this example.

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 27: 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 28: 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 toolbar.

2. The Rule Template form displays:

 

Figure 29: Edit Rule

Edit Rule.png

 

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 toolbar.

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

 

Figure 30: 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 toolbar.

2. The Copy Rule form displays:

 

Figure 31: Copy Rule

Copy Rule.png

 

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 32: 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 33: 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 toolbar under the Event List.

 

Figure 34: Event List

 

2. The Create Event form displays:

 

Figure 35: Create Event

 

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

4. Add the necessary parameters by selecting the Add button.

 

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

 

Figure 36: 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, like status, creation data, rule, instance, and the event steps previously defined. In this step, the user is not able to update data.

 

Figure 37: 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 38: 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 39: Resume Events

 

Complete Event

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

 

Figure 40: 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 Shop Floor Control/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 that 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

---