SAP Plant Connectivity
SAP Plant Connectivity
Content
SAP Plant Connectivity
Basics
Tags
Methods
Tools for System Settings
Options
Global Settings
Specifying the System ID
Configuring the Main Service
Management Services
Compatibility Settings
User Settings
Configuring the Log Display for the Agent Instance
Configuring the Audit Log Display
Enhanced Error Handling
Settings for the Expression Editor
Registering PCo in the SLD
Authorization Management
Settings for Cloud Integration
User Configuration Tab
Process Flow for the Authorization Check
Transition to Central User Group Maintenance
Server Security Settings Tab
Internal WebSocket Communication Tab
Internal Communication with the Main Service
Processes and Integration Scenarios with SAP PCo
Notification Process
Settings for the Notification Process with SAP MII
Calling MII Transactions Using Web Services
SOAP-Based Web Services
REST-Based Web Services
Configuring an Asynchronous Transaction Call
Assignment of Web Service Call as Destination of a Notification
Query Process (with SAP MII)
Example: Settings for a Query Process with SAP MII 12.1
Example: Settings for a Query Process with SAP MII 14.0
Integration with the SAP Digital Manufacturing Cloud
Mapping of Machine Model Entities to Configuration Elements in PCo
PCo as OPC UA Server and as Web Server
Method Notifications
Enhanced Method Processing (EMP)
Standard EMP Implementation Locking
Standard EMP Implementation Key-Value Pair Buffer
Integration with Third-Party Systems Using Web Services
Integration with Third-Party Systems Using ENP
Process with Enhanced Notification Processing (ENP)
Implementing and Configuring Enhanced Notification Processing (ENP)
Enhanced Notification Processing
Assignment of Modules and Variables (ENP)
Assigning Source System Tags
Exception Handling
Destination System Calls with Response Processing
Configuring Destination System Calls with Response Processing
Connection of Web Applications via WebSocket
Connection of External Data Sources to Bus. Suite Applications
Data Exchange Using Queries
Process Settings for the Data Exchange Using Queries
Defining an RFC Destination
SNC Settings
Generation and Processing of Notifications
Process Steps for Remote Subscription
Process Steps for the Subscription in the PCo Console
Application Handle
Test Program RPCO_BS_INT_TEST
Initial Screen
Function Keys on the Initial Screen
Parameters for Communication Between Bus. Suite and PCo Agent
Parameters for Processing Tags
Results List
F4 Input Help for Browsing for Namespaces
Error Handling
ABAP Sample Implementations
Example of Data Exchange Using Queries
Examples of Generating and Processing Notifications
Conversion of Notifications to Time Ticket Logs
Automatic Running of Time Ticket Confirmations
Implementation of a Class for Processing Notifications (Class ZUD_RK_CONF)
Implementation of Class ZUD_RK_BADI_KONF for BAdI Implementation
Appendix
Tips and Tricks
Overview: Objects for Integration
SQL Data Types
Integration with SAP ODA
Settings for SAP ODA
Defining an RFC Destination
Settings in Transaction COOPC1
Configuration Elements in SAP PCo
Source System
OPC Source Systems
Basic Concepts of OPC
OPC DA Source System
Server Tab
Settings Tab
Aliases Tab
Import and Export
Reliable Connection Tab
OPC UA Source System
OPC UA Source System: Session Tab
Select Endpoint
OPC UA Source System: Security Tab
Application Certificate for OPC UA Source Systems
Generate and Assign a Self-Signed Certificate
Validation Options for Server Certificates
Possible Causes of Connection Setup Failure
OPC UA Source System: Subscription Tab
OPC UA Source System: Structures Tab
Import OPC UA Data Types into the PCo Data Type Repository
Save the JSON Template of the Selected Structures
Example: Configure Derived Data Types
Behavior at Runtime
Functional Limitations
OPC HDA Source System
OPC HDA Source System: Settings Tab
OPC AE Source System
Settings Tab
OLE DB Source System
OLE DB Connection Tab
Using Microsoft Excel
Using Microsoft Access
Reliable Connection Tab (OLE DB / ODBC Source System)
ODBC Source System
ODBC Source System: ODBC Database Connection Tab
Creating a DSN in the ODBC Data Source Administrator
Reliable Connection Tab (OLE DB / ODBC Source System)
Modbus Source System
Modbus Agent Tab
Settings for TCP Communication
Settings for Serial Communication
Determining the Update Rate
Modbus Units Tab
Tag Definition Tab
Importing or Exporting Modbus Tags
General Form of Message Frames
MQTT Source System
Client Tab
Connection Tab
Security Settings Tab
Authentication Method (wss)
Certificate Folders
Certificate Validation Options
Tag Definition Tab
Wildcards in the Topic Filter
Configure MQTT Message from Template
Test Parsing of Payload
Message Configuration: Define Parameters Manually (for JSON, XML, and URL-Encoded)
Message Configuration: Context Menu
Import Data Types into the Data Type Repository
Recommended Security Settings
Process for Validation of the Server Certificate Chain
Asymmetric Hash Algorithms
Timer Source System
Timer Configuration Tab
Create Timers and Trigger Notification Messages
Proficy Historian Source System
OSISoft PI Source System
PI Source System: Server Tab
PI Source System: Settings Tab
Asset Framework Source System
Server Tab
Settings Tab
Citect Source System
Citect Source System: Settings Tab
IP21 Source System
IP21 Source System: Server Settings Tab
File Monitor Source System (Deprecated)
File Monitor Source System: Settings Tab
Rename File
Authentication Tab
Query Functions of the File Monitor Source System
Example: Agent Instance Settings for the File Monitor Source System
File System Source System
Settings Tab
Authentication Tab
Upload Binary File Content
Socket Source System
Statistics Functions for Source Systems
Filter Functions when Browsing for Tags
Functions for Source Systems
Destination System
Universal Web Service Destination System
Web Service Settings Tab
Configuring the Endpoint URI for RESTful Services
Template Syntax
Load Service Description from File
Security Settings Tab
Configuration of OAuth Settings
Operation Configuration Tab
Request Message Configuration Tab (RESTful)
Add a Request or Response Mapping
Allowed Data Types
binary
base64Binary
boolean
byte
date
dateTime
dateTimeOffset
jsDate
decimal
double
duration
float
GUID
int
long
object
sbyte
short
single
string
stream
time
timeOfDay
Creating Arrays
Context Menu
Configure Message from Template
Examples of Request Message Parameters (RESTful)
Request Message Configuration Tab (OData and Web Service)
Import Data Types into the Data Type Repository
Response Message Configuration Tab (RESTful)
Response Message Configuration Tab (OData and WS)
Templates Tab
Advanced Configuration Tab
Request and Response Settings
Uploading and Downloading Files
Uploading Multiple Files (MIME Format Multipart)
Downloading Multiple Files (MIME Format Multipart)
Uploading a File (MIME Format Binary)
Downloading a File (MIME Format Binary)
Session Configuration
Test Configuration
Proxy Settings Tab
Example: Create a Universal Web Service Destination System (OData)
OPC UA Destination System
Session Tab
Method Tab
Test Method
Reliable Connection Tab
ODBC Destination System
ODBC Destination System: Configuration Tab
Setting Up the Connection to the SQL Server
Setting Up the Connection to the SAP HANA Database
Assignment of Destination System Variables (ODBC Destination System)
RFC Destination System
RFC Client Settings Tab
Security Settings Tab
Multiple Call Destination System
Example of Using an MCD
Variables of a Multiple Call Destination System
Example of Calculating Variable Values
Configuring a Multiple Call Destination System
Configuring a Linear Call Sequence of Destination Systems
Configuring Suspend and Resume
Steps
Branching Conditions
Examples of Branching Conditions
Activating Exception Handling
Predefined Functions in the Multiple Call Destination System
General Settings Tab
Log Level
Resume Handles Tab
Testing a Multiple Call Destination System
Query Destination System
Creating a Query Destination System with Defined Tag Names
Creating a Query Destination System with Parameterizable Tag Names
Predefined Output Variables in a Query Destination System
Recommendations for Using the Query Destination System
Working with Arrays in the Query Destination System
MQTT Destination System
Client Tab
Security Settings Tab
Message Settings Tab
Generate Mapping from Template
Message Configuration Screen Area
Datentypen in das Datentypverzeichnis importieren
Simulation Destination System: Configuration Tab
MII Destination System (Deprecated)
Server Tab
Advanced Tab
Web Service Destination System (Deprecated)
Server Settings Tab (WS Destination System)
Operation Configuration Tab (WS Destination System)
Request Message Configuration Tab
Creating Arrays
Response Message Configuration Tab
Calculated Variables in a Web Service Response Message
Defining and Testing Calculated Variables
Use Cases for Calculated Variables
Example of Configuring a Service Operation
Advanced Settings (WS Destination System)
Functions for Destination Systems
Agent Instance
Host Tab
Log Tab
Servers Tab
SAP MII Query Server
Setting Up a Secure Connection for MII Queries
SAP MII Query Server (Before 12.2)
SAP ODA RFC Server
SAP NW RFC Server
SAP EWM RFC Server
WebSocket Server
Settings for the Notification Process with WebSocket
JSON Messages for WebSocket Connections
XML Messages for WebSocket Connections
OPC UA Server
OPC UA Server Settings Tab
Security Configuration Tab
Server Method Definitions Tab
PCo Web Server
PCo Web Server Settings Tab
Certificate Folders
Web Server Method Definitions Tab (Web Server)
Creating Method Definitions
Maintaining Method Definitions
Asynchronous
Include Parameters in Message Body
Result of Method Maintenance
Icons
Tag Query Tab
Subscription Items Tab
Unsupported Data Types for OPC UA Applications
Adding Tags
Notification Processing Tab
Notification Message Queue and Dispatch Settings
Storage Method
Process Notification Messages Exactly Once in Order
Enhanced Notification Processing
Displaying Messages
Functions for the Agent Instance
Starting and Stopping an Agent Instance
Using Starting Groups for Agent Instances
Notification
Tag-Based Notifications
Static Notifications
Versioned Notifications
Creating and Activating a Draft Version
Adding a Draft Version
Functions for Versioned Notifications
Notification Template
Notification Template: Remote Subscription Tab
Configuration of Tag-Based Notifications
Notification Tab
Trigger Types
Triggering Subscription Items
Output Tab
Adding an Expression
Generating Expressions
Maintaining Context Items
Testing a Notification Delivery
Message Delivery Tab
Destinations Tab
Define Data for SAP MII System
Assignment of Notification Output (Call of MII Transactions)
Assignment of Notification Output (Universal WS Destination System)
Assignment of Notification Output (Multiple Call Destination System)
Assignment of Notification Output (OPC UA Destination System)
Assignment of Modules and Variables (ENP)
Exception Handling
Assigning Source System Tags
Assignment of Destination System Variables (ODBC Destination System)
Assignment of Notification Output (WS Destination System)
Method Notifications
Notification Tab (Method Notification)
Assignment of Input Parameters Tab
Destination Tab
Assignment of Output Parameters/Variables Tab
Functions for Notifications
Expression Editor
Formulating and Calculating Expressions
String Literals in Expressions
Examples of Strings
Syntax Highlighting in the Expression Editor
Functions in the Expression Editor
Operators
Examples for Using Functions in the Expression Editor
Application Examples for csvParse(csvString, recordSeparator, fieldSeparator, quoteCharacter, containsHeader)
Application Example for structCompDelete(obj, [component 1, ..., component n-1], component)
Examples of Message Texts
Message Bundling
Deadband
Handling of Data Types
PCo Data Types
Elementary Data Types
Structured Data Types
Array Data Types
Enumeration Data Types
Support of Data Type Categories
Namespaces
Functions in the Import Data Types Dialog Box
Select Data Type (Selection Dialog)
Processing Character Strings in JSON Format
Special Functions of the Management Console
Logging
Certificate Overview
Identification Type of Certificates
Backing Up and Restoring PCo Configuration Data
Setting Up an Automatic Backup
Exporting and Importing Configuration Elements
Starting the PCo Management Console in Display Mode
Setting the Command Line Parameters
Controlling the Cursor Using the TAB Key
Remote Client
Adding a PCo System Using Host Name
Adding a PCo System via SLD
Additional Monitoring Tools
Notes for Installing SAP PCo