Skip to main content

i4scada Knowledge Base

MessengerPro Tutorials

Abstract

Follow up these step-based tutorials to configure your MessengerPro environment, in order to send and receive email notifications in case of malfunctions.

Note

The MessengerPro tutorials use the Demo Database of Studio project and the signals associated with it.

Management of Members
Abstract

Check out this step based tutorial and follow the steps to start managing your i4scada Messengerpro members.

The scope of the present article is to guide you through the most commonly met use cases for the management of MessengerPro members.

  1. Open the i4scada Studio and visit the Settings section.

  2. Select the MessengerPro menu entry.

  3. By default, the Members section is displayed.

    Members_section.jpg
  4. Click on the toolbar button New New.jpg.

  5. The member's list is updated with a new Member. The default name provided by Studio is "Member1" and the Service is set to E-Mail.

    Member1_added.jpg
  6. At the bottom of the Members panel under the Tab General, start filling in information upon "Member1". More details about the settings under the tab General can be found under The Members Section article.

    General_TAB.jpg
  7. Further on, proceed to the tab Addresses. To add an address click the toolbar button New New.jpg. More details about the settings under tab Addresses can be found under The Members Section article.

    Addresses_TAB.jpg
  8. Mark the new Address as Active, select the wished Service , and insert the Number / E-Mail address

    fill_in_address.jpg
  9. To preserve the organized changes click the Save button. 

  10. To create a second user with the same or similar settings, select the new listed user and press the toolbar button Copy Copy.jpg.

    Copy_member.jpg
  11. The Copy Members pop-up dialog is opened. In this dialog, fill in the number of copies you wish to create and press the Insert button to confirm.

    Copy_Members_dialog.jpg
  12. The copied member is added to the list view, available for further updates. Members updates can be organized directly under the tab General and tab Addresses.

    Copied_Member.jpg
  13. To delete a listed user, select the item to be removed and click the toolbar button Delete Delete.jpg.

    Delete_Member.jpg
  14. The Confirm delete dialog is opened. Click the OK button to confirm the deletion.

    Delete_member.jpg
  15. Once the OK button is clicked the selected Member is removed from the list view. 

Management of Escalation tables
Abstract

Follow the steps in this article to establish by yourself the i4scada MessengerPro Escalation Tables.

The present article will guide you through adding, copying, and deleting Escalation tables. 

  1. Open the i4scada Studio.

  2. Navigate to the Settings section and open the MessengerPro module.

  3. By default, the Members panel is opened. Switch to the Escalation tables panel, from the toolbar drop-down list.

    Escalation_tables.jpg
  4. Click the toolbar button New New.jpg

  5. A new escalation table is added to the list. The default name is "EscalationTable1".

    New_escalation_table.jpg
  6. At the bottom of the Escalation tables panel, fill in the desired information under the tab General. More information about the tab General can be found under The Escalation Tables Section chapter.

    TAB_General.jpg
  7. Switch to the tab Levels and press the button New. More information about the tab Levels can be found under The Escalation Tables Section chapter.

  8. The Members Section pop-up dialog is opened. Select the desired Member to be associated with the new Escalation table.

    Members_Section.jpg
  9. To preserve the organized changes press the button Save.

    TAB_Levels.jpg
  10. To create a copy of the listed Escalation table, select the desired item to be copied and press the toolbar Copy button Copy.jpg.

  11. The Copy Escalation Table pop-up dialog is opened. Fill in the desired number of copies to be created and click on the Insert button.

    Copy_escalation_table.jpg
  12. A copy is added to the list. Further updates of the Escalation table can be organized.

    Copied_Escalation_Table.jpg
  13. To delete any of the listed Escalation tables, select the listed item to be removed and click the toolbar button Delete Delete.jpg.

    Delete_escalation_table.jpg
  14. The Confirm delete dialog is displayed. Click the OK button to confirm the deletion operation.

    Delete_Esc_Table.jpg
  15. Once the button OK is clicked, the Escalation table is removed from the list view. 

Management of Shift schedules
Abstract

Start setting up the Shift Schedules for your i4scada MessengerPro setup and learn how to manage them.

To view, add, copy, edit and delete shift schedules, follow the steps described below:

  1. Open the i4scada Studio

  2. Visit the Settings section and open the MessengerPro module.

  3. By default, the Member section is opened. Switch to the Shift schedules, from the toolbar drop-down list.

    ShiftSchedules_panel.jpg
  4. Click the toolbar button New New.jpg.

  5. The Shift schedule type selection pop-up dialog is opened. In this view, the user is asked to select the Shift type. The given options are: Cyclic shift schedule and Calendar based shift schedule. More details about the Shift schedule types can be found in chapter The Shift Schedules Section.

    Add_Shift_schedule.jpg
  6. After selecting the desired type, click on the Insert button. The new Shift Schedule is added to the list view.

    Shift_schedule_added.jpg
  7. Select the new Shift schedule and click the toolbar button Edit Edit_Shift_Schedule.jpg

  8. The Edit Shift schedule panel is displayed. More details about this panel can be found in the chapter The Shift Schedules Section.

    Edit_Shift_Schedule_panel.jpg
  9. To insert a Shift schedule click the button New.

  10. The Shift schedule editor dialog pops-up.

    ShiftScheduler.jpg
  11. Define the needed shift terms. For the present use case, the Shift Schedule will begin at 08:00 o'clock and end at 16:00 o'clock, from Monday until Friday. 

    Shift_defined.jpg
  12. To preserve the changes, click the OK button.

  13. The Shift schedule pop-up dialog is closed. The calendar is updated and displays the defined shift. By pressing the View week and View month toolbar buttons, additional pop-up dialogues are opened, as described in chapter The Shift Schedules Section.

    Calendar_updated.jpg
  14. To delete elements from the previously defined Shift schedule, select the calendar item to be removed and click the button Delete Delete.jpg

  15. The selected calendar item is removed.

    Deleted_scheduled_item.jpg
  16. To preserve the changes, click the Save button. The initial Shift Schedules panel is displayed.

  17. To fully remove a Shift schedule, select the item to be removed, in list view, and click the toolbar button Delete Delete.jpg.

    Delete_Shift_Schedule.jpg
  18. The Confirm delete dialog is displayed. Click the OK button to confirm the deletion operation.

    Delete_shift_schedule.jpg
  19. Once the button OK is clicked, the Shift schedule is removed from the list view. 

Management of Alarming groups
Abstract

Check out these easy steps guiding you on how to create, copy and delete the i4scada MessengerPro Alarming Groups.

To manage the Alarming groups go through the following steps:

  1. Open the i4scada Studio.

  2. Navigate to the Settings section and open the MessengerPro module.

  3. By default, the Members panel is displayed. Select the Alarming groups option from the toolbar drop-down list.

    Alarming_gr_panel.jpg
  4. Click the toolbar button New New.jpg.

  5. A new Alarming group is added to the list. 

    New_Alarm_Gr.jpg
  6. At the bottom of the Alarming group panel, in the tab General, the Name of the Alarming group can be changed and a Description can be added. More details about TAB General of Alarming groups can be found in the chapter The Alarming Groups Section.

    Alarming_Gr_TAB_General.jpg
  7. Switch to the tab Shift Schedules and click the button New. More details about the tab Shift Schedule of Alarming groups can be found in the chapter The Alarming Groups Section.

    New_Shift_Schedule.jpg
  8. The Shift Schedules Selection dialog pops-up.

    Shift_Schedules_Selection.jpg
  9. Select the Shift Schedule to be attributed to the Alarming group and press the button OK.

  10. The Shift Schedule is added to the list view. To confirm the changes press the button Save.

    Shift_Schedule_added.jpg
  11. Select the Alarming group in the list view and press the toolbar button Copy Copy.jpg.

  12. The Copy Alarm Group dialog pops up. Insert the amount of copies to be created and press the button Insert.

    Copy_Alarm_Gr.jpg
  13. The Copy Alarm Group dialog is closed and a new Alarm Group is added to the list view. 

    Alarming_Gr_copied.jpg
  14. Select the copied Alarm group in the list view and press the toolbar button Delete Delete.jpg.

  15. The Confirm delete dialog is displayed. Click the OK button to confirm the deletion operation.

    Delete_Alarming_group.jpg
  16. The Confirm delete dialog is displayed. Click the OK button to confirm the deletion operation.

    Delete_Alarming_list_item.jpg
  17. Once the button OK is clicked, the Alarming list is removed from the list view. 

Management of Alarming list
Abstract

Follow up this easy step-based tutorial to learn how to create, copy and delete an i4SCADA MessengerPro Alarming List.

The alarming lists can be managed, in the MessengerPro module, by organizing the following steps:

  1. Open the i4SCADA Studio

  2. Navigate to the Settings section and open the MessengerPro module

  3. By default, the Members panel is displayed. Select the Alarming list option from the toolbar drop-down list.

    Alarming_list.jpg
  4. Click on the toolbar button New alarm.

  5. The Alarms Selection dialog pops up displaying the list of Signals.

    New_alarm.jpg
  6. Once the desired signal is selected, click the OK button. The Alarm is added to the list view.

    Alarm_listed.jpg
  7. By selecting the listed Alarm, the detailed view, displayed at the bottom of the Alarming list panel is populated with data. 

  8. Go to the tab General and fill in the information about the Alarming mode, Table ID, Acknowledge PIN, and Acknowledge alarm. More details about the tab General, can be found in the chapter The Alarming List Section.

    TAB_General_Alarm_list.jpg
  9. Switch to the tab File Attachments. More details about the TAB File Attachment, can be found in the chapter The Alarming List Section.

    TAB_File_Attachment.jpg
  10. Click the button New in the File Attachment tab.

  11. A new entry is added to the list. The desired language can be selected from the drop-down list. Also, a text and a URL to a file can be added.

    Language_is_added.jpg
  12. To preserve the changes, click the Save button.

  13. Click on the button New alarm group in the Alarming list toolbar.

  14. The Alarm group selection dialog pops up. 

    AlarmGr_selection.jpg
  15. Select one or more Alarm Group(s) from the list and click the OK button. 

  16. The Alarming list is populated with the new Alarm Group(s).

  17. Select a listed Alarm or Alarm group and click the Copy button Copy.jpg.

  18. The Alarm selection / Alarm group selection dialog pops up. 

    Copy.jpg
  19. After selecting the Alarm or the Alarm group, click OK button.

  20. The dialog is closed and the list is populated with a new Alarm / Alarm group.

  21. To delete an Alarm or an Alarm group, select the element to be removed and click the Delete button Delete.jpg.

  22. The element selected for removal is deleted from the list view. 

Send and receive emails via MessengerPro
Abstract

This is a full use case guiding you how to configure a working i4scada MessengerPro project and how to test the obtained results.

Organize below described steps, in order to send and receive emails, via MessengerPro:

  1. Open the i4scada Studio.

  2. Navigate to the Settings section and open the Module Signals tree node.

  3. Click-right in the Module Signals panel.

  4. The contextual menu is opened. Hover the option New and select the MessengerPro option.

    Module_Signals.jpg
  5. The Signal Browse window is opened. Expand the Studio Server nodes and select a Group by clicking on it. 

    Signal_Browser.jpg
  6. Select desired Signal(s) from the list view and click the OK button.

  7. The Signal Browser window is closed and the Module signal(s) added.

    Module_signal_added.jpg
  8. Switch to the Settings section and open the MessengerPro module.

  9. The Members panel is opened by default. Click the toolbar button New New.jpg.

  10. A new Member is created with the name "Member1".

    New_member.jpg
  11. Select "Member1" and visit the details panel, under the tab General

  12. Select the  Representative . For thepresent use case we shall leave the default option "Nobody".

  13. Select the  Language. For the present use case we shall set the language to "English".

  14. Set the State to the value "present".

  15. Add an Acknowledge PIN

  16. Select an i4scada User, from the users drop-down list.

    General_TAB_Settings.jpg
  17. Switch to the tab Addresses, under the Members details panel and click the button New.

  18. Select the Service E-Mail.

  19. Add an E-Mail address.

  20. Set the Service as Active.

    Addresses_TAB_settings.jpg
  21. Preserve the changes for "Member1" by clicking the Save button.

  22. Navigate to the Settings section and expand the Messaging node. Click on the Services node.

  23. Activate the E-Mail service.

    Services.jpg
  24. Under the tab General, add the Sender E-Mail address and mark the Active check-box.

    Services_General_TAB.jpg
  25. Switch to the Communication tab and mark the Send authentication check-box as true.

  26. Select the SMTP option from the drop-down list.

  27. Add the SMTP Settings:  Server, Port, User and Password. Mark the option "Secure communication SSL/TTL" as True.

  28. Add the POP3 Settings: ServerPortUser and Password. Mark the option "Secure communication SSL/TTL" as True.

    Communication_settings.jpg
  29. To preserve the changes click the Save button. 

  30. Click on the MessengerPro module, under the Settings section. Switch from the Members panel to the Alarming list. Make sure that the Signal "Buffer 1" is available in the list.

    Alarm_Buffer.jpg
  31. Open the i4scada Service Manager and start the i4scada Server and the i4scada MessengerPro.

    Service_Manager.jpg
  32. Open the i4scada Test Center, go to the tab Communication and select the option Manage servers

    Manage_servers.jpg
  33. In the Manage servers dialog, make sure that the Server ID corresponds the currently configured  database server.

    Dialog_Manage_servers.jpg
  34. Click the button Apply to confirm the server settings.

  35. Click the toolbar button Browse server, in the i4scada Test Center.

    Test_center.jpg
  36. The Browse server window is opened. Select the "Buffer 1" signal from the list view and click the Import button.

    Buffer_1.jpg
  37. Write a value for the "Buffer 1" signal in the i4scada Test Center.

    write_value.jpg
  38. An E-Mail providing the i4scada Test Center value is sent to the specified E-Mail address.