Control

It is necessary to adapt custom scripts due to changes to the "dpQueryConnect" functions in WinCC OA Version 3.11. With Version 3.11 the string parameter "identifier" has been changed to the anytype parameter "userData" which can cause problems when calling the corresponding callback function of the dpQueryConnect. So the callback functions must be adapted manually to the new anytype parameter when upgrading a project to WinCC OA Version 3.19.

Incorrect CTRL extensions, which are loaded in the UI or CTRL manager and are stored outside of the /bin WinCC OA directory, may cause a crash of the corresponding manager. The information of the affected CTRL extension is shown in the WinCC OA log viewer. This must be corrected accordingly. With the new command line option -noUserCtrlExt, the loading of CTRL extensions (which is stored outside of the /bin directory) can be blocked. This option is also used for WCCOAtoolConvertDb.

With version 3.19 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++) by WinCC OA and cannot be used e.g. as variable names anymore. When updating older projects to 3.19, there may be problems 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.

When updating an older WinCC OA project to 3.19, adjust the project-specific CTRL extensions manually.

Scripts using the formerly allowed malpractice in return values for classes need to be corrected, with a given class hierarchy of Base - Derived and a function Base foo() { return Derived(); } up to now an object of the Derived class was returned. From 3.19 onwards the correct return value of a Base class object is used.

Note that before an old WinCC OA project can be updated, any modified standard libraries (especially pt.ctl) have to be synchronized with the current libraries or moved temporary. This also applies to sub projects. For the generation of the panel topology sum alert data points, the updated library pt.ctl from the WinCC OA version is used. If the library is already available in the project, the library is taken from the project and the changes in the pt.ctl from the new version are not considered. Therefore, you have to synchronize the project specific pt.ctl with that of the version or move it from the project.