Home
Web Connectivity / Network Interfaces
Data exchange, APIs and web technologies
XMPP
XMPP (formerly Jabber) is mostly used in chat (instant messaging) applications and allows near real time communication between two or more parties. It can, e.g., be used to push information from a WinCC_OA project server to one or more persons, even allowing the recipient to send a confirmation back to the server.

Version Information
Release Notes, Update information, Certifications and Frequently Asked Questions.
Concepts
Your first step into modern and powerful process visualization.
Deployment
Topics, you need to know, before using WinCC OA.
Security
Go beyond the norm in cybersecurity.
Engineering
Powerful tools for easy or complex engineering tasks.
Data Management
Classify, structure and archive your data.
Business Logic / Control
Endless possibilities in data processing for your projects.
Data Visualization
User interfaces, Trends and Reports for every purpose and device.
Southbound Interfaces
The process connection to the actual machines/sensors.
Northbound Interfaces
Your portal to the cloud or supervising systems.
Web Connectivity / Network Interfaces
Data exchange, APIs and web technologies
- APIs
  An overview of the APIs (Application Programming Interface) available in WinCC OA.
- COM in WinCC OA
  COM stands for Component Object Model, a specification for developing modular software components which can be used by each COM compatible application. COM components can be easily integrated in such applications and can even be removed from an application at run time. COM components can be programmed in various different programming languages although C++ is used mostly. The specifications OLE, ActiveX and DirectX are based on the COM technology.
- Prometheus Interface
  The Prometheus interface (also referred to as Prometheus client) serves as a bridge between WinCC OA and Prometheus. It facilitates the retrieval, processing, and exposure of data from the WinCC OA system to a Prometheus-compatible format. This allows Prometheus to monitor and alert based on the data fetched from the WinCC OA system.
- SIMATIC PLC Discovery
  In increasingly dynamic automation environments and the merging of IT with OT, the SIMATIC PLC Discovery can help with the connection of newly added S7/S7+ devices by showing you all the devices in the network
- WinCC OA JavaScript Manager for Node.js
  The WinCC OA JavaScript Manager for Node.js is a manager that allows for the integration of the TypeScript/JavaScript runtime environment Node.js® into WinCC OA.
- SIMATIC Unified AR (Augmented Reality)
  SIMATIC Unified AR is an industrial Augmented Reality app that allows to display and operate HMI screens (WinCC Unified) and web applications (WinCC OA Dashboard) in real production environments.
- HTTP Server
  The HTTP Server integrates Internet technologies directly into WinCC OA . Implemented as an add-on for the Control Manager, possible applications are many and diverse. The HTTP Server can be used as a web server for static HTML pages including download facility or to generate dynamic HTML pages.
- XML-RPC
  XML-RPC (Extensible Markup Language Remote Procedure Call) allows software on different operating systems to make procedure calls over the internet. XML-RPC uses HTTP for the transport and XML for the encoding. It sends the procedure call to a remote server through HTTP. The call is an XML document and it receives the response as XML.
- REST Reporting API
  The REST Reporting API is integrated into the Standard web server and can be activated via the config entry enabled in the [restReporting] section.
- Distributed systems
  Distributed systems in WinCC OA allow to connect two or more autonomous WinCC OA systems via a network.
- Dist-Management
  Configuring and maintaining a distributed system in WinCC OA requires a high amount of engineering effort due to a high number of settings and configuration steps that must be applied on several systems. The Dist-Management reduces the engineering effort and simplifies the necessary settings.
- XMPP
  XMPP (formerly Jabber) is mostly used in chat (instant messaging) applications and allows near real time communication between two or more parties. It can, e.g., be used to push information from a WinCC_OA project server to one or more persons, even allowing the recipient to send a confirmation back to the server.
  - xmppAcceptSubscription()
    Accepts an XMPP request of type "subscriptionRequest".
  - xmppClose()
    Closes the client communication channel to an XMPP server.
  - xmppJidGetBareJid()
    This function returns the bare jid part of a jabber ID.
  - xmppJidGetDomain()
    This function allows you to query the domain part of a jabber ID.
  - xmppJidGetResource()
    This function allows you to query the resource part of a jabber ID.
  - xmppJidGetUser()
    This function allows you to query the user part of a jabber ID.
  - xmppOpen()
    Opens a client communication channel to an XMPP server.
  - xmppRefuseSubscription()
    Refuses an XMPP request of type "subscriptionRequest".
  - xmppRoomBanUser()
    This function allows you to ban a specified user (jid) from a chat room.
  - xmppRoomGetName()
    This function allows you to query the name of a chat room.
  - xmppRoomGetParticipants()
    This function allows you to query the participants of a chat room.
  - xmppRoomGetSubject()
    This function allows you to query the subject of a chat room.
  - xmppRoomInviteUser()
    This function allows you to invite a user to a chat room.
  - xmppRoomJoin()
    This function allows you to join a chat room.
  - xmppRoomKickUser()
    This function allows you to kick a specified user (jid) out of a chat room.
  - xmppRoomLeave()
    This function allows you to leave a chat room.
  - xmppRoomSetSubject()
    This function allows you to set a subject of a chat room.
  - xmppSendMessage()
    Sends a message over the opened clientId channel to the given recipient. The recipient is specified via the jabber id.
  - xmppSetPresence()
    This function allows to change your presence to a specific state -see the parameter description below.
User Management
All about authorization, authentication and login-customization.
Availability
How to get your system uptime to the maximum.
Reporting
Create state of the art project reports without limits.
Addons
Useful tools and enhancements for special demands.
Reference Tables
Detailed and extensive content for special project adaptation.
Videos & Tutorials
Explore the capabilities of WinCC OA with our carefully selected collection of video tutorials and guides.
WinCC OA Documentation
Basic information about terms and functions within the documentation.
Disclaimer
A brief clarification of liability exclusions or legal notices.

XMPP

XMPP (formerly Jabber) is mostly used in chat (instant messaging) applications and allows near real time communication between two or more parties. It can, e.g., be used to push information from a WinCC_OA project server to one or more persons, even allowing the recipient to send a confirmation back to the server.

The server can be one of the widely available servers on the internet or it can also be a non-public server, e.g. only available in the company intranet.

Every user on the network has a unique XMPP address, called JID (for historical reasons,XMPP addresses are often called Jabber IDs). The JID is structured like an e-mail address with a username and a domain name (or IP address) for the server where that user resides, separated by an at sign (@), such as winccoa.etm@jabber.at

Since a user may wish to log in from multiple locations, they may specify a resource. A resource identifies a particular client belonging to the user (for example home, work, or mobile). This may be included in the JID by appending a slash followed by the name of the resource. For example, the full JID of a user's mobile account could be winccoa.etm@jabber.at/mobile.

Several XMPP functions are available to be used on the WinCC OA server. You can invite a user to a chat room, open a topic in a chat, kick out a user etc. You can find the list of the available functions in the table below:


Function name
xmppOpen()
xmppSendMessage()
xmppRoomJoin()
xmppRoomLeave()
xmppRoomGetParticipants()
xmppRoomSetSubject()
xmppRoomGetSubject()
xmppRoomInviteUser()
xmppRoomKickUser()
xmppRoomGetName()
xmppJidGetUser()
xmppJidGetDomain()
xmppJidGetResource()
xmppJidGetBareJid()
xmppAcceptSubscription()
xmppRoomBanUser()
xmppRefuseSubscription()
xmppClose()