News Version 10.0 Table of Content

HMI/SCADA/PSIM News version 10.0 Table of Content

Table of Content...... 2 Introduction...... 3 New objects, funktions and solutions in WideQuick 10.0 Theme – Colors...... 4-7 Zoom and Pan in worviews...... 8-9 Line chart objekt...... 10-13 Tooltip and MouseOver for objects...... 14 Dynamic focus management of workviews...... 15 Map objects...... 16-19 New functions for managing images...... 20 Running WideQuick Runtime as a service...... 21 Windows Manager...... 22-23 Objects and functions with enhanced functionality inWideQuick 10 CSV import of workviews...... 24-27 Logging...... 28 Object list...... 29 Tab object...... 30 Multiviewer...... 31 Debug log...... 32-33 Ordering a WideQuick license...... 34 License tables for WideQuick HMI/SCADA/PSIM...... 35 Release Notes...... 36-39

2 - Introduction

WideQuick version 10.0 is full of exciting innovations and this brochure provides a compre-hensive overview of all the new and updated features. The brochure contains examples of how system integrators and others can use these new features to create attractive and cost-effective solutions.

We want every new version of WideQuick to make project work easier for system integrators by improving existing features and implementing advanced new ones. We have focused strongly on the user interface in the development of version 10.0. We have developed new features that give system integrators even more opportunities to create modern and intuitive user interfaces. Such new features include Theme, Zoom and Pan in workviews, Tooltip and MouseOver, Window Manager and the ability to focus on workviews.

We have also added a map object where the map information for the object updates online and where the map can contain smart WideQuick objects for user interaction. The previous line chart object has been replaced with a brand new one. The new line chart object is considerably more powerful and flexible than its predecessor and can also be used by WideQuick Web Client.

One eagerly awaited major new feature is the ability to run WideQuick Runtime as a service from version 10.0 onwards. Other new features include new image management options and a debugging tool that will identify a syntax error in a script for example. We have also added and improved the following features: CSV import of drawings produced in pro- grams such as AutoCAD, new logging options, and enhanced functionality in the list object and the tab object.

- 3 Theme – Colors

Theme is a new feature that makes it much easier to create standardised, modern user interfaces. You can configure a colour theme for WideQuick Runtime in WideQuick Designer, which can then be applied automatically to all workviews and pop-up windows throughout the application. This new feature also enables you to change the colour for parts of the application that could previously only have a specific predefined colour.

Description of the function

The Theme feature opens up further possibilities for Using the colours from Theme in the objects available in customising the appearance of the WideQuick project the object library opens up even more possibilities. You and creating a homogeneous look for the application. can then create an application where Theme applies to Theme applies mainly to interaction objects such as but- all of the project’s workviews, including all constituent tons, sliders, history objects, etc., but can also be used objects, depending on different factors and conditions. for the background colour of workviews and the colors in individual objects, for example. The entire project can change color, for example, depending on the individual or type of user who is logged You can create and name any number of themes. All the in. You can create a general colour scheme to be used colors forming part of each theme can be retrieved and when an object has an active alarm, for example. applied using a script. You can also configure a custom set of colors for each theme. These can be used, for This feature can be used for WideQuick Runtime, example, to customise graphical objects using dynamics/ Remote and Web Client. scripting so that they fit in with the theme. Theme – colors is included as standard with the license levels Extended, Advanced and Premium.

4 - Theme – Colors

Example

In the example below, we have applied new themes for the workview as described on the previous page. This function can be applied to many different parts of the user interface by using the theme olours for interaction objects, background colours and individual objects.

- 5 Theme – Colors Cont.

Example

In this example, we have used Theme to change the appearance of the workview depending on whether it is day or night; in other words you can select a theme depending on the ambient light where the screen is. Theme applies to all window titles, the background color, the tab object, colors of the constituent objects, etc. WideQuick Designer has a brand new dialog that makes creating a new theme easy. When you configure a new theme, WideQuick Designer shows an example of how the finished result will look in WideQuick Runtime, Remote and Web Client. You can name and save any number of themes and then easily call them in WideQuick Runtime to decide which theme to use.

7 Zoom and Pan in workviews

From WideQuick version 10.0 onwards, you can zoom and pan the content of a workview in WideQuick Runtime, Remote and Web Client. This function enables you to create a user interface that is more intuitive for the user and where the workviews can contain far more information than before, while also allowing you to zoom in on the information you want.

Description of the function

The properties window for workviews in WideQuick ibility of workviews configured using earlier versions of Designer has been given a new tab called Layout. On this WideQuick, this feature is not enabled for a workview by tab, you can configure whether the zoom and pan fea- default. ture is enabled for a particular workview. It is now possible to set whether the objects are to be scaled against The function enables the current zoom level and panning the workview while also preserving the height-to-width position to be read and written by a script, opening up a ratio of objects. The sliders can be hidden, displayed wide range of smart and exciting solutions. as needed, or always displayed. You can also specify The examples below present a number of solutions that whether the user is able to zoom and/or pan using the illustrate the basic functionality that can be created us- pointing device. ing the new feature.

You can set how much the user is able to zoom. By de- Zoom and Pan in workviews is included as standard with fault, the range is 10%–1000% of the original size of the the license levels Advanced and Premium. workview. In order to maintain the backward compat-

Example

Example 1 In this example, we have a workview that is located in a multiviewer, in other words it occupies part of the user interface. You can zoom in on a selected area in the multiviewer using the scroll wheel on a mouse or the touchscreen of one of our operator panels.

8 - Example 2 This example shows part of the same workview as in Exam- ple 1 and what it looks like when the system is configured to display the sliders at the sides.

Example 3 You can configure the system to zoom in on a particular object automatically when an alarm is activated, for example. Any condition can be used to determine which section is zoomed in on in a workview.

Example 4 The system is able to detect the current zoom level so the desired information can be displayed, depending on the zoom level. You can do this in any number of steps so that more information is displayed the more you zoom into the workview. This example shows the same type of event as in the previous example, but here we have used the zoom level to display more detailed information about the object automatically using a pop-up.

Example 5 As the zoom level and panning position can both be written and read, zoom and pan can be controlled using a range of functions in WideQuick. You can also change the zoom level and panning position in multiple workviews at the same time. In this slightly more advanced example, we have shown the same information in both workviews but with different zoom factors; the left-hand image is an overview. When you use the zoom and pan function in one of the workviews, it acts on both workviews at the same time. So although the left-hand image is an overview, it does not always show all the information available for the workview because the zoom and pan function is also applied to this view. The zoom level and panning position also control the size and location of a semi-transparent rectangle that appears only in the left-hand overview image. This indicates the area that is displayed in the right-hand workview.

- - 9 LinjeChart2

The new line chart object in WideQuick 10.0 is called LineChart2. This is a brand new object developed from scratch that is extremely flexible, has much higher performance and offers far more possibilities compared with the previous line chart object. Data is processed and presented much more quickly, improving the user experience for the operator. The inbuilt flexibility means there are almost limitless opportunities for customising the new line chart object, both in design mode and directly in WideQuick Runtime.

Description of the function

A range of options for customising the line chart object Save configured Layouts Depending on the type of application and the unique needs You can use Layouts to save different configurations and of the customers, there are different requirements for the then load them whenever you want. These layouts contain presentation of measurement data, for example, in a line information about all the settings that are available for the chart object. There are several options available to the line chart object, so you can change its appearance quickly system integrator for configuring the presentation of data in and effectively. If you lay out a line chart object in the object the line chart object. The number of line chart object prop- library, you can easily save layouts which you can then reuse erties that can be customised using WideQuick Designer has across different views and other projects. increased significantly and almost all of these properties can be adjusted directly in WideQuick Runtime using a script. WideQuick Web Client The new line chart object can also be used in WideQuick New interaction options for the operator Web Client and looks and works almost exactly the same as Using the line chart object in WideQuick is easy and intuitive the one that runs in WideQuick Runtime. and the user can move around the line chart object using natural interaction. For example, you can drag in one of the More settings options in WideQuick Designer axes to edit it and also scroll the mouse wheel to zoom in There are many more configuration options in the new line on the data you want. You can also drag the drawing area to chart object compared with the previous one, although we adjust all axes at the same time. have chosen to keep the basic appearance the same. The object is also displayed in much greater detail in WideQuick Easy to add or remove Y-axes and graphs Designer, making it a lot easier for the system integrator to You can add and remove as many Y-axes and graphs as you specify the appearance of the layout in workviews. want to display. Choose whether you want the Y-axis to be on the left-hand or right-hand side of the object and select LineChart2 is included as standard with all license levels. the lines that you want to be connected to the object. You can also do all this directly in WideQuick Runtime.

10 - LinjeChart2

Example

Example 1 It’s easy to zoom in and out of the new line chart object. Position the cursor over the area/value you want to zoom in on, then scroll in or out.

Example 2 Most functions are available using a script, so you can easily create custom buttons/entry fields to add more Y-axes directly in WideQuick Runtime.

Example 3 There are lots of options for customising the appearance of the line chart object, both in WideQuick Designer and directly in WideQuick Runtime.

- 11 Line Chart Cont.

Description of the function

Below is a selection from the many script functions available in our new line chart object.

backgroundColor() Returns the background color in a Color object.

contains(_layoutName_) Returns true if the specified layout-name is present in the object.

graph(_name_) Returns a LineChart2Graph object for the specified graph name, or a null object if the graph could not be found. _name_ the name of the graph.

graphs () Returns a list of all graph names.

layouts() Returns a list of all layout names.

load(_layoutName_) Loads the specified layout to the object. Returns true upon successful loading, otherwise false. _layoutName_ the name of the layout to be loaded.

penColor() Returns the color of the pen in a Color object.

removeGraph(_name_) Deletes the specified graph. Returns true if the graph could be deleted, otherwise false. _name_ the name of the graph to be removed.

removeLayout(_layoutName_) Deletes the specified layout. Returns true if the layout could be deleted, otherwise false. _layoutName_ the name of the layout you want to delete.

removeYAxis(_name_) Deletes the specified Y-axis. Returns true if the layout could be deleted, otherwise false. Raises an exception if there are graphs connected to the axis. _name_ the name of the axis to be deleted.

resetPanZoom() Reset the current zooming and panning.

save (_ layoutName_opt _) Saves the specified layout to disk. If _layoutName_opt_ is not supplied, the current layout is saved. Returns true if the save succeeds, otherwise false. Please note Layouts can not be saved on the remote clients, such as WQRemote or WQWeb. _layoutName_opt_ indicates which layout configuration will be saved. This parameter can be omitted.

saveAll() Saves all changes in all layouts. Returns true if everyting was saved successfully, otherwise false. Please note Layouts can not be saved on the remote clients, such as WQRemote or WQWeb.

setBackgroundColor(_color_) Sets the background color. _color_ specifies the color, it can be specified by a Color object or a numeric value.

setPenColor(_color_) Sets the pen color. The color is used as the line color in the legend, the ruler and the Axes. _color_ specifies the color, it can be specified by a Color object or a numeric value.

yAxes() Returns a list of the names of all Y-axes in the object.

yAxis(_name_) Returns a LineChart2Axis object for the specified axis, or a null object if the specified axis couldn´t be found. _name_ the name on the axis that is sought.

12 Example

As the dialog box in WideQuick Designer shows, there are many options available to the system integrator for configuring how data is presented in the line chart object. It is important to remember that almost all of these properties can also be adjusted directly in WideQuick Runtime using a script.

The line chart object offers excellent options for synchronising the scale of the y-axis and/or x-axis with one or more other line chart objects. You can use it to compare data at different points in time, for example.

The script functions open up fantastic opportunities for system integrators and end customers to create their own functions and what we have shown here are just a few examples of what can be created using the many script functions available for the new line chart object. Below are some more examples of designs for the line chart object.

- 13 Tooltip and MouseOver for objects

To further enhance the user experience, we have introduced a Tooltip function, which allows you to display text information when the user moves the cursor over a particular object, for example. This means you don’t need to display the information in a separate workview. We have also added the MouseOver functions “onEnter” and “onLeave”, which give the system integrator another opportunity to enhance the intuitive experience for the operator.

Description of the function

The Tooltip function is activated as soon as the user user moves the cursor over an object and when the user moves the cursor over an object and the text informa- moves the cursor away from an object. The script can tion can contain variable data as well as static text. On execute the desired function and, as a simple example, top of the ability to display a Tooltip whenever the cur- a variable can be set to value=1 of “onEnter” and to sor passes over an object, an important element of this value=0 of “onLeave”, after which the variable can be feature is that the workviews and objects now support used to specify the desired functions in the application. the “onEnter” and “onLeave” events. Tooltip and MouseOver for objects are included as These two events run the appropriate script when the standard with all license levels.

Example

Here are three different examples of how you can use the Tooltip and MouseOver function. The image at the top shows a Tooltip containing static text and variable data. In the next example, we have used “onEnter” to select an object. In the third example, we have also activated a pop-up using “onEnter”.

14 - Dynamic focus management of workviews

When a special event occurs, in a surveillance situation for example, it may be important to notify the operator about the event by displaying a special workview. To ensure that the relevant workview is displayed at the front of the user interface, we have introduced a feature called Dynamic focus management of workviews.

Description of the function

This function can be activated for various reasons, but it You can specify whether the workviews that are focused is commonly used to focus on a particular workview in on overlay other applications or only overlay the views in the event of an alarm or an alarm of a particular prior- the WideQuick application. ity. The workview the system focuses on can contain, for example, the object and the part of the process that has Dynamic focus management of workviews is included as caused the most serious alarm. standard with all license levels.

Example

In this example, a priority 1 alarm has occurred at a time when the operator has chosen not to display the user interface temporarily.

WideQuick immediately displays the WideQuick application with the selected workview at the front of the user interface. At the same time, WideQuick displays a symbol at the relevant object, where the operator can open an action list and quickly view information about which actions to take.

- - 15 Map Object @

The map object is used to display map information, which is updated online. Objects from the WideQuick Designer object library can be positioned and linked to geographic positions and displayed on the map. You can pan across the map and zoom in to 20 different levels. You can also specify which objects are to be displayed at each zoom level.

Description of the function

The new map object opens up entirely new You can create variables to represent different zoom opportunities and you can create an application, for levels and then assign a visibility range (directly or using example, where the user has access to increasingly a variable) to WideQuick objects using the style “3–10”, detailed WideQuick information the more they zoom in which means that the object is visible between and at on the map. zoom levels 3 and 10. The ordinary visibility dynamics of the objects can also determine whether or not the The map object has a flexible structure and the current object is visible. map position and zoom level can be accessed via a script. This enables advanced functionality to be set We have initially chosen to use the OpenStreetMap up, where the map object is able to interact with other service (https://www.openstreetmap.org) to collect map features of the application. data. WideQuick therefore has access to high-quality maps that are updated continuously; these updates Objects from the object library can be positioned at any are downloaded automatically from OpenStreetMap as location on the map (latitude and longitude) and the they become available. Up to 50 MB of map data can be entire world map is available. Interaction objects (such stored offline following initial connection. To begin with, as buttons, history objects, etc.) cannot be positioned on the map object is available for WideQuick Runtime and the map. Besides the X and Y coordinates, the dynamics Remote Client. function as normal. A WideQuick object has more or less the same interaction options available as when it is Map object is included as standard with the license positioned in a standard workview; for example, you can levels Advanced and Premium. click on an object to open a workview/dialog.

16 - @

Example

The example below initially shows a map of Skåne, not in Lund. If you zoom in further on the map, Wide- Blekinge and parts of Halland and Småland. At this zoom Quick will display each individual property in Lund, togeth- level, a small information field is displayed in Malmö, Lund er with brief BMS information and an indication of the and Kristianstad showing the number of properties that property for which one or more alarms are activated. the company in question owns or has responsibility for in each city, as well as a colour or alarm symbol indicating When the operator clicks on a property, the left-hand that everything is OK in Malmö and Kristianstad but image shows information about the property in question.

- - 17 Map Object Cont.

Example cont.

The map object in WideQuick also enables you to move an object dynamically on the map. A script command containing latitude and longitude enables the position of objects to be changed continuously in WideQuick Runtime. In the example below, we update the location of the train, the grey information box.

17:31

17:39

17:43 17:5 5

18 - There is an option to pan and zoom in on an object on the map automatically if an event occurs, such as an alarm. When WideQuick automatically zooms in on an object, the program can also activate other functions, such as displaying a related plan drawing showing all the security objects.

The image above shows the map object dialog in WideQuick Designer.

- - 19 New Functions for Managing Images

SVG images and other image formats have been available for use as background images in workviews for some time. Now we have introduced new options for adapting the image to the workview.

Description of the function

In the new version of WideQuick 10.0, you can scale a background image in three ways in relation to the workview. This is useful, for example, if you have a background image in a workview that is designed in one format but displayed in another. An example of this could be where the background image is a floor and you want to place objects that will hold their position relative to the background image. This is extremely useful if you have a fixed-size multiviewer, for example, where you want to display subviews of varying sizes, which therefore need to be adjusted to the multiviewer’s dimen- sions. New image management features are included as standard with all license levels. Example

There are new setting options for scaling images in workviews and in the image object when displaying background images: Keep aspect ratio, Tiled and Stretch. We demonstrate below how these three functions work:

Keep aspect ratio The image retains its size ratio e.g. “16:9”.

Tiled Stretch If the workview is larger than the image, the image The image is stretched or shrunk to the extent necessary is repeated as many times as necessary to cover the to cover the entire workview surface. surface of the workview.

20 - Running WideQuick Runtime as a service

From WideQuick version 10.0 onwards, you can run WideQuick Runtime as a service. There are three elements to this new feature: 1) Run WideQuick Runtime without a user interface 2) Integration with Windows Service 3) User interface makes it easy to configure the service.

Description of the function

When WideQuick Runtime runs as a service, the program loads all the components in the application as usual, but excludes all functionality that requires a graphical user interface, such as workviews and their content. Important messages, such as “Invalid License”, are written to log files instead of being displayed in an on-screen dialog box. All functionality that requires WideQuick Monitor is disabled when you run WideQuick Runtime as a service. If you want to use the “Transfer to target system” function, you will need to launch WideQuick Runtime in “window mode” so you can transfer the project and then restart WideQuick Runtime as a service.

WideQuick Runtime can run in “service mode” (headless) on Linux, although no script is provided for doing this automatically.

Running WideQuick Runtime as a service is included as standard with the license level Premium but is also included with the Option Package Communication for the license level Advanced.

- - 21 Window Manager

Window Manager is a new function that uses the “windowManager” script object together with the “desktop” and “Screen” objects to provide the user with powerful options for specifying the position of workviews on different screens.

Description of the function

The “desktop” object the system right now?”. You can also use the object to Responds to queries such as “Which screen is the give commands such as “Move my window to the top primary screen?”, “How many screens are there?”, “Is right of the second screen (1, screen list is zero in- WideQuick Runtime running in service mode without ac- dexed)”. In the script, this command would be as follows: cess to screens?”, “Is a virtual screen area being used?”, windowManager.moveTo(1, myView, windowManager. “Which screen is this workview displayed on?” and “Give TopRight); me an object that represents the second screen”. You can also use the “windowManager” object to The “Screen” object receive notification when new windows are created or removed, for example. This makes it easy to write a Responds to queries relating to a specific screen, such script that makes all pop-up dialogs display on a specific as “What resolution does the screen have?”, “How big screen, for example. The “windowManager” object is the virtual screen area?”, “What is the position of makes it much easier to take into account how the the screen relative to the primary screen?” and “Which WideQuick project will handle multiple screens. It is also windows are displayed on this screen?”. far easier to remain aware of when screens are added or The “windowManager” object removed. Responds to queries relating to the handling of stand- Window Manager is included as standard with the alone workviews. An example is “Which windows are in license levels Advanced and Premium.

22 Example

The “windowManager” object, together with the related “desktop” and “Screen” objects, can be used in a number of different ways. In the example below, we have developed a dialog box in WideQuick Designer that can be used in WideQuick Runtime to specify where the operator wants to display the different functions.

23 CSV Import of Workviews – Enhanced Functionality

In the previous version, WideQuick 9.0, we introduced the CSV import of workviews function. This function is used when you have a finished basis in the form of drawings and associated object data, created using AutoCAD for example, which you want to import into one or more workviews in WideQuick. We have now significantly updated this feature to further improve and streamline the workflow.

Description of the function

With the CSV import of workviews feature, you can example. The CSV file contains information about which quickly create a large number of workviews, which to- background image to use, often in SVG format, as well as gether contain thousands of smart objects from the ob- all the data for all the objects that will be included in the ject library, in a single import. This feature loads the CSV workviews to be created or updated on import. data created from drawings produced in AutoCAD, for

WideQuick Objects Data Objects Library

Drawing CSV file WideQuick WideQuick WideQuick e.g. Export e.g. CSV Drawing Designer Runtime AutoCAD Excel Import Workview Workview

24 CSV Import of Workviews – Enhanced Functionality

Example

The main new addition is that you can now combine new settings from the CSV files with an existing workview. You can create completely new objects and also update existing ones. You cannot change the type of the object, however, without first removing the object from the existing workview.

The settings for scaling views have been added directly to the dialog. You can manually adjust the settings for Offset X, Offset Y, Offset Rotation, Scale X, Scale Y, Scale Width and Scale Height. Once you have finished your adjust- ments, you can apply the settings to all the views that will be imported at the touch of a button. You can of course import the scaling settings directly from the CSV file(s).

25 CSV Import of Workviews – Enhanced Functionality Cont.

Example cont.

General improvements have been made, such as clearer information in the log system for the dialog as well as icons that guide the user to what needs to be done. If you change how the views are imported in relation to existing views, for example, an icon will be displayed on the “Reload CSV data” button, which must be pressed in order to view the results of the selection. It now makes no difference at all which order you define the properties of workviews, objects and templates in the CSV files.

There is now support for “templates” and extensive options for specifying settings for individual objects and workviews by adding supplementary data to the CVS files. For example, you can choose to have all workviews with a name ending in “_dlg” set to the size “800x600” unless explicitly specified otherwise for the individual workviews in the CSV settings. The order of priority for the settings is: specific object settings, template settings for a specific type with a name requirement (for example, the name must end with “_txt”), general settings for a specific type irrespective of name. In this example, we specify that all texts should be rotated 20 degrees, contain the text “Default text from template” and have the colour blue (see row 18 in the Excel file) except for those ending with “_txt”, which are to be rotated 60 degrees (see row 19 in the Excel file) unless otherwise specified for the individual text object. In addition, in our example, all boxes with a name ending with “_box” are to have the size 60x60 and the colour grey (see row 20 in the Excel file) unless otherwise specified for the individual object; for example box2_box is to have the colour steelblue (see row 10 in the Excel file), box3_box is to have the colour pink (see row 11 in the Excel file) and box4_box is to have the size 80x80 (see row 12 in the Excel file). These are just a few examples of the many settings options available. The results from the Excel file are displayed in the CSV import preview.

26 - CSV Import of Workviews – Enhanced Functionality Cont.

Workviews can be added automatically to subfolders using their naming conventions. For example, the name “Building_A/Floor_3” creates the workview “Floor_3” under the folder “Building_A”. You can remove the same workview by importing the view with the name “Floor_3” on the next import. This technology allows you to move around thousands of workviews quickly and easily.

CAD Drawing

CSV file

WideQuick CSV Import preview

WideQuick Designer

WideQuick Runtime

- 27 Logging – Enhanced Functionality

The logging function has been enhanced with new options that will make it easier to configure which variables to log.

Description of the function

You can now configure the loggers to log, for example, You can also disable the start and stop values for logging all variables/tags that follow the pattern “A_*”. In other so as to obtain a cleaner table of values. This also means words, variables called “A_alarm”, “A_temp” and “A_ef- that WideQuick cannot detect the program restart. fect”, for example, will be logged automatically. Wid- eQuick Runtime supports the managing of variables that are added and removed between software restarts.

Example

28 - Object List – Enhanced Functionality

From WideQuick version 10.0 there is a new script function in the object list. This has been developed so that the object list can be instructed which row should be marked as active using a script.

Description of the function

The new function is called “_minobjektlista_.setCurrentIn- The new function means you can make the object list dex()”. Every time the object list receives new data, the “remember” which row was last selected. The user must row selected is reset because the object list has to delete then determine whether the previous row has changed its all its data before it can load the new data. position in the list compared with the previous update.

Example

- 29 Tab Object – Enhanced functionality

From WideQuick version 10.0 onwards, you can edit the text content of the tab headings.

Description of the function

The content of the tab headings can be set dynamically using simple script calls. Both static text and variable values can be displayed. This means you can create a function in the style of “Alarm (3)”, where the figure 3 indicates that there are three active alarms displayed on the tab.

Example

This shows a tab object with dynamic data displayed in the first three tabs, such as the number of fire alarms.

30 - Multiviewer – Enhanced functionality

The multiviewer is an object that enables you to choose which view is displayed in the object. From WideQuick version 10.0 onwards, we have made configuration simpler for when the multiviewer needs to display a large number of workviews.

Description of the function

From version 10.0 onwards, there are several differ- The major benefit of using the “setWorkview” function is ent ways you can specify the view to be displayed. You that the multiviewer can then contain hundreds, maybe can do this using an index, as before, but you can now even thousands, of different workviews. Having to con- also specify which view is displayed using a script call figure these manually to be included in the multiviewer’s (setWorkview). You can also use the script call to specify indexed list would have been a very time-consuming workviews with a path. Views specified in this way are task. added to the object automatically if they are not configured as part of the object in WideQuick Designer.

- 31 Debug Log

From WideQuick version 10.0 it is possible to use a new function to log data during execution, making debugging easier if there is a script error, for example. To activate this function, simply select the setting in the project dialog. The data is written to the file /Log/Debug.log.

Description of the function

When the debug log is enabled, WideQuick Runtime The log is always complete as it automatically contains writes relevant data to Debug.log during execution to information about both warnings and errors that arise make debugging easier. Examples of the data logged during execution. If you need help from our support de- include: license information, hardware information, partment, you will only need to send the Debug.log file whether or not WideQuick is running as a service, which for debugging instead of sending Warnings.log and Error. elements of WideQuick are loaded (script, database, log as was previously the case. workviews, etc.), users who log in, ongoing monitoring of memory usage by both WideQuick Runtime and the The user can log additional data in Debug.log themselves rest of the system, whether clients can connect (blocked in order to provide further debugging information. They because of license or settings), any problems arising can do this by calling the script function “Debugger. because of invalid scripts. log(_msg_)”. These messages are always written to the Debug.log file, even if the function has not been enabled We are likely to add further data in the future as we in the project settings. receive feedback from our customers.

Example

The user’s own texts are always marked “[User]” so as to clearly indicate data for which the user is responsible. 2019-03-22 15:48:08.221 78) [User] window created: Workview1.kvie

If the memory usage of WideQuick Runtime or the system fluctuates by more than 5% in either direction, this is logged as shown below: 2019-03-22 15:48:08.035 73) <--- System check ---> 2019-03-22 15:48:08.037 74) System CPU load: 16.8675% 2019-03-22 15:48:08.039 75) Process RAM (Used/Total): 98/32639 MB (0%) 2019-03-22 15:48:08.040 76) System RAM (Used/Total): 7372/32639 MB (23%) 2019-03-22 15:48:08.042 77) --- System check ---

32 - Debug Log

- 33 Ordering a WideQuick License

Information to help you choose the right license when ordering WideQuick We believe it is important for all those interested in WideQuick to know just how easy it is to choose the right license when ordering our WideQuick HMI/SCADA/PSIM software. We want the order process to be simple, even though there is a large number of licenses and items to choose from.

You only order WideQuick Runtime licenses A license is only required for WideQuick Runtime. The number of clients (WideQuick Remote Client) and the number of web clients (WideQuick Web Client) that the system can have are determined by the number of connections allowed for each WideQuick Runtime license. When you order a WideQuick Runtime license, the basic license often includes a number of client connections, to which more client connections can be added.

Choice of operating system As WideQuick can run on Windows or Debian Linux, the first selection to make is the operating system on the computer where WideQuick Runtime will run.

Ordering a new license You have two options when ordering a new license: • New license without free upgrades • New license with 5 years’ free upgrades (recommended)

Upgrading an existing license There are several different options available for upgrading an existing license: • Upgrade to more tags and/or to a higher license level but keep the same version. • Upgrade to a license with 5 years’ free updates, with the additional option of upgrading to more tags and/or to a higher license level at the same time. • Upgrade a license with 5 years’ free updates to more tags and/or to a higher license level. • In addition to the above options, you can also update an existing license to the latest version, but only if your current license is no more than two versions older.

Selecting a license level for WideQuick You can choose which license level you require; in other words the level of functionality you want WideQuick to have. There are four license levels you can choose from for WideQuick Runtime: HMI-BASIC, HMI-EXTENDED, SCADA- ADVANCED and SCADA-PREMIUM. The table on the next page shows the differences between the different license levels. The main difference is that WideQuick Runtime with a SCADA license or a PSIM license can have one or more WideQuick Remote Client and/or more WideQuick Runtime connections, which HMI licenses cannot. HMI-BASIC is intended for training purposes only.

Size of the system Once you have chosen a license level, all that remains is to select the size of the license, i.e. the maximum number of external tags (variables) that WideQuick Runtime will use.

34 - WideQuick License Table

HMIHMIHMI - Runtime- Runtime- Runtime SCADASCADASCADA - Runtime- Runtime- Runtime PSIMPSIMPSIM - Runtime- Runtime- Runtime WideQuickWideQuickWideQuick HMI/SCADA/PSIM HMI/SCADA/PSIM HMI/SCADA/PSIM 10.x 10.x 10.x BasicBasicBasic ExtendedExtendedExtended AdvancedAdvancedAdvancedPremiumPremiumPremium AdvancedAdvancedAdvancedPremiumPremiumPremium AbleAbleAble to to connect to connect connect to to other to other other WideQuick® WideQuick® WideQuick® Runtime Runtime Runtime NoNoNo NoNoNo YesYesYes YesYesYes YesYesYes YesYesYes ParallelParallelParallel WideQuick® WideQuick® WideQuick® Remote Remote Remote Client/Runtime Client/Runtime Client/Runtime connections connections connections 0 0 0 0 0 0 2 (12)2 (12)2 (12) 5 (20)5 (20)5 (20)(100) (100) (100) 2 (12)2 (12)2 (12) 5 (20)5 (20)5 (20)(100) (100) (100) ParallelParallelParallel WideQuick® WideQuick® WideQuick® Web Web Web Client Client Client connections connections connections 0 0 0 5 (15)5 (15)5 (15) 5 (15)5 (15)5 (15) 1010 (20)10 (20) (20)(100) (100) (100) 5 (15)5 (15)5 (15) 1010 (20)10 (20) (20)(100) (100) (100) ParallelParallelParallel WideQuick® WideQuick® WideQuick® OPC OPC OPC Server Server Server connections connections connections 0 0 0 2 (12)2 (12)2 (12) UnlimitedUnlimitedUnlimited UnlimitedUnlimitedUnlimited UnlimitedUnlimitedUnlimited UnlimitedUnlimitedUnlimited

NumberNumberNumber of of workviews of workviews workviews 161616 128128128 256256256 327683276832768 256256256 327683276832768 ThemesThemesThemes NoNoNo YesYesYes YesYesYes YesYesYes YesYesYes YesYesYes LanguageLanguageLanguage and and andunit unit unit conversion conversion conversion NoNoNo YesYesYes YesYesYes YesYesYes YesYesYes YesYesYes WindowWindowWindow manager manager manager NoNoNo NoNoNo YesYesYes YesYesYes YesYesYes YesYesYes PanPan Panand and andzoom zoom zoom NoNoNo NoNoNo YesYesYes YesYesYes YesYesYes YesYesYes EmbeddedEmbeddedEmbedded maps maps maps NoNoNo NoNoNo YesYesYes YesYesYes YesYesYes YesYesYes

NumberNumberNumber of of Users of Users Users and and andPrivileges Privileges Privileges 1 1 1 161616 UnlimitedUnlimitedUnlimited UnlimitedUnlimitedUnlimited UnlimitedUnlimitedUnlimited UnlimitedUnlimitedUnlimited MicrosoftMicrosoftMicrosoft Active Active Active Directory Directory Directory NoNoNo NoNo (Option)No (Option) (Option) YesYesYes YesYesYes YesYesYes YesYesYes

Database,Database,Database, number number number of of connections of connections connections 0 0 0 1 1 1 4 4 4 8 8 8 4 4 4 8 8 8 Database,Database,Database, custom custom custom SQL SQL SQLqueries queries queries NoNoNo NoNoNo YesYesYes YesYesYes YesYesYes YesYesYes TCPTCP TCPlisteners* listeners* listeners* NoNoNo NoNoNo NoNo (Option)No (Option) (Option) YesYesYes NoNo (Option)No (Option) (Option) YesYesYes RemoteRemoteRemote Procedure Procedure Procedure Calls Calls Calls (RPC)* (RPC)* (RPC)* NoNoNo NoNoNo NoNo (Option)No (Option) (Option) YesYesYes NoNo (Option)No (Option) (Option) YesYesYes MicrosoftMicrosoftMicrosoft .NET .NET .NET plugin plugin plugin support* support* support* NoNoNo NoNoNo NoNo (Option)No (Option) (Option) YesYesYes NoNo (Option)No (Option) (Option) YesYesYes MicrosoftMicrosoftMicrosoft Windows Windows Windows Service* Service* Service* NoNoNo NoNoNo NoNo (Option)No (Option) (Option) YesYesYes NoNo (Option)No (Option) (Option) YesYesYes

ProjectProjectProject file file fileencryption encryption encryption NoNoNo NoNo (Option)No (Option) (Option) YesYesYes YesYesYes YesYesYes YesYesYes ParallelParallelParallel Ethiris® Ethiris® Ethiris® Server Server Server connections connections connections 0 0 0 0 0 0 2 (12)2 (12)2 (12) UnlimitedUnlimitedUnlimited 2 (12)2 (12)2 (12) UnlimitedUnlimitedUnlimited EthirisEthirisEthiris Extended Extended Extended Functionality Functionality Functionality NoNoNo NoNoNo NoNo (Option)No (Option) (Option) NoNo (Option)No (Option) (Option) YesYesYes YesYesYes

NumberNumberNumber of of variables of variables variables can can canbe be logged be logged logged 646464 2 0482 0482 048 2525 00025 000 000 100100 100000 000 000 2525 00025 000 000 100100 100000 000 000 MaxMaxMax numbers numbers numbers of of variables, of variables, variables, tags tags tags and and andalarms alarms alarms (Total) (Total) (Total) 1 0241 0241 024 4 096-164 096-164 096-16 384 384 3841616 384-10016 384-100 384-100 000 000 0003232 76832 768 768- 400 - 400 - 400000 000 0001616 384-10016 384-100 384-100 000 000 0003232 76832 768 768- 400 - 400 - 400000 000 000 NumberNumberNumber of of external of external external tags tags tags 512512512 102410241024 – 8192 – 8192– 8192 204820482048 - 50 - 50 -000 50 000 000409640964096 - 200 - 200 - 200000 000 000204820482048 - 50 - 50 -000 50 000 000409640964096 - 200 - 200 - 200000 000 000

HMI - Runtime SCADA - Runtime HMIPSIM - Runtime - Runtime SCADA - Runtime PSIM - Runtime WideQuick HMI/SCADA/PSIM 10.x WideQuick PSIM 10.x Basic Extended Advanced Premium AdvancedBasic ExtendedPremium Advanced Premium Advanced Premium Able to connect to other WideQuick® Runtime AbleNo to connect to otherNo WideQuick®Yes Runtime Yes NoYes NoYes Yes Yes Yes Yes Parallel WideQuick® Remote Client/Runtime connections Parallel0 WideQuick® 0Remote Client/Runtime2 (12) connections5 (20) (100) 20 (12) 5 (20)0 (100) 2 (12) 5 (20) (100) 2 (12) 5 (20) (100) Parallel WideQuick® Web Client connections Parallel0 WideQuick®5 (15) Web Client connections5 (15) 10 (20) (100) 50 (15) 105 (15)(20) (100) 5 (15) 10 (20) (100) 5 (15) 10 (20) (100) Parallel WideQuick® OPC Server connections Parallel0 WideQuick®2 (12) OPC Server connectionsUnlimited Unlimited Unlimited0 2Unlimited (12) Unlimited Unlimited Unlimited Unlimited

Number of workviews Number16 of workviews128 256 32768 16256 12832768 256 32768 256 32768 Themes ThemesNo Yes Yes Yes NoYes YesYes Yes Yes Yes Yes Language and unit conversion LanguageNo and unit conversionYes Yes Yes NoYes YesYes Yes Yes Yes Yes Window manager WindowNo manager No Yes Yes NoYes NoYes Yes Yes Yes Yes Pan and zoom Pan andNo zoom No Yes Yes NoYes NoYes Yes Yes Yes Yes Embedded maps EmbeddedNo maps No Yes Yes NoYes NoYes Yes Yes Yes Yes

Number of Users and Privileges Number1 of Users and16 Privileges Unlimited Unlimited Unlimited1 Unlimited16 Unlimited Unlimited Unlimited Unlimited Microsoft Active Directory MicrosoftNo ActiveNo Directory (Option) Yes Yes NoYes No (Option)Yes Yes Yes Yes Yes

Database, number of connections Database,0 number of1 connections 4 8 0 4 1 8 4 8 4 8 Database, custom SQL queries Database,No custom SQLNo queries Yes Yes NoYes NoYes Yes Yes Yes Yes TCP listeners* TCP listeners*No No No (Option) Yes NoNo (Option) NoYes No (Option) Yes No (Option) Yes Remote Procedure Calls (RPC)* RemoteNo Procedure CallsNo (RPC)* No (Option) Yes NoNo (Option) NoYes No (Option) Yes No (Option) Yes Microsoft .NET plugin support* MicrosoftNo .NET pluginNo support* No (Option) Yes NoNo (Option) NoYes No (Option) Yes No (Option) Yes Microsoft Windows Service* MicrosoftNo Windows NoService* No (Option) Yes NoNo (Option) NoYes No (Option) Yes No (Option) Yes

Project file encryption ProjectNo file encryptionNo (Option) Yes Yes NoYes No (Option)Yes Yes Yes Yes Yes Parallel Ethiris® Server connections Parallel0 Ethiris® Server0 connections2 (12) Unlimited 20 (12) Unlimited0 2 (12) Unlimited 2 (12) Unlimited Ethiris Extended Functionality EthirisNo Extended FunctionalityNo No (Option) No (Option) NoYes NoYes No (Option) No (Option) Yes Yes

Number of variables can be logged Number64 of variables2 048 can be logged25 000 100 000 2564 000 2100 048 000 25 000 100 000 25 000 100 000 Max numbers of variables, tags and alarms (Total) Max1 024numbers of4 variables,096-16 384 tags16 and 384-100 alarms 000 (Total)32 768 - 400 000 16 1384-100 024 000 432 096-16 768 - 400384 00016 384-100 000 32 768 - 400 000 16 384-100 000 32 768 - 400 000 Number of external tags Number512 of external1024 tags– 8192 2048 - 50 000 4096 - 200 000 2048512 - 50 000 10244096 – - 8192 200 000 2048 - 50 000 4096 - 200 000 2048 - 50 000 4096 - 200 000 *Included in the Option Package Communication for WideQuick Runtime Advanced

- - 35 Release Notes

New in all products

1. Updates in CSV import of workviews The new functionality combines new/updated CSV data with existing workviews. Existing objects are updated if properties such as position, width, height and colour have changed. New objects are integrated among existing ones. As well as combining data in this way, you can now organise workviews, adjust scaling and inherit from templates.

2. New image management features Support for the use of an SVG image as a background image for workviews and action objects. The aspect ratio of the image can also be maintained when the image is displayed in scaled format. WideQuick’s image object also supports aspect ratio locking and this applies to all image formats supported by WideQuick.

3. Enhanced features of the Multiviewer object The multiviewer now supports the dynamic editing of workviews using a script call. You can also specify workviews with a path. Views specified in this way are added to the object automatically, even if they are not configured as part of the object in WideQuick Designer.

4. Option to change headings dynamically in the tab object Support for dynamic editing of tab object headings using a simple script call.

5. New functions in the ByteArray script object The copy(), interpret(), toUint16(), toBoolean() and toDouble() functions have been added to the ByteArray object.

6. Support for button toggle function in WideQuick Web Client The toggle function for standard buttons is supported in WideQuick Web Client. This function is not displayed; i.e. the button does not change, although the variable is toggled.

7. Color theme support Color themes allow you to customise the appearance of WideQuick projects to an even greater extent. This feature mainly applies to interaction objects such as buttons, sliders and history objects, but can also be used for the background color of workviews. Color themes are available using scripts and graphic objects and the user can define their own colors.

8. LineChart2 object The line chart has a new and more modern interface that has inherited much of its functionality from the History2 object. The LineChart2 object works just like the original object, but supports an unlimited number of axes and graphs, for example. You can add and remove axes and graphs while it is running. Performance and the accuracy of drawings have been improved significantly despite the expanded functionality.

9. Tooltip Tooltip enables you to display text information when the user moves the cursor over a particular object, for example. You can also use the new “onEnter” and “onLeave” functions to perform other actions, such as opening a pop-up window.

10. Run WideQuick Runtime as a service This feature enables WideQuick to be run as a service. The functionality is the same as when WideQuick Runtime is run as an application, except for those elements that use WideQuick Monitor. All functionality that requires Wide- Quick Monitor is disabled when you run WideQuick Runtime as a service.

36 - 11. Support for pan and zoom The new pan and zoom function can be enabled for individual workviews. The settings for this can be found on a new tab called “Layout”, which has been added under the workview properties dialog. On this tab, the user can set the scaling for the object (in relation to the workview or background image); whether the sliders are hidden, displayed as needed, or always displayed; and whether the user is able to zoom and/or pan using the pointing device.

12. Map object The MapView object can display a complete map of the world with up to 20 zoom levels using OpenStreetMap. The object’s performance is maximised using the computer’s graphics card (GPU). A WideQuick object can be positioned anywhere on the map and made hidden/visible depending on the zoom level.

13. Loggers updated The user can define multiple log variables in a logger using “*”. If multiple variables are defined using a specific naming structure, parts of the name can be excluded; for example “*_LB01*” would log all tags with a name containing “_LB01”. On restart, the logger is updated with the variables that have been added or deleted.

14. Debug log The debug log function activates a detailed debug log. Information about license options, system checks, remote client connections, script validations, warnings, errors, and debug information is saved to a file – {Project directory}/Log/ Debug.log. By default, the debug log is disabled because it requires a large amount of resources, but you can easily enable it under project settings.

15. WindowManager script object The new WindowManager object makes managing WideQuick Runtime window and screen configurations easy. The object can interact with the desktop without the need to specify hard-coded resolutions.

- - 37 Release Notes

Bug fixes since WideQuick 9.0.0

The issues below have been resolved since WideQuick 9.0.0, with the potential for more to follow.

WideQuick Designer:

The logger dialog displayed version conflict warnings when the storage type database was used.

WideQuick Runtime: DotNetPlugin: Some DLL files did not load correctly.

DotNetPlugin: Some areas of application lacked support for Unicode.

Printer.print(workview) did not recognise the “rotation” property.

Custom button did not recognise the “Autosave” property.

Custom button without images was not rendered correctly.

Graphical issue with the objects Polygon and History2.

The alarm list did not behave correctly when “Display alarms for group” was set to “All known systems”.

System.open() behaved incorrectly in a number of ways.

Minor problems with the on-screen keyboard.

Textbox.value was always set to String.

The property is now returned as either Number or String, depending on the “Type” setting.

WideQuick Web Client:

The Alarm object did not take the font setting in WideQuick Web Client into account.

The button lacks certain script properties in WideQuick Web Client.

Minor error with Custom Button in WideQuick Web Client.

38 - - 39 KENTIMA PRODUCT LINES

AUTOMATION HMI/SCADA SOFTWARE INDUSTRIAL COMPUTERS OPERATOR PANELS

SECURITY VIDEO MANAGEMENT SOFTWARE NETWORK VIDEO RECORDER/CLIENT PSIM SOFTWARE

Postadress: Besöksadress: BOX 174 Kastanjevägen 4 SE-245 22 Staffanstorp 245 44 Staffanstorp Sverige Sverige AB. 19004-01. English. of Kentima trademark registered WideQuick are

Tel: +46 (0)46-25 30 40 Fax: +46 (0)46-25 03 10