Home
Business Logic / Control
Endless possibilities in data processing for your projects.
Control graphics
GIS Viewer EWO
WinCC OA GIS Viewer provides the cartographic representation of objects in WinCC OA. This new feature provides numerous advantages, particularly in geographical distributed systems, like in Water, Traffic, Oil & Gas or Energy.

Version Information
Release Notes, Update information, Certifications and Frequently Asked Questions.
Concepts
Your first step into modern and powerful process visualization.
Deployment
Topics, you need to know, before using WinCC OA.
Security
Go beyond the norm in cybersecurity.
Engineering
Powerful tools for easy or complex engineering tasks.
Data Management
Classify, structure and archive your data.
Business Logic / Control
Endless possibilities in data processing for your projects.
- Introduction to CTRL
  An introduction to the product's own programming language Control(CTRL).
- Control Classes
  The overview of classes available in Control.
- Types of Control Functions
  An overview of the types of functions distinguished within Control.
- Control graphics
  - Graphics objects
  - Attributes of graphics objects
  - Panel functions
  - Reference Functions
  - Arc
  - AttentionEffect EWO functions
  - Bar trend
  - BarChart3D EWO
  - Button
  - Chart.ewo
  - Calendar
  - Cascade
  - Checkbox
  - Clock
  - Combobox
  - DateTimeEdit EWO functions
  - DialGauge EWO
  - DoubleSpinbox EWO
  - DpTreeView
  - DpTypeView
  - Embedded module
  - Frame
  - GIS Viewer EWO
    WinCC OA GIS Viewer provides the cartographic representation of objects in WinCC OA. This new feature provides numerous advantages, particularly in geographical distributed systems, like in Water, Traffic, Oil & Gas or Energy.
    - Introduction to the GIS Viewer
    - "acceptDrops"
      Specifies whether drop events are enabled for this object.
    - "addEmptyLayer"
      Adds an empty layer to a map.
    - "addPointToLayer"
      Adds a coordinate to a layer.
    - "addPointToPolygon"
      Adds a point to a polygon.
    - "addPointToPolyline"
      Adds a point to a polyline.
    - "addPolygonToLayer"
      Adds a polygon to a layer.
    - "addPolylineToLayer"
      Adds a polyline to a layer.
    - "addRectangleToLayer"
      Adds a rectangle to a layer.
    - "addVarValueColorMapping"
      With the color mapping function, you can set different colors for a shape for each range of values of an assigned variable.
    - "assignVariableToShape"
      Assigns a variable and a value to a shape so that the shape can be selected by the variable.
    - "contextMenuPolicy"
      Defines how the respective widgets shows the context menu.
    - "deleteAll"
      Deletes all loaded layers and shapes of the GIS Viewer.
    - "deleteLayer"
      Deletes one specified Layer.
    - "drawTooltip"
      Shows a tooltip for the GIS Viewer.
    - "exportLayerIndexFile"
      Exports a layer index file that contains all the information of a layer.
    - "focus"
      The attribute "focus"; returns TRUEif the object has the focus.
    - "font"
      Sets the font of an object.
    - "getLayerFieldIndex"
      Returns the field index for the specified field name in the specified layer.
    - "getLayerFieldName"
      Returns the field name for the specified index in the specified layer.
    - "getLayerName"
      Returns the layer name for the specified index.
    - "getNumFieldsLayer"
      Returns the number of fields for the layer.
    - "getNumLayers"
      Returns the number of layers.
    - "getNumObjects"
      Returns the number of objects in all layers.
    - "getNumObjectsLayer"
      Returns the number of objects for the layer.
    - "getNumPoints"
      Returns the number of points in all layers.
    - "getNumPolygons"
      Returns the number of polygons in all layers.
    - "getShapeNameInLayer"
      Returns the shape name in a layer.
    - "getShapeXCoordinate"
    - "getShapeYCoordinate"
      Returns the Y coordinate for the specified shape.
    - "getXLeft"
      Returns the left edge's x coordinate of the currently displayed area.
    - "getXRight"
      Returns the right edge's x coordinate of the currently displayed area.
    - "getYBottom"
      Returns the bottom edge's Y coordinate of the currently displayed area.
    - "getYTop"
      Returns the top edge's Y coordinate of the currently displayed area.
    - "hideLayer"
      Hides a layer.
    - "home"
      Zooms a map to the full extent.
    - "isActiveWindow"
      The attribute "isActiveWindow"; returns TRUE if this widget is the active window, otherwise FALSE.
    - "layoutDirection"
      Defines the widget's layout direction.
    - "loadColorFile"
      Loads a WinCC OA color file.
    - "loadShapeFile"
      Loads an ESRI shape file.
    - "maxWidthForText"
      Sets the maximum width of the shown area for which the text will be displayed.
    - "memoryReport"
      Creates a memory report file that shows what is in the memory.
    - "moveRectangle"
      Moves a rectangle.
    - "pan";
      Pans a map.
    - "PVSSLinkSumAlertToShape"
      Links a sum alert data point with a shape in the GIS Viewer.
    - "PVSSReceiveSumAlertStatus"
      Passes the results of a dpQuery to the GIS Viewer.
    - "PVSSSetSumAlertPanels";
    - "removePolyLineGradient"
      Removes polyline gradient.
    - "resetShapeFillColor"
      Resets the shape fill color.
    - "resetShapeLineColor"
      Resets the shape line color to the default value.
    - "scrollWheelEnabled"
      Defines whether zooming with the mouse wheel shall be possible.
    - "selectColor"
      Defines the color for the selection window (hold down the left mouse button and draw a rectangle).
    - "selectShapeVarAsShapeName"
      Sets the entries of a selected Field (Column inside the .dbf file) as names for the shapes of a layer.
    - "setAutoZoomExtra"
    - "setLayerClickEnabled"
      Enables or disables the click events for the GIS Viewer.
    - "setLayerDrawAfterText"
      Sets the selected layer at the top.
    - "setLayerFillColor"
      Sets the layer fill color.
    - "setLayerLineColor"
      Sets the layer line color.
    - "setLayerLineStyle"
      Sets the layer line style.
    - "setLayerLineWidth"
      Sets the layer line width. The line width be also set using the function "setLayerLineStyle". The defined width in "setLayerLineStyle" overwrites the width in this function.
    - "setLayerPointSymbol"
      Sets a displaying symbol for a point on a specific layer
    - "setLayerVisibleRange"
      Sets the visible range of a layer.
    - "setMinWidthLayer"
      Sets the minimum width for a layer.
    - "setOpen"
      Sets an item to open if open is TRUE and the item is expandable or to close if open is FALSE.
    - "setPolyLineGradient"
      Sets a polyline gradient.
    - "setPropShapeWildcard"
      Set a property of various shapes that match a wildcard.
    - "setShapeColorByName"
      Sets a shape color by the color name.
    - "setShapeFillColor"
      Sets the fill color for a shape.
    - "setShapeIcon"
      Sets an icon for a shape.
    - "setShapeLineColor"
      Sets the shape line color.
    - "setShapePVSSSymbol"
      Sets a panel reference to a specific shape/point inside the GIS Viewer.
    - "setSmoothSteps"
      Set smooth zooming steps for a map.
    - "setTextVisible"
      Sets a text visible.
    - "showLayer"
      Shows a layer.
    - "showShapesAll"
      Shows all shapes for a layer.
    - "showShapesWildcard"
      Shows shapes by wildcard.
    - "tooltipDuration"
      Specifies how long a tooltip is shown.
    - "updatesEnabled"
      This attribute specifies whether updates of a widget (for example, a textEdit, slider, progress bar, zoom navigator, LCD number or thumb wheel) have been enabled.
    - "updateShapeAndAutoZoom"
      Updates a shape with a color and zooms it in.
    - "x", "y"
      The attributes x and y return the coordinate of an object (e.g. a textEdit, a progress bar, a slider, a zoom navigator, an LCD number or a thumb wheel). x returns the X coordinate of an object. y returns the Y coordinate of an object.
    - "zoom"
      Zooms a map in or out.
    - "zoomByVariableValue"
      Zooms all shapes that are assigned to a certain value of a variable.
    - "zoomByWildcard"
      Allows to zoom to a specific area of the map that is determined using the field entry of the .dbf file.
    - "zoomEnabled"
      Defines if an area can be selected and zoomed with the left mouse button.
    - "zoomLimitMaximum"
      Defines the maximum zoom factor that is allowed.
    - "zoomLimitMinimum"
      Defines the minimum zoom factor that is allowed.
  - Label Functions
  - Layoutgroup functions
  - LCD number
  - Maps Widget - Properties and Functions
  - PDF Viewer EWO
  - PictureFlow EWO functions
  - Pipe
  - Polyline
  - Primitive text
  - Progress bar
  - Radio box
  - Rectangle
  - Reference Functions
  - Scheduler.ewo
  - Selection list
  - Slider
  - Spin button
  - Splitter
  - Tab
  - Table
  - TextEdit
  - Text field
  - Thumb wheel
  - ToggleSwitch EWO
  - Tree widget
  - Trend
  - VideoPlayer.ewo
  - WebView EWO
    All functions, specifically available for the WebView EWO.
  - Zoom Navigator
    Functions available for the Zoom Navigator widget.
- CONTROL Functions
- CtrlExtension
  The CtrlExtension allows the addition of custom C++ code.
- CTRL Debugger
  You can use the CTRL debugger to debug the Control programming language. The debugger can be used via its own panel, which also enables the monitoring and setting of variable values during the execution of a script.
- SQL in CONTROL
  The database functions enable you to quickly carry out value queries on data points and elements.
- API Manager
  The WinCC OA API (Application Programming Interface) offers a number of functions adding special Managers to this process control system.
- NextGen Archiver Backend-API
  This chapter describes the NextGen Archiver Backend API
Data Visualization
User interfaces, Trends and Reports for every purpose and device.
Southbound Interfaces
The process connection to the actual machines/sensors.
Northbound Interfaces
Your portal to the cloud or supervising systems.
Web Connectivity / Network Interfaces
Data exchange, APIs and web technologies
User Management
All about authorization, authentication and login-customization.
Availability
How to get your system uptime to the maximum.
Reporting
Create state of the art project reports without limits.
Addons
Useful tools and enhancements for special demands.
Reference Tables
Detailed and extensive content for special project adaptation.
Videos & Tutorials
Explore the capabilities of WinCC OA with our carefully selected collection of video tutorials and guides.
WinCC OA Documentation
Basic information about terms and functions within the documentation.
Disclaimer
A brief clarification of liability exclusions or legal notices.

GIS Viewer EWO

WinCC OA GIS Viewer provides the cartographic representation of objects in WinCC OA. This new feature provides numerous advantages, particularly in geographical distributed systems, like in Water, Traffic, Oil & Gas or Energy.

Functions:

Displaying maps which are available in the ESRI shape file format.
Displaying WinCC OA objects (symbols, texts, color changes and/or process values) in different map layers.
Definition of any number of layers.
Automatic zoom to pending warnings or alarms.
Manual zoom (+, - and zoom of an area).
Easy navigation to plant panels and to the alarm / event screen

Individual geographic areas can be precisely monitored through automatic or manual zoom right down to the device level. Should system components be in warning or alarm status this is signified by colors, forms, symbols, or characters on the respective map, allowing fast and precise navigation to the interruption. The WinCC OA solution gain more informative value through combination of cartographic information with actual status signals of the plant. A much more efficient project design is also achieved through dynamic map material rather than static map frames.

The WinCC OA GIS Viewer EWO allows displaying and managing ESRI shapes files. You can display maps and add shapes to your maps.

The viewer was tailor-made to fit in with WinCC OA. Therefore, the GIS viewer provides various functions like:

Loading WinCC OA colorDB files. Therefore, the viewer understands WinCC OA colors including blinking colors,
A shape layer can be tied to WinCC OA _SumAlertPanel data point. Therefore, a shape will blink in case of an alarm of this data point,
The viewer understands the function dpQueryConnectSingle() and can perform a dpQueryconnect query and feed the results directly into the viewer.

The WinCC OA GIS Viewer does not come with any maps. ETM does not provide, or can not assist you, in getting ESRI shapes files. You may find free maps on the Internet or may have to purchase a map containing the appropriate information.

Maps can be obtained from many different vendors (e.g.: ESRI - Environmental Systems Research Institute).

See chapter Introduction to GIS_Viewer for useful examples of the GIS Viewer and a list of available functions.

Figure 1. GIS Viewer