WinCC OA Version Incompatibilities

Due to changes to the implementations and features following changes to WinCC OA lead to a different behavior than to previous versions. These changes must be considered when upgrading your existing project or the usage of existing libraries!

General

Video Encryption

Since vimacc version 2.2.2.2 (installed with WinCC OA 3.15) IPC sockets encryption is enabled for all vimacc services. Unencrypted WinCC OA components cannot communicate with the encrypted vimacc services anymore. This means that:

  • A video server with this vimacc version cannot be operated with video clients from Versions lower or equal to 3.14, since you cannot enable encryption for them.
  • The vimacc version of an existing video server is also updated.
  • After installing a WinCC OA Version higher or equal to 3.15, it is not possible to communicate with encrypted vimacc services in an existing WinCC OA project from a Version lower or equal to 3.14. This also applies if the services are running locally.

webclient_http.ctl Changes

Starting with version 3.18, the functionality of "webclient_http.ctl" was moved to the new CTRL++ class "HttpServer" in "HttpServer.ctl". "webclient_http.ctl" was modified to create an instance of this class and call the "start()" function. This allows you to easily add new httpConnect() calls in "webclient_http.ctl" or derive new classes from "HttpServer". It is, however, still not possible to create more than one instance of an "HttpServer" per script. This also means only one instance of the "HttpServer" class is possible.

Config Entries

Config Entry "CompareOldNew"

Starting with version 3.18 the config entry "CompareOldNew" has been changed from section [WINCC_OA] to section [opcsrv].

User Interface

UI Connections with -server

Due to the integration of the Desktop UI into the WinCC OA Device Management, you must unlock UI connections that are using the "-server" parameter. The connections can be unlocked manually or automatically. See Device Management.

CONTROL

Control Keywords

With version 3.16 some new control keywords are reserved (e.g.new or delete, refer to Variables and constants for further information) or used (e.g.struct or class, refer to Control++) byWinCC OA and cannot be used e.g. as variable names anymore. When updating older projects to 3.18, problems can arise if you have defined one of these keywords as a variable name. In this case you have to replace the now invalid names in the respective scripts and panels.

Script Execution

As of version 3.18, functions throw a syntax error in the following cases, which prevents the script from being executed:

  • Functions that are declared as void but still return a value.
  • Functions that have a declared return value but do not return anything.

getFileNames() - dir Parameter

Starting with WinCC OA version 3.16 P001 only a valid folder path can be stated for the dir parameter of the function getFileNames(). Stating an actual file path will return an empty string as the file path is no valid directory.

GEDI

Forbidden Characters for Data Point Names

With 3.18 the list of illegal characters for data point names has been updated.

Forbidden characters for data point names are: blank and . : , ; * ? [ ] { } $ @ as well as unprintable ASCII characters:

\x01 \x02 \x03 \x04 \x05 \x06 \x07 \x08 \x09 
\x0A \x0B \x0C \x0D \x0E \x0F 
\x10 \x11 \x12 \x13 \x14 \x15 \x16 \x17 \x18 \x19 
\x1A \x1B \x1C \x1D \x1E \x1F 
\x20 \x7F

See here for more information on these unprintable characters.

Font Size

Since WinCC OA 3.14 the font sizes are saved in pixels instead of points. This means a possible change in the font size for panels from older projects.

Objects in Layouts

Starting with 3.18, objects which are managed by layouts can not be moved or resized. This includes script actions as position, positionAsDyn, size or sizeAsDyn.

Layout Management

Due to enhancements to the WinCC OA Layout Management feature the existing behavior and default values have changed. Consider this when upgrading your WinCC OA project. It may be necessary to adjust your existing layout settings to get the previous visuals representation of your panels.

Drivers

TIA Symbolic

The S7 TIA symbolic is no longer supported. Instead use the new S7Plus driver for communication with S7-1200 and S7-1500 devices. Old version projects with TIA connections configured for the S7 driver can be migrated to the S7Plus driver with the S7 TIA Symbolic Migration panel.

_S7Config / _S7Conn DPE Changes

Following DPEs were removed from the _S7Config DP:
  • IPAddress
  • Rack
  • Slot
  • Timeout
  • ConnectionType
  • TSPPExtras
  • ProtocolExtras
Following DPEs were removed from the _S7Conn DP:
  • DevNr
  • ReduConn.DevNr
  • ReduCP.DevNr
  • ReduCP.ReduConn.DevNr
Following new DPEs were added to the _S7Conn DP:
  • Address
  • ReduConn.Address
  • ReduCP.Address
  • ReduCP.ReduConn.Address
Note:

These new DPEs contain the IPAddress, Rack, Slot, Timeout, ConnectionType, TSPPExtras, ProtocolExtras parameters encoded as JSON string for each S7 connection.

They replace the formerly used DPEs of the DPs _S7Config and _S7Conn.