how to use sap mii remote plant connectivity notifications

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.


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.


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


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:


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.


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.


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


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


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.


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.


8

h. Click OK. Trigger expression will be defined.

2.3 Configure Output tab a. Click on Output tab


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


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.


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.


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


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


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.


15

2.5 Configure Destinations tab a. Click on Destinations tab

b. Click on Add Destination available on the right hand side


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


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.


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.


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.


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)


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.


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.


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.


24

e. Click on Create Notification button available in the bottom pane. Click OK.

f. Notification details should appear.


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.


26

i. Add the Destination for the notification.

j. Save the notification.


27

k. Publish the notification.

l. Activate the notification.


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.


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.


Connectivity will appear as DRAFT under the specific PCo Agent with new version.


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.


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.


Connectivity will appear as DRAFT under the specific PCo Agent.


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


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


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


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.


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


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.


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:


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.




d. Select the PCo Data Server from the displayed list.

e. Select the Status as PUBLISH TO PCO by clicking on icon


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.


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.


41

3.3 Import and Export the notifications a. Click on Browse Notifications tile.





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.


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.


44

i. Click on Import button. Notifications will be imported successfully.

how to use sap mii remote plant connectivity notifications

Documents