How To Use SAP MII – Remote Plant
Connectivity Notifications
Applicable Release: MII 15.0
Version 1.0
Date: 14-01-2015
SAP MII – Remote Plant
Connectivity Notifications
How-To Guide
SAP MII How-To-Guide for Plant Connectivity Integration
i
© Copyright 2015 SAP AG. All rights reserved.
No part of this publication may be reproduced or transmitted in
any form or for any purpose without the express permission of
SAP AG. The information contained herein may be changed
without prior notice.
Some software products marketed by SAP AG and its
distributors contain proprietary software components of other
software vendors.
Microsoft, Windows, Outlook, and PowerPoint are registered
trademarks of Microsoft Corporation.
IBM, DB2, DB2 Universal Database, OS/2, Parallel Sysplex,
MVS/ESA, AIX, S/390, AS/400, OS/390, OS/400, iSeries,
pSeries, xSeries, zSeries, z/OS, AFP, Intelligent Miner,
WebSphere, Netfinity, Tivoli, Informix, i5/OS, POWER,
POWER5, OpenPower and PowerPC are trademarks or
registered trademarks of IBM Corporation.
Adobe, the Adobe logo, Acrobat, PostScript, and Reader are
either trademarks or registered trademarks of Adobe Systems
Incorporated in the United States and/or other countries.
Oracle is a registered trademark of Oracle Corporation.
UNIX, X/Open, OSF/1, and Motif are registered trademarks of
the Open Group.
Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame,
VideoFrame, and MultiWin are trademarks or registered
trademarks of Citrix Systems, Inc.
HTML, XML, XHTML and W3C are trademarks or registered
trademarks of W3C®, World Wide Web Consortium,
Massachusetts Institute of Technology.
Java is a registered trademark of Sun Microsystems, Inc.
JavaScript is a registered trademark of Sun Microsystems, Inc.,
used under license for technology invented and implemented by
Netscape.
MaxDB is a trademark of MySQL AB, Sweden.
SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP
NetWeaver, and other SAP products and services mentioned
herein as well as their respective logos are trademarks or
registered trademarks of SAP AG in Germany and in several
other countries all over the world. All other product and service
names mentioned are the trademarks of their respective
companies. Data contained in this document serves
informational purposes only. National product specifications
may vary.
These materials are subject to change without notice. These
materials are provided by SAP AG and its affiliated companies
("SAP Group") for informational purposes only, without
representation or warranty of any kind, and SAP Group shall not
be liable for errors or omissions with respect to the materials.
The only warranties for SAP Group products and services are
those that are set forth in the express warranty statements
accompanying such products and services, if any. Nothing herein
should be construed as constituting an additional warranty.
These materials are provided “as is” without a warranty of any
kind, either express or implied, including but not limited to, the
implied warranties of merchantability, fitness for a particular
purpose, or non-infringement.
SAP shall not be liable for damages of any kind including
without limitation direct, special, indirect, or consequential
damages that may result from the use of these materials.
SAP does not warrant the accuracy or completeness of the
information, text, graphics, links or other items contained within
these materials. SAP has no control over the information that
you may access through the use of hot links contained in these
materials and does not endorse your use of third party web pages
nor provide any warranty whatsoever relating to third party web
pages.
SAP ME “How-to” Guides are intended to simplify the product
implementation. While specific product features and procedures
typically are explained in a practical business context, it is not
implied that those features and procedures are the only approach
in solving a specific business problem using SAP ME. Should
you wish to receive additional information, clarification or
support, please refer to SAP Consulting.
SAP MII How-To-Guide for Plant Connectivity Integration
ii
Document History
Document Version Description Author
1.0 Initial version Sindhu Hariharan
The value of y will be incremented by 1 for a new version of the How-To-Guide for a new version of MII.
SAP MII How-To-Guide for Plant Connectivity Integration
iii
Table of Contents
1 Introduction ........................................................................................................................................... 1
1.1 Plant Connectivity Integration ...................................................................................................... 1
2 Manage Notifications ............................................................................................................................ 2
2.1 Creating a notification for Plant Connectivity Data Server .......................................................... 2
2.2 Configure Trigger tab.................................................................................................................... 5
2.3 Configure Output tab .................................................................................................................... 8
2.4 Configure Message Delivery tab ................................................................................................. 13
2.5 Configure Destinations tab .......................................................................................................... 15
2.6 Configure Description tab ........................................................................................................... 19
2.7 Save the notification.................................................................................................................... 21
2.8 Publish the notification ............................................................................................................... 22
2.9 Activate the notification .............................................................................................................. 22
2.10 Creating a notification for Plant Catalog .................................................................................... 23
2.11 Edit the Notification .................................................................................................................... 28
2.12 Delete the Notification ................................................................................................................ 33
3 Browse Notifications .......................................................................................................................... 36
3.1 Browse the notifications .............................................................................................................. 36
3.2 Activate and Pause the notifications ........................................................................................... 38
3.3 Import and Export the notifications ............................................................................................ 41
SAP MII How-To-Guide for Plant Connectivity Integration
1
1 Introduction
1.1 Plant Connectivity Integration
SAP MII is integrated with SAP Plant Connectivity (PCo) which allows you to create and configure
notifications directly in SAP MII and publish the notifications to SAP Plant Connectivity (SAP PCo)
systems. SAP PCo connects to the data source and handles the published notifications. Once
notifications are published and activated in PCo, you can pause and resume them individually from SAP
MII without stopping the whole agent instance.
To launch Plant Connectivity Integration follow the below steps:
a. Login to MII Portal
b. Expand ‘Plant Connectivity Integration’
c. Click on link ‘Notification Integration’
The homepage of Plant Connectivity Integration is shown below:
SAP MII How-To-Guide for Plant Connectivity Integration
2
The Plant Connectivity Management is divided into following tabs:
1. Manage Notifications
2. Browse Notifications
3. Recently Modified Notifications
Note: Each tabs is explained in detail in further sections.
2 Manage Notifications
2.1 Creating a notification for Plant Connectivity Data Server
a. Click on Manage Notifications tile.
b. Choose the PCo Data Server from icon which displays all the PCo Connectors, created and
enabled in SAP MII - Data Server screen
c. Select the PCo Data Server from the displayed list.
SAP MII How-To-Guide for Plant Connectivity Integration
3
d. Selected PCo Data servers will display all the notification is any exists and Create Notification
which is available in bottom corner of the screen is enabled.
SAP MII How-To-Guide for Plant Connectivity Integration
4
e. Click on Create Notification which is available in bottom corner of
the screen is enabled.
f. Enter the Notification Name and Description.
g. Click OK
SAP MII How-To-Guide for Plant Connectivity Integration
5
h. Notification details screen will appear with following details:
Notification name: Notification_Plant_Chocolates
Description: Notification created for temperature tags under Chocolate plant
Data Server: WS_MII_WSCKT
Status: DRAFT
Version: 1
i. Notification details screen consists of following tabs with Save, Edit, Publish to PCo, Activate,
Pause, Delete and Cancel buttons:
Trigger
Output
Message Delivery
Destinations
Description
2.2 Configure Trigger tab a. By default Trigger tab will appear under Notification details screen
b. Change the Trigger type as OnTrue from the dropdown
SAP MII How-To-Guide for Plant Connectivity Integration
6
c. Click on Manage Expression available on right side corner.
d. Expression editor screen will appear
e. In Plant Information Catalog, Expand the Root hierarchy. Expand The Group and Select the PIC
Tag.
Note: Make sure that we have Plant Information catalog hierarchy defined under SAP MII Catalog
Services for PCo Agents which has been used to create notifications.
SAP MII How-To-Guide for Plant Connectivity Integration
7
f. Click on Add to Expression available on the top of the PIC table. Selected PIC tag namespace
will be added under Trigger Expression field. Also can provide user-defined trigger expression
such as [Root/Group_WS_MII/Simulation/Random1]>=80. Can include different functions
which MII supports to create the valid expression
g. Click on Validate button. It validates the trigger expression provided whether it is syntactically
correct with success or error message.
SAP MII How-To-Guide for Plant Connectivity Integration
8
h. Click OK. Trigger expression will be defined.
2.3 Configure Output tab a. Click on Output tab
SAP MII How-To-Guide for Plant Connectivity Integration
9
b. Click on Manage Output available on Output Expression table.
c. Output Expression editor will appear
d. Select the PIC tags on Plant Information Catalog pane. Click on Add to Expression
SAP MII How-To-Guide for Plant Connectivity Integration
10
e. Provide the name to Output Expression and Click on PCo Expression icon available on row
item of Output expression. Expression in PCo format is displayed.
SAP MII How-To-Guide for Plant Connectivity Integration
11
f. Click OK. Output expression will be added.
g. Select the Output expression “TagValue”. Go to Context for TagValue table. Click on Manage
Context
h. Output Context editor will appear.
SAP MII How-To-Guide for Plant Connectivity Integration
12
i. Select the PIC Tags under Plant Information catalog pane and click on Add Properties. Select the
Properties.
j. Provide the name as “Pressure” to the context added.
k. Click on Add Context and define the new context property
SAP MII How-To-Guide for Plant Connectivity Integration
13
l. Click OK
i. Output expression and context for the output expression will be added.
2.4 Configure Message Delivery tab a. Click on Message Delivery tab
SAP MII How-To-Guide for Plant Connectivity Integration
14
b. Set the Reliability properties such as Maximum Number of Retries as 5 and Retry interval
(seconds) as 60
c. Set the Lifetime properties for notification such as Days 1, Hours 0 and Minutes 0
d. Set the Failed Messages properties such as Message Persistence as KeepAll and Delete Message
after (Minutes) as disabled (default value is 60)
e. Set the Message Bundling properties such as Fixed Number of Messages as 10 and Maximum
Accumulation Time (seconds) as 60. Turn on these two properties.
SAP MII How-To-Guide for Plant Connectivity Integration
15
2.5 Configure Destinations tab a. Click on Destinations tab
b. Click on Add Destination available on the right hand side
SAP MII How-To-Guide for Plant Connectivity Integration
16
c. Select the Destination type as Simulation Destination; Destination System as Sim <from
dropdown> which are already defined in Plant Connectivity server
d. Provide the Destination name as Destination1 and Description as Saved locally
e. Click OK
f. Click on Add Destination available on the right hand side
SAP MII How-To-Guide for Plant Connectivity Integration
17
g. Choose the Destination type as MII Destination; Destination System as ldcimfc <from
dropdown> which were already defined in Plant Connectivity server
h. Provide the Destination name as Destination2 and Description as Alerts sent to MII
i. Click OK
j. Browse the Transaction Name by clicking on available. Browse Transaction pop up
appears.
SAP MII How-To-Guide for Plant Connectivity Integration
18
k. Select the transaction which you want to process these PCo notifications which are sent from
Plant Connectivity Server when trigger expression is met.
MII transactions should have XML data type Input Transaction Parameter.
l. Click OK.
SAP MII How-To-Guide for Plant Connectivity Integration
19
m. Destinations are added to the notification.
2.6 Configure Description tab a. Click on Description tab
b. Click on Add Description available in the screen.
SAP MII How-To-Guide for Plant Connectivity Integration
20
c. A new row will be added to table. Click on under Language column and Choose the
Language such as de
d. Provide the description for the newly added language (User specific locale)
SAP MII How-To-Guide for Plant Connectivity Integration
21
2.7 Save the notification a. All the mandatory data are provided in notification. We can save the notification by clicking on
Save button available in the bottom pane.
SAP MII How-To-Guide for Plant Connectivity Integration
22
2.8 Publish the notification a. Once the notification saved, we can publish the notification to Plant Connectivity by clicking on
Publish to PCo button available in bottom pane.
Note: In MII, notification status will be changed to PUBLISH TO PCO whereas in Plant
Connectivity will appear as DRAFT under the specific PCo Agent.
2.9 Activate the notification a. Once the notification is published, we can activate the notification by clicking on Activate button
available in bottom pane.
Note: In MII, notification status will be changed to CURRENT whereas in Plant Connectivity
will also appear as CURRENT under the specific PCo Agent.
SAP MII How-To-Guide for Plant Connectivity Integration
23
2.10 Creating a notification for Plant Catalog a. Go to Manage Notification tile.
b. Choose the Plant Catalog
c. Manage notification screen under Plant Catalog will appear with PIC hierarchies.
d. Expand the Root and Select the PIC tag or PIC Group under which the remote notification should
be created.
SAP MII How-To-Guide for Plant Connectivity Integration
24
e. Click on Create Notification button available in the bottom pane. Click OK.
f. Notification details should appear.
SAP MII How-To-Guide for Plant Connectivity Integration
25
g. Go to Output tab. Selected PIC tags should be added under Expression in Output Expression
table.
h. Provide the Name for Output Expression and Add the Context for the Output Expression.
SAP MII How-To-Guide for Plant Connectivity Integration
26
i. Add the Destination for the notification.
j. Save the notification.
SAP MII How-To-Guide for Plant Connectivity Integration
27
k. Publish the notification.
l. Activate the notification.
SAP MII How-To-Guide for Plant Connectivity Integration
28
2.11 Edit the Notification a. Go to Manage Notification. Select the PCo Data Server. Select the Notification which you need
to update/edit it. Click on Edit button available in RowItem
b. Notification details screen will appear
c. Change the Trigger type as “Always”. Trigger Expression will be disabled.
SAP MII How-To-Guide for Plant Connectivity Integration
29
d. Click on Save button available in bottom pane. Notification will be updated.
Version will get updated as 2 and Status as DRAFT
e. Click on Publish to PCo button available in bottom pane.
Note: In MII, notification status will be changed to PUBLISH TO PCO whereas in Plant
Connectivity will appear as DRAFT under the specific PCo Agent with new version.
SAP MII How-To-Guide for Plant Connectivity Integration
30
f. Click on Edit button available in bottom pane.
g. Go to Output tab. Add a new Output expression using Manage Output button available in upper
right hand corner.
SAP MII How-To-Guide for Plant Connectivity Integration
31
h. Click on Save button available in bottom pane. Notification will be updated.
Version will still be 2 and Status as MODIFIED
i. Click on Publish to PCo button available in bottom pane.
Note: In MII, notification status will be changed to PUBLISH TO PCO whereas in Plant
Connectivity will appear as DRAFT under the specific PCo Agent.
SAP MII How-To-Guide for Plant Connectivity Integration
32
j. Once the notification is published, we can activate the notification by clicking on Activate button
available in bottom pane.
Note: In MII, notification status of Version 2 will be changed to CURRENT and Version 1 will
be in OUTDATED status whereas in Plant Connectivity also appear as CURRENT under the
specific PCo Agent and Version 1 will be in EXPIRED status
SAP MII How-To-Guide for Plant Connectivity Integration
33
2.12 Delete the Notification a. Go to Manage Notification. Select the PCo Data Server. Select the Notification whose Status is
DRAFT and Version is 1.Click on Delete button available in RowItem
b. A delete notification pop up appears as Delete this version of notification and Click OK
c. Selected notification will be deleted successfully only in MII side.
d. Go to Manage Notification. Select the PCo Data Server. Select the Notification whose Status is
PUBLISH TO PCO and Version is 2. Click on Delete button available in RowItem
SAP MII How-To-Guide for Plant Connectivity Integration
34
e. A delete notification pop up appears and choose the option as Delete this version of notification
and click OK.
f. Selected notification will be deleted successfully in both MII and Plant Connectivity side.
g. Go to Manage Notification. Select the PCo Data Server. Select the Notification whose Status is
CURRENT and Version is 3. Click on Delete button available in RowItem
SAP MII How-To-Guide for Plant Connectivity Integration
35
h. A delete notification pop up appears and choose the options as Delete all versions of notification
and Phase out current notification and click OK.
i. All the versions of selected notification will be deleted successfully in both MII and Plant
Connectivity side and ensures that notification messages if any will be delivered to the recipients.
SAP MII How-To-Guide for Plant Connectivity Integration
36
3 Browse Notifications
3.1 Browse the notifications a. Click on Browse Notifications tile.
b. Notifications can be browse by its PCo Data Servers, Notification Name and Status.
c. Choose the PCo Data Server from icon which displays all the PCo Connectors, created and
enabled in SAP MII - Data Server screen
d. Select the PCo Data Server from the displayed list.
e. Click on Search button available on right side corner of the screen.
f. All the notifications which are created under the selected PCo Data Server will be displayed.
SAP MII How-To-Guide for Plant Connectivity Integration
37
g. Select the notification and Click on button available in RowItem.
h. Selected notification details will be displayed.
i. We can perform the edit/update, publish, activate and delete operations directly in Notification
details screen.
j. Select the notification and click on button available in RowItem.
k. Selected notification can be delete by choosing the following options:
SAP MII How-To-Guide for Plant Connectivity Integration
38
1. Delete this version of notification
2. Delete all versions of notification
3. Phase out current notification
l. You can also delete the notification from Browse notification screen.
3.2 Activate and Pause the notifications a. Click on Browse Notifications tile.
b. Notifications can be browse by its PCo Data Servers, Notification Name and Status.
c. Choose the PCo Data Server from icon which displays all the PCo Connectors, created and
enabled in SAP MII - Data Server screen
d. Select the PCo Data Server from the displayed list.
e. Select the Status as PUBLISH TO PCO by clicking on icon
SAP MII How-To-Guide for Plant Connectivity Integration
39
f. Click on Search button available on right side corner of the screen.
g. All the notifications which are in PUBLISH TO PCO will be displayed.
h. Select the notification and click on Activate.
i. Select the Status as CURRENT by clicking on icon and Click on Search button
available on right side corner of the screen.
SAP MII How-To-Guide for Plant Connectivity Integration
40
j. All the notifications which are in CURRENT will be displayed.
k. Select the notification and Click on Pause. Notification Log will appear with notification message
l. Select the notification and Click on Resume and Notification Log will appear with notification
message.
SAP MII How-To-Guide for Plant Connectivity Integration
41
3.3 Import and Export the notifications a. Click on Browse Notifications tile.
b. Notifications can be browse by its PCo Data Servers, Notification Name and Status.
c. Choose the PCo Data Server from icon which displays all the PCo Connectors, created and
enabled in SAP MII - Data Server screen
SAP MII How-To-Guide for Plant Connectivity Integration
42
d. Select the PCo Data Server from the displayed list. Click on Search button icon
available on right side corner of the screen.
e. Click on SelectAll icon available in left side table header. Click on Export button.
Notification.xml file will be exported to default location.
SAP MII How-To-Guide for Plant Connectivity Integration
43
f. Similarly, we can import the notification.xml files through Import button available.
Pre-requisites: Relevant PCo Data servers and PIC hierarchical structure should be created in
import system.
g. Click on Browse Notifications tile.
h. Click on Import button. Browse the notification.xml file from the path.
SAP MII How-To-Guide for Plant Connectivity Integration
44
i. Click on Import button. Notifications will be imported successfully.