WorldView For Windows Editor's Guide, October 23, 2009 PDF

Document Number: WV-201
WorldView for Windows

Editors Guide ____________________________________________
October 23, 2009

This manual describes how to use the editing facilities in WorldView for Windows.
Survalent Technology Corporation Mississauga, Ontario
Copyright 2000 2009 Survalent Technology Corporation

All rights reserved
WV-201 WorldView for Windows Editors Guide
Survalent Technology Corporation 2600 Argentia Road Mississauga, Ontario L5N 5V4
TEL (905) 826-5000 FAX (905) 826-7144
The software described in this document is furnished under license, and may only be used or copied in accordance with the terms of such license.
The content of this manual has been carefully checked for accuracy. However, if you find any errors, please notify Survalent Technology Corporation.
Revisions
Date October 1, 2001
Description Library selector, pmacro properties, and views and layers dialogs now resizable. Improved dialog for setting declutter levels. Added point browser, pop-up and background photos, and report and external data pushbuttons. Added menus for task activation pushbuttons and for analog points. Symbols and pmacros now accessible from library selector for editing. Added new map, new alarm view and new oprsum view functions to File menu. Sort folder function added to layers dialog. Save DXF defaults added to DXF import dialog. Clarification of null entries in symbol table editor. Added button to delete segment. Added display of grid. Changed color of selection handles for groups to magenta. Double-clicking an object in the map editor performs Modify. Enhanced pmacro rotation options. Added dialog code 1 for view-only points. New Analog History pmacro. Added Change Station feature. Added View Name to all status pmacros. Improved handling of DXF import option files and import errors. Added text-to-symbol replacement for DXF import from Microstation. Updated to add description of how to add Publish and Update functions. Added Undo/Redo. Added library Delete. Added alignment editing tool. Added nudge functions. Added control panels in the Library Selector window. Added analog gauge pmacro. Added pushbutton, station and status bitmap pmacros. Added time value pmacro. Added analog history. Added dialog code -2. Added Disallow Manual Set pmacro resource. Added Erase Before Draw pmacro resource. Added Tooltip Text pmacro resource. Added View and Report menus. Added missing resource check. Added Reservations. Added DWG import. Screen shots updated. Added templates and template pmacro. Added the following pmacro resources: Arrow Head Size, Data Item, some new dialog codes (10, 11, 12 and 13) for status points, Draw from base (for analog bars), Thousands Separator (for analog values), Warn on Execute (for control points). Added Resource Sharing (Export / Import objects).
December 9, 2002
April 5, 2003 September 18, 2007
October 23, 2009
Worldview for Windows Editors Guide
Revision
Contents
1
1.1
Introduction
1-1
Other Documentation .................................................................................................................. 1-2
2
2.1 2.2 2.2.1 2.2.2 2.2.3 2.2.4 2.2.5 2.2.6 2.2.7 2.3
Overview
2-1
Libraries....................................................................................................................................... 2-1 Edit Tools .................................................................................................................................... 2-2 File Menu ............................................................................................................................. 2-3 Edit Menu ............................................................................................................................. 2-4 View Menu ........................................................................................................................... 2-4 Map Menu ............................................................................................................................ 2-5 Tool Bar ............................................................................................................................... 2-5 Navigation Bar ..................................................................................................................... 2-5 Edit Bar ................................................................................................................................ 2-6 Library Selector ........................................................................................................................... 2-7
3
3.1 3.2 3.3 3.4 3.4.1 3.4.2 3.4.3 3.4.4 3.4.5 3.4.6
Getting Started
3-1
Library Selector ........................................................................................................................... 3-2 Creating Drawing Styles.............................................................................................................. 3-4 Creating Text Styles .................................................................................................................... 3-6 Creating Symbols ........................................................................................................................ 3-7 Breaker Symbol .................................................................................................................... 3-8 Pushbutton Symbol ............................................................................................................ 3-10 Substation Symbol ............................................................................................................. 3-11 Load Symbol ...................................................................................................................... 3-12 Switch Symbol ................................................................................................................... 3-13 Transformer Symbol .......................................................................................................... 3-14
Contents i
3.4.7 3.5 3.6 3.6.1 3.6.2 3.6.3 3.6.4 3.6.5 3.6.6 3.7 3.7.1 3.7.2 3.7.3
Fuse Symbol .......................................................................................................................3-16 Drawing Style Tables ................................................................................................................3-20 Creating Pmacros .......................................................................................................................3-22 Pushbutton Pmacro .............................................................................................................3-23 Analog Point Pmacro ..........................................................................................................3-26 Substation Pmacro ..............................................................................................................3-28 Breaker Pmacro ..................................................................................................................3-29 Switch Pmacro ....................................................................................................................3-31 Fuse Pmacro .......................................................................................................................3-31 The Map .....................................................................................................................................3-32 Substation Layer .................................................................................................................3-32 Feeder Layer .......................................................................................................................3-44 Main Layer .........................................................................................................................3-51
4
4.1 4.1.1 4.1.2 4.1.3 4.1.4 4.1.5 4.1.6 4.1.7 4.1.8 4.1.9 4.1.10 4.1.11 4.1.12 4.1.13 4.2 4.2.1 4.2.2 4.2.3 4.2.4 4.2.5 4.2.6 4.2.7 4.3 4.3.1 4.3.2 4.3.3 4.3.4 4.3.5 4.3.6 4.3.7 4.3.8 4.3.9
Drawing Styles
4-1
Drawing Style Editor ...................................................................................................................4-1 Name ....................................................................................................................................4-3 Color Add .............................................................................................................................4-3 Color Modify ........................................................................................................................4-5 Color Insert ...........................................................................................................................4-5 Color Delete .........................................................................................................................4-5 Line Width ............................................................................................................................4-5 Line Style .............................................................................................................................4-6 Cyclic Colors ........................................................................................................................4-6 Pixmap ..................................................................................................................................4-6 Apply ....................................................................................................................................4-6 Undo .....................................................................................................................................4-6 Save ......................................................................................................................................4-7 Cancel ...................................................................................................................................4-7 Drawing Style Table Editor .........................................................................................................4-7 Name ....................................................................................................................................4-8 Drawing Style Selection List ................................................................................................4-9 Drawing Style Table Element List .......................................................................................4-9 Apply ....................................................................................................................................4-9 Undo .....................................................................................................................................4-9 Save ......................................................................................................................................4-9 Cancel ...................................................................................................................................4-9 Using Drawing Style Tables ......................................................................................................4-10 Analog Point .......................................................................................................................4-10 Status Point .........................................................................................................................4-11 Station .................................................................................................................................4-11 Unacknowledged Alarms ...................................................................................................4-12 Flags ...................................................................................................................................4-13 Owner Tags ........................................................................................................................4-14 Pushbutton ..........................................................................................................................4-15 Segment ..............................................................................................................................4-15 Line Section ........................................................................................................................4-16
Contents ii
4.3.10
Customizing Drawing Style Tables.................................................................................... 4-16
5
5.1 5.2 5.3 5.4 5.5 5.6 5.7 5.8 5.9
Text Styles
5-1
Name ........................................................................................................................................... 5-3 Select Font ................................................................................................................................... 5-3 Orientation ................................................................................................................................... 5-3 Horizontal Justification ............................................................................................................... 5-4 Vertical Justification.................................................................................................................... 5-4 Apply ........................................................................................................................................... 5-4 Undo ............................................................................................................................................ 5-4 Save ............................................................................................................................................. 5-5 Cancel .......................................................................................................................................... 5-5
6
6.1 6.2 6.3 6.3.1 6.4 6.4.1 6.4.2 6.4.3 6.4.4 6.4.5 6.4.6 6.4.7 6.5 6.5.1 6.5.2 6.5.3
Symbols
6-1
Creating a New Symbol............................................................................................................... 6-2 Opening an Existing Symbol ....................................................................................................... 6-3 Editing a Symbol ......................................................................................................................... 6-4 Symbol Origin ...................................................................................................................... 6-5 Symbol Table .............................................................................................................................. 6-6 Name .................................................................................................................................... 6-7 Symbol Selection List .......................................................................................................... 6-7 Symbol Table Element List .................................................................................................. 6-8 Apply .................................................................................................................................... 6-8 Undo ..................................................................................................................................... 6-8 Save ...................................................................................................................................... 6-8 Cancel................................................................................................................................... 6-8 Using Symbol Tables .................................................................................................................. 6-8 Flags ..................................................................................................................................... 6-9 Owner Tags ........................................................................................................................ 6-11 Customizing Symbol Tables .............................................................................................. 6-12
7
7.1 7.1.1 7.1.2 7.2 7.2.1 7.2.2 7.2.3 7.2.4 7.2.5 7.2.6 7.2.7
Pmacros
7-1
Editing a Pmacro ......................................................................................................................... 7-3 Editing Resources................................................................................................................. 7-7 Deleting a Pmacro .............................................................................................................. 7-10 Pmacro Classes .......................................................................................................................... 7-10 Analog Value Pmacro ........................................................................................................ 7-11 Analog Bar Pmacro ............................................................................................................ 7-12 Analog Gauge Pmacro ....................................................................................................... 7-13 Analog History Pmacro ...................................................................................................... 7-14 Mobile Icon Pmacro ........................................................................................................... 7-15 Mobile Icon Bitmap Pmacro .............................................................................................. 7-16 Pseudo Color Pmacro (VMS SCADA Only) ..................................................................... 7-16
Contents iii
7.2.8 7.2.9 7.2.10 7.2.11 7.2.12 7.2.13 7.2.14 7.2.15 7.2.16 7.2.17 7.2.18 7.2.19 7.2.20 7.2.21 7.3 7.3.1 7.3.2 7.3.3 7.3.4 7.3.5 7.3.6 7.3.7 7.3.8 7.3.9 7.3.10 7.3.11 7.3.12 7.3.13 7.3.14 7.3.15 7.3.16 7.3.17 7.3.18 7.3.19 7.3.20 7.3.21 7.3.22 7.3.23 7.3.24 7.3.25 7.3.26 7.3.27 7.3.28 7.3.29 7.3.30 7.3.31 7.3.32 7.3.33 7.3.34
Pseudo Symbol Pmacro (VMS SCADA Only) ..................................................................7-17 Pseudo Text Pmacro (VMS SCADA Only) .......................................................................7-18 Pushbutton Symbol Pmacro ...............................................................................................7-19 Station Color Pmacro .........................................................................................................7-20 Station Symbol Pmacro ......................................................................................................7-21 Status Color Pmacro ...........................................................................................................7-22 Status Symbol Pmacro ........................................................................................................7-23 Status Text Pmacro .............................................................................................................7-24 Text Value Pmacro .............................................................................................................7-25 Pushbutton Bitmap Pmacro ................................................................................................7-26 Station Bitmap Pmacro .......................................................................................................7-27 Status Bitmap Pmacro ........................................................................................................7-28 Time Value Pmacro ............................................................................................................7-29 Templates ...........................................................................................................................7-30 Pmacro Resources ......................................................................................................................7-32 Alarm Blocked Flag Drawing Style Table .........................................................................7-32 Alarm Blocked Flag Enable ...............................................................................................7-32 Alarm Blocked Flag Offset X.............................................................................................7-33 Alarm Blocked Flag Offset Y.............................................................................................7-33 Analog Scale Factor ...........................................................................................................7-33 Angle Length ......................................................................................................................7-33 Angle Start ..........................................................................................................................7-33 Arrow Head Size ................................................................................................................7-33 Bar Length ..........................................................................................................................7-34 Bar Width ...........................................................................................................................7-34 Bitmap 0, 1, 2, 3, 4 .............................................................................................................7-34 Bitmap Height ....................................................................................................................7-34 Bitmap Width .....................................................................................................................7-34 Button Argument 1 Data ....................................................................................................7-35 Button Argument 1 Type ....................................................................................................7-35 Button Argument 2 Data ....................................................................................................7-35 Button Argument 2 Type ....................................................................................................7-35 Button Data.........................................................................................................................7-36 Button Label .......................................................................................................................7-36 Button Label Drawing Style Table .....................................................................................7-37 Button Label Text Style......................................................................................................7-37 Button Label X Offset ........................................................................................................7-37 Button Label Y Offset ........................................................................................................7-37 Button Type ........................................................................................................................7-37 Color Status Point Name ....................................................................................................7-38 Condition Flag Drawing Style Table ..................................................................................7-38 Condition Flag Enable ........................................................................................................7-39 Condition Flag Offset X .....................................................................................................7-39 Condition Flag Offset Y .....................................................................................................7-39 Control Fail Timeout ..........................................................................................................7-39 Control Panel Filename ......................................................................................................7-40 Control Panel Point Prefix ..................................................................................................7-40 Control Panel String 1, 2, 3 ................................................................................................7-40 Control Panel X Position ....................................................................................................7-40
Contents iv
7.3.35 7.3.36 7.3.37 7.3.38 7.3.39 7.3.40 7.3.41 7.3.42 7.3.43 7.3.44 7.3.45 7.3.46 7.3.47 7.3.48 7.3.49 7.3.50 7.3.51 7.3.52 7.3.53 7.3.54 7.3.55 7.3.56 7.3.57 7.3.58 7.3.59 7.3.60 7.3.61 7.3.62 7.3.63 7.3.64 7.3.65 7.3.66 7.3.67 7.3.68 7.3.69 7.3.70 7.3.71 7.3.72 7.3.73 7.3.74 7.3.75 7.3.76 7.3.77 7.3.78 7.3.79 7.3.80 7.3.81 7.3.82 7.3.83
Control Panel Y Position .................................................................................................... 7-40 Control Success Timeout ................................................................................................... 7-41 Data Item ............................................................................................................................ 7-41 Dial Colour ......................................................................................................................... 7-42 Dial Direction ..................................................................................................................... 7-42 Dialog Code ....................................................................................................................... 7-42 Disallow Manual Set .......................................................................................................... 7-49 Drawing Style..................................................................................................................... 7-49 Draw from base .................................................................................................................. 7-49 Erase Before Draw ............................................................................................................. 7-50 Filename ............................................................................................................................. 7-50 Flag Scale Factor X ............................................................................................................ 7-51 Flag Scale Factor Y ............................................................................................................ 7-51 Gauge Subtype ................................................................................................................... 7-51 Gauge Type ........................................................................................................................ 7-51 Horizontal Justification ...................................................................................................... 7-51 Image Scale Factor, X Axis................................................................................................ 7-52 Image Scale Factor, Y Axis................................................................................................ 7-52 Label Color......................................................................................................................... 7-52 Label Position X ................................................................................................................. 7-52 Label Position Y ................................................................................................................. 7-52 Label Text .......................................................................................................................... 7-53 Label Text Style ................................................................................................................. 7-53 Limit Color ......................................................................................................................... 7-53 Limit Max Value ................................................................................................................ 7-53 Limit Min Value ................................................................................................................. 7-53 Limit Center Color ............................................................................................................. 7-53 Limit Max Visible % .......................................................................................................... 7-54 Limit Min Visible % .......................................................................................................... 7-54 Limits Number ................................................................................................................... 7-54 Lower Limit ....................................................................................................................... 7-54 Magnification ..................................................................................................................... 7-54 Magnification Point Name ................................................................................................. 7-54 Major / Minor Divisions..................................................................................................... 7-55 Major / Minor Divisions Color........................................................................................... 7-55 Major Divisions Precision .................................................................................................. 7-55 Major Divisions Text Color ............................................................................................... 7-55 Major Divisions Text Style ................................................................................................ 7-55 Minimum Size (Pixels)....................................................................................................... 7-55 NAK Bitmap 0, 1, 2, 3, 4 ................................................................................................... 7-56 NAK Drawing Style Table ................................................................................................. 7-56 NAK Symbol 0, 1, 2, 3, 4 ................................................................................................... 7-56 Needle Color ...................................................................................................................... 7-56 Needle Type ....................................................................................................................... 7-57 Needle Visible Percentage ................................................................................................. 7-57 Normal Drawing Style Table ............................................................................................. 7-57 Orientation.......................................................................................................................... 7-57 Owner Tag Flag Drawing Style Table ............................................................................... 7-58 Owner Tag Flag Enable ..................................................................................................... 7-58
Contents v
7.3.84 Owner Tag Flag Offset X ...................................................................................................7-58 7.3.85 Owner Tag Flag Offset Y ...................................................................................................7-58 7.3.86 Owner Tag Flag Symbols ...................................................................................................7-58 7.3.87 Point Name .........................................................................................................................7-58 7.3.88 Point Title 1, 2, 3 ................................................................................................................7-59 7.3.89 Precision .............................................................................................................................7-59 7.3.90 Radius .................................................................................................................................7-59 7.3.91 Rotation (degrees) ..............................................................................................................7-59 7.3.92 Scale Factor On X Axis ......................................................................................................7-60 7.3.93 Scale Factor On Y Axis ......................................................................................................7-60 7.3.94 Select Box Drawing Style ..................................................................................................7-60 7.3.95 Sign Flag Enable.................................................................................................................7-60 7.3.96 Station Name ......................................................................................................................7-60 7.3.97 Station Name 2, 3, 4 ...........................................................................................................7-60 7.3.98 String 0, 1, 2, 3 ...................................................................................................................7-61 7.3.99 Symbol................................................................................................................................7-61 7.3.100 Symbol 0, 1, 2, 3, 4 .............................................................................................................7-61 7.3.101 Symbol Status Point Name .................................................................................................7-61 7.3.102 Tag Flag Drawing Style Table............................................................................................7-62 7.3.103 Tag Flag Enable..................................................................................................................7-62 7.3.104 Tag Flag Offset X ...............................................................................................................7-62 7.3.105 Tag Flag Offset Y ...............................................................................................................7-62 7.3.106 Thousands Separator ..........................................................................................................7-63 7.3.107 Text Style ...........................................................................................................................7-63 7.3.108 Time Format .......................................................................................................................7-63 7.3.109 Tool Tip Text......................................................................................................................7-63 7.3.110 Upper Limit ........................................................................................................................7-64 7.3.111 View Name .........................................................................................................................7-64 7.3.112 X Analog Point Name ........................................................................................................7-65 7.3.113 Y Analog Point Name ........................................................................................................7-65 7.3.114 Current Value Enable .........................................................................................................7-65 7.3.115 Enable Time .......................................................................................................................7-65 7.3.116 Enable Current 15M Max (or Min) ....................................................................................7-65 7.3.117 Enable Current Hour (Day or Week) Max (or Min) ...........................................................7-65 7.3.118 Enable Previous 15M (Hour, Day or Week) Max (or Min) ...............................................7-65 7.3.119 Format String ......................................................................................................................7-66 7.3.120 Warn on Execute ................................................................................................................7-66 7.4 Pushbuttons ................................................................................................................................7-67 7.4.1 View Pushbutton ................................................................................................................7-67 7.4.2 Graph Pushbutton ...............................................................................................................7-68 7.4.3 Task Pushbutton .................................................................................................................7-69 7.4.4 Note Pushbutton .................................................................................................................7-71 7.4.5 Image Pushbutton ...............................................................................................................7-72 7.4.6 External Data Pushbutton ...................................................................................................7-75 7.4.7 Report Pushbutton ..............................................................................................................7-77 7.5 Menu Files .................................................................................................................................7-79 7.5.1 Task Menu ..........................................................................................................................7-79 7.5.2 Analog Point Menu.............................................................................................................7-81 7.5.3 View Menu .........................................................................................................................7-82
Worldview for Windows Editors Guide Contents vi
7.5.4 7.6 7.6.1 7.6.2 7.7 7.8 7.8.1 7.8.2
Report Menu....................................................................................................................... 7-84 Creating DSNs and UDL Files .................................................................................................. 7-85 Creating a DSN (Data Source Name) ................................................................................ 7-85 Creating a UDL File ........................................................................................................... 7-87 Missing Resource Check ........................................................................................................... 7-90 Sharing Resources With Other Users ........................................................................................ 7-91 Export Object ..................................................................................................................... 7-91 Import objects..................................................................................................................... 7-92
Map Editing
8-1
8.1 File Menu .................................................................................................................................... 8-1 8.1.1 New Map .............................................................................................................................. 8-2 8.1.2 Open ..................................................................................................................................... 8-3 8.1.3 Import ................................................................................................................................... 8-4 8.1.4 Export ................................................................................................................................... 8-4 8.1.5 Portable Map Export ............................................................................................................ 8-4 8.1.6 Save ...................................................................................................................................... 8-4 8.1.7 Save As................................................................................................................................. 8-4 8.1.8 Reservations ......................................................................................................................... 8-5 8.1.9 Publish LSs ......................................................................................................................... 8-5 8.2 Edit Menu .................................................................................................................................... 8-5 8.2.1 Undo / Redo ......................................................................................................................... 8-6 8.2.2 Cut ........................................................................................................................................ 8-6 8.2.3 Copy ..................................................................................................................................... 8-6 8.2.4 Paste ..................................................................................................................................... 8-7 8.2.5 Clear ..................................................................................................................................... 8-7 8.2.6 Find ...................................................................................................................................... 8-8 8.2.7 Modify .................................................................................................................................. 8-8 8.2.8 Group.................................................................................................................................... 8-8 8.2.9 Ungroup................................................................................................................................ 8-9 8.2.10 Alignment ........................................................................................................................... 8-10 8.2.10.1 Left ......................................................................................................................................... 8-10 8.2.10.2 Right ...................................................................................................................................... 8-10 8.2.10.3 Top ......................................................................................................................................... 8-10 8.2.10.4 Bottom ................................................................................................................................... 8-10 8.2.10.5 Center Vertical ....................................................................................................................... 8-10 8.2.10.6 Center Horizontal ................................................................................................................... 8-10 8.2.10.7 Spaced Vertical ...................................................................................................................... 8-10 8.2.10.8 Spaced Horizontal .................................................................................................................. 8-11 8.2.10.9 Distribute as Matrix ............................................................................................................... 8-11 8.2.10.10 Same Height ....................................................................................................................... 8-12 8.2.10.11 Same Width ........................................................................................................................ 8-12 8.2.10.12 Same Size ........................................................................................................................... 8-12 8.2.11 Change Station ................................................................................................................... 8-12 8.2.12 Front ................................................................................................................................... 8-12 8.2.13 Back ................................................................................................................................... 8-13 8.2.14 Recolor ............................................................................................................................... 8-13
Worldview for Windows Editors Guide Contents vii
8.2.15 8.2.16 8.2.17 8.2.18 8.3 8.3.1 8.3.2 8.3.3 8.3.4 8.3.5 8.3.6 8.4 8.4.1 8.4.2 8.4.3 8.4.4 8.4.5 8.5 8.6 8.6.1 8.6.2 8.6.3 8.7 8.7.1 8.7.2 8.7.3 8.7.4 8.7.5 8.7.6 8.7.7 8.7.8 8.7.9 8.7.10 8.7.11 8.7.12 8.7.13 8.7.14 8.7.15 8.7.16 8.7.17 8.7.18 8.7.19 8.7.20 8.7.21 8.7.22 8.7.23 8.7.24 8.7.25 8.8
Restyle ................................................................................................................................8-13 Relayer................................................................................................................................8-13 Nudge Functions.................................................................................................................8-13 Select Member ....................................................................................................................8-13 View Menu ................................................................................................................................8-14 Edit Bar...............................................................................................................................8-14 Edit Tools ...........................................................................................................................8-14 Alignment Bar ....................................................................................................................8-14 Background Images ............................................................................................................8-15 Tree Lists ............................................................................................................................8-15 Library Selector ..................................................................................................................8-16 Map Menu..................................................................................................................................8-17 Set Extent ...........................................................................................................................8-17 Set Grid...............................................................................................................................8-17 Optimize Map .....................................................................................................................8-18 Layer Statistics ...................................................................................................................8-19 Grid Enabled.......................................................................................................................8-20 Tool Bar .....................................................................................................................................8-20 Navigation Bar ...........................................................................................................................8-21 Layers .................................................................................................................................8-21 Views and Layers Lists ......................................................................................................8-22 Edit Mode ...........................................................................................................................8-22 Edit Bar ......................................................................................................................................8-22 Select ..................................................................................................................................8-22 Library Selector ..................................................................................................................8-24 Toggle Grid ........................................................................................................................8-24 Toggle Alignment Toolbar .................................................................................................8-24 Line .....................................................................................................................................8-24 Modifying Line Properties .................................................................................................8-25 Rectangle ............................................................................................................................8-26 Filled Rectangle ..................................................................................................................8-26 Modifying Rectangle Properties .........................................................................................8-26 Ellipse .................................................................................................................................8-26 Filled Ellipse.......................................................................................................................8-27 Arc ......................................................................................................................................8-27 Filled Arc ............................................................................................................................8-27 Modifying Arc Properties ...................................................................................................8-27 Closed Polygon...................................................................................................................8-29 Filled Polygon ....................................................................................................................8-29 Open Polygon .....................................................................................................................8-29 Modifying Polygon Properties ...........................................................................................8-30 Text String ..........................................................................................................................8-30 Modifying String Properties ...............................................................................................8-31 Symbol................................................................................................................................8-31 Modifying Symbol Properties ............................................................................................8-31 Pmacro ................................................................................................................................8-32 Pmacro Properties Dialog ...................................................................................................8-32 Attaching a Point Name to a Pmacro..................................................................................8-33 Groups .......................................................................................................................................8-36
Contents viii
8.8.1 8.8.2 8.8.3 8.9 8.9.1 8.9.2 8.9.3 8.9.4 8.9.5 8.9.6 8.9.7 8.9.8 8.10 8.10.1 8.10.2 8.10.3 8.10.4 8.10.5
Creating a Group ................................................................................................................ 8-36 Segment .............................................................................................................................. 8-37 Select Member ................................................................................................................... 8-39 Views ......................................................................................................................................... 8-40 Creating a View.................................................................................................................. 8-40 Modifying a View .............................................................................................................. 8-42 Background Images ............................................................................................................ 8-43 Deleting a View.................................................................................................................. 8-45 Adding a Views Folder ...................................................................................................... 8-46 Deleting a Folder ................................................................................................................ 8-47 Organizing Views............................................................................................................... 8-47 Set As Default View........................................................................................................... 8-49 Layers ........................................................................................................................................ 8-49 Creating a Layer ................................................................................................................. 8-50 Setting Automatic Declutter Levels ................................................................................... 8-51 Deleting a Layer ................................................................................................................. 8-53 Layer Drawing Order ......................................................................................................... 8-53 Organizing Layers .............................................................................................................. 8-53
9
9.1 9.1.1 9.1.2 9.1.3 9.2 9.3
World Map Import
9-1
DXF File Import .......................................................................................................................... 9-2 Saved DXF Import Parameters ............................................................................................ 9-5 Text-to-Symbol Replacement in Microstation ..................................................................... 9-7 DWG / DXF File import ...................................................................................................... 9-8 Import From WorldView for VMS ............................................................................................. 9-9 Portable Map Export ................................................................................................................. 9-11
10
10.1 10.1.1 10.1.2 10.1.3 10.1.4 10.2 10.2.1 10.2.2
Change Control
10-1
Change Control With Reservations ........................................................................................... 10-1 Setup................................................................................................................................... 10-1 Reserving the WorldView Database .................................................................................. 10-2 Publishing Your Edits ........................................................................................................ 10-3 Update ................................................................................................................................ 10-4 Change Control Without Reservations ...................................................................................... 10-6 Control of Editing .............................................................................................................. 10-6 Publish and Update ............................................................................................................ 10-7
Contents
ix
Introduction
This document describes the editing facilities that are contained in Worldview for Windows. WorldView for Windows is a world map user interface for the SCADA system. WorldView runs on Windows 200x/XP/Vista, and operates as a client to the SCADA host computer. The WorldView program uses its own local copy of the map (stored on the PCs hard drive), on which it overlays dynamic analog and status data that is retrieved from currently active the host computer. Operator actions, such as control and alarm acknowledgement, are forwarded to the host computer for execution. Chapter 2, Overview, introduces you to the editing facilities. Chapter 3, Getting Started, gets you started right away and takes you through the steps of creating, from scratch, a simple station diagram. Chapter 4, Drawing Styles, describes how to create and modify drawing styles and drawing style tables. Chapter 5, Text Styles, describes how to create and modify text styles. Chapter 6, Symbols, describes how to create and modify symbols and symbol tables. Chapter 7, Pmacros, describes how to create and modify pmacros. Chapter 8, Map Editing, describes how to edit maps, add symbols, pmacros and text to the map, and how to create views and poke points to take you to those views. Chapter 9, World Map Import, describes how to import a map from either a DXF file or a VMS host. Chapter 10, Change Control, describes how to get your new maps and libraries to your colleagues PCs.
Introduction
1-1
1.1
Other Documentation
This document is designed for the people who maintain your WorldView database. It does not describe in detail how to manage map windows within WorldView nor how to navigate through a map (e.g. pan and zoom, and request views). These are described in the companion document: WorldView for Windows Operators Guide, document number WV-200 which should be regarded as pre-requisite reading for this editors guide. For further background reading, you will also find the following SCADA documents useful (particularly the ones related to the point database):
Table 1-1 Useful Documents VMS SCADA Windows SCADA Document Number Document Number DB-900 DB-901 DB-902 DB-903 DB-904 DB-401 DB-402 DB-403 DB-404 DB-405
Title Point Database Editing Guide Alarm Database Editing Guide Calculation Database Editing Guide Historical Database Editing Guide Report Database Editing Guide
Introduction
1-2
Overview
This document describes how to create a WorldView map and the libraries of components that go into the map. A world map file consists of graphic objects stored in layers. In WorldView, each layer can be assigned upper and lower magnification levels outside of which the entire layer declutters (i.e. disappears from view). This powerful feature allows you to create extremely complex maps that can be easily navigated.
2.1
Libraries
The graphics objects contained in a WorldView map consist of: drawing primitives text strings symbols pmacros
Examples of drawing primitives are Lines, Rectangles, Filled Rectangles, Ellipses, Filled Ellipses, Arcs, Filled Arcs, Closed Polygons, Filled Polygons and Open Polygons. The colors and lines style of the drawing primitives in a WorldView map are defined by drawing styles. The WorldView editor allows you to create a library of as many drawing styles as you want. The appearance of text strings in a map is governed by both drawing styles and text styles. A text style defines a font and font size, as well as orientation and alignment. You can create a library of as many text styles as you want. A symbol is a group of drawing primitives and text strings. Each symbol can be used any number of times in the map to represent static objects such as distribution transformers and poles, and you can create a library of as many symbols as you want.
Overview
2-1
A pmacro is a complex object that represents a SCADA database point and/or acts as a poke point. Pmacros associated with database points use symbols and text strings to display the current values of the points. When you click on a point-related pmacro, it displays a dialog box that allows you to interact with the associated point (e.g. to perform a control operation or acknowledge an alarm). Other types of pmacro serve as poke points that allow you to bring up trend graphs, images and reports, or to jump to other views in the map. The WorldView editor allows you to create a library of as many pmacros as you want. Note that you dont create a separate pmacro for each point. For each point that you want in the map, you place an instance of the desired pmacro onto the map and then attach it by name to the database point. So you can have a thousand points in your map represented by a thousand instances of just a handful of different pmacros. Each library element can be used as often as desired. The same drawing style can be used with graphics primitives, text strings, symbols and pmacros (pmacros use tables of drawing styles to color-code things). If you change that drawing style, you will change the appearance of all objects that use that drawing style. This gives you tremendous power to make a global change by means of one little edit. On the other hand, it can cause great pain if you decide you want to change the color of a few thousand lines but they use the same drawing style as a few other thousand lines that you dont wish to change. So what do you do? Plan ahead. Take feeders, for example. Even if you just want them all to be yellow today, consider using different drawing styles for overhead vs. underground and for different voltage levels. If you want them all yellow, thats fine. Make them all yellow. But the fact that they are separate drawing styles means that, in the future, you will be able to change the colors of all your 4 KV overheads without disturbing anything else, in seconds. The same thing goes for layers. Lots of layers are good. Having many layers gives you lots of control in the decluttering of the map, both automatic and manual. This is particularly important for very large maps, where good decluttering is essential to good performance.
2.2
Edit Tools
The WorldView editor is built into the WorldView program itself. To go into edit mode, click on the Edit button in the tool bar.
Access to edit mode is denied to you unless you are logged into a privileged SCADA account. If you are not logged into a privileged account, the Edit button is insensitive. The login procedure is described in the WorldView for Windows Operators Guide.
Insensitive Edit button
Overview
2-2
In edit mode, navigation through the map is the same as in view mode with one exception: poke points associated with views dont work. When you click on a view poke point, the editor doesnt take you to that view. The editor instead highlights the poke point and expects you to do something to it (i.e. edit it). Many of the edit tools are contained in the pull-down menus and tool bars that are described in WorldView for Windows Operators Guide. Well just very quickly review all of the relevant pull-down menus and tool bars here.
2.2.1
File Menu

New Map New Alarm View New Opresum New Workspace Open Import Export Close Save Save As Reservations Publish LSs Projector Remote Control Login Logout Set password Login Workstation Logout Workstation Print Print Preview Print Setup Page Setup Exit
Create new map Create new alarm view Create new operator Summary view Create a new workspace Open existing map, symbol, pmacro Open the Import popup window Open the Export popup window Close map, symbol or pmacro Save map, symbol or pmarco Open Save As dialog Open the Reservations popup window Publish line sections Opens Projector Control window Login Logout Set a password Login Workstation Logout Workstation Request print screen Print preview Print setup Page Setup Exit WorldView program
Overview
2-3
2.2.2
Edit Menu

Undo Redo Cut Copy Paste Clear Paste Link Find Modify Group Ungroup Alignment Change Station Front Back Recolor Restyle Relayer Background Color Nudge up Nudge Down Nudge Down Nudge left Nudge right Links
Undo Redo Cut object and copy to clipboard Copy object to clipboard Paste items from clipboard Delete selected object(s) Find point note, line section or text in map Open Properties dialog for selected object Group objects together Ungroup objects Open Alignment popup menu Change points to another station Bring object to front Move object to back Change color of selected object Change text of selected object Change layer of selected object Change background color
2.2.3

View Menu
Status Bar Tool Bar Edit Bar Navigate Bar Edit tools Alignment Bar Background Images Tree Lists Library Selections Options Save Configuration Trace events
Display/hide status bar Display/hide tool bar Toggle edit mode and edit bar Display/hide navigation bar Display/hide Edit toolbar Display/hide alignment bar Display/hide background images Open Tree Lists window Open Library Selectior window Open Options window Save current screen layout Open trace window
Overview
2-4
2.2.4
Map Menu

Set Extent Set Grid Optimize Map Layer Statistics Grid Enabled Ctrl+G
Open Set Extent window Open Set Grid window Open Optimize Threshold window Get layer statistics Toggle Grid
2.2.5
Tool Bar
New Window Open Save Cut Copy Paste Print
Open a window with same contents as active window Open a file Save symbol, pmacro or map Cut object(s) from the map and copy to the clipboard Copy object(s) to the clipboard Copy items from the clipboard onto the map or symbol Print
2.2.6
Navigation Bar
Layers Views and layers List Edit Mode
Open the Layers drop-down menu Open the Views and Layers pop-up window Toggle edit mode and edit bar
Overview
2-5
2.2.7
Edit Bar
The Edit bar appears whenever you are in Edit mode. The Edit bar is described in detail in section 8.7, Edit Bar. Select an object for modification/deletion Open the Library Selector pop-up window Toggle Grid Open Alignment Toolbar Draw a Line with the selected drawing style Draw a Rectangle with line/color of selected drawing style Draw a Filled Rectangle with color of selected drawing style Draw an Ellipse with line /color of selected drawing style Draw a Filled Ellipse with color of selected drawing style Draw a Arc with line/color of selected drawing style Draw a Filled Arc with color of selected drawing style Draw a Closed Polygon with line/color of selected drawing style Draw a Filled Polygon with color of selected drawing style Draw an Open Polygon with line/color of selected drawing style Write Text String with font of selected text style and color of selected drawing style Place on map a symbol selected from the symbol library Place on map a pmacro selected from the pmacro library
Overview
2-6
2.3
Library Selector
The libraries of drawing styles and symbols, etc are available through the Library Selector window. This is a multi-paned window that can be invoked by clicking on the Library Selector button in the edit bar. The Library Selector window, shown in Figure 2-1, has eight tabs corresponding to eight libraries. When you click on a tab, the pane containing the corresponding library is brought to the front.
Figure 2-1 Library Selector Use of the Library Selector to access the various libraries is described throughout this document.
Overview
2-7
Getting Started
This chapter gets you started right away by teaching you, step by step, how to create a simple world map from the bottom up. The world map that will be created consists of a basic substation with two feeders. A picture of the completed map is shown in (Figure 3-1).
Figure 3-1 Simple Substation Example
Getting Started
3-1
In this chapter, were going to use a white background because in printed versions of this document, the screen captures look much better with white backgrounds. If you prefer a black background, thats fine (in a WorldView print screen, the background is not printed, so you need not worry about having print screens full of ink). In order to edit, you will need to log into a privileged SCADA account. The login procedure is described in the WorldView for Windows Operators Guide.
3.1
Library Selector
In this chapter, were going to create not only a map but also some of the drawing styles, text styles and symbols that go into the map. The libraries of drawing objects are accessible via the Library Selector window. Survalent Technology supplies extensive libraries of such drawing objects, in fact all that you need to create a good map. At some point, though, you will want to customize these objects and create new ones of your own so that your map reflects your companys drawing standards. Before we actually do some map editing, therefore, were going to create some of the drawing objects needed to build the map of Figure 3-1 and add them to our libraries. This will be the subject of the next few sections. Another reason for creating brand new drawing objects is that if we modify existing ones, well change the appearance of any existing maps that use them. We dont want to do that on our first go around. To begin, lets create a new empty map window to work in.
Figure 3-2 Empty WorldView Window 1. Start WorldView by clicking on the WorldView shortcut. This will open an empty WorldView window, as shown in (Figure 3-2) 2. From the File pull-down menu, select New Map. 3. In the previously empty WorldView window, a new window for your new map will open, named Untitled1. See (Figure 3-3)
Getting Started
3-2
Notice that the Audible Alarm Silence is dimmed (not available). To make it available, you have to log into a privileged SCADA account.
Figure 3-3 New Map Window
4. To log in, click on the Login pushbutton. In the Login window that appears, enter your username and password and then click on OK.
5. After logging in, click on the Edit mode button button. 6. Now click on the Library Selector button.
to open the Edit toolbar that consist the Library Selector
This opens the Library Selector window shown in (Figure 3-4). This is the starting point. You will be creating many of the items you need for your sample WorldView map from here
Figure 3-4 Library Selector Window
Getting Started
3-3
3.2
Creating Drawing Styles
A drawing style consists of both colors and line styles. If you specify multiple colors in a drawing style, the system will cycle through those colors at the rate of one color per second. This is how blinking and other fancy effects can be produced. 1. Youre now going to create all of the drawing styles that youll need in order to build your sample map. The Library Selector window should already be open from the previous paragraph. If not, open it by clicking on the Library Selector button. In the Library Selector window, click on the Drawing Styles tab to bring it to the front and then, with the mouse pointer in the Drawing Styles window, right-click to open the pop-up menu, as shown in Figure (Figure 3-5)
Figure 3-5 Pop-up Menu in Drawing Styles Window
2. In the pop-up menu, click on Add. The Drawing Style Editor window will appear as shown in (Figure 3-6) 3. In the Drawing Style Editor, type _Yellow into the Name field. The underscore in the name will sort your colors to the top of the list for the purpose of this exercise. 4. In the Drawing Style Editor, type _Yellow into the Name field. The underscore in the name will sort your colors to the top of the list for the purpose of this exercise.
5. In the Drawing Style Editor, type _Yellow into the Name field. The underscore in the name will sort your colors to the top of the list for the purpose of this exercise. 6. Click on the Color Add button. This will bring up the Color window, shown in (Figure 3-7). From this window, select the first yellow color box on the left by clicking on it once and then click on the OK button to close the Color window. This will add a yellow colored box to the Cyclic Colors list in the Drawing Style Editor window, as shown in (Figure 3-6).
Getting Started
3-4
Figure 3-6 a)Drawing Style Editor, b)Yellow Drawing Style
Figure 3-7 Color Window 7. Click on the Save button to close the Drawing Style Editor window and to save the new drawing style. 8. We need to add a few more drawing styles to our list. Repeat steps 2 to 7 with the name _Green and using a dark green color. Repeat steps 2 to 7 with the name _Red and using a red color. Repeat steps 2 to 7 with the name _Orange and using an orange color. Repeat steps 2 to 7 with the name _Gray and using a gray color. Repeat steps 2 to 7 with the name _Black and using black. Getting Started 3-5
9. Now we need to add some drawing styles that will appear to flash on and off. Start by adding a new drawing style called _Alarm Yellow. 10. Click on the Color Add button and select the first yellow box on the left by clicking on it once and then click on the OK button to close the Color window. 11. Select Color Add again. This time add black (the last box in the first column on the left) and click on OK. If your screen background is black, anything drawn in this drawing style will appear to flash on and off, at the rate of one color per second, when youre not in edit mode. 12. Click on the Save button to close the Drawing Style Editor window and to save the new drawing style. 13. Repeat steps 8 to 12 for _Alarm Red using red and black. 14. Repeat steps 8 to 12 for _Alarm Orange using orange and black. 15. Now we need a couple of different line styles. Select the _Yellow drawing style we created earlier, right-click on it and then select Modify. 16. Change the name to _Yellow Bus Bar and change the Line Width to 3 pixels. Lines drawn with this drawing style will be 3 screen pixels wide at all zoom levels where the lines are visible (i.e. not de-cluttered). Save the changes you made, and click Yes when asked if you want to create a new drawing style. 17. Open the _Yellow drawing style again. Change the name to _Yellow Feeder and change the line width to 2 pixels and save it. You have now added to the drawing styles library the drawing styles that youll need for the sample map. Note that this has been just a quick introduction. For a more detailed description of the Drawing Style Editor, see Chapter 4, Drawing Styles.
3.3
Creating Text Styles
A text style consists of a font and font size, as well as other attributes such as orientation and alignment. A text style does not specify color. The color of a text string is defined by the strings associated drawing style (see Section 3.2, Creating Drawing Styles).
1. With the mouse in the Text Styles window, right-click to open a pop-up menu similar to the one we saw earlier with drawing styles. 2. In the pop-up menu, click on the Add button. The Text Style Editor will appear.
Figure 3-8 Text Styles of Library Selector
Getting Started
3-6
3. In the Library Selector window, click on the Text Styles tab to bring it to the front. 4. Type _Arial 200 into the Name field, as shown in (Figure 3-9). 5. Click on the Select Font button. This will bring up the Font window shown in (Figure 3-10).
Figure 3-9 Text Styles Editor
6. Click in the data entry box under the Size menu and type in a value of 28. 7. Click on the OK button to close the Font window
Figure 3-10 Font Window 8. Click on the Save button in the Text Style Editor to save the new text style. 9. Repeat steps 2 to 9 for Text Styles _Arial 300 and _Arial 100 using the corresponding sizes. Select a Font Style of Bold for the _Arial 300 text style. You have now added the text styles that youll need for sample map. For a more detailed description of the Text Style Editor, see Chapter 5, Text Styles.
3.4
Creating Symbols
A symbol is a set of one or more drawing objects grouped together to represent something, that something typically being a real world device such as a switch or a valve. Each symbol can be used many times in the map. If you decide to change the appearance of a symbol, all you need to do is edit the symbol in the library and all instances of the symbol in the map will be updated automatically.
Getting Started
3-7
Figure 3-11 Symbols Tab of Library Selector When you first get the system, the symbol library already contains a set of ready-to-use symbols that are provided by Survalent Technology, but you can create your own symbols. How to do this is the subject of this section.
3.4.1
Breaker Symbol
Well begin by drawing some breaker symbols. A breaker has two states: on and off. That doesnt mean we need two breaker symbols though. Although we can use two symbols for each breaker point, we can also make do with just one, and arrange to have it colored differently depending on the state of the point. In our sample map, were going to make use of both ways of representing status points.
1. To create a new symbol, access the Symbols tab of the Library Selector window and rightclick anywhere in the list of symbols. In the pop-up menu that appears, select Add.
Figure 3-12 Creating A New Symbol 2. A blank symbol drawing window, labeled Untitled, will appear with the Tool bar, Navigation bar and the Edit bar located in it. 3. In the Library Selector window, click on the Drawing Styles tab. Scroll down and select the _Red drawing style by clicking on it once with the left mouse button. Either drag the Library Selector out of the way, or close it. (The selected drawing style will remain selected.)
Getting Started
3-8
4. From the Map pull-down menu, select Set Grid. A Grid dialog will appear. The spacing should default to 10000 x 10000. If not, fill in these values. Leave the Offsets set to zero. 5. Check the Grid Enabled check box and click on Ok. (If you want to see the grid, you can check the Grid Visible check box too.)
Figure 3-13 Grid Dialog
6. Click on the Filled Box button in the Edit bar. 7. To draw a rectangle on the screen, move your mouse to a point on the screen where the coordinates at the bottom of the screen read X:0 Y:0. Press down on the left mouse button and drag up and to the right until the coordinates read X:10000 Y:10000. Let go of the mouse button and you should have a red square as shown below.
Figure 3-14 Red Square Symbol
8. Click on the Save button that is located on the Tool bar. Because this is a brand new symbol, bring up the Save As window.
this will
Getting Started
3-9
9. In the File name field of the Save As window, type the name _Breaker Closed and then click on the Save button. This will save your symbol and close the Save As window. But dont close the symbol yet.
Figure 3-15 Save As Window 10. We are now going to make a green-colored copy of the red symbol we just created. Retrieve the Library Selector and click on the Drawing Styles tab. Find the _Green drawing style and select it by clicking on it once. 11. Click on the Select (Arrow) tool and then select the symbol by clicking on it. It will be highlighted by a selection rectangle (an outline). Right-click, and from the pop-up menu that appears, choose Recolor. The symbol will turn green. 12. From the File pull-down menu, select Save As. In the File name field of the Save As window, enter _Breaker Open. 13. Close the symbol drawing window by selecting Close from the File pull-down menu. 14. Close the Library Selector window. This completes the breaker symbols.
3.4.2
Pushbutton Symbol
Now we are going to make a symbol to represent a pushbutton. The symbol for a pushbutton will consist of a gray rectangle, as shown in (Figure 3-16).
Figure 3-16 Pushbutton Symbol 1. Open the Library Selector, and in the Symbols list, right-click and select the Add function. A symbol drawing window will appear. Worldview for Windows Editors Guide Getting Started 3-10
2. Access the Drawing Styles pane of the Library Selector and select the _Gray drawing style. Close the Library Selector. 3. From the Map pull-down menu, select Set Grid. In the Grid window that appears, change the spacing to 1000 x 1000, check both the Grid Enabled and Grid Visible check boxes, and click on OK.
4. Select the Filled Box symbol from the Edit bar. 5. Position the cursor at X:0 Y:0, press and hold the mouse button down, and drag the cursor up and to the right until the coordinates read X:12000 Y:8000, and let go of the mouse button. A gray rectangle will appear in the drawing area. 6. Click on the Save button, and in the Save As window that appears, enter the name _Pushbutton and press Enter. Close the open windows.
3.4.3
Substation Symbol
In this paragraph, were going to make a symbol that we will use to represent a substation. This symbol will consist of a circle, as shown below.
Figure 3-17 Substation Symbol 1. In the Symbols list of the Library Selector, right-click and select the Add function. A symbol drawing window will appear. 2. Go into edit mode and access the Drawing Styles tab of the Library Selector. Select the {dynamic} drawing style. Close the Library Selector. 3. From the Map pull-down menu, select Set Grid. Ensure that the spacing is 10000 x 10000, check the Grid Enabled check box and click on OK. Worldview for Windows Editors Guide Getting Started 3-11
4. Select the Filled Ellipse
tool from the Edit bar.
5. Position the cursor at X:0 Y:10000, hold the left mouse button down, and drag the cursor down until the coordinates read X:10000 Y:0. Then release the mouse button. Your symbol should resemble (Figure 3-17). 6. Click on the Save button, and in the Save As window that appears, enter the name _Substation and press Enter. Close the open windows.
3.4.4
Load Symbol
Now well construct a symbol to represent a load. The symbol for a load will be represented by a yellow triangle, shown in (Figure 3-18).
Figure 3-18 Symbol of a Load 1. In the Symbols list of the Library Selector, right-click and select the Add function. A blank symbol drawing window will appear. 2. Go into edit mode and access the Drawing Styles pane of the Library Selector. Select the _Yellow drawing style that we created earlier and close the Library Selector. 3. From the Map pull-down menu, select Set Grid. In the Grid window that appears, change the spacing to 1000 x 1000, check the Grid Enabled check box, and click OK.
4. Select the Filled Polygon Worldview for Windows Editors Guide
tool from the Edit bar. Getting Started 3-12
5. Position the cursor at X:0 Y:5000 and click once. Drag the cursor down until the coordinates read X:8000 Y:0 and click once. Then drag the cursor up to the coordinates X:8000 Y:10000 and click twice. The drawing will fill in the last line for you and fill in the polygon in yellow. 6. Click on the Save button, and in the Save As window that appears, enter the name _Load and press Enter. Close the open windows.
3.4.5
Switch Symbol
We will now draw some symbols for switches. We will need two symbols, one to represent each switch state as shown in (Figure 3-19).
Figure 3-19 Open and Closed Switches 1. In the Symbols list of the Library Selector, right-click and select the Add function. A new blank symbol drawing window titled Untitled will appear. 2. Click on the Edit mode button, and access the Drawing Styles pane of the Library Selector window. 3. Select the {dynamic} drawing style and dismiss the Library Selector. 4. From the Map pull-down menu, select Set Grid. In the Grid window that appears, change the spacing to 1000 x 1000, check the Grid Enabled check box and click OK.
In the Edit toolbar, 5. The closed switch will consist simply of two small circles connected by a line. select the Filled Ellipse Tool. Place your mouse pointer at the co-ordinates X:0 Y:0 (approximately) and drag the mouse pointer until the co-ordinates read X:1000 Y:1000. 6. Draw another circle the same size, beginning at X:5000 Y:0. Worldview for Windows Editors Guide Getting Started 3-13
7. Turn off the grid by selecting Set Grid (from the Map pull-down menu) and clearing the Grid Enabled check box (by clicking on it), and click on OK.
from the Edit toolbar and draw a line between the center of the first circle and the 8. Select the Line Tool center of the second circle. You should now have a drawing that resembles the symbol at the bottom of (Figure 3-19). Note: Holding down the Shift key ensures that a line will be perfectly horizontal or vertical. Not using the shift key allows you to draw a line in any direction. 9. Click on the Save button, and in the Save As window that appears, enter the name _Switch Closed and press Enter. Dont close the window yet.
We will now create the symbol for the open switch (the symbol at the top of (Figure 3-19)).
1. In the Edit bar, click on the Select (arrow)
tool.
2. Select the horizontal line by clicking on it once with the left mouse button.
3. With the line selected, delete it by clicking on the Cut (scissors) tool
in the Tool bar.
4. Select the Line Draw tool in the Edit bar, and drag out a line from the center of the left circle to about oneinch above and just left of the right circle as shown in (Figure 3-19). 5. To save this new symbol under a different name, select Save As from the File pull-down menu. In the Save As window that appears, enter _Switch Open in the File Name field and press Enter to save your new symbol. 6. Close all open windows under the main WorldView Window.
3.4.6
Transformer Symbol
Next, well make a symbol to represent a transformer. The symbol for a transformer is shown in (Figure 3-20). 1. In the Symbols list of the Library Selector, right-click and select the Add function. 2. Click on the Edit mode button and access the Drawing Styles pane of the Library Selector. Find and select the _Yellow Bus Bar style that we created in section 3.2, Creating Drawing Styles. Close the Library Selector. 3. From the Map pull-down menu, select Set Grid. In the Grid window, change the spacing to 1000 x 1000, check Grid Enabled and click OK.
4. Select the Open Polygon tool from the Edit bar.
The mouse pointer turns into a cross-hair cursor.
Getting Started
3-14
5. Position the cursor at X:0 Y:2000 and click once. 6. Move the cursor up and to the right at a 45 degree angle until it snaps to the point X:1000 Y:3000, and click once. 7. Move the cursor down and to the right until it snaps to the point X:2000 Y:2000 and click once. 8. Repeat the previous two steps four more times, ending at X:6000 Y:2000, and clicking twice at the end. Your diagram should look as shown below.
9. Click once on the center point of your Symbol and drag a line straight down to the bottom of the window (to coordinates X:3000 Y:0), and double-click. 10. Move the mouse pointer to X:0 Y:5000, click once, and drag a line down to the left to X:1000 Y:4000 and click once. 11. Drag the cursor back up until your coordinates read X:2000 Y:5000 and click once.
Figure 3-20 Transformer Symbol 12. Continue doing this until you have drawn a mirror image of the original zig-zag line. Double-click at the end. 13. Draw the final line from coordinates X:3000 Y:4000 straight up to X:3000 Y:7000 and double-click. You should now have the diagram as shown in (Figure 3-20). 14. Click on the Save button, and in the Save As window that appears, enter the name _Transformer and press Enter. Close the open windows.
Getting Started
3-15
3.4.7
Fuse Symbol
Next, were going to create two different symbols for a fuse, one for each state of the fuse.
Figure 3-21 Open and Close Fuse Symbols 1. In the Symbols list of the Library Selector, right-click and select the Add function. 2. Click on the Edit mode button and access the Drawing Styles pane of the Library Selector. Select the {dynamic} drawing style and close the Library Selector. 3. From the Map pull-down menu, select Set Grid. In the Grid window, change the spacing to 1000 x 1000, check Grid Enabled, and click OK. 4. Using the Line Drawing tool, draw a line from the coordinates X:0 Y:2000 to X:2000 Y:2000.
From a starting point of X:2000 Y:4000, drag a circle down and to the 5. Select the Unfilled Ellipse tool. right to the point X:6000 Y:0. Your diagram should look like (Figure 3-22).
Getting Started
3-16
Figure 3-22 Partial Fuse 6. Draw another circle immediately to the right of the first one by dragging an ellipse from X:6000 Y:4000 to X:10000 Y:0. Select the line tool and draw a line from X:10000 Y:2000 to X:12000 Y:2000 as shown in (Figure 3-23).
Figure 3-23 Partial Fuse 2 7. With the Select tool, select modify. select the first circle, right-click on it, and from the pop-up menu that appears,
Getting Started
3-17
8. The Arc Properties dialog will open as shown in (Figure 3-24). Change the value of the Start field from 0 to 180, and change the Angle field from 360 to 180 and click on OK.
Figure 3-24 Arc Properties Dialog 9. For the second circle, just change the Angle from 360 to 180. 10. Turn off the grid by selecting Set Grid from the Map pull-down menu and unchecking the Grid Enabled check box. and draw a circle about inch in diameter. Select this circle and center it 11. Select the Filled Ellipse tool over the intersection of the first straight line and the semi circle. Your diagram should now look like the one in (Figure 3-25).
Figure 3-25 Partially completed _Fuse Closed Symbol
Getting Started
3-18
12. Select the circle you just drew and click on the copy and paste icons in the toolbar. Center the copy of the circle over the second intersection of the semi-circle and the straight line, and click once to paste it. The symbol is now complete and should look like the closed fuse in (Figure 3-21). 13. Click on the Save button, and in the Save As window that appears, enter the name _Fuse Closed. Dont close the symbol drawing window. Were now going to turn the _Fuse Closed symbol into a _Fuse Open symbol. 14. Lets first save the existing open fuse symbol under a new name (so we dont accidentally use Save instead of Save As later). From the File pull-down menu, select Save As, and in the Save As window that appears, enter the name _Fuse Open, and press Enter. 15. Select the first semi-circle, right-click, and from the pop-up menu that appears, choose Modify. The Arc Properties window that we saw earlier reappears. 16. In the Arc Properties window, change the Angle from 180 to 90. You can click on the Apply button to see the results before clicking on OK, if you wish. 17. Repeat the previous two steps for the second semi-circle. Your symbol should now look like the one in (Figure 3-26).
Figure 3-26 Open Fuse 18. If you had already changed the symbols name to _Fuse Open as suggested in step 13, you may now click on the Save button to save the updated image under the filename _Fuse Open. If you havent already changed the symbols name, make sure you click on Save As rather than Save. Then close any open windows other than the main WorldView window at this time. You have now created all of the symbols that you need to build the sample map. For more details on editing symbols, see Chapter 6, Symbols.
Getting Started
3-19
3.5
Drawing Style Tables
Drawing style tables are arrays of drawing styles used to dynamically color code things in the map. Drawing styles contained in a drawing style table are selected by indexing according to the value of some parameter associated with the object being color-coded. Examples of the use of drawing style tables are to color-code: the current value of an analog point according to what operating limit it may be violating, if any the {dynamic} portions of a status points symbol according to the current state of the status point a points tag indicator according to the highest level tag currently on the point
Although the database already contains perfectly good drawing style tables, were going to create brand new ones for our sample map.
_Unacknowledged Alarms Table 1. First, well create a table of colors to use for points that have one or more unacknowledged alarms. Access the Drawing Style Tables pane of the Library Selector.
Figure 3-27 Adding a Drawing Style Table 2. With the mouse in the Drawing Style Table window, right-click and select Add from the pop-up menu that appears. The Drawing Style Table Editor will appear as shown in (Figure 3-28). In the Drawing Style Table Editor, the left side is a list of all of the available drawing styles. The list on the right, which right now is empty, is the list of drawing styles that make up the drawing style table that is currently being edited.
Getting Started
3-20
3. In the Name field, enter _Unacknowledged Alarms.
Figure 3-28 Drawing Style Table Editor
4. In the scrollable list of drawing styles on the left, click once on _Alarm Red and then once on _Alarm Yellow (in that order). As you click on each drawing style, you should see its name appear in the list on the right. See (Figure 3-29). 5. Click on the Save button to save your drawing style table and close the Drawing Style Table Editor.
Figure 3-29 New Drawing Style Table _Acknowledged Alarms 1. Now well create a table to use with points that do not have any unacknowledged alarms. As we did above, access the Drawing Style Tables Editor to add a new table. 2. In the Name field, enter _Acknowledged Alarms. 3. In the list on the left, click once on _Red and then once on _Yellow. 4. Click on the Save button to save the new table and to close the Drawing Style Table Editor. _Unacknowledged Station Alarms 1. Now well create a table to use with stations in which at least one point has an unacknowledged alarm. Access the Drawing Style Table Editor as above, and enter the name _Unacknowledged Station Alarms. 2. Add the color _Alarm Orange to the table, and then click on the Save button to save the table and close the editor.
Getting Started
3-21
_Acknowledged Station Alarms 1. Now well create a table to use with stations that do not have any points with unacknowledged alarms. Access the Drawing Style Table Editor as above, and enter the name _Acknowledged Station Alarms. 2. Add the color _Orange to the table, and then click on the Save button to save the table and dismiss the editor. _Pushbutton 1. Now well create a table to be used by pushbuttons. Access the Drawing Style Table Editor as above, and enter the name _Pushbutton 2. Add the color _Black to the table, and then click on the Save button to save the table and close the editor. Thats it for drawing style tables for now. For a more detailed description of drawing style tables, See Chapter 4, Drawing Styles.
3.6
Creating Pmacros
Pmacros are dynamic objects that: display the values of database points, or act as poke points, or both of the above
Point-related pmacros display point values via either symbols or text strings. When you click on a pmacro thats linked to a database point, a dialog box is displayed with pushbuttons that you can use to perform operations such as: control manual set acknowledge or block alarms add or remove tags modify limits (analog points only)
These dialogs are described in detail in the WorldView for Windows Operators Guide. Pmacros can be associated with other things besides database points: clicking on a view pmacro brings up another view of the map clicking on a graph pmacro brings up an associated trend graph clicking on a task activation pmacro sends a run/stop message to an application clicking on an image pmacro brings up a pop-up photo clicking on a report pmacro brings up a Microsoft Excel or Query report clicking on an external data pushbutton retrieves a record from an external database
Survalent Technology provides a number of ready-to-use pmacros in the pmacro library, but you can create your own. Like symbols, pmacros are created and modified via the New and Open functions in the File pulldown menu. Each pmacro may be used many times in the map. Each instance can be associated with a different point, view, graph etc. But when you change the definition of a pmacro in the pmacro library, the change applies to every instance of that pmacro in the map.
Getting Started
3-22
In this section, we will create a number of pmacros that will reference the drawing styles, text styles symbols and drawing style tables that we have just created in the previous sections.
3.6.1
Pushbutton Pmacro
Well start with a pushbutton pmacro.
1. In the Pmacros list of the Library Selector, right-click and select the Add function. 2. This brings up a Create Pmacro window containing a list of pmacro classes that we can choose from.
Figure 3-30 Adding a New Pmacro
3. Select Pushbutton Symbol from the list and click OK. 4. This brings up a Pmacro Properties window, as shown in (Figure 3-32). The Pmacro Properties window contains three columns: Resource, Override, and Default.
Figure 3-31 Selecting Pushbutton Symbol
Getting Started
3-23
5. In the pushbutton Pmacro Properties window, double-click on the Button Label Text Style resource to open the Button Label Text Style dialog.
Figure 3-32 Properties of Pushbutton Pmacro The Resource column shows the names of the pmacros resources (attributes). The default column shows the default values of the resources. Note that not all of the resources have default values. The override column shows the actual values, if any, that you have specified for the resources. To enter a value for a resource, double-click on the name of the resource. A resource edit window will open to let you enter a value. When an instance of the pmacro is added to the map, any resource values in the Override column will be used instead of those in the Default column.
6. In the Button Label Text Style dialog, find and select _Arial 200. Then click on the OK button to close the dialog.
Figure 3-33 Button Label Text Style Resource Dialog 7. Next, double-click on the Button Label Drawing Style Table resource. Select _Pushbutton from the list of tables that appears (see (Figure 3-34)) and click OK. This will give our pushbutton label text the blackcolored drawing style we created in section 3.2, Creating Drawing Styles, and assigned to a drawing style table in section 3.5, Drawing Style Tables.
Figure 3-34 Button Label Drawing Style Table Resource Dialog
Getting Started
3-24
8. Scroll down and double-click on the Symbol 0 resource. This will bring up a Symbol 0 dialog containing a list of all of the available symbols. See (Figure 3-35). Locate the _Pushbutton symbol, click on it once and click OK. The gray pushbutton symbol that we drew in section 3.4.2, Pushbutton Symbol, will appear in the pmacro display window. Note: If you can't reposition the Pmacro Properties window so you can see whats happening in the background adequately, feel free to click the OK box at the bottom to close the window. Select the Edit mode button to reopen it at any time.
9. To test how well the text style fits and looks on the pushbutton, double-click on the Button Label resource, enter F1, and select OK. The label we just entered is shows up on the button at the bottom left hand corner. The text size is ok, but the text isnt centered.
Figure 3-35 Symbol 0 Resource Dialog 10. Double-click on the Button Label X Offset resource, enter a value of 3000 and click on OK. 11. Double-click on the Button Label Y Offset resource, enter a value of 1500 and click on OK.
Figure 3-36 Button Label X and Y Offset Resource Dialogs 12. The text is now nicely centered on the button. Since our button labels are going to be 2 digits wide, this setting should work well for all of them. If you place longer labels on some of these pushbuttons, you can stretch the pushbutton by changing the Scale Factor On X Axis resource without affecting the size of the text. An even better thing to do is to create some text styles with center alignment for use as pushbutton labels. With these, you wont need to touch the Button Label X Offset resource. 13. In the Pmacro Properties window, select the Button Label resource and then click on the Remove Override button at the bottom of the window. This removes the F1 label from the library Pmacro that you are creating. Real labels will be added as overrides on a per instance basis when we add the pmacros to the map. 14. Click on the OK button in the Pmacro Properties window. This dismisses the Pmacro Properties window. You could get it back, if you wanted, by clicking on the Edit button. But we dont want it back right now. 15. Click on the Save button located in the Tool Bar. Because this is a brand new pmacro, a Save As window will appear. In the File Name field, enter the name Pushbutton and then click on Save.
Getting Started
3-25
Figure 3-37 Save As Window 16. Click on the Close button under the File menu. This will close the Pushbutton pmacro
3.6.2
Analog Point Pmacro
Here, well create an Analog value pmacro that displays analog data in numeric form. 1. In the Pmacros list of the Library Selector, right-click and select the Add function.
2. From the Create Pmacro window that appears, select Analog Value. 3. This causes the Pmacro Properties window for the Analog Value pmacro to appear.
Figure 3-38 Selecting Analog Value Pmacro
Getting Started
3-26
Figure 3-39 Properties of Analog Value Pmacro
4. Double-click on the NAK Drawing Style Table resource to open the NAK Drawing Style Table dialog. Click on the _Unacknowledged Alarms table name once to select it and then click on OK.
Figure 3-40 NAK Drawing Style Table Resource Dialog
Figure 3-41 Normal Drawing Style Table Resource Dialog
5. Double-click on the Normal Drawing Style Table resource and in the resource dialog that appears, click on the _Acknowledged table once to select it. Then click on OK. 6. Double-click on the Text Style resource and select _Arial 100. Then click on OK.
Figure 3-42 Text Style Resource Dialog 7. Click on the OK button in the analog_value Pmacro Properties window to close the window. 8. Click on the Save button in the toolbar, and in the Save As dialog that appears, enter the name _Analog, and press Save.
Getting Started
3-27
3.6.3
Substation Pmacro
There are two types of station pmacro: Station Symbol and Station Color. Both use symbols and colors to display the overall status of a station in terms of: existence of unacknowledged alarms on any point on the station priority of highest priority outstanding or unacknowledged alarm on any point on the station
Station pmacros can also act as view poke points. Here were going to build a simple Substation pmacro for the sample map. The pmacro will appear as a large round pushbutton visible from the overview of the map. If there are unacknowledged alarms on any of the points on the station, the pushbutton will flash to alert the operator. Clicking on the pushbutton will open a view linked to the station pmacro.
1. As we did above, start a new pmacro edit by right-clicking in the Pmacros list of the Library selector, and selecting the Add function. 2. In the Create Pmacro window that appears, select station_color and then click on OK.
Figure 3-43 Creating A Station Color Pmacro
3. A Pmacro Properties window appears containing resources for the Station Color pmacro. 4. Note that there are five Button Label resources. Since a substation pmacro would normally be used several times (once for each substation), well leave the Button Label itself blank, to be filled in when each instance is placed on the map.
Figure 3-44 Properties of Station Color Pmacro
Getting Started
3-28
5. Double click on the Magnification resource. A Magnification dialog will appear, as shown in (Figure 3-45). Enter 80 into the data entry field and then click OK.
Figure 3-45 Magnification Resource Dialog 6. Double-click on the NAK Drawing Style Table resource and in the NAK Drawing Style Table dialog of (Figure 3-40) that appears, click on the _Unacknowledged Station Alarms drawing style table once to select it and then click on OK. 7. Double-click on the Normal Drawing Style Table resource and in the Normal Style Resource dialog of (Figure 3-41) that appears, select the _Acknowledged Station Alarms drawing style table and then click on OK.
8. Double-click on the Symbol resource, and in the Symbol resource dialog that appears, select _Substation and then click on OK. The _Substation symbol that we created in section 3.4.3, Substation Symbol, should appear in the pmacro drawing area in orange.
Figure 3-46 Symbol Resource Dialog 9. Notice the View Name resource in the Pmacro Properties window. Were not going to specify it now. The value of this resource will be filled in when we place instances of the substation pmacro on the map. 10. Click on the OK button at the bottom of the Pmacro Properties window and save the pmacro with the name _Substation. Then click on the Close button under the File menu.
3.6.4
Breaker Pmacro
Now well create a pmacro to represent a breaker. Well use the status_symbol pmacro class which, as the name implies, uses different symbols to show the various states of the breaker.
Getting Started
3-29
1. Start a new pmacro edit as we did above. From the Create Pmacro window, select status_symbol and click OK.
Figure 3-47 Creating A Status Symbol Pmacro 2. Scroll through the resources and turn off all the flags (Alarm Blocked Flag, Condition Flag, Owner Tag Flag and Tag Flag) by double-clicking each flags enable resource and unchecking the check box in the dialog that appears. 3. Scroll through the resources and turn off all the flags (Alarm Blocked Flag, Condition Flag, Owner Tag Flag and Tag Flag) by double-clicking each flags enable resource and unchecking the check box in the dialog that appears.
Figure 3-48 Alarm Blocked Flag Enable Resource Dialog 4. Double-click on the NAK Drawing Style Table resource. The dialog of (Figure 3-40) will appear showing you all of the available drawing style tables. Select _Unacknowledged Alarms and click on OK to close the dialog. You should now see _Unacknowledged Alarms in the column next to the NAK Drawing Style Table Resource.
5. Double click on the NAK Symbol 0 resource and select the _Breaker Open symbol by clicking on it once. Click on OK to close the dialog.
Figure 3-49 NAK Symbol 0 Resource Dialog 6. Double-click on the NAK Symbol 1 resource, and in the dialog that appears, select the _Breaker Closed symbol and click on OK. 7. Double-click on the Normal Drawing Style Table resource and in the resource dialog that appears (see (Figure 3-41)), select the _Acknowledged Alarms drawing style table and then click on the OK button.
Getting Started
3-30
8. Scroll down until you can see the resources Symbol 0 and Symbol 1. Enter the _Breaker Open and _Breaker Closed symbols into these resources. 9. Click the OK button at the bottom of the Pmacro Properties window. Save the pmacro under the name _Breaker. Then click on the Close button under the File menu.
3.6.5
Switch Pmacro
Now well create a pmacro to represent a switch. This will be a Status Symbol pmacro too. 1. Start a new pmacro edit as we did above. From the Create Pmacro window, select status_symbol and click OK. 2. As we did for the breaker, turn off all four flags resource (Alarm Blocked, Condition, Owner Tag and Tag) by unchecking each flags enable resource. 3. Double click on the Magnification resource. In the resource dialog of (Figure 3-45) that appears, enter the value 5 and then click on OK. 4. Double-click on the NAK Drawing Style Table resource and in the resource dialog of (Figure 3-40) that appears, select the _Unacknowledged Alarms table and click on OK. Similarly, for the Normal Drawing Style Table resource, specify the _Acknowledged Alarms drawing style table. 5. Double-click on the NAK Symbol 0 resource. In the resource dialog of (Figure 3-49) that appears, select the _Switch Open symbol and click on OK. Similarly, for the NAK Symbol 1 resource, specify the _Switch Closed symbol. 6. Double-click on the Symbol 0 resource. In the resource dialog of (Figure 3-35) that appears, select the _Switch Open symbol and click on OK. Similarly, for the Symbol 1 resource, specify the _Switch Closed symbol. 7. Click OK at the bottom of the Pmacro Properties window. Then save the pmacro with the name _Switch and close any open windows.
3.6.6
Fuse Pmacro
Now we will create a Pmacro to represent a fuse. 1. Start a new pmacro edit as we did above. From the Create Pmacro window, select status_symbol and click on OK. 2. Double-click on the Magnification resource. In the resource dialog of (Figure 3-45) that appears, enter the value 5 and then click on OK. 3. Double-click on the NAK Drawing Style Table resource and from the resource dialog that appears, select the _Unacknowledged Alarms table and click on OK. Similarly, assign the _Acknowledged Alarms drawing style table to the Normal Drawing Style Table resource. 4. Double-click on the NAK Symbol 0 resource and assign the _Fuse Open symbol to it. Assign the _Fuse Closed symbol to the NAK Symbol 1 resource.
Getting Started
3-31
5. Double-click on the Symbol 0 resource and assign the _Fuse Open symbol to it. Similarly, assign the _Fuse Closed symbol to the Symbol 1 resource. 6. Click OK at the bottom of the Pmacro Properties window. Then save the pmacro as _Fuse and close any open windows.
3.7
The Map
Now we are ready to create the map itself, using the symbols and Pmacros that have been created. Our first task is to create and populate a layer called Substation.
3.7.1
Substation Layer
1. Dismiss all of the windows inside your main WorldView window. From the File pull-down menu, select New Map. 2. This creates an empty map window. Maximize the window by clicking on the Maximize button. 3. Click on the Save button in the toolbar. In the Save As window that appears, enter the name Test Map and click on Save. From now, we can just click on the Save button to update the map. The map editor does prompt you to save the map if you close it after having made some changes.
Figure 3-50 Saving A New Map
Getting Started
3-32
4. Click on the Tree List button located on the Navigation bar. This brings up the Views and Layers window, shown in (Figure 3-51).
Figure 3-51 Views and Layers Window
5. Click on the Layers tab to bring the Layers pane to the front. You will see a folder icon with the title Layers, as shown in (Figure 3-52).
Figure 3-52 Layers Tab
6. With the mouse over the Layers folder, rightclick to obtain a pop-up menu as shown in (Figure 3-53). From this menu, select Create Layer. This will bring up an Edit Layers dialog, as shown in (Figure 3-54). Note that you are allowed to create layers only if the view is in Edit mode.
Figure 3-53 Layers Pop up Manu
Getting Started
3-33
7. In the Layer Name field, enter Substation and click OK. The Layers list now contains one entry in it, Substation.
Figure 3-54 Edit Layers Dialog
8. Select the Substation layer by clicking on it once. As shown in (Figure 3-55), this highlights the layer name to indicate that the layer is selected for insertion of graphics objects. The green dot beside the layer name means that the layer is currently visible (i.e. not decluttered), and the capital A means that the layer is set to Auto declutter.
Figure 3-55 Views and Layers Window with Substation Selected 9. Dismiss the Views and Layers window 10. Another way to select a layer for drawing into by using the Layers button in the Navigation toolbar as shown in (Figure 3-56). Highlight the Substation layer and click on Select, as shown, and the dialog boxes will close on their own. The Selected Layer may now be edited.
Figure 3-56 Layers Selection Button
Getting Started
3-34
11. From the Map pull-down menu, select Set Grid. If this function is dimmed, its because you are not logged into a privileged account. As soon as you log in, the Set Grid function will be available. In the Grid dialog, set the two Spacing fields to 1000, check the Grid Enabled check box and click OK.
12. If you are not already in edit mode, click on the Edit button to bring up the Edit bar. 13. Click on the Library Selector button to open the Library Selector window. Click on the Text Styles tab to bring the Text Styles pane to the front and then move the Library Selector window off to one side of the screen so that its not in the way. Note that once you have selected something from the Library Selector, you can actually dismiss it until you need to select something else. 14. Select the text style named _Arial 300 by clicking on it once. Tip: you can scroll down a long list of Text Styles by pressing a letter on the keyboard that corresponds to the first letter of the named font. E.g. press T for Times New Roman. The window will scroll down to the first text style that begins with T. 15. In the Library Selector, select the Drawing Styles tab and select the _Green drawing style.
16. Click on the Text button
in the Edit bar.
17. Click in the center of the view window. This will open the String Properties dialog shown in (Figure 3-57). In the String data entry field, type Substation. 18. Change the Horizontal Default to Center. Justification from
19. Click on the OK button to close the String Properties dialog.
Figure 3-57 String Properties Dialog
Getting Started
3-35
20. At first, the lettering may be very large and you may not be able to see all of the word. Using the Zoom buttons located on the Navigation bar, zoom in and out until the word Substation is about the same size as in the window in (Figure 3-58).
Figure 3-58 21. Using the scroll bar move the screen upwards so that Substation is located right at the top of the window, as shown ion (Figure 3-59).
Figure 3-59 22. Click on the Pmacros tab in the Library Selector window. From the list of pmacros, select the _Breaker pmacro. 23. Click on the Pmacro button in the Edit bar.
24. Click on the position at which you want the breaker to appear. Place five breakers on the map so that the breakers appear on your screen as they do in (Figure 3-60) by clicking once in each of the desired locations. The pmacros will snap to the nearest grid point.
Getting Started
3-36
In this sample map, were not going assign point names to any of the pmacros. This will be described in Chapter 8, Map Editing.
Figure 3-60 Substation with Five Breakers 25. In the Library Selector window, click on the Symbols tab, and from the list of symbols, select the Transformer symbol. 26. Click on the Symbol button in the Edit bar. 27. Now, wherever you click, a transformer symbol will appear. Place a transformer symbol between each set of breakers as shown in (Figure 3-61). You can disable the grid if you want to place transformers between grid points.
Figure 3-61
Getting Started
3-37
28. Click on the Drawing Styles tab in the Library Selector and from the list of drawing styles, select the Yellow Bus Bar drawing style.
29. Click on the Line
Draw button found in the Edit bar.
30. Draw two horizontal lines (the bus bar) originating from the middle breaker as shown in (Figure 3-62). To draw a horizontal line, start with the cursor at one of the desired end-points. Press and hold down the Shift key and the left mouse button. Now drag the mouse in the direction you want the line to be formed. Release both the Shift key and the mouse button to complete the line.
Figure 3-62 31. Click on the Pmacros tab in the Library Selector, and from the list of pmacros, select the Breaker pmacro. 32. Select the Pmacro button in the Edit toolbar and add four more breakers to the map so that your map resembles the map shown in (Figure 3-63).
Figure 3-63
Figure 3-64
33. Click on the Drawing Styles tab in the Library Selector, and from the list of drawing styles, select the _Yellow drawing style. 34. Click on the Line Draw button and draw four lines, one from each of the four lower breakers to the Bus Bar as pictured in (Figure 3-64).
Getting Started
3-38
35. Now draw two lines connecting the Bus Bar to the two breakers directly above the Bus Bar. 36. Draw four more lines to connect both transformers to the breakers directly above and below them. Your map should now look like (Figure 3-65).
Figure 3-65
37. Draw a line extending upward from each of the two uppermost breakers. The line should extend near the top of the window. 38. Click on the Drawing Styles tab of the Library Selector, and select the _Yellow Feeder drawing style. 39. Draw four lines, one from each of the four lowest breakers, downwards towards the bottom of the screen. The lines should extend about half of the distance between the breaker and the bottom of the window. Your map should now resemble the map in (Figure 3-66). Figure 3-66
40. Draw a line extending upward from each of the two uppermost breakers. The line should extend near the top of the window. 41. Click on the Drawing Styles tab of the Library Selector, and select the _Yellow Feeder drawing style. Draw four lines, one from each of the four lowest breakers, downwards towards the bottom of the screen. The lines should extend about half of the distance between the breaker and the bottom of the window. Your map should now resemble the map in (Figure 3-67).
Figure 3-67 42. Click on the Drawing Styles tab of the Library Selector and select the _Green drawing style. Worldview for Windows Editors Guide Getting Started 3-39
43. Click on the Text Styles tab and select the _Arial 100 text style. 44. Click on the Text button in the Edit toolbar, move the cursor just to the right and a bit above of the Bus Bar (the yellow horizontal bar) and click on the left mouse button. This will open the String Properties dialog box. 45. Type Volts A into the text box and click OK. Your screen should now resemble (Figure 3-68).
Figure 3-68 46. Left click the mouse just under the V in the string Volts A, enter Volts B in the String text box that appears and click on OK. 47. Repeat the above procedure for Volts C. 48. Click on the Pmacros tab of the Library Selector and select the _Analog pmacro. 49. Click on the Pmacro button in the Edit toolbar. 50. Move the mouse directly to the right of the Volts A label and click on the left mouse button. This will place an Analog pmacro there. 51. Repeat the previous step to place Analog pmacros beside both the Volts B and Volts C titles. Your map should now resemble (Figure 3-69).
Getting Started
3-40
Figure 3-69 52. Repeat steps 42 to 49 except this time use the title Amps instead of Volts and place the titles so that in the end, the substation resembles (Figure 3-70).
Figure 3-70 53. Click on the Pmacros tab in the Library Selector and select the Pushbutton pmacro. 54. Select the Pmacro button in the Edit toolbar. Place the cursor just under the left-most vertical yellow line and click on the left mouse button to put down a pushbutton. 55. Move the cursor under the next yellow line on the left and click. This will put down another pushbutton and your map should resemble (Figure 3-71).
Getting Started
3-41
Figure 3-71
56. Choose the Select tool from the Edit toolbar and right-click on the first pushbutton pmacro. In the pop-up menu that appears, select Modify.
Figure 3-72 Selecting Modify 57. In the Pmacro Properties window of (Figure 3-73) that appears, double-click on the Button Data resource. In the Button Data resource dialog, enter the view name Feeder, and click on OK. Note that the view name appears in the Override column of the Pmacro Properties window.
Figure 3-73 Button Data Resource Dialog
Getting Started
3-42
58. In the Pmacro Properties window, double-click on the Button Label resource. In the Button Label resource dialog that appears, enter the string F1 as the label, and click on OK. Note that the label you just entered appears in the Override column of the Pmacro Properties window.
Figure 3-74 Button Label Resource Dialog 59. In the Pmacro Properties window, click on OK to save your overrides. 60. Repeat steps 54 to 57 for the second pushbutton, specifying F2 in the Button Label resource.
61. Click on the Tree List button to open up the Views and Layers window and click on the Views tab to bring it to the front. With the cursor over the Views folder, right-click and from the pop-up menu that appears, select Add View.
Figure 3-75 Add View In the View Name field of the view dialog that appears type in the name Substation and click on OK. (Well discuss background images in a later chapter. Dont worry about this for now.)
Getting Started
3-43
Figure 3-76 Creating the Substation View The substation layer is now complete. We will now create the Feeder layer.
3.7.2
Feeder Layer
1. Leave the Views and Layers window open and select the Layers tab. 2. With the cursor over the Layers folder, right-click and select Create Layer from the pop-up menu that appears. See (Figure 3-53). 3. In the Layer Name field of the Edit Layers dialog, type in the name Feeder and click on OK. See (Figure 3-54) 4. Select the new Feeder layer for drawing by clicking on it once and closing the Layers and Views window. Alternatively, you can use the Layers button in the Navigation toolbar, in which case you highlight the Feeder layer and click on Select. 5. Use the zoom and scroll buttons until your diagram resembles (Figure 3-77).
Getting Started
3-44
Figure 3-77 6. Select the Pmacros tab of the Library Selector and select the Pushbutton pmacro. 7. Click on the Pmacro button in the Edit bar, move the cursor directly under the two existing pushbuttons and click to put down a third pushbutton as shown in (Figure 3-78).
Figure 3-78 8. Choose the Select tool in the Edit bar and right-click on the new pushbutton. From the pop-up menu, select Modify. 9. In the Pmacro Properties window that appears, set the value of the Button Data resource to the name Substation using steps followed below. 10. Set the Magnification resource to a value of 3. 11. Set the value of the Button Label resource to S/S (short for SubStation). 12. Set the Button Label Text Style resource to _Arial 300. Click on OK in the Pmacro Properties window to save your overrides.
Getting Started
3-45
move the 13. Using the Panning Tool, map so that the only thing visible is the S/S pushbutton as shown in (Figure 3-79) .
Figure 3-79 14. From the Drawing Styles pane of the Library Selector, select the _Yellow Feeder drawing style. 15. Click on the Line Draw button in the Edit bar, and draw four lines as shown in (Figure 3-80). The numbers in (Figure 3-80) are shown only to identify the four individual lines. Dont draw the numbers. Use the grid to keep your lines straight. Use the Open Polygon tool to draw lines 1, 2 and 3, if you wish.
Figure 3-80 16. Click on the Pmacros tab of the Library Selector and select the _Switch pmacro. 17. Click on the Pmacro button in the Edit bar. Position the cursor beneath the line labeled 3 in (Figure 3-80) and click to put down a switch pmacro. The exact location of the pmacro doesnt matter. You will be moving it in the upcoming steps.
18. Choose the Select tool from the pop-up menu.
in the Edit bar. Right-click on the switch you just placed, and choose Modify
19. From the switchs Pmacro Properties window, double-click on the Rotation (degrees) resource and set the value to 90. This will rotate the symbol 90 degrees to the right. Click on OK in the Pmacro Properties window. Your switch should now be positioned vertically. 20. Turn off the grid. Move the cursor directly over the switch and click and hold the left mouse button. Drag the switch over so that it lines up with the yellow line labeled 3 in (Figure 3-80). Worldview for Windows Editors Guide Getting Started 3-46
21. Select the switch again and click on the copy button on the tool bar. Click on paste and place the copy of the switch so it lines up under line 4 in (Figure 3-80). 22. Using the steps followed above for the first switch, access the second switchs Pmacro Properties window and set its Rotation resource value to 90. This will rotate the symbol 90 degrees to the left. Close the Pmacro Properties window. The second switch should now be positioned vertically. 23. Your map should now resemble (Figure 3-81).
Figure 3-81 24. Click on the Line Draw button in the Edit toolbar, and in the _Yellow Feeder drawing style, draw three lines as shown in (Error! Reference source not found.). (The numbers and white lines are shown only to identify the three individual lines. Dont draw the white lines and numbers.)
Figure 3-82
Getting Started
3-47
25. Copy the switch on the right and paste it at the bottom of line 3 in (Figure 3-83). 26. Select the Pmacro tool in the Edit bar. Select the Switch pmacro in the Library selector and place a switch next to line 2 in (Figure 3-83).
Figure 3-83
27. Select the Line Draw tool in the Edit bar and draw another horizontal line as shown in (Figure 3-84).
Figure 3-84 28. From the Pmacros pane of the Library Selector select the _Fuse pmacro. Click on the Pmacro tool in the Edit bar and place a fuse at the end of the line drawn in the previous step as shown in (Figure 3-85).
Figure 3-85 29. Draw a short horizontal line originating from the right side of fuse as shown in (Figure 3-86). Worldview for Windows Editors Guide Getting Started 3-48
Figure 3-86 30. Select the _Switch pmacro from the Library Selector, and place a switch directly beside the line you have just drawn. This will place a switch next to the line as shown in (Figure 3-87).
Figure 3-87 31. Draw a short horizontal line originating from the right side of switch as shown in (Figure 3-88).
Figure 3-88
Getting Started
3-49
32. Select the Load symbol from the Symbols pane of the Library Selector. Click on the Symbol tool in the Edit bar, and place a Load symbol at the end of the line you just drew so it resembles (Figure 3-89).
Figure 3-89 Feeders with Load
33. In the Library Selector select the _Alarm Red drawing style from the Drawing Styles pane, and select the Arial 100 text style from the Text Styles pane. 34. Click on the Text tool in the Edit bar. Place the cursor directly below the switch at the bottom of the screen and click the left mouse button. 35. In the Text Properties dialog that appears, enter Note: This switch should be kept in the Open state. in the String dialog box. Change the Horizontal Justification Center and click on OK. 36. Your map should now resemble (Figure 3-90).
Figure 3-90 37. Click on the Tree List button to open the Views and Layers dialog. 38. Select the Views tab to bring it to the front. Using steps followed previously to create the Substation view, create a view named Feeder. See steps 59 and 60 in paragraph 3.7.1, Substation Layer. The Feeder layer is now complete. We will now create the Main layer.
Getting Started
3-50
3.7.3
Main Layer
1. Create a layer named Main following the same procedures that you used to create the Substation and Feeder layers. Dismiss the Layers and Views window. highlighting the Main layer and clicking on 2. Select the new Main layer by clicking on the Layers tool, Select, as shown in (Figure 3-91). This is an alternative to selecting a layer via the Views and Layers window.
Figure 3-91 Selecting A Layer To Draw Into 3. Using the scroll bars, move the map so that it resembles (Figure 3-92).
Figure 3-92 4. From the Pmacros pane of the Library Selector, select the _Substation pmacro. 5. Select the Pmacro tool in the Edit bar, and place a _Substation pmacro so that it completely covers the substation but doesnt cover the feeder, as shown in (Figure 3-93). Its ok if the entire substation pmacro cant be seen on the screen
Figure 3-93
Getting Started
3-51
6. Access the Pmacro Properties window for the _Substation pmacro you just put down. Set the View Name resource to Substation (this is a view we created earlier in paragraph 3.7.1, Substation Layer), and close the Pmacro Properties window.
7. Click on the Tree List button to access the Views and Layers window. In the Layers pane of the Views and Layers window, right-click on the Substation layer. In the pop-up menu that appears, select Modify.
Figure 3-94 Modify Layer 8. In the Edit Layers dialog that appears, click on the upper Set Current button. The Zoom Out Declutter Point field will update to show you the scale (magnification), in world units per pixel, at which you are currently viewing the map. Click on OK. This will be the largest scale at which the Substation layer will be visible when its declutter mode is set to Auto. When you zoom out beyond this magnification level, all objects contained in this layer will disappear.
Figure 3-95 Setting Zoom Out Declutter Level 9. Repeat steps 7 and 8 for the Feeder layer. 10. Do the same for the Main layer but click on the lower Set Current button instead of the upper one. This will be smallest scale at which the Main layer will be visible when its declutter mode is set to Auto. When you zoom in beyond this magnification level, all objects contained in this layer will disappear. 11. Zoom out until your map resembles (Figure 3-96).
Getting Started
3-52
Figure 3-96 12. In the Views pane of the Views and Layers window, using steps followed in paragraphs 3.7.1, Substation Layer, and 3.7.2, Feeder Layer, create a new view and name it Main. 13. Right-click on the Main view that you just created. In the pop-up menu that appears, click on Set As Default View. This is the view that will appear whenever you click on the Home button. default view name is highlighted in red. In the Views list, the
Figure 3-97 Setting the Default View
Figure 3-98 Default View
14. Save the map by clicking on the Save button in the tool bar, and exit from edit mode by clicking on the Edit button in the navigation bar. The Edit tool bar will disappear. You have now completed your sample map. Your map consists of three layers and three views which contain a substation and a feeder. Your default view, the Main view, displays a small orange circle that is used to represent a substation. Clicking on the substation will take you to the Substation view so that you can see the internal structure of the substation. From this substation, clicking on the feeder button will take you to the Feeder view so that you can see the entire feeder in one window. From this view, you can also click on a button to take you back to the Substation view
Getting Started
3-53
The layers will turn off at certain magnification levels so as to keep the screen decluttered. For example, if you start at the Main view, and zoom in, you will see that at a certain magnification, the orange circle representing the substation disappears and the feeder and internal structure of the substation appear. What is happening is that the Main layer is automatically turning off and the Substation and Feeder layers are turning on. The point-related pmacros in the sample map will not operate because we did not attach them to SCADA database points. Attaching a pmacro to a database point is just a matter of modifying the pmacros Point Name resource to contain the desired point name. This is done via the Pmacro Properties window that we saw throughout this chapter. Details on entering point names are provided in chapter 8, Map Editing.
Getting Started
3-54
Drawing Styles
This chapter describes how to use the Drawing Style and Drawing Style Table editors. Both editors are accessible via the Library Selector window.
4.1
Drawing Style Editor
Clicking on the Drawing Styles tab of the Library Selector causes a list of the existing drawing styles to be displayed, as shown in (Figure 4-1).
Figure 4-1 List of Drawing Styles Each drawing style in the list defines a combination of the following graphics attributes: colors (up to 8 colors) line thickness line style
Drawing Styles
4-1
If you are editing a symbol (as opposed to a map), the list of drawing styles includes one extra drawing style named {dynamic}. See (Figure 4-2). In a symbol embedded in a pmacro, any symbol graphics that are drawn in {dynamic} are dynamically colored according to the state of the point associated with the pmacro.
Figure 4-2 Drawing Styles for Symbols For example, if the pmacros drawing style table contains the colors green and red, then while the point is in state 0, any {dynamic} stuff in the symbol for state 0 is drawn in green. Similarly, while the point is in state 1, any {dynamic} stuff in the symbol for state 1 is drawn in red. The symbols for states 0 and 1 can be identical. Right-clicking anywhere in the list of drawing styles opens an Add, Modify, Delete option list. You can use Add or Modify to create new drawing styles or to modify existing ones.
Figure 4-3 Add/Modify/Delate Drawing Style If you click on Add, the Drawing Style Editor window opens with a blank name and default graphics attributes, as shown in (Figure 4-4). If you click on Modify, the Drawing Style editor shows the data for the selected drawing style, as illustrated in (Figure 4-5). Note that if you modify an existing drawing style, you will change the appearance of all existing graphic elements that use that drawing style.
Drawing Styles
4-2
Figure 4-4 Add Drawing Style
Figure 4-5 Modify Existing Drawing Style
The Drawing Style Editor options are described below.
4.1.1
Name
This is the name of the drawing style. It must be a legal Windows file name (because the drawing style definition is stored as a .gcl file of this name). Make the names descriptive to make it easier for you and your colleagues to remember. Examples of useful names are names that describe what the drawing styles are used for (e.g. Streets and Underground Feeder) or names that describe the color and line size and/or type (e.g. Yellow Wide Dashed).
4.1.2
Color Add
This pushbutton opens the Color window of (Figure 4-6) to allow you to add a color to the Cyclic Colors box. In the Color window, you can create your own colors using the Add To Custom Colors function, or you can just stick to the Basic colors.
Figure 4-6 Color Window
Drawing Styles
4-3
Basic colors To use a basic color, click on the desired color in the Basic colors matrix. This causes the selected color to be highlighted, and also moves the cursor in the custom colors section to the correct color location, puts the color in the Color/Solid box and populates the Hue, Sat, Lum, Red, Green and Blue boxes with appropriate values. When you click on OK, the Color window is closed and the selected color is added to the Cyclic Colors box of the Drawing Style Editor window.
Add to Custom Colors You can create custom colors as follows: Select the entry in the Custom colors matrix that you wish to update. The selected entry will be highlighted. Select the desired luminance value by moving the slide box beside the rainbow up or down. This updates the color in the Color/Solid box and updates the Lum, Red, Green and Blue boxes with appropriate numeric values. The Hue and Sat boxes are not updated. Select the hue and saturation by clicking in the rainbow. This updates the color in the Color/Solid box and populates the Hue, Sat, Red, Green and Blue boxes with appropriate values. The Lum box is not updated. If you wish, you can type numeric values directly into the Hue, Sat, and Lum, or the Red, Green and Blue boxes. When the desired color appears in the Color/Solid box, click on the Add to Custom Colors pushbutton. The selected color will be added to the previously selected Custom Colors box.
Clicking on Cancel closes the Color window without applying any changes to the Cyclic Colors box of the Drawing Styles Editor window. To add multiple colors to a drawing style, just use the Color Add... function repeatedly. (Figure 4-7) shows an example of a drawing style containing two colors: red and black. It is a drawing style used to draw analog point values for points that have unacknowledged emergency limit violation alarms. The fact that the WorldView program cycles through the red and black colors at the rate of one color per second is what makes such points blink.
Figure 4-7 Multiple Colors in A Drawing Style
Drawing Styles
4-4
4.1.3
Color Modify
To modify any of the colors in a drawing style, click on the desired color in the Cyclic Colors box, and then click on the Color Modify... pushbutton. The Color window of (Figure 4-6) will open and allow you to select a color as described in paragraph 4.1.2, Color Add. When you click on OK in the Color window, the color that you had selected in the Cyclic Colors box is replaced by the color selected in the Color window.
4.1.4
Color Insert
To insert a color into the list of Cyclic Colors, click on the color in front of which you wish to make an insertion, and then click on the Color Insert... pushbutton. The Color window of (Figure 4-6) will open and allow you to select a color as described in paragraph 4.1.2, Color Add. When you click on OK in the Color window, the color that you selected in the Color window will be inserted into the list of Cyclic Colors at the point that you had specified.
4.1.5
Color Delete
To delete a color from the list of Cyclic Colors, click on the color you wish to delete and then click on the Color Delete... pushbutton. The selected color will be removed from the list.
4.1.6
Line Width
You can select a line width from 1 to 4 pixels using this tool. This affects all solid lines and some dashed lines, depending on the drawing object. For example, a dashed 4-pixel line will be used in a rectangle but only a dashed 1-pixel line will be used for a circle.
Figure 4-8 Line Width
Drawing Styles
4-5
4.1.7
Line Style
There are five choices for line style: Solid Dashed Dot DashedDot DashedDotDot
Figure 4-9 Line Style
4.1.8
Cyclic Colors
The Cyclic Colors box shows the colors that presently contained in the drawing style. As mentioned above, adding multiple colors to a drawing style causes any objects drawn in that style to cycle between the selected colors at the rate of one color per second. Up to eight colors are supported for each drawing style. There is no cycling of colors while you are in WorldView edit mode.
4.1.9
Pixmap
This function is not presently used.
4.1.10
Apply
Clicking on Apply causes the new or modified drawing style to be saved. If the drawing style already existed, any objects in the map that use that drawing style are updated. The Drawing Style Editor window is left open.
4.1.11
Undo
Clicking on Undo undoes any changes that you may have made using Apply while the Drawing Style Editor window was open. Once you dismiss the Drawing Style Editor window, you cannot undo what you did (except by using the Drawing Style Editor again).
Drawing Styles
4-6
4.1.12
Save
Clicking on Save causes the new or modified drawing style to be saved. If the drawing style already existed, any objects in the map that use that drawing style are updated. The Drawing Style Editor window is closed, and you cannot undo your changes (except by using the Drawing Style Editor again).
4.1.13
Cancel
Clicking on Cancel dismisses the Drawing Style Editor without saving any changes made since the last use of Save.
4.2
Drawing Style Table Editor
Clicking on the Drawing Style Tables tab of the Library Selector causes a list of the existing drawing style tables to be displayed, as shown in (Figure 4-10). Right clicking anywhere in the list of drawing style tables opens an Add, Modify, Delete option list. You can use Add or Modify to create new drawing style tables or to modify existing ones.
Figure 4-10 List of Drawing Styles Tables
Figure 4-11 Add/Modify/Delate Drawing Style Table If you click on Add, the Drawing Style Table Editor window opens with a blank name and default graphics attributes, as shown in (Figure 4-12). Worldview for Windows Editors Guide Drawing Styles 4-7
If you click on Modify, the Drawing Style Table Editor shows the data for the selected drawing style table, as illustrated in (Figure 4-13). Note that if you modify an existing drawing style table, you will change the appearance of all objects that use that drawing style table.
Figure 4-12 Add New Drawing Style Table
Figure 4-13 Modify Existing Drawing Style Table The options of the Drawing Style Table Editor are described below.
4.2.1
Name
This is the name of the drawing style table.
Drawing Styles
4-8
4.2.2
Drawing Style Selection List
The list on the left-hand side of the Drawing Style Table Editor is a list of all of the available drawing styles. When you click on one, the selected drawing style is added to the end of the list contained in the right-hand side of the Drawing Style Table Editor.
4.2.3
Drawing Style Table Element List
The list on the right-hand side of the Drawing Style Table Editor is the list of drawing styles contained in the drawing style table being edited. Since the drawing styles in a drawing style table are accessed by indexing, drawing style tables are very order-dependent. The meaning of the elements of a drawing style table depends on how the drawing style table is used. The various ways in which drawing style tables are used are described in section 4.3, Using Drawing Style Tables. To add an entry to the drawing style table, click on the desired entry in the drawing style selection list on the lefthand side of the Drawing Style Table Editor. The selected entry will be added to the end of the drawing style table element list on the right-hand side of the Drawing Style Editor. The order of the elements (drawing styles) in the drawing style table can be manipulated by using the up and down arrows. The up arrow causes the selected drawing style in the table to move up one position in the list. The down arrow causes the selected drawing style to move down one position in the list. Clicking on the left arrow causes the selected drawing style to be removed from the drawing style table.
4.2.4
Apply
Clicking on Apply causes the new or modified drawing style table to be saved. If the drawing style table already exists, any objects in the map that use that drawing style table are updated. The Drawing Style Table Editor window is left open.
4.2.5
Undo
Clicking on Undo undoes any changes that you may have made using Apply while the Drawing Style Table Editor window was open. Once you dismiss the Drawing Style Table Editor window, you cannot undo what you did (except by using the Drawing Style Table Editor again).
4.2.6
Save
Clicking on Save causes the new or modified drawing style table to be saved. If the drawing style table already existed, any objects in the map that use that drawing style table are updated. The Drawing Style Table Editor window is closed, and you cannot undo your changes (except by using the Drawing Style Table Editor again).
4.2.7
Cancel
Clicking on Cancel dismisses the Drawing Style Table Editor without saving any changes made since the last Save.
Drawing Styles
4-9
4.3
Using Drawing Style Tables
Drawing style tables are used by pmacros, line sections and segments to dynamically color their graphics elements according to values contained in the SCADA database. The various uses of drawing style tables are described below.
4.3.1
Analog Point
An analog pmacro (both value and bar) uses a drawing style table to color the analog point value to reflect the current limit state of the point (e.g. color the point green if its in its normal range, red if it violates its emergency alarm limit, etc.). (Figure 4-14) shows the contents of such a drawing style table that is provided in the standard WorldView database. The drawing style table is named ANALOG_DEFAULT. Table 4-1 explains the usage of each element of this drawing style table.
Figure 4-14 Analog Point Drawing Styles Table
Table 4-1Analog Drawing Style Table Elements Drawing Style Used When Point: Index ANALOG_NORMAL Not used (place-holder) 0 1 2 3 4 5 6 7 ANALOG_REASON ANALOG_EMGERG ANALOG_PREEMERG ANALOG_NORMAL ANALOG_PREEMERG ANALOG_EMGERG ANALOG_REASON Violates lower reasonability limit Violates lower emergency limit Violates lower pre-emergency limit Is in its normal range Violates upper pre-emergency limit Violates upper emergency limit Violates upper reasonability limit
Drawing Styles
4-10
4.3.2
Status Point
A status pmacro uses a drawing style table to re-color its symbols according to the current state of a status point (e.g. color the symbol green if the point is open, color the symbol red if the point is closed). Only the portions of the symbols that are drawn in the {dynamic} drawing style are re-colored in this manner. The portions of the symbols that are not drawn in {dynamic} retain the colors in which they were drawn. (Figure 4-15) shows the contents of such a drawing style table that is provided in the standard WorldView database. The drawing style table name is STATUS_DEFAULT. Table 4-2 explains the usage of each element of this drawing style table.
Figure 4-15 Status Point Drawing Style Table
Table 4-2 Elements in Status Point Drawing Style Table Drawing Style Used When Point: Index STATUS_0 Is in state 0 0 1 2 3 STATUS_1 STATUS_2 STATUS_3 Is in state 1 Is in state 2 Is in state 3
4.3.3
Station
A station pmacro uses a drawing style table to re-color its symbols according to the priority of the highest-priority unacknowledged or outstanding alarm on any point on the station. As in the case of the status points, only the portions of the symbols that are drawn in the {dynamic} drawing style are re-colored in this manner. (Figure 4-16) shows the contents of such a drawing style table that is provided in the standard WorldView database. The name of the drawing style table is STATION_DEFAULT. Table 4-3 explains the usage of each element of this drawing style table.
Drawing Styles
4-11
Figure 4-16 Station Drawing Style Table
Table 4-3 Elements of Station Drawing Style Table Drawing Style Used When Highest Priority Alarm Is: Index STATION_0 0 0 1 2 3 4 STATION_1 STATION_2 STATION_3 STATION_4 1 2 3 4
4.3.4
Unacknowledged Alarms
In all three cases above (analog, status and station), you can specify two different drawing style tables for each pmacro: one to be used when there are no unacknowledged alarms on the point or station, and another to be used when there are unacknowledged alarms on the point or station. Typically, the colors in the unacknowledged table would differ from those of the acknowledged table only by the addition of black in the cyclic colors list to cause the point to blink whenever it has unacknowledged alarms. The standard WorldView database contains three corresponding drawing style tables for use with unacknowledged alarms. These drawing style tables are named: NAK_ANALOG_DEFAULT NAK_STATUS_DEFAULT NAK_STATION_DEFAULT
and have the same usages as listed in Table 4-1, Table 4-2 and Table 4-3.
Drawing Styles
4-12
4.3.5
Flags
The condition, tag and alarm blocked indicators that are included in pmacros also have drawing style tables. This allows you to customize the coloring of these indicators. (Figure 4-17) shows the contents of a drawing style table for condition codes that is provided in the standard WorldView database. The name of the drawing style table is FLAG_STATUS. Table 4-4 explains the usage of each element of this drawing style table.
Figure 4-17 Condition Code Drawing Style Table
Table 4-4 Elements of Condition Code Drawing Style Table Used When Point Is: Index Drawing Style FLAGERROR not used 0 1 2 3 4 5 6 7 FLAGNORMAL FLAGTELEMETRYFAILED FLAGMANUALLYSET FLAGCALCULATED FLAGUNSET FLAGERROR FLAGERROR Normal Telemetry Failed Manually Set Calculated From Manually Set Data Unset (Setpoint) not used not used
Similar drawing style tables are provided in the standard WorldView database for the tag and alarm blocked indicators. The names of these drawing style tables are FLAG_TAG and FLAG_BLOCK respectively. Table 4-5 and Table 4-6 explain the usage of each element of these drawing style tables.
Drawing Styles
4-13
Table 4-5 Elements of Tag Drawing Style Table Used When: Index Drawing Style FLAGNORMAL Point is normal 0 1 2 3 4 5 6 7 FLAGFULLTAG FLAGHOLDCLOSETAG FLAGSELECTED FLAGOPENING FLAGCLOSING FLAGINTERLOCKING FLAGINFORMATIONALTAG Highest level tag is full tag Highest level tag is hold open or hold closed tag Point is selected for control Point is opening following control Point is closing following control Point has control-inhibiting interlock Highest level tag is information tag
Table 4-6 Elements of Alarm Blocked Drawing Style Table Used When: Index Drawing Style STANDARD_CYAN Not used (this is a required placeholder) 0 1 2 FLAGBLOCKED FLAGBLOCKED Point does not have blocked alarms Point has one or more blocked alarms
4.3.6
Owner Tags
Owner tags are tag types that you can customize. Each owner tag type maps to one of the following: Inhibit all control Inhibit open control Inhibit close control Do not inhibit control
You can have as many owner tag types as you wish. When you enable the owner tag indicator in a pmacro, you have to specify a drawing style table. Each element of the drawing style table is associated with an owner tag type. The WorldView program selects the drawing style for an owner tag indicator by indexing into the drawing style table using the points highest-level owner tag as the index. Suppose that you have defined the following set of owner tag types: Station Guarantee Work Permit Self Protection Hold Off Caution Work and Test Information
where Station Guarantee is the highest level and Information is the lowest level. Then a corresponding drawing style table for these owner tags could look like the one in Table 4-7.
Drawing Styles
4-14
Table 4-7 Drawing Style Table for Owner Tags Used When Highest Level Owner Tag Is: Index Drawing Style Normal None 0 1 2 3 4 5 6 StationGuarantee WorkPermit HoldOff Caution WorkAndTest Information Station Guarantee Work Permit Hold Off Caution Work and Test Information
4.3.7
Pushbutton
A pushbutton pmacro uses a drawing style table to color its label text. One color is used to color the text when the mouse is not clicked on it. Another color is used to color the text while youre holding the mouse button down with the mouse pointer on the pushbutton. The standard WorldView database contains a pushbutton drawing style table named PUSHBUTTON_LABEL. Its elements are listed in Table 4-8. Table 4-8 Elements of Pushbutton Drawing Style Table Used When: Index Drawing Style STANDARD_BLACK Pushbutton is not depressed 0 1 STANDARD_WHITE Pushbutton is depressed
4.3.8
Segment
Segments use drawing style tables to color groups of graphics elements according to the current values of status points. In this case, the graphics elements contained in the group are re-colored regardless of whether they are drawn in {dynamic} or not. The standard WorldView database contains two segments drawing style tables named SEGMENT_DEFAULT (used when the point has no unacknowledged alarms) and NAK_SEGMENT_DEFAULT (used when the point has one or more unacknowledged alarms). The elements of SEGMENT_DEFAULT are listed in Table 4-9. The usage of the elements of NAK_SEGMENT_DEFAULT is the same as that of the elements of SEGMENT_DEFAULT. Table 4-9 Elements of Segment Drawing Style Table Drawing Style Used to Color Segment When: Index SEGMENT_0 Point is in state 0 0 1 2 3 SEGMENT_1 SEGMENT_2 SEGMENT_3 Point is in state 1 Point is in state 2 Point is in state 3
Drawing Styles
4-15
4.3.9
Line Section
Line sections use drawing style tables to color groups of graphics elements according to the states of the line sections as calculated by the topology processor in the System Configuration Status (SCS) subsystem. As in the case of segments, the graphics elements contained in the line section are re-colored regardless of whether they are drawn in {dynamic} or not. The required elements of a drawing style table for display of topology data is shown in Table 4-10. This is described in more detail in the System Configuration Status Users Guide (document number SCS-300). Table 4-10 Elements of an SCS (Electric) Drawing Style Table Line Section Status Index de-energized 0 1 2 3 4 5 6 7 8 9 10 11 12 de-energized, looped energized energized, paralleled energized, looped energized, paralleled, looped calculated outage partially de-energized, looped partially energized partially energized, paralleled partially energized, looped partially energized, paralleled, looped partial calculated outage
4.3.10
Customizing Drawing Style Tables
As you can see, the drawing style tables define a very large part of the dynamic coloring scheme of your system. The examples of drawing style tables presented in paragraphs 4.3.1 to 4.3.9 are those that come with the SCADA system when you first get it. You are free to customize them as you wish. Just make sure that all drawing style tables have at least as many elements (drawing styles) as shown in Table 4-1 to Table 4-10. One way to customize a drawing style table is to leave the table itself alone and instead customize the drawing styles that they contain. For example, you can customize the coloring scheme of your analog points by customizing drawing styles ANALOG_NORMAL, ANALOG_REASON, etc. Another way to customize a drawing style table is to remove the drawing styles that are in them and replace them with other drawing styles. If you wanted, for example, to have different colors for upper and lower limit violations, you could modify the ANALOG_DEFAULT and NAK_ANALOG_DEFAULT tables as shown in Table 4-11.
Drawing Styles
4-16
Table 4-11 Modified ANALOG_DEFAULT and NAK_ANALOG_DEFAULT Tables Drawing Styles Drawing Styles in ANALOG_DEFAULT in NAK_ANALOG_DEFAULT Index ANALOG_NORMAL ANALOG_NORMAL 0 1 2 3 4 5 6 7 ANA_LO_REAS ANA_LO_EMERG ANA_LO_PREEM ANALOG_NORMAL ANA_UP_PREEM ANA_UP_EMERG ANA_UP_REAS NAK_ANA_LO_REAS NAK_ANA_LO_REAS NAK_ANA_LO_PREEM ANALOG_NORMAL NAK_ANA_UP_PREEM NAK_ANA_UP_EMERG NAK_ANA_UP_REAS
Another thing you can do is to create new drawing style tables of your own and reference these in your pmacros. This allows you to retain intact the original drawing style tables for reference purposes, but more importantly, allows you to have multiple coloring schemes. You can, for example, create two sets of analog drawing style tables and use one for electric (with green for normal) and the other one for water (with cyan for normal). You may also wish to use different colors for different types of status points. If you have the System Configuration Status program, you can use multiple drawing style tables to create multiple line section coloring schemes for high voltage vs. low voltage, for example, or for electric vs. water vs. gas.
Drawing Styles
4-17
5 Text Styles
This chapter describes how to use the Text Style editor. Clicking on the Text Styles tab of the Library Selector causes a list of the existing text styles to be displayed, as shown in (Figure 5-1).
Figure 5-1 List of Text Styles Each text style defines a combination of the following text attributes: font (including style and size) orientation justification
Text Styles
5-1
Right clicking anywhere in the list of text styles opens an Add, Modify, Delete option window. You can use Add or Modify to create new text styles or to modify existing ones. Note that if you modify an existing text style, you will change the appearance of all existing text that uses that text style.
Figure 5-2 Add/Modify/Delete Text Style
If you click on Add, the Text Style Editor window opens with a blank name and default text attributes, as shown in (Figure 5-3).
Figure 5-3 Add New Text Style If you click on Modify, the Text Style editor shows the data for the selected text style, as illustrated in (Figure 5-4).
Figure 5-4 Modify Existing Text Style
Text Styles
5-2
The Text Style Editor options are described below.
5.1
Name
This is the name of the text style. It must be a legal Windows file name (because the text style definition is stored as a .fnl file of this name). Make the names descriptive to make it easier for you and your colleagues to remember. Examples of useful names are names that describe what the text styles are used for (e.g. Street Names and Note Label) or names that describe the font and point size (e.g. Arial Center Bold 16).
5.2
Select Font
Clicking on the Select Font.. pushbutton causes a Font window to be displayed, as shown in (Figure 5-5).
Figure 5-5 Font Window If the text style is an existing text style, the font, font style and size of the text style are shown in the box at the top of the window. To edit, select a font from the scrollable font list, select a font style, and either select or enter font size (point size). You can manually enter font sizes that are larger or smaller than the sizes listed in the scrolling window. Note that different fonts at the same point size can be somewhat different in size. A sample of the current selection is shown in the Sample box. Clicking on OK saves the current font selection and closes the Font window. This does not save the text style. Thats done via the Save pushbutton in the main Text Style editor window. Clicking on Cancel dismisses the Font window without applying any font changes.
5.3
Orientation
There are two choices: Horizontal and Vertical. The Horizontal option produces text that is read from left to right. The Vertical option places each character of the text string letter directly below the previous character in a column. The default is Horizontal.
Text Styles
5-3
5.4
Horizontal Justification
This defines the horizontal alignment of the text with respect to the cursor. (The cursor is a crosshair that is used to position text.) You have four choices: Left Right Center Decimal The left edge of the text string is placed at the cursor. The right edge of the text string is placed at the cursor. The center of the text string is placed at the cursor. This is for alignment of numbers by the decimal point. The decimal point is placed at the cursor.
Left
Right
Center
4.00 (Decimal)
The default option is Left.
5.5
Vertical Justification
This defines the vertical alignment of the text relative to the cursor. There are four choices: Baseline Top Bottom Center The baseline of the text is placed directly above the cursor. The top of the text box is placed directly below the cursor. The bottom of the text box is placed directly above the cursor. The center of the text box is placed on the cursor.
Baseline
Top
Bottom
Center
The default option is Baseline.
5.6
Apply
Clicking on Apply saves the new or modified text style but keeps the text style editor window open. If the text style is an existing text style, any text strings that are currently in view and that use that text style are updated.
5.7
Undo
This function undoes any changes made using Apply while the window is open.
Text Styles
5-4
5.8
Save
This saves the new or modified text style and closes the Text Style Editor window. If the text style is an existing text style, any text strings that are currently in view and that use that text style are updated.
5.9
Cancel
This dismisses the Text Style Editor without saving any changes made since the last Save.
Text Styles
5-5
6 Symbols
This chapter describes how to use the Symbol and Symbol Table editors. Symbols may be used in several ways: Symbols can be used on a map to represent static objects for which there are no database items in the SCADA system. Symbols can be used in pmacros to represent dynamic points in the map. A status point pmacro, for example, can display a different symbol for a point depending on the current state of the point. Alternatively, you can define a pmacro to use just one symbol and color the symbol differently to represent the state of the point. Pmacros also use symbols to represent the quality codes and tags of their associated points. Symbols can be used to represent various types of poke points on the map. You can use poke points to jump to different views in the map, to bring up trend graphs, notes or images, or to initiate command sequences.
In WorldView, each symbol is essentially a mini-world map and is edited via a Symbol editor that operates very much like the map editor. There are differences, of course: symbols do not have layers, and you cannot place pmacros in symbols. You can place drawing elements such as lines and shapes into a symbol, as well as text and even other symbols, but not pmacros.
SymbolsWorldview for Windows Editors Guide
Symbols
6-1
A list of the symbols available in your database can be obtained by clicking on the Symbols tab of the Library Selector. See (Figure 6-1).
Figure 6-1 List of Simbols This symbol library includes a set of ready-to-use symbols provided by Survalent Technology, but you can add your own custom symbols using the Symbol editor, as described in the next section. If you have imported your base map from a DXF file, then your symbol library will also include all of the symbols that were contained in the DXF file.
6.1
Creating a New Symbol
To create a new Symbol, right-click anywhere in the symbol list, and from the options list that appears, select Add.
Figure 6-2 Creating A New Symbol A Symbol Editor window, labeled Untitled, will be displayed, as shown in (Figure 6-2), that is very similar to the Map Editor window.
Symbols
6-2
At the top of the Symbol Editor window are the same navigation tools and Library Selector pushbutton as in the Map Editor. At the right is the edit bar, again the same as that available in the Map Editor, but with the pmacros pushbutton desensitized.
Figure 6-3 Symbol Editor Window The edit bar allows you to add lines and shapes into the new symbol. The Library Selector allows you to choose drawing styles and text styles to draw with.
6.2
Opening an Existing Symbol
To edit an existing symbol, right-click on the desired symbol and select the Modify option.
Figure 6-4 Opening an Existing Symbol Alternatively, you can select Open from the File pull-down menu.
Symbols
6-3
In the Open window that appears: Select Symbol [*.syl] from the Files of type: pop-up menu. Navigate to the syl folder using the navigation tools at the top of the Open window: from the wmp folder, click on the Up One Level folder icon to go up one level to the standard folder, and then click on the syl folder. This will display a scrollable list of all of the symbols contained in the syl folder.
Figure 6-5 Open Window Use the scroll bar to find the desired symbol, and either double-click on it or click on it once and then click on Open. The Symbol Editor window will then appear with the selected symbol.
Figure 6-6 Selecting an Existing Symbol to Open
6.3
Editing a Symbol
As mentioned before, the drawing tools available for symbol editing are a subset of those available in the Map Editor for map editing. See Chapter 8, Map Editing, for a description of the editing tools. Note that the Set Grid feature in the Map Editor is also available in the Symbol Editor, and can be used to help you construct good-looking symbols with precisely defined coordinates. To save a symbol, you can use the Save pushbutton, or use the Save or Save As functions in the File pull-down menu.
Symbols
6-4
6.3.1
Symbol Origin
It is important to understand that when you place a symbol on a map, it is positioned so that the origin (X:0, Y:0) of the symbol appears at the point in the map at which you clicked. For a new symbol, the Symbol Editor initializes the scale of the view so that the height of the drawing area corresponds to 10,000 world units, and Y=0 is at the bottom of the drawing area. The width of the drawing area, in world units, will depend on the aspect ratio of the Symbol Editor window, and the X=0 will be on the left-hand side of the drawing area. (If the window was perfectly square, the origin would be at the lower left corner of the window.) The center of the drawing area is X=5000, Y=5000. If you create your symbol to fill this initial drawing area, the origin of your symbol will be at the lower left corner of the symbol. When you apply this symbol to the map, it will appear on the map with its lower left corner at the point in the map where you clicked. Sometimes, it will be more convenient to have the origin of your symbol at the center of the symbol. In such cases, you can bring up the symbol in the Symbol Editor, zoom out by a factor of two (approximately) and drag the entire symbol such that the coordinates of the center of the symbol are 0,0. This is a very easy task with grid mode enabled, especially if you had drawn the symbol with grid mode on in the first place. You can check the coordinates of any point in the symbol (or map, if you are in the map editor) simply by moving the mouse pointer to that point and reading the coordinates that are displayed in the status bar at the bottom of the edit window. The displayed coordinates are updated continuously as you move the mouse pointer. There is no need to click the mouse.
Symbols
6-5
6.4
Symbol Table
Clicking on the Symbol Tables tab of the Library Selector causes a list of the existing symbol tables to be displayed, as shown in (Figure 6-7).
Figure 6-7 List of Symbol Tables Right clicking anywhere in the list of symbol tables opens an Add, Modify, Delete option window. You can use Add or Modify to create new symbol tables or to modify existing ones.
Figure 6-8 Add/Modify/Delete Symbol Table If you click on Add, the Symbol Table Editor window opens with a blank name and an empty symbols list, as shown in (Figure 6-9).
Figure 6-9 New Symbol Table
Symbols
6-6
If you click on Modify, the Symbol Table Editor shows the data for the selected symbol table, as illustrated in (Figure 6-10).
Figure 6-10 Existing Symbol Table Note that if you modify an existing symbol table, you will change the appearance of all existing pmacros that use that symbol table. Clicking on Delete presently does not do anything. To delete a symbol table, you have to open the stl folder through Windows Explorer and delete the appropriate .stl file. The options of the Symbol Table Editor are described below.
6.4.1
Name
This is the name of the symbol table.
6.4.2
Symbol Selection List
The list on the left-hand side of the Symbol Table Editor is a list of all of the available symbols. When you click on one, the selected symbol is added to the end of the list contained in the right-hand side of the Symbol Table Editor. Some of the symbol tables that WorldView uses require null placeholder entries. You can create a null placeholder entry in a symbol table by using the {Null} entry in the symbol selection list. When you click on {Null} on the left, a {Null} entry is added to the list on the right. The editor shows you where the null entries are and allows you to manipulate them in the same way as non-null entries. section 6.5, Using Symbol Tables, describes where null entries are required.
Symbols
6-7
6.4.3
Symbol Table Element List
The list on the right-hand side of the Symbol Table Editor is the list of symbols contained in the symbol table being edited. Since the symbols in a symbol table are accessed by indexing, symbol tables are very orderdependent. The meaning of the elements of a symbol table depends on how the symbol table is used. The various ways in which symbol tables are used are described in section 6.5, Using Symbol Tables. To add an entry to the symbol table, click on the desired entry in the symbol selection list on the left-hand side of the Symbol Table Editor. The selected entry will be added to the end of the symbol table element list on the right-hand side of the Symbol Table Editor. The order of the elements (symbols) in the symbol table can be manipulated by using the up and down arrows. The up arrow causes the selected symbol in the table to move up one position in the list. The down arrow causes the selected symbol to move down one position in the list. Clicking on the left arrow causes the selected symbol to be removed from the symbol table.
6.4.4
Apply
Clicking on Apply causes the new or modified symbol table to be saved. If the symbol table already exists, any objects in the map that use that symbol table are updated. The Symbol Table Editor window is left open.
6.4.5
Undo
Clicking on Undo undoes any changes that you may have made using Apply while the Symbol Table Editor window was open. Once you dismiss the Symbol Table Editor window, you cannot undo what you did (except by using the Symbol Table Editor again).
6.4.6
Save
Clicking on Save causes the new or modified symbol table to be saved. If the symbol table already existed, any objects in the map that use that symbol table are updated. The Symbol Table Editor window is closed, and you cannot undo your changes (except by using the Symbol Table Editor again).
6.4.7
Cancel
Clicking on Cancel dismisses the Symbol Table Editor without saving any changes.
6.5
Using Symbol Tables
Symbol tables are used by pmacros to dynamically display the status of points in your map. The various uses of symbol tables are described below. (The use of symbol tables is analogous to that of drawing style tables. See section 4.3, Using Drawing Style Tables.)
Symbols
6-8
6.5.1
Flags
Section 4.3, Using Drawing Style Tables, describes the use of drawing style tables in the condition, tag and alarm blocked indicators of pmacros. Symbol tables are used in much the same way. (Figure 6-11) shows the contents of a symbol table for condition codes that is provided in the standard WorldView database. The name of the symbol table is condition_flags.
Figure 6-11 Condition Code Symbol Table In a condition flags table, a null entry is required in the second position. This corresponds to the Normal condition code, for which no symbol is displayed. Table 6-1 explains the usage of each element of this symbol table. Table 6-1 Elements of Condition Code Symbol Table Drawing Style Used When Point Is: Index flagerror not used 0 1 2 3 4 5 6 7 {Null} flagtelemetryfailed flagmanuallyset flagcalculated flagunset flagerror flagerror Normal Telemetry Failed Manually Set Calculated From Manually Set Data Unset (Setpoint) not used not used
Similar symbol tables are provided in the standard WorldView database for the tag and alarm blocked indicators. The names of these symbol tables are tag_flags and alarm_blocked respectively. (Figure 6-12) and (Figure 6-13) and Table 6-2 and Table 6-3 illustrate the usage of each element of these symbol tables.
Symbols
6-9
Figure 6-12Tag Symbol Table Note that in a regular tag flags table, a null entry is required in the first position. This corresponds to the "untagged" state, for which no symbol is displayed. In a blocked alarm flags table, a null entry is also required in the first position. This corresponds to the "no alarms blocked" status, for which no symbol is displayed. Table 6-2 Elements of Tag Symbol Table Drawing Style Used When: Index {Null} Point has no tag 0 1 2 3 4 5 6 7 flagfulltag flagholdopentag flagselected flagopening flagclosing flaginterlocking flaginformational Highest level tag is full tag Highest level tag is hold open or hold closed tag Point is selected for control Point is opening following control Point is closing following control Point has control-inhibiting interlock Highest level tag is information tag
Symbols
6-10
Figure 6-13 Alarm Blocked Flag Symbol Table
Table 6-3 Elements of Alarm Blocked Symbol Table Drawing Style Used When: Index {Null} Point does not have any blocked alarms 0 1 flagblocked Point has one or more blocked alarms
6.5.2
Owner Tags
Paragraph 4.3.6, Owner Tags, describes how drawing style tables are used to display owner tags. When you enable the owner tag indicator in a pmacro, you have to specify a symbol table in addition to a drawing style table. Each element of the symbol table is associated with an owner tag type. The WorldView program selects the symbol for an owner tag indicator by indexing into the symbol table using the points highest-level owner tag as the index. Suppose that you have defined the following set of owner tag types: Station Guarantee Work Permit Self Protection Hold Off Caution Work and Test Information
where Station Guarantee is the highest level and Information is the lowest level. Then a corresponding symbol table for these owner tags could look like the one in Table 6-4. In a symbol table used for owner tags, no null entries are required. Position zero corresponds to the highest-level owner tag, position one corresponds to the next lower level owner tag, etc.
Symbols
6-11
Table 6-4 Symbol Table for Owner Tags Used When Highest Level Owner Tag Is: Index Symbol StationGuarantee Station Guarantee 0 1 2 3 4 5 WorkPermit HoldOff Caution WorkAndTest Information Work Permit Hold Off Caution Work and Test Information
6.5.3
Customizing Symbol Tables
Symbol tables define a large part of the dynamic flags used to display the status of the points in your system. The examples of symbol tables presented in paragraphs 6.5.1 and 6.5.2 are those that come with the SCADA system when you first get it. You are free to customize them as you wish. Just make sure that all symbol tables have at least as many elements (symbols) as shown in Table 6-1to Table 6-4. One way to customize a symbol table is to leave the table itself alone and instead customize the symbols that they contain. Another way to customize a symbol table is to remove the symbols that are in them and replace them with other symbols.
Symbols
6-12
7 Pmacros
This chapter describes how to use the Pmacro editor. Pmacros are objects that serve as points of interaction with the user. The available classes of pmacro are listed in Table 7-1. Most of the pmacro classes are associated with database points. These pmacros display point values, and when you click on them, they display dialog boxes that allow you to perform operations on the points. Other classes of pmacro act as poke points only. When you click on them, they take you to a different view in the map, or bring up a trend graph, image or note, or allow you to operate a command sequence. Each class of pmacro has a set of attributes called resources. Some of these resources are items contained in libraries that we have talked about earlier, such as drawing styles, text styles and symbols. Other resources consist of just numeric values or text strings. Pmacros that are associated with database points have one or more resources that consist of SCADA point names. The resources used by each class of pmacro are identified in section 7.2, Pmacro Classes. The resources themselves are described in section 7.3, Pmacro Resources. You can create as many pmacros of each class as you wish. Its the values of the resources that make each pmacro different. For example, you can create a Status Symbol pmacro called 4KV Breaker with appropriate symbol resources for use with 4KV breaker points. And you can create another Status Symbol pmacro called Recloser with other symbols for use with recloser points. Each of these pmacros can be used as many times as you wish in your map by simply putting them down on the map and attaching them to database points. How to add a pmacro to a map and attach it to a database point is described in Chapter 8, Map Editing. The subject of the present chapter is how to create the pmacros.
Pmacros
7-1
Table 7-1Pmacro Classes Description Class of Pmacro Displays the value of an analog point in the form of a bar graph Analog Bar Analog Gauge Analog History Analog Value Mobile Icon Mobile Icon Bitmap Pushbutton Bitmap Pushbutton Symbol Station Bitmap Station Color Station Symbol Status Bitmap Status Color Status Symbol Status Text Template Text Value Time Value Display the value of an analog point using a gauge Displays historical max/min values of one or more analog points, with timestamps Displays the value of an analog point as a numeric text string Displays a symbol at a location determined by the values of two analog points Displays a bitmap at a location determined by the values of two analog points Acts as a poke point for views, graphs, images, notes and command sequences. Displayed using a bitmap. Acts as a poke point for views, graphs, images, notes and command sequences. Displayed using a symbol. Displays the alarm status of a station by displaying bitmaps Display the alarm status of a station by coloring a symbol Displays the alarm status of a station by displaying symbols Displays the value of a status point by displaying a different bitmap for each state Displays the value of a status point by coloring a symbol Displays the value of a status point by displaying a different symbol for each state Displays the status of a status point by displaying a text string Displays a complex object that contains pmacros, symbols, graphics and text strings Displays the value of a text point by displaying a text string Displays the current time
When you add a pmacro to the map, you can override and change any of the resources for just that particular instance of the pmacro. For example, if you want to apply a scale factor to the display of an analog point and you dont want to create a new pmacro with that scale factor, you can override the scale factor when you add the pmacro to the map. This does not affect the definition of the pmacro in the library, and does not affect any of the other instances of that pmacro in the map. On the other hand, when you edit the pmacro definition itself using the Pmacro editor, you do affect all of the pmacros in the map except in the instances where you have overridden the resource values. The point were trying to make here is that while overrides are very convenient, overusing them destroys your ability to make wholesale changes to all instances of a certain pmacro by simply editing the library definition of that pmacro. A bit of planning before you start can save a lot of work in the future. The list of pmacros that are currently in your pmacro library can be viewed by clicking on the Pmacros tab of the Library Selector window. This is where you select the desired pmacro when you add a pmacro to the map.
Pmacros
7-2
Figure 7-1 List of Pmacros Some of the pmacros in your library were there when you first got your system. They were provided by Survalent Technology Corporation.
7.1
Editing a Pmacro
To create a new pmacro, access the Pmacros tab of the Library Selector, right-click anywhere in the pmacro list and select the Add function.
Figure 7-2 Adding A New Pmacro A Create Pmacro window will appear, as shown in (Figure 7-3). This window shows a list of the available pmacro classes.
Pmacros
7-3
Figure 7-3 Create Pmacro Window When you double-click on one of the pmacro classes, a Pmacro Properties window is displayed, as illustrated in (Figure 7-4). (The example in Figure 7-4 is for a pmacro of class Status Symbol.) This window shows a scrollable list of the resources associated with the selected class. The Pmacro Properties window is resizable, so you can see all of the resources at once, if you wish.
Figure 7-4 Pmacro Properties Window In the background, a blank pmacro display window opens as well. This window is used to show you what the pmacro will look like as youre defining the resources.
Pmacros
7-4
In the Pmacro Properties window: Resource The Resource column is a list of the resources available for the selected pmacro class. You may need to double click or drag the vertical bar between the titles in order to have the complete names of some of the resources displayed. Detailed descriptions of all resources used by all classes of pmacro are provided in section 7.3, Pmacro Resources. Default The Default column is a list of default values for the resources. These are the values that will be used by instances of the pmacro on the map if you do not supply values for the library definition of the pmacro. Note that not all resources have default values. Override The Override column contains the resource values for the library definition of the pmacro. Any resource values that you enter here override the defaults and are the values that are used for each instance on the map (unless you further override them when you add a pmacro to the map). As mentioned before, use of overrides on a per instance basis should be minimized. An exception is the Point Name resource, which will generally be different for every instance. The Point Name resource should be left blank in the Pmacro Editor, and entered as an override when you add each instance of the pmacro to the map. Remove Override This pushbutton removes the override value of a selected resource. The resource reverts to its default value (if it has one). Apply Clicking on the Apply pushbutton applies the changes and keeps the Pmacro Properties window open. Undo Clicking on the Undo pushbutton undoes any changes made using Apply while the window is open. OK Clicking on OK applies the changes and closes the Pmacro Properties window. To get the Pmacro Properties window back, click on the Edit button. Alternatively you can select Modify from the Edit pull-down menu.
Pmacros
7-5
Cancel Clicking on Cancel closes the Pmacro Properties window without applying any changes. To get the Pmacro Properties window back, click on the Edit button or select Modify from the Edit pull-down menu. To create your pmacro, edit the resources as required. If there is a Point Name resource, leave it blank. The point name is filled in as an instance override when you add the pmacro to the map. Other resources, such as labels and associated filenames, are also typically specified at the time of instantiation, so leave these blank too. How to edit resources is described in paragraph 7.1.1, Editing Resources. The meaning of the resources is described in Section 7.3, Pmacro Resources.
Figure 7-5 Save As Window When youre ready to save the pmacro, click on the Save pushbutton in the WorldView toolbar. This will open the Save As window. Type in the desired file name for the new Pmacro and click on Save. This will save the new Pmacro file and close the Save As window. The Pmacro Properties window and the pmacro display window will remain, and you can continue editing the pmacro if you wish. Or you can dismiss the Pmacro editor by closing the pmacro display window. If you wish to edit the pmacro at a later time, you can access it by right-clicking on its entry in the Library Selector window.
Figure 7-6 Accessing an Existing Pmacro Alternatively, you can select Open from the File pull-down menu, and in the Open window that appears, select Pmacro (*.pml) from the Files of type: menu. Then, navigate to the pml folder, and select the desired pmacro.
Pmacros
7-6
Figure 7-7 Open Window The Pmacro Properties window will appear, showing the pmacros current resource values, as well as the pmacro display window showing what the pmacro presently looks like. See (Figure 7-8).
Figure 7-8 Editing an Existing Pmacro
7.1.1
Editing Resources
To edit a resource in the Pmacro Properties window, double-click on the resource name (in the Resource column). A dialog box will appear that allows you to select or type in a resource value. The various dialog boxes that are used to specify resource values are described below.
Pmacros
7-7
Library Resource A library resource specifies an element of a library, such as a drawing style, drawing style table, text style or symbol library. The dialog used to select the desired library element is illustrated in (Figure 7-9) (where the example is one of specifying a drawing style table). The dialog contains the name of the pmacro in the title bar, the name of the resource below that, followed by a data entry field and a scrollable list of the elements in the library. If the pmacro already has a value for this resource, the value appears in the data entry field and the corresponding library element in the list is highlighted.
Figure 7-9 Library Resource Dialog You can type the name of the desired library reference into the data entry field or select one from the scrollable list by clicking on it. When you click on an item in the list, it appears in the data entry field. If you type in a name that is not in the list, nothing will happen when you click on OK or Apply. Once the desired entry is in the data entry field, clicking on Apply will cause the selected item to appear in the Override column of the resource. Clicking on Undo removes the item from the Override column or returns to the original override that existed before. Clicking on Cancel closes the dialog without saving any changes made since the last Apply. Clicking on OK saves any changes made, stores the entered value in the Override column and closes the dialog. Enable/Disable Resource An enable/disable resource has a simple Yes or No value. The dialogs used for these resources are illustrated in (Figure 7-10). The name of the pmacro is shown in the title bar. Below that is a check box and the name of the resource. The check box is checked for Yes and unchecked for No. Figure 7-10 Check Box Dialog You can toggle the check mark by simply clicking on the check box. When you click on OK or Apply, the resource value in the Override column updates to Yes if the check box is checked and No if the check box is unchecked.
Pmacros
7-8
Value Resource Value resources are simple numeric values or text strings. The dialogs used for these resources are illustrated in (Figure 7-11). The name of the pmacro is shown in the title bar. Below that is the name of the resource and below that is a data entry field for the resource value. If the resource already has a value, the data entry field is initialized to that value. Figure 7-11 Data Entry Dialog
Type Resource A type resource specifies an entry from a limited list of types. The dialogs used for these resources are similar to those for library reference resources. An example is shown in (Figure 7-12). The name of the pmacro is shown in the title bar, below which is the resource name. This is followed by a data entry field and a scrollable list of allowed types. If the resource already has a value, it will appear in the data entry field, and the corresponding item in the list will be highlighted.
Figure 7-12 Type Selector Dialog As in the case of a library resource, you can either enter the desired type into the data entry field or select it from the list.
Filename Resource A filename resource specifies a file, such as one that contains an image, a menu definition or a report. An example is shown in (Figure 7-13). You can either enter the desired filename into the data entry field or select it from the list.
Figure 7-13 Filename Dialog
Pmacros
7-9
A point name resource specifies the name of a point. An example is shown in (Figure 7-14).
Figure 7-14 Point Name Dialog
Point Name Resource You can either enter the desired point name into the data entry field or browse for it. The point browser is described in Chapter 8, Map Editing. Note that point names are added to the pmacro when you instantiate them on the map, not when you define them in the Pmacro editor.
7.1.2
Deleting a Pmacro
The right-click Delete function in the Library Selector deletes the object from the library and moves it to the Recycle Bin. Before doing so, WorldView asks you for confirmation that you really want to delete the library resource. There is no Undo for this. If you want to undo, you have to retrieve the object yourself from the Recycle Bin. Before deleting a resource, WorldView checks the libraries and all currently open maps and control panels to make sure that the resource is not in use. If it is in use, the resource will not be deleted. Any maps and control panels that are not open will not be checked.
7.2
Pmacro Classes
This section describes the various pmacro classes and identifies the resources used by each class. The resources are described in detail in section 7.3, Pmacro Resources. Most of these pmacro classes are associated with database points. When you are in viewer mode, and you click on a pmacro that is associated with a database point, the system displays a dialog box containing functions that you can perform on the point. These dialog boxes are described in the WorldView for Windows Operators Guide.
Pmacros
7-10
7.2.1
Analog Value Pmacro
The Analog Value pmacro displays the value of an analog point in a numerical fashion. By specifying appropriate drawing style tables for the pmacro, you can control how the displayed value is to be color-coded to reflect the points limit state as well as its unacknowledged alarm status. The resources used by the analog value pmacro are listed in (Figure 7-15).
Figure 7-15Properties of Analog Value Pmacro
Pmacros
7-11
7.2.2
Analog Bar Pmacro
Analog Bar pmacros display analog point values in the form of real time bar graphs. Each pmacro displays one bar. You can set up a row of these to provide a visual representation of data that can be interpreted with just a glance. The length of each bar updates to reflect the value of the associated point. The color of the bar can be made to reflect the limit state of the analog point (i.e. what alarm limits are violated, if any, by the points current value). The resources used by the Analog Bar pmacro are listed in (Figure 7-16).
Figure 7-16 Properties of Analog Bar Pmacro
Pmacros
7-12
7.2.3
Analog Gauge Pmacro
The Analog Gauge pmacro allows you to create various types of gauges, dials and meters in your map or control panel, driven by the values of analog points. When you click on a gauge pmacro, the same analog dialog appears as for Analog Value pmacros with dialog code 0. You can define the Analog Gauge pmacro to not be selectable by setting the dialog code to -1. The resources used by the Analog Gauge pmacro are listed in the two halves of (Figure 7-17).
Figure 7-17 Properties of Analog Gauge Pmacro
Pmacros
7-13
7.2.4
Analog History Pmacro
An Analog History pmacro displays analog point historical values in a pop-up window. The table within this window can be configured to show any one or more of the analog history values for each of up to 18 point names. The table may be organized to show one data item per line, or to show multiple points on each line. The resources used by the Analog History pmacro are listed in (Figure 7-18).
Figure 7-18 Properties of Analog History Pmacro
Pmacros
7-14
7.2.5
Mobile Icon Pmacro
The Mobile Icon pmacro can display the value of two status points (one determines the symbol and the other determines the color). But the mobile icon is further controlled by the value of several other points. In particular, the location of the mobile icon within the map is determined by the values of two analog points. This makes the mobile icon useful for displaying the location and status of company vehicles in your service area. The location of your vehicles, whether they are trains, buses or maintenance trucks, can be telemetered to the master station via radio-based RTUs or GPS transponders. A magnification analog point can be used to enlarge the mobile icon under certain conditions to alert the operators. The resources used by the mobile icon are shown in (Figure 7-19).
Figure 7-19 Properties of Mobile Icon Pmacro Although the mobile icon is associated with database points, it is presently a display-only pmacro. You cannot click on it when you are in viewer mode (if you do, nothing happens).
Pmacros
7-15
7.2.6
Mobile Icon Bitmap Pmacro
A Mobile Icon Bitmap is a pmacro very similar to the regular Mobile Icon except that it uses bitmaps (e.g. *.jpg, *.bmp, etc) instead of symbols.
7.2.7
Pseudo Color Pmacro (VMS SCADA Only)
Pseudo points are special status points that can only be used on WorldView maps (and only when connected to a VMS-based SCADA system). They are created by means of a special pseudo point editor, but have no telemetry or control addresses. They can be manually set on WorldView maps to reflect the status of devices that are manually operated by field personnel but that are not monitored by SCADA. A Pseudo Color pmacro is associated with one pseudo point. It uses one symbol that is partly or completely drawn in the {dynamic} drawing style. The pmacro colors the {dynamic} portions of the symbol to reflect the current value of the pseudo point. The colors used are specified in a drawing style table resource. Since a pseudo point can have four possible states, there should be four drawing styles in this table. The complete set of resources used by the Pseudo Color pmacro is shown in (Figure 7-20). Since tagging of pseudo points is allowed, the list includes resources for tags and owner tags.
Figure 7-20 Properties of Pseudo Color Pmacro
Pmacros
7-16
7.2.8
Pseudo Symbol Pmacro (VMS SCADA Only)
A Pseudo Symbol pmacro is similar to the Pseudo Color pmacro described above, except that a separate symbol is displayed for each possible state of the pseudo point. See paragraph 7.2.4, Pseudo Color Pmacro. The resources used by the Pseudo Symbol pmacro are shown in (Figure 7-21). The Symbol 0 resource specifies the name of the symbol to be displayed when the pseudo point is in state 0, etc
Figure 7-21 Properties of Pseudo Symbol Pmacro
Pmacros
7-17
7.2.9
Pseudo Text Pmacro (VMS SCADA Only)
A Pseudo Text pmacro is similar to the Pseudo Symbol pmacro described above, except that text strings are displayed instead of symbols. A different text string is displayed for each possible state of the pseudo point. The resources used by the Pseudo Text pmacro are shown in (Figure 7-22). The String 0 resource specifies the text string to be displayed when the pseudo point is in state 0, etc.
Figure 7-22 Properties of Pseudo Text Pmacro
Pmacros
7-18
7.2.10
Pushbutton Symbol Pmacro
A Pushbutton Symbol pmacro acts as a poke point that can be used to go to other views, bring up trend graphs notes, images or reports, or to activate command sequences. Which of these things the poke point does is specified by the Button Type resource. Additional information, such as the name of a view or the number of a trend graph or command sequence, is defined in the Button Data and Button Argument resources. For some pushbutton types, associated files such as those containing images or ODBC queries are specified by the Filename resource. The use of these resources for each button type is described in Section 7.3, Pmacro Resources, and Section 7.4, Pushbuttons. The complete set of resources used by the Pushbutton pmacro is shown in (Figure 7-23). The Symbol 0 resource specifies the name of the symbol to display on the map to represent the poke point. The symbol can be anything you like. It does not have to be a picture of a pushbutton. The Symbol 1 resource specifies the name of an alternate symbol to be displayed while the mouse pointer is on the pushbutton pmacro and the mouse button is pressed. If you dont feel creative, you can enter the same symbol name for both Symbol 0 and Symbol 1 or just leave Symbol 1 blank.
Figure 7-23 Properties of Pushbutton Symbol Pmacro The Button Label Text Style and Button Label Drawing Style Table resources allow you to specify the text style and color of a label to be drawn on the pushbutton. The label text itself is specified in the Button Label resource, which can be left blank in the library definition of the pmacro since you will most likely want to override a different label string for each instance of the pushbutton on the map. The reason the color resource is a drawing style table rather than just one drawing style is that the second drawing style in the table is used while the mouse button is down on the pmacro (similar to displaying the alternate symbol). Only two drawing styles are needed in this drawing style table.
Pmacros
7-19
7.2.11
Station Color Pmacro
A Station Color pmacro is similar to the Pseudo Color pmacro in that one symbol is colored to reflect the status of a station. Only the {dynamic} portion of the symbol is re-colored. The color is chosen by indexing into a drawing style table using the priority of the highest priority outstanding or unacknowledged alarm on any point on that station. The drawing style table is chosen based on whether there are any unacknowledged alarms on the station. When there are unacknowledged alarms on the station, the drawing style table specified by the NAK Drawing Style Table resource is the one that is used. If you want blinking effects for unacknowledged alarms, you would put cycling drawing styles into this table. Since there are five alarm priorities (0 to 4), both drawing style tables must have five drawing styles in them. The complete set of resources used by the Station Color pmacro is shown in (Figure 7-24).
Figure 7-24 Properties of Station Color Pmacro The Button Label resources allow you to specify a label (e.g. station name) for each station pmacro, in a manner similar to that for Pushbutton pmacros (see Paragraph 7.2.10, Pushbutton Pmacro). The View Name resource specifies the name of a view in the map. If the value of this resource is non-blank, then clicking on the station pmacro causes the viewer to jump to the specified view. The view name thus adds a view pushbutton functionality to the station pmacro. This is great for system overviews: the color of the station symbol indicates the highest priority outstanding or unacknowledged alarm the symbol flashes if there are any unacknowledged alarms on the station clicking on the station symbol takes you to the view of that station
Pmacros
7-20
7.2.12
Station Symbol Pmacro
The Station Symbol pmacro is similar to the Station Color pmacro except that a separate symbol is displayed for each alarm priority. The symbols specified by Symbol 0 etc are displayed when there are no unacknowledged alarms on the station. The symbols specified by NAK Symbol 0 etc are displayed when there are unacknowledged alarms on the station. The resources used by the Station Symbol pmacro are shown in (Figure 7-25). The View Name resource can be used to turn the station symbol pmacro into a view poke point in a manner similar to that of the station color pmacro. See Paragraph 7.2.11, Station Color Pmacro.
Figure 7-25 Properties of Station Symbol Pmacro
Pmacros
7-21
7.2.13
Status Color Pmacro
The Status Color pmacro is similar to the Pseudo Color pmacro except that its associated with a status point rather than a pseudo point. Like the pseudo color pmacro, the status color pmacro uses one symbol that is partly or completely drawn in the {dynamic} drawing style. The pmacro colors the {dynamic} portions of the symbol to reflect the current value of the status point. The colors used are specified in two drawing style table resources. The Normal Drawing Style Table is used when the point has no unacknowledged alarms. The NAK Drawing Style Table is used when the point has unacknowledged alarms. Since a status point can have four possible states, both tables should contain four drawing styles each. A number of Flag resources allow you to enable or disable indications of point quality, alarm blocked status and tag status. The complete set of resources used by the Status Color pmacro is shown in (Figure 7-26).
Figure 7-26 Properties of Status Color Pmacro
Pmacros
7-22
7.2.14
Status Symbol Pmacro
The Status Symbol pmacro is similar to the Status Color pmacro except that a separate symbol is displayed for each state of the point. The symbols identified by Symbol 0 etc are displayed when the point has no unacknowledged alarms. The symbols identified by NAK Symbol 0 etc are displayed when the point has unacknowledged alarms. Despite its name, this pmacro can be used with analog points as well as status points. If you specify the name of an analog point for the Point Name resource, the pmacro will display Symbol 0 if the analog points value is positive, Symbol 1 if the points value is zero, and Symbol 2 if the points value is negative. The complete set of resources used by the Status Symbol pmacro is shown in (Figure 7-27).
Figure 7-27 Properties of Status Symbol Pmacro
Pmacros
7-23
7.2.15
Status Text Pmacro
The Status Text pmacro is similar to the Status Symbol pmacro except that it displays text strings instead of symbols to indicate the current value of the point. A different text string is displayed for each possible state of the point. The resources used by the Status Text pmacro are shown in (Figure 7-28). The String 0 resource specifies the text string to be displayed when the point is in state 0, etc. The color of the text is taken from drawing style tables identified by Normal Drawing Style Table and NAK Drawing Style Table resources. As usual, a color is obtained from the table by using the points current value as an index. The selection of which drawing style table to be used is based on whether the point has any unacknowledged alarms. Because a status point can have four possible states, both of these drawing style tables should have four drawing styles in them.
Figure 7-28 Properties of Status Text Pmacro
Pmacros
7-24
7.2.16
Text Value Pmacro
A Text Value pmacro displays the value of a text point. The value of the text point consists of a text string (of up to 30 characters) and a color code (0 7). When the string is displayed, trailing spaces are left off, which points with short strings to be placed close together on the map.The resources used by the Text Value pmacro are shown in (Figure 7-29).
Figure 7-29 Properties of Text Value Pmacro A Text Style resource specifies the font to use for the text string. The color for the text string is obtained by using the text points color code to index into a drawing style table (which should have eight drawing styles in it). If you click on a text point pmacro that does not have a "Normal Drawing Style Table " resource defined, an error message is displayed. The standard coloring scheme for text points is shown in Table 7-2, but in WorldView, you can use any color scheme you like for text points.
Table 7-2 Standard Text Point Colors Color Color Code Orange 0 Red 1 Green 2 Yellow 3 Blue 4 Magenta 5 Cyan 6 White 7
Pmacros
7-25
7.2.17
Pushbutton Bitmap Pmacro
The Pushbutton bitmap pmacro use bitmaps (image files) rather than symbols and can be used in both maps and control panels. You can produce a "transparent" pushbutton (i.e. one that shows a pushbutton or target contained in the background photo of a control panel) by not specifying any bitmap and just appropriately setting the Bitmap Height and Bitmap Width resources. The resources used by the Pushbutton Bitmap pmacro are listed in (Figure 7-30).
Figure 7-30 Properties of Pushbutton Bitmap Pmacro
Pmacros
7-26
7.2.18
Station Bitmap Pmacro
The Station Bitmap pmacro is similar to the Station Symbol pmacro except that instead of symbol the bitmap (image files) is displayed. The bitmaps specified by Bitmap 0 etc are displayed when there are no unacknowledged alarms on the station. The symbols specified by NAK Bitmap 0 etc are displayed when there are unacknowledged alarms on the station. Any bitmap files that you wish to use in bitmap pmacros should be placed in the "bmp" folder of the WorldView "standard" directory. Bitmap file types supported include GIF, JPG and BMP. The resources used by the Station Bitmap pmacro are listed in (Figure 7-31). The View Name resource can be used to turn the station bitmap pmacro into a view poke point.
Figure 7-31 Properties of Station Bitmap Pmacro
Pmacros
7-27
7.2.19
Status Bitmap Pmacro
The Status Bitmap pmacro is similar to the Status Symbol pmacro except that it displays bitmaps instead of symbols to indicate the current value of the point. A different bitmaps is displayed for each possible state of the point. The Bitmap 0 resource specifies the bitmap to be displayed when the point is in state 0, etc. The selection of which bitmap to be used is based on whether the point has any unacknowledged alarms. Because a status point can have four possible states, you should define two sets of four bitmap files instead of symbols. The Bitmap Height and Bitmap Width resources allow you to specify the desired size in world units. The resources used by the Status Bitmap pmacro are listed in (Figure 7-32).
Figure 7-32 Properties of Status Bitmap Pmacro
Pmacros
7-28
7.2.20
Time Value Pmacro
The Time Value pmacro displays the current date and time, and can be used in both maps and control panels. If you are using the Time pmacro, you must check the "Guarantee Drawing Order" checkbox in the Options dialog (else the displayed time will not update). The resources used by the Time Value pmacro are listed in (Figure 7-33). The Time Format resource is a string that contains time formatting codes. The formatting codes are preceded by a percent sign (%). Characters that do not begin with % are output as is.
Figure 7-33 Properties of Time Value Pmacro
Pmacros
7-29
7.2.21
Templates
WorldView supports a type of object called Template which can be used with both Windows and VMS SCADA systems. A WorldView template is a complex object that contains pmacros, symbols, graphics and text strings. Its an entity that is similar to a single-page control panel, but when instantiated, is displayed right in the map (not via a separate pop-up window). The template makes it easy to create standard navigation bars and other complex objects for repeated use in the map. And like control panels, when you modify a template, instances of the template are automatically updated.
In the Library Selector dialog (Figure 7-34), theres a tab labeled Templates. Right-click and select Add, and an editor similar to the control panel editor will appear to allow you to create a template and place both graphics and pmacros in it.
Figure 7-34 Library Selector Templates are instantiated in the map via a class of pmacro called a Template pmacro. You can create as many templates and template pmacros as you like (Figure 7-35)
Figure 7-35 Create Pmacro
Pmacros
7-30
In the template pmacro, theres a resource called Template that allows you to assign the template to that pmacro.
Figure 7-36 Pmacro Resource
When you place an instance of a template pmacro on the map, an instance of the corresponding template is added to the map. As mentioned above, if you edit and make changes to the template, all instances of the template are automatically updated (regardless of which pmacros were used to instantiate them). In edit mode, when you click on anything in the template, you select the template and you can move it, delete it or edit its resources (edit the template pmacros resources, that is). When you exit from edit mode and you select anything in the template, you operate on that object within the template. If the object is a view pushbutton, you go to that view. An example of a simple template in the template editor is shown below. The template contains four station pmacros with views. Note that if you enable grid mode, the lines going through 0,0 are highlighted in red. (This feature applies to the map and symbol editors too.)
Figure 7-37 Station Manu An example of an instance of this template in a map is shown below.
Pmacros
7-31
Besides station pmacros, the contents of templates are presently pretty much limited to static objects, such as menus and pushbutton links to fixed objects or documents. This serves the purpose that most of you are looking for: to create navigation bars to be placed in views and that can be easily maintained and expanded when needed. Although you can include analog and status pmacros in a template, the points have to be fully specified (i.e. with the station name). Note: You cannot add groups, views, layers or other templates to a template. Templates are stored in Standard\Templates and have the extension .template. Templates dont have the station part of the points defined in the template instance pmacro as control panels do.
7.3
Pmacro Resources
The following is a description of all of the pmacro resources that are available.
7.3.1
Alarm Blocked Flag Drawing Style Table
This resource specifies the name of a drawing style table to be used to color the alarm blocked indicator for a point. Double-clicking on this resource brings up a library resource dialog similar to that shown in Figure 7-9 to allow you to select a drawing style table. The alarm blocked indicator is the letter B. See paragraph 4.3.5, Flags, for a description of what needs to be in the drawing style table used for the display of the alarm blocked indicator. The value of this resource is meaningless if the Alarm Blocked Flag Enable resource is set to No. See paragraph 7.3.2, Alarm Blocked Flag Enable.
7.3.2
Alarm Blocked Flag Enable
This resource is used with a variety of point-related pmacros. It specifies whether the points alarm blocked indicator is to be displayed or not. Double-clicking on this resource brings up a check box dialog similar to that of (Figure 7-10) to allow you to toggle yes or no.
Pmacros
7-32
7.3.3
Alarm Blocked Flag Offset X
This resource is used to horizontally position the alarm blocked indicator relative to the origin of the pmacro. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a horizontal offset value (in world units). The value of this resource is meaningless if the Alarm Blocked Flag Enable resource is set to No. See paragraph 7.3.2, Alarm Blocked Flag Enable.
7.3.4
Alarm Blocked Flag Offset Y
This resource is used to vertically position the alarm blocked indicator relative to the origin of the pmacro. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a vertical offset value (in world units). The value of this resource is meaningless if the Alarm Blocked Flag Enable resource is set to No. See paragraph 7.3.2, Alarm Blocked Flag Enable.
7.3.5
Analog Scale Factor
This resource is used with the Analog Bar and Analog Value pmacros only. It is used to scale the value of the associated analog point to be displayed. The points value is divided by the scale factor. For example, if you have a point whose value is in kilowatts, and you wish to display it in megawatts, you can enter a scale factor of 1000. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a scale factor value.
7.3.6
Angle Length
This resource is used with the Analog Gauge pmacro only. It represents the angle length of the meter in degrees, positive being in the counter-clockwise direction. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a length value.
7.3.7
Angle Start
This resource is used with the Analog Gauge pmacro only. It represents the start angle of the meter in degrees, 0 degrees being the X axis. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a start value.
7.3.8
Arrow Head Size
This resource is used in a Gauge pmacro. It specifies the arrow head size as a fraction (0.0 to 1.0) of the arrow size.
Pmacros
7-33
7.3.9
Bar Length
This resource is used with Analog Bar pmacros only. It represents the maximum deflection (in world units) of a bar that varies in length depending on the value of the analog point. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a length value. The value of this resource is automatically overridden if you resize the pmacro by stretching it.
7.3.10
Bar Width
This resource is used with Analog Bar pmacros only. It specifies the width (in world units) of the bar. Doubleclicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a width value. The value of this resource is automatically overridden if you resize the pmacro by stretching it. The width of the bar is not affected by the value of the analog point. Only the length is. See paragraph 7.3.9, Bar Length.
7.3.11
Bitmap 0, 1, 2, 3, 4
These resources are used with Pushbutton, Station and Status Bitmap pmacros. They specify bitmaps to be used to display the status of these types of pmacros. These bitmaps are used when there are no unacknowledged alarms on the station or point. For a station, they specify the bitmaps to be displayed for each value of highest priority outstanding alarm. In this case, there are five bitmaps to be specified (corresponding to five alarm priorities). For a status point, they specify the bitmaps to be displayed for each possible state of the point. In this case, there are four bitmaps, which are called "Bitmap 0" through "Bitmap 3" to select (corresponding to four possible states of a status point). For a pushbutton, the "Bitmap 0" specifies the name of the bitmap to display on the map to represent the poke point. The "Bitmap 1" resource specifies the name of an alternate bitmap to be displayed while the mouse button is down on the pushbutton pmacro. Double-clicking on each of these resources brings up a dialog similar to that of (Figure 7-13) to allow you to select the desired bitmap from the "bmp" folder.
7.3.12
Bitmap Height
This resource is used with Pushbutton, Station and Status Bitmap pmacros. It specifies the height (in world units) of the bitmap. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a height value. It is not allowed to resize the pmacro by stretching it.
7.3.13
Bitmap Width
This resource is used with Pushbutton, Station and Status Bitmap pmacros. It specifies the width (in world units) of the bitmap. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a width value. It is not allowed to resize the pmacro by stretching it.
Pmacros
7-34
7.3.14
Button Argument 1 Data
This resource is used only with pushbutton pmacros of type Task, with dialog code 0. It represents the value of the first of two arguments that are sent to the task when you click on the pushbutton. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter an argument value. See paragraph 7.4, Pushbuttons, for details on how button arguments are used. The dialog code is defined by the value of the Dialog Code resource of the pushbutton pmacro. If a Task pushbutton is assigned a dialog code of 1, the pushbutton displays a user-defined menu of functions when you click on the pushbutton. The menu item that is selected then determines the value of the first argument that is sent to the task. In this case, it doesnt matter what the value of the Button Argument 1 Data resource is. See paragraph 7.5.1, Task Menu, for a description of how to create and use task menus.
7.3.15
Button Argument 1 Type
This resource is used only with Pushbutton and Pushbutton Bitmap pmacros of type Task. It represents the type of the first of two arguments that are sent to the task when you click on the pushbutton. Double-clicking on this resource brings up a type selection dialog similar to that of (Figure 7-12) to allow you to select an argument type. The allowed argument types are: Integer Float String
7.3.16
Button Argument 2 Data
This resource is used only with Pushbutton and Pushbutton Bitmap pmacros of type Task. It represents the value of the second of two arguments that are sent to the task when you click on the pushbutton. Doubleclicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter an argument value. See section 7.4, Pushbuttons, for details on how button arguments are used. As described in paragraph 7.3.14, Button Argument 1 Data, a dialog code of 1 causes the pushbutton to get the first argument from a menu instead of from the Button Argument 1 Data resource. Note that this is not the case for Button Argument 2 Data. The value of the Button Argument 2 Data resource is passed to the task as the second argument regardless of the pushbuttons dialog code.
7.3.17
Button Argument 2 Type
This resource is used only with Pushbutton and Pushbutton Bitmap pmacros of type Task. It represents the type of the second of two arguments that are sent to the task when you click on the pushbutton. Double-clicking on this resource brings up a type selection dialog similar to that of (Figure 7-12) to allow you to select an argument type. The allowed argument types are: Integer Float String
Pmacros
7-35
7.3.18
Button Data
This resource is used with Pushbutton and Pushbutton Bitmap pmacros only. Its meaning depends on the pushbutton type as specified by the Button Type resource (see paragraph 7.3.24, Button Type). Double-clicking on the Button Data resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a button data value. The meaning of the Button Data resource for each button type that uses it is summarized in Table 7-3 Table 7-3 Meaning of Button Data Resource Button Type Meaning of Button Data View Name of a view. When you click on the pushbutton, the viewer takes you to the view whose name is identified by the value of this resource. How to create views is described in chapter 8, Editing Maps. Graph number. When you click on the pushbutton, the viewer brings up a graph window containing a graph whose number is identified by the value of this resource. How to create graphs is described in chapter 8, Trend Graphs, of the WorldView for Windows Operators Manual. Name of a task mailbox. When you click on the pushbutton, the viewer brings up either a task activation dialog or a task menu that allows you to run or stop applications. Both the task activation dialog and the task menu are described in the WorldView for Windows Operators Guide. Name of a note topic. When you click on the pushbutton, the viewer brings up a Note window showing the contents of the note. Not used. SQL statement that retrieves a record from a relational database. When you click on the pushbutton, the viewer executes the SQL statement to retrieve the record and displays its contents in a pop-up window. Not used.
Graph
Task
Note
Image External Data Report
7.3.19
Button Label
This resource allows you to define a text string to be used to display a descriptive label in the pmacro. For example, you can specify the name of a view in a view pushbutton or a description of a trend graph in a graph pushbutton. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a label string. Normally, you should leave this resource undefined in the library definition of the pmacro, and specify it when you add an instance of the pmacro to the map. But its ok to put something in as a default, so you can see what the label looks like immediately when you put down the pmacro onto the map. Then you can edit the label.
Pmacros
7-36
Although the resource name has the word button in it, the resource can be used with non-pushbutton pmacros as well as pushbutton pmacros. It can be used with station and status pmacros to make the displayed pmacro include a station or device name.
7.3.20
Button Label Drawing Style Table
This resource specifies the name of a drawing style table to be used to color the label in pmacros that have the Button Label resource. See Paragraph 7.3.19, Button Label. Double-clicking on the Button Label Drawing Style Table resource brings up a library resource dialog similar to that of (Figure 7-9) to allow you to select the desired drawing style table. The specified drawing style table should have two drawing styles in it. Normally, the first drawing style is used to color the label. The second drawing style is used to color the label when the mouse button is depressed while the mouse pointer is over the pmacro.
7.3.21
Button Label Text Style
This resource specifies the name of a text style to be used to display the label in pmacros that have the Button Label resource. See Paragraph 7.3.19, Button Label. Double-clicking on this resource brings up a library resource dialog similar to that of (Figure 7-9) to allow you to select the desired text style.
7.3.22
Button Label X Offset
This resource specifies a horizontal offset to apply to the position of the label in pmacros that have the Button Label resource. See Paragraph 7.3.19, Button Label. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter an offset value (in world units) The offset positions the text relative to the origin of the pmacro. A positive value moves the label text to the right, a negative value moves it to the left.
7.3.23
Button Label Y Offset
This resource specifies a vertical offset to apply to the position of the label in pmacros that have the Button Label resource. See Paragraph 7.3.19, Button Label. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter an offset value (in world units). The offset positions the text relative to the origin of the pmacro. A positive value moves the label up, a negative value moves it down.
7.3.24
Button Type
This resource is used with Pushbutton and Pushbutton Bitmap pmacros only. It specifies the type of pushbutton pmacro. Double-clicking on this resource brings up a type selection dialog to allow you to select a pushbutton type.
Pmacros
7-37
Figure 7-38 Pushbutton Type Selection Dialog The purposes of the various pushbutton types are listed in Table 7-4. Table 7-4 Pushbutton Types Purpose of Pushbutton Pushbutton Type Bring up a view in the map View Graph Task Note Image External Data Report Bring up a trend graph Send a message to a mailbox Bring up a note Bring up a pop-up photo Retrieve and display the contents of a record from a relational database Bring up a report or query via Microsoft Excel or Query
7.3.25
Color Status Point Name
This resource is used with Mobile Icon pmacros only. It specifies the name of a status point whose current state determines the drawing style used to re-color the {dynamic} portions of the icons symbol. Double-clicking on this resource brings up a data entry dialog of the type shown in (Figure 7-14) to allow you to enter or browse for a status point name.
7.3.26
Condition Flag Drawing Style Table
This resource specifies the name of a drawing style table to be used to color the condition code indicator for a point. Double-clicking on this resource brings up a library resource dialog similar to that shown in (Figure 7-9) to allow you to select a drawing style table. If the point is normal, the condition code indicator is blank. Otherwise, its a character from Table 7-5.See Paragraph 4.3.5, Flags, for a description of what needs to be in the drawing style table used for the display of the condition code indicator.
Pmacros
7-38
Table 7-5 Condition Codes Condition Meaning Code Telemetry failed F M * U E Manually set Calculated from manually set data Unset setpoint Error
The value of this resource is meaningless if the Condition Flag Enable resource is set to No. See Paragraph 7.3.27, Condition Flag Enable.
7.3.27
Condition Flag Enable
This resource is used with a variety of point-related pmacros. It specifies whether the points condition indicator is to be displayed or not. Double-clicking on this resource brings up a check box dialog similar to that of (Figure 7-10) to allow you to toggle yes or no.
7.3.28
Condition Flag Offset X
This resource is used to horizontally position the condition indicator relative to the origin of the pmacro. Doubleclicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a horizontal offset value (in world units). The value of this resource is meaningless if the Condition Flag Enable resource is set to No. See Paragraph 7.3.27, Condition Flag Enable.
7.3.29
Condition Flag Offset Y
This resource is used to vertically position the condition indicator relative to the origin of the pmacro. Doubleclicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a vertical offset value (in world units). The value of this resource is meaningless if the Condition Flag Enable resource is set to No. See Paragraph 7.3.27, Condition Flag Enable.
7.3.30
Control Fail Timeout
This resource specifies how long to keep displaying a points control panel after you have executed a control in which there was a checkback failure. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a timeout value (in seconds). The purpose of the timer is to allow you retry the control that just failed without having to re-select the point.
Pmacros
7-39
7.3.31
Control Panel Filename
This resource is used with the Station Symbol, Color and Bitmap pmacros. This is the name of an associated Control panel file. Double-clicking on this resource brings up a dialog similar to that of (Figure 7-13) to allow you to select the desired control panel from the "cpl" folder. See the IED Control Panel Users Guide for more details on creating control panels.
7.3.32
Control Panel Point Prefix
This resource is used with the Station Symbol, Color and Bitmap pmacros. It specifies an optional point name prefix associated with a specific instantiation of an IED that was created using the IED Wizard. See the IED Control Panel Users Guide for more details on creating control panels.
7.3.33
Control Panel String 1, 2, 3
The Control Panel String 1, Control Panel String 2 and Control Panel String 3 resources are used with the Station Symbol, Color and Bitmap pmacros. These resources specify text strings that are to be displayed in the control panel. Each string may be up to 50 characters in length. You can distinguish a displayed control panel from another of the same type through these substituted strings. To place these strings in the control panel, insert into the control panel text string objects with string values #string1#, #string2# and #string3# (without the quotes). WorldView will substitute these special string values by the corresponding strings specified in the station pmacro. You can use any combination of these three strings, in any text style and drawing style, and you can place them anywhere you want in the control panel. See the IED Control Panel Users Guide for more details on creating control panels.
7.3.34
Control Panel X Position
This resource is used with the Station Symbol, Color and Bitmap pmacros. It allows you to specify (in pixels) the desired initial horizontal position of the control panel when it is launched. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter an initial horizontal position for the control panel. See the IED Control Panel Users Guide for more details on creating control panels.
7.3.35
Control Panel Y Position
This resource is used with the Station Symbol, Color and Bitmap pmacros. It allows you to specify (in pixels) the desired initial vertical position of the control panel when it is launched. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter an initial vertical position for the control panel. See the IED Control Panel Users Guide for more details on creating control panels.
Pmacros
7-40
7.3.36
Control Success Timeout
This resource specifies how long to keep displaying a points control dialog after you have executed a control in which there was a check back success. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a timeout value (in seconds). The purpose of the timer is to allow you to repeat the control that you just executed (after confirming that the device behaved as expected) without having to re-select the point. This is particularly useful with tap changers and other jog-type control points.
7.3.37
Data Item
Both Analog and Status point pmacros allow you to show other data items besides current value. The other data items are selectable by means of a me nu in the Data Item resource. See (Figure 7-39) for an analog point below.
Figure 7-39 Data Item Dialog Via the Data Item resource you can select: last update time, point description, engineering units and any of the analog history data items. This feature can be used with analog bars and gauges as well as with regular numeric pmacros, but in the case of the gauges and bars, only the numeric data items can be used. For status points, you can select: last update time, point description, state string and transition count.
Pmacros
7-41
The tooltip for the point identifies the data item that is being displayed if its not current value. It also shows the current value.
7.3.38
Dial Colour
This resource is used with the Analog Gauge pmacro only. It specifies the color of the Dial. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-9) to allow you to choose from the list of already defined Drawing Styles.
7.3.39
Dial Direction
This resource is used with the Analog Gauge pmacro only. It specifies the direction of the Label, Left to Right or Right to Left. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-9) to allow you to choose the direction.
7.3.40
Dialog Code
This resource specifies the type of control dialog that is to be displayed when you click on the pmacro in viewer mode. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a numeric dialog code.
Status Pmacro There are presently 14 different control dialogs available for status pmacros. They are numbered 0 13, and are selected from a menu, as shown in (Figure 7-40). There is a special dialog code of (1) Disabled (no dialog) that you can use in order to have no dialog displayed at all when you click on a point. You can use this for points that you wish to be display only, i.e. to make the pmacro not be selectable (except in edit mode). For such pmacros, the right-click pop-up menu still allows you to access Tag/Untag, Notes, Alarm and Oprsum Viewer dialogs (for read only). For such pmacros, although you are allowed to view tags and notes, you are not allowed to add, modify or delete them, nor use the point in Group Tag operations.
Pmacros
7-42
Figure 7-40 Selecting a Dialog Code for a Status Pmacro
The control dialogs that can be selected via the dialog code are all described in detail in the WorldView for Windows Operators Guide. For your convenience, they are shown in this editing guide below. Note that for dialog code 0, 1 and 2, the control dialogs that appear include a Properties button that allows you to access the point editor. If you have the point editing right, you are allowed to make changes to the point.
Figure 7-41 Normal Control Panel - Dialog Code 0
Pmacros
7-43
Figure 7-42 Tap Changer Control Panel - Dialog Code 1
Figure 7-43 Alternate Control Panel - Dialog Code 2
Figure 7-44 Direct Control Panel - Dialog Code 3
Figure 7-45 Direct Set Manual Panel Dialog Code 4
Figure 7-46 Direct Set Manual With Tag Dialog Code 5
Pmacros
7-44
Figure 7-47 Direct Control Panel for multi points pmacros when only one Point name is defined Dialog Code 6
Figure 7-48 Direct Control Panel for multi points pmacros when all tree Point name are defined Dialog Code 6
Figure 7-49 Direct Open on press Close on release Dialog Code 7
Figure 7-50 Direct Control Panel - Dialog Code 8 The dialogs for dialog codes 7 and 8 contain just one control pushbutton. For dialog code 7, when you press and hold the control pushbutton, a 0-control is issued to the point, and the pushbutton label updates to show the state 1 command string. When you release the pushbutton, a 1-control is issued and the pushbutton label reverts to the 0 command string. For dialog code 8, its the other way around: when you press on the control pushbutton, a 1-control is issued, and when you release the pushbutton, a 0-control, is issued. You can keep the dialog up for repeated control actions by specifying a non-zero value for the Control Fail Timeout resource. Worldview for Windows Editors Guide Pmacros 7-45
Figure 7-51 Direct Control Panel - Dialog Code 9 The dialog for dialog code 9 is the same as for dialog code 3 except that an execute button is included. Dialog code 10 causes a control panel to be launched when you select the point.
Figure 7-52 Tag Dialog Control Panel - Dialog Code 11 Dialog code 11 causes just the Tag/Untag dialog to be displayed when you select the point (with no other functions allowed).
Figure 7-53 Direct Open - Dialog Code 12
Figure 7-54 Direct Close - Dialog Code 13
The dialogs for dialog codes 12 and 13 contain just one pushbutton. Pressing on the pushbutton causes a control to be issued (open control for dialog 12, close control for dialog 13). These dialogs are particularly useful for mimicking controls in control panels.
Pmacros
7-46
Pushbutton Pmacro The Dialog Code resource is also used with task, view and report pushbuttons. In this case, there is no menu. Just type in either a 0 or a 1. Dialog code 0 produces a regular pushbutton. Dialog code 1 causes the viewer to display a menu when you click on the pmacro. The definition and usage of menus is the subject of section 7.5, Menu Files.
Analog History Pmacro For Analog History pmacros, the dialog code determines the organization of the Analog History window. A value of zero produces the standard display shown here, where each value appears on a separate line.
Figure 7-55 Normal Analog History Window with Dialog Code 0
If you want multiple points on each line (e.g. for 3-phase electrical points), you can enter the desired number of points per line into the Dialog Code resource of the pmacro. The display that results from setting the dialog code to 3 is shown in the example of (Figure 7-56).
Figure 7-56 3-Phase Analog History with Dialog Code 3 Worldview for Windows Editors Guide Pmacros 7-47
Analog Point Pmacro There are presently 3 different control dialogs available for analog point pmacros. They are numbered 0 to 2, and are selected from a menu, as shown in (Figure 7-57). There is a special dialog code of (1) Disabled (no dialog) that you can use in order to have no dialog displayed at all when you click on a point. You can use this for points that you wish to be display only, i.e. to make the pmacro not be selectable (except in edit mode). For such pmacros, the right-click pop-up menu still allows you to access Tag/Untag, Notes, Limits, Analog History, Alarm and Oprsum Viewer dialogs (for read only). For such pmacros, although you are allowed to view tags, notes and limits, you are not allowed to edit them.
Figure 7-57 Selecting a Dialog Code for an Analog Pmacro
Figure 7-58 Analog Point with Dialog Code 0- Default Worldview for Windows Editors Guide Pmacros 7-48
For analog points, dialog code 1 (Menu) causes the viewer to display a menu when you click on the pmacro. The definition and usage of these menus is the subject of section 7.5, Menu Files
Dialog code 2 (Set manual only) causes the Analog Set Manual dialog to appear when the pmacro is selected.
Figure 7-59 Analog Point with Dialog Code 2 ( Set manual only)
Symbol Pmacros A dialog code of 2 assigned to symbol pmacros causes the extent of the pmacro to depend on the currently displayed symbol instead of on the aggregate of all the symbols that are associated with the pmacro. Other than this, the behavior is as for dialog code 1. What is this good for? It allows you to create a pmacro that, while its point is in one state, occludes and renders unselectable another pmacro, but when the point is in another state, the second pmacro is both visible and selectable.
7.3.41
Disallow Manual Set
This resource is used with Analog Bar/Value/Gauge, Status Symbol/Color/Text/Bitmap and Text Value pmacros. If this resource is set to Yes, WorldView will not allow manual set or deactivate operations on the point. In the case of an analog menu pmacro, WorldView will not even bring up the analog menu dialog.
7.3.42
Drawing Style
This resource is used with the Time Value pmacro only. The color of the displayed date and time is determined by the drawing style specified by this resource. Double-clicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired drawing style.
7.3.43
Draw from base
This is an option that allows you to be able to display analog bars in a bipolar fashion. Its enabled by setting the Draw from base resource to Yes, and by entering the desired baseline value into the Base value resource.
Pmacros
7-49
Figure 7-60 Draw from base
7.3.44
Erase Before Draw
This resource is used with the Analog Value/Gauge, Mobile Icon, Status Symbol/Color/Text/Bitmap, Station Symbol/Color/Bitmap and Text/Time Value pmacros. The default value of this resource is Yes, which causes the entire extent of the pmacro to be erased before redrawing it on an update. Setting this resource to No allows you to have stuff that's behind the pmacro show through the empty parts of the pmacro (e.g. text or other graphics poking through an open box or circle), creating sort of a transparent effect. If you wish to make use of this feature, you have to enable the "Guaranteed Drawing Order" option in the Options dialog.
7.3.45
Filename
This is the name of an associated file. The use of an associated file depends on the type of pmacro and is summarized in Table 7-6. Details can be found in section 7.4, Pushbuttons, and section 7.5, Menu Files. Table 7-6 Use of Associated Files Pmacro Analog value, dialog code 1 Task pushbutton, dialog code 1 Image pushbutton External data pushbutton Report pushbutton
File Menu file Menu file Image file .udl file .xls or .qry file
Location of file wmp wmp Image directory qry qry
Pmacros
7-50
7.3.46
Flag Scale Factor X
This resource specifies a horizontal scale factor to be applied to all of the flag indicators in the pmacro (so that you can independently control the aspect ratio of the flags). This includes the alarm blocked flag, condition code flag and the tag flag. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a scale factor value. You can use this resource to adjust the size of the flags relative to the rest of the pmacro.
7.3.47
Flag Scale Factor Y
This resource specifies a vertical scale factor to be applied to all of the flag indicators in the pmacro (so that you can independently control the aspect ratio of the flags). This includes the alarm blocked flag, condition code flag and the tag flag. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a scale factor value. You can use this resource to adjust the size of the flags relative to the rest of the pmacro.
7.3.48
Gauge Subtype
This resource is used only with the Analog Gauge pmacro when the Gauge Type is Corner. It specifies the subtype of the Gauge i.e. visible quadrant for the Corner gauge. Double-clicking on this resource brings up a type selection dialog similar to that of (Figure 7-12) to allow you to select a gauge subtype. The allowed gauge subtypes are: Top-Left Top-Right Bottom-Left Bottom-Right
7.3.49
Gauge Type
This resource is used with the Analog Gauge pmacro only. It specifies the type of the Gauge. Double-clicking on this resource brings up a type selection dialog similar to that of (Figure 7-12) to allow you to select a gauge type. The allowed gauge types are: Dial Meter Corner
7.3.50
Horizontal Justification
This resource specifies the horizontal justification of text-based pmacros such as Analog Value, Pseudo Text, Status Text and Text Value, and allows you to override the horizontal justification of the selected text style (and avoid having to create a new text style). Double-clicking on this resource brings up a type selector dialog similar to that of (Figure 7-12) to allow you to select the desired justification. Your choices are:
Pmacros
7-51
Default (i.e. use the justification of the text style) Left Right Center Decimal
See section 5.4, Horizontal Justification, for a description of what these choices mean.
7.3.51
Image Scale Factor, X Axis
This resource is used with pushbuttons of type Image. It specifies a horizontal scale factor to be applied to the image when the image is invoked (the image is invoked by clicking on the pushbutton). Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a scale factor value. If you want to maintain the images original aspect ratio, which would be the normal case, set the image scale factors in both the X and Y directions the same. See paragraph 7.3.52, Image Scale factor, Y Axis.
7.3.52
Image Scale Factor, Y Axis
This resource is used with pushbuttons of type Image. It specifies a vertical scale factor to be applied to the image when the image is invoked (the image is invoked by clicking on the pushbutton). Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a scale factor value. If you want to maintain the images original aspect ratio, which would be the normal case, set the image scale factors in both the X and Y directions the same. See paragraph 7.3.51, Image Scale factor, X Axis.
7.3.53
Label Color
This resource is used with the Analog Gauge pmacro only. It specifies the color of the Gauge title. Doubleclicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired drawing style.
7.3.54
Label Position X
This resource is used with the Analog Gauge pmacro only. It allows you to specify the desired horizontal position of the gauge title. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a horizontal position for the gauge title.
7.3.55
Label Position Y
This resource is used with the Analog Gauge pmacro only. It allows you to specify the desired vertical position of the gauge title. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a vertical position for the gauge title.
Pmacros
7-52
7.3.56
Label Text
This resource allows you to define the title of an analog gauge. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter the text of the title. Normally, you should leave this resource undefined in the library definition of the pmacro, and specify it when you add an instance of the pmacro to the map. But its ok to put something in as a default, so you can see what the label looks like immediately when you put down the pmacro onto the map. Then you can edit the label.
7.3.57
Label Text Style
This resource is used with the Analog Gauge pmacro. It specifies the text style to use to display the title of the gauge. Double-clicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired text style.
7.3.58
Limit Color
This resource is used with the Analog Gauge pmacro only. It specifies the color of the selected Limit. Doubleclicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired drawing style. Note that colors for a maximum of 6 limits can be defined.
7.3.59
Limit Max Value
This resource is used with Analog Gauge pmacros only. It specifies the maximum value at which the color in the selected Limit will apply. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a maximum limit value. Note that a maximum of 6 limits can be defined.
7.3.60
Limit Min Value
This resource is used with Analog Gauge pmacros only. It specifies the minimum value at which the color in the selected Limit will apply. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a minimum limit value. Note that a maximum of 6 limits can be defined.
7.3.61
Limit Center Color
This resource is used with the Analog Gauge pmacro only. It specifies the color for the inner area, below the value in "Limit Min Visible %" resource. Double-clicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired drawing style.
Pmacros
7-53
7.3.62
Limit Max Visible %
This resource is used with Analog Gauge pmacros only. It specifies the maximum visible percent of radius for the Limits Area. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a maximum value in percent.
7.3.63
Limit Min Visible %
This resource is used with Analog Gauge pmacros only. It specifies the minimum visible percent of radius for the Limits Area. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a minimum value in percent.
7.3.64
Limits Number
This resource is used with Analog Gauge pmacros only. It specifies the number of limits that will be displayed. According to this number of limits, the same number of Limit Color, Limit Max and Limit Min values will be displayed. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a number of limits.
7.3.65
Lower Limit
This resource is used with Analog Bar and Analog Gauge pmacros only. It specifies the value of the associated analog point below which the bar is to be displayed with zero length or the needle of the gauge is to be displayed at its minimum position. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a lower limit value. See paragraph 7.3.110, Upper Limit.
7.3.66
Magnification
This is a resource that allows you to scale the symbolic content of the entire pmacro. Double-clicking on this resource brings up a data entry dialog of the type shown in (Figure 7-11) to allow you to enter a magnification factor. The magnification applies to symbols and flags, but not to text. The bar in an analog bar and gauge in an analog gauge pmacro can also be magnified using this resource. Magnification factors greater than unity expand the size of the pmacro. Positive values less than unity act to reduce the size of the pmacro. Negative values invert the symbolic contents, both vertically and horizontally, in addition to scaling the symbolic content (but leave the text content untouched).
7.3.67
Magnification Point Name
This resource is used with Mobile Icons only. It specifies the name of an analog point whose value is used as a magnification factor when displaying the icons symbol. Double-clicking this resource brings up a data entry dialog of the type shown in (Figure 7-14) to allow you to enter or browse for a magnification point name. If you have also specified a Magnification resource (see paragraph 7.3.66, Magnification), the value retrieved from the point specified by the Magnification Point Name resource is multiplied by the value of the Magnification
Pmacros
7-54
resource to produce the total amount of magnification. The variability afforded by the Magnification Point Name resource allows you to enlarge the mobile icon under certain conditions to alert the operator.
7.3.68
Major / Minor Divisions
These resources are used with Analog Gauge pmacros only. They specify the number of major divisions, and number of minor divisions in each major division, that will be displayed. Double-clicking on these resources brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a number of major / minor divisions.
7.3.69
Major / Minor Divisions Color
These resources are used with Analog Gauge pmacros only. They specify the color of the major and minor divisions. Double-clicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired drawing style. The Major Division Color resource only applies to major divisions that are not in any Limits range. Divisions that are within a limit range are colored using the color of the Limit. The same coloring rule applies to the Minor Divisions.
7.3.70
Major Divisions Precision
This resource is used with Analog Gauge pmacros only. Positive values of this resource specify the number of decimal digits for the major division labels of the analog gauge. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a major divisions precision value. A value of zero for this resource means no decimal places and no decimal point.
7.3.71
Major Divisions Text Color
This resource is used with Analog Gauge pmacros only. It specifies the color of the major divisions labels. Double-clicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired drawing style.
7.3.72
Major Divisions Text Style
This resource is used with Analog Gauge pmacros. It specifies the text style to use to display the labels of the major divisions. Double-clicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired text style.
7.3.73
Minimum Size (Pixels)
This resource is used with Analog Bar/Gauge/Value/History and Status Symbol/Color/Text/Bitmap pmacros. It allows you to specify an optional minimum size before a point can be selected for operation. If both the displayed height and width of the point are less than this minimum size, WorldView does not allow you to select the point. Worldview for Windows Editors Guide Pmacros 7-55
If the value of this resource is zero (the default), the point is always selectable, no matter what its size, as long as it can be seen. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a minimum size in pixels.
7.3.74
NAK Bitmap 0, 1, 2, 3, 4
These resources are used with Station Bitmap and Status Bitmap pmacros when there are unacknowledged alarms on the station or status point, respectively. For a station, they specify the bitmaps to be displayed for each value of highest priority outstanding or unacknowledged alarm. For a status point, they specify the bitmaps to be displayed for each possible state of the point. In the case of a station point, there are five bitmaps to select (to correspond to five alarm priorities). In the case of a status point, there are four bitmaps to select (corresponding to four possible states of a status point). Double-clicking on these resources brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired bitmap.
7.3.75
NAK Drawing Style Table
NAK stands for uNAcKnowledged. This resource specifies a drawing style table that is to be used to color a symbol or text string to reflect the value of a station or status point, or the limit state of an analog point, when there are unacknowledged alarms on the point. If the pmacro uses symbols, only the portion of the symbol that is drawn in {dynamic} are colored according to the contents of this drawing style table. Double-clicking on this resource brings up a library reference dialog similar to that shown in (Figure 7-9) to allow you to select the desired drawing style table. For a station point, the color is chosen from the selected table by means of an index consisting of the priority of the highest outstanding or unacknowledged alarm on the station. For a status point, the color is chosen according to the current state of the status point. For an analog point, whether the pmacro is an Analog Value or an Analog Bar pmacro, the color is chosen by indexing according to the points current limit state.
7.3.76
NAK Symbol 0, 1, 2, 3, 4
These resources are used with Station Symbol and Status Symbol pmacros when there are unacknowledged alarms on the station or status point, respectively. For a station, they specify the symbols to be displayed for each value of highest priority outstanding or unacknowledged alarm. For a status point, they specify the symbols to be displayed for each possible state of the point. In the case of a station point, there are five symbols to select (to correspond to five alarm priorities). In the case of a status point, there are four symbols to select (corresponding to four possible states of a status point). Double-clicking on these resources brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired symbol.
7.3.77
Needle Color
This resource is used with Analog Gauge pmacros only. It specifies the color of the needle. Double-clicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired drawing style. Worldview for Windows Editors Guide Pmacros 7-56
7.3.78
Needle Type
This resource is used with Analog Gauge pmacros. It specifies the type of the needle. Double-clicking on this resource brings up a type selector dialog similar to that of (Figure 7-12) to allow you to select the desired needle type. Your choices are: Line Arrow Diamond
7.3.79
Needle Visible Percentage
This resource is used with Analog Gauge pmacros only. It specifies the visible percent of the needle for the meter type of gauge. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a value in percent.
7.3.80
Normal Drawing Style Table
This resource is similar to the NAK Drawing Style Table resource except that it is used when there are no unacknowledged alarms on the point. See paragraph 7.3.75, NAK Drawing Style Table. Double-clicking on this resource brings up a library resource dialog similar to that of (Figure 7-9) to allow you to select the desired drawing style table.
7.3.81
Orientation
This resource specifies the orientation of text-based pmacros such as Analog Value, Pseudo Text, Status Text and Text Value, and allows you to override the orientation of the selected text style (and avoid having to create a new text style). Double-clicking on this resource brings up a type selector dialog similar to that of (Figure 7-12) to allow you to select the desired orientation. Your choices are: Default (i.e. use the orientation of the text style) Horizontal Vertical
See section 5.3, Orientation, for a description of what these choices mean.
Pmacros
7-57
7.3.82
Owner Tag Flag Drawing Style Table
This resource specifies the name of a drawing style table that contains the drawing styles to be used to display the symbols representing the highest-level tag on the point. Each element of this drawing style table has a counterpart in a corresponding symbol table. See paragraph 7.3.86, Owner Tag Flag Symbols. Double-clicking on this resource brings up a library resource dialog similar to that of (Figure 7-9) to allow you to select the desired drawing style table.
7.3.83
Owner Tag Flag Enable
This resource is used with a variety of point-related pmacros. It specifies whether the points owner tag indicator is to be displayed or not. Double-clicking on this resource brings up a check box dialog similar to that of (Figure 7-10) to allow you to toggle yes or no.
7.3.84
Owner Tag Flag Offset X
This resource is used to horizontally position the owner tag indicator relative to the origin of the pmacro. Doubleclicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a horizontal offset value (in world units). The value of this resource is meaningless if the Owner Tag Flag Enable resource is set to No. See paragraph 7.3.83, Owner Tag Flag Enable.
7.3.85
Owner Tag Flag Offset Y
This resource is used to vertically position the owner tag indicator relative to the origin of the pmacro. Doubleclicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a vertical offset value (in world units). The value of this resource is meaningless if the Owner Tag Flag Enable resource is set to No. See paragraph 7.3.83, Owner Tag Flag Enable.
7.3.86
Owner Tag Flag Symbols
This resource specifies the name of a symbol table that contains the symbols to be displayed to represent the highest level tag on the point. Double-clicking on this resource brings up a library resource dialog similar to that of (Figure 7-9) to allow you to select the desired symbol table. See sections 6.4, Symbol Table, and sections 6.5, Using Symbol Tables, and in particular, paragraph 6.5.2, Owner Tags, for details on creating symbol tables for owner tags.
7.3.87
Point Name
For pmacros that are associated with one and only one point, this resource specifies that points name. Doubleclicking on this resource brings up opens a data entry dialog of the type shown in (Figure 7-14) to allow you to enter or browse for a point name. Worldview for Windows Editors Guide Pmacros 7-58
It makes sense to leave this resource blank in the library definition of the pmacro, in favor of filling it in as an override when you add each instance of the pmacro to the map. Note that the Analog History pmacro class supports 18 point names, which are called Point Name 01 through Point Name 18. Note that the Status Symbol, Color, Text and Bitmap pmacro classes can be associated with two more point names. The additional point name resources, which can be used if the dialog code is set to 6, are called Point Name 2 and Point Name 3.
7.3.88
Point Title 1, 2, 3
These are three resources that are used with Status Symbol, Color, Text and Bitmap pmacros only. They specify the titles of the three sections of the three-point dialog that is obtained when the dialog code is set to 6. Double-clicking on each of these resources brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a point title.
7.3.89
Precision
This resource is used with Analog Value pmacros only. Positive values of this resource specify the number of decimal digits to be used in the numerical display of the analog points value. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a precision value. A value of zero for this resource means no decimal places and no decimal point. A value of 1 causes the analog value to be displayed with a floating decimal point so as to display as many significant digits as possible. A value of 2 causes the value to be displayed with leading zeros (as opposed to leading blanks).
7.3.90
Radius
This resource is used with Analog Gauge pmacros only. It specifies the radius of the gauge. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a radius in world units.
7.3.91
Rotation (degrees)
This resource is used with pmacros that display symbols. It allows you to specify an angle of rotation for the symbols associated with the pmacro. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a rotation angle. The rotation angle is specified in units of degrees. Positive rotation is counterclockwise. Flags are rotated as well as the symbols if the Rotate MTB Flags option is checked in the Map View tab of the Options window. See Section 5.33, Map View Options, of the WorldView for Windows Operators Guide. Text contained in the symbol is rotated. Label text is not.
Pmacros
7-59
7.3.92
Scale Factor On X Axis
This resource is used to specify a horizontal scale factor to apply only to the symbols contained in the pmacro (so that you can change the symbol's aspect ratio). Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a scale factor value.
7.3.93
Scale Factor On Y Axis
This resource is used to specify a vertical scale factor to apply only to the symbols contained in the pmacro (so that you can change the symbol's aspect ratio). Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a scale factor value.
7.3.94
Select Box Drawing Style
This resource is used with point-related pmacros. When you click on a point pmacro in view mode, the viewer highlights your selection by drawing a selection rectangle around it. This resource specifies the drawing style that is used to draw this selection rectangle. Double-clicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired drawing style.
7.3.95
Sign Flag Enable
This resource is used with Analog Value pmacros only. It specifies whether the plus and minus (+, -) signs on the numeric display of the points value are to be displayed or not. Double-clicking on this resource brings up the check box dialog of (Figure 7-10) to allow you to toggle yes or no. Whats this for? In cases where power or fluid flow can be in either direction, flow can be positive or negative. Rather than make the operator have to think things like positive means flowing left, its preferable, in such cases, to numerically display the absolute value of the flow, and display the direction of the flow using a symbol like an arrow. See paragraph 7.2.14, Status Symbol Pmacro, and paragraph 7.3.100, Symbol 0, 1, 2, 3, 4, for more on how to display symbols based on the sign of analog values.
7.3.96
Station Name
This resource is used with Station Symbol, Color and Bitmap pmacros. For pmacros that are associated with one and only one station, this resource specifies that stations name. Double-clicking on this resource opens a data entry dialog of the type shown in (Figure 7-14) to allow you to enter or browse for a station name. It makes sense to leave this resource blank in the library definition of the pmacro, in favor of filling it in as an override when you add each instance of the pmacro to the map.
7.3.97
Station Name 2, 3, 4
These resources are used to specify three additional stations for Station Symbol, Color and Bitmap pmacros that are used to launch control panels. (A control panel can show points for up to four stations.) Double-clicking
Pmacros
7-60
on each of these resources opens a data entry dialog of the type shown in (Figure 7-14) to allow you to enter or browse for a station name. See the IED Control Panel Users Guide for more information on creating control panels.
7.3.98
String 0, 1, 2, 3
These are four resources that are used with Status Text and Pseudo Text pmacros only. The string that is displayed depends on the points current value. Double-clicking on any of these resources brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a string.
7.3.99
Symbol
This resource is used with pmacros that are associated with just one symbol only. See paragraphs 7.2.7, Pseudo Color Pmacro, paragraphs 7.2.11 Station Color Pmacro, and paragraphs 7.2.13, Status Color Pmacro. Double-clicking on this resource brings up a library resource dialog similar to that of (Figure 7-9) to allow you to select the desired symbol.
7.3.100
Symbol 0, 1, 2, 3, 4
These resources are used with station and point-related pmacros. They specify symbols to be used to display the status of the point associated with the pmacro. These symbols are used when there are no unacknowledged alarms on the station or point. For a station, they specify the symbols to be displayed for each value of highest priority outstanding alarm. In this case, there are five symbols to be specified (corresponding to five alarm priorities). For a status point, they specify the symbols to be displayed for each possible state of the point. In this case, there are four symbols to select (corresponding to four possible states of a status point). For an analog point, these resources specify the symbols to display to show the sign of the point, as shown in Table 7-7. In this case, there are three symbols to select. Table 7-7 Use of Symbols With Analog Points Used When Analog Point Value Is: Resource Positive Symbol 0 Symbol 1 Symbol 2 Zero Negative
Double-clicking on each of these resources brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired symbol.
7.3.101
Symbol Status Point Name
This resource is used with Mobile Icons only. It specifies the name of a status point whose current state is used to select which symbol to display for the icon. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a point name. Worldview for Windows Editors Guide Pmacros 7-61
7.3.102
Tag Flag Drawing Style Table
The tag flag consists of a single character that is displayed to indicate the points control state or highest level tag. The characters used for this purpose are listed in Table 7-8.
Table 7-8 Tag Flag Characters Flag Character Meaning Point is tagged T Device is selected for control S Device is opening O Device is closing X Point is interlocked I
The color of the displayed character is determined by a drawing style table specified by this resource. Doubleclicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired drawing style table. See paragraph 4.3.5, Flags, for a description of what needs to be in a Tag Flag drawing style table. The value of this resource is meaningless if the Tag Flag Enable resource is set to No. See paragraph 7.3.103, Tag Flag Enable.
7.3.103
Tag Flag Enable
This resource is used with a variety of point-related pmacros. It specifies whether the points tag indicator is to be displayed or not. Double-clicking on this resource brings up a check box dialog similar to that of (Figure 7-10) to allow you to toggle yes or no.
7.3.104
Tag Flag Offset X
This resource is used to horizontally position the tag indicator relative to the origin of the pmacro. Doubleclicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a horizontal offset value (in world units). The value of this resource is meaningless if the Tag Flag Enable resource is set to No. See paragraph 7.3.103, Tag Flag Enable.
7.3.105
Tag Flag Offset Y
This resource is used to vertically position the tag indicator relative to the origin of the pmacro. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a vertical offset value (in world units). The value of this resource is meaningless if the Tag Flag Enable resource is set to No.
Pmacros
7-62
See paragraph 7.3.103, Tag Flag Enable.
7.3.106
Thousands Separator
This resource is used with the display of numeric quantities by analog pmacros. If set to Yes, the thousands separator is displayed in numeric values.
7.3.107
Text Style
This resource is used with pmacros whose principal output is a text string. This includes the Analog Value, Status Text, Pseudo Text, and Text Value pmacros. The Text Style resource specifies the text style to use to display the string. Double-clicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired text style.
7.3.108
Time Format
This resource is used with Time Value pmacros only. It specifies a string that contains time formatting codes. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter the time format. The available formatting codes are listed in Table 7-9. Table 7-9 Time Format Codes Meaning Code Abbreviated week day name %a Abbreviated month name %b Date/time representation for locale %c Hour in 24-hour format %H Day of year as decimal number %j Month as decimal number %m Current locale's AM/PM indicator %p Second as decimal number %S Weekday as decimal number %w Date representation for current locale %x Year without century %y Time-zone name %z
Code %A %B %d %I %M %U %W %X %Y %%
Meaning Full weekday name Full month name Day of month as decimal number Hour in 12-hour format Minute as decimal number Week number in year (Sunday) Week number in year (Monday) Time representation for locale Year with century Percent sign
7.3.109
Tool Tip Text
This resource is used with Analog History and Pushbutton Symbol/Bitmap pmacros. It allows you to define a text string to be used to display a tool tip. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a tool tip text. By using the string \n as a separator, you can create multi-line tooltips. For example, Feeder\nLoads would be displayed as: Feeder Worldview for Windows Editors Guide Pmacros 7-63
Loads For pushbutton pmacros, a default tooltip is used if the Tool Tip Text resource is blank. For example, for a view pushbutton, the tooltip shows the view name by default. Normally, you should leave this resource undefined in the library definition of the pmacro, and specify it when you add an instance of the pmacro to the map. But its ok to put something in as a default, so you can see what the label looks like immediately when you put down the pmacro onto the map. Then you can edit the text.
7.3.110
Upper Limit
This resource is used with Analog Bar and Analog Gauge pmacros only. It specifies the value of the associated analog point above which the bar is to be displayed at its full length or the gauge is to be displayed at full angle. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter an upper limit value. The full length of the bar is defined by the Bar Length resource described in paragraph 7.3.9, Bar Length, while the full angle value of the gauge is defined by the Angle Length resource described in paragraph 7.3.6, Angle Length. There is also a Lower Limit resource that specifies the value below which the bar or gauge is to be drawn with zero length. See paragraph 7.3.65, Lower Limit.
7.3.111
View Name
This resource is used with Station Color, Station Symbol and Station Bitmap pmacros to specify the name of a view to go to when you click on the station symbol. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter the desired view name. If you leave this resource blank, then when you click on the station symbol, instead of jumping to a view, the pmacro displays a dialog box that allows you to acknowledge all alarms on the station.
Figure 7-61 Dialog for Station With No View Name
The View Name resource can also be used with Status Color, Status Symbol, Status Text and Status Bitmap pmacros. If a view name is specified, the pmacro will operate like a station pmacro and jump to that view. This is convenient if the status point is a calculated summary point, which represents the state of an arbitrary group of points. See the Automation Database Editing Guide for more information. Note that view names in all pmacros are case-insensitive.
Pmacros
7-64
7.3.112
X Analog Point Name
This resource is used with Mobile Icons only. It specifies the name of an analog point whose value determines the X coordinate of the mobile icons location within the map. The value of the X analog point is assumed to be in world units. Double-clicking on this resource brings up a data entry dialog of the type shown in (Figure 7-14) to allow you to enter or browse for the required point name.
7.3.113
Y Analog Point Name
This resource is used with Mobile Icons only. It specifies the name of an analog point whose value determines the Y coordinate of the mobile icons location within the map. The value of the Y analog point is assumed to be in world units. Double-clicking on this resource brings up a data entry dialog of the type shown in (Figure 7-14) to allow you to enter or browse for the required point name.
7.3.114
Current Value Enable
This resource is used only by Analog History pmacros. If set to Yes, the analog history window will include an entry for the present value of the point.
7.3.115
Enable Time
This resource is used only by Analog History pmacros. If enabled, the analog history window will include the time of occurrence for each displayed value. This is used to identify the time at which a maximum or a minimum value occurred.
7.3.116
Enable Current 15M Max (or Min)
These two resources are used only by Analog History pmacros. If enabled, the corresponding maximum or minimum value will be included in the analog history display window. This will be the highest/lowest value seen so far in this 15-minute interval. It is based on all values that have occurred, not just on periodic samples.
7.3.117
Enable Current Hour (Day or Week) Max (or Min)
These resources are used only by Analog History pmacros. For each resource enabled, the corresponding maximum or minimum value will be included in the analog history display window. This will be the highest/lowest value seen so far in the current day, hour, or week. It is based on all values that have occurred, not just on periodic samples.
7.3.118
Enable Previous 15M (Hour, Day or Week) Max (or Min)
These resources are used only by Analog History pmacros. For each resource that is set to Yes, the corresponding maximum or minimum value will be included in the analog history display window. This will be the highest/lowest value seen in the preceding 15-minute, day, hour, or week interval. It is based on all values that occurred, not just on periodic samples.
Pmacros
7-65
7.3.119
Format String
This resource is used only by Analog History pmacros, and allows you to customize the column headings. Each column heading is separated by a vertical bar "|". You can control the horizontal justification by using preceding control characters: < for left, > for right, and ^ for center.
Figure 7-62 Analog History Format String
7.3.120
Warn on Execute
This resource in the status colour/symbol pmacro allows you to specify that a warning message is to be displayed between the Open/Close and Execute functions of a control sequence. The warning message identifies the point name, description and the control about to be issued.
Figure 7-63 Dialog for Warning message
Pmacros
7-66
7.4
Pushbuttons
This section describes in more detail how the various types of pushbuttons can be created and used. For completeness of the description, the Pmacro Properties dialogs that are illustrated in this section correspond to instantiated pmacros (i.e. pmacros that have been placed on the map and whose instance-specific data, such as view name or graph number, has been filled in).
7.4.1
View Pushbutton
An example of an instantiated View pushbutton pmacro is shown in (Figure 7-64). In this example, only the following were specified on instantiation: name of the view (ABERDEEN S/S SLD) pushbutton label (AB S/S)
Figure 7-64 Example of View Pushbutton Definition
The symbols used to display the pushbutton are specified by the Symbol 0 and Symbol 1 resources. The scale factor on X- and Y-axis resources are used to magnify the pushbutton symbols independently in either direction. The button label drawing style table, text style and x and y offset resources define how the label will look on the pushbutton. The text of the pushbutton label is defined by the Button Label resource on instantiation. When you click on the view pushbutton, the viewer takes you to the specified view. If the view named in the Button Data resource does not exist, nothing happens when you click on the pushbutton. Worldview for Windows Editors Guide Pmacros 7-67
Right-clicking on a view pushbutton brings up a pop-up menu that offers "Open" and "Open in New Window". Note: Sometimes its convenient to use a bitmap view pushbutton to act as a zoomable photographic background for an area of the map. In order to facilitate the use of such silent pushbuttons, WorldView doesnt display a tooltip for view pushbuttons that have no defined views, nor does it display an error message if such pushbuttons are clicked on when not in edit mode.
7.4.2
Graph Pushbutton
An example of an instantiated Graph pushbutton pmacro is shown in (Figure 7-65). In this example, only the following were specified on instantiation: graph number (12, specified by the Button Data resource) button label (Load and Weather Data)
It is allowed to assign a graph number zero to a pushbutton. Pushbuttons containing graph number zero can also originate from SLDs that have been converted from Qwindows to WorldView
Figure 7-65 Example of Graph Pushbutton Definition
The appearance of the pushbutton in terms of symbols and label characteristics is defined in the same manner as for a View pushbutton. See paragraph 7.4.1, View Pushbutton. How to define graphs is described in Chapter 8, Trend Graphs, of the WorldView for Windows Operators Guide.
Pmacros
7-68
7.4.3
Task Pushbutton
An example of an instantiated Task pushbutton pmacro is shown in (Figure 7-66). In this example, only the following were specified on instantiation: command sequence number (specified by the Button Argument Data resource) task name (specified by the Button Data resource) button label (specified by the Button Label resource)
Figure 7-66 Example of Task Pushbutton Definition
The Task pushbutton does not activate application programs directly. What it does is send run and stop messages to a mailbox whose name is identified by the Button Data resource. In the viewer, when you click on a task pushbutton that has dialog code 0, a Task Activation dialog appears. When you click on Run and then Execute in the Task Activation dialog, a run request is sent to the mailbox. When you click on Stop and then Execute, a stop request is sent. The application must already be activated and must be written to service the mailbox. The run and stop messages that are sent to the task mailbox can contain up to two arguments. If required by the application, the values of these arguments can be specified by the Button Argument resources that are described in paragraph 7.3.14 to paragraph 7.3.17.
Pmacros
7-69
There are a number of SCADA applications that support this task pushbutton interface. These are summarized in Table 7-10. Note that on the VMS SCADA platform, you can write your own applications using the FDB Library API. Table 7-10 SCADA Applications That Support Task Pushbuttons Button Button Button Application Data Argument 1 Argument 2 Run Action Application Command Sequencing (VMS and Windows) Historical Data Collection (VMS only) SEQPRO command sequence # not used Starts the specified command sequence. Takes an immediate sample in the specified dataset. Sheds the specified load. Execute specified command
Application Stop Action Stops the specified command sequence. None.
THIST
dataset #
not used
Load Shed (VMS only) AGC (VMS only)
LSEXEC
load control set # AGC command
not used
Restores the specified load. None.
AGCITF
not used
WorldView does not allow you to run or stop command sequences unless you're logged into an account that has the "Run Command Sequence" right. This applies to both VMS and Windows servers. When you click on a task pushbutton that has a dialog code of 1, a menu is displayed (instead of the Task Activation dialog). The items in this menu correspond to various values of the Button Argument 1 resource. When you click on a menu item, a run command containing the appropriate Button Argument 1 value is sent to the application. In the case of the Command Sequencing application, such menus can be used to allow the operators to initiate any command sequence that is listed in the menu. Or in AGC, such a menu can contain a list of AGC functions that you wish the operators to be able to execute. Details on how to create task menus are given in section 7.5, Menu Files, and more specifically in paragraph 7.5.1, Task Menu.
Pmacros
7-70
7.4.4
Note Pushbutton
An example of an instantiated Note pushbutton pmacro is shown in (Figure 7-67). This pmacro uses a symbol called Light Bulb as the displayed icon. Only the topic needs to be specified on instantiation:
Figure 7-67 Example of Note Pushbutton Definition
When you click on a note pushbutton, a Note dialog appears even if you do not have the Edit Notes right and allows you to view and print the note. The Note dialog displays the current contents of the note, and only if you have appropriate privileges, allows you to modify the contents of the note. The Notes dialog contains right-click copy and paste functions.
Figure 7-68 Note dialog
Pmacros
7-71
7.4.5
Image Pushbutton
An example of an instantiated Image pushbutton pmacro is shown in (Figure 7-69). When you click on an image pushbutton, the image is displayed in a separate window that can be both relocated and re-sized. When resizing, the image's aspect ratio, including any modification made by the X-Y scale factors, is preserved. The image files can be in JPG, GIF or BMP format.
Figure 7-69 Example of Image Pushbutton Definition
You specify the image file by double clicking on the Filename resource and browsing for the desired file. See (Figure 7-70). The following resources specify optional X and Y scale factors to be applied to the image when the image is displayed: Image Scale Factor, X Axis Image Scale Factor, Y Axis
Pmacros
7-72
Figure 7-70 Browsing for Image Files
Figure 7-71 Image Directory
All of the image files referenced by WorldView must be located in a single directory that is specified in the Image Directory portion of the Options dialog. The reason for this is to make it easier for you to maintain your WorldView databases on different computers. If the map contained the complete path to each image file, it would be difficult for you to transfer a map from an operator workstation whose database is on a shared disk drive to a dial-up laptop where the database is on drive C. The image directory is stored in the registry, not in the map. This means that each computer can have its images in a different directory.
Pmacros
7-73
You can pick any directory for your image files. We recommend that you do not use any folder within WorldView's "standard" directory. This is because some of the image files may be quite large, and the convenience of being able to transfer your map database via e-mail or floppy disk in the form of zips of the "standard" folder would be lost if your "standard" folder contained the image files. We suggest that you create a folder called Images within the C:/Program Files/Quindar directory and put your image files there. You can have multiple image windows up at the same time. Each image window can be iconized and dismissed via the usual buttons at the top right corner of the window.
Figure 7-72 Example of Pop Up Image
Pmacros
7-74
7.4.6
External Data Pushbutton
An example of an instantiated External Data pushbutton pmacro is shown in (Figure 7-73). This type of pushbutton allows you to retrieve a record from any OLE DB accessible database on the network and have its contents displayed in a pop-up window. You do not need the Survalent Technology ODBC driver or Excel SCADA Add-in to make use of this feature.
Figure 7-73 Example of External Data Pushbutton Definition
The target database is defined by a Microsoft Data Link file that is specified by the pmacro's Filename resource. The Data Link file, which has a UDL extension, specifies a DSN (Data Source Name), which in turn specifies the location of the database. How to create Data Source Names and Data Link files is described in section 7.6, Creating DSNs and UDL Files. The Filename resource stores only the filename, not the path to the UDL file. The UDL file must be located in the qry folder of the standard directory. If your standard directory doesnt have a qry folder, create one.
Pmacros
7-75
The SQL "select" statement that fetches the desired record is specified by the pmacro's Button Data resource. For example, if you specify: select * from XFRMRS where NAME = '005A' a record whose "NAME" column contains 005A will be retrieved from a table named "XFRMRS", and all columns of that record will be displayed in a Dataview pop-up window. In the pop-up window, each column value is displayed on a separate line, immediately preceded by the column name.
Figure 7-74 Dataview Window Displaying External Data Record
If your select statement is not specific enough, and multiple records are retrieved, only the first record is displayed. A separate instance of this External Data pushbutton is required for each piece of equipment for which you wish to retrieve external data.
Pmacros
7-76
Important In order to use the External Data pushbutton, your PC must have a version of MDAC (Microsoft Data Access Components) that is version MDAC 2.6 RTM (2.60.6526.3) or higher. If your version of MDAC is not high enough, you may encounter an error message, but the data retrieval may still succeed. If you do not have MDAC at all, WorldView will crash when you click on the External Data pushbutton. You can obtain the latest version of MDAC from Microsofts web site. Make sure you download MDAC 2.6 RTM and not MDAC 2.6 SDK (SDK is the developer's kit). During installation of the MDAC update, you may be asked if it's ok to upgrade such things as Internet Explorer. We don't know what you get if you say no. Note that if you have some Microsoft products such as SQL Server on your PC, you may already have MDAC 2.6 RTM.
7.4.7
Report Pushbutton
An example of an instantiated Report pushbutton pmacro is shown in (Figure 7-75). This type of pushbutton allows you to invoke a Microsoft Excel or Query report.
Figure 7-75 Example of Report Pushbutton Definition
The reports and queries that can be brought up in this manner are the same ones that can be accessed from the Reports and Queries tabs of the WorldView Graphs and Reports dialog. Your workstation must have installed on it the Survalent Technology ODBC driver (if connected to a VMS host) or the Excel SCADA Add-in (if connected to a Windows host) in order for you to be able to use this feature.
Pmacros
7-77
The .xls and .qry files that generate these reports and queries must be located in the qry folder of the standard directory. If your connection is to a VMS host, the preparation of such reports and queries is described in chapter 5 of the ODBC Driver and SQL Server User's Guide. For each report or query pushbutton, the filename of the .xls or .qry file to be invoked is specified by the pushbutton pmacro's Filename resource. Although the report pushbutton was intended primarily to invoke files containing queries to the SCADA database, it can be used for other purposes. By selecting the All Files option, you can select any file that is contained in the qry folder, including a Word or PDF document, or a database file such as an Access .mdb file. When you click on the pushbutton, the application that is associated with the file will be invoked.
Figure 7-76 All Files Option in Filename Dialog
If the target file does not contain a query to the SCADA database, you don't need the Survalent ODBC driver or Excel SCADA Add-in installed on your PC.
Pmacros
7-78
7.5
Menu Files
This section describes how to create menus for task activation targets and analog points. The menus are defined by text files located in the wmp folder of the standard directory.
7.5.1
Task Menu
A task menu is a menu of parameters that can be sent to an application. In the case where the "task" is "seqpro" (command sequencing), the menu is a menu of command sequences to activate. In order to have a task pushbutton bring up a menu, you must set the value of the Dialog Code resource to 1. The menu itself is defined in a text file whose filename is specified by the Filename resource. You can create the menu files using Notepad.
Figure 7-77 Task Pushbutton with Menu
When you double-click on the Filename resource, a Filename dialog appears that allows you to browse for the desired menu text file. Although the browser allows you to go anywhere, your menu text files must be located in the "wmp" folder of the "standard" directory within your WorldView database.
Pmacros
7-79
Figure 7-78 Browsing for Menu Files (Figure 7-79) contains an example of the menu that would appear for a menu text file defined as shown below: $title="Reconfigure" $pb_columns=2 26," Normal " 30," T1 and T2 parallel " 28," Shift all load to T1 " 29," Shift all load to T2 "
Figure 7-79 Example of Task Menu File
In the menu text file, the $title keyword specifies the title of the menu dialog. Each subsequent line defines one menu item in terms of a numeric parameter and the text to be displayed for the menu item. In the case where the task is the command sequence processor (Button Data = "seqpro"), the numeric parameters represent command sequence numbers. In this example, when you click on "Shift all load to T1", command sequence number 28 is activated.
Pmacros
7-80
7.5.2
Analog Point Menu
By specifying a dialog code of 1 (Menu) in an analog pmacro, you can assign a menu file to an analog point. In a manner similar to that of the task menu file described above, each line of the menu file specifies a numeric value and a text string. On the map, the "value" that is displayed for the analog point is the text string from the menu file that corresponds to the point's actual numeric value. When you click on the point, the menu appears in a dialog. If you then select one of the menu items, the point's value is set to the menu item's corresponding numeric parameter.
Figure 7-80 Analog Value Pmacro With Menu
As an example, when you click on an analog point to which is assigned the menu file shown below, the dialog in (Figure 7-81) would appear: $title="AGC Mode" $pb_columns=3 $ColorByValue 1,"Tie Line Bias" 2,"Constant Net Interchange" 3,"Constant Frequency"
Pmacros
7-81
Figure 7-81 Analog Point Menu If you select "Constant Net Interchange" from the menu in this dialog, the analog point's value would be set to 2. This feature is useful for handling an analog point whose value is an integer that represents the state or mode of a process. You could use it to control the operation of a command sequence. In the example above, the analog point is used to specify the mode of calculating ACE to an AGC program. ColorByValue, which is not assigned a value, is an optional keyword. If this keyword is present, WorldView colors the analog value (which is a string from the menu file) according to its position in the menu instead of using the points limit state. The colors used for this alternate coloring scheme are taken from a drawing style table that is specified by the same resource used to specify the drawing style table for limit-based coloring. As in the case for task menus, the menu files for analog points must be in the "wmp" folder of the "standard" directory, and can be selected using the same Filename dialog as shown in paragraph 7.5.1, Task Menu. In fact, you can see the AGC mode menu file in the Filename dialog of (Figure 7-78) above (it's called agcmod.txt).
7.5.3
View Menu
A view menu is a menu of any views you like, in any order that could be selected to be displayed. In order to have a view pushbutton bring up a menu, you must set the value of the Dialog Code resource to 1. The menu itself is defined in a text file (.txt), located in the wmp folder, whose filename is specified by the Filename resource of the view pushbutton pmacro. You can create the menu file using Notepad.
Pmacros
7-82
Figure 7-82 View Pushbutton with Menu
As an example, when you click on a view pushbutton to which is assigned the menu file shown below, the dialog in (Figure 7-83) would appear: 1,ABERDEEN S/S SLD,Aberdeen 1,BARTONVILLE S/S SLD,Bartonville 1,CAROLINE S/S SLD,Caroline 1,CENTRAL S/S SLD,Central
Figure 7-83 View Menu In the view menu file, each statement contains up to three comma-separated fields and defines a view. The number at the beginning of the statement is not presently used, but should be set to 1 because a future implementation of WorldView will use these numbers to produce a hierarchical menu. The next field is the actual name of the view. The third field is the name that you want to appear in the pop-up menu. If this third field is absent, the pop-up menu will simply show the actual view name.
Pmacros
7-83
It is also possible to assign Alarm views and Oprsum views to the View pushbuttons. The desired .ALV or .OPR file is specified in the Filename resource.
7.5.4
Report Menu
With a Report pushbutton it is also possible to open a pop-up menu with desired SCADA reports. The menu file format is the same as for a view menu: nn,report_file{,menu_name} As an example, when you click on a report pushbutton to which is assigned the menu file shown below, the dialog in (Figure 7-84) would appear: 1,Scada_MinMax.lnk,MinMax Report 1,Scada_Tags.lnk,Tag Report 1,Scada_opLog.lnk,Operations Log Report 1,Module_History.lnk,Module History 1,Publish_History.lnk,Publish History
Figure 7-84 Report Menu The menu file extension must be ".txt" and the file must be located in the wmp folder. A dialog code of 1 must be assigned to the report pushbutton. The menu file must contain a list of shortcuts to ScadaReports.exe (if Windows SCADA) or ReportView.exe (if VMS SCADA). The shortcuts themselves must reside in the qry folder. (The shortcuts contain references to the SCADA reports in the command lines.)
Pmacros
7-84
7.6
Creating DSNs and UDL Files
This section describes how to create data structures that define locations of databases that may be accessed via External Data pushbuttons.
7.6.1
Creating a DSN (Data Source Name)
A DSN is a thing that defines the location of a database. To create a DSN, invoke the ODBC Data Source Administrator window from the Control Panel.
Figure 7-85 ODBC Data Source Administrator Click on the Add... pushbutton In the Create New Data Source window that appears, select the driver that is appropriate for the desired database.
Pmacros
7-85
Figure 7-86 Create new data Source Window In this example, we're creating a DSN for an Access database. In the ODBC Microsoft Access Setup window that appears, type in the desired name and description of the DSN. In our example, the name is KongSCADA05.
Figure 7-87 ODBC Microsoft Access Setup Dialog Then click on the Select... pushbutton.
Pmacros
7-86
In the Select Database window that appears, browse for the desired database.
Figure 7-88 Select Database
Use the Network... pushbutton if your database is on another computer
7.6.2
Creating a UDL File
A UDL file is a thing that specifies a DSN. You can create a new UDL file by using the shortcut menu. Right-click in the folder where you want to create the UDL file, and after selecting New, select Microsoft Data Link as the file type. If you don't see Microsoft Data Link in the shortcut menu, just create a new Text Document and give the file a UDL extension. Ignore the warning about the change in filename extension possibly making the file unusable
Pmacros
7-87
Double-click on the file you just created. A Data Link Properties dialog will appear, as shown below. In the Provider property sheet, select the appropriate OLE DB provider. For Microsoft Access, choose Microsoft OLE DB Provider for ODBC Drivers. Then click on Next>> (or click on the Connection tab).
Figure 7-89 Data Link Properties Provider Tab The Connection property sheet is context sensitive-it only shows options that are relevant to the provider selected on the previous sheet. In the Connection property sheet, select the "Use data source name" option. Then select the desired DSN from the pop-up menu of DSNs immediately below the "Use data source name" option. For Oracle, you must enter a user name and password in section 2 (see (Figure 7-90)). You can use the Test Connection pushbutton to verify that the database is reachable.
Figure 7-90 Data Link Properties Connection Tab
Pmacros
7-88
Then go on to the Advanced property sheet. The Advanced property sheet only shows options that are relevant to the selected provider. For Oracle or SQL Server, you must enable the access permission for Read. (You don't need to do this for an Access database.)
Figure 7-91 Data Link Properties Advanced Tab Then go on to the All property sheet. The All property sheet provides a summary of the initialization properties for the database connection that you're setting up. You can edit any of the properties directly from this sheet by doubleclicking on the property or selecting the name and clicking the Edit Value button. For Oracle, you must set the Persist Security Info property to True. You do not need to change anything else. The value of the Data Source name appears automatically. So do Password and User ID if you entered them on the Advanced property sheet.
Figure 7-92 Data Link Properties All Tab When done, click on OK to close the Data Link Properties dialog. Now all you have to do is put the UDL file into your WorldView "qry" directory.
Pmacros
7-89
7.7
Missing Resource Check
When a map is opened, and resources such as pmacros are found to be missing, WorldView generates a "Missing Resource" report to show you whats missing. The report is contained in a log file created in the wmp folder. The name of the log file is the name of the map. The "Missing Resource" report shows, for each missing resource, the name of the first object in the map that references the missing resource (e.g. the name of the pmacro if a pmacro resource is missing). If a missing resource is referenced by a text string object, the report displays the string value (which you can find using the Find function).
Figure 7-93 Missing Resource Error Window The log file is overwritten each time Worldview starts (in order to avoid having it grow indefinitely). It therefore only contains information about the most recently detected missing items. A sample of the log file is shown below:
Missing Resources Report C:\Program Files\Quindar\Maps\Hamilton\Standard\Wmp\Hamilton.wmp 15/04/2005 12:42:24 Resource Name Resource Type # Refs ===================================================================== STANDARD_YELLOW DRAWING_STYLE 10682 ----------------------------------------------------------------------WDrawString 67 WDrawPoint 9042 WDrawSymbol 802 WDrawPmacro 493 WDrawArc 278
If the map contains missing objects (e.g. pmacros that do not exist), its important to not save the map until the missing objects have been recovered. If you do save the map, the map will be saved without the missing objects, and then it will be too late to fix. If the map contains objects that themselves have references to missing resources (e.g. a pmacro or symbol that references a missing drawing style), the missing resources will be either not be displayed or will be replaced by defaults. But the objects themselves will remain in the map even if the map is saved.
Pmacros
7-90
If you bring up the resource editor for a resource that contains references to missing resources, the editor tries to show as much of the resource as possible so that you can make corrections if you decide to not try to recover the missing resources. For example, when the symbol editor displays a symbol that contains components in non-existent drawing styles, the editor displays those components in the dynamic drawing style (which is displayed in white). If the symbol contains a text string in a non-existent text style, the text string is not displayed. But when you click on the text string, a selection rectangle is displayed showing the original extent (when the text style did exist), and you can edit the text object and choose a new text style.
7.8
Sharing Resources With Other Users
Sharing of resources such as WorldView symbols, pmacros and control panels can be done in a user-friendly manner by using the Export and Import functions.
7.8.1
Export Object
In order to export a symbol, pmacro or control panel, go into Edit mode in WorldView, and in the Library Selector dialog, right-click on the desired object. You will see the Export function in the right-click menu.
Figure 7-94 Export Object
Selecting the Export function causes WorldView to export the object, and all the resources it uses, into a zip file, where the zip filename consists of a prefix, underscore, object name, underscore, and the object type (SYMBOL, PMACRO or CPANEL). The output zip file is placed in the WorldView root directory (i.e. the directory that contains the standard folder). Both the object itself and all of its resources will also have the prefix at the front of their names. In the case of a control panel, the Export function follows all the pushbuttons to other pages of the control panel and includes all pages of the control panel in the output zip file. So its not necessary to export every page. Just export the first page. The main purpose of the prefix in the object and resource names is to avoid conflicts with resources of the same name that already exist in someone elses database. In Windows SCADA, before you are allowed to export, you must first enter an identifying prefix into the Share Resource Prefix field at the bottom of the WorldView page of the System Parameters editor (SCADA Explorer). WorldView attaches this prefix to all objects and resources that it Worldview for Windows Editors Guide Pmacros 7-91
exports. It does this in order to: 1) identify who the files came from, and 2) avoid conflicts if multiple people export resources with the same name.
In VMS SCADA, the prefix is defined by a logical name. Call Survalent customer service to have this set up for you. All WorldView objects provided on the Survalent web site contain the prefix STC in the object names.
7.8.2
Import objects
To import an object, go into Edit mode, and go to any of the three libraries mentioned above (symbol, pmacro or control panel), right-click anywhere and select the Import function. An Import Shared Resources dialog appears to allow you to browse for the desired zip file to import. After importing all the zip files you want, restart WorldView. No need to do a Save. Note: Its not necessary to have a prefix defined in order to do imports. The resources in the zip file are organized by their appropriate folders (syl, pml etc), but theyre stored in text format. So its not possible to unpack the zip files manually. You must use the Import function (which converts the text files back into binary).
Pmacros
7-92
8 Map Editing
This chapter describes how to use the pull-down menus and button bars in a map window to edit a map. Only the menus that contain editing functions, and only the editing functions in these menus, are described. Similarly, in the button bars, only the buttons used for editing are described. Non-editing menus and functions are described in the WorldView for Windows Operators Guide.
8.1
File Menu
The File menu is illustrated in (Figure 8-1). Only the items relevant to editing are described below. The other functions are described in the WorldView for Windows Operators Guide.
Figure 8-1 File Menu
Map Editing
8-1
8.1.1
New Map
When you select this function, an empty map window appears within the main WorldView window, in which you can draw stuff from scratch, as we did in Chapter 3, Getting Started. Or you can import a map from a DXF file as described in Chapter 9, Importing Maps.
Figure 8-2 New Map Window
Map Editing
8-2
8.1.2
Open
This function brings up an Open dialog that allows you to select a file to open. Select the map you wish to open and then click on Open. A map window containing the desired map will appear.
Figure 8-3 Open A Map
The Open dialog defaults to files of type Map (*.wmp) and sub-folder Wmp. If you wish to open something else, then choose a different file type (e.g. Alarm View (*.alv) or Symbol (*.syl)), and if necessary, a different sub-folder, before clicking on Open.
Figure 8-4 Opening an Existing Map
Map Editing
8-3
8.1.3
Import
This function is used to import maps from either DXF files or WorldView text files. This is described in Chapter 9, World Map Import.
8.1.4
Export
This function is used to export maps (or libraries) to WorldView text files. This is described in Chapter 9, World Map Import.
8.1.5
Portable Map Export
This function is used to export complete maps as a text file. This is described in Chapter 9, World Map Import.
8.1.6
Save
This function saves the map youre currently working on. If the map is a brand new map that has never been saved before, then a Save As window appears to allow you to name the new map. See paragraph 8.1.7, Save As. If you attempt to exit WorldView without saving your changes, you will be prompted to save your changes before the program exits.
Figure 8-5 Prompt To Save Changes
8.1.7
Save As
The Save As function saves the current map under a new name. The Save As window that is displayed contains a File name data entry field in which you type in the desired file name. If you want to save the map under an existing name, thereby overwriting the existing map, you can click on the existing file name. Clicking on the Save button in the Save As window saves the map.
Figure 8-6 Save As Window
Map Editing
8-4
8.1.8
Reservations
This function is used to exclusively reserve the WorldView database (i.e. the map and all of the resource files) so that only you can edit it. This is described in section 10.1, Change Control With Reservations.
8.1.9
Publish LSs
This function is used to publish line sections to the online directories of both host computers. It need only be used after you have edited line sections. Line sections define the topology of a network (electric, gas and/or water) that is represented in the map. The line section data is used by a topology processor to calculate the network connectivity. The calculated connectivity data allows WorldView to dynamically color the line sections to show you what parts of the network are energized/pressurized. Line section editing is an extension of the map editing function of WorldView, and is described in the following document: System Configuration Status Users Guide (document number SCS-300)
8.2
Edit Menu
The Edit pull-down menu is illustrated in (Figure 8-7).
Figure 8-7 Edit Menu The functions contained in this menu are mostly duplications of the tools you can access either through the tool bar or through a pop-up menu that appears when you right-click on an object in the map.
Map Editing
8-5
Only the items relevant to editing are described below. The other functions are described in the WorldView for Windows Operators Guide.
Figure 8-8 Pop Up Menu Obtained on Right Click on an object
8.2.1
Undo / Redo
The Undo function, accessible from the Edit menu and via the standard Ctrl-Z keyboard equivalent, checkpoints the before state of each object that is modified during an edit session. The list of checkpoints allows Undo to step back through the modifications, and allows Redo to step forward again to re-create the modifications. The size of the Undo list is 99. A separate Undo list is maintained for each document (map, control panel or symbol). When the edited document is saved, its entire Undo history is discarded. The checkpoints that are recorded (and therefore the actions that can be undone) include: insert (draw), delete, move, resize, recolor, restyle and relayer. Cut and Paste is also undoable, although the content of the clipboard before the Cut is not restored. Operations performed using the Alignment tools can be undone and redone, as well as certain edits of groups (with the exception of delete).
8.2.2
Cut
Selecting Cut while one or more objects in the map are selected causes the selected objects to be deleted from the map and copied to the Windows clipboard. Each new Cut or Copy overwrites the previous contents of the clipboard. There is a tool bar equivalent to the Cut function. The Ctrl-X keyboard equivalent also works.
8.2.3
Copy
Selecting Copy while one or more map objects are selected causes the selected objects to be copied to the Windows clipboard. The objects in the map are not disturbed. Each new Cut or Copy overwrites the previous contents of the clipboard. There is a tool bar equivalent to the Copy function. The Ctrl-C keyboard equivalent also works.
Map Editing
8-6
8.2.4
Paste
When you select Paste, the mouse pointer becomes accompanied by an outline of the last thing that you cut or copied to the clipboard. The outline follows the mouse pointer wherever you move it until you click. Where you click is where the contents of the clipboard will be pasted. There is a tool bar equivalent to the Paste function. The Ctrl-V keyboard equivalent also works. Because you can select many objects at once (by drawing a selection rectangle around the desired objects), and you can copy all of the selected objects to the clipboard at once, replication of complex entities in your map is quite an easy task. Even complete substations can be replicated. (Figure 8-9) shows the substation of (Figure 8-4), zoomed out somewhat, and having been selected and copied in its entirety to the clipboard, being pasted in its entirely to the left of it. The contents of the clipboard can be pasted as often as you wish. Note that you cannot paste objects into your WorldView map from other Windows applications. You can, however, copy and paste between multiple map windows within WorldView.
Figure 8-9 Pasting a Substation
8.2.5
Clear
Selecting Clear while one or more objects are selected causes the objects to be deleted from the map but not copied to the clipboard. The existing contents of the clipboard are not disturbed. Unlike Cut, you cant undo this function via a Paste.
Map Editing
8-7
8.2.6
Find
While you are in Edit mode, the Find function can locate objects in the map for you, just as it does in operating mode. Points, notes, and line sections can all be located by name, as well as background text. Refer to WV200, WorldView for Windows Operators Guide for more information. In the Find Text function, theres an option that allows you to replace all matching text strings by another string. You must be in Edit mode to use this. In the Find dialog for Text, you will see: Replace with: text field Replace pushbutton - this causes the found string to be replaced Replace/Next pushbutton - this causes the found string to be replaced and find the next instance of the string Replace All pushbutton - this causes all instances of the string to be replaced
Figure 8-10 Find and Replace Text
8.2.7
Modify
The Modify function brings up dialogs that allow you to modify the properties of the selected object. Because there are different dialogs for different types of objects, the Modify function cannot be used when several objects are selected at the same time. If the object you want to modify is part of a group, you can to use the Select Member function to access only the desired object. See paragraph 8.2.8, Group, and the discussion of object selection in section 8.7, Edit Bar.
8.2.8
Group
The Group function allows you to group selected objects together to make them more convenient to manipulate. To group objects together, use the Select tool in the Edit bar and enclose the objects in a selection rectangle, or alternatively, click on each desired object while holding down the control (Ctrl) key.
Map Editing
8-8
Next, select the Group function, and from the submenu that appears, select Group again. The objects will now be grouped. When you click on a group, the editor highlights your selection by one selection rectangle encompassing all of the objects in the group. In a selection rectangle for a group, the handles are colored magenta instead of yellow. In (Figure 8-11), all of the circuitry on the right side of the substation had been grouped and is now selected.
Figure 8-11 Grouped Half of Substation
Another purpose for grouping objects together is to associate multiple objects to a segment or line section. Segments are described in paragraph 8.8.2, Segment. Line sections are described in the System Configuration Status Users Guide.
8.2.9
Ungroup
This function ungroups the objects that had previously been grouped together. To ungroup a group, select the group by selecting any object in the group, and then select the ungroup function.
Map Editing
8-9
The editor will not allow you to ungroup a group that has been assigned to a segment or line section. The Ungroup function is insensitive if the group that you have selected is associated with a segment or line section. You must break any such association before you can ungroup the group.
8.2.10
Alignment
This function brings up a pop-up menu shown in (Figure 8-12) with options to align the selected objects, evenly space and make the selected objects the same size, width and height.
Figure 8-12 Alignment Menu
There is also an equivalent alignment toolbar that can be obtained via the alignment pushbutton in the Edit toolbar. 8.2.10.1 Left This function aligns the left edge of the selected objects. 8.2.10.2 Right This function aligns the right edge of the selected objects. 8.2.10.3 Top This function aligns the top edge of the selected objects. 8.2.10.4 Bottom This function aligns the right edge of the selected objects. 8.2.10.5 Center Vertical This function aligns the selected objects centered vertically. 8.2.10.6 Center Horizontal This function aligns the selected objects centered horizontally. 8.2.10.7 Spaced Vertical This function evenly spaces the selected objects vertically.
Map Editing
8-10
8.2.10.8 Spaced Horizontal This function evenly spaces the selected objects horizontally. 8.2.10.9 Distribute as Matrix This function allows you to distribute the selected objects in a matrix of rows and columns. When choosing this option, a dialog shown in (Figure 8-13) appears giving you two spacing options.
Figure 8-13 Matrix Alignment Dialog Auto Spacing (Preserves Order) This function evenly spaces the selected objects within the rectangle that contains all of the objects. You have to specify the number of elements desired in each row or column. WorldView then aligns the objects accordingly. In order to be able to preserve the order of the objects, WorldView assumes that the objects are already approximately correctly arranged, just not perfectly aligned. If an object is so far out that WorldView cannot decide where to put it, it leaves the object where it is.
Manual Spacing (Does Not Preserve Order) This function evenly spaces the selected objects according to a grid that you specify in world units. As above, you have to specify the number of elements desired in each row or column. The origin of the grid can chosen to be either the Top-Left corner or the Bottom-Left corner of the selection rectangle. If you select Top-Left, the grid extends rightwards and downwards. If you select Bottom-Left, the grid extends rightwards and upwards.
Map Editing
8-11
8.2.10.10 Same Height This function allows you to make the selected objects the same height as the: maximum height object, or minimum height object 8.2.10.11 Same Width This function allows you to make the selected objects the same width as the: maximum width object, or minimum width object 8.2.10.12 Same Size This function allows you to make the selected objects the same size as the: biggest object, or smallest object
8.2.11
Change Station
This function allows you to change the station name of all the points in a group of pmacros. Select a group of objects (drag a rectangle around them, or hold Ctrl and click on each one), right-click and choose Change Station from the menu. In the Change Station dialog that appears, use the browse buttons to select the station that you wish to change from and the station that you wish to change to. When you click on the Rename button, all point names on the old station are changed to corresponding points on the new station. Note that it is the point names in the selected pmacros that are changed, not the points themselves. Selected objects that are not pmacros are not affected. On completion of the operation, the Change Station dialog reports how many pmacros were modified, how many were not modified because their points were not on the old station, and how many could not be modified because the corresponding points were not found on the new station.
Figure 8-14 Change Station
8.2.12
Front
This function causes the selected object(s) to be placed in front of all other objects that are in the same layer. The selected objects that move to the front will block out objects that are behind them. Unfilled objects are transparent: only the lines of these objects will block out other objects. Worldview for Windows Editors Guide Map Editing 8-12
8.2.13
Back
Use this tool to place the selected object(s) behind all other objects. Select an object(s) and then select Edit, Back. The selected objects will move to the back and be blocked out by objects in front of them. Unfilled picture objects are transparent. Only the lines of these will block out the objects moved to the back.
8.2.14
Recolor
Recolor applies the current drawing style to the selected objects. To use this function, select a drawing style from the Drawing Styles tab in the Library Selector. Then select the object(s) to be recolored and then, from the Edit menu, select Recolor. Alternatively, you can right click on any of the selected objects, and select Recolor from the pop-up menu. You can recolor all graphics primitives (basic shapes). You can also recolor the parts of symbols that are drawn in the {dynamic} drawing style. You cannot recolor the other parts of symbols from the map editor. Recoloring the non-{dynamic} parts of an existing symbol may only be done from the symbol editor. Note that this will affect all instances of the symbol in the map. If a symbol being edited contains other symbols, only the {dynamic} parts of those other symbols can be recolored.
8.2.15
Restyle
This function applies the current text style to the selected text string objects. To use this function, select one or more text objects, select a text style from the Library Selector, and then select Restyle from the Edit menu. The selected text will be given the font, type and size of the selected text style.
8.2.16
Relayer
This tool can be used to move the selected object(s) to the currently selected layer. First, select a layer using the Layers button. See section 8.10, Layers, for further details. Select one or more objects, and then select Relayer from the Edit menu (or right-click and select Relayer from the pop-up menu). This will move the selected object(s) to the selected layer.
8.2.17
Nudge Functions
The Nudge functions can be used to nudge the positions of one or more selected objects Up, Down, Left or Right, After selecting one or more objects, select the desired direction from the Edit menu or by operating the arrow keys. There is no Undo for nudge operations.
8.2.18
Select Member
If the object you want to modify is part of a group, you can use the Select Member function to access only the desired object. This function is accessible through a pop-up menu that appears when you right-click on an object in the map. This function is described in paragraph 8.8.3, Select Member.
Map Editing
8-13
8.3
View Menu
(Figure 8-15) illustrates the View menu.
Figure 8-15 View Manu Only the items relevant to editing are described below. The other functions are described in the WorldView for Windows Operators Guide.
8.3.1
Edit Bar
Selecting this function toggles WorldView between view mode and edit mode. You must be logged into a privileged SCADA account in order to be able to go into edit mode, and you must be in edit mode in order to do any editing. When you go into edit mode, an Edit bar of edit buttons appears. The Edit bar is described in section 8.7, Edit Bar. The Edit bar is removed when you return to view mode. There is a navigation bar equivalent for this menu function. Its called the Edit button. See paragraph 2.2.6, Navigation Bar.
8.3.2
Edit Tools
The Edit Tools function is a toggle button that either displays or hides the edit toolbar. The Edit button in the navigation bar does the same thing. The Edit bar is described in section 8.7, Edit Bar.
8.3.3
Alignment Bar
The Alignment function is a toggle button that either displays or hides the alignment toolbar when you are in Edit mode. There is an Edit toolbar equivalent for this menu function. It is called Toggle Alignment pushbutton. Worldview for Windows Editors Guide Map Editing 8-14
8.3.4
Background Images
This toggle function allows you to turn on or off background images in a map.
8.3.5
Tree Lists
This function brings up the Views and Layers window shown in (Figure 8-16). The Views and Layers window contains four tabbed panes. The one labeled Views shows a list of all of the views that are defined in the map. From this pane, you can create, modify and delete views. You can also organize your views in a hierarchical fashion via folders and sub-folders. Details about creating and maintaining views are provided in section 8.9, Views.
Figure 8-16 Views and Layers Window The pane labeled Layers shows a list of all of the layers that are in your map. From this pane, you can create, modify and delete layers. From here, you can also set each layer into either automatic or manual declutter mode. For each layer, you can specify the auto-declutter zoom limits to be used for when that layer is in autodeclutter mode. Like views, layers can be organized hierarchically in folders and sub-folders. Although each layer must have its own declutter limits, it is possible to toggle entire folders of layers between automatic and manual declutter mode in a single operation. The pane labeled Layer Drawing Order shows the order in which the layers are drawn. Within each layer, the elements contained in that layer are drawn in the order in which you put them into the map. You can override this order by using the Front and Back functions described in paragraphs 8.2.12, Front, and 8.2.13, Back. You can also specify the order in which the layers themselves are to be drawn by editing the list contained in the Layer Drawing Order pane. This gives you lots of control over the display of overlapping objects in your map. The Feeders pane shows all your feeders, organized first by station transformer and then by substation transformer, and allows you to enable or disable display of feeders. This is described in the WorldView for Windows Operators Guide.
Map Editing
8-15
A button bar equivalent for the Tree Lists function is available in the navigation bar. A detailed description of how to create and manage layers is provided in section 8.10, Layers.
8.3.6
Library Selector
This function brings up the Library Selector window shown in (Figure 8-17). The Library Selector is a multipaned window that shows all of the WorldView components that can be used in your map. This includes drawing styles, text styles, symbols and pmacros. The creation and use of all of these components have been described throughout this document. A button bar equivalent for the Library Selector function is available in the Edit toolbar. This function is only available when you are in edit mode. The function in the menu is dimmed if you are in view mode.
Figure 8-17 Library Selector Window
Map Editing
8-16
8.4
Map Menu
The Map menu is shown in (Figure 8-18)
Figure 8-18 Map Menu It contains four functions that are described below.
8.4.1
Set Extent
This function brings up a dialog that allows you to override the extent of the map. To change the extent, set the mouse pointer to where you want the lower left corner and record the coordinates. Repeat for the upper right coordinates. Then access the Set Map Extent dialog and enter these coordinates.
Figure 8-19 Set map extent Dialog
The extent of the map is the smallest rectangle that completely encompasses everything thats in the map. The Current pushbutton allows you to adjust the extent of the map by panning and zooming to the desired view and then just clicking on the Current button.
8.4.2
Set Grid
This function brings up a Grid dialog that allows you to define a grid and turn it on and off. The grid allows graphics and library components to be accurately placed and sized on the map.
Map Editing
8-17
If you uncheck Grid Visible, the grid will not be displayed even when its enabled. Even though you cant see the grid in this case, you can still feel the effects of the grid in that objects and endpoints appear to jump from grid-point to grid-point as you move the mouse.
Figure 8-20 Grid Dialog The grid is defined in world units in terms of both spacing and offset, both of which can be specified independently for the horizontal (X) and vertical (Y) directions. (Figure 8-21) illustrates a visible grid. If the grid spacing corresponds to less than a few pixels, it is not displayed even if the Grid Visible check box is checked.
Figure 8-21 Example of Visible Grid
8.4.3
Optimize Map
WorldView contains a function that reorganizes the storage of the map so as to optimize the speed at which that map can be redrawn when you navigate.
Map Editing
8-18
Values of approximately 100 have been found to produce dramatically improved display response times for large maps.
Figure 8-22 Optimize Map Dialog The storage reorganization is based on variable-sized tiling. The optimization threshold is the number of elements to be placed in each tile. Very large values of the optimization threshold produces very large tiles and hence little optimization. Very small values of the optimization threshold, on the other hand, cause so many tiles to be produced that the speed improvement is outweighed by the overhead of tile management. In the present implementation of WorldView, repeated use of the Optimize Map function produces diminished results. For now, its best to use it just once immediately after DXF import.
8.4.4
Layer Statistics
This function allows you to obtain a report on the contents of the map. The report is produced in a text file that you name. Included in the report file are: the map extent, a list of all the layers, and for each layer, the number and extent of the graphics contained in that layer. At the end, the report indicates the total number of graphics primitives and layers that are contained in the map. Invoking the Layer Statistics function brings up the Save As dialog to allow you to specify the name and directory for the report file.
Figure 8-23 Save As Window for Layer Statistics Report File
When you click on Save, the report file is produced. The report file for the small station map shown in (Figure 8-4) is shown in (Figure 8-24).
Map Editing
8-19
Figure 8-24 Layer Statistics Report File
8.4.5
Grid Enabled
This function makes toggling the grid on or off more convenient during editing. A Ctrl+G keyboard equivalent is provided, and a button bar equivalent for the Grid Enabled function is available in the Edit toolbar. This function is only available when you are in edit mode. The function in the menu is dimmed if you are in view mode.
8.5
Tool Bar
The editing functions that are contained in the Tool bar have already been described for their menu counterparts in section 8.1, File Menu, and 8.2, Edit Menu. The non-editing functions are described in detail in the WorldView for Windows Operators Guide. They will just be listed here.
New Window Open Save Cut Copy Paste Print
Open a window with same contents as active window Open a file Save symbol, pmacro or map Cut object(s) from the map and copy to the clipboard Copy object(s) to the clipboard Copy items from the clipboard onto the map or symbol Print
Map Editing
8-20
8.6
Navigation Bar
The navigation bar contains some functions related to editing. Only the editing functions are described below. The non-editing functions are described in the WorldView for Windows Operators Guide.
Layers Views and layers List Edit Mode
Open the Layers drop-down menu Open the Views and Layers pop-up window Toggle edit mode and edit bar
8.6.1
Layers
This function brings up a drop-down menu containing the directory structure of the layers. To select a layer to draw in, locate the desired layer by navigating through the structure and then click on the Select item.
Figure 8-25 Selecting a Layer
The two other options, Visible and Auto Declutter, are used to control the declutter mode. Clicking on Visible takes the layer out of automatic declutter mode, places it in manual mode and if the layer was previously invisible by virtue of being auto-decluttered off, makes the layer visible. The next time you look at this layer, the check mark beside Auto Declutter will no longer be there (indicating that the layer no longer auto decluttered) and a check mark appears beside Visible. If you subsequently toggle the Visible option off, the layer is not placed back into auto declutter mode. To place the layer back into auto declutter mode, you can click on the Auto Declutter option. Clicking on Select sets that layer active for editing, each layer has its own Auto Declutter settings. Only one layer can be selected at a time. The selected layer will have a checkmark beside Select for that layer. This is the only way to determine after the fact which layer is selected for editing. Therefore if you are editing a world map with a large number of layers, it is recommend that you make a record of each layer as you select it. See section 8.10, Layers, for more details on layers.
Map Editing
8-21
8.6.2
Views and Layers Lists
This performs the same function as the Tree Lists item in the View menu. See paragraph 8.3.5, Tree Lists.
8.6.3
Edit Mode
This toggles between edit mode and view mode, and is equivalent to the Edit Bar item in the View menu. See paragraph 8.3.1, Edit Bar.
8.7
Edit Bar
The Edit bar contains drawing tools that allow you to select the type of graphics that you wish to place on the map. The edit bar is only available when you are in edit mode and appears automatically when you go into edit mode.
The contents of the edit bar are described below.
8.7.1
Select
The Select tool allows you to select objects that are already in the map. After selecting this tool, place the tip of the mouse pointer over the object you want to select and then click. If you left-click, the object will be highlighted by a selection rectangle that contains eight yellow handles.
You can: move the selected object by dragging it to the desired location delete the object by pressing Shift + Delete resize the object in the horizontal direction by clicking on either the left-middle or right-middle handle and dragging the handle to the left or the right resize the object in the vertical direction by clicking on either the top-middle or bottom-middle handle and dragging the handle upwards or downwards resize the object in both directions at once by clicking on any corner handle and moving diagonally
Map Editing
8-22
If you right-click, a pop-up menu of functions to perform on the selected object will appear. With the exception of Select Member, these functions have counterparts in the Edit pull-down menu and are described in section 8.2, Edit Menu. If you double-click on an object, WorldView reacts as though you had selected it, right-clicked, and chosen Modify. The Modify function brings up a Properties dialog of a type that is appropriate to the selected object. These dialogs allow you to review the definition of the object as well as make changes, and are described below with the appropriate drawing tool.
Figure 8-26 Pop up Menu
The Select Member function allows you to select an individual object that is part of a group. This is described in section 8.8, Groups, and in particular, paragraph 8.8.3, Select Member. You can select multiple objects simultaneously by using the mouse to drag a box around the objects you want to select. The objects will be highlighted individually by dimmed selection rectangles and in their entirety by one active selection rectangle that encompasses all of the selected objects. See (Figure 8-9) for an example of this. The objects must be fully inside your selection box to become selected. Furthermore, only objects that are visible (not decluttered off) will be selected. When multiple objects are selected, the individual selection rectangles are not active (i.e. you cant click on any of their handles to manipulate individual objects). The main selection rectangle that surrounds all of the selected objects is partially active: The entire set of selected objects can be moved by dragging the mouse in the same way as for a single object. The corner handles can be used to resize the entire set of objects together but only so constrained as to not change the aspect ratio of the object set. The top-middle, bottom-middle and side-middle handles are not active. The Modify function in the pop-up menu that appears when you right-click is not active (because the required Properties dialog is not unique). The other functions in the pop-up menu, such as Recolor, Restyle, Relayer, Cut etc can be used, however.
The constrained re-size action described above for selections of multiple objects also applies to symbols and pmacros. If you wish to change the aspect ratio of symbols or pmacros, you can do so by editing their X and Y Scale Factor attributes using the appropriate Properties dialogs (which you can access via the Modify pop-up function). Note: The "escape" key can be used to cancel a current selection of an object in the map. Map Editing 8-23
8.7.2
Library Selector
This performs the same function as the Library Selector item in the View Menu. See paragraph 8.3.6, Library Selector.
8.7.3
Toggle Grid
This performs the same function as the Library Selector item in the View Menu. See paragraph 8.3.6, Library Selector.
8.7.4
Toggle Alignment Toolbar
This pushbutton brings up an object alignment toolbar described bellow.

Align the right edge of the selected objects
Align the top edge of the selected objects
Align the bottom edge of the selected objects Align the selected objects centered vertically
Align the selected objects centered horizontally
Align the left edge of the selected objects
Make the selected objects the same height as the: -maximum height object -maximum width object -biggest object
Evenly space the selected objects vertically
Evenly space the selected objects horizontally
Distribute the objects in a matrix of rows and columns Make the selected objects the same height as the: -minimum height object -minimum width object -smallest object
8.7.5
Line
This tool allows you to draw lines. After selecting this tool, move the mouse pointer to where you wish to start a line, hold the mouse button down and drag the mouse to create the line. Holding down the shift key as you do so will make your line either perfectly horizontal or vertical.
Map Editing
8-24
As is the case when adding any object to the map, make sure youve selected the desired layer into which you want the object to go. You can do this by using the Layers drop-down menu (described in paragraph 8.6.1, Layers) or the Layers pane of the Views and Layers window (described in section 8.10, Layers). Also, if youre adding graphics primitives such as lines, shapes or text strings, make sure you have selected the desired drawing style, and in the case of text, the desired text style. You can do this via the Library Selector.
8.7.6
Modifying Line Properties

If you right-click on a line and select the Modify function, a Point Properties window appears showing the properties of the selected line. The Point Properties dialog identifies the layer and drawing style of the selected line. To change these, use the Relayer and Recolor functions.
Figure 8-27 Point Properties Dialog for Line The Point Properties dialog also shows the coordinates of the start and end points of the line, as well as an empty check box named Filled. You can modify any of the coordinates by double-clicking on them in the Point Properties Dialog. An X-Y Coordinates dialog appears to allow you to modify the selected coordinates.
Figure 8-28 X-Y Coordinates Dialog Note that you cannot add coordinates to a line. You can only modify them. By clicking on Apply, you can see the changes you have made before you dismiss the Point Properties dialog. You can use Undo to revert back to what you have in the Point Properties dialog. There is no undo after you dismiss the Point Properties dialog. Checking the Filled box has no effect on a straight line. Well see its uses later with other objects. (The Point Properties dialog is used with rectangles and polylines as well as with individual lines. A rectangle or polyline contains a list of coordinate pairs that correspond to each vertex of the object plus one more: the very last coordinate pair is a repeat of the first coordinate pair.)
Map Editing
8-25
8.7.7
Rectangle
This tool allows you to draw unfilled rectangles. After selecting this tool, move the mouse pointer to one corner of where you wish to create the rectangle, hold the mouse button down and drag the mouse to the opposite corner. Holding down the shift key as you drag will make your rectangle a perfect square.
8.7.8
Filled Rectangle
This tool allows you to draw filled rectangles in the same manner as described above for unfilled rectangles.
8.7.9
Modifying Rectangle Properties

If you right-click on a rectangle and select the Modify function from the pop-up menu, a Point Properties window appears showing the properties of the selected rectangle. This is the same Point Properties dialog that we saw in the previous paragraph for lines, except that there are now five coordinate pairs instead of two (the last one is a repeat of the first one). The coordinates can be modified in the same manner as described for lines. The editor will not prevent you from completely distorting the rectangle by changing the coordinates of its vertices.
Figure 8-29 Point Properties Dialog for Rectangle
The Filled check box, which shows whether the rectangle is presently filled or not, can be toggled to turn an unfilled rectangle into a filled rectangle and vice versa.
8.7.10
Ellipse
This tool allows you to create ellipses. After selecting this tool, you create the ellipse by defining a bounding box (rectangle) that would contain the ellipse. Click on one corner of this bounding box, hold the mouse button down and drag the mouse to the opposite corner of the bounding box, and then release the mouse button. Your ellipse will be created inside the invisible box that you just defined. Holding down the shift key as you drag the mouse causes your ellipse to be a perfect circle.
Map Editing
8-26
8.7.11
Filled Ellipse
This tool allows you to draw filled ellipses in the same manner as described above for unfilled ellipses.
8.7.12
Arc
This tool allows you to draw an arc. Move the mouse pointer to one corner of where you wish to create your arc, hold the mouse button down and drag the mouse to the opposite end of the arc. Your arc will default to being of an ellipse, or 90 of a circle.
8.7.13
Filled Arc
This tool allows you to draw a filled arc in the same manner as described above for an unfilled arc. Select your Filled Arc and open the Arc Properties Dialog box, shown below in paragraph 8.7.14. You will see the Layer and Drawing Style you selected, the co-ordinates of the Ellipse points that the Arc is part of, the Start angle and Angle total, the mode and the style. You can convert your Arc to an ellipse or longer or shorter arc by changing the Angle values, e.g. change 90 to 180 degrees and get half an ellipse. You can change to a nonfilled are.
8.7.14
Modifying Arc Properties

If you right-click on an ellipse (or any arc) and select the Modify function from the popup menu, an Arc Properties dialog appears for the selected ellipse. The Arc Properties dialog identifies the layer and drawing style of the ellipse. You can modify these by using the Relayer and Recolor functions.
Figure 8-30 Arc Properties Dialog The X-Y coordinates shown in the Arc Properties dialog are the coordinates of the arcs bounding box. The first set of coordinates is that of the top left corner of a box that would surround the ellipse. The second set of coordinates is that of the bottom right corner of the bounding box. The coordinate values can be edited. Arcs, ellipses, and circles are all handled the same way in the Arc Properties dialog. If you draw an arc and check its XY coordinates, you will find that the corners of the bounding box that you used to draw the arc are not at the coordinates shown in the Arc Properties dialog. This is because an arc is
Map Editing
8-27
considered as part of an ellipse, and the XY coordinates that are stored are those of a bounding box for the complete ellipse. The Start Angle and Angle Length fields in the Arc Properties dialog allow you to convert an ellipse to an arc and vice versa, and to modify the orientation of an arc. The value of Start Angle for all ellipses defaults to zero. Arcs created from left to right have a starting point of 0, and arcs created from right to left have starting points of 180. The value of Angle Length for all ellipses is 360. The angle of arcs defaults to 90 as shown in the diagram. The diagram in (Figure 8-31) shows the location of the angles in an ellipse, with 0 on the right edge of the horizontal plane of the ellipse, and the angle being measured in a counter clockwise direction. The coordinates inside the circle are what you will find on any arc you create. By modifying the Start, Angle, and XY co-ordinates, you can precisely control the shape and placement of an ellipse or arc. Figure 8-31 Start, Angle for Arcs
You only need to modify the Start Angle and Angle Length of Arcs. If you change the Start Angle of an Arc to 180 and the Angle Length to 180 and click apply, you will get the bottom half of an ellipse. Changing the Angle Length to 270 will change its appearance to of a pie. All Ellipses and Circles are 360 but changing the Angle will change them to part ellipses or Arcs. In the Arc Properties dialog, there is also a Mode and Style selection. There are three Modes and two Styles which control how your ellipse will appear. Filled is self-explanatory. Closed causes the ends of the arc to be joined, but Open does not join the ends of the arc. Style affects the appearance of the open part of your arc. Pie indicates that your arc will be joined by two lines from the ends of the arc joined at the center of the arc. Chord indicates that one line will be drawn between the ends of the arc. Table 8-1 illustrates how an ellipse would change as the Start, Angle, Mode and Style fields are modified.
Map Editing
8-28
Table 8-1Modifying the Properties of an Arc Angle Mode Style Ellipse Start 1 0 360 Open Pie
Appearance
-45
270
Open
Pie
-45
270
Closed
Pie
-45
270
Filled
Pie
-45
270
Filled
Chord
8.7.15
Closed Polygon
This tool allows you to draw a closed polygon. After selecting this tool, click where you want your polygon to start. Its not necessary to hold the mouse button down for this. Click on each vertex that you want in your polygon, and then double-click on the last vertex. You dont have to draw a line back to the first point. The last line that links to the starting point will be created automatically.
8.7.16
Filled Polygon
This tool allows you to create a closed polygon. The procedure is the same as that described above for a closed polygon.
8.7.17
Open Polygon
This tool allows you to draw an open polygon. The procedure is the same as that described above for a closed polygon. Select this tool and click where you want your polygon to start. You do not need to hold down the mouse button for this operation. Click on each co-ordinate that you want in your polygon, and double click on the last point.
Map Editing
8-29
8.7.18
Modifying Polygon Properties

If you right-click on a polygon (of any type) and select the Modify function from the pop-up menu, a Point Properties dialog appears for the selected polygon. The Point Properties dialog, which is the same one that is displayed for lines and rectangles, identifies the layer and drawing style of the polygon. You can modify these by using the Relayer and Recolor functions. The coordinates list, which is scrollable, can be modified in the same way as for lines and rectangles. You can also change a polygon from filled to unfilled and vice versa.
Figure 8-32 Point Properties Dialog for Polygon
8.7.19
Text String
This tool allows you to add text to the map. After selecting this tool, click where you want the text string to start. A String Properties dialog will appear. Enter the desired text string into the String data entry field and then click on OK. There is no limit on the length of the text string that you can enter, but there are no text wrap tools, so the string will display on one line. The String Properties dialog allows you to override the current text styles horizontal and vertical justification and the orientation for the text string. See Chapter 5, Text Styles, for definitions of these text styles attributes. Dont overuse this override capability, or you may find that you wont be able to make simple global changes later on. The String Properties dialog also allows you to specify an angle of rotation (in degrees).
Figure 8-33 String Properties Dialog
Map Editing
8-30
8.7.20
Modifying String Properties
Any text string that you add will be in the text style, layer and drawing style that you last selected using other tools. If you wish to change any of these, you can use the Restyle, Relayer and Recolor functions described in earlier sections of this chapter. If you wish to adjust the X-Y position of the text string, or the justification, orientation or rotation of the text string, you can do so via the String Properties dialog of (Figure 8-33). You can access the String Properties dialog by right-clicking on the text string and selecting the Modify function from the pop-up menu that appears. If the text string is horizontally oriented, the entire line of text is rotated by the angle that you specify. If the text string is vertically oriented, then each character will be rotated by the angle that you specified, but the text string will still be vertically oriented.
8.7.21
Symbol
This tool allows you to add a symbol to the map. After selecting this tool, just click where you want the symbol to be added. The symbol will appear at the selected location. To move or re-size the symbol, you can select the symbol (using the Select tool) and then move by dragging or re-size using the handles on the selection rectangle that highlights the symbol.
8.7.22
Modifying Symbol Properties
If you right-click on a symbol and select the Modify function from the pop-up menu, a Symbol Properties dialog appears for the selected symbol. The Symbol Properties dialog identifies the layer of the symbol. You can modify the layer that the symbol is in by using the Relayer function. The XY coordinate fields allow you to precisely locate the symbol where you want. The Scale X and Scale Y fields give you the option of changing not only the size of the symbol but also the aspect ratio. Symbols can also be rotated. The angle of rotation is specified in degrees counterclockwise.
Figure 8-34 Symbol Properties Dialog
Map Editing
8-31
8.7.23
Pmacro
This tool allows you to add a pmacro to the map. After selecting this tool, just click where you want the pmacro to be added. The pmacro will appear at the selected location. If the pmacro is a status point pmacro, the symbol and color used to display the pmacro will be those that correspond to State 0, with no unacknowledged alarms. If the pmacro is an analog pmacro, a string of question marks is displayed in the color that corresponds to the points normal range (no limit violations). The number of question marks after the decimal point corresponds to the value of the Precision resource of the pmacro. In both cases, all of the indicators (condition code, tag flag and alarm blocked flag) that are enabled are displayed with the pmacro.
Figure 8-35 Displayed Pmacros To move or re-size the pmacro, you can select the pmacro (using the Select tool) and then move by dragging or re-size using the handles on the selection rectangle that highlights the pmacro.
8.7.24
Pmacro Properties Dialog
If you right-click on a pmacro and select the Modify function from the pop-up menu, a Pmacro Properties dialog appears for the selected pmacro. The Pmacro Properties dialog identifies the layer of the pmacro. You can modify the layer that the pmacro is in by using the Relayer function.
Figure 8-36 Pmacro Properties Dialog for Status Symbol Pmacro
Map Editing
8-32
Each class of pmacro has its own type of Pmacro Properties dialog. These dialogs are the same as those used with the Pmacro editor to create the pmacros, and are described in Chapter 7, Pmacros. The XY coordinate fields in the Pmacro Properties dialog show the exact location of the pmacro in the map, and can be modified if desired. Any overrides (resource values) that you defined for the pmacro when you created the pmacro in the Pmacro library are now shown as default values in the Pmacro Properties dialog for the instance you just put down on the map. You can override the values of any of these resources for just this particular instance of the pmacro by double-clicking on the resource name and entering the override value into the resource dialog that appears. See Chapter 7, Pmacros, for a detailed description of all of the available pmacro resources for each class of pmacro, and how to modify them. If an instance of a pmacro has a resource with an override value, the override value is displayed in the Override column of the Pmacro Properties dialog. Any override value can be removed by selecting the corresponding resource name and clicking on the Remove Override button. Any override value that is added or removed is immediately applied to the displayed pmacro without requiring the use of Apply.
8.7.25
Attaching a Point Name to a Pmacro
It has previously been mentioned that per-instance overrides should be used with care (because it can render making global changes quite difficult). There is one resource, however, that should be left blank in the library pmacro definition and should be overridden on a per instance basis. This is the Point Name resource, which normally would have a different value (point name) for each instance in the map. Note that if you do wish to display the same point more than once in the map (using multiple pmacros), the editor lets you do so. You can, for example, display a voltage or current for a feeder coming out of a substation at the substations zoom level, and then display the point again at a higher (zoomed out) feeder level. Use of separate layers with appropriate declutter levels would prevent the two pmacros from be displayed simultaneously. To assign a point name to an instance of a pmacro, double-click on the Point Name resource name in the Resource column of the Pmacro Properties dialog. A Point Name resource dialog will appear containing a data entry field for a point name, Type in the desired point name and click on OK.
Figure 8-37 Point Name Resource Dialog If the point name that you enter does not exist on the host computer, or if it is not of the correct type for the pmacro, then an error message is displayed. In this case, you can correct the mistake and click on OK again. Alternatively, you can browse for the point. If you click on the Browse button in the Point Name resource dialog, a Point Browser window will be displayed, containing a scrollable list of stations as shown in (Figure 8-38). The list contains the names and descriptions of all of the stations that are in the host system, in alphabetic order of station name. Worldview for Windows Editors Guide Map Editing 8-33
When you click on the desired station name, the Point Browser window updates to show an alphabeticallyordered list of all of the points on the selected station, as shown in (Figure 8-39). The list is filtered to contain only points of the type that is appropriate to the pmacro.
Figure 8-38 Station List in Point Browser
Figure 8-39 Point List in Point Browser When you click on the desired point name, the Point Browser window is dismissed and the selected point name is displayed in the Point Name field of the resource dialog.
Map Editing
8-34
Figure 8-40 Point Name Resource Dialog with Point Name When you click on OK in the resource dialog, the resource dialog will be dismissed and the point name will appear in the Override column of the Pmacro Properties dialog.
Figure 8-41 Point Name in Override Column of Status Symbol Pmacro When you click on OK in the Pmacro Properties dialog, the pmacro is now attached to the point. If you get out of edit mode (by toggling the Edit button in the navigation bar), and click on the pmacro, youll get a control dialog that allows you to operate the point (see (Figure 8-42)). You can get right back into edit mode by again toggling the Edit button.
Figure 8-42 Control Dialog for Status Point
Map Editing
8-35
8.8
Groups
Grouping multiple objects together can be a very useful way to edit parts of your map. When you click on any element of a group (in edit mode), the entire group is highlighted by one selection rectangle that completely surrounds the group of objects. You can move or re-size the group as if it was one object. Another reason for grouping objects together, however, is to be able to associate multiple objects to one element in the SCADA database. There are presently two types of database assignments that can be made for groups: Segment If you define a group to be a Segment, it becomes assigned to a status point. Everything in the group will be colored according to the current value of the status point. This is described in paragraph 8.8.2, Segment. Line Section If you define a group to be a line section, it becomes assigned to a record in the line section database. Everything in the group will be colored according to the current connectivity status of the line section (energized, de-energized, paralleled, looped, etc). This is described in the System Configuration Status Users Guide.
8.8.1
Creating a Group
To create a group, select the objects that you wish to group by using the procedure described in paragraph 8.7.1, Select. Alternatively, you can control-click on each object. You may have to use the latter if objects you dont want in your groups are mixed in with the ones you want. Either way, each object select will have its own selection rectangle plus one that surrounds all of the selected objects. After selecting the objects, right-click anywhere within the outer selection rectangle, and in the popup menu that appears, select Group. In the submenu that appears after that, select Group again.
Figure 8-43 Creating a Group This creates the group. Next time you click on any element of the group, the entire group will become selected and highlighted by one selection rectangle that surrounds the group. Individual selection rectangles for each element will no longer appear.
Map Editing
8-36
To ungroup a group, right-click on any element of the group and in the pop-up menu that appears, select Ungroup. If a group has been assigned to a status point (segment) or a line section record, you cannot ungroup the group until you delete the groups association to the point or line section. You dont have to delete the point or line section itself just the groups association to the point or line section.
Figure 8-44 Ungroup
8.8.2
Segment
The purpose of segments is to color-code parts of your map according to the value of status points, which may be telemetered or calculated. If you dont have the System Configuration Status program on your system, and if your network is not too complex, you can use calculated status points assigned to segments to show the energized/de-energized or pressurized/un-pressurized status of your network. To turn a group into a segment, right-click on any element of the group. In the pop-up menu that appears, select Group. In the sub-menu that appears, the Segment item is now selectable. When you select it, a special Segment Pmacro Properties dialog appears.
Figure 8-45 Creating A Segment
Map Editing
8-37
In the Group sub-menu, the Group item is still selectable because you can create groups of groups. The Line Section item is selectable only if you have the System Configuration Status program on your system.
Figure 8-46 Pmacro Properties Dialog for Segment As you may guess, segments are implemented in WorldView by special pmacros that have no counterpart in the pmacro library. That is, you cannot create segment pmacros in the pmacro library. You can only create them by creating groups and then turning groups into segments using the Group sub-menu described immediately above. In the Pmacro Properties dialog for a segment, there are three resources that you can specify. The two drawing style table resources specify drawing style tables that are used to color the segment (i.e. the group) according to the current value of the status point. The NAK Drawing Style table is used when the status point has one or more unacknowledged alarms. The Normal Drawing Style Table is used when the status point has no unacknowledged alarms. Each table should have four drawing styles in it. To specify the desired drawing style table, double-click on it, and in the Library resource dialog that appears, find and select the desired drawing style table.
Figure 8-47 NAK Drawing Style Table Resource Dialog for Segment The Point Name resource specifies the name of the status point that is to drive the coloring of the segment. To enter the point name, double-click on the resource name in the Resource column, and in the Point Name dialog that appears, enter the point name directly or use the point name browser as described in paragraph 8.7.25, Attaching a Point Name to a Pmacro.
Map Editing
8-38
8.8.3
Select Member
When you right-click or double-click on a group that is not associated with a segment or a line section, and select Modify, a pop-up window appears to show the internal identifier of the group. There are no modifications that you can make to the group via this window. (The move and re-size functions that you can perform can only be done by dragging and re-sizing the groups selection rectangle.)
Figure 8-48 Group Internal Identifier When you right-click on a group that is assigned to a segment, and select Modify, the segment Pmacro Properties dialog of (Figure 8-46) appears. This dialog allows you to modify the definition of the segment (i.e. the resource values of the segment pmacro) but it does not allow you to modify the group itself. When you right-click on a group that is assigned to a line section, and select Modify, the SCS Line Section Editor window appears. This window allows you to modify the definition of the line section record but does not allow you to modify the group itself. So how do you modify any of the elements in a group without ungrouping (especially since you can ungroup a segment or line section)? To access an individual element in a group, you use the Select Member function in the right-click pop-up menu. First click on any element in the group. The entire group will be highlighted, and the handles will be colored magenta. Then right-click on the element that you want to access, and in the pop-up menu that appears, choose Select Member. When you do so, the group highlight disappears and the selected element becomes highlighted alone (and the handles become colored yellow). Now you can move it or re-size it via its handles, or you can right-click on it and use the editing functions that are in the pop-up menu. You can even cut the element from the group (but you cant undo it and presently, you cant add new objects to an existing group).
Map Editing
8-39
Figure 8-49 Select Member
8.9
Views
A view is like a bookmark to a particular place in the world map. Each view has a name. You can create any number of views and organize them in a hierarchical fashion in a tree list. You can also assign views to pushbuttons. When you click on a view pushbutton, youre taken immediately to the view that is assigned to that pushbutton. When you save a view, you also save the current auto/manual declutter settings for all of the layers that are in the map. This means that it is possible to create a view with some layers showing that would not normally show when in auto declutter mode. You can also include a photo as the background of a view.
8.9.1
Creating a View
To create a named view, first use any navigation tools you like to bring the desired view into the map window. Then invoke the Views and Layers window by Views and Layers Lists button in the navigation bar or by selecting the Tree Lists function in the View pull-down menu. If in your view, you want to override the automatic declutter of any layers (i.e. manually turn on layers are normally off at this zoom level, or manually turn on layers that are normally off), then do this now using steps described in section 8.10, Layers. In the Views pane of the Views and Layers window, right-click on the Views folder as shown in (Figure 8-50).
Map Editing
8-40
Figure 8-50 Adding a View in the Views and Layers Window In the pop-up menu that appears, select Add View. An Edit Views dialog will appear, as shown in (Figure 8-51). Type in the desired view name into the View field and click on OK. View names are case-insensitive. The Lower Left and Upper Right X-Y fields are initialized to the coordinates of the lower left and upper right corners of the map window, so you dont have to enter these if the desired view is exactly whats currently in the map window. But you can adjust these if you wish. When you click on OK, the Edit Views dialog is removed and the new view name is added to the list of views in the Views pane of the Views and Layers window. Figure 8-51 Edit Views Dialog
Map Editing
8-41
Double-clicking on the view name takes you immediately to that view.
Figure 8-52 New View
8.9.2
Modifying a View
If you find later that the view is too large or too small, you can adjust it by navigating and then right-clicking on the view name. Select Modify View from the pop-up menu. The same View dialog of (Figure 8-51) will appear. In the Edit Views dialog, click on the Current button. This set the X-Y coordinate values in the View dialog to the corners of the map window. When you click on OK, the view definition is updated.
Figure 8-53 Modifying a View There is no mechanism to change the view name of an existing view. If you modify an existing view and change the view name in the View dialog, a confirmation dialog appears asking if you wish to create a new view with that name.
Map Editing
8-42
Figure 8-54 Confirmation to Create View
8.9.3
Background Images
You can specify a background image for your view by clicking on the Background Image button in the Edit Views dialog. This brings up an image file browser dialog that allows you to select the desired image.
Figure 8-55 Background Image Browser You can specify whether you want the background image stretched to fit the screen or not. If you dont specify stretch to fit, the image is displayed at the top left of the screen. This is a useful option that allows you to incorporate your company logo in the default view.
Map Editing
8-43
Figure 8-56 View Definition with Background Image, Streched to Fit An example of a view with a photo of a substation as a background is shown in (Figure 8-57). An example of an overview with a logo (Survalents) as a background is shown in (Figure 8-58).
Figure 8-57 View with Background Image (Stretched to Fit)
Map Editing
8-44
Figure 8-58 View with Logo Image (Not Stretched to Fit) The image files that can be used for background images must be located in the image directory that is specified on the Directories page of the Options dialog. This is the same directory that contains the pop-up photos. See paragraph 7.4.5, Image Pushbutton. A background image is not considered to be an object that shifts or scales when you pan or zoom. The background image that is associated with a view is displayed only while youre looking at that view. As soon as you begin to navigate away from the view, whether its by panning or zooming, the background image disappears. If you add your company logo to your default view, you may find that it shows up fine when you click on the Home button but it doesnt appear when WorldView starts up and automatically opens the map and displays the initial view. This is because when you save the startup configuration (via the Save Configuration function), its not the name of the current view thats memorized. Its the coordinates of the current view. (This initial view at startup doesnt have to be the default view, and in fact, doesnt even have to be a named view at all.) WorldView does memorize the fact that a background image was displayed at the time the configuration was saved, however. So all you have to do after you add the logo is re-save the desired configuration.
8.9.4
Deleting a View
To delete a view, right-click on the view name and select Delete from the pop-up menu. A confirmation dialog will appear to which you must answer yes if you really want to delete the view.
Map Editing
8-45
Figure 8-59 Confirmation to Delete View
8.9.5
Adding a Views Folder

To add a views folder, right-click on the main Views folder and select Add Folder from the pop-up menu. In the Enter Name Of Folder dialog that appears, type in the desired name of the folder.
Figure 8-60 Enter Name of Folder Dialog When you click on OK, the folder will be added to the list of views and folders, as shown in (Figure 8-61). Note that the list is not sorted for you. Anything new is added to the bottom, and you re-arrange the list and move things into folders as described in paragraph 8.9.7, Organizing Views.
Figure 8-61 New Folder To rename a folder, right-click on the folder and then select Rename Folder from the pop-menu. Type in the new folder name into the Enter Name Of Folder dialog that appears, and click on OK.
Map Editing
8-46
8.9.6
Deleting a Folder
A folder cannot be deleted unless it is empty. To delete an empty folder, right-click on the folder and select Delete Folder from the pop-up menu. A confirmation dialog appears, to which you must answer Yes if you really want to delete the folder.
Figure 8-62 Confirmation to Delete View
8.9.7
Organizing Views
To move a view up or down in a list: 1. Click on the view that you wish to move. 2. Drag the view to the position after which you wish the view to appear and release the mouse button. Folders can be moved in the same way. To move a view into a folder: 1. Click on the view that you wish to move. 2. Drag the view to the folder icon of the target folder and release the mouse button. Note that you must release the mouse button over the target folders icon, not its name. If you release the mouse button while the mouse pointer is over the folders name, you will move the view to the position after the folder at the level of the folder (instead of inside the folder). The Views list behaves like a Windows Explorer directory structure. If a folder contains views or other folders, it has a plus sign + beside it. When you click on the plus sign or double-click on the folder icon or name, you open the folder. The folders contents are now displayed, and the folder has a minus sign -beside it. Clicking on the minus sign or double-clicking on the folder will close the folder and hide its contents.
Map Editing
8-47
Figure 8-63 Closed Folder
Figure 8-64 Open Folder With Three Views In It
Note that folders can be placed inside other folders to create a multi-level hierarchy of views. To bring a view or folder out of a folder: 1. Click on the view or folder that you wish to move. 2. Drag the view or folder to another view or folder name (not icon) and release the mouse button. (Figure 8-65) illustrates taking view 2 out of My folder by dragging it and releasing the mouse button when the pointer was over the name My folder.
Figure 8-65 Taking View 2 Out Of "My folder"
Map Editing
8-48
8.9.8
Set As Default View
To make a view the default view, right-click on the view name and select Set As Default View from the pop-up menu. The arrow beside the default view name is highlighted red. From now on, this is the view that will appear when you click on the Default View button in the navigation bar.
Figure 8-66 Default View
8.10
Layers
Layers in a world map are like a stack of transparencies. Every object in the map is in one and only one layer. The set of objects in a layer can be turned on or off (i.e. appear or disappear from the screen). This is called decluttering. The decluttering for each layer can be set to either automatic or manual mode. A layer that is in auto-declutter mode automatically turns off all of its objects when you navigate outside the layers assigned inner and outer zoom limits. A layer that is in manual declutter mode can be turned on or off manually. Worldview does not limit the number of layers that you can create. The more layers you have, the more declutter control you have on your map. When you import maps from DXF files, the layers that are in the DXF file are preserved in the WorldView map file. After the import, you can set the auto declutter levels for each layer. If you re-import an updated version of a DXF file that you previously imported, then you can specify that the contents of the layers in the new DXF file should replace the contents of the corresponding layers in the working map. Because of this, its very important to create new layers for objects that you add to the map using the WorldView editors. If you do this, then you can re-import the layers of an updated DXF file without disturbing the layers containing your own artwork.
Map Editing
8-49
8.10.1
Creating a Layer
To create a layer, access the Views and Layers window by clicking on the Tree Lists button in the navigation bar or by using the Tree Lists function in the View menu. In the Views and Layers window, click on the Layers tab. Right-click on the Layers folder. In the pop-up menu that appears select Create layer. This will bring up an Edit Layers dialog, as shown in (Figure 8-68).
Figure 8-67 Create Layer Enter the desired layer name into the Layer Name data field and click on OK. The Edit Layers dialog will be dismissed and the new layer will be added to the end of the list of layers in the View and Layers window. The Zoom Out and Zoom In Declutter Point data specify the minimum and maximum zoom levels, respectively, for automatic decluttering. This is described in paragraph 8.10.2, Setting Automatic Declutter Levels.
Figure 8-68 Edit Layers Dialog
Map Editing
8-50
8.10.2
Setting Automatic Declutter Levels
To set the minimum zoom level for automatic decluttering, zoom out to the desired level (where the objects are at the smallest size that you wish to see) and right-click on the desired layer name in the layers list. In the popup menu that appears, select Modify.
Figure 8-69 Modify Layer This brings up the Edit Layers dialog that we saw earlier.
Map Editing
8-51
Click on the Set Current button beside the Zoom Out Declutter Point field. This causes the current scale in world units per pixel to be calculated and filled into the Zoom Out Declutter Point field. Click on OK. Now zoom in to the maximum zoom level at which you wish the layer to be visible. Access the Layer dialog again by right-clicking on the layer name in the layers list. Click on the Set Current button beside the Zoom In Declutter Point field. This causes the current scale in world units per pixel to be calculated and filled into the Zoom In Declutter Point field. Click on OK. Now, when you zoom outside of these two zoom levels, the layer will automatically turn off (if the layer is in autodeclutter mode). Setting the declutter mode of a layer is described in the WorldView for Windows Operators Guide.
Figure 8-70 Setting Maximum and Minimum Scale for Automatic Declutter Note that a scale value of 1 may be used to indicate that the zoom limit is infinite. For example, if the Zoom Out Declutter Point is set to a positive value and the Zoom In Declutter Point is 1, then the layer will be off until you zoom in to the zoom out declutter point, and will then stay on indefinitely as you zoom in deeper (i.e. there is no second zoom level at which the layer will declutter off again). The Edit Layers dialog contains a Layer Mode radio button. The choices are: AUTO The layer is automatically decluttered if not manually set in the view (to either ON or OFF). MANUAL OFF The layer is manually set to OFF, unless explicitly manually set to ON in the view. The name of an existing layer cannot be changed. If you attempt to modify the name of an existing layer via the Edit Layers dialog, a confirmation dialog appears asking if you wish to create a new layer.
Figure 8-71 Confirmation to Create New Layer
Map Editing
8-52
8.10.3
Deleting a Layer
To delete a layer, right-click on the desired layer name and select Delete from the pop-up menu. A confirmation dialog will appear. If you really want to delete the layer, select yes.
Figure 8-72 Confirmation to Delete Layer
8.10.4
Layer Drawing Order

The Layer Drawing Order pane of the Views and Layers window displays a list of all of the layers that are in your map. The order of the layers in this list is the order in which the layers are re-drawn by WorldView whenever navigate through the map. This order is initially the order in which the layers were created.
Figure 8-73 Layer Drawing Order You can control the order in which layers are drawn by modifying the order of this list. A layer name can be moved within the list by clicking on the layer name and dragging it to a new position in the list. The layer will be moved to immediately after the position where you release the mouse button. Note that you dont have to be in edit mode to modify the layer drawing order, but you do have to be logged into a SCADA account and you do have to remember to save the map.
8.10.5
Organizing Layers
As in the case of views, you can hierarchically organize your layers in folders.
Map Editing
8-53
To create a new folder, right-click on the Layers folder and select Create Folder from the pop-up menu. An Enter Name Of Folder dialog will appear (the same one that we saw for views). Enter the desired name of the new folder and click on OK.
Figure 8-74 Creating A Folder for Layers The new folder will be added at the bottom of the root directory list. You can re-arrange the list of layers and folders, and put layers (and even folders) into folders. The procedure for doing this is identical to that described for views in section 8.9, Views. Folders can be renamed or deleted by using the Rename Folder or Delete Folder items in the right-click pop-up menu. The Sort Folder function can be used to sort the contents of a folder in alphabetical order. This is particularly useful after your first DXF import before youve created any folders. You can open a folder by clicking on the folders plus + sign or double-clicking on its icon or folder name. You can close a folder by clicking on its minus sign -or again double-clicking on the folders icon or folder name. (Figure 8-75) shows an example of a map in which the layers have been organized into a multi-level system of folders. In (Figure 8-75), layers AB-1 and AB-2 are manually set to on, while the remaining layers in the aberdeen s/s folder are in auto-declutter mode and are turned off.
Figure 8-75 Hierarchical Layer Folders Setting the declutter modes of layers is described in the WorldView for Windows Operators Guide. Worldview for Windows Editors Guide Map Editing 8-54
When you decide how to organize your layer folders, keep in mind a very powerful layer control feature that is available to the operators. In the right-click pop-up menu are some functions that can be used to place entire folders of layers into automatic or manual declutter mode: Folder Auto Folder Manual
and when in manual mode, to turn all of the layers contained in the folder on or off: Folder On Folder Off
Note: Modifying or rearranging the views and layers of the map is not allowed unless you have map editing privilege. A tooltip on the layer list pushbutton shows the currently selected layer.
Map Editing
8-55
World Map Import
This chapter describes how to import maps from other sources into WorldView for Windows. Section 9.1, DXF File Import, describes how to import DXF files from other drawing packages (such as AutoCAD) or AM/FM/GIS systems. The DXF import function has two important features: You can specify that the contents of the DXF file are to be added to the present contents of the target map window. This allows you to put together a large map from multiple DXF files. You can specify that the contents of all of the layers contained in the DXF file are to completely replace the contents of the same layers in the target map window. This allows you to update the previously imported layers in your map without disturbing the layers that contain graphics that you entered using the WorldView editing facility.
Section 9.2, Import From WorldView for VMS, describes how to import maps and libraries from WorldView for VMS. This is a two-step process: The first step is to export the WorldView for VMS maps and libraries into text files on the VMS host computer and transfer them to your PC (via FTP). This is described in the Guide to World Map Conversion (document number WV-107). The next step is to import the text files exported above into WorldView for Windows. This is whats described in section 9.2.
World Map Import
9-1
9.1
DXF File Import
To import a DXF file, you have to be logged into a privileged account. If you are importing for the first time, create a new (and empty) map window by selecting New Map from the File menu. This creates an empty WorldView map window.
Figure 9-1 Selecting New Map in File Manu
Switch to Edit Mode, and from the File menu, select Import, and then from the next sub-menu that appears, select DXF R12 File. When you select the DXF R12 File item, a browse window is displayed inviting you to select the DXF file you wish to import.
Figure 9-2 Selecting DXF R12 File item
World Map Import
9-2
Figure 9-3 Import DXF files When you select the desired DXF file, a DXF Import Settings window is displayed.
Figure 9-4 DXF Import Settings In the DXF Import Settings window: The DXF Map Extent area shows the declared extent of the map in the DXF files own coordinates. The Recommended Scale Factor is calculated for you (from the declared extent in the DXF file) so as to make the imported map occupy approximately 100 million by 100 million world units. (The total WorldView coordinate space is 1 billion by 1 billion world units.) You can use the recommended scale factor as is, or you can modify it by editing it. For reference, the Minimum Scale Factor is calculated to show you the scale factor value that would make the imported map occupy 1 million by 1 million world units. And the Maximum scale factor is calculated to show you the scale factor value that would make the imported map occupy 1 billion by 1 billion world units. Survalent recommends that you not exceed a coordinate space of +-500,000,000, for two reasons: to allow for later additions to the map to support monitors with different aspect ratios (e.g. 3x4, 16x9 etc) from that where the import is being performed. World Map Import 9-3
The X and Y offsets are calculated for you to center the imported map at origin 0,0 in the WorldView coordinate space. These can be edited if you dont wish the imported map to be centered in WorldViews coordinate space. The rotation is initialized to zero. You can enter a non-zero angle of rotation if you wish. Leaving Make Map larger if required unchecked causes the import function to only import stuff thats inside the declared map extent. It is not uncommon to find graphics in a DXF file that are outside the DXF files declared extent. This is usually garbage caused by export errors, and if imported, can stretch the imported maps extent to such a degree that the imported map can be difficult to handle. The best default therefore is to leave the box unchecked. If you suspect that there are things missing in your imported map, you can try re-importing with the Make Map larger if required option checked.
Leaving Overwrite Existing Text Styles unchecked causes the import function to not update the WorldView text style library. This is handy in cases where you have modified previously imported text styles and you dont want your changes to be lost on this import. If you do want the text styles updated, the Overwrite Existing Text Styles box must be checked. Leaving Replace Existing Layers unchecked causes the import functions to import and add the new map to the existing map (if you had one open). This is what you would do if you wanted to merge several maps together (i.e. import multiple sub-maps to produce one large map). If, on the other hand, what you want to do is to update your map from an updated DXF file, you would check the Replace Existing Layers check box. In this case, each layer in the DXF file completely replaces the corresponding layer of your existing map. Note that any layers in your existing map that are not present in the DXF file are left intact. Which is why its very important to put your own stuff that you add(e.g. stations, pmacros, pushbuttons, etc) into layers separate from those imported from DXF files.
The Use Default File button allows you to use a previously saved set of scale factor, X-Y offsets and rotation angle. The Save Defaults As pushbutton allows you to define and save these import parameters for use on subsequent imports. See paragraph 9.1.1, Saved DXF Import Parameters. The Font Factor is a scale factor for text only. It allows you to adjust for text size differentials that can result if the source text is vector-based (WorldView text is based on TrueType fonts). The Keep Line sections check box controls whether line sections are to be preserved on re-import. If checked, WorldView determines whether any of the layers about to be imported already exist in the map being updated, and if so, whether any of those layers contain line sections. If yes, then WorldView performs an X-Y match of all of the graphics in those layers that are presently attached to line sections against the graphics that are being imported. For each matching graphic, WorldView preserves the attachment to the line section
After clicking on OK, the import function proceeds to import the DXF file. During the import, a progress bar is displayed. How long the import takes depends on the size of the DXF file, but most files will take well under a minute. On completion, if you like what you see, you can save the map.
World Map Import
9-4
Figure 9-5
Import Progress Bar
The DXF Import function will display an error message if it encounters an error in the DXF file. If the problem is not fatal, the import will continue after you acknowledge the error.
Figure 9-6
Import Error Message
After saving the map, you can use the Optimize Map function to reorganize storage of the map so as to optimize the speed of navigation. See paragraph 8.4.3, Optimize Map. After optimizing the map, Save it again.
9.1.1
Saved DXF Import Parameters
The Save Defaults As pushbutton allows you to save the current set of import parameters as the default, to be used on subsequent DXF imports. When you click on the pushbutton, a Save File dialog appears and you can give the options file any name you choose. It will be given the extension .opt by default. If you are importing several separate maps, you may wish to keep their parameters separately. But if you are merging several DXF files into a single WorldView map, it may be more convenient to use the same option file for all the imports. To use the saved parameters on a subsequent import, just press the Use Default File button in the DXF Import Settings dialog. A File Open dialog box will appear, and you will be able to select the option file you wish to use. The scale factor, offset and rotation angle information fields will update to show the saved values. Using saved DXF import parameters is a must for cases where maps are imported (and subsequently updated) from multiple DXF files that represent different areas of your network but are all based on the same coordinate space. If youre importing a matrix of section maps, for example, we suggest that you import the middle one first and save its import parameters as the default. Then use those defaults to import the remaining DXF files. Saved DXF import parameters are also useful for single DXF file imports and updates. When you import a DXF file that represents an update to one that was previously imported, the extent of the new file may be different from that of the original. In order to be compatible with the other layers of your map, it's important that all DXF updates be done at exactly the same scale and offset. By saving the DXF import parameters on the initial import, you don't need to record on a piece of paper the scale and offset that was used for the first DXF file import. It's in the map's option file.
World Map Import
9-5
If you click on Import without saving the defaults, you are asked whether you wish to save the current settings. You can say No if you wish. If you say yes, you will be prompted to enter or browse for a filename.
Figure 9-7 Confirmation to Save Import Settings Even if you do not save the options in a file, WorldView logs all imports, complete with import parameters. The log file is named Worldview.log and is located in the WorldView directory. An example of the log file is shown below. In addition to DXF imports, the log file is also used to record saves of maps and publishes of line sections.
World Map Import
9-6
9.1.2
Text-to-Symbol Replacement in Microstation
Some MicroStation systems do not use the INSERT command to specify symbols in an exported DXF file. Instead, they just insert special text strings, which the importing program must convert to a symbol. To accommodate this, WorldView supports a text-to-symbol cross-reference file. If youre using this capability, the name of the cross-reference file must be the same as the name of the DXF file being imported but with a .DXF_OPT file extension. If the cross-reference file exists, WorldView uses it to replace text strings by symbols. If the file does not exist, no text to symbol replacement is performed. Below is an example of a text-to-symbol cross-reference file. A double-slash // in the first position of a line denotes a comment.
// 44KV_LAYER_12.DXF_OPT // Option File for MicroStation Text-to-Symbol Conversion // Notes: Separators are SPACE, TAB and QUOTE 1 "HYDRO" "SW_LABEL" "ZZZ" "M5-51" 3D_BREAKER_CLOSED 60POLE STANDARD STANDARD 1.0 1.0 1.0 1.0
MICROSTATION MS_CONVERSION MS_CONVERSION // EOF
The cross-reference file contains the following keywords: MICROSTATION This keyword enables or disables text-to-symbol replacement. Setting the keyword value to 1 enables text-tosymbol replacement. Setting the keyword value to 0 disables it. MS_CONVERSION Each instance of this keyword defines the following items in order to map a certain text string in a certain layer and with certain font style to a WorldView symbol: Layer Name This is the name of a layer that contains text strings that need to be replaced by symbols. Text String Any instance of this text string in the previously specified layer is to be replaced by a symbol. The symbol that replaces the text string is specified by the next item. Symbol This is the name of the symbol that is to replace each instance of the text string identified above. Note: Since the symbol definitions are not included in the DXF file, the symbols that replace text strings must be prepared ahead of time and be present in the WorldView symbol library at the time of the DXF import. Worldview for Windows Editors Guide World Map Import 9-7
Font This is the name of a font for the text string that needs to be replaced. If the text string is not in this font, it is not replaced by a symbol. If the text strings font is a default font that is defined in the DXF file for the entire layer, then just set this to STANDARD.
X Scale This is the X scale factor to be applied to the symbol that replaces the text string.
Y Scale This is the Y scale factor to be applied to the symbol that replaces the text string.
In the example above, each instance of text string M5-51 in layer SW_LABEL in font style STANDARD will be replaced by a symbol named 60POLE. The X and Y scale factors used on the symbol are both 1.0. Another example is the special string %%C that represents the Greek letter PHI (used in electrical diagrams to represent the word "phase"). Other special symbols that are also properly imported are the combined +- sign and the degree sign.
9.1.3
DWG / DXF File import
The DWG / DXF import function is a more advanced function that presently supports all versions of AutoCAD DWG and DXF up to AutoCAD 2008.
Figure 9-8 Selecting a DWG/DXF File in File Menu The same Import Settings dialog is used as for DXF R12 import. If the DWG file is password-protected, WorldView prompts you for the password. The price for this capability is that imports are noticeably slower. A 10-20 second import using the original DXF R12 import function can take a few minutes using this function. For this reason, the DXF R12 import function has been retained. In DWG files, some of the attributes of Blocks (symbol definitions) are not used by WorldView. In this case, WorldView simply ignores the unused attributes. Worldview for Windows Editors Guide World Map Import 9-8
9.2
Import From WorldView for VMS
This section describes how to import WorldView text files that were exported from WorldView for VMS. The file extensions of these exported text files are listed in Table 9-1. Table 9-1 Exported Text File Extensions File File Type Extension .wms .gcs .fns .pms .sms .ims WorldView map Drawing styles and drawing style tables Text styles Pmacros Symbols and symbol tables Pixmap ASCII file
To import a WorldView database from VMS: 1. Open a new map (using the New Map function in the File pull-down menu). 2. Import the libraries in the following order: Drawing Styles Pixmaps Text Styles Symbols Pmacros
Figure 9-9 Selecting Drawing Styles For each library, select Import from the File pull-down menu and from the sub-menu that appears, click on the library name. For each library that you select, an Import library dialog will appear to let you find and select the desired library text file.
World Map Import
9-9
Figure 9-10 Import drawing styles When you click on Open, the selected file is imported into the appropriate sub-folder of your WorldView standard directory. Any existing elements of each library will be over-written. Note that there will be two library files of the symbol type (extension .sms). Import them both in two consecutive import commands, but import the file named symbol table.sms second. 3. Import the map. An Import Maps dialog will appear to let you find and select the map file. The map you select will be imported and then drawn in the current map window.
Figure 9-11 Import Map
4. Unlike the imports of the libraries, the results of a map import are not automatically written to disk. You must save the map using either the Save command in the File menu or the Save button in the Tool bar. Each library or map import is a separate command. You can exit or do other things between each import command. You can choose to re-import any library or map at any time without repeating the import of the other Worldview for Windows Editors Guide World Map Import 9-10
files. Generally, you would import the libraries only once but re-import the map(s) whenever there are changes on the VMS system that you want on your PC. If there were changes in any of the libraries on the VMS system, then you would re-import those too. If you import a map into a window that already has a map open, the result will be a merge of the two maps. If you do this by accident, you can close the map window without saving the map, and import the map again in a new empty window. You dont have to re-import the libraries.
9.3
Portable Map Export
This function allows you to export a map to a text file (with .wms extension) with its point IDs replaced by the actual point names. The purpose of this is to produce a map that can be re-imported into another system where the point IDs are different, such as when moving from a VMS to a Windows SCADA system. On import to the other system, WorldView looks up every point name and produces and saves new point IDs.
Figure 9-12 Portable Map Export Since this export process must look up each point ID on the Master, and convert it to a name, it may take a long time. The warning box shown below is displayed before proceeding with the export.
The output file may be named anything you wish, and can be placed anywhere you like, but you should retain the .wms extension.
World Map Import
9-11
Figure 9-13 Export Map
World Map Import
9-12
10
Change Control
10.1
Change Control With Reservations
WorldView supports a Reservation system that prevents multiple users from editing the map simultaneously.
The Reservation system allows you to exclusively reserve the WorldView database (i.e. the map and all of the resource files) so that only you can edit it. By including Publish and Update functions, the system allows other users to be automatically notified that new versions of the maps and resources are available, and to then conveniently update their workstations.
The Reservation system is only available for Windows SCADA.
10.1.1
Setup
The WorldView reservation system is enabled via the WorldView page of the System Parameters editor in the SCADA Explorer.
To enable reservations, you have to:
Change Control
10-1
Specify the directory on the network that contains the official copy of the WorldView database. In the example above, this is a directory called Repository on a computer called Servert. Check the Enable Reservations checkbox. And, of course, place your official copy of the WorldView database in the specified repository directory. The repository directory contains the Standard folder.
10.1.2
Reserving the WorldView Database
If the reservation system is enabled, you cannot edit the WorldView database without a reservation. If you attempt to do so, an error message is displayed:
Figure 10-1 Error message To reserve the WorldView database, use the Reservations sub-menu in the File menu.
Figure 10-2 Reservation the WorldView database If someone else has the database reserved, WorldView identifies the reservation holders account name and workstation to you.
Change Control
10-2
10.1.3
Publishing Your Edits
After you have finished editing, you can publish your files. When you publish, all the files that you have modified will be copied to the central repository, and from there made available to other users to download and use on their own workstations. If you have deleted any files in your WorldView database, those files will be deleted from the central repository as well. When you publish, a dialog is displayed that allows you to enter a comment (of up to 500 characters) to describe your changes. This dialog also displays how many modules are being published (both updated and deleted). You can request to see a list of the modules by clicking on the Updated Files and Deleted Files pushbuttons.
Figure 10-3 Publishing the Edits A checkbox at the bottom of the Publish dialog allows you to specify that you do not wish the module history to be updated. This is useful in cases where you have just done a DXF or other type of import. When you click on Ok to initiate the Publish, a progress dialog displays the name of every file that is being updated or deleted. As a precaution, before a file is overwritten or deleted in the central repository by a publish command, it is automatically copied to a Save folder in the repository.
Change Control
10-3
The Publish operation is logged in the operations log. Reserve, Release and Update functions are not logged. After publishing, you may Release your reservation, or hold on to the reservation to continue editing.
10.1.4
Update
When files are published to the central repository, WorldView informs all users at startup of WorldView, and on a user-selectable time interval, that changes have been made and that the user may update his WorldView files. The user can then ask WorldView to update the WorldView files on his workstation.
If Reservations is enabled, the Publish Check Time parameter in the Options dialog specifies the interval (in minutes) at which WorldView is to check for a new version of the database.
Change Control
10-4
A value of zero in the Publish Check Time parameter means check only at startup. Once you acknowledge that youve seen the message (by clicking on OK), WorldView does not re-issue the message unless you restart WorldView or another Publish occurs. A value of -1 means dont check, ever. This is a useful value to use on workstations that belong to people outside your company and whose version of the map is to be strictly controlled by your own people. A user right for Update Map is included in the User Rights editor. If your account doesnt have this user right, you cannot update any workstation. As a precaution, before deleting any file in your copy of the WorldView database, the Update function first places a copy of the file into a Save folder of your WorldView directory. In order for the changes to take effect, you must restart WorldView after performing the Update function.
If you attempt to reserve the database but your workstation is not up-to-date, a warning message is displayed. The dialog asks if you wish to have your workstation updated. If you indicate No, then your reservation request will be denied. If you indicate Yes, then your workstation will be updated and you will be invited to restart WorldView. You will not be able to make your reservation until you do so.
Change Control
10-5
10.2
Change Control Without Reservations
If you choose to not enable the Reservation system, or if your SCADA system is based on VMS, then you have to use a more hands-on approach. However, basically, in order to publish your changes to other PCs, all you really have to do is transfer the files that you have created and modified to those other PCs. These files are all contained in various sub-folders of: C:/Program Files/Quindar/WorldView/standard In our sample map of Chapter 3, Getting Started, we didnt modify any pre-existing files, but we did create new files of the following types: Each new drawing style that we created is contained in a new file whose name is the name of the drawing style and whose file extension is .gcl. These files are contained in the gcl sub-folder. Each new drawing style table that we created is contained in a new file whose name is the name of the drawing style table and whose file extension is .gtl. These files are contained in the gtl sub-folder. Each new text style that we created is contained in a new file whose name is the name of the text style and whose file extension is .fnl. These files are contained in the fnl sub-folder. Each new symbol that we created is contained in a new file whose name is the name of the symbol and whose file extension is .syl. These files are contained in the syl sub-folder. Each new pmacro that we created is contained in a new file whose name is the name of the pmacro and whose file extension is .pml. These files are contained in the pml sub-folder. We didnt create any new symbol tables, but if we did they would be contained in new files whose names are the names of the symbol tables and whose file extensions are .stl. These files are contained in the stl sub-folder. The map itself is contained in a new file called sample.wmp and is contained in the wmp sub-folder.
If you copy all of these files to the appropriate directories on your colleagues PCs, your colleagues will be able to use your map.
10.2.1
Control of Editing
If you dont use the Reservation system to preclude two people editing the same file on separate PCs, it is very important that your company implement a procedure for controlling WorldView database maintenance. Consider including the following in your procedure: Overall control of the updating and distribution of maps is assigned to one person. Even if you use an electronic bulletin board to post notices of maps being updated, one person is in charge of monitoring the activity described in such a bulletin board. People who edit the map files are aware of company drawing standards, and fully understand the implications of making changes to existing libraries (drawing styles, symbols etc).
Change Control
10-6
A mechanism exists to ensure that updated maps are distributed to all users. You can use e-mail, CDs, or LAN-based file transfers. A very convenient way to completely update a PC is to zip the entire standard directory on the PC where the edits were made, copy the zip file to the target PC, and unzip the zip file into the target PCs standard directory. Just say yes to All when the Confirm File Overwrite dialog appears. If you have an IT department, you can consider automating the update procedure. See section 10.2.2, Publish and Update. Ensure that a mechanism exists for identifying the version of a map so that users can confirm whether they have the most recent version or not. For example, you can reserve a small area of the map to record the date that the map was last edited together with the name or initials of the person who last edited it (so that people know who to ask if they have questions). Consider sometimes including a brief description of a significant change (e.g. addition of a new feeder).
10.2.2
Publish and Update
Sharing a WorldView Database One way to share a WorldView database is to have everyone's copy of WorldView point to one common directory on a shared drive somewhere on the network. Although this is convenient, it does have some drawbacks. First, it causes all WorldView map opens and saves to be over the network. For large maps, this may cause noticeably slower performance. In addition, remote users may not be able to map to the shared drive for security reasons or may find the download time unacceptable (especially if access is via a dial-up connection). So we suggest that you think about going a little further and implementing a simple Publish and Update scheme that keeps the main advantages of a centralized WorldView database but avoids the drawbacks. The idea is to use the shared location just as a central storage place for the official WorldView database. No ones (or almost no ones) copy of WorldView would access this directly. Instead, people would have copies of this WorldView database on their own PCs, and: use an Update batch file to update their copy of the WorldView database from the shared location whenever it changes use a Publish batch file to publish edits from their own PC to the shared location
Because each users copy of the map is on the users local hard drive, access times and network load are reduced. Anyone intending to edit the map should get an up-to-date local copy of the map via the Update function and then edit locally. This will make save operations very fast. In addition, other users will not see interim copies of the map or libraries. When youre ready to make the new map and libraries available to other users, a simple "Publish" command will copy the map and libraries to the server. Update In the examples of this section, lets assume that the shared WorldView database is stored in a share called ScadaCommon on a server called Tycho". And lets assume that the WorldView database on each users PC is stored in: "c:\program files\quindar\worldview" Worldview for Windows Editors Guide Change Control 10-7
For an Update function, you can create a file called "Update.bat" that contains just one statement: Xcopy <file://tycho/ScadaCommon/standard> \\tycho\ScadaCommon\standard "c:\program files\quindar\worldview\standard" /S/Q The quotes in the statement are required because the destination path has a space in it. The "/S" means copy subdirectories. The "/Q" forces a quiet copy. You can place a shortcut to the batch file in your start menu, or on your desktop. Publish To publish your computer's WorldView database to the shared location, you can create a batch file called "Publish.bat". It would contain just one statement that looks like this: Xcopy "c:\program files\quindar\worldview\standard" <file://tycho/ScadaCommon/standard> \\tycho\ScadaCommon\standard /S/Q As in the case of Update, you can place a shortcut to the batch file in your start menu, or on your desktop. Note that only people who edit WorldView would have a need for the "Publish" batch file. People who just use WorldView would only need the "Update" function.
Change Control
10-8

WorldView For Windows Editor's Guide, October 23, 2009 PDF

Hochgeladen von

Dokumentinformationen

Originalbeschreibung:

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

WorldView For Windows Editor's Guide, October 23, 2009 PDF

Hochgeladen von

Copyright:

Verfügbare Formate

Document Number: WV-201

WorldView for Windows

October 23, 2009

Survalent Technology Corporation Mississauga, Ontario

Copyright 2000 2009 Survalent Technology Corporation

WV-201 WorldView for Windows Editors Guide

TEL (905) 826-5000 FAX (905) 826-7144

Date October 1, 2001

April 5, 2003 September 18, 2007

October 23, 2009

Worldview for Windows Editors Guide

Other Documentation .................................................................................................................. 1-2

Worldview for Windows Editors Guide

Worldview for Windows Editors Guide

Customizing Drawing Style Tables.................................................................................... 4-16

Worldview for Windows Editors Guide

Worldview for Windows Editors Guide

Worldview for Windows Editors Guide

7.5.4 7.6 7.6.1 7.6.2 7.7 7.8 7.8.1 7.8.2

Worldview for Windows Editors Guide

World Map Import

Worldview for Windows Editors Guide

Worldview for Windows Editors Guide

Worldview for Windows Editors Guide

Worldview for Windows Editors Guide

Worldview for Windows Editors Guide

Worldview for Windows Editors Guide

Worldview for Windows Editors Guide

New Window Open Save Cut Copy Paste Print

Layers Views and layers List Edit Mode

Worldview for Windows Editors Guide

Worldview for Windows Editors Guide

Worldview for Windows Editors Guide

Figure 3-1 Simple Substation Example

Worldview for Windows Editors Guide

Worldview for Windows Editors Guide

Figure 3-3 New Map Window

to open the Edit toolbar that consist the Library Selector

Figure 3-4 Library Selector Window

Worldview for Windows Editors Guide

Creating Drawing Styles

Figure 3-5 Pop-up Menu in Drawing Styles Window

Worldview for Windows Editors Guide

Figure 3-6 a)Drawing Style Editor, b)Yellow Drawing Style

Worldview for Windows Editors Guide

Creating Text Styles

Figure 3-8 Text Styles of Library Selector

Worldview for Windows Editors Guide

Figure 3-9 Text Styles Editor

Worldview for Windows Editors Guide

Worldview for Windows Editors Guide

Figure 3-13 Grid Dialog

Figure 3-14 Red Square Symbol

Worldview for Windows Editors Guide

4. Select the Filled Ellipse

tool from the Edit bar.

4. Select the Filled Polygon Worldview for Windows Editors Guide

tool from the Edit bar. Getting Started 3-12

1. In the Edit bar, click on the Select (arrow)

in the Tool bar.

4. Select the Open Polygon tool from the Edit bar.

The mouse pointer turns into a cross-hair cursor.