Wincc 7.2 Manual

SIMATIC HMIWinCC V7.2WinCC: Tools (SmartTools, User Archive, Interfaces)System Manual

Print of the Online Help

02/2013A5E32317002-AA

SmartTools 1

User archive 2

COM Provider in the Layout Editor

3

OPC - Open Connectivity 4

Legal informationWarning notice system

This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are graded according to the degree of danger.

DANGERindicates that death or severe personal injury will result if proper precautions are not taken.

WARNINGindicates that death or severe personal injury may result if proper precautions are not taken.

CAUTIONindicates that minor personal injury can result if proper precautions are not taken.

NOTICEindicates that property damage can result if proper precautions are not taken.If more than one degree of danger is present, the warning notice representing the highest degree of danger will be used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to property damage.

Qualified PersonnelThe product/system described in this documentation may be operated only by personnel qualified for the specific task in accordance with the relevant documentation, in particular its warning notices and safety instructions. Qualified personnel are those who, based on their training and experience, are capable of identifying risks and avoiding potential hazards when working with these products/systems.

Proper use of Siemens productsNote the following:

WARNINGSiemens products may only be used for the applications described in the catalog and in the relevant technical documentation. If products and components from other manufacturers are used, these must be recommended or approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and maintenance are required to ensure that the products operate safely and without any problems. The permissible ambient conditions must be complied with. The information in the relevant documentation must be observed.

TrademarksAll names identified by are registered trademarks of Siemens AG. The remaining trademarks in this publication may be trademarks whose use by third parties for their own purposes could violate the rights of the owner.

Disclaimer of LiabilityWe have reviewed the contents of this publication to ensure consistency with the hardware and software described. Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the information in this publication is reviewed regularly and any necessary corrections are included in subsequent editions.

Siemens AGIndustry SectorPostfach 48 4890026 NRNBERGGERMANY

A5E32317002-AA 02/2013 Technical data subject to change

Copyright Siemens AG 2013.All rights reserved

Table of contents

1 SmartTools.................................................................................................................................................11 1.1 Overview......................................................................................................................................11 1.2 Tag Export/Import........................................................................................................................12 1.2.1 Tag Export/Import........................................................................................................................12 1.2.2 Installation of Export/Import Tags................................................................................................12 1.2.3 Operation.....................................................................................................................................13 1.2.4 The Tag Export/Import tool..........................................................................................................14 1.2.5 Connections.................................................................................................................................15 1.2.6 File structures..............................................................................................................................15 1.2.7 Tag..............................................................................................................................................16 1.2.8 Appendix......................................................................................................................................18 1.3 Tag simulator...............................................................................................................................20 1.3.1 The Tag simulator........................................................................................................................20 1.3.2 Using the tag Simulator...............................................................................................................20 1.3.3 Functions of the simulator...........................................................................................................21 1.3.4 Installing the simulator.................................................................................................................22 1.3.5 Adding/deleting tags....................................................................................................................23 1.3.6 Parameter assignment of the functions.......................................................................................23 1.3.7 Activating/deactivating tags.........................................................................................................24 1.3.8 Display of the tags.......................................................................................................................24 1.3.9 Loading/saving simulation data...................................................................................................24 1.3.10 FAQ.............................................................................................................................................25 1.4 Dynamic Wizard Editor................................................................................................................26 1.4.1 Dynamic Wizard Editor................................................................................................................26 1.4.2 Overview......................................................................................................................................26 1.4.3 Installation of the Dynamic Wizard Editor....................................................................................28 1.4.4 Structure......................................................................................................................................29 1.4.4.1 Structure......................................................................................................................................29 1.4.4.2 Toolbar........................................................................................................................................30 1.4.4.3 Editor window..............................................................................................................................31 1.4.4.4 Help Editor...................................................................................................................................32 1.4.4.5 Output window.............................................................................................................................33 1.4.5 Structure of a Dynamic Wizard function......................................................................................34 1.4.5.1 Structure of a Dynamic Wizard function......................................................................................34 1.4.5.2 Dynamic Wizard dialog................................................................................................................34 1.4.5.3 Integrating header files and DLLs................................................................................................35 1.4.5.4 Language-dependent definitions.................................................................................................35 1.4.5.5 Wizard flags.................................................................................................................................36 1.4.5.6 Property list..................................................................................................................................37 1.4.5.7 System interface..........................................................................................................................38 1.4.5.8 Global variables...........................................................................................................................39 1.4.5.9 Options list...................................................................................................................................39 1.4.5.10 Trigger list....................................................................................................................................42 1.4.5.11 Display of parameter assignment................................................................................................44

WinCC: Tools (SmartTools, User Archive, interfaces)System Manual, 02/2013, A5E32317002-AA 3

1.4.5.12 Wizard Functions for parameter input.........................................................................................45 1.4.5.13 Wizard functions for generating dynamics...................................................................................70 1.4.5.14 Wizard WinCC functions..............................................................................................................82 1.4.5.15 Wizard progress functions...........................................................................................................86 1.4.5.16 Wizard Windows functions..........................................................................................................89 1.4.6 Examples.....................................................................................................................................95 1.4.6.1 Examples.....................................................................................................................................95 1.4.6.2 Demo Wizard...............................................................................................................................95 1.4.6.3 Dynamic motor............................................................................................................................98 1.5 Documentation Viewer..............................................................................................................102 1.5.1 WinCC Documentation Viewer..................................................................................................102 1.5.2 Installing WinCC Documentation Viewer...................................................................................102 1.5.3 Description.................................................................................................................................103 1.5.4 Creating the .emf file(s).............................................................................................................104 1.6 WinCC CrossReferenceAssistant..............................................................................................105 1.6.1 WinCC CrossReferenceAssistant..............................................................................................105 1.6.2 Installation of the CrossReferenceAssistant..............................................................................105 1.6.3 General......................................................................................................................................105 1.6.4 Known functions (script management)......................................................................................106 1.6.5 Project selection........................................................................................................................110 1.6.6 File selection..............................................................................................................................111 1.6.7 Conversion................................................................................................................................112 1.6.8 Expanded settings.....................................................................................................................113 1.7 WinCC Communication Configurator........................................................................................115 1.8 WinCC Configuration Tool.........................................................................................................116 1.8.1 Introduction................................................................................................................................116 1.8.2 System requirements.................................................................................................................117 1.8.3 Installation of the ConfigurationTool..........................................................................................117 1.8.4 Interface.....................................................................................................................................118 1.8.4.1 Interface.....................................................................................................................................118 1.8.4.2 Toolbar......................................................................................................................................118 1.8.4.3 Dropdown menu........................................................................................................................119 1.8.4.4 Pop-up menu.............................................................................................................................121 1.8.4.5 Status bar..................................................................................................................................122 1.8.5 Operation of the WinCC configuration tool................................................................................122 1.8.5.1 Operation of the configuration tool............................................................................................122 1.8.5.2 Creating a new project folder.....................................................................................................125 1.8.5.3 Worksheets................................................................................................................................135 1.8.5.4 Dialogs.......................................................................................................................................195 1.8.5.5 Processing configured data.......................................................................................................202 1.8.5.6 Creating objects by means of the pop-up menu of the tag table...............................................218 1.8.5.7 Changing the data storage location...........................................................................................234 1.8.6 Diagnostics................................................................................................................................235 1.8.6.1 Diagnostics................................................................................................................................235 1.8.6.2 Error column..............................................................................................................................236 1.8.7 Tips and tricks...........................................................................................................................238 1.8.7.1 Tips and tricks...........................................................................................................................238 1.8.7.2 Example of a quantity structure in the configuration tool...........................................................238 1.8.7.3 Changing the worksheet............................................................................................................240 1.8.7.4 Row limitation............................................................................................................................242

Table of contents

WinCC: Tools (SmartTools, User Archive, interfaces)4 System Manual, 02/2013, A5E32317002-AA

1.8.7.5 Address generation...................................................................................................................242 1.8.7.6 VBA macros...............................................................................................................................246 1.8.7.7 Special characters.....................................................................................................................246 1.8.7.8 Address strings for Simatic S7 Protocol Suite...........................................................................247 1.8.7.9 Packages...................................................................................................................................249 1.9 WinCC Archive ConfigurationTool.............................................................................................250 1.9.1 Introduction................................................................................................................................250 1.9.2 System requirements.................................................................................................................251 1.9.3 Installation of the Archive ConfigurationTool.............................................................................251 1.9.4 Quick start.................................................................................................................................252 1.9.5 Operating WinCC Archive.........................................................................................................259 1.9.5.1 Operating WinCC Archive.........................................................................................................259 1.9.5.2 Creating an archive folder.........................................................................................................260 1.9.5.3 Configuring a process value archive.........................................................................................267 1.9.5.4 Configuring a compressed archive............................................................................................284 1.9.5.5 Checking the archive data.........................................................................................................292 1.9.5.6 Creating, modifying and deleting...............................................................................................2982 User archive..............................................................................................................................................307 2.1 Introduction to archives/user archives.......................................................................................307 2.2 User archives and redundancy..................................................................................................309 2.3 Working with the "User Archive" editor......................................................................................310 2.3.1 Structure of the "User Archive" editor........................................................................................310 2.3.2 Configuration of a User Archive.................................................................................................311 2.3.2.1 How to create a user archive.....................................................................................................311 2.3.2.2 How to configure the communication to tags.............................................................................312 2.3.2.3 How to configure the control tags..............................................................................................313 2.3.2.4 Example for the use of control tags...........................................................................................314 2.3.2.5 How to specify the authorizations for the archive......................................................................318 2.3.2.6 How to create user archive fields..............................................................................................319 2.3.2.7 How to set the values of the user archive fields........................................................................320 2.3.2.8 How to specify the authorizations and conditions of the field....................................................321 2.3.2.9 How to configure multilingual text..............................................................................................322 2.3.2.10 How to make changes in the user archive.................................................................................323 2.3.3 Configuring a view.....................................................................................................................324 2.3.3.1 How to create a view.................................................................................................................324 2.3.3.2 How to create the columns of a view.........................................................................................325 2.3.3.3 How to specify the relation of a view.........................................................................................326 2.3.4 Overview of unusable names....................................................................................................326 2.3.5 How to export the configuration data of the user archive..........................................................328 2.3.6 How to import the configuration data of the user archive..........................................................329 2.3.7 How to edit the runtime data in the user archive.......................................................................331 2.3.8 How to export runtime data of the user archive.........................................................................331 2.3.9 How to import runtime data of the user archive.........................................................................333 2.4 Data communication with automation systems.........................................................................336 2.4.1 SIMATIC interfaces...................................................................................................................336 2.4.2 Data communication with S7 via raw data tags.........................................................................336 2.4.2.1 How to configure data communication via raw data tags..........................................................336 2.4.2.2 Data format differences between WinCC and S5/S7................................................................338 2.4.2.3 Sending jobs and data from S7 to WinCC.................................................................................339

Table of contents


2.4.2.4 Receiving data and processing acknowledgment in S7............................................................340 2.4.2.5 Structure of the message frame header....................................................................................340 2.4.2.6 Job Header................................................................................................................................341 2.4.2.7 Data of the job...........................................................................................................................342 2.4.2.8 The acknowledgement header..................................................................................................342 2.4.2.9 Description of the job types.......................................................................................................343 2.4.2.10 Description of the error codes...................................................................................................344 2.5 User archive functions...............................................................................................................345 2.5.1 General information...................................................................................................................345 2.5.2 How to use the functions of the user archive.............................................................................346 2.5.3 Example of a user archive script...............................................................................................348 2.5.4 Functions for Configuring User Archives...................................................................................357 2.5.4.1 Functions for Configuring User Archives...................................................................................357 2.5.4.2 uaAddArchive............................................................................................................................357 2.5.4.3 uaAddField................................................................................................................................358 2.5.4.4 uaGetArchive.............................................................................................................................358 2.5.4.5 uaGetField.................................................................................................................................359 2.5.4.6 uaGetNumArchives...................................................................................................................360 2.5.4.7 uaGetNumFields........................................................................................................................360 2.5.4.8 UaQueryConfiguration...............................................................................................................361 2.5.4.9 uaReleaseConfiguration............................................................................................................361 2.5.4.10 uaRemoveAllArchives...............................................................................................................362 2.5.4.11 uaRemoveAllFields....................................................................................................................363 2.5.4.12 uaRemoveArchive.....................................................................................................................363 2.5.4.13 uaRemoveField.........................................................................................................................364 2.5.4.14 uaSetArchive.............................................................................................................................364 2.5.4.15 uaSetField.................................................................................................................................365 2.5.4.16 Structure of the field configuration "uaCONFIGFIELD".............................................................366 2.5.4.17 Structure of the user archive configuration "uaCONFIGARCHIVE"..........................................366 2.5.5 General runtime functions.........................................................................................................368 2.5.5.1 General runtime functions.........................................................................................................368 2.5.5.2 uaConnect.................................................................................................................................368 2.5.5.3 uaDisconnect.............................................................................................................................369 2.5.5.4 uaGetLocalEvents.....................................................................................................................369 2.5.5.5 uaIsActive..................................................................................................................................370 2.5.5.6 uaOpenArchives........................................................................................................................370 2.5.5.7 uaOpenViews............................................................................................................................371 2.5.5.8 uaQueryArchive.........................................................................................................................371 2.5.5.9 uaQueryArchiveByName...........................................................................................................372 2.5.5.10 uaReleaseArchive.....................................................................................................................373 2.5.5.11 uaSetLocalEvents......................................................................................................................373 2.5.5.12 uaUsers.....................................................................................................................................374 2.5.6 Archive-specific runtime functions.............................................................................................374 2.5.6.1 Archive-specific runtime functions.............................................................................................374 2.5.6.2 uaArchiveClose.........................................................................................................................376 2.5.6.3 uaArchiveDelete........................................................................................................................376 2.5.6.4 uaArchiveExport........................................................................................................................377 2.5.6.5 uaArchiveGetCount...................................................................................................................378 2.5.6.6 uaArchiveGetFieldLength..........................................................................................................378 2.5.6.7 uaArchiveGetFieldName...........................................................................................................379 2.5.6.8 uaArchiveGetFields...................................................................................................................379 2.5.6.9 uaArchiveGetFieldType.............................................................................................................380

Table of contents


2.5.6.10 uaArchiveGetFieldValueDate....................................................................................................381 2.5.6.11 uaArchiveGetFieldValueDouble................................................................................................381 2.5.6.12 uaArchiveGetFieldValueFloat....................................................................................................382 2.5.6.13 uaArchiveGetFieldValueLong....................................................................................................383 2.5.6.14 uaArchiveGetFieldValueString..................................................................................................383 2.5.6.15 uaArchiveGetFilter.....................................................................................................................384 2.5.6.16 uaArchiveGetID.........................................................................................................................384 2.5.6.17 uaArchiveGetName...................................................................................................................385 2.5.6.18 uaArchiveGetSort......................................................................................................................386 2.5.6.19 uaArchiveImport........................................................................................................................386 2.5.6.20 uaArchiveInsert..........................................................................................................................387 2.5.6.21 uaArchiveMoveFirst...................................................................................................................387 2.5.6.22 uaArchiveMoveLast...................................................................................................................388 2.5.6.23 uaArchiveMoveNext..................................................................................................................388 2.5.6.24 uaArchiveMovePrevious............................................................................................................389 2.5.6.25 uaArchiveOpen..........................................................................................................................389 2.5.6.26 uaArchiveReadTagValues.........................................................................................................390 2.5.6.27 uaArchiveReadTagValuesByName...........................................................................................390 2.5.6.28 uaArchiveRequery.....................................................................................................................391 2.5.6.29 uaArchiveSetFieldValueDate.....................................................................................................392 2.5.6.30 uaArchiveSetFieldValueDouble.................................................................................................392 2.5.6.31 uaArchiveSetFieldValueFloat....................................................................................................393 2.5.6.32 uaArchiveSetFieldValueLong....................................................................................................394 2.5.6.33 uaArchiveSetFieldValueString...................................................................................................394 2.5.6.34 uaArchiveSetFilter.....................................................................................................................395 2.5.6.35 uaArchiveSetSort.......................................................................................................................396 2.5.6.36 uaArchiveUpdate.......................................................................................................................396 2.5.6.37 uaArchiveWriteTagValues.........................................................................................................397 2.5.6.38 uaArchiveWriteTagValuesByName...........................................................................................398 2.5.7 Troubleshooting functions .....................................................................................................398 2.5.7.1 uaGetLastError..........................................................................................................................398 2.5.7.2 uaGetLastHResult.....................................................................................................................400 2.6 WinCC UserArchiveControl.......................................................................................................401 2.6.1 WinCC UserArchiveControl.......................................................................................................401 2.6.2 Configuring the UserArchiveControl..........................................................................................402 2.6.2.1 How to configure the UserArchiveControl.................................................................................402 2.6.2.2 How to define the contents of the UserArchiveControl..............................................................404 2.6.2.3 How to configure the display for the table.................................................................................407 2.6.2.4 How to configure the toolbar and the status bar .......................................................................411 2.6.2.5 How to export runtime data.......................................................................................................415 2.6.2.6 How to define the effect of the online configuration..................................................................416 2.6.2.7 How to make the toolbar for the UserArchiveControl dynamic..................................................418 2.6.3 Operation in runtime..................................................................................................................420 2.6.3.1 Operating the UserArchiveControl in runtime............................................................................420 2.6.3.2 To process the data in the UserArchiveControl:........................................................................422 2.6.3.3 How to select the data of the user archive................................................................................424 2.6.3.4 How to sort the display of user archive data..............................................................................425 2.7 Before WinCC V7: WinCC User Archives Table Element.........................................................428 2.7.1 User Archives Table Element....................................................................................................428 2.7.2 Functionality..............................................................................................................................428 2.7.3 Configuration of User Archives Table Element..........................................................................429

Table of contents


2.7.3.1 Configuring a User Archives Table Element..............................................................................429 2.7.3.2 Place the User Archive Table Element in a process screen......................................................429 2.7.3.3 Define properties of the User Archives Table Element..............................................................431 2.7.3.4 Delete the User Archives Table Element...................................................................................432 2.7.4 Properties of WinCC User Archives Table Element..................................................................432 2.7.4.1 Properties of WinCC User Archives Table Element..................................................................432 2.7.4.2 "General" tab.............................................................................................................................433 2.7.4.3 "Columns" tab............................................................................................................................434 2.7.4.4 "Toolbar" Tab.............................................................................................................................435 2.7.4.5 "Status Bar" Tab........................................................................................................................435 2.7.4.6 "Filter/ Sorting" tab.....................................................................................................................436 2.7.4.7 "Fonts" Tab................................................................................................................................437 2.7.4.8 "Colors" tab................................................................................................................................437 2.7.5 Configuring a Form View...........................................................................................................437 2.7.5.1 Configuring a Form View...........................................................................................................437 2.7.5.2 Insert "Text" form field...............................................................................................................439 2.7.5.3 Insert "Edit" form field................................................................................................................440 2.7.5.4 Insert "Button" form field............................................................................................................441 2.7.5.5 Edit form fields subsequently.....................................................................................................442 2.7.5.6 Delete form fields.......................................................................................................................442 2.7.6 User Archives Table Elements in Runtime................................................................................442 2.7.6.1 Table of User Archives Table Element......................................................................................442 2.7.6.2 The User Archives Table Element Form...................................................................................443 2.7.6.3 Toolbar of WinCC User Archives Table Element......................................................................444 2.7.6.4 Operating the Control using Dynamized Objects......................................................................448 2.7.6.5 List of properties for the User Archives Table Element.............................................................451 2.7.6.6 Overview of the dynamizable properties in the layout...............................................................4543 COM Provider in the Layout Editor...........................................................................................................457 3.1 COM Provider in the Layout Editor............................................................................................457 3.2 Working with COM Server Objects............................................................................................458 3.3 How to Output Data from a COM Server in a Report................................................................459 3.4 Example of an integration of a COM server..............................................................................460 3.5 Details of the COM Interface for Reporting...............................................................................4614 OPC - Open Connectivity.........................................................................................................................465 4.1 OPC - Open Connectivity..........................................................................................................465 4.2 Functionality of OPC..................................................................................................................466 4.3 OPC Specifications....................................................................................................................467 4.4 Compatibility..............................................................................................................................468 4.5 Using OPC in WinCC................................................................................................................469 4.6 WinCC OPC XML DA Server....................................................................................................471 4.6.1 Functionality of WinCC OPC XML DA server............................................................................471 4.6.2 Installation.................................................................................................................................472 4.6.2.1 Installation.................................................................................................................................472 4.6.2.2 Installing the Internet Information Service (IIS).........................................................................472 4.6.2.3 Installing Microsoft .NET Framework.........................................................................................473 4.6.2.4 Installing WinCC OPC XML DA Server.....................................................................................474

Table of contents


4.7 WinCC OPC DA server.............................................................................................................475 4.7.1 Functionality of the WinCC OPC DA Server..............................................................................475 4.7.2 Using Multiple OPC DA Servers................................................................................................476 4.7.3 Querying the OPC DA Server Name.........................................................................................477 4.7.4 Examples of OPC DA Connections...........................................................................................478 4.7.4.1 WinCC - WinCC Connection.....................................................................................................478 4.7.4.2 WinCC - SIMATIC NET FMS OPC Server Connection.............................................................482 4.7.4.3 WinCC - SIMATIC NET S7-OPC Server Connection................................................................485 4.7.4.4 WinCC - Microsoft Excel Connection........................................................................................490 4.8 WinCC OPC HDA server...........................................................................................................495 4.8.1 Functionality of the WinCC OPC HDA server............................................................................495 4.8.2 Data Structure of a WinCC OPC HDA Server...........................................................................496 4.8.2.1 Data Structure of a WinCC OPC HDA Server...........................................................................496 4.8.2.2 Overview of the supported attributes.........................................................................................497 4.8.2.3 Overview of the supported assemblies......................................................................................498 4.8.2.4 Overview of the supported functions.........................................................................................499 4.8.2.5 Time Format of a WinCC OPC HDA Server..............................................................................500 4.8.3 Quality codes.............................................................................................................................501 4.8.4 Supported Write-Accesses........................................................................................................502 4.8.5 Example of an OPC HDA Connection.......................................................................................504 4.8.5.1 Example of an OPC HDA Connection.......................................................................................504 4.8.5.2 HDA server browser..................................................................................................................505 4.8.5.3 How to Configure Access to a WinCC Archive Tag Using the HDA Server Browser................507 4.8.5.4 Reading Values of WinCC Archive Tags...................................................................................508 4.8.6 Special features of the OPC HDA server in WinCC for acyclic logging.....................................510 4.9 WinCC OPC A&E Server...........................................................................................................513 4.9.1 Functionality of the WinCC OPC A&E server............................................................................513 4.9.2 Mapping of the WinCC Message System on OPC A&E............................................................514 4.9.2.1 Mapping of the WinCC Message System on OPC A&E....................................................514 4.9.2.2 Mapping the WinCC message classes and message types......................................................515 4.9.2.3 Mapping the WinCC message priority.......................................................................................516 4.9.2.4 Attributes of the WinCC Message System................................................................................516 4.9.2.5 Acknowledgement theory..........................................................................................................518 4.9.3 Quality Codes for OPC A&E......................................................................................................520 4.9.4 Example of an OPC A&E Connection.......................................................................................520 4.9.4.1 Example of an OPC A&E Connection.......................................................................................520 4.9.4.2 How to Configure Access to the WinCC Message System.......................................................521 4.9.5 OPC A&E server with hierarchical access.................................................................................523 4.9.5.1 Functionality of the OPC A&E server........................................................................................523 4.9.5.2 OPC A&E Server of WinCC V6.2 SP2 or higher.......................................................................525 4.9.5.3 Mapping the WinCC Message System on OPC A&E................................................................528 4.9.5.4 Quality Codes for OPC A&E......................................................................................................533 4.9.6 Reading archived messages.....................................................................................................534 4.9.6.1 Accessing archived events........................................................................................................534 4.9.6.2 Syntax for accessing archived messages using OPC...............................................................535 4.9.6.3 Read methods for archived messages......................................................................................536 4.9.6.4 Identifying archived messages..................................................................................................537 4.10 WinCC OPC UA Server.............................................................................................................539 4.10.1 Principle of operation the WinCC OPC UA Server ...................................................................539 4.10.2 Security concept of OPC UA.....................................................................................................540

Table of contents


4.10.3 OPC UA Services support.........................................................................................................542 4.10.4 Name area of the WinCC OPC UA server.................................................................................543 4.10.5 OPC UA Data Access................................................................................................................545 4.10.6 OPC UA Log Access.................................................................................................................546 4.10.7 Configuring the WinCC OPC UA server....................................................................................547 4.10.7.1 Configuration file........................................................................................................................547 4.10.7.2 How to configure the OPC UA server........................................................................................548 4.11 Commissioning..........................................................................................................................551 4.11.1 OPC Commissioning.................................................................................................................551 4.11.2 Configuring Windows.................................................................................................................551 4.11.2.1 This is how you configure Windows accounts for the use of WinCC OPC................................551 4.11.2.2 How to adapt the Windows firewall settings..............................................................................552 4.11.3 XML...........................................................................................................................................553 4.11.3.1 Commissioning - OPC XML.......................................................................................................553 4.11.3.2 Defining the Security Settings with IIS.......................................................................................553 4.11.3.3 How to set the correct version of ASP.NET...............................................................................555 4.11.3.4 How to Test the Installation.......................................................................................................555 4.11.4 Trace.........................................................................................................................................557 Index.........................................................................................................................................................559

Table of contents


SmartTools 11.1 OverviewContents

Smart Tools is a collection of programs which are useful when working with WinCC.It contains the following programs and files: Tag Simulator Tag Export/Import Dynamic Wizard Editor Documentation Viewer WinCC CrossReferenceAssistant Communication Configurator WinCC Configuration Tool WinCC Archive ConfigurationTool

Note

Smart Tools are supplementary tools. Bear in mind that they may have an impact on how WinCC works, such as on its runtime behavior and memory requirements.As far as user friendliness and functionality are concerned, the same criteria as for the WinCC Basis software do not necessarily apply.

See alsoWinCC Communication Configurator (Page 115)Tag Export/Import (Page 12)The Tag simulator (Page 20)Dynamic Wizard Editor (Page 26)WinCC Documentation Viewer (Page 102)WinCC CrossReferenceAssistant (Page 105)


1.2 Tag Export/Import

1.2.1 Tag Export/Import

Short descriptionThe program exports all connections, all data structures and all tags from an open project into corresponding ASCII files. These can then be imported into a second project. The ASCII format allows processing the data with a spreadsheet program before reimporting them.

1.2.2 Installation of Export/Import Tags

IntroductionTag Export/Import can be installed in two different ways:This program can only be used in a meaningful manner, if WinCC has been installed as well.

RequirementsIn WinCC multi-user projects the Smart Tool "Tag Export/Import" cannot be used for a client without its own project.

Procedure1. During WinCC setup, select "WinCC V7 complete" from the "Programs" dialog.

WinCC is installed together with SmartTools, the WinCC ConfigurationTool and WinCC Archive ConfigurationTool.

The Tag Export/Import application is started by selecting "SIMATIC > WinCC > Tools > Tag Export Import".

Alternative ProcedureYou can also install the Tag Export/Import application from the WinCC DVD.1. Switch to the WinCC DVD directory "WinCC\InstData\Smarttools\Setup".2. Double-click setup.exe.3. From the "Components" dialog select "VarExpImp".4. Click "Continue". Follow the on-screen instructions.

SmartTools1.2 Tag Export/Import


1.2.3 Operation

EXPORT1. First start WinCC and open the project from which to export tags. Start "VAR_EXIM.EXE"2. Select path and name of the file to which to export. Initially only the name of the file without

extension is needed.3. Select the "Export" mode.4. Press "Execute". Confirm the information in the message box.5. Wait until "End Export/Import" is displayed in the status bar.6. You can view the created files using the respective buttons "tag" (tags), "con" (connections),

"dex" (structures) and "diag" (logbook).

Empty groups are not exported.The underscore ( _ ) is reserved for naming. This is why file names must not contain underscores.

IMPORT1. First start WinCC and open the project into which to import tags.2. All channel drivers into which the connections are to be imported must be available in the

project. If required, add missing drivers to the project. 3. Start "VAR_EXIM.EXE"4. Select path and name of the file from which to import. Initially only the name of the file

without extension is needed. When using the selection dialog, click on one of the three exported files.

5. Select the "Import" or "ImportOverwrite" mode. In the "ImportOverwrite" mode tags already existing in the target project are overwritten with imported tags bearing the same name. In the "Import" modus a message is written into the logbook file instead and the tag in the target project remains unchanged.

6. Press "Execute". Confirm the information in the message box.7. Wait until "End Export/Import" is displayed in the status bar.8. View the created data in the WinCC tag management.

In both modes import is not possible with WinCC Runtime enabled.The following sections describe the technical details of the Tag Export/Import. However, these information are not necessarily required for the standard case of a target computer with the same system configuration as the WinCC system used for exporting. Knowledge of the WinCC variable structure is only required if you want to create new tags or modify existing tags via the ASCII files.



1.2.4 The Tag Export/Import toolThe "Tag Export/Import" tool is an independent application based on the WinCC API. The tool may be used for exporting all WinCC tags of a project into ASCII files as well as for importing tags, e.g. into a second project. In doing so, three files are created. [name]_cex.csv for the logical connections [name]_dex.csv for the structural descriptions [name]_vex.csv for the tag descriptionsIn the files, a header is generated informing about the data created. During import the three files are automatically read in.The file [name]_cex.csv is imported first, as the tags can only be created if the associated connection already exists.This is followed by the data structures defined in the file [name]_dex.csv. These are user-defined data types which have to be known before creating a tag of this type.Afterwards the tag definitions from the file [name]_vex.csv are read in.Tag groups cannot be created independently from a tag. If a group does not exist, it is automatically created together with the tag. This is why no group file is generated when exporting. If groups are defined in your project which contain no tag, these groups are not exported.When creating a tag, the addressing defining the physical location of the tag in the automation system is configured, among others. This address depends on the connection channel and the connected automation system. When configuring via WinCC Explorer the user is presented a channel dependent input screen. When editing an inport file of "Tag Export/Import" these characteristics have to be taken into account.In any case, exported tags are only to be imported in a second WinCC project if this system has the same configuration as the system on which the data were exported. When data are imported into a project, possibly already existing tags must be known. If required, the addresses have to be corrected manually.On the other hand, the import of tags from systems with another channel configuration may be possible in some cases. The success of such a procedure depends on channel and AS! The exported structure types, however, are hardware-independent. All channel or connection specific parameters such as Connection, GroupName, address information are not considered. These parameters are only defined when creating a structure tag.

Points to note about exporting the address string in szSpecificThe address string is checked by the channel specific software when creating the tag. These channel DLLs expect a certain syntax which must not undergo country-specific changes. This is why the address strings are placed in additional " " parantheses when exporting, which are later removed during import. This is to make sure tools like Excel do not change the address information (list separator problem).



1.2.5 ConnectionsA connection can only be imported if a corresponding channel driver has been configured. In addition, the parameters in the file [name]_cex.csv must be suited to the configured channel driver.Should the target computer use a different channel than the system from which the exported data originate, this is the first change which has to be made to the exported data. A simpe procedure to determine the required connection data:Configure all connections on the target computer and start the export process. This allows you to get the parameters of your target computer from the file [name]_cex.csv.

Example of a logical connection:

#Conname Unit Common Specific FlagVerbAS1 Industrial Ethernet General "" 0VerbAS2 Profibus FMS General "" 0

The second line shows the logical connection of an Industrial Ethernet driver from the Simatic S7 Protocol Suite.The third line contains the logical connection of a Profibus FMS driver.Under #Conname the name of the logical connection is given. In the exported file you find this logical connection name in the tag data. The logical connection is used for the communication with the automation system to access the external tags in the process.

1.2.6 File structuresStructure of the file [name]_dex.csv:

#Structure Name Type ID Creator ID Project Path Control_1 1001 2500 C:\Testdaten\Proj.mcp #Varname C.Vartype C.CreatorID C.VarLength etc.NewTag1 ... ... ... ...NewTag2 ... ... ... ...NewTag3 ... ... ... ...etc. ... ... ... ...

#: Comment character#Structure Name: The next line contains the name of the file structure with structure-specific

parameters. The indication of the project path only serves to document from which project the data were exported. The data are imported automatically into the currently opened project.

#Varname: The next lines contain the elements of the file structure until a new line #Structure Name is detected or no further lines are defined. One line contains all parameters required for defining a tag.



Remark for WinCC API users:The column heading of the first line shows the names of the parameters in the corresponding file structures of the API calls. The data may then be clearly interpreted in an Excel table.If a name is given with a letter followed by a point this is to facilitate the assignment to the API calls.

Example:

C.nnnnnn contained in Common substructureP.nnnnnn contained in Protocol substructureL.nnnnnn contained in Limits substructureS.nnnnnn contained in Scaling substructure

1.2.7 TagTags and connections consist of a general part and a specific part. The specific part is always provided by the channel DLL. Even though this part may be missing during configuration (it must be defined prior to activation), all objects whose specific part is missing will be ignored during import. The missing parts will be replaced by '*' during export.

Importing tags of a user-defined type.A predefined WinCC tag is identified by a data type with a value between 1 and 18.A user-defined structure type receives as data type the TypID which was assigned during creation of the data structure by the data manager. This TypID is greater than 1000.A structure type is determined by its name and its data type.The name of the data structure is identical on the computer from which it was exported and the computer on which it was imported. The TypID, however, does not have to or will not be identical.In order to create a tag of the type structure type, an assignment must be made from TypID to structure name.

Example:The structure types are exported to the file [name]_dex.csv.



#Structure Name

Type ID Creator ID Project Path

ExternStr1 1046 0 G:\Testdaten\... #Varname C.Vartype C.CreatorID C.VarLength C.VarProperty ...Tag1 1 0 2 ... ...Tag2 2 0 1 ... ...Tag3 3 0 1 ... ...Tag4 4 0 2 ... ...

The tags are exported to the file [name]_vex.csv.

#Varname Conn Group Spec Flag CTypInstExStr1 VerbLp GruLp DB200,DBB10 0 1046InstExStr1.Tag1 VerbLp GruLp DB200,D10.0 0 1InstExStr1.Tag2 VerbLp GruLp DB200,DBB10 0 2InstExStr1.Tag3 VerbLp GruLp DB200,DBB10 0 3InstExStr1.Tag4 VerbLp GruLp DB200,DBB10 0 4

In the file [name]_dex.csv a structure type with name ExternStr1 and TypID 1046 is defined.In the file [name]_vex.csv a structure tag of type ExternStr1 with name InstExStr1 is defined. The assignment that this represents a structure type ExternStr1 is made by the value in column CTyp, which contains TypID 1046 of this structure type.In order to import a structure tag, the structure type must also be contained in the file [name]_dex.csv, and tags of this type in the file [name]_vex.csv.Tag Import/Export remembers the Name/TypID assignment to quantify the structure tags even if the TypID is different on the target computer.If you wish to import tags of the type "user-defined" without reading the data structure during import (e.g. no file [name]_dex.csv), the TypID of the target computer of this data structure must be manually edited in the csv file. In this case, the TypID will be determined by using the exported file [name]_dex.csv of the target computer, as described above.The tag properties are displayed in column CPro as decimal value in the exported file [name]_vex.csv . The following tag properties exist:

Tag property Decimal value Hexadecimal valueInternal tag with project-wide updates 2 2Internal tag with computer-specific updates

8194 2002

External tag 4 4For example, if internal tags with computer-specific updates are to be exported from WinCC but internal tags with project-wide updates are to be imported in WinCC, the value of the tag property in column CPro may be changed in the export file from 8194 to 2 for the respective tags. Subsequently, the modified export file is saved and imported in WinCC.



1.2.8 AppendixTag fields----------------Varname: char szVarName[MAX_DM_VAR_NAME +1];Conn: char szConnection[MAX_DM_CONNECTION_NAME +3];Group: char szGroupName[MAX_DM_GROUP_NAME +1];Spec: char szSpecific[MAX_DM_VAR_SPECIFIC +1];Flag: DWORD dwFlags; CommonCtyp: DWORD dwVarType; // Variable typeCLen: DWORD dwVarLength; // Variable lengthCPro: DWORD dwVarProperty; // Variable property internal/externalCFor: DWORD dwFormat; // Format convertion Protocol:P1 : BOOL bTopLimitErr; // error in top limitP2 : BOOL bBottomLimitErr; // error in bottom limitP3 : BOOL bTransformationErr; // transformation errorP4 : BOOL bWriteErr; // write errorP5 : BOOL bWriteErrApplication;P6 : BOOL bWriteErrProcess; Limits valuesLF1: double dTopLimit;LF2: double dBottomLimit;LF3: double dStartValue;LF4: double dSubstituteValue; Limits flagsL1 : BOOL bTopLimit; // use substitute value on top limitL2 : BOOL bBottomLimit; // use substitute value on bottom limitL3 : BOOL bStartValue; // use substitute value on startL4 : BOOL bConnectionErr; // use substitute value on error connectionL5 : BOOL bTopLimitValid; // value top limit is valid



L6 : BOOL bBottomLimitValid; // value bottom limit is validL7 : BOOL bStartValueValid; // value start is validL8 : BOOL bSubstValueValid; // value substitute is valid Values for the field Ctyp-------------------------BIT 1SBYTE 2BYTE 3SWORD 4WORD 5SDWORD 6DWORD 7FLOAT 8DOUBLE 9TEXT_8 10TEXT_16 11RAW 12ARRAY 13STRUCT 14BITFIELD_8 15BITFIELD_16 16BITFIELD_32 17TEXTREF 18 Description of connection fields--------------------------------Conname: char szConnection[MAX_DM_CONNECTION_NAME +3];Unit: char szUnitName [MAX_DM_UNIT_NAME+1];Common: char szCommon [MAX_DM_CON_COMMON +1]Specific: char szSpecific [MAX_DM_CON_SPECIFIC +1] ;



1.3 Tag simulator

1.3.1 The Tag simulator

Short descriptionThe tag simulator is used to simulate internal tags and process tags.A typical area of application for the tag simulator is the testing of a configuration without connected process peripherals or with connected process peripherals but without a running process.Without a connected process, only internal tags may be simulated.In case of connected process peripherals, the process tags may be directly supplied with values by the tag simulator. This allows you to perform a function test of the HMI system using the original hardware.The updating time for tag values is one second. Any changes take effect only upon activation of the functions or changes of the project folder. A maximum number of 300 tags may be configured.Another possible application for the tag simulator is the implementation of a project for demonstration purposes.There is often no system connection for the presentation of the HMI system. In these cases, the simulation will control the internal tags.A detailed description of the tag simulator is to be found in the respective online help.

WARNINGThe tag simulator writes the process values into the connected automation system. This means that a possible reaction of connected process peripherals has to be taken into account.

1.3.2 Using the tag SimulatorA typical area of application for the tag simulator is the testing of a configuration without connected process peripherals or with connected process peripherals but without a running process.

SmartTools1.3 Tag simulator


Simulation of process tags without process peripheralsWithout a connected process, only internal tags may be simulated. In order to simulate the process off-line, the following procedure is recommended:1. Make a backup copy of your project by copying your project folder and renaming it to, for

example, xxx_sim. Use this backup copy as your test object. Open WinCC with this copied project.

2. Use the functions "Cut" and "Paste" to add the tags to be simulated to the internal tags. Do not use "Copy" and "Paste", otherwise WinCC Explorer will automatically generate an extension to the tag name to ensure that tag names are unique in the project. The address information of tags declared as internal tags will thus be lost.

3. With the aid of the simulator, the tags can now be supplied with values.4. Once the test phase is over, you can continue your work with the original project.

Simulation of process tags With connected process peripheralsIn case of connected process peripherals, the process tags may be directly supplied with values by the tag simulator. This allows you to perform a function test of the HMI system using the original hardware, such as e.g.: Checking limit value levels, message output. Testing the continuity of alarms, warnings, error messages and checking status displays. Presetting, reading and modifying digital and analog inputs and outputs. Alarm simulation.

1.3.3 Functions of the simulator

IntroductionThe simulation provides the configurator with six different functions. These functions allow to supply the configured objects with realistic values.To test different cases, the simulation offers 6 functions. Each tag can be assigned one of these 6 functions.

SineAs periodic non-linear function.

OscillationFor simulating jumps of a reference variable.



Random numbersThe "Randon numbers" function makes randomly created values available to the user.

IncrementAn up counter beginning with the minimum value again after reaching the maximum value.

DecrementA down counter beginning with the maximum value again after reaching the minimum value.

SliderA slider allowing the user to set a fixed value.

1.3.4 Installing the simulatorThe tag simulator can be installed in two different ways:

Procedure1. During WinCC setup, select "WinCC V7 complete" from the "Programs" dialog.


Start the tag simulator by selecting "SIMATIC > WinCC > Tools > WinCC Tag Simulator".

Alternative ProcedureYou can also install the tag simulator application from the WinCC DVD.1. Switch to the WinCC DVD directory "WinCC\InstData\Smarttools\Setup".2. Double-click setup.exe.3. Select the entry "WinCC Tag Simulator" in the "Components" dialog.4. Click "Continue". Follow the on-screen instructions.

Starting the simulatorThe simulator Simulation.exe can either be started via Windows Explorer, or you can enter it in the startup list of WinCC Explorers, whereby it will automatically start whenever a project is activated.



An activated project in WinCC Explorer is required for the proper operation of the simulator. If the simulator has been added to the startup list of the project, this prerequisite is satisfied automatically.

1.3.5 Adding/deleting tags

Adding new tagsUsing the menu commands "Edit/New Tag", tags can be added to the simulation. For this purpose, the tag selection dialog of the WinCC Explorer will be called, in which the desired tags from the active project can be selected. If new tags are to be created, this can be performed in the tag selection dialog as well. By confirming the selection with the "OK" button, the previously selected tag is entered in the "Properties..." tab of the simulator. There you may specify how the tag value is to be changed.For final acceptance into the simulator the tag tab control must be clicked before the next tag is added.The configured tag simulation can be saved in a configuration file with the file extension "sim".

Removing tagsIf a tag is to be removed from the simulator list, it must be selected and deleted by clicking the menu item "Edit/Delete Tag". The selected tag will then be deleted from the list of tags to be simulated without confirmation dialog.

1.3.6 Parameter assignment of the functionsThe function parameters can be set individually for each tag.

Sine waveFor the sine function the value range can be set by means of the Amplitude parameter.The zero point for the value range can be defined with Offset.The period is set by means of the parameter Period of oscillation (set value * cycle time).

OscillationThe parameter Setpoint is used to define the value kept after the transient reaction.The parameter Overshoot specifies how much the values may deviate from the setpoint value if the attenuation is set to zero.The parameter Period of oscillation defines the time interval. After the time interval has elapsed, the oscillation begins anew.



Random numbers The parameters Lower limit and Upper limit specify the interval for the random numbers.

IncrementThe parameters Start value and Stop value specify the interval for the up counter.

DecrementThe parameters Start value and Stop value specify the interval for the down counter.

SliderThe parameters Start value and Stop value define the adjustment range of the slider.

1.3.7 Activating/deactivating tagsFor a smooth transition from offline configuration to online configuration the tags can be individually activated and deactivated via an own check box.If the tag is enabled, the simulation calculates the values and transfers them to the WinCC Explorer.If the check box is not activated, the simulation does not transfer values to the WinCC Explorer.

1.3.8 Display of the tagsIn the configuration phase, tag control is facilitated for the configurator by displaying the following information in the Tags tab: current WinCC project name of the tag assigned function status (active / inactive) present valueUpon selecting the name of a tag, the other parameters are entered in the "Properties" tag.

1.3.9 Loading/saving simulation dataThe simulation data can be saved so that they are available when restarting the simulator. This is done by selecting the menu items "File/Save" or "File/Save as...".A simulation configuration already saved is loaded by means of the menu commands "File/Open".



When starting the simulator the last used configuration related to a WinCC project is automatically loaded.

1.3.10 FAQ

Error with DM-API, DLL not foundErrors occuring when calling the simulator in connection with DLLs are due to a missing path instruction in the file AUTOEXE.BAT. Check this file for the following entry in the path instruction:SET PATH = .....;:\\bine.g.: SET PATH=C:\SIEMENS\WINCC\BIN;



1.4 Dynamic Wizard Editor

1.4.1 Dynamic Wizard Editor

Short descriptionThe Dynamic Wizard Editor is a tool for creating own Dynamic Wizards. Dynamic Wizards allow frequently reoccuring configuration processes to be automated.

1.4.2 Overview

IntroductionThe Dynamic Wizard brings additional functionality to Graphics Designer. It assists the user in handling frequently reoccurring configuration sequences. This reduces the configuration effort and the risk of configuration errors.The Dynamic Wizard consists of a variety of Dynamic Wizard functions. A large number of Dynamic Wizard functions are already supplied. And these can be further extended with functions that you create yourself.An editor is included for creating your own Dynamic Wizard functions. This editor is the program dynwizedit.exe.

SmartTools1.4 Dynamic Wizard Editor


All of the Dynamic Wizard functions are stored in a data basis (...\WinCC\wscript\Dynwiz.cwd) on the hard disk. The Dynamic Wizard has a standardized display and user interface for selecting and parameterizing the Dynamic Wizard functions. After a Dynamic Wizard function has been selected, Dynamic Wizard will load it into memory and start it.



Interface between Dynamic Wizard and Dynamic Wizard functionThe link between Dynamic Wizard and the Dynamic Wizard function is made using a system interface in the Dynamic Wizard function. The structure of this interface is defined. This interface contains information, which Dynamic Wizard can evaluate.Essential content of the interface:Reference to the process functionThe process function is the intended main function of the Dynamic Wizard. It contains the "service", which a Dynamic Wizard function provides for the user, e.g. the creation of an action on a graphic object.The options list defines the parameters, which are required for the process function. It also defines how they are specified using the dialog's user interface.The trigger list List defines the triggers to be linked to the generated object. It also defines how they are specified using the dialog's user interface.

See alsoTrigger list (Page 42)Options list (Page 39)

1.4.3 Installation of the Dynamic Wizard EditorThe Dynamic Wizard Editor can be installed in two different ways:

Procedure 1. During WinCC setup, select "WinCC V7 complete" from the "Programs" dialog.


Start the Dynamic Wizard Editor by selecting "SIMATIC > WinCC > Tools".

Alternative procedureYou can also install the Dynamic Wizard Editor from the WinCC DVD.1. Switch to the WinCC DVD directory "WinCC\InstData\Smarttools\Setup".2. Double-click setup.exe.3. Select "Dynamic Wizard Editor" in the "Components" dialog.4. Click "Next". Follow the on-screen instructions.



1.4.4 Structure

1.4.4.1 StructureThe Dynamic Wizard Editor comprises the following elements:Menu barThe menu bar contains the functions of the Dynamic Wizard Editor. The menu bar is always visible.ToolbarThe tool bar can be made visible as needed and dragged to any place on the screen with the mouse.Editor windowThe Editor window is only visible if a Dynamic Wizard function has been opened to be edited or a new one is created. Each function will be opened in its own editing window. Several editing windows can be open at the same time.Output windowThe output window can be made visible as required. It shows the result of the functions "Create CWD", "Read Wizard Script" and "Compile Script".Status barThe status bar can be made visible as required. It informs about the keyboard setting and the position of the cursor in the editing window.Dynamic WizardWith the Dynamic Wizard, you can dynamize an object using C actions. When executing wizards, preconfigured C actions and trigger events are defined and transferred to the object properties.

See alsoOutput window (Page 33)Editor window (Page 31)Toolbar (Page 30)



1.4.4.2 Toolbar

Introduction The toolbar allows you to execute actions more rapidly. You do not have to make several selections through the menus until you reach the required function.

Icons

Icon DescriptionCreates a new Dynamic Wizard function.

Opens an existing Dynamic Wizard function (*.wnf).

Saves the Dynamic Wizard function.

Cuts the selected text and copies it to the clipboard.

Copies the selected text to the clipboard.

Pastes the contents of the clipboard at the location of the cursor.

Prints the contents of the current editing window.

Displays additional information on the Dynamic Wizard Editor.

Creates the Dynamic Wizard data (CWD). This function is used to read all wizard scripts available for the language that is currently set and to condition these for processing in the Dynamic Wizard.The file that is generated is stored in the WinCC installation path (installation path\wscripts\dynwiz.cwd).Reads in the wizard scripts and makes them available to the Dynamic Wizard. Sets the language for which the wizard script is configured. This includes all languages known in WinCC, independent on the installed languages.A change of the wizard language has no effect on the overall system or configuration interface.Changes the object. The Dynamic Wizard is also available in the editor for debugging actions and depends on the different properties of an object in Graphics Designer.You can debug a new or existing wizard script in the editor by using this function to change to an existing object in an existing picture.Based on this new object setting, the Dynamic Wizard is set up to display only the wizard scripts that are suitable for this object.



Icon DescriptionShows all Dynamic Wizard scripts for the selected language. Moreover, wizard scripts existing in the dialog can be deleted from the list.Opens the Help Editor.Compiles the script.

See alsoHelp Editor (Page 32)

1.4.4.3 Editor window

Introduction The editor window serves to create and edit Dynamic Wizard functions.



Color codingThe C code is displayed with the following colors:

Color Significance Exampleblue Keywordsgreen Commentsred Stringsblack other C code

1.4.4.4 Help Editor

IntroductionWithin this dialog a help text can be entered for each page created via the wizard script. Only help texts for Dynamic Wizards already created can be entered.



Elements of the Help Editor

Element DescriptionWizard group This field is used to specify the group (=tab) containing the Dynamic Wizard.Wizard name This field is used to select the Dynamic Wizard for which a help text is to be created.Page This field is used to select the dialog page for which the help text is to be created.Help text In this field the help text will be entered.

1.4.4.5 Output window

IntroductionThe output window shows the result of the functions "Create CWD", "Read Wizard Script" and "Compile Script".

The output window helps to find errors in the scripts.If there is an error in the script, the following message appears:...\WinCC\wscripts\wscripts.deu\DemoWiz1.wnf(6):error(003a): 'include': invalid function definition

Description...\WinCC\wscripts\wscripts.deu\ Directory containing the wnf file. DemoWiz1.wnf(6) File name and line number where the error occurserror(003a): 'include': invalid function definition Error number and error description.



1.4.5 Structure of a Dynamic Wizard function

1.4.5.1 Structure of a Dynamic Wizard function

IntroductionA Dynamic Wizard function must have a certain specified strructure. It corresponds to the required components.1. Integrating header files and DLLs2. Language-dependent definitions3. Wizard flags4. Property list5. System interface6. Global variables7. Options list8. Trigger list9. Display of parameter assignment

See alsoDisplay of parameter assignment (Page 44)Trigger list (Page 42)Options list (Page 39)Global variables (Page 39)System interface (Page 38)Property list (Page 37)Wizard flags (Page 36)Language-dependent definitions (Page 35)Integrating header files and DLLs (Page 35)

1.4.5.2 Dynamic Wizard dialog

IntroductionEach Dynamic Wizard option has its specific functionality. However, due to the predefined function structure all functions have a similar sequence and a similar dialog interface. The Dynamic Wizard dialog consists of several dialog pages. "Welcome to the Dynamic Wizard" dialog "Select trigger" dialog


WinCC: Tools (SmartTools, User Archive, interfaces)34 System Manual, 02/2013, A5

Wincc 7.2 Manual

Documents

personal safety

proper precautions

warning notices

safety alert symbol

property damage

severe personal injury

relevant documentation

proper transport