Internal data points of the OPC UA client

_OPCUA

A data point _OPCUA<num> of this type stores the mapping of OPC UA severities to WinCC OA alert classes. <num> stands for the manager number of the started client. By default, 3 data points of this type already exist: _OPCUA1, _OPCUA2 and _OPCUA3.

Data point element

Type

Description

Config.AlarmPrioMapping

dyn_string

Defines the mapping of OPC UA severities to WinCC OA alert classes.

A mapping has the following format:

...

An example of such a mapping is:

0 OPCUA_info

250 OPCUA_warning

500 OPCUA_alarm

1000 OPCUA_danger

I.e.:

If an alarm with a severity of 150 is received, this belongs to the WinCC OA alert class "OPCUA_info".

If an alarm with a severity of 499 is received, this belongs to the WinCC OA alert class "OPCUA_warning".

If an alarm with a severity of 500 is received, this belongs to the WinCC OA alert class "OPCUA_alarm".

If an alarm with a severity of 1000 (highest OPC UA severity) is received, this belongs to the WinCC OA alert class "OPCUA_danger".

or further information see Mapping of alarm data.

_OPCUAServer

A data point of this type contains the configuration and status information of an OPC UA server to which the client connects to.

The connection and security settings will not be applied until the server has not been restarted. That means that the connection is not cut and reestablished with the new parameters automatically.

The elements of this type are described in the following table.

Data point element	Type	Description
Config.ConnInfo	string	Specifies the server URL. This defines how the server can be reached. An example for the format is: opc.tcp://localhost:4841
Config.AccessInfo	string	Contains the user name for the access to the server. If the data point element is empty, the client logs in anonymously.
Config.Password	blob	Contains the password for the access to the server. The password is displayed encoded. Note that if the password on the server was changed, the changes also have to be updated on the client in order to decode the password correctly.
Config.Security.Policy	uint	The following security policies are possible: None (0) Basic125Rsa15 (2)
Config.Security.MessageMode	uint	The following message concepts are possible: None (0) Sign&Encrypt (2)
Config.Security.Certificate	string	Certificate which should be used by the client for connection establishment (example: myCertificate.der). If this field is empty, the client uses PVSS_UA_defaultclient.der respectively WinCC_OA_UA_Client.der (version 3.11 and higher).
Config.Active	bool	With this data point element the communication to the corresponding server can be deactivated (FALSE) and activated (TRUE).
Config.ReconnectTimer	uint	Time interval in seconds the driver tries to establish a connection to the server, if no connection is available.
Config.StatusMapping	dyn_string	Specifies the mapping of the OPC UA status codes to WinCC OA user bits. The mapping is specified in a dyn_string. The dyn_string contains entries in the following form: <UA status code><space><user bit number> Whereas one user bit on the right side can be used multiple times: For example: 0x00000000 1 0x80280000 2 0x80300000 2 2150891520 32
Config.Separator	string	Separator for the view of the display names.
Config.Subscriptions	dyn_dpid	A subscription is always definitely assigned to a server. A server may have multiple subscriptions. In this internal data point element the corresponding subscriptions are stored in the format <systemName>:_<subscriptionName>.
State.ConnState	uint	Indicates the connection status to the server: Not connected (0) Connected (1)
State.ServerState	string	Displays the server status. Possible states are: "Good" "Bad" "Connected" - means that the client is connected but the actual server state is not known yet (i.e. this can change to "Good" or "Bad"). "ConnectionWarningWatchdogTimeout" "Disconnected" "ServerShutdown" "ConnectionErrorApiReconnect"
State.StartTime	time	Displays the startup time of the server. Format: JJJJ.MM.TT HH:MM:SS:MMM
State.VendorInfo	string	Displays the vendor information of the server.
Command.GQ	uint	Triggers a general query on the server. The specified value indicates whether values, alarms or both is queried: values and alarms (0) values only (1) alarms only (2)
Redu.Config.ConnInfo	string	Specifies the server URL of the redundant server. This defines how to connect the OPC UA server. An example of the format is: opc.tcp://localhost:4841
Redu.Config.Active	bool	With this data point element the communication to the redundant server can be switched off (FALSE) and switched on (TRUE).
Redu.State.ConnState	uint	Indicates the connection status to the redundant server. not connected (0) connected (1)
Redu.State.ServerState	string	Indicates the server status of the redundant server (Good or Bad).
Redu.State.StartTime	time	Indicates the start time of the redundant server. Format: JJJJ.MM.TT HH:MM:SS:MMM
Redu.State.VendorInfo	string	Indicates the vendor name of the redundant server.
Browse.GetBranch	dyn_string	With the aid of this data point element browsing is triggered. The following is saved: ServerName \| S1 StartNode \| ns=1;s=SYSTEM Level \| 0 (recursive), >0 (number of levels downwards)
Browse.DisplayNames	dyn_string	View of the names up from the start node. The levels are separated with a separator that was defined in the server data point. For example: Folder?stringArray
Browse.BrowsePaths	dyn_string	View of the whole browsing path in the defined notation beginning at the node /0:Objects: /1:AGENT/1:Objects/1:pUInt32 Special characters as / . < > : # ! & are disguised by &.
Browse.NodeIds	dyn_string	View of each NodeId per browsed node in the defined notation: ns=1;s=AGENT.Objects.pUInt32
Browse.NodeClasses	dyn_string	View of each NodeClass per browsed node: OpcUa_NodeClass_Unspecified OpcUa_NodeClass_Object OpcUa_NodeClass_Variable OpcUa_NodeClass_Method OpcUa_NodeClass_ObjectType OpcUa_NodeClass_VariableType OpcUa_NodeClass_ReferenceType OpcUa_NodeClass_DataType OpcUa_NodeClass_View
Browse.DataTypes	dyn_string	View of the data type.
Browse.ValueRanks	dyn_string	View of the value rank.

_OPCUASubscription

This data point type provides the configuration of subscriptions and the indication of their status. The data point element names with dark gray background in the table below cannot be set / are not visible in the subscription configuration panel.

Data point element	Type	Default-Werte	Description
Config.RequestedLifetimeCount	uint	100	Number of repeats until the subscription is deleted, if no values can be read.
Config.RequestedMaxKeepAliveCount	uint	10	Number of how often publishing may be without a value change. If the specified value is exceeded, the client sends an alive request to the server. The value 0 means that this function is inactive.
Config.RequestedPublishingInterval	uint	500	In these intervals in seconds the values are read from the server's queues by the client. The value 0 means that this function is inactive.
Config.MaxNotificationsPerPublish	uint	0	Indicates how many notifications may be retrieved per publish.
Config.PublishingEnabled	bool	FALSE	Activates (TRUE) and deactivates (FALSE) a subscription ((no) reaction on value changes).
Config.Priority	uint	0	This value indicates with which priority the notifications of this subscription are sent by the server. Value range: 0 - 255; whereby 0 means no special priority and 255 means the highest priority.
Config.SubscriptionType	uint	1	Defines whether this is a subscription on : Data (1) Events (2) Alarms & Conditions (3) undefined (0) - not selectable in the panel
Config.MonitoredItems.TimestampsToReturn	uint	3	Indicates which timestamp of the node should be used. In WinCC OA the corresponding availability is defined by: Source (0) Server (1) Reserved (2) None (3) - OPC UA client passes timestamp.
Config.MonitoredItems.QueueSize	uint	1	Number of value changes of the items, which will be stored until the next publish.
Config.MonitoredItems.DiscardOldest	bool	TRUE	Defines whether the oldest elements (TRUE - default) or the youngest elements (FALSE) are discarded from the queue, if the queue overflows.
Config.MonitoredItems.SamplingInterval	uint	0	Interval for querying monitored items in milliseconds.
Config.MonitoredItems.DataChangeFilter.Trigger	uint	1	Defines the trigger to which the filter applies: Status (0) Status, Value (1) Status, Value, Timestamp (2)
Config.MonitoredItems.DataChangeFilter.DeadbandType	uint	0	Defines the deadband type for value calculation: none (0) absolute (1) percent (2)
Config.MonitoredItems.DataChangeFilter.DeadbandValue	uint	0	Value in whose range from the original value up the deadband is valid.
Config.Alarm.Acknowledgment	dyn_string	-	Not used.
Config.Alarm.AlarmType	string	-	Alarm type.
State.SubscriptionId	uint	0	Internal identification number for every subscription. This is unique for each server. Value range: 1 to MAX_UINT 0 = invalid
State.RevisedLifetimeCount	uint	100	Returned LifeTimeCount.
State.RevisedMaxKeepAliveCount	uint	10	Returned MaxKeepAliveCount. Value range: 1 to MAX_UINT 0 = invalid
State.RevisedPublishingInterval	uint	0	Returned publishing interval in milliseconds. 1 to MAX_UINT 0 = invalid
State.AssignedOPCUAServer	string	-	Name of the OPC UA server to which the subscription is assigned.
Command.GQ	uint	0	Trigger for the general query per subscription. This is triggered independent of the value. As one subscription can be either for values or alarms, the value be passed is irrelevant.

V 3.11 SP1