User Interface (VISION)

The basic user interface client for WinCC OA.

The User Interface in WinCC OA is called WCCOAui. The User Interface consists of the VISION and PARA modules (see chapter PARA module, basics) as well as of the module GEDI (see chapter GEDI, basics).

The systems being monitored and their components are represented graphically in panels. These contain simple elements such as lines, rectangles or circles, as well as more complex objects with pre-set functions, so-called "widgets", such as buttons, text fields or selection lists. By clicking on a graphics element or performing similar operations, the user can initiate actions such as opening another panel, sending messages or changing process states. Graphs and tables are provided for analyzing processes. System status messages are displayed in an alert panel where they can also be acknowledged.

When a project is created the WinCC OA User Interface WCCOAUI is automatically added to the console. Start the User Interface WCCOAUI from the console, see also chapter WinCC OA Console.

Figure 1. WinCC OA User Interface WCCOAUI - Module VISION

The module VISION comprises three menus and an icon bar. These are described in detail in the chapter Structure of module VISION.

UI's have a retry time of 600 seconds for the connection establishment. If the connection fails during the operation, the system tries to reconnect endlessly.

  1. Call regedit using the command line.

  2. Add the new entry DisableUNCCheck under Software/Microsoft/Command Processor

  3. Set the entry to 1.

If you have created a shortcut that opens a WinCC OA program (for example, the console) and the directory path, where the shortcut is executed, is specified using UNC paths, system calls might not work. To use system calls, add a new registry entry DisableUNCCheck to the registry as follows:

How to get images with a lot of information to be opened faster

  • In case of a big number of elements in an image the assignment to the attribute "name" (this.name = … or setvalue(…”name” …). in the graphics elements may take a while. Thus, the function should not be used or if necessary only for manual actions (click events) not when opening panels.

  • Highly complex CTRL functions can/should be implemented in a CTRL extension using C++.

  • Separated Callback functions which have a lot in common (partially same DPEs, partially same code) should be combined.

  • If the visibility is a dynamic attribute, define this kind of elements in the panel (reference) static as invisible (visible = no) and then set dynamic to visible.

Panel cache

The UI panel cache is module dependent. This means that a panel must be opened in the respective module to be cached. Closing the module means that the cache is cleared. All panels are cached by default. However, with panel property keep in memory you can define specific panels which shall not be cached.

The config entry panelCacheSize allows to define the cache size.

Root panels which are opened without file extension or with the absolute path are not cached.

Error handling before init in WCCOAUI

When starting a WinCC OA VISION module via the command line, a message is shown when errors (syntax errors in the config file, missing config entry etc.) occur before the configuration file is read and the project path is detected. Via the message box you know immediately what kind of error occurred and where it occurred.

After the project path was successfully detected the possible errors are written to log files. If WinCC OA is started from the command line the possible errors are written to the WinCC OA log file.