SIMATIC HMI WinCC V7.2 - WinCC: Tools (SmartTools… · SIMATIC HMI WinCC V7.2 WinCC: Tools (SmartTools, User Archive, Schnittstellen) Systemhandbuch Ausdruck der Online-Hilfe 02/2013

SIMATIC HMI

WinCC V7.2WinCC: Tools (SmartTools, User Archive, Schnittstellen)

Systemhandbuch

Ausdruck der Online-Hilfe

02/2013A5E32316991-AA

SmartTools 1

User Archive 2

COM-Provider im Seitenlayout-Editor

3

OPC - Open Connectivity 4

Rechtliche HinweiseWarnhinweiskonzept

Dieses Handbuch enthält Hinweise, die Sie zu Ihrer persönlichen Sicherheit sowie zur Vermeidung von Sachschäden beachten müssen. Die Hinweise zu Ihrer persönlichen Sicherheit sind durch ein Warndreieck hervorgehoben, Hinweise zu alleinigen Sachschäden stehen ohne Warndreieck. Je nach Gefährdungsstufe werden die Warnhinweise in abnehmender Reihenfolge wie folgt dargestellt.

GEFAHR

bedeutet, dass Tod oder schwere Körperverletzung eintreten wird, wenn die entsprechenden Vorsichtsmaßnahmen nicht getroffen werden.

WARNUNG

bedeutet, dass Tod oder schwere Körperverletzung eintreten kann, wenn die entsprechenden Vorsichtsmaßnahmen nicht getroffen werden.

VORSICHT

bedeutet, dass eine leichte Körperverletzung eintreten kann, wenn die entsprechenden Vorsichtsmaßnahmen nicht getroffen werden.

ACHTUNGbedeutet, dass Sachschaden eintreten kann, wenn die entsprechenden Vorsichtsmaßnahmen nicht getroffen werden.Beim Auftreten mehrerer Gefährdungsstufen wird immer der Warnhinweis zur jeweils höchsten Stufe verwendet. Wenn in einem Warnhinweis mit dem Warndreieck vor Personenschäden gewarnt wird, dann kann im selben Warnhinweis zusätzlich eine Warnung vor Sachschäden angefügt sein.

Qualifiziertes PersonalDas zu dieser Dokumentation zugehörige Produkt/System darf nur von für die jeweilige Aufgabenstellung qualifiziertem Personal gehandhabt werden unter Beachtung der für die jeweilige Aufgabenstellung zugehörigen Dokumentation, insbesondere der darin enthaltenen Sicherheits- und Warnhinweise. Qualifiziertes Personal ist auf Grund seiner Ausbildung und Erfahrung befähigt, im Umgang mit diesen Produkten/Systemen Risiken zu erkennen und mögliche Gefährdungen zu vermeiden.

Bestimmungsgemäßer Gebrauch von Siemens-ProduktenBeachten Sie Folgendes:

WARNUNG

Siemens-Produkte dürfen nur für die im Katalog und in der zugehörigen technischen Dokumentation vorgesehenen Einsatzfälle verwendet werden. Falls Fremdprodukte und -komponenten zum Einsatz kommen, müssen diese von Siemens empfohlen bzw. zugelassen sein. Der einwandfreie und sichere Betrieb der Produkte setzt sachgemäßen Transport, sachgemäße Lagerung, Aufstellung, Montage, Installation, Inbetriebnahme, Bedienung und Instandhaltung voraus. Die zulässigen Umgebungsbedingungen müssen eingehalten werden. Hinweise in den zugehörigen Dokumentationen müssen beachtet werden.

MarkenAlle mit dem Schutzrechtsvermerk ® gekennzeichneten Bezeichnungen sind eingetragene Marken der Siemens AG. Die übrigen Bezeichnungen in dieser Schrift können Marken sein, deren Benutzung durch Dritte für deren Zwecke die Rechte der Inhaber verletzen kann.

HaftungsausschlussWir haben den Inhalt der Druckschrift auf Übereinstimmung mit der beschriebenen Hard- und Software geprüft. Dennoch können Abweichungen nicht ausgeschlossen werden, so dass wir für die vollständige Übereinstimmung keine Gewähr übernehmen. Die Angaben in dieser Druckschrift werden regelmäßig überprüft, notwendige Korrekturen sind in den nachfolgenden Auflagen enthalten.

Siemens AGIndustry SectorPostfach 48 4890026 NÜRNBERGDEUTSCHLAND

A5E32316991-AAⓅ 02/2013 Änderungen vorbehalten

Copyright © Siemens AG 2013.Alle Rechte vorbehalten

Inhaltsverzeichnis

1 SmartTools.................................................................................................................................................11 1.1 Übersicht.....................................................................................................................................11 1.2 Variablen Export/Import...............................................................................................................12 1.2.1 Variablen Export/Import...............................................................................................................12 1.2.2 Installation von Variablen Export/Import......................................................................................12 1.2.3 Handhabung................................................................................................................................13 1.2.4 Das Werkzeug Variablen Export/Import......................................................................................14 1.2.5 Verbindungen..............................................................................................................................15 1.2.6 Dateistrukturen............................................................................................................................15 1.2.7 Variable.......................................................................................................................................16 1.2.8 Anhang........................................................................................................................................18 1.3 Variablensimulator.......................................................................................................................21 1.3.1 Der Variablensimulator................................................................................................................21 1.3.2 Einsatz des Variablensimulators.................................................................................................21 1.3.3 Funktionen des Simulators..........................................................................................................22 1.3.4 Installation des Simulators...........................................................................................................23 1.3.5 Variablen hinzufügen/löschen.....................................................................................................24 1.3.6 Parametrierbarkeit der Funktionen..............................................................................................24 1.3.7 Variablen aktivieren/deaktivieren.................................................................................................25 1.3.8 Darstellung der Variablen............................................................................................................25 1.3.9 Simulationsdaten laden/speichern...............................................................................................26 1.3.10 FAQ.............................................................................................................................................26 1.4 Dynamic Wizard Editor................................................................................................................27 1.4.1 Dynamic Wizard Editor................................................................................................................27 1.4.2 Überblick......................................................................................................................................27 1.4.3 Installation des Dynamic Wizard Editor.......................................................................................29 1.4.4 Aufbau.........................................................................................................................................29 1.4.4.1 Aufbau.........................................................................................................................................29 1.4.4.2 Symbolleiste................................................................................................................................30 1.4.4.3 Editierfenster...............................................................................................................................32 1.4.4.4 Hilfe-Editor...................................................................................................................................33 1.4.4.5 Ausgabefenster...........................................................................................................................34 1.4.5 Aufbau einer Dynamic Wizard Funktion......................................................................................34 1.4.5.1 Aufbau einer Dynamic Wizard Funktion......................................................................................34 1.4.5.2 Dynamic Wizard Dialog...............................................................................................................35 1.4.5.3 Einbinden von Header-Dateien und DLL's..................................................................................35 1.4.5.4 Sprachabhängige Definitionen....................................................................................................36 1.4.5.5 Wizard Flags................................................................................................................................37 1.4.5.6 Eigenschaftsliste..........................................................................................................................38 1.4.5.7 System-Schnittstelle....................................................................................................................39 1.4.5.8 Globale Variablen........................................................................................................................40 1.4.5.9 Optionenliste................................................................................................................................40 1.4.5.10 Triggerliste...................................................................................................................................43 1.4.5.11 Anzeige der Parametrierung........................................................................................................45

WinCC: Tools (SmartTools, User Archive, Schnittstellen)Systemhandbuch, 02/2013, A5E32316991-AA 3

1.4.5.12 Wizard-Funktionen für die Parametereingabe.............................................................................46 1.4.5.13 Wizard-Funktionen für die Generierung von Dynamiken.............................................................71 1.4.5.14 Wizard-WinCC-Funktionen..........................................................................................................83 1.4.5.15 Wizard-Progress-Funktionen.......................................................................................................87 1.4.5.16 Wizard-Windows-Funktionen.......................................................................................................90 1.4.6 Beispiele......................................................................................................................................96 1.4.6.1 Beispiele......................................................................................................................................96 1.4.6.2 Demo Wizard...............................................................................................................................96 1.4.6.3 Motor dynamisieren.....................................................................................................................99 1.5 Documentation Viewer..............................................................................................................103 1.5.1 WinCC Documentation Viewer..................................................................................................103 1.5.2 Installation des WinCC Documentation Viewer.........................................................................103 1.5.3 Beschreibung.............................................................................................................................104 1.5.4 Erzeugen der .emf-Datei(en).....................................................................................................105 1.6 WinCC CrossReferenceAssistant..............................................................................................106 1.6.1 WinCC CrossReferenceAssistant..............................................................................................106 1.6.2 Installation des CrossReferenceAssistant.................................................................................106 1.6.3 Allgemein...................................................................................................................................106 1.6.4 Bekannte Funktionen (Skriptverwaltung)...................................................................................107 1.6.5 Projektauswahl..........................................................................................................................111 1.6.6 Dateiauswahl.............................................................................................................................112 1.6.7 Konvertierung............................................................................................................................113 1.6.8 Erweiterte Einstellungen............................................................................................................114 1.7 WinCC Communication Configurator........................................................................................117 1.8 WinCC ConfigurationTool..........................................................................................................119 1.8.1 Einführung.................................................................................................................................119 1.8.2 Systemvoraussetzungen...........................................................................................................120 1.8.3 Installation des ConfigurationTool.............................................................................................120 1.8.4 Oberfläche.................................................................................................................................121 1.8.4.1 Oberfläche.................................................................................................................................121 1.8.4.2 Symbolleiste..............................................................................................................................121 1.8.4.3 Dropdown-Menü........................................................................................................................122 1.8.4.4 Kontextmenü.............................................................................................................................125 1.8.4.5 Statuszeile.................................................................................................................................126 1.8.5 Bedienung des ConfigurationTools...........................................................................................126 1.8.5.1 So bedienen Sie das ConfigurationTool....................................................................................126 1.8.5.2 Anlegen einer neuen Projektmappe..........................................................................................129 1.8.5.3 Tabellenblätter...........................................................................................................................139 1.8.5.4 Dialoge......................................................................................................................................200 1.8.5.5 Bearbeiten von projektierten Daten...........................................................................................205 1.8.5.6 Erzeugen von Objekten über das Kontextmenü der Variablentabelle.......................................222 1.8.5.7 Ändern des Ablageortes der Daten...........................................................................................238 1.8.6 Diagnose...................................................................................................................................239 1.8.6.1 Diagnose...................................................................................................................................239 1.8.6.2 Fehlerspalte...............................................................................................................................240 1.8.7 Tips und Tricks..........................................................................................................................243 1.8.7.1 Tips und Tricks..........................................................................................................................243 1.8.7.2 Beispiel für ein Mengengerüst im ConfigurationTool.................................................................243 1.8.7.3 So wechseln Sie das Tabellenblatt............................................................................................244 1.8.7.4 Zeilenbeschränkung..................................................................................................................246

Inhaltsverzeichnis

WinCC: Tools (SmartTools, User Archive, Schnittstellen)4 Systemhandbuch, 02/2013, A5E32316991-AA

1.8.7.5 Adressgenerierung....................................................................................................................246 1.8.7.6 VBA-Makros..............................................................................................................................250 1.8.7.7 Sonderzeichen...........................................................................................................................250 1.8.7.8 Adressstrings für die Simatic S7 ProtocolSuite.........................................................................251 1.8.7.9 Packages...................................................................................................................................253 1.9 WinCC Archive ConfigurationTool.............................................................................................255 1.9.1 Einführung.................................................................................................................................255 1.9.2 Systemvoraussetzungen...........................................................................................................257 1.9.3 Installation des Archive ConfigurationTool................................................................................257 1.9.4 Schnelleinstieg..........................................................................................................................258 1.9.5 Bedienung von WinCC Archive.................................................................................................266 1.9.5.1 Bedienung von WinCC Archive.................................................................................................266 1.9.5.2 Anlegen einer Archivmappe......................................................................................................267 1.9.5.3 Projektieren eines Prozesswertarchivs......................................................................................274 1.9.5.4 Projektieren eines Verdichtungsarchivs....................................................................................292 1.9.5.5 Prüfen der Archivdaten..............................................................................................................300 1.9.5.6 Erzeugen, Ändern und Löschen................................................................................................307

2 User Archive.............................................................................................................................................315 2.1 Einführung User Archive/Anwenderarchive...............................................................................315 2.2 User Archive und Redundanz....................................................................................................317 2.3 Arbeiten mit dem Editor "User Archive".....................................................................................318 2.3.1 Aufbau des Editors "User Archive"............................................................................................318 2.3.2 Projektierung eines Anwenderarchivs.......................................................................................319 2.3.2.1 So erstellen Sie ein Anwenderarchiv.........................................................................................319 2.3.2.2 So projektieren Sie die Kommunikation zu Variablen................................................................320 2.3.2.3 So projektieren Sie die Steuervariablen....................................................................................321 2.3.2.4 Beispiel zur Verwendung der Steuervariablen..........................................................................323 2.3.2.5 So legen Sie die Rechte des Archivs fest..................................................................................326 2.3.2.6 So erstellen Sie Anwenderarchivfelder......................................................................................327 2.3.2.7 So legen Sie Werte der Anwenderarchivfelder fest...................................................................329 2.3.2.8 So legen Sie die Rechte und Bedingungen des Felds fest.......................................................329 2.3.2.9 So projektieren Sie mehrsprachige Texte.................................................................................330 2.3.2.10 So gehen Sie bei Änderungen des Anwenderarchivs vor.........................................................332 2.3.3 Projektierung einer Sicht...........................................................................................................333 2.3.3.1 So erstellen Sie eine Sicht.........................................................................................................333 2.3.3.2 So erstellen Sie die Spalten einer Sicht....................................................................................334 2.3.3.3 So legen Sie die Relation einer Sicht fest.................................................................................335 2.3.4 Übersicht der nicht verwendbaren Namen................................................................................335 2.3.5 So exportieren Sie die Konfigurationsdaten des User Archive..................................................337 2.3.6 So importieren Sie die Konfigurationsdaten des User Archive..................................................339 2.3.7 So bearbeiten Sie die Runtime-Daten im User Archive.............................................................340 2.3.8 So exportieren Sie die Runtime-Daten des User Archive..........................................................340 2.3.9 So importieren Sie die Runtime-Daten des User Archive..........................................................342 2.4 Datenaustausch mit Automatisierungssystemen.......................................................................345 2.4.1 SIMATIC-Schnittstellen.............................................................................................................345 2.4.2 Datenaustausch mit S7 über Rohdatenvariablen......................................................................345 2.4.2.1 So projektieren Sie den Datenaustausch über Rohdatenvariablen...........................................345 2.4.2.2 Datenformat-Unterschiede zwischen WinCC und S5/S7..........................................................347 2.4.2.3 Senden der Aufträge und Daten aus der S7 an WinCC............................................................349

Inhaltsverzeichnis


2.4.2.4 Empfang der Daten und der Bearbeitungsquittierung in der S7................................................349 2.4.2.5 Aufbau des Telegrammkopfes...................................................................................................350 2.4.2.6 Der Auftragskopf........................................................................................................................350 2.4.2.7 Daten des Auftrags....................................................................................................................351 2.4.2.8 Der Quittungskopf......................................................................................................................352 2.4.2.9 Beschreibung der Auftragstypen...............................................................................................353 2.4.2.10 Beschreibung der Fehlercodes..................................................................................................353 2.5 User Archive Funktionen...........................................................................................................355 2.5.1 Allgemeine Informationen..........................................................................................................355 2.5.2 So verwenden Sie die Funktionen des User Archive................................................................356 2.5.3 Beispiel eines User Archive-Skripts...........................................................................................358 2.5.4 Funktionen zur Konfiguration von Anwenderarchiven...............................................................367 2.5.4.1 Funktionen zur Konfiguration von Anwenderarchiven...............................................................367 2.5.4.2 uaAddArchive............................................................................................................................367 2.5.4.3 uaAddField................................................................................................................................368 2.5.4.4 uaGetArchive.............................................................................................................................369 2.5.4.5 uaGetField.................................................................................................................................369 2.5.4.6 uaGetNumArchives...................................................................................................................370 2.5.4.7 uaGetNumFields........................................................................................................................371 2.5.4.8 uaQueryConfiguration...............................................................................................................371 2.5.4.9 uaReleaseConfiguration............................................................................................................372 2.5.4.10 uaRemoveAllArchives...............................................................................................................372 2.5.4.11 uaRemoveAllFields....................................................................................................................373 2.5.4.12 uaRemoveArchive.....................................................................................................................374 2.5.4.13 uaRemoveField.........................................................................................................................374 2.5.4.14 uaSetArchive.............................................................................................................................375 2.5.4.15 uaSetField.................................................................................................................................376 2.5.4.16 Struktur der Feld-Konfiguration "uaCONFIGFIELD"..................................................................376 2.5.4.17 Struktur der Anwenderarchiv-Konfiguration "uaCONFIGARCHIVE".........................................377 2.5.5 Allgemeine Runtime-Funktionen...............................................................................................378 2.5.5.1 Allgemeine Runtime-Funktionen...............................................................................................378 2.5.5.2 uaConnect.................................................................................................................................379 2.5.5.3 uaDisconnect.............................................................................................................................380 2.5.5.4 uaGetLocalEvents.....................................................................................................................380 2.5.5.5 uaIsActive..................................................................................................................................380 2.5.5.6 uaOpenArchives........................................................................................................................381 2.5.5.7 uaOpenViews............................................................................................................................381 2.5.5.8 uaQueryArchive.........................................................................................................................382 2.5.5.9 uaQueryArchiveByName...........................................................................................................383 2.5.5.10 uaReleaseArchive.....................................................................................................................384 2.5.5.11 uaSetLocalEvents......................................................................................................................384 2.5.5.12 uaUsers.....................................................................................................................................385 2.5.6 Archivspezifischen Runtime-Funktionen...................................................................................385 2.5.6.1 Archivspezifische Runtime-Funktionen.....................................................................................385 2.5.6.2 uaArchiveClose.........................................................................................................................387 2.5.6.3 uaArchiveDelete........................................................................................................................387 2.5.6.4 uaArchiveExport........................................................................................................................388 2.5.6.5 uaArchiveGetCount...................................................................................................................389 2.5.6.6 uaArchiveGetFieldLength..........................................................................................................389 2.5.6.7 uaArchiveGetFieldName...........................................................................................................390 2.5.6.8 uaArchiveGetFields...................................................................................................................390 2.5.6.9 uaArchiveGetFieldType.............................................................................................................391

Inhaltsverzeichnis


2.5.6.10 uaArchiveGetFieldValueDate....................................................................................................392 2.5.6.11 uaArchiveGetFieldValueDouble................................................................................................392 2.5.6.12 uaArchiveGetFieldValueFloat....................................................................................................393 2.5.6.13 uaArchiveGetFieldValueLong....................................................................................................394 2.5.6.14 uaArchiveGetFieldValueString..................................................................................................394 2.5.6.15 uaArchiveGetFilter.....................................................................................................................395 2.5.6.16 uaArchiveGetID.........................................................................................................................395 2.5.6.17 uaArchiveGetName...................................................................................................................396 2.5.6.18 uaArchiveGetSort......................................................................................................................397 2.5.6.19 uaArchiveImport........................................................................................................................397 2.5.6.20 uaArchiveInsert..........................................................................................................................398 2.5.6.21 uaArchiveMoveFirst...................................................................................................................398 2.5.6.22 uaArchiveMoveLast...................................................................................................................399 2.5.6.23 uaArchiveMoveNext..................................................................................................................399 2.5.6.24 uaArchiveMovePrevious............................................................................................................400 2.5.6.25 uaArchiveOpen..........................................................................................................................400 2.5.6.26 uaArchiveReadTagValues.........................................................................................................401 2.5.6.27 uaArchiveReadTagValuesByName...........................................................................................401 2.5.6.28 uaArchiveRequery.....................................................................................................................402 2.5.6.29 uaArchiveSetFieldValueDate.....................................................................................................403 2.5.6.30 uaArchiveSetFieldValueDouble.................................................................................................403 2.5.6.31 uaArchiveSetFieldValueFloat....................................................................................................404 2.5.6.32 uaArchiveSetFieldValueLong....................................................................................................405 2.5.6.33 uaArchiveSetFieldValueString...................................................................................................405 2.5.6.34 uaArchiveSetFilter.....................................................................................................................406 2.5.6.35 uaArchiveSetSort.......................................................................................................................407 2.5.6.36 uaArchiveUpdate.......................................................................................................................407 2.5.6.37 uaArchiveWriteTagValues.........................................................................................................408 2.5.6.38 uaArchiveWriteTagValuesByName...........................................................................................409 2.5.7 Funktionen zur Fehlersuche......................................................................................................409 2.5.7.1 uaGetLastError..........................................................................................................................409 2.5.7.2 uaGetLastHResult.....................................................................................................................411 2.6 WinCC UserArchiveControl.......................................................................................................412 2.6.1 WinCC UserArchiveControl.......................................................................................................412 2.6.2 Projektierung des UserArchiveControl......................................................................................413 2.6.2.1 So projektieren Sie das UserArchiveControl.............................................................................413 2.6.2.2 So bestimmen Sie die Inhalte des UserArchiveControl.............................................................415 2.6.2.3 So projektieren Sie die Darstellung der Tabelle........................................................................418 2.6.2.4 So konfigurieren Sie die Symbolleiste und die Statuszeile .......................................................423 2.6.2.5 So exportieren Sie Runtime-Daten............................................................................................427 2.6.2.6 So bestimmen Sie die Auswirkung der Online-Projektierung....................................................429 2.6.2.7 So dynamisieren Sie die Symbollleiste des UserArchiveControl...............................................431 2.6.3 Bedienung in Runtime...............................................................................................................433 2.6.3.1 Bedienung des UserArchiveControl in Runtime........................................................................433 2.6.3.2 So bearbeiten Sie die Daten im UserArchiveControl.................................................................436 2.6.3.3 So selektieren Sie Daten des Anwenderarchivs........................................................................437 2.6.3.4 So sortieren Sie die Anzeige der Anwenderarchivdaten...........................................................439 2.7 Vor WinCC V7: WinCC User Archives Table Element..............................................................442 2.7.1 User Archives Table Element....................................................................................................442 2.7.2 Funktionalität.............................................................................................................................442 2.7.3 Projektierung eines User Archives Table Elements..................................................................443

Inhaltsverzeichnis


2.7.3.1 Projektierung eines User Archives Table Element....................................................................443 2.7.3.2 User Archives Table Element in einem Prozessbild platzieren.................................................444 2.7.3.3 Die Eigenschaften des User Archives Table Element festlegen...............................................445 2.7.3.4 Das User Archives Table Element löschen...............................................................................447 2.7.4 Eigenschaften des WinCC User Archives Table Element.........................................................447 2.7.4.1 Eigenschaften des User Archives Table Element.....................................................................447 2.7.4.2 Registerkarte "Allgemein"..........................................................................................................448 2.7.4.3 Registerkarte "Spalten".............................................................................................................449 2.7.4.4 Registerkarte "Symbolleiste".....................................................................................................450 2.7.4.5 Registerkarte "Statuszeile"........................................................................................................450 2.7.4.6 Registerkarte "Filter/Sortierung"................................................................................................451 2.7.4.7 Registerkarte "Schriftarten".......................................................................................................452 2.7.4.8 Registerkarte "Farben"..............................................................................................................452 2.7.5 Projektierung einer Formularansicht..........................................................................................452 2.7.5.1 Projektierung einer Formularansicht..........................................................................................452 2.7.5.2 Formularfeld "Text" anlegen......................................................................................................454 2.7.5.3 Formularfeld "Edit" anlegen.......................................................................................................455 2.7.5.4 Formularfeld "Button" anlegen...................................................................................................456 2.7.5.5 Formularfelder nachträglich bearbeiten.....................................................................................457 2.7.5.6 Formularfelder löschen..............................................................................................................458 2.7.6 User Archives Table Elements in Runtime................................................................................458 2.7.6.1 Die Tabelle des User Archives Table Element..........................................................................458 2.7.6.2 Das Formular des User Archives Table Element......................................................................459 2.7.6.3 Die Symbolleiste des User Archives Table Element.................................................................459 2.7.6.4 Bedienung des Controls über dynamisierte Objekte.................................................................464 2.7.6.5 Liste der Eigenschaften des User Archives Table Element.......................................................466 2.7.6.6 Übersicht der dynamisierbaren Eigenschaften im Layout.........................................................470

3 COM-Provider im Seitenlayout-Editor.......................................................................................................471 3.1 COM-Provider im Seitenlayout-Editor.......................................................................................471 3.2 Arbeiten mit COM Server-Objekten...........................................................................................472 3.3 So geben Sie Daten aus einem COM-Server in einem Bericht aus..........................................473 3.4 Beispiel zur Integration eines COM-Servers.............................................................................474 3.5 Beschreibung der COM-Schnittstelle für die Protokollierung....................................................475

4 OPC - Open Connectivity.........................................................................................................................479 4.1 OPC - Open Connectivity..........................................................................................................479 4.2 Funktionsweise von OPC..........................................................................................................480 4.3 OPC Spezifikationen.................................................................................................................481 4.4 Kompatibilität.............................................................................................................................482 4.5 Verwendung von OPC in WinCC...............................................................................................483 4.6 WinCC-OPC-XML-DA-Server....................................................................................................485 4.6.1 Funktionsweise des WinCC-OPC-XML-DA-Servers.................................................................485 4.6.2 Installation.................................................................................................................................486 4.6.2.1 Installation.................................................................................................................................486 4.6.2.2 Installation des Internet Information Service (IIS)......................................................................486 4.6.2.3 Microsoft .NET-Framework installieren.....................................................................................487 4.6.2.4 WinCC-OPC-XML-DA-Server installieren.................................................................................488

Inhaltsverzeichnis


4.7 WinCC-OPC-DA-Server............................................................................................................489 4.7.1 Funktionsweise des WinCC-OPC-DA-Servers..........................................................................489 4.7.2 Verwendung mehrerer OPC-DA-Server....................................................................................490 4.7.3 So können Sie den Namen der OPC-DA-Server abfragen.......................................................491 4.7.4 Beispiele von OPC-DA-Kopplungen..........................................................................................492 4.7.4.1 Kopplung WinCC - WinCC........................................................................................................492 4.7.4.2 Kopplung WinCC - SIMATIC NET FMS-OPC-Server................................................................496 4.7.4.3 Kopplung WinCC - SIMATIC NET S7-OPC-Server...................................................................499 4.7.4.4 Kopplung WinCC - Microsoft Excel...........................................................................................504 4.8 WinCC-OPC-HDA-Server..........................................................................................................509 4.8.1 Funktionsweise des WinCC-OPC-HDA-Servers.......................................................................509 4.8.2 Datenstruktur des WinCC-OPC-HDA-Servers..........................................................................510 4.8.2.1 Datenstruktur des WinCC-OPC-HDA-Servers..........................................................................510 4.8.2.2 Übersicht der unterstützten Attribute.........................................................................................511 4.8.2.3 Übersicht der unterstützten Aggregate......................................................................................512 4.8.2.4 Übersicht der unterstützten Funktionen.....................................................................................513 4.8.2.5 Zeitformat des WinCC-OPC-HDA-Servers................................................................................514 4.8.3 Quality Codes............................................................................................................................516 4.8.4 Unterstützte Schreibzugriffe......................................................................................................516 4.8.5 Beispiel einer OPC-HDA-Kopplung...........................................................................................519 4.8.5.1 Beispiel einer OPC-HDA-Kopplung...........................................................................................519 4.8.5.2 HDA Server Browser.................................................................................................................520 4.8.5.3 So projektieren Sie den Zugriff auf eine WinCC Archivvariable mit dem HDA Server Browser521 4.8.5.4 So können Sie Werte der WinCC Archivvariable lesen.............................................................522 4.8.6 Besonderheiten des OPC-HDA-Servers in WinCC bei azyklischer Archivierung......................524 4.9 WinCC-OPC-A&E-Server..........................................................................................................527 4.9.1 Funktionsweise des WinCC-OPC-A&E-Servers........................................................................527 4.9.2 Abbildung des WinCC Meldesystems auf OPC A&E................................................................528 4.9.2.1 Abbildung des WinCC Meldesystems auf OPC A&E................................................................528 4.9.2.2 Abbildung der Meldeklassen und Meldearten von WinCC........................................................529 4.9.2.3 Abbildung der Priorität von WinCC-Meldungen.........................................................................530 4.9.2.4 Attribute des WinCC Meldesystems..........................................................................................530 4.9.2.5 Quittierphilosophie.....................................................................................................................532 4.9.3 Quality Codes für OPC A&E......................................................................................................534 4.9.4 Beispiel einer OPC-A&E-Kopplung...........................................................................................534 4.9.4.1 Beispiel einer OPC-A&E-Kopplung...........................................................................................534 4.9.4.2 So projektieren Sie den Zugriff auf das WinCC Meldesystem...................................................535 4.9.5 OPC-A&E-Server mit hierarchischem Zugriff............................................................................537 4.9.5.1 Funktionsweise des OPC-A&E-Servers....................................................................................537 4.9.5.2 OPC-A&E-Server ab WinCC V6.2 SP2.....................................................................................539 4.9.5.3 Abbildung des WinCC Meldesystems auf OPC A&E................................................................542 4.9.5.4 Quality Codes für OPC A&E......................................................................................................547 4.9.6 Lesen von archivierten Meldungen............................................................................................548 4.9.6.1 Zugriff auf archivierte Ereignisse...............................................................................................548 4.9.6.2 Syntax für Zugriff auf archivierte Meldungen mit OPC..............................................................549 4.9.6.3 Lesemethoden für archivierte Meldungen.................................................................................550 4.9.6.4 Identifizieren von archivierten Meldungen.................................................................................552 4.10 WinCC-OPC-UA-Server............................................................................................................553 4.10.1 Funktionsweise des WinCC OPC-UA-Servers..........................................................................553 4.10.2 Sicherheitskonzept von OPC UA...............................................................................................554

Inhaltsverzeichnis


4.10.3 Unterstützte OPC-UA-Services.................................................................................................556 4.10.4 Namensraum des WinCC-OPC-UA-Servers.............................................................................557 4.10.5 OPC UA Data Access................................................................................................................559 4.10.6 OPC UA Historical Access........................................................................................................560 4.10.7 WinCC-OPC-UA-Server konfigurieren......................................................................................561 4.10.7.1 Konfigurationsdatei....................................................................................................................561 4.10.7.2 So konfigurieren Sie den OPC-UA-Server................................................................................562 4.11 Inbetriebnahme..........................................................................................................................565 4.11.1 Inbetriebnahme - OPC...............................................................................................................565 4.11.2 Konfiguration von Windows.......................................................................................................565 4.11.2.1 So konfigurieren Sie Windows-Konten für die Benutzung von WinCC-OPC.............................565 4.11.2.2 So passen Sie die Windows Firewall-Einstellungen an.............................................................566 4.11.3 XML...........................................................................................................................................567 4.11.3.1 Inbetriebnahme - OPC XML......................................................................................................567 4.11.3.2 So stellen Sie die Sicherheitseinstellungen mit IIS ein..............................................................567 4.11.3.3 So stellen Sie die korrekte Version von ASP.NET ein...............................................................569 4.11.3.4 So testen Sie die Installation.....................................................................................................569 4.11.4 Trace.........................................................................................................................................571

Index.........................................................................................................................................................573

Inhaltsverzeichnis


SmartTools 11.1 Übersicht

InhaltSmart Tools ist eine Sammlung nützlicher Programme, die die Arbeit mit WinCC unterstützen.

Sie enthält folgende Programme und Dateien:

● Variablensimulator

● Variablen Export/Import

● Dynamic Wizard Editor

● Documentation Viewer

● WinCC CrossReferenceAssistant

● Communication Configurator

● WinCC ConfigurationTool

● WinCC Archive ConfigurationTool

Hinweis

Smart Tools sind Zusatzwerkzeuge. Bitte beachten Sie, dass sie Auswirkungen auf den Betrieb von WinCC haben können, z.B. auf das Laufzeitverhalten oder den Speicherbedarf.

Für die Benutzerfreundlichkeit und Funktionalität der Smart-Tools gelten nicht zwingend die gleichen Maßstäbe, wie für die WinCC Basis-Software.

Siehe auchWinCC Communication Configurator (Seite 117)

Variablen Export/Import (Seite 12)

Der Variablensimulator (Seite 21)

Dynamic Wizard Editor (Seite 27)

WinCC Documentation Viewer (Seite 103)

WinCC CrossReferenceAssistant (Seite 106)


1.2 Variablen Export/Import

1.2.1 Variablen Export/Import

KurzbeschreibungDas Programm exportiert aus einem geöffneten Projekt alle Verbindungen, alle Datenstrukturen und alle Variablen in entsprechende ASCII-Dateien. Diese können dann in einem zweiten Projekt importiert werden. Das ASCII-Format erlaubt ein Verarbeiten der Dateien mit einem Tabellenkalkulations-Programm, bevor man sie wieder importiert.

1.2.2 Installation von Variablen Export/Import

EinleitungVariablen Export/Import kann auf zwei Arten installiert werden.

Das Programm ist nur dann sinnvoll einsetzbar, wenn auch WinCC installiert ist.

VoraussetzungBei WinCC-Mehrplatzprojekten können Sie das Smart Tool "Variablen Export/Import" nicht beim Client ohne eigenes Projekt einsetzen.

Vorgehensweise1. Wählen Sie beim Setup von WinCC im Dialog "Programme" den Eintrag "WinCC V7

komplett" aus.WinCC wird mit den SmartTools sowie WinCC ConfigurationTool und WinCC Archive ConfigurationTool installiert.

Die Anwendung Variablen Export/Import starten Sie über "SIMATIC > WinCC > Tools > Tag Export Import".

Alternative VorgehensweiseSie können die Anwendung Variablen Export/Import auch von der WinCC-DVD installieren.

1. Wechseln Sie auf der WinCC-DVD in das Verzeichnis "WinCC\InstData\Smarttools\Setup".

2. Klicken Sie das Programm setup.exe doppelt.

3. Wählen Sie im Dialog "Komponenten" den Eintrag "VarExpImp".

4. Klicken Sie auf die Schaltfläche "Weiter". Folgen Sie den Anweisungen auf dem Bildschirm.

SmartTools1.2 Variablen Export/Import


1.2.3 Handhabung

EXPORT1. Starten Sie zuerst WinCC und öffnen Sie das Projekt aus dem Sie Variablen exportieren

wollen. Starten Sie "VAR_EXIM.EXE"

2. Wählen Sie Pfad und Name der Datei, in die exportiert werden soll. Hier wird zunächst nur der Name der Datei ohne Namenserweiterung benötigt

3. Stellen Sie den Modus auf "Export"

4. Drücken Sie auf "Execute". Bestätigen Sie die Angaben in der Melde-Box

5. Warten Sie bis die Anzeige "End Export/Import" im Statusfeld erscheint

6. Sie können sich die erzeugten Dateien mit den entsprechenden Schaltern "tag" (Variablen), "con" (Verbindungen), "dex" (Strukturen) und "diag" (Logbuch) ansehen

Leere Gruppen werden nicht exportiert.Der Unterstrich ( _ ) ist für die Namensbildung reserviert. Dateinamen dürfen deshalb keinen Unterstrich enthalten.

IMPORT1. Starten Sie zuerst WinCC und öffnen Sie das Projekt, in das Sie Variablen importieren

wollen.

2. Es müssen alle Kanaltreiber in dem Projekt vorhanden sein, in die Verbindungen importiert werden sollen. Fügen Sie also gegebenenfalls fehlende Treiber dem Projekt hinzu

3. Starten Sie "VAR_EXIM.EXE"

4. Wählen Sie Pfad und Name der Datei, aus der importiert werden soll. Hier wird zunächst nur der Name der Datei ohne Namenserweiterung benötigt. Wenn Sie den Auswahldialog benutzen, klicken Sie eine der drei exportierten Dateien an

5. Stellen Sie den Modus auf "Import" oder "ImportOverwrite". Im Modus "ImportOverwrite" wird eine im Zielprojekt bereits vorhandene Variable mit der zu importierenden Variablen gleichen Namens überschrieben. Im Modus "Import" wird stattdessen eine Meldung in die Logbuchdatei geschrieben, die Variable im Zielprojekt bleibt unverändert.

6. Drücken Sie auf "Execute". Bestätigen Sie die Angaben in der Melde-Box

7. Warten Sie bis die Anzeige "End Export/Import" im Statusfeld erscheint

8. Sehen Sie sich die erzeugten Daten im WinCC Variablenhaushalt an

Der Import in beiden Modi ist bei aktiviertem WinCC Runtime nicht möglich.

In den weiteren Abschnitten werden die technischen Details des Variablen Export/Import beschrieben. Die Kenntnis dieser Kapitel ist jedoch nicht unbedingt notwendig für den Standardfall, wo die Zielmaschine die gleiche Anlagenkonfiguration aufweist wie die WinCC-



Anlage, auf der exportiert wurde. Kenntnisse der WinCC-Variablenstruktur sind nur dann notwendig, wenn Sie selbst über die ASCII-Dateien neue Variablen erzeugen oder bestehende Variablen modifizieren möchten.

1.2.4 Das Werkzeug Variablen Export/ImportDas Werkzeug "Variablen Export/Import" ist eine selbständige Applikation, die auf der WinCC-API basiert. Das Werkzeug kann sowohl zum Export aller WinCC-Variablen eines Projekts in ASCII-Dateien, als auch zum Import von Variablen z.B. in ein zweites Projekt benutzt werden. Dabei werden drei Dateien generiert

● [name]_cex.csv für die logischen Verbindungen

● [name]_dex.csv für die Strukturbeschreibungen

● [name]_vex.csv für die Variablenbeschreibungen

In den Dateien wird eine Kopfzeile generiert, die Aufschluss über die generierten Daten gibt. Beim Import werden die drei Dateien automatisch eingelesen.

Die Datei [name]_cex.csv wird zuerst importiert, denn die Variablen können nur erzeugt werden, wenn die zugehörige Verbindung bereits existiert.Es folgen die Datenstrukturen, die in der Datei [name]_dex.csv definiert sind. Dies sind anwenderdefinierte Datentypen, die natürlich vor dem Anlegen einer Variablen diesen Typs bekannt sein müssen.Danach werden die Variablendefinitionen aus der Datei [name]_vex.csv eingelesen.

Variablengruppen können nicht unabhängig von einer Variablen erzeugt werden. Ist eine Gruppe nicht vorhanden, wird sie automatisch mit der Variablen erzeugt. Aus diesem Grund wird beim Export auch keine Gruppen-Datei generiert. Sind in Ihrem Projekt Gruppen definiert, die keine Variable enthalten, so werden diese Gruppen auch nicht exportiert.

Beim Anlegen einer Variablen wird unter anderem die Adressierung projektiert, die festlegt, an welchem physikalischen Ort die Variable auf dem Automatisierungssystem lokalisiert ist. Diese Adresse ist abhängig vom Kanal der Verbindung und von dem angeschlossenen Automatisierungssystem. Bei der Projektierung über den WinCC Explorer wird dem Anwender eine kanalabhängige Eingabemaske vorgelegt. Beim Editieren einer Importdatei von "Variablen Export/Import" müssen diese Spezifika berücksichtigt werden.Exportierte Variablen sind also mit Sicherheit nur dann auf einem zweiten WinCC Projekt zu importieren, wenn diese Anlage die gleiche Konfiguration aufweist wie die Anlage, auf der die Daten exportiert wurden. Wenn Daten in ein Projekt importiert werden, so muss dies in Kenntnis eventuell schon vorhandener Variablen geschehen. Die Adressen sind gegebenenfalls von Hand zu korrigieren.Andererseits ist jedoch nicht ausgeschlossen, dass der Import von Variablen von Anlagen mit einer anderen Kanalkonfiguration möglich ist. Der Erfolg eines solchen Vorhabens ist Kanal und AS abhängig!

Die exportierten Strukturtypen sind dagegen hardwareunabhängig. Alle kanal- bzw. verbindungsspezifischen Parameter wie Connection, GroupName, Adressinformation werden nicht berücksichtigt. Diese Parameter werden erst beim Anlegen einer Strukturvariablen festgelegt.



Besonderheiten beim Exportieren des Adressstrings in szSpecific.Der Adressstring wird beim Anlegen der Variablen von der kanalspezifischen Software geprüft. Diese Kanal-DLL's erwarten eine bestimmte Syntax, die länderspezifisch nicht verändert werden darf. Aus diesem Grunde werden die Adressstrings beim Exportieren in eine zusätzliche " " Klammer eingeschlossen, die beim Importieren dann wieder entfernt wird. Damit ist sichergestellt, dass eingesetzte Werkzeuge wie Excel, die Adressinformation nicht verändern (Problem des Listentrennzeichens).

1.2.5 VerbindungenEine Verbindung kann nur dann importiert werden, wenn ein entsprechender Kanaltreiber projektiert ist. Zusätzlich müssen die Parameter in der Datei [name]_cex.csv zum projektierten Kanaltreiber passen.

Sollte die Zielmaschine einen anderen Kanal benutzen als die Anlage von der die exportierten Daten stammen, ist dies die erste Änderung die an den exportierten Daten vorgenommen werden muss.

Eine einfache Vorgehensweise um die nötigen Verbindungsdaten zu ermitteln ist:Projektieren Sie auf der Zielmaschine alle Verbindungen und starten Sie den Export. Sie können dann die Parameter ihrer Zielmaschine aus der Datei [name]_cex.csv entnehmen.

Beispiel für eine logische Verbindung:

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

Die zweite Zeile zeigt die logische Verbindung eines Industrial Ethernet Treibers aus der Simatic S7 Protocol Suite.Die dritte Zeile enthält die logische Verbindung eines Profibus-FMS Treibers.

Unter #Conname steht der Name der logischen Verbindung. In der exportierten Datei finden sie diesen logischen Verbindungsnamen in den Daten der Variablen wieder. Über die logische Verbindung wird die Kommunikation mit dem Automatisierungssystem durchgeführt, um auf die externen Variablen im Prozess zuzugreifen.

1.2.6 DateistrukturenDateistruktur der Datei [name]_dex.csv:

#Structure Name Type-Id Creator-ID Project Path Regelung_1 1001 2500 C:\Testdaten\Proj.mcp #Varname C.Vartype C.CreatorID C.VarLength usw.NeueVariable1 ... ... ... ...



NeueVariable2 ... ... ... ...NeueVariable3 ... ... ... ...usw... ... ... ... ...

#: Kommentarzeichen#Structure Name: Die nächste Zeile enthält den Namen einer Dateistruktur, mit strukturspezifischen

Parametern. Die Angabe des Projektpfades dient lediglich der Dokumentation aus welchem Projekt die Daten exportiert wurden. Das Importieren der Daten erfolgt automatisch in das gerade geöffnete Projekt.

#Varname: Die nächsten Zeilen enthalten die Elemente der Dateistruktur, bis eine neue Zeile #Structure Name erkannt wird oder keine Zeilen mehr definiert sind. Eine Zeile enthält alle Parameter die zur Definition einer Variablen benötigt werden.

Bemerkung für Nutzer des WinCC API:Die erste Zeile enthält als Spaltenüberschrift die Namen der Parameter in den entsprechenden Dateistrukturen der API Aufrufe. In einer Excel Tabelle können die Daten dann übersichtlich interpretiert werden.Wenn ein Name mit einem Buchstaben und folgendem Punkt bezeichnet ist, so soll dies zur leichteren Zuordnung zu den API Aufrufen dienen.

Beispiel:

C.nnnnnn ist in Unterstruktur Common enthaltenP.nnnnnn ist in Unterstruktur Protocol enthaltenL.nnnnnn ist in Unterstruktur Limits enthaltenS.nnnnnn ist in Unterstruktur Scaling enthalten

1.2.7 VariableVariablen und Verbindungen bestehen aus einem allgemeinen Teil und einem spezifischen Teil. Der spezifische Teil wird immer durch die jeweilige Kanal-DLL bereitgestellt. Obwohl beim Projektieren, dieser Teil fehlen darf (er muss vor der Aktivierung definiert sein), werden alle Objekte beim Import ignoriert, deren spezifischer Teil fehlt. Beim Export werden diese fehlende Teile durch '*' ersetzt.

Importieren von Variablen eines anwenderdefinierten Typs.Eine vordefinierte WinCC-Variable wird durch einen Datentyp identifiziert, dessen Wert zwischen 1...18 liegt.



Ein anwenderdefinierter Strukturtyp erhält als Datentyp die TypID, welche beim Anlegen der Datenstruktur vom Datenmanager vergeben wird. Diese TypID ist größer als 1000.

Ein Strukturtyp wird bestimmt durch seinen Namen und seinen Datentyp.

Der Name der Datenstruktur ist auf der Maschine auf der exportiert wurde gleich dem Namen auf der Maschine auf der importiert wird. Die TypID muss bzw. wird jedoch nicht identisch sein.

Um eine Variable vom Typ Strukturtyp anlegen zu können, muss eine Zuordnung von TypID zu Strukturname erfolgen.

Beispiel:

Die Strukturtypen sind in der Datei [name]_dex.csv exportiert.

#Structur Name Type-ID Creator-ID Project Path ExternStr1 1046 0 G:\Testdaten\... #Varname C.Vartype C.CreatorID C.VarLength C.VarProperty ...Variable1 1 0 2 ... ...Variable2 2 0 1 ... ...Variable3 3 0 1 ... ...Variable4 4 0 2 ... ...

Die Variablen sind in der Datei [name]_vex.csv exportiert.

#Varname Conn Group Spec Flag CTypInstExStr1 VerbLp GruLp DB200,DBB10 0 1046InstExStr1.Variable1 VerbLp GruLp DB200,D10.0 0 1InstExStr1.Variable2 VerbLp GruLp DB200,DBB10 0 2InstExStr1.Variable3 VerbLp GruLp DB200,DBB10 0 3InstExStr1.Variable4 VerbLp GruLp DB200,DBB10 0 4

In der Datei [name]_dex.csv wird ein Strukturtyp mit Name ExternStr1 und der TypID 1046 definiert.

In der Datei [name]_vex.csv ist eine Strukturvariable vom Typ ExternStr1 mit Namen InstExStr1 definiert. Die Zuordnung, dass es sich dabei um einen Strukturtyp ExternStr1 handelt, erfolgt über den Wert in der Spalte CTyp, der die TypID 1046 dieses Strukturtyps enthält.

Um eine Strukturvariable zu importieren, muss also der Stukturtyp in der Datei [name]_dex.csv enthalten sein und die Variablen dieses Typs in der Datei [name]_vex.csv.

Variablen Import/Export merkt sich die Namens-TypID-Zuordnung und kann so die Strukturvariablen instanziieren, auch wenn die TypID auf der Zielmaschine eine andere ist.

Will man Variablen vom Typ "anwenderdefiniert" importieren ohne dass die Datenstruktur beim importieren eingelesen wird (z.B. keine Datei [name]_dex.csv), so muss die TypID der Zielmaschine dieser Datenstruktur von Hand in der csv-Datei nacheditiert werden. Die TypID wird in diesem Fall mit Hilfe der exportierten Datei [name]_dex.csv der Zielmaschine wie oben beschrieben ermittelt.



Die Eigenschaft einer Variablen wird in der Spalte CPro als Dezimalwert in der exportierten Datei [name]_vex.csv dargestellt. Es werden folgende Variableneigenschaften unterschieden:

Variableneigenschaft Dezimalwert Hexadezimalwertinterne Variable mit projektweiter Aktualisierung

2 2

interne Variable mit rechnerlokaler Aktualisierung

8194 2002

externe Variable 4 4

Werden z.B. interne Variablen mit rechnerlokaler Aktualisierung aus WinCC exportiert, es sollen jedoch interne Variablen mit projektweiter Aktualisierung in WinCC wieder importiert werden, so kann in der Exportdatei der Wert der Variableneigenschaft in der Spalte CPro für die entsprechenden Variablen von 8194 in 2 geändert werden. Anschließend wird die modifizierte Exportdatei gespeichert und in WinCC importiert.

1.2.8 AnhangVariablen-Felder----------------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 bWriteErrProzess;



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 validL6 : 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 15



BITFIELD_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 Variablensimulator

1.3.1 Der Variablensimulator

KurzbeschreibungDer Variablensimulator wird zur Simulation interner Variablen und von Prozessvariablen eingesetzt.

Ein typisches Einsatzgebiet für den Variablensimulator ist beispielsweise der Test einer Projektierung ohne angeschlossene Prozessperipherie, oder mit angeschlossener Prozessperipherie aber ohne laufenden Prozess.

Ohne angeschlossene Prozessperipherie können nur interne Variablen simuliert werden.

Bei angeschlossener Prozessperipherie können die Prozessvariablen mit dem Variablensimulator direkt mit Werten versorgt werden. Damit kann mit der Originalhardware ein Funktionstest des Bedien- und Beobachtungssystem durchgeführt werden.

Die Aktualisierungszeit für Variablenwerte beträgt eine Sekunde. Eine Änderung wirkt sich erst beim Aktivieren der Funktionen oder beim Wechseln der Projektmappe aus.

Es sind maximal 300 Variablen projektierbar.

Eine weitere Einsatzmöglichkeit des Variablensimulators ist die Realisierung eines Projektes für Demonstrationszwecke.Für die Präsentation des Bedien- und Beobachtungssystems ist oftmals keine Anlagenverbindung vorhanden. Hier übernimmt die Simulation die Steuerung der internen Variablen.

Eine detaillierte Beschreibung des Variablensimulators finden Sie in der zugehörigen Online Hilfe.

WARNUNG

Der Variablensimulator schreibt die Prozesswerte in das angeschlossene Automatisiserungssystem. Das bedeutet, dass eine Reaktion eventuell angeschlossener Prozessperipherie berücksichtigt werden muss.

1.3.2 Einsatz des VariablensimulatorsEin typisches Einsatzgebiet für den Variablensimulator ist das Testen der Projektierung ohne angeschlossene Prozessperipherie oder mit angeschlossener Prozessperipherie, aber ohne laufenden Prozeß.

SmartTools1.3 Variablensimulator


Simulation der Prozessvariablen ohne ProzessperipherieOhne angeschlossene Prozessperipherie können nur interne Variable simuliert werden. Um den Prozess vorab Offline zu simulieren wird folgendes Vorgehen empfohlen:

1. Erstellen Sie eine Sicherheitskopie Ihres Projektes, indem Sie Ihren Projektordner kopieren und beispielsweise in xxx_sim umbenennen. Diese Sicherheitskopie benutzen Sie als Testobjekt. Öffnen Sie WinCC mit diesem kopierten Projekt.

2. Die Prozessvariablen die Sie simulieren wollen, fügen Sie über die Funktion „Ausschneiden„ und „Einfügen„ zu den internen Variablen hinzu. Arbeiten Sie nicht mit „Kopieren„ und „Einfügen„, denn der WinCC Explorer generiert automatisch eine Namenserweiterung zum Variablennamen hinzu, damit der Variablenname im Projekt eindeutig bleibt. Die Adressinformation der so als interne Variablen deklarierten Prozessvariablen geht dabei verloren.

3. Die Variablen können jetzt mit Hilfe des Simulators mit Werten versorgt werden.

4. Ist die Testphase beendet, dann arbeiten Sie mit dem Originalprojekt weiter.

Simulation der Prozessvariablen mit angeschlossener ProzessperipherieBei angeschlossener Prozessperipherie können die Prozessvariablen mit dem Simulator direkt mit Werten versorgt werden. Damit kann mit der original Hardware ein Funktionstest des Bedien- und Beobachtungssystems durchgeführt werden, wie z.B:

● Überprüfung von Grenzwertstufen, Meldeausgaben.

● Test der Durchgängigkeit von Alarmen, Warnungen, Fehlermeldungen und Kontrolle von Statusanzeigen.

● Vorbesetzen, Auslesen und Ändern von digitalen und analogen Ein- und Ausgängen.

● Alarmsimulation.

1.3.3 Funktionen des Simulators

EinleitungDie Simulation stellt dem Projekteur 6 verschiedene Funktionen zur Verfügung. Mit diesen Funktionen können die projektierten Objekte mit realitätsnahen Werten versorgt werden.

Um verschiedene Fälle zu testen, stellt die Simulation 6 Funktionen zur Verfügung. Jeder einzelnen Variablen kann eine dieser 6 Funktionen zugeordnet werden.

SinusAls periodische, nichtlineare Funktion.

SchwingungZur Simulation von Sprüngen einer Führungsgröße.



ZufallszahlenMit der Funktion "Zufallszahlen" stehen dem Anwender zufällig erzeugte Werte zur Verfügung.

IncrementEin Vorwärtszähler, der nach Erreichen des Maximums wieder beim Minimum beginnt.

DecrementEin Rückwärtszähler, der nach Erreichen des Minimums wieder beim Maximum beginnt.

SliderEin Schieberegler mit dem der Anwender einen festen Wert einstellen kann.

1.3.4 Installation des SimulatorsDer Variablensimulator kann auf zwei Arten installiert werden:



Den Variablensimulator starten Sie über "SIMATIC > WinCC > Tools > WinCC Tag Simulator".

Alternative VorgehensweiseSie können die Anwendung Variablensimulator auch von der WinCC-DVD installieren.



3. Wählen Sie im Dialog "Komponenten" den Eintrag "WinCC Variablen Simulator".


Starten des SimulatorsDer Simulator Simulation.exe kann entweder über den Windows Explorer gestartet werden, oder man trägt ihn in die Anlaufliste des WinCC Explorer ein, wodurch er automatisch beim Aktivieren eines Projekts gestartet wird.



Voraussetzung für die einwandfreie Funktion des Simulators ist ein aktiviertes Projekt im WinCC Explorer. Wenn der Simulator in der Anlaufliste des Projekts eingetragen ist, dann ist diese Voraussetzung gegeben.

1.3.5 Variablen hinzufügen/löschen

Neue Variable hinzufügenÜber den Menüpunkt "Bearbeiten/Neue Variable" können Variablen zur Simulation hinzugefügt werden. Dafür wird der Variablenauswahldialog des WinCC Explorer aufgerufen, über den die gewünschte Variable aus dem aktiven Projekt ausgewählt werden kann. Soll eine neue Variable angelegt werden, so kann dies ebenfalls im Variablenauswahldialog durchgeführt werden. Durch Bestätigen der Auswahl über die "OK" Schaltfläche wird die zuvor selektierte Variable in die Registerkarte "Eigenschaften" des Simulators eingetragen. Hier kann nun gewählt werden, in welcher Form der Variablenwert verändert werden soll.

Zur endgültigen Übernahme in den Simulator muss die Registerkarte Variablen angeklickt werden, bevor die nächste Variable hinzugefügt wird.

Die projektierte Variablensimulation kann in einer Konfigurationsdatei mit der Dateiendung "sim" gespeichert werden.

Variable löschenSoll eine Variable aus der Liste des Simulators gelöscht werden, so selektiert man diese und wählt den Menüpunkt "Bearbeiten/Variable löschen". Die selektierte Variable wird dann ohne Rückfrage aus der Liste der zu simulierenden Variablen gelöscht.

1.3.6 Parametrierbarkeit der FunktionenDie Parameter der Funktionen sind für jede Variable individuell einstellbar.

SinusBei der Funktion Sinus ist der Wertebereich über den Parameter Amplitude einstellbar.

Der Nullpunkt für den Wertebereich kann mit dem Offset angegeben werden.

Die Periodendauer wird mit dem Parameter Schwingungsdauer (eingestellter Wert * Cycle Time) eingestellt.

SchwingungMit dem Parameter Sollwert wird der Wert eingestellt, der nach dem Einschwingvorgang stehen bleibt.

Der Parameter Überschwingen gibt an, wie weit die Werte vom Sollwert abweichen können, wenn die Dämpfung Null gesetzt wird.



Mit dem Parameter Schwingungsdauer wird das Zeitintervall festgelegt. Nach Ablauf der im Zeitintervall angegebenen Zeit beginnt die Schwingung neu.

ZufallszahlenMit den Parametern Untergrenze und Obergrenze wird das Intervall für die Zufallszahlen festgelegt.

IncrementMit den Parametern Startwert und Stoppwert wird das Intervall für den Vorwärtszähler festgelegt.

DecrementMit den Parametern Startwert und Stoppwert wird das Intervall für den Rückwärtszähler festgelegt.

SliderMit den Parametern Startwert und Stoppwert wird der Einstellbereich für den Schieberegler festgelegt.

1.3.7 Variablen aktivieren/deaktivierenUm einen reibungslosen Übergang von der Offline-Projektierung zur Online-Projektierung zu bekommen, sind die Variablen über ein eigenes Kontrollkästchen einzeln aktivierbar und deaktivierbar.

Ist die Variable aktiviert, werden von der Simulation die Werte berechnet und an den WinCC Explorer übergeben.

Ist das Kontrollkästchen nicht angewählt, so werden von der Simulation keine Werte an den WinCC Explorer übergeben.

1.3.8 Darstellung der VariablenDem Projekteur wird in der Projektierungsphase die Kontrolle über die Variablen erleichtert, indem folgende Informationen in der Registerkarte Variablen angezeigt werden:

● das aktuelle WinCC Projekt

● Name der Variablen

● zugeordnete Funktion

● Status (aktiv / inaktiv)

● aktuell anliegender Wert



Wird der Name einer Variablen selektiert, dann werden in der Registerkarte "Eigenschaften" die weiteren Parameter eingetragen.

1.3.9 Simulationsdaten laden/speichernDie Simulationsdaten können gesichert werden, um beim nächsten Start des Simulators wieder verfügbar zu sein. Dies geschieht über den Menüpunkt "Datei/Speichern", oder "Datei/Speichern unter...".

Eine bereits gesicherte Simulationskonfiguration wird über den Menüpunkt "Datei/Öffnen" geladen.

Beim Start des Simulators wird automatisch die zuletzt verwendete Konfiguration, bezogen auf ein WinCC Projekt, geladen.

1.3.10 FAQ

Fehler mit DM-API, DLL nicht gefundenWenn beim Aufruf des Simulators ein Fehler im Zusammenhang mit DLL's auftritt, dann liegt das an einer fehlenden Pfadanweisung in der Datei AUTOEXE.BAT. Kontrollieren Sie bitte, ob in dieser Datei folgender Eintrag in der Pfadanweisung zu finden ist:

SET PATH = .....;<WinCC-Laufwerk>:\<WinCC-Directory>\bin

z.B: SET PATH=C:\SIEMENS\WINCC\BIN;



1.4 Dynamic Wizard Editor

1.4.1 Dynamic Wizard Editor

KurzbeschreibungDer Dynamic Wizard Editor ist ein Tool zur Erstellung eigener Dynamik Wizards. Mit Dynamik Wizards können oft wiederkehrende Projektierungsabläufe automatisiert werden.

1.4.2 Überblick

EinleitungDer Dynamic Wizard steht als zusätzliche Funktionalität im Graphics Designer zur Verfügung. Er kann den Anwender bei oft wiederkehrenden Projektierungsabläufen unterstützten. Damit wird der Projektierungsaufwand reduziert und mögliche Projektierungsfehler verringert.

Der Dynamic Wizard besteht aus verschiedenen Dynamic Wizard Funktionen. Es steht schon eine große Zahl an Dynamic Wizard Funktionen zur Verfügung. Diese können durch selbst erstellte Funktionen noch ergänzt werden.

Zur Erstellung eigener Dynamic Wizard Funktionen steht ein eigener Editor zur Verfügung. Es handelt sich dabei um das Programm dynwizedit.exe.

SmartTools1.4 Dynamic Wizard Editor


Alle Dynamic Wizard Funktionen sind auf der Festplatte in einer Datenbasis (...\WinCC\wscript\Dynwiz.cwd) gespeichert. Der Dynamic Wizard hat eine standardisierte Anzeige und Bedienoberfläche zur Auswahl und Parametrierung der Dynamic Wizard Funktionen. Nach Auswahl einer Dynamic Wizard Funktion wird diese vom Dynamic Wizard in den Speicher geladen und zur Ausführung gebracht.

Schnittstelle zwischen Dynamic Wizard und Dynamic Wizard FunktionDie Verknüpfung zwischen Dynamic Wizard und Dynamic Wizard Funktion erfolgt über eine System-Schnittstelle in der Dynamic Wizard Funktion, die in ihrer Struktur vorgegeben ist. Diese Schnittstelle enthält Informationen, die vom Dynamic Wizard ausgewertet werden.Wesentlicher Inhalt der Schnittstelle ist:



Referenz auf die BearbeitungsfunktionDie Bearbeitungsfunktion ist die Hauptfunktion der Dynamic Wizard Funktion. Sie enthält die "Leistung", die eine Dynamic Wizard Funktion dem Anwender bietet, z.B. die Erzeugung einer Aktion an einem Grafik-Objekt.

Die Optionenliste definiert die Parameter, die für die Bearbeitungsfunktion notwendig sind. Sie legt auch fest, wie diese über die Dialog-Oberfläche vorgegeben werden.

Die Triggerliste definiert die Trigger, mit dem ein erzeugtes Objekt verknüpft werden soll. Sie legt auch fest, wie diese über die Dialog-Oberfläche vorgegeben werden.

Siehe auchTriggerliste (Seite 43)

Optionenliste (Seite 40)

1.4.3 Installation des Dynamic Wizard EditorDer Dynamik Wizard Editor kann auf zwei Arten installiert werden:

Vorgehensweise 1. Wählen Sie beim Setup von WinCC im Dialog "Programme" den Eintrag "WinCC V7


Den Dynamik Wizard Editor starten Sie über "SIMATIC > WinCC > Tools".

Alternative VorgehensweiseSie können den Dynamik Wizard Editor auch von der WinCC-DVD installieren.



3. Wählen Sie im Dialog "Komponenten" den Eintrag "Dynamik Wizard Editor".


1.4.4 Aufbau

1.4.4.1 AufbauDer Dynamic Wizard Editor enthält folgende Elemente:



MenüleisteDie Menüleiste enthält die Funktionen des Dynamic Wizard-Editors. Die Menüleiste ist immer sichtbar.

SymbolleisteDie Symbolleiste kann bei Bedarf sichtbar geschaltet und mit der Maus an jede beliebige Stelle des Bildschirms gesetzt werden.

EditierfensterDas Editierfenster ist nur sichtbar, wenn eine Dynamic Wizard Funktion zur Bearbeitung geöffnet ist oder eine neue angelegt wird. Jede Funktion wird in einem eigenen Editierfenster geöffnet. Es können mehrere Editierfenster gleichzeitig geöffnet sein.

AusgabefensterDas Ausgabefenster kann bei Bedarf sichtbar geschaltet werden. Es enthält das Ergebnis der Funktionen "CWD-Erzeugen", "Wizard Script einlesen" und "Script übersetzen".

StatuszeileDie Statuszeile kann bei Bedarf sichtbar geschaltet werden. Sie informiert über die Einstellung der Tastatur und zeigt die Position der Schreibmarke im Editierfenster an

Dynamic WizardDer Dynamic Wizard bietet Ihnen die Möglichkeit ein Objekt über C-Aktionen zu dynamisieren. Bei der Ausführung der Wizards werden vorgefertigte C-Aktionen und Triggerereignisse festgelegt und in den Objekteigenschaften hinterlegt

Siehe auchAusgabefenster (Seite 34)

Editierfenster (Seite 32)

Symbolleiste (Seite 30)

1.4.4.2 Symbolleiste

Einleitung Durch die Symbolleiste sind Sie in der Lage, Aktionen schneller auszuführen. Sie müssen sich nicht mehr über das Menü bis zu der erforderlichen Funktion durchwählen.



Symbole

Symbol BeschreibungLegt eine neue Dynamic Wizard Funktion an.

Öffnet eine vorhandene Dynamic Wizard Funktion (*.wnf).

Speichert die Dynamic Wizard Funktion.

Schneidet den markierten Text aus und kopiert ihn in die Zwischenablage.Kopiert den markierten Text in die Zwischenablage.

Fügt den Inhalt der Zwischenablage an die Position der Schreibmarke einDruckt den Inhalt des aktiven Editierfensters aus.

Zeigt nähere Informationen zum Dynamic Wizard-Editor an.

Erzeugt die Dynamic Wizard Daten (CWD). Mit dieser Funktion werden für die momentan eingestellte Sprache alle vorhandenen Wizard-Skripte eingelesen und für die Bearbeitung im Dynamic-Wizard aufbereitet.Die erzeugte Datei befindet sich im Installationspfad von WinCC (Installationspfad\wscripts\dynwiz.cwd).Liest die Wizard-Skripte ein und stellt so diese dem Dynamic Wizard zur Verfügung.Stellt die Sprache ein, für welche das Wizard-Skript projektiert wird. Es werden hier die WinCC bekannten Sprachen zur Verfügung gestellt, unabhängig von den installierten Sprachen.Die Umstellung der Wizard-Sprache hat keine Auswirkung auf das Gesamtsystem bzw. auf die Projektierungsoberfläche.Wechselt das Objekt. Der Dynamic Wizard, der zu Testzwecken auch im Editor zur Verfügung steht, ist abhängig von den unterschiedlichen Eigenschaften eines Objekts im Graphics Designer.Damit im Editor ein neues oder vorhandenes Wizard-Skript getestet werden kann, kann über diese Funktion zu einem vorhandenen Objekt in einem vorhandenen Bild gewechselt werden.Aufgrund des neu eingestellten Objekts wird der Dynamic Wizard so angepasst, dass nur Wizard-Skripte angezeigt werden, welche für dieses Objekt geeignet sind.Zeigt alle Dynamic Wizard-Skripte für die eingestellte Sprache an. Außerdem können im Dialog vorhandene Wizard-Skripte aus der Liste gelöscht werden.Öffnet den Hilfe-Editor

Übersetzt das Skript.



Siehe auchHilfe-Editor (Seite 33)

1.4.4.3 Editierfenster

Einleitung Im Editierfenster werden Dynamic Wizard Funktionen erstellt und bearbeitet.

FarbcodierungDie Darstellung des C-Code ist wie folgt farblich gekennzeichnet:

Farbe Bedeutung Beispielblau Schlüsselworte

grün Kommentare

rot Strings

schwarz sonstiger C-Code



1.4.4.4 Hilfe-Editor

EinleitungInnerhalb dieses Dialogs kann für jede durch das Wizard-Skript erzeugte Seite ein Hilfetext hinterlegt werden. Es können nur Hilfetexte für bereits angelegte Dynamic Wizards hinterlegt werden.

Elemente des Hilfe-Editors

Element BeschreibungWizard-Gruppe Über das Auswahlfeld wird festgelegt in welcher Gruppe (=Registerkarte) sich der

Dynamic Wizard befindet.Wizard-Name Über das Auswahlfeld wird festgelegt für welchen Dynamic Wizard ein Hilfetext

angelegt wird.Seite Über das Auswahlfeld wird festgelegt für welche Dialogseite der Hilfetext angelegt

wird.Hilfe-Text In dieses Feld wird der Hilfetext eingegeben.



1.4.4.5 Ausgabefenster

EinleitungDas Ausgabefenster enthält das Ergebnis der Funktionen "CWD-Erzeugen", "Wizard Script einlesen" und "Script übersetzen".

Das Ausgabefenster hilft beim Suchen von Fehlern in den Skripten.

Ist im Skript ein Fehler, dann sieht die Meldung folgend aus:

...\WinCC\wscripts\wscripts.deu\DemoWiz1.wnf(6):error(003a): 'include': invalid function definition

Beschreibung...\WinCC\wscripts\wscripts.deu\ Verzeichnis, in dem die wnf-Datei abgelegt ist.DemoWiz1.wnf(6) Dateiname und die Zeilennummer, in der der Fehler

auftritterror(003a): 'include': invalid function definition Fehlernummer und die Beschreibung zum Fehler.

1.4.5 Aufbau einer Dynamic Wizard Funktion

1.4.5.1 Aufbau einer Dynamic Wizard Funktion

EinleitungEine Dynamic Wizard Funktion muss einen vorgeschriebenen Aufbau haben. Sie ist entsprechend der notwendigen Bestandteile strukturiert.

1. Einbinden von Header-Dateien und DLL's

2. Sprachabhängige Definition

3. Wizard-Flags



4. Eigenschaftsliste

5. System-Schnittstelle

6. Globale Variablen

7. Optionenliste

8. Triggerliste

9. Anzeige der Parametrierung

Siehe auchAnzeige der Parametrierung (Seite 45)

Triggerliste (Seite 43)

Optionenliste (Seite 40)

Globale Variablen (Seite 40)

System-Schnittstelle (Seite 39)

Eigenschaftsliste (Seite 38)

Wizard Flags (Seite 37)

Sprachabhängige Definitionen (Seite 36)

Einbinden von Header-Dateien und DLL's (Seite 35)

1.4.5.2 Dynamic Wizard Dialog

EinleitungJede Dynamic Wizard Funktion hat ihre spezifische Funktionalität. Durch die fest vorgegebene Struktur einer Funktion haben alle Funktionen aber einen ähnlichen Ablauf und eine ähnliche Dialogoberfläche. Der Dynamic Wizard-Dialog besteht aus mehreren Dialogseiten.

● Dialog "Willkommen beim Dynamic Wizard"

● Dialog "Trigger auswählen"

● Dialog "Optionen setzen"

● Dialog "Fertig !"

1.4.5.3 Einbinden von Header-Dateien und DLL's

EinleitungEine Header-Datei enthält Deklarationen von Konstanten, Datentypen, Variablen und Funktionen.



Die Header-Dateien werden durch eine #include-Anweisung in die Funktion eingebunden. Die wichtigste einzubindende Datei ist hier die Datei dynamic.h. In dieser Datei sind u.a. die Funktionen zur Gestaltung der Oberfläche des Dynamic Wizards deklariert.

DLL-Dateien (Dynamic Link Library) sind ausführbare Routinen, die von einem Programm geladen werden können, wenn sie von diesem benötigt werden.

Um DLL-Dateien nutzen zu können, werden diese über eine #pragma - Anweisung in die Funktion eingebunden.

Im Dynamic Wizard Editor sind folgende Pfade eingestellt:

Header-Dateien von WinCC: ...\WinCC\aplib\

DLL's von WinCC: ...\WinCC\bin\

Sollte sich die Dateien in einem anderen Verzeichnis befinden, dann ist der vollständige Pfad in der #include- und in der #pragma-Anweisung anzugeben.

1.4.5.4 Sprachabhängige Definitionen

EinleitungDie Standardfunktionen der Dynamic Wizard Funktionen existieren in den drei Sprachen Deutsch, Englisch und Französisch. Mit Umschaltung der Sprache im WinCC-Explorer erfolgt auch eine Auswahl der entsprechenden Sprachversion der Dynamic Wizard Funktionen.

Innerhalb der Pfade

..\WinCC\wscripts\wscripts.deu

..\WinCC\wscripts\wscripts.enu

..WinCC\wscripts\wscripts.fra

muss für eine Wizard Funktion jeweils ein WNF-File vorhanden sein.

Bei der Erstellung sollten alle sprachabhängigen Definitionen in diesem Abschnitt angeordnet sein. Dies erleichtert die Erstellung der anderen Sprachversionen.



1.4.5.5 Wizard Flags

EinleitungMit diesen Flags wird festgelegt, für welche Projektierungsart die Dynamic Wizard Funktion gilt.

Flags

FLAG WIZARD_FLAG_OCX Für alle OCX-DateienWIZARD_FLAG_ALL_PROJECT_TYPES Für alle Projekte



FLAG WIZARD_FLAG_SINGLEUSER_PROJECT Nur für Einzelplatz-ProjekteWIZARD_FLAG_MULTICLIENT_PROJECT

Nur für Client-Projekte

WIZARD_FLAG_MULTIUSER_PROJECT Nur für Clients ohne Projektdaten

1.4.5.6 Eigenschaftsliste

EinleitungIn der Eigenschaftsliste wird festgelegt, für welche Objektarten eine Dynamic Wizard Funktion einsetzbar ist. Dies erfolgt dadurch, dass eine Liste von Objekteigenschaften angegeben wird. Verfügt ein Objekt über mindestens eine der aufgeführten Eigenschaften, kann die Dynamic Wizard Funktion auf dieses Objekt angewendet werden.

Jeder Eintrag in der Eigenschaftsliste besteht aus zwei Parametern:

● Name der Eigenschaft, in der englischen Bezeichnung z. B. Hintergrundfarbe (Backcolor)

● WinCC Datentyp

Wird eine leere Eigenschaftsliste verwendet, kann die Dynamic Wizard Funktion auf alle Objektarten angewendet werden. Die Eigenschaftsliste muss auf jeden Fall vorhanden sein, auch wenn diese leer ist.



1.4.5.7 System-Schnittstelle

EinleitungÜber die System-Schnittstelle werden die Eigenschaften der neuen Dynamic Wizard Funktion festgelegt.

Parameterbeschreibung1. Der erste Parameter legt fest, auf welcher Registerkarte die Dynamic Wizard Funktion

erscheinen soll.

2. Der zweite Parameter legt fest, unter welchem Namen die Dynamic Wizard Funktion erscheinen soll.

3. Der dritte Parameter ist immer NULL.

4. Der vierte Parameter bezeichnet den Namen des für die Dynamic Wizard Funktion zu verwendenden Symbols.

5. Der fünfte Parameter ist ein Hilfetext mit einer näheren Beschreibung der Funktionalität der Dynamic Wizard Funktion.

6. Der sechste Parameter ist eine Liste mit den Namen der für die einzelnen Optionsseiten erstellten Funktionen. Diese Liste ist mit einem NULL Eintrag abzuschließen. Es ist die Erstellung von maximal fünf Optionsseiten möglich. Weitere Informationen dazu finden Sie unter "Optionenliste".



7. Der siebente Parameter ist der Name der Bearbeitungsfunktion, welche nach Betätigung der "Fertigstellen" Schaltfläche aufgerufen wird. Die Bearbeitungsfunktion ist die Hauptfunktion der Dynamic Wizard Funktion. Sie enthält die "Leistung", die eine Dynamic Wizard Funktion dem Anwender bietet, z.B. die Erzeugung einer Aktion an einem Grafik-Objekt.

8. Der achte Parameter ist der Name der Funktion, welche die auf den Optionsseiten gemachten Einstellungen zusammenfasst und dem Anwender anzeigt, bevor dieser die Fertigstellen-Schaltfläche betätigt. Weitere Informationen dazu finden Sie unter "Anzeige der Parametrierung".

9. Der neunte Parameter ist eine Liste der auf der Triggerseite anzuzeigenden Trigger. Für die am häufigsten auftretenden Anwendungsfälle stehen Makros zur Verfügung, welche diese Triggerliste ausfüllen. Weitere Informationen dazu finden Sie unter "Triggerliste".

1.4.5.8 Globale Variablen

EinleitungFür jeden in den Optionsseiten einzustellenden Parameter ist eine globale Variable zu definieren. Damit wird erreicht, dass die eingestellten Parameter in allen erstellten Funktionen bekannt sind und mit ihnen gearbeitet werden kann.

Die Datenübergabe zwischen den System-Funktionen ist nur über globale Variablen möglich. Dies ist immer dann notwendig, wenn Trigger- und/oder Optionsparameter an die Bearbeitungsfunktion übergeben werden müssen.

1.4.5.9 Optionenliste

EinleitungOptionen sind Parameter, die für die Funktionalität der Dynamic Wizard Funktion notwendig sind. Optionen setzen keinen Trigger voraus.

Optionen werden in der Optionenliste der System-Schnittstelle definiert. Die Optionenliste enthält für jede Option den Namen der zugeordneten Optionen-Funktion z.B. "OnOption1".



Abgeschlossen wird die Optionenliste durch einen NULL-Pointer. Es dürfen maximal fünf Optionen in der Liste definiert werden.

Optionen-FunktionVom Dynamic-Wizard werden die Optionen-Funktionen nacheinander entsprechend ihrer Reihenfolge in der Optionenliste aufgerufen. Für jede Optionen-Funktion wird der Dialog "Optionen setzen" angezeigt, in der die Funktion ihre spezifische Eingabe programmiert.

Für die Programmierung der Eingabe gibt es Wizard-System-Funktionen. Weitere Informationen dazu finden Sie unter "Wizard-System-Funktionen".

Im Dialog "Optionen setzen" steht eine bestimmte Fläche zur Verfügung, in der statische Texte, Eingabefelder sowie andere Eingabeboxen angeordnet werden können.



Im Dialog "Optionen setzen" ist die Fläche mit Zeilen 1 bis 15 vollständig gefüllt.

Die Option-Funktion dazu sieht wie folgt aus:



1.4.5.10 Triggerliste

EinleitungTrigger sind nur in Verbindung mit Aktionen an einem Grafik-Objekt notwendig.

Trigger werden in der Triggerliste der System-Schnittstelle definiert. Die Triggerliste enthält für jeden Trigger einen Eintrag.

Der Eintrag besteht aus zwei Parametern. Der erste Parameter ist die Bezeichnung des Triggers, die in der Oberfläche angezeigt wird z.B. linke Maustaste drücken. Der zweite Parameter gibt den Namen der zugeordneten Trigger-Funktion.

Abgeschlossen wird die Triggerliste durch ein NULL-Pointer-Paar. Es dürfen maximal 50 Trigger in der Liste definiert werden.

Für die am häufigsten verwendeten Trigger gibt es vordefinierte Makros.



Makro JCR_TRIGGERS Triggerereignisse

DECLARE_JCR_TRIGGERSMausklick, Linke Maustaste, Rechte Maustaste

JCR_ZYCL_TRIGGERS zyklische TriggerDECLARE_JCR_ZYKL_TRIGGERSBildzyklus, Fensterzyklus, Bei Änderung, 250 ms, 500 ms, 1 Sekunde, 2 Sekunden , 5 Sekunden, 10 Sekunden, 1 Minute, 5 Minuten, Anwenderzyklus 1, Anwenderzyklus 2, Anwenderzyklus 3, Anwenderzyklus 4, Anwenderzyklus 5

JCR_ACTION_TRIGGERS AktionstriggerDECLARE_JCR_ACTION_TRIGGERS

Aus der Triggerliste wird der Dialog "Trigger auswählen" erzeugt. In einer Listbox werden alle Trigger-Bezeichnungen zur Auswahl angezeigt.



Nach Auswahl eines Triggers wird vom Dynamic-Wizard die zugeordnete Trigger-Funktion aufgerufen.

1.4.5.11 Anzeige der Parametrierung

EinleitungTrigger- und Optionsparameter können im Dialog "Fertig !" angezeigt werden. Damit hat der Anwender die Möglichkeit die Parametrierung noch einmal zu prüfen und gegebenenfalls zu ändern.

Im Anzeigefeld der Seite "Fertig !" kann mit der Windows-Funktion SetWindowText ein Text angezeigt werden. Das Anzeigefeld hat eine Höhe von 12 Zeilen.



1.4.5.12 Wizard-Funktionen für die Parametereingabe

CreateStatic

EinleitungIm Dialog "Option setzen" wird bei den Koordinaten x,y ein statischer Text angezeigt.

SyntaxHWND CreateStatic (int x, int y, char* "Text")

Parameter

Parameter Beschreibung int x Gibt den Wert der x-Koordinate an. int y Gibt den Wert der Y-Koordinate an.char* Text Gibt den Text an, der ausgegeben wird.



Rückgabewert

RückgabewertHWND gibt den Handle des Objekts zurück

BeispielDer folgende Auszug aus der Datei "Demo.wnf" zeigt den Einsatz dieser Funktion.

char* DynWizEditStatic = "Geben Sie einen Text ein:";.....void OnOption1(void){static BOOL bFirst = TRUE;HWND hWnd = NULL;.....if (bFirst == TRUE){strcpy(g_szEdit,DynWizEdit);



bFirst = FALSE;}//Statischer Text

CreateStatic(0,5,DynWizEditStatic);...........}

CreateEdit

EinleitungIm Dialog "Option setzen" wird bei den Koordinaten x,y ein Eingabefeld angezeigt. In das Eingabefeld kann ein Text eingegeben werden.

SyntaxHWND CreateEdit ( int x, int y, char* pText )

Parameter

Parameter Beschreibung int x Gibt den Wert der x-Koordinate an. int y Gibt den Wert der y-Koordinate an.char* pText Zeiger auf einen Eingabepuffer. Der Eingabepuffer kann mit einem Wert vorbelegt

sein. Dieser wird im Eingabefeld angezeigt.

Rückgabewert

RückgabewertHWND Gibt den Handle des Objekts zurückpText Eingabepuffer enthält den eingegebenen Text.



BeispielDer folgende Auszug aus der Datei "Demo.wnf" zeigt den Einsatz dieser Funktion.Im Dialog "Optionen setzen" des "Demo Wizard" wird ein Eingabefeld angezeigt.

char* DynWizEditStatic = "Geben Sie einen Text ein:";char* DynWizEdit = "Beispieltext";.....char g_szEdit[256];void OnOption1(void){static BOOL bFirst = TRUE;HWND hWnd = NULL;.....if (bFirst == TRUE){strcpy(g_szEdit,DynWizEdit);bFirst = FALSE;}



//Statischer Text für das Eingabefeld

CreateStatic(0,5,DynWizEditStatic);//Eingabefeld

hWnd = CreateEdit(0,20,g_szEdit)GetWindowRect(GetParent(hWnd), &rect);MoveWindow(hWnd,0,20,(rect.right-rect.left),21,TRUE);...........}

CreateSpinEdit

EinleitungIm Dialog "Option setzen" wird bei den Koordinaten x,y ein Eingabefeld mit Drehregler angezeigt.

Über das Eingabefeld wird ein Integerwert in eine Eingabevariable eingetragen.

SyntaxHWND CreateSpinEdit (int x, int y, int* pValue, int Min, int Max, int Base )

Parameter

Parameter Beschreibungint x Gibt den Wert der x-Koordinate an.int y Gibt den Wert der y-Koordinate an.int* pValue Zeiger auf eine Integer-Eingabevariable. Die Eingabevariable kann mit einen

Standardwert vorbelegt sein.int Min Untere Grenze für den Eingabewertint Max Obere Grenze für den Eingabewertint Base Zahlenformat der Eingabe:

10 = dezimale Eingabe16 = hexadezimale Eingabe

Rückgabewert

RückgabewertHWND Gibt Handle des Objekts zurück.pValue Eingabevariable enthält den eingegebenen Wert.



BeispielDer folgende Auszug aus der Datei "Demo.wnf" zeigt den Einsatz dieser Funktion.Im Dialog "Optionen setzen" des "Demo Wizard" wird ein Eingabefeld mit Drehregler angezeigt. Sie können dort einen Wert zwischen 0-1000 einstellen.

char* DynWizSpinStatic= "Geben Sie einen Wert ein (0 - 1000):";char* DynWizEdit = "Beispieltext";......char g_szEdit[256];void OnOption1(void){static BOOL bFirst = TRUE;HWND hWnd = NULL;.....if (bFirst == TRUE){strcpy(g_szEdit,DynWizEdit);bFirst = FALSE;



}......//Statischer Text für das Eingabefeld mit Drehregler

CreateStatic(0,50,DynWizSpinStatic);...

//Eingabefeld mit Drehregler

hWnd = CreateSpinEdit(0,65,&g_iSpinEdit,0,1000,10);MoveWindow(hWnd,0,65,(rect.right-rect.left)/4,21,TRUE);

......}

CreateListBox

EinleitungIm Dialog "Option setzen" wird bei den Koordinaten x,y eine Auswahlfeld angezeigt. In der Auswahlfeld können mehrere Einträge aufgelistet werden. Über Mausklick kann ein Eintrag ausgewählt werden.

SyntaxHWND CreateListbox (int X, int Y, char* Headline, int NumLines, int* pSelect )

Parameter

Parameter Beschreibung int x Gibt den Wert der x-Koordinate an. int y Gibt den Wert der y-Koordinate an.char* Headline Überschrift der Auswahlfeldint NumLines Anzahl der Zeilen in der Auswahlfeld. Vorgegeben werden muss:

NumLines = Anzahl Zeilen + 1 (1 =< NumLines = <16)int* pSelect Zeiger auf der Ergebnisvariable



Rückgabewert

RückgabewertHWND Gibt Handle des Objekts zurück.pSelect Nummer des ausgewählten Eintrags. Die Nummer ist der Index in der Auflistung

(beginnend bei 0).

BeispielDer folgende Auszug aus der Datei "Demo.wnf" zeigt den Einsatz dieser Funktion. Im Dialog "Optionen setzen" des "Demo Wizard" wird ein Auswahlfeld angezeigt. Das Auswahlfeld hat eine mögliche Größe von drei Zeilen. Da mehr als drei Einträge vorhanden sind, wird ein Rollbalken angezeigt.

Hinweis

Mit der Funktion "CreateListbox" wird nur das Auswahlfeld selbst erzeugt. Der Inhalt der Zeilen muss mit der Funktion "SendMessage" eingetragen werden.

char* DynWizListStatic= "Wählen Sie einen Eintrag aus:";...int g_iListBox = 0;//Typdefinition der Elemente in der Auswahlfeld



typedef struct listboxItem{int iIndex;char szItemText[256];}LB_ITEM, *PLB_ITEM;

#define LB_NUM_LINES 5

LB_ITEM g_itemListBox[LB_NUM_LINES] ={{ 0, "First Element"}, { 1, "Second Element"}, { 2, "Third Element"}, { 3, "Fourth Element"}, { 4, "Fifth Element"}}; void OnOption1(void){static BOOL bFirst = TRUE;HWND hWnd = NULL;.....if (bFirst == TRUE){strcpy(g_szEdit,DynWizEdit);bFirst = FALSE;}......//Statischer Text für das Auswahlfeld

CreateStatic(0,162,DynWizListStatic);...//Auswahlfeld

hWnd = CreateListbox(0,177,"Headline",LB_NUM_LINES,&g_iListBox);MoveWindow(hWnd,0,177,(rect.right-rect.left),50,TRUE);



//Mit der Funktion "CreateListbox" wird nur die Box selbst erzeugt. Der Inhalt der Zeilen muss mit //der Funktion "SendMessage" eingetragen werden.

for (i=0; i<LB_NUM_LINES; i++){SendMessage(hWnd,LB_INSERTSTRING,(WPARAM)-1,(LPARAM)g_itemListBox[i].szItemText);}}

CreateCheckBox

EinleitungIm Dialog "Option setzen" wird bei den Koordinaten x,y ein Kontrollkästchen angezeigt. Über das Kontrollkästchen kann eine Option aktiviert werden. In einem Dialog können mehrere Kontrollkästchen verwendet werden.

SyntaxHWND CreateCheckBox (int x, int y, char* Text, BOOL* pSelect )

Parameter

Parameter Beschreibung int x Gibt den Wert der x-Koordinate an. int y Gibt den Wert der y-Koordinate an.char* Text Text, der rechts von dem Kontrollkästchen angezeigt.BOOL* pSelect Zeiger auf die Ergebnisvariable. Die Ergebnisvariable sollte mit einem

Standardwert (True/False) vorbelegt werden.

Rückgabewert

RückgabewertHWND Gibt Handle des Objekts zurück.pSelect Zustand der Aktivierung

FALSE = nicht aktiviertTRUE = aktiviert



BeispielDer folgende Auszug aus der Datei "Demo.wnf" zeigt den Einsatz dieser Funktion. Im Dialog "Optionen setzen" des "Demo Wizard" werden drei Kontrollkästchen angezeigt, die jeweils eine Option darstellen. Jede Option kann für sich allein aktiviert werden.

BOOL g_bCheck1 = TRUE;BOOL g_bCheck2 = TRUE;BOOL g_bCheck3 = TRUE; void OnOption1(void){static BOOL bFirst = TRUE;HWND hWnd = NULL;.....if (bFirst == TRUE){...}...



...//Kontrollkästchen

iMid = (rect.right-rect.left)/2 ; CreateCheckBox(iMid,100,"CheckBox 1",&g_bCheck1);CreateCheckBox(iMid,116,"CheckBox 2",&g_bCheck2);CreateCheckBox(iMid,132,"CheckBox 3",&g_bCheck3}

CreateFrame

EinleitungIm Dialog "Option setzen" wird ein rechteckiger Rahmen angezeigt. Die linke, obere Ecke des Rahmen wird durch die Koordinaten x,y festgelegt. Die rechte, untere Ecke des Rahmens ist mit der rechten, unteren Ecke des Optionenfensters identisch.

SyntaxHWND CreateFrame (int x, int y, char* Title )

Parameter

Parameter Beschreibungint x Gibt den Wert der x-Koordinate an.int y Gibt den Wert der y-Koordinate an.char* Title Beschriftung in der oberen Kante des Rechtecks

Rückgabewert

RückgabewertHWND Gibt Handle des Objekts zurück.



BeispielDer folgende Auszug aus der Datei "Demo.wnf" zeigt den Einsatz dieser Funktion. Im Dialog "Optionen setzen" des "Demo Wizard" wird ein Rahmen mit dem Titel "Frame" angezeigt.

void OnOption2(void){//Rahmen CreateFrame(0,150,"Frame");}......

CreateRadioButton

EinleitungIm Dialog "Option setzen" wird bei den Koordinaten x,y eine Optionsschaltfläche angezeigt. Über die Optionsschaltfläche kann eine Option aktiviert werden.

Die Anwendung von Optionsschaltfläche ist nur sinnvoll, wenn im Dialog mehrere Optionsschaltflächen verwendet werden. Es ist immer nur eine Optionsschaltfläche aktiv.



SyntaxHWND CreateRadioButton (int x, int y, char* Text, BOOL* pSelect )

Parameter

Parameter Beschreibung int x Gibt den Wert der x-Koordinate an. int y Gibt den Wert der Y-Koordinate an.char* Text Bezeichnung der Option, die mit der Optionsschaltfläche aktiviert wird. Der Text

wird rechts von der Optionsschaltfläche angeordnet.BOOL* pSelect Zeiger auf die Ergebnisvariable. Die Ergebnisvariable sollte mit einem

Standardwert (True/False) vorbesetzt werden.

Rückgabewert

RückgabewertHWND Gibt Handle des Objekts zurück.pSelect Zustand der Aktivierung:

FALSE = nicht aktiviertTRUE = aktiviert



BeispielDer folgende Auszug aus der Datei "Demo.wnf" zeigt den Einsatz dieser Funktion. Im Dialog "Optionen setzen" des "Demo Wizard" werden drei Optionsschaltflächen angezeigt, die jeweils eine Option darstellen. Es kann nur eine Option aktiviert werden.

BOOL g_bOption1 = TRUE;BOOL g_bOption2 = FALSE;BOOL g_bOption3 = FALSE; void OnOption1(void){static BOOL bFirst = TRUE;HWND hWnd = NULL;.....if (bFirst == TRUE){...}...



...//Optionsschaltflächen

CreateRadioButton(0,100,"RadioButton 1",&g_bOption1);CreateRadioButton(0,116,"RadioButton 2",&g_bOption2);CreateRadioButton(0,132,"RadioButton 3",&g_bOption3);}

CreateFileBrowser

EinleitungIm Dialog "Option setzen" wird bei den Koordinaten x,y ein Eingabefeld mit einer Durchsuchen-Schaltfläche angezeigt. In das Eingabefeld kann ein Dateiname eingegeben werden.

Durch Aktivierung der Durchsuchen-Schaltfläche wird ein Dateiauswahldialog geöffnet.

SyntaxHWND CreateFileBrowser (int x, int y, DWORD Flags, char* Filter, char* Dateiname )

Parameter

Parameter Beschreibungint x Gibt den Wert der x-Koordinate an.int y Gibt den Wert der y-Koordinate an.DWORD Flags Steuerflags des Auswahlfensters:

FB_WITHPATH = Dateiname mit PfadFB_SAVE_AS = Anstelle des Öffnens-Dialogs erscheint der Dialog "Speichern unter".



Parameter Beschreibungchar* Filter Filter für die Anzeige von Datentypen im Auswahlfeld des

Dateiauswahldialogs. Durch Vorgabe der Erweiterung wird bestimmt, welche Datentypen im Auswahlfeld angezeigt werden.Ein Filter besteht aus einem String-Paar. Der 1. String ist der Filtername. Der 2. String ist die Filterfunktion in der Form *.typ, wobei 'typ' eine Dateierweiterung ist. Im Auswahlfeld werden nur die Dateien mit dieser Dateierweiterung angezeigt. 1. und 2. String sind durch | getrennt. Es können mehrere Filter durch | gekettet werden. Das letzte Filter wird durch || begrenzt.Beispiele:char* Filter1 = "Graphic-Bilder (*.PDL) | *.PDL||";

char* Filter2 = "Dokumente (*.doc) | *.doc|""Text-Dateien *.txt | *.txt|""WNF-Dateien | *.wnf|""Alle Dateien (*.*) | *.*||";

Am Ende der Filterfunktion sind keine Leerzeichen erlaubt.char* Dateiname Eingabepuffer für den Dateinamen. Es kann ein Pfadname als Standardwert

vorgegeben werden. Dieser Standardwert hat folgende Auswirkung:Der Pfadname wird im Eingabefenster standardmäßig angezeigt.Wird auf die Durchsuchen-Schaltfläche geklickt wird der Pfad im Dateiauswahldialog eingestellt. Hat der Dateiname die Erweiterung '*.typ', dann werden im Auswahlfeld des Auswahldialogs alle Dateien dieses Typs angezeigt.

Rückgabewert

RückgabewertHWND Gibt Handle des Objekts zurück.Dateiname Eingabepuffer enthält den Dateinamen

BeispielDer folgende Auszug aus der Datei "Demo.wnf" zeigt den Einsatz dieser Funktion. Im Dialog "Optionen setzen" des "Demo Wizard" wird ein Eingabefeld mit einer Durchsuchen-



Schaltfläche angezeigt. Mit einem Klick auf die Durchsuchen-Schaltfläche wird der Dateiauswahldialog geöffnet.

char* DynWizFileBrowserStatic = "Wählen Sie eine Datei aus:";char* DynWizFileBrowser = "C:\\Beispieldatei";char* DynWizFilter = "Textdateien (*.txt) | *.txt|" "Alle Dateien (*.*) | *.*||";...char g_szFileBrowser[256];...void OnOption2(void){static BOOL bFirst = TRUE;HWND hWnd = NULL;RECT rect;...if (bFirst == TRUE){...



strcpy(g_szFileBrowser,DynWizFileBrowser);First = FALSE;}......// Statischer Text für das Eingabefeld mit Durchsuchen-Schaltfläche

CreateStatic(0,95,DynWizFileBrowserStatic);//Dateiauswahldialog

hWnd = CreateFileBrowser(0,110,FB_WITHPATH,DynWizFilter,g_szFileBrowser);MoveWindow(hWnd,0,110,(rect.right-rect.left),21,TRUE);}

CreateVarBrowser / CreateVarBrowserEx

EinleitungIm Dialog "Option setzen" wird bei den Koordinaten x,y ein Eingabefeld mit einer Durchsuchen-Schaltfläche angezeigt. In das Eingabefeld kann ein Variablenname eingegeben werden. Durch einen Klick auf die Durchsuchen-Schaltfläche wird der Variablenauswahldialog von WinCC geöffnet. Bei der Funktion "CreateVarBrowserEx" kann zusätzlich ein Variablenfilter parametriert werden. Mittels dieses Filters werden die im Variablenauswahldialog angezeigten Variablen begrenzt. Möglich ist eine Filterung nach Datentyp, Variablengruppe, Variablenname und Verbindung.

SyntaxHWND CreateVarBrowser (int x, int y, char* VarName )

HWND CreateVarBrowserEx (int x, int y, LPDM_VARFILTER VarFilter, char* VarName )

Parameter

Parameter Beschreibung int x Gibt den Wert der x-Koordinate an. int y Gibt den Wert der y-Koordinate an. LPDM_VARFILTER VarFilter Optionale Angabe eines Zeigers auf einen Variablenfilter. Bei

Angabe eines NULL-Zeigers ist kein Filter aktiv.Der Variablenfilter muss mittels der Struktur DM_VARFILTER definiert werden. Weiterführende Information dazu finden Sie bei der Dokumentation zu WinCC ODK.

char* VarName Enthält den Variablennamen an. Der Variablenname kann mit einem Standardwert vorbelegt werden. Diese Eingabe wird immer angezeigt.



Rückgabewert

RückgabewertHWND Gibt Handle des Objekts zurück.VarName Eingabepuffer enthält den Variablenname

BeispielDer folgende Auszug aus der Datei "Demo.wnf" zeigt den Einsatz dieser Funktion. Im Dialog "Optionen setzen" des "Demo Wizard" wird ein Eingabefeld mit einer Durchsuchen-Schaltfläche angezeigt. Mit einem Klick auf die Durchsuchen-Schaltfläche wird der Variablenauswahldialog von WinCC geöffnet.

char* DynWizVarBrowser = "Beispielvariable";char* DynWizPicBrowserStatic = "Wählen Sie ein Bild aus:";...char g_szVarBrowser[256];...void OnOption2(void){static BOOL bFirst = TRUE;



HWND hWnd = NULL;RECT rect;...if (bFirst == TRUE){...strcpy(g_szVarBrowser,DynWizVarBrowser);First = FALSE;}......// Statischer Text für das Eingabefeld mit Durchsuchen-Schaltfläche

CreateStatic(0,95,DynWizFileBrowserStatic);//Variablenauswahldialog

hWnd = CreateFileBrowser(0,110,FB_WITHPATH,DynWizFilter,g_szFileBrowser);GetWindowRect(GetParent(hWnd), &rect);MoveWindow(hWnd,0,110,(rect.right-rect.left),21,TRUE);}

CreatePackageBrowser/CreatePackageBrowserEx

EinleitungIm Dialog "Option setzen" wird bei den Koordinaten x,y ein Eingabefeld mit einer Durchsuchen-Schaltfläche angezeigt. In das Eingabefeld kann ein Name eingegeben werden. Der Packagebrowser wird durch die Durchsuchen-Schaltfläche am rechten Rand des Eingabefelds aktiviert. Mit dem Flag oder der ProgID wird die Art der Daten festgelegt, welche aus dem Package angezeigt werden soll.

Bei der Funktion "CreatePackageBrowserEx" kann statt eines Flags eine ProgID übergeben werden.

SyntaxHWND CreatePackageBrowser (int x, int y, DWORD flags, char* Name )

HWND CreatePackageBrowserEx (int x, int y, char* ProgID, char* Name )



Parameter

Parameter Beschreibungint x Gibt den Wert der x-Koordinate an.int y Gibt den Wert der Y-Koordinate an.DWORD flags Aktuell nur PB_PICTURE verwendbar. Dadurch wird die

Bildauswahl aktiviert.char* ProgID Programmatische ID der Komponente, über die die Auswahl

aufgebaut wird. Durch Übergabe von "WinCC.CCFileASOStub.1" wird die Bildauswahl angesprochen.

char* Name Enthält den Namen. Der Namen kann mit einem Standardwert vorbelegt werden. Diese Eingabe wird immer angezeigt.

Rückgabewert

RückgabewertHWND Gibt Handle des Objekts zurück.Name Eingabepuffer enthält den Name

BeispielDer folgende Auszug aus der Datei "Demo.wnf" zeigt den Einsatz dieser Funktion. Im Dialog "Optionen setzen" des "Demo Wizard" wird ein Eingabefeld mit einer Durchsuchen-



Schaltfläche angezeigt. Mit einem Klick auf die Durchsuchen-Schaltfläche wird der Bildauswahldialog geöffnet.

char* DynWizPicBrowserStatic = "Wählen Sie ein Bild aus:";char* DynWizPicBrowser = "Beispielbild"; ...char g_szPicBrowser[256];...void OnOption2(void){static BOOL bFirst = TRUE;HWND hWnd = NULL;RECT rect;...if (bFirst == TRUE){... strcpy(g_szPicBrowser,DynWizPicBrowser);



First = FALSE;}......// Statischer Text für das Eingabefeld mit Durchsuchen-Schaltfläche

CreateStatic(0,50,DynWizPicBrowserStatic);//Bildauswahldialog

hWnd = CreatePackageBrowser(0,65,PB_PICTURE,g_szPicBrowser);MoveWindow(hWnd,0,65,(rect.right-rect.left),21,TRUE);}

CreateObjectBrowser

EinleitungIm Dialog "Option setzen" wird bei den Koordinaten x,y ein Eingabefeld mit einer Durchsuchen-Schaltfläche angezeigt. In das Eingabefeld kann ein Objekt- oder ein Eigenschaftsname eingegeben werden. Durch einen Klick auf die Durchsuchen-Schaltfläche wird ein Auswahldialog geöffnet. In dem Auswahldialog kann ein Objekt- oder Eigenschaftsname gesucht und ausgewählt werden.

SyntaxHWND CreateObjectBrowser (int x, int y, char* Title, DWORD flags, char* ObjectName )

Parameter

Parameter Beschreibung int x Gibt den Wert der x-Koordinate an. int y Gibt den Wert der Y-Koordinate an. char* title Beschriftung des Auswahldialogs. DWORD flags Es können zwei verschiedene Flags übergeben werden:

OB_OBJECTS Anzeige aller ObjekteOB_PROPERTIES Zusätzlich wird die Auswahl der Eigenschaften angeboten.

char* ObjectName Eingabepuffer für den Objekt- bzw. Eigenschaftsname. Der Eingabepuffer kann mit einem Standardwert eingestellt werden.



Rückgabewert

RückgabewertHWND Gibt Handle des Objekts zurück.ObjectName Eingabepuffer enthält den Objekt- bzw. Eigenschaftsname

BeispielDer folgende Auszug aus der Datei "Demo.wnf" zeigt den Einsatz dieser Funktion. Im Dialog "Optionen setzen" des "Demo Wizard" wird ein Eingabefeld mit einer Durchsuchen-Schaltfläche angezeigt. Mit einem Klick auf die Durchsuchen-Schaltfläche wird der Fensterobjektauswahldialog geöffnet.

char* DynWizObjectBrowserStatic = "Wählen Sie ein Objekt aus:";char* DynWizObjectBrowser = "Objekt";char* DynWizObject = "Fensterobjektauswahl";;...char g_szObjectBrowser[256];...void OnOption2(void)



{static BOOL bFirst = TRUE;HWND hWnd = NULL;RECT rect;...if (bFirst == TRUE){...strcpy(g_szObjectBrowser,DynWizObjectBrowser);First = FALSE;}......// Statischer Text für das Eingabefeld mit Durchsuchen-Schaltfläche

CreateStatic(0,50, CreateStatic(0,140,DynWizObjectBrowserStatic););//Fensterauswahldialog

hWnd = CreateObjectBrowser(0,155,DynWizObject,OB_OBJECTS,g_szObjectBrowser);MoveWindow(hWnd,0,155,(rect.right-rect.left),21,TRUE);

}

1.4.5.13 Wizard-Funktionen für die Generierung von Dynamiken

GenerateBLOB

EinleitungDie Funktion GenerateBLOB (BLOB = Binary Large OBject) erzeugt eine Aktion, das an eine Eigenschaft eines Grafik-Objekts angehängt werden kann. Eine Aktion besteht aus 3 Teilen.

Prolog: Dies ist der Kopf der C-Funktion.

Beispiel:#include "apdefap.h"void OnLButtonDown(char* lpszPictureName,char* lpszObjectName,char* lpszPropertyName, UINT nFlags, int x, int y){Der Prolog ist abhängig vom Trigger, durch den die Aktion gestartet wird (in obigem Beispiel: linke Maustaste drücken)



Epilog: Dies ist das Ende der C-Funktion und besteht aus dem Zeichen '}'.

Rumpfteil: Dieser Teil enthält die eigentliche Funktionalität der C-Funktion. Beispiel: ProgramExecute("notepad.exe");

Die Funktion erzeugt den C-Code der Aktion und kompiliert diesen C-Code. Ergebnis der Kompilierung ist ein P-Code. Dieser wird vom WinCC-Runtime-System interpretiert und bearbeitet. Bei fehlerhaftem C-Code wird kein P-Code erzeugt.

Die Funktion erzeugt ein BLOB, in dem die Teile der Aktion (u.a. C-Code, P-Code, Trigger, ...) gespeichert sind. Vor dem Ende der Wizard Funktion muss das BLOB wieder gelöscht werden. Weiterführende Informationen zum Löschen der Funktion BLOB finden Sie unter "DeleteBLOB".

SyntaxAP_BLOB GenerateBLOB (char* Prolog, char* Epilog, char* Format, ... )

Parameter

Parameter Beschreibungchar* Prolog Prolog der Aktion als ASCII-String. char* Epilog Epilog der Aktion als ASCII-String.char* Format Rumpfteil der Aktion als ASCII-String bzw. Format-String entsprechend Standard-

Funktion "printf".

Hinweis

Die Erzeugung des C-Codes erfolgt mit der C-Funktion sprintf. Der Parameter wird als Format-String bearbeitet, d.h. Format-Steuerzeichen (z.B. \ % ") werden ausgewertet. Sollen diese in den C-Code übernommen werden (z.B. als Format-String für einen printf-Aufruf in einer Aktion), so müssen sie mit einem \ versehen werden.Beispiel:\ \ \% \%

" \"

RückgabewertDie Funktion liefert als Rückgabewert eine strukturierte Variable des Typs AP_BLOB mit den folgenden Strukturkomponenten

Strukturkomponente RückgabewertDWORD dwPCodeSize Länge des erzeugten P-Code in ByteLPVOID lpPCode Zeiger auf den erzeugten P-Codeint nErrors Anzahl der Compiler-Fehler int nWarnings Anzahl der Compiler-Warnungen.



BeispielDer folgende Auszug aus der Datei "Execute Programm.wnf" zeigt den Einsatz dieser Funktion. Die Wizard Funktion erzeugt ein C-Script, mit dem eine andere Applikation (hier im Beispiel: notepad.exe) gestartet wird.

...

...void OnGenerate(void){PCMN_ERROR pError;AP_BLOB *blob;char code[500];char sError[500];..Slash2DblSlash(g_Bild, strlen(g_Bild));..sprintf(code,"%sProgramExecute(\"%s\");",ifcode,g_Bild);..//Prolog

blob = GenerateBLOB("#include \"apdefap.h\"\r\n""void OnClick(char* lpszPictureName," "char*lpszObjectName,char* lpszPropertyName,""UINT nFlags,int x, int y) {",//Epilog

"}",//Rumpfteil

code); BEGIN_JCR_BLOBERRORS SetAction(NULL, blob, g_Trigger); END_JCR_BLOBERRORS DeleteBLOB(blob);}



Erzeugtes C-Script:

#include "apdefap.h"void OnLButtonDown(char* lpszPictureName,char* lpszObjectName,char* lpszPropertyName,UINT nFlags, int x, int y){ProgramExecute("notepad.exe");}

DeleteBLOB

EinleitungDie Funktion GenerateBLOB erzeugt ein BLOB. Am Ende der Wizard Funktion muss der BLOB wieder gelöscht werden. Mit der Funktion DeleteBLOB löscht man den BLOB.

Syntaxvoid DeleteBLOB (AP_BLOB* blob)

Parameter

Parameter BeschreibungAP_BLOB* blob Zeiger auf die Ergebnisvariable der Funktion "GenerateBLOB".

BeispielDeleteBLOB(blob);

SetAction

EinleitungAn das angewählte Grafik-Objekt wird am angegebenen Trigger eine Aktion angehängt.

Ist der Trigger ein Ereignis, dann wird dieser direkt als Aufruf-Parameter vorgegeben.



Ist der Trigger die Dynamisierung einer Eigenschaft, dann muss der Trigger vorher mittels der Funktionen AddVarTrigger bzw. AddTimeTrigger in das BLOB eingetragen werden.

Hinweis

Soll die Aktion nicht an das angewählte Objekt, sondern an ein anderes Objekt angehängt werden, dann muss die API-Funktion PDLCSSetAction benutzt werden. Weiterführende Informationen zur Funktion PDLCSSetAction erhalten Sie im Handbuch zu WinCC ODK.

SyntaxBOOL SetAction (char* Property, AP_BLOB* Blob, DWORD Trigger )

Parameter

Parameter Beschreibung char* Property Name der Eigenschaft. Es muss immer der englische Name der

Eigenschaft benutzt werden. Bei einem Trigger an einem Ereignis muss ein NULL-Zeiger übergeben werden.

AP_BLOB* Blob Zeiger auf die Ergebnisvariable der Funktion "GenerateBLOB".DWORD TriggerID ID des Triggers:

NOTDEFINED = Trigger ist im BLOB eingetragenMOUSECLICK = Maus-KlickMOUSELBUTTONDOWN = linke Maustaste drückenMOUSELBUTTONUP = linke Maustaste loslassenMOUSERBUTTONDOWN = rechte Maustaste drückenMOUSERBUTTONUP = rechte Maustaste loslassenKEYBOARDDOWN = Tastaturtaste drückenKEYBOARDUP = Tastaturtaste loslassenOBJECTCHANGE = ObjektänderungPROPERTYCHANGE = Änderung der EigenschaftPICTUREOPEN = BildanwahlPICTURECLOSE = Bildabwahl

Rückgabewert

RückgabewertBOOL Returnwert TRUE = Funktion erfolgreich ausgeführt.

FALSE = Funktion nicht erfolgreich ausgeführt.

BeispielSiehe Beispiel bei der Funktion GenerateBLOB.



Siehe auchGenerateBLOB (Seite 71)

AddTimeTrigger

EinleitungDie Funktion ergänzt die Aktion um einen Trigger des Typs "Zyklischer Trigger".

SyntaxBOOL AddTimeTrigger (AP_BLOB* Blob, char* Name, DWORD TriggerType, DWORD GraphCycleType, DWORD CycleID )

Parameter

Parameter Beschreibung AP_BLOB* Blob Zeiger auf die Ergebnisvariable der Funktion "GenerateBLOB".char* Name Name des Ereignisses. Dies ein beliebiger ASCII-String. Der

Name wird im Fenster der Aktion als Ereignisname angezeigt.DWORD TriggerType Typ des zyklischen Triggers:

2 = Zeit-Zyklus (Standard-Zyklus)4 = Grafik-Objekt-Zyklus

DWORD GraphCycleType Typ des Grafik-Objekt-Zyklus:0= Fenster-Zyklus1 = Bild-Zyklus

DWORD CycleID Triggerzyklus:0 = Bei Änderung1 = 250 ms2 = 500 ms3 = 1 s4 = 2 s5 = 5 s6 = 10 s7 = 1 min8 = 5 min9 = 10 min10 = 1 h11 = Anwenderzyklus 112 = Anwenderzyklus 213 = Anwenderzyklus 314 = Anwenderzyklus 415 = Anwenderzyklus 5



Rückgabewert

RückgabewertBOOL TRUE = Funktion erfolgreich ausgeführt.


BeispielDie Zeit, die zwischen zwei Aktionsauslösungen vergeht beträgt 1s.

BOOL FctRet;..FctRet = AddTimeTrigger(blob, "1 sec", 2, 0, 3);



AddVarTrigger/AddVarTriggerEx

EinleitungDie Funktion ergänzt die Aktion um einen Trigger des Typs "Variablen-Trigger".

SyntaxBOOL AddVarTrigger (AP_BLOB* Blob, char* EventName, char* VarName )

BOOL AddVarTriggerEx (AP_BLOB* Blob, char* EventName, char* VarName, DWORD CycleID )

Parameter

Parameter Beschreibung AP_BLOB* Blob Zeiger auf die Ergebnisvariable der Funktion "GenerateBLOB".char* EventName Name des Ereignisses. Dies ein beliebiger ASCII-String. Der

Name wird im Fenster der Aktion als Ereignisname angezeigt.char* VarName Name der WinCC Variablen, die die Triggerung auslöst bzw. an

der Triggerung beteiligt ist.DWORD CycleID Triggerzyklus:

0 = Bei Änderung1 = 250 ms2 = 500 ms3 = 1 s4 = 2 s5 = 5 s6 = 10 s7 = 1 min8 = 5 min9 = 10 min10 = 1 h11 = Anwenderzyklus 112 = Anwenderzyklus 213 = Anwenderzyklus 314 = Anwenderzyklus 415 = Anwenderzyklus 5Bei der Funktion AddVarTrigger wird der Wert CycleID = 4 fest vorgegeben.

Rückgabewert





BeispielSie haben in der Triggerart "Variable" die Variable 'StartTurbine1' als Trigger eingetragen. Die Aktion wird gestartet, sobald sich der Wert einer dieser Variablen ändert.

BOOL FctRet FctRet = AddVarTriggerEx(blob,"Turbine Start","StartTurbine1",0);

SetValidateFct

EinleitungDer Name einer Prüf-Funktion wird dem Dynamic Wizard mitgeteilt. Mit der Prüf-Funktion können die Optionen und Trigger-Parameter geprüft werden. Bei negativem Prüfergebnis kann die erneute Eingabe veranlasst werden.

Die Prüf-Funktion wird aufgerufen, wenn im Dialog "Optionen auswählen" oder im Dialog "Trigger setzen" auf die Schaltfläche "Weiter" geklickt wird. Bei positivem Prüfergebnis wird



der Dialog verlassen und die nächste Seite angezeigt. Bei negativem Prüfergebnis bleibt Dialog weiterhin angezeigt. Erst nach Eingabe der richtigen Parameter ist eine Fortsetzung möglich.

Die Prüf-Funktion ist ab dem Zeitpunkt wirksam, ab dem sie im Dynamic-Wizard gesetzt wurde. Sie ist dann auch für nachfolgende Optionen-Seiten wirksam. Soll keine oder eine andere Prüf-Funktion wirksam werden, so muss entweder eine Dummy-Funktion (mit positivem Prüfergebnis) oder eine andere Prüf-Funktion gesetzt werden.

SyntaxBOOL SetValidateFct (LPCSTR FctName)

Parameter

Parameter BeschreibungLPCSTR FctName Name der Prüf-Funktion als ASCII-String.

Rückgabewert

RückgabewertBOOL Ergebnis der Prüfung

TRUE = positives Prüfergebnis.FALSE = negatives Prüfergebnis.

BeispielDer folgende Auszug aus der Datei "Instanzobjekt.wnf" zeigt den Einsatz dieser Funktion.

Die Wizard Funktion wurde um eine Prüf-Funktion erweitert.

......// Validierung Option 1

BOOL ValidateOpt1(void){// Property ausgewählt

return (strcmp(g_NewInst, ""));} void OnOption1(void){



HWND hWnd;RECT rect;DM_VARFILTERdmFilter = {DM_VARFILTER_TYPE, 1, NULL, NULL, NULL, NULL }; SetValidateFct("ValidateOpt1");sprintf(g_NewInst, "");..}

EnumProperty/EnumPropertyEx

EinleitungDie Funktion EnumProperty listet die Objekteigenschaften eines Objektes auf. Bei der Funktion EnumPorpertyEx können die aufzulistenden Objekteigenschaften eines Objektes spezifiziert werden.

SyntaxBOOL EnumProperty (char* FName, LPVOID pItem, DWORD dwFlags );

BOOL EnumPropertyEx (LPCTSTR Projectname, LPCTSTR Picturename, LPCTSTR Objectname, char* FName, LPVOID pItem, DWORd dwFlags );

Parameter

Parameter BeschreibungLPCTSTR Projectname Zeiger auf den Namen des Projektes, einschließlich Verzeichnis

und Dateierweiterung.LPCTSTR Picturename Zeiger auf den Namen des Bildes, dessen Objekte aufgelistet

werden soll. Groß- und Kleinbuchstaben werden unterschieden. LPCTSTR Objectname Zeiger auf den Namen des Objektes char* FName Name Ihrer Callback-Funktion, die für jede Objekteigenschaft

eines einmal aufgerufen wird.



Parameter Beschreibung LPVOID pItem Zeiger auf applikationsspezifische Daten, der an die Callback-

Funktion weitergereicht wird. Dieser Zeiger wird von der Funktion nicht ausgewertet, sondern in der Callback-Funktion wieder zu Verfügung gestellt.

DWORD dwFlags dwFlags spezifiziert die aufzulistenden Eigenschaftstypen. Derzeit sind folgende Angaben möglich:PropertyHasDynamic (Wert: 0x0001) Es werden nur Objekteigenschaften enumeriert, die eine Dynamisierung besitzen.PropertyHasEvents (Wert: 0x0002) Es werden nur Objekteigenschaften enumeriert, die eine Ereignis besitzen.PropertyIsDynamicable (Wert: 0x0003) Es werden nur Objekteigenschaften enumeriert, die dynamisierbar sind.

Rückgabewert

RückgabewertBOOL TRUE = Objekteigenschaften eines Objekttyps aufgelistet

FALSE = Fehler

BeispielDer folgende Auszug aus der Datei "Dynamic Property.wnf" zeigt den Einsatz dieser Funktion.

......// Callback-FunktionBOOL EnumFct(char *property, VARTYPE vt, LPVOID pItem){sprintf(g_prop[SendMessage((HWND)pItem,LB_INSERTSTRING,(WPARAM)-1,(LPARAM)property)],property);return TRUE;} void OnOption1(void){HWND hWnd,LBHwnd;RECT rect;static BOOL bFirst = TRUE; if(bFirst)



{...}... CreateStatic(0, 10,"Eigenschaften des aktuellen Objekts :");LBHwnd=CreateListbox(0, 30, g_Headline, 8, &g_indexProperty);EnumProperty("EnumFct", LBHwnd, 3);GetWindowRect(GetParent(LBHwnd), &rect);...

1.4.5.14 Wizard-WinCC-Funktionen

GetProjectName

EinleitungDer Pfad des aktuellen WinCC Projekts wird ermittelt.

SyntaxLPCSTR GetProjectName ( void )

Rückgabewert

RückgabewertLPCSTR Zeiger auf den ASCII-String der MCP-Datei

Beispiel

LPCSTR Name;

Name = GetProjectName();

Die Funktion liefert z.B. folgendes Ergebnis: C:\Siemens\WinCC\WinCCProjects\Example.mcp



GetPictureName

BeschreibungDer Name des aktuellen Bilds (*.pdl) wird ermittelt.

SyntaxLPCSTR GetPictureName ( void )

Rückgabewert

RückgabewertLPCSTR Zeiger auf den ASCII-String der PDL-Datei

Beispiel

LPCSTR Name;

Name = GetPictureName();

Die Funktion liefert z.B. folgendes Ergebnis: TurbineControl.PDL

GetDefaultWNFPath

BeschreibungDer Pfad der aktuellen WNF-Verzeichnis wird ermittelt.

SyntaxLPCSTR GetDefaultWNFPath ( void )

Rückgabewert

RückgabewertLPCSTR Zeiger auf den ASCII-String des Pfadnamens

Beispiel

LPCSTR Name;

Name = GetDefaultWNFPath();



Die Funktion liefert z.B. folgendes Ergebnis: C:\Siemens\WinCC\wscripts\wscripts.deu\

GetObjectName

EinleitungDer Name des angewählten Grafik-Objekts im aktuellen Bilds wird ermittelt.

SyntaxLPCSTR GetObjectName ( void )

Rückgabewert

RückgabewertLPCSTR Zeiger auf den ASCII-String des Objektnamens

Beispiel

LPCSTR Name;

Name = GetObjectName();

Die Funktion liefert z.B. folgendes Ergebnis: Button1

InsertXRefSection

BeschreibungDie Funktion fügt in den übergebenen Quellcode einen Abschnitt gemäß der Xref-Notation ein, sodass die übergebenen Variablen und Bildernamen als Define eingetragen sind.

SyntaxBOOL InsertXRefSection (char * SourceCode, char* TagName[], int TagCount, char* PictName[], int PictCount)

Parameter

Parameter Beschreibungchar *SourceCode CodePuffer, in dem der Xref-Abschnitt eingefügt werden sollchar *TagName[] NULL oder Feld von Variablennamen, die in den Xref-Abschnitt

eingefügt werden.



Parameter Beschreibungint TagCount Anzahl der Variablennamen im Feld TagName[]char *PictName[] NULL oder Feld von Bildnamen, die in den Xref-Abschnitt

eingefügt werdenint PictCount Anzahl der Bildnamen im Feld PictName[]

Rückgabewert

RückgabewertBOOL Der Ergebniswert gibt an, ob die Funktion erfolgreich

durchgeführt wurde.char *TagName[] Feld der Defines für die an gleicher Stelle übergebenen Variablenchar *PictName[] Feld der Defines für die an gleicher Stelle übergebenen Bilder

Beispiel

char* szPictureArray[1];

char szPictName[255];

char szSourceCode[1100];

strcpy(szPictName, "Newpdl.pdl");

szPictureArray[0] = szPictName;

strcpy(szSourceCode, "");

InsertXrefSection(szSourceCode,NULL,0,szPictureArray,1);

Als Ergebnis wird Folgendes von der Funktion zurückgeliefert:

szSourceCode:

// WINCC:TAGNAME_SECTION_START

// syntax: #define TagNameInAction "DMTagName"

// next TagID : 1

// WINCC:TAGNAME_SECTION_END

// WINCC:PICNAME_SECTION_START

// syntax: #define PicNameInAction "PictureName"

// next PicID : 1

#define PIC_0 " Newpdl.Pdl"

// WINCC:PICNAME_SECTION_END



szPictureArray[0]: "PIC_0"

1.4.5.15 Wizard-Progress-Funktionen

Wizard-Progress-Funktionen

EinleitungDie Progress-Funktionen dienen zur Anzeige des Fortschritts (in %) eines Bearbeitungsvorgangs in einer "Progress-Box".

Beim Erzeugen der Fortschrittsanzeige (CreateProgressDlg) werden ein Anfangs- und ein Endwert sowie ein Inkrement vorgegeben. Der Anfangswert entspricht dem Fortschritt 0%, der Endwert dem Fortschritt 100%. Das Inkrement legt fest, in welchen Schritten der Fortschritt sich ändern kann.

In der Regel ist der Anfangswert = 0 und das Inkrement = 1. Der Endwert ist die Anzahl der Bearbeitungsschritte des Vorgangs.

Im Bearbeitungsvorgang wird der Fortschritt um ein Inkrement erhöht (Progress_StepIt) oder auf einen definierten Wert gesetzt (Progress_SetPos).

Am Ende des Bearbeitungsvorgangs muss die Fortschrittsanzeige wieder gelöscht werden (DestroyProgressDlg).

In der Fortschrittsanzeige kann ein Text angezeigt werden (Progress_SetStatus), z.B. der Text "Erzeugen der Grafik-Objekte". Dieser kann auch während des Bearbeitungsvorgangs geändert werden, um verschiedene Teilvorgänge zu unterscheiden.

In der Regel ist es nicht möglich, den Bearbeitungsvorgang so zu unterteilen, dass eine zeitlich lineare Anzeige des Fortschritts möglich ist. Dies ist aber auch nicht notwendig. Die Anzeige, dass ein Fortschritt erfolgt, ist ausreichend.



Siehe auchDestroyProgressDlg (Seite 90)

Progress_SetPos (Seite 89)

Progress_Steplt (Seite 89)

Progress_SetStatus (Seite 88)

CreateProgressDlg (Seite 88)

CreateProgressDlg

EinleitungIn einer Fortschrittsanzeige wird der Fortschritt eines Bearbeitungsvorgangs im Bereich 0..100% angezeigt.

SyntaxPROGRESS_DLG CreateProgessDlg (int nLower, int nUpper, int nStepInc )

Parameter

Parameter Beschreibungint nLower Anfangswert des Fortschritts (entspricht 0 %)int nUpper Endwert des Fortschritts (entspricht 100 %)int nStepInc Inkrement des Fortschritt

Rückgabewert

RückgabewertPROGRESS_DLG Handle des Objekts

Progress_SetStatus

BeschreibungIn die Fortschrittsanzeige wird ein Text als Überschrift eingetragen.

Syntaxvoid Progress_SetStatus (PROGRESS_DLG hDlg, char* ActionName )



Parameter

Parameter BeschreibungPROGRESS_DLG hDlg Handle des Objektschar* ActionName Text der Überschrift

Progress_Steplt

BeschreibungDer Fortschritt eines Bearbeitungsvorgangs wird um ein Inkrement erhöht.

Syntaxvoid Progress_Steplt (PROGRESS_DLG hDlg )

Parameter

Parameter BeschreibungPROGRESS_DLG hDlg Handle des Objekts

Progress_SetPos

BeschreibungIn der Fortschrittsanzeige wird der Fortschritt auf einen definierten Wert gesetzt. Dieser Wert muss zwischen Anfangs- und Endwert liegen.

Syntaxvoid Progress_SetPos (PROGRESS_DLG hDlg, int nPos )

Parameter

Parameter BeschreibungPROGRESS_DLG hDlg Handle des Objektsint nPos Wert des Fortschritts



DestroyProgressDlg

EinleitungDie Fortschrittsanzeige wird geschlossen.

Syntaxvoid DestroyProgressDlg (PROGRESS_DLG hDlg )

Parameter

Parameter BeschreibungPROGRESS_DLG hDlg Handle des Objekts

1.4.5.16 Wizard-Windows-Funktionen

Wizard-Windows-Funktionen

EinleitungNachfolgend erfolgt eine Kurzbeschreibung von Windows Funktionen, die in Zusammenhang mit den Wizard-System-Funktionen (insbesondere mit den Fenster-Funktionen für die Parametereingabe) verwendet werden müssen bzw. können.

Weiter gehende Information erhalten Sie im Microsoft Developers Studio /Win32 SDK Programmer's Reference enthalten.

Siehe auchMessageBox (Seite 95)

ShowWindow (Seite 94)

GetWindow (Seite 93)

SendMessage (Seite 93)

MoveWindow (Seite 92)

GetWindowRect (Seite 91)

GetParent (Seite 91)



GetParent

EinleitungZu einem Fenster wird das Handle des Parent-Fensters ermittelt z.B. des Handles des Optionenfensters.

SyntaxHWND GetParent (HWND hWnd )

Parameter

Parameter BeschreibungHWND hWnd Handle des Fensters, zu dem das Parent-Fenster ermittelt werden

soll.

Rückgabewert

RückgabewertHWND Handle des Parent-Fensters

NULL = Es existiert kein Parent-Fenster.

GetWindowRect

EinleitungGröße und Koordinaten eines Fensters werden ermittelt z.B. die Größe des Optionenfensters.

SyntaxBOOL GetWindowRect (HWND hWnd, LPRECT lpRect )

Parameter

Parameter BeschreibungHWND hWnd Handle des FenstersLPRECT lpRect Pointer auf eine strukturierte Ergebnisvariable



Rückgabewert


FALSE = Funktion nicht erfolgreich ausgeführt.LPRECT lpRect Strukturierte Ergebnisvariable der Struktur LPRECT mit den

Strukturkomponenten:LONG left: X-Koordinate der linken, oberen EckeLONG top: Y-Koordinate der linken, oberen EckeLONG right: X-Koordinate der rechten, unteren EckeLONG bottom: Y-Koordinate der rechten, unteren Ecke

Siehe auchSo fügen Sie das Skript "Motor.wnf" in die Datenbasis ein (Seite 100)

CreateEdit (Seite 48)

MoveWindow

EinleitungPosition und Dimension eines Fensters werden verändert z.B. die Position und die Größe der Eingabefelder im Optionenfenster .

SyntaxBOOL MoveWindow (HWND hWnd, int x, int y, int nWidth, int nHeight, BOOL bRepaint )

Parameter

Parameter BeschreibungHWND hWnd Handle des Fenstersint x X-Koordinate der linken, oberen Eckeint y, Y-Koordinate der linken, oberen Eckeint nWidth Breiteint nHeight HöheBOOL bRepaint TRUE = Das Fenster wird neu gezeichnet.

Rückgabewert





Siehe auchSo erstellen Sie die Dynamic Wizard Funktion für den Motor (Seite 99)

SendMessage

EinleitungEine Nachricht wird an ein Fenster gesendet. Die Funktion wird z.B. zum Füllen eines Auswahlfeldes verwendet.

SyntaxLRESULT SendMessage (HWND hWnd, UINT Msg, WPARAM wParam, LPARAM lParam )

Parameter

Parameter BeschreibungHWND hWnd Handle des FenstersUINT Msg, Typ der Nachricht:

LB_INSERTSTRING = Text in einer ListBox einfügenWPARAM wParam 1. Parameter der Nachricht:

-1 = Der Text wird am Ende angefügt.LPARAM lParam 2. Parameter der Nachricht:

Pointer auf den Text

Rückgabewert

RückgabewertLRESULT Handle des Objekts

GetWindow

EinleitungEs wird das Handle des Fensters ermittelt, das in einer bestimmten Beziehung zum einem anderen Fenster (Original-Fenster) steht.

SyntaxGetWindow (HWND hWnd, UINT uCmd )



Parameter

Parameter BeschreibungHWND hWnd Handle des Original-FenstersUINT uCmd Beziehung

GW_HWNDFIRST = oberstes Fenster

Rückgabewert

RückgabewertHWND Handle des gefundenen Fensters oder NULL

ShowWindow

EinleitungDie Art der Anzeige eines Fenster wird festgelegt.

SyntaxShowWindow (HWND hWnd, int nCmdShow )

Parameter

Parameter BeschreibungHWND hWnd Handle des Fenstersint nCmdShow Anzeigestatus der Fensters

SW_HIDE = nicht sichtbar

Rückgabewert

RückgabewertBOOL TRUE = Fenster war sichtbar

FALSE = Fenster war nicht sichtbar



MessageBox

EinleitungDie Funktion dient zur Anzeige einer Nachricht an den Anwender, wenn ein Fehler aufgetreten ist oder ein Eingriff des Anwenders notwendig ist.

Die Meldung wird mit einer anwenderspezifischen Nachricht, Titel und Schaltfläche angezeigt.

HinweisParamater "MB_SYSTEMMODAL"

Wird die Funktion einer Message Box mit dem Paramter "MB_SYSTEMMODAL" ausgeführt, wird sichergestellt, dass die Message Box in den Vordergrund gestellt wird. Wird dieser Paramter nicht angegeben, ist die Message Box für den Anwender nicht mehr sichtbar (befindet sich im Hintergrund) sowie nicht bedienbar. Mausklicks außerhalb der Message Box werden zwischengepuffert und erst nach dem Schließen der Message Box abgearbeitet.

Beispiel: MessageBox(NULL, "Welt", "Hallo", MB_SYSTEMMODAL | MB_OK);

Syntaxint MessageBox (HWND hWnd, LPCTSTR lpText, LPCTSTR lpCaption, UINT uType )

Parameter

Parameter BeschreibungHWND hWnd Handle des Parent-Windows

NULL = Meldung hat kein Parent-Window.LPCTSTR lpText Text der NachrichtLPCTSTR lpCaption Text des TitelsUINT uType MB_SYSTEMMODAL = verhindert eine Blockade des Systems,

solange die MessageBox geöffnet ist.Typ der Box:MB_OK = Meldung mit einer 'OK' - SchaltflächeMB_OKCANCEL = Meldung mit den Schaltflächen 'OK' und 'Abbrechen'

Rückgabewert

Rückgabewertint ID der betätigten Schaltfläche:

IDOK = Schaltfläche 'OK' betätigtIDCANCEL = Schaltfläche 'Abbrechen' betätigt



Beispiel

int RetMsg;

RetMsg = MessageBox (NULL, "Fehler bei Aufruf der API-Funktionen", "System-Fehler", MB_SYSTEMMODAL | MB_OK);

1.4.6 Beispiele

1.4.6.1 Beispiele

EinleitungIm Rahmen dieser Beschreibung wurden zwei Beispiele für Dynamic Wizard Funktionen erstellt:

● Demo Wizard

● Motor dynamisieren

Siehe auchMotor dynamisieren (Seite 99)

Demo Wizard (Seite 96)

1.4.6.2 Demo Wizard

Demo Wizard

EinleitungIn der Datei "Demo.wnf" wird ein Dynamic Wizard mit der Bezeichnung "Demo" Wizard erstellt. Dieser Dynamic Wizard zeigt die grundlegenden Funktionen, welche zur Verfügung stehen, um dem Anwender komfortabel die Eingabe von Daten zu ermöglichen. Der Demo Wizard führt jedoch keine Aktion aus.



Siehe auchSo fügen Sie das Skript "Demo.wnf" in die Datenbasis ein (Seite 98)

So erstellen Sie den Hilfetext (Seite 97)

So erstellen Sie die Dynamic Wizard Funktion für den Demo Wizard (Seite 97)

So erstellen Sie die Dynamic Wizard Funktion für den Demo Wizard

VoraussetzungEin WinCC Projekt muss geöffnet sein.

Vorgehensweise1. Kopieren Sie im Windows Explorer die Datei "Demo.wnf" aus dem Verzeichnis "Siemens\

WinCC\ documents\ german" in das Verzeichnis "Siemens\ WinCC\ wscript\ wscript.deu".

2. Starten Sie den Dynamic Wizard Editor.

3. Wählen Sie im Menü Datei des Dynamic Wizard Editors den Eintrag "Öffnen" aus. Es öffnet sich der Dateiauswahldialog.

4. Markieren Sie die Datei "Demo.wnf". Klicken Sie auf die Schaltfläche "Öffnen". Die Datei "Demo.wnf" wird in einem Editierfenster angezeigt.

5. Klicken Sie auf das Symbol in der Symbolleiste, um das Skript zu übersetzen. Das Ergebnis wird im Ausgabefenster angezeigt.

Siehe auchSo fügen Sie das Skript "Demo.wnf" in die Datenbasis ein (Seite 98)

So erstellen Sie den Hilfetext

EinleitungIn diesem Abschnitt wird für den Dialog "Trigger auswählen" eine Hilfe erstellt.

Vorgehensweise1. Klicken Sie auf die das Symbol in der Symbolleiste. Es öffnet sich der Hilfe-Editor.

2. Wählen Sie im Feld "Wizard - Gruppe" den Eintrag "Beispiel" aus.

3. Wählen Sie im Feld "Wizard - Name" den Eintrag "Demo Wizard" aus.

4. Wählen Sie im Feld "Seite" den Eintrag "TriggerPage" aus

5. Tragen Sie im Feld "Hilfe - Text:" folgenden Text ein: "Trigger auswählenIn diesem Dialog können Sie das Ereignis festlegen, bei dem eine Aktion ausgeführt werden soll."



6. Schließen Sie den Hilfe-Editor über die Schaltfläche "OK".

7. Führen Sie den Demo Wizard aus. Klicken Sie im Dialog "Trigger auswählen" auf die Schaltfläche "Hilfe".

So fügen Sie das Skript "Demo.wnf" in die Datenbasis ein

EinleitungUm die Dynamic Wizard Funktion "Demo.wnf" im Graphics Designer einsetzen zu können , muss diese in die Datenbasis des Dynamic Wizard eingebunden werden.

Dazu sind folgende Schritte notwendig,

1. Einlesen des Wizard Skripts

2. Erzeugen der cwd-Datei

Vorgehensweise1. Klicken Sie auf die das Symbol in der Symbolleiste. Es öffnet sich der

Dateiauswahldialog.

2. Wählen Sie die Datei "Demo.wnf" aus. Klicken Sie auf die Schaltfläche "Öffnen".

3. Klicken Sie auf das Symbol in der Symbolleiste, um die Datenbasis neu zu erstellen.



4. Wählen Sie im Menü "Ansicht" des Dynamic Wizard Editor den Menüpunkt "Dynamic Wizard".

5. Klicken Sie auf die Registerkarte "Beispiel". Doppelklicken Sie auf den Eintrag "Demo Wizard".

1.4.6.3 Motor dynamisieren

Motor dynamisieren

EinleitungIn der Skriptdatei "Motor.wnf" ist ein Dynamic Wizard mit der Bezeichnung "Motor dynamisieren" erstellt.

Hinweis

Dieser wurde eigens für die Dynamisierung eines Anwender-Objekt namens Motor erstellt und kann auf keine andere Objektart angewendet werden.

Siehe auchSo dynamisieren Sie das Anwender-Objekt "Motor" (Seite 101)

So fügen Sie das Skript "Motor.wnf" in die Datenbasis ein (Seite 100)

So erstellen Sie die Dynamic Wizard Funktion für den Motor (Seite 99)

So erstellen Sie die Dynamic Wizard Funktion für den Motor

VoraussetzungEin WinCC Projekt muss geöffnet sein.



Vorgehensweise1. Öffnen Sie im Windows Explorer das Winzip-Archiv "Motor.zip" im Verzeichnis "Siemens\

WinCC\ documents\ german".

2. Extrahieren Sie die Datei "Motor.wnf" in das Verzeichnis "..\WinCC\wscripts\wscripts.deu".

3. Extrahieren Sie die Datei "Motor_dyn.pdl" in das Verzeichnis "..\WinCC\WinCCProjects\Name desWinCCProjekts\GraCs".

4. Starten Sie den Dynamic Wizard Editor.

5. Wählen Sie im Menü Datei des Dynamic Wizard Editors den Eintrag "Öffnen" aus. Es öffnet sich der Dateiauswahldialog.

6. Markieren Sie die Datei "Motor.wnf". Klicken Sie auf die Schaltfläche "Öffnen". Die Datei "Motor.wnf" wird in einem Editierfenster angezeigt.

7. Klicken Sie auf das Symbol in der Symbolleiste, um das Skript zu übersetzen. Das Ergebnis wird im Ausgabefenster angezeigt.

Siehe auchSo fügen Sie das Skript "Motor.wnf" in die Datenbasis ein (Seite 100)

So fügen Sie das Skript "Motor.wnf" in die Datenbasis ein

EinleitungUm die Dynamic Wizard Funktion "Motor.wnf" im Graphics Designer einsetzen zu können , muss diese in die Datenbasis des Dynamic Wizard eingebunden werden.

Dazu sind folgende Schritte notwendig,

1. Einlesen des Wizard Skripts

2. Erzeugen der cwd-Datei

Vorgehensweise1. Klicken Sie auf die das Symbol in der Symbolleiste. Es öffnet sich der

Dateiauswahldialog.

2. Wählen Sie die Datei "Motor.wnf" aus. Klicken Sie auf die Schaltfläche "Öffnen".

3. Klicken Sie auf das Symbol in der Symbolleiste, um die Datenbasis neu zu erstellen.

Siehe auchSo dynamisieren Sie das Anwender-Objekt "Motor" (Seite 101)



So dynamisieren Sie das Anwender-Objekt "Motor"

EinleitungDas Anwender-Objekt Motor wird über den Dynamic Wizard "Motor dynamisieren" mit einer WinCC Strukturvariable vom Strukturtyp "MotorStruct" verknüpft. Dabei werden verschiedene C-Aktionen und Variablenanbindungen an diesem Objekt erstellt. Dieser Wizard kann auf keine andere Objektart angewendet werden.

Voraussetzung● Legen Sie eine interne Variable "T08i_course_wiz_selected" vom Datentyp "Textvariable

8-Bit-Zeichensatz".

● Legen Sie eine Struktur mit dem Namen "MotorStruct" und drei interne Elemente namens "Activ", "Hand" und "Error" vom Datentyp BIT an.

● Legen Sie eine interne Variable namens "STR_Course_wiz1" vom Datentyp "MotorStruct".

Vorgehensweise1. Öffnen Sie den Graphics Designer. Wählen Sie im Menü "Datei" den Menüeintrag "Öffnen".

Wählen Sie im Dateiauswahldialog das Bild "Motor_dyn.pdl" aus.

2. Markieren Sie das Anwender-Objekt Motor. Auf der Registerkarte "Beispiel" wird der Wizard "Motor dynamisieren" angeboten.

3. Starten Sie den Dynamic Wizard. Klicken Sie im Dialog "Willkommen beim Dynamic Wizard" auf die Schaltfläche "Weiter". Es öffnet sich die Dialog "Optionen setzen"

4. Klicken Sie im Dialog "Optionen setzen" auf die Durchsuchen-Schaltfläche. Es öffnet sich der Variablenauswahldialog. Wählen Sie als Strukturvariable den Eintrag "STR_Course_wiz1" aus. Schließen Sie den Dialog über die Schaltfläche "OK".

5. Klicken Sie im Dialog "Optionen setzen" auf die Schaltfläche "Weiter". Es öffnet sich der Dialog "Fertig!". Schließen Sie den Dialog über die Schaltfläche "Fertigstellen".

6. Speichern Sie das Bild. Aktivieren Sie Graphics Designer Runtime.

7. Über die Schaltflächen können Sie die Variablenwerte des selektierten Motors simuliert werden.



Siehe auchSo legen Sie die Struktur und die Strukturvariable an (Seite 102)

So legen Sie die Struktur und die Strukturvariable an

EinleitungIn diesem Abschnitt wird gezeigt, wie die Struktur "MotorStruc" und die Strukturvariable "STR_Course_wiz1" projektiert wird. Die Struktur und die Strukturvariable werden in dem Beispiel "Motor dynamisieren" verwendet.

Vorgehensweise1. Wählen Sie im Kontextmenü "Strukturtypen" den Eintrag "Neuer Strukturtyp" aus. Es öffnet

sich der Dialog "Struktur-Eigenschaften

2. Benennen Sie die Struktur in "MotorStruc" um. Klicken Sie auf Schaltfläche "Neues Element" und legen Sie eine interne Variable "Active" vom Datentyp BIT an.

3. Klicken Sie auf Schaltfläche "Neues Element" und legen Sie eine interne Variable "Hand" vom Datentyp BIT an.

4. Klicken Sie auf Schaltfläche "Neues Element" und legen Sie eine interne Variable "Error" vom Datentyp BIT an. Schließen Sie den Dialog über die Schaltfläche "OK".

5. Klicken Sie im Navigationsfenster auf das "Pluszeichen" vor dem Symbol "Variablenhaushalt". Wählen Sie im Kontextmenü "interne Variablen" den Eintrag "Neue Variable" aus. Legen Sie eine WinCC Variable "STR_Course_wiz1" vom Datentyp "MotorStruc" an.



1.5 Documentation Viewer

1.5.1 WinCC Documentation Viewer

KurzbeschreibungDruckaufträge des WinCC-Protokollsystems können in eine Datei umgeleitet werden. Bei großen Datenmengen wird für jede Protokollseite eine Datei angelegt.

Mit dem WinCC Documentation Viewer können diese Dateien angezeigt und ausgedruckt werden.

1.5.2 Installation des WinCC Documentation ViewerDer WinCC Documentation Viewer kann auf zwei Arten installiert werden:



Den WinCC Documentation Viewer starten Sie über "SIMATIC > WinCC > Tools".

Alternative VorgehensweiseSie können den WinCC Documentation Viewer auch von der WinCC-DVD installieren.



3. Wählen Sie im Dialog "Komponenten" den Eintrag "WinCC Documentation Viewer".


Hinweis

Ist ein WinCC Projekt aktiviert, können Sie nur die emf-Dateien dieses Projektes ansehen und ausdrucken. Ist WinCC nicht aktiv, können Sie mit dem WinCC Documentation Viewer sämtliche emf-Dateien öffnen und ausdrucken.

SmartTools1.5 Documentation Viewer


1.5.3 Beschreibung

EinleitungDruckaufträge können in eine Datei umgeleitet werden. Bei großen Datenmengen wird für jede Protokollseite eine Datei angelegt.

Mit dem WinCC Documentation Viewer können diese Dateien angezeigt und ausgedruckt werden.

Hinweis

Ist beim Start des WinCC Documentation Viewer ein WinCC Projekt bereits aktiviert, können Sie nur die emf-Dateien des aktiven WinCC Projektes anzeigen und ausdrucken. Ist beim Start des Viewer das WinCC Projekt geöffnet, aber nicht aktiviert, so können Sie mit dem Viewer sämtliche emf-Dateien öffnen und ausdrucken.

Beim Deaktivieren des Runtime wird der Viewer in jedem Fall geschlossen.

Der WinCC Documentation Viewer ist in drei Bereiche unterteilt.

Am oberen Bildschirmrand befindet sich die Menüleiste. Über die Direkthilfe werden die Menüeinträge erläutert.

Direkt unterhalb der Menüleiste befindet sich die Symbolleiste. Häufig benötigte Funktionen wie z.B das Vor- und Zurückblättern werden hier als Symbole abgelegt. Über die Direkthilfe werden die Funktionen der einzelnen Symbole erläutert.

Im Fenster wird das aktuelle Dokument dargestellt. Die Darstellung ist per Mausklick in zwei Stufen vergrößerbar.

Der Bildschirm wird nach unten durch die Statuszeile, in der Informationen zur aktuellen Bedienung dargestellt werden, begrenzt.



1.5.4 Erzeugen der .emf-Datei(en)

EinleitungDruckaufträge können in eine Datei umgeleitet werden. Bei großen Datenmengen wird für jede Protokollseite eine Datei angelegt. Die Druckausgabe erfolgt in eine oder mehrere .emf-Dateien. Die Dateien werden mit dem Namen Page<nnnnnn>.emf in dem Pfad abgelegt, wobei <nnnnn> eine fünfstellige fortlaufende Nummer darstellt.

Der Name des Pfades setzt wie folgt zusammen: aus dem Projektpfad (z.B. "C:\VFSWinCC\PRT\") sowie <Ablage> + <JJJJMMTTHHMM> (JJJJ = Jahr, MM = Monat, TT = Tag, HH = Stunde, MM = Minute).

Wenn Sie in das Feld "Ablage" mit "PDdaten" eintragen, wird innerhalb des Projektverzeichnisses für den Druckauftrag die folgende Pfadstruktur angelegt.

Vorgehensweise1. Wählen Sie in den WinCC Editoren im Menü "Datei" den Eintrag "Projektdokumentation

einrichten" aus.

2. Klicken Sie im Dialog "Druckauftrageigenschaften" auf die Registerkarte "Druckerfestlegung".

3. Aktivieren Sie auf der Registerkarte "Druckerfestlegung" das Kontrollkästchen "Datei (*.emf)". Falls Sie keine gleichzeitige Ausgabe auf dem Drucker wünschen, deaktivieren Sie das Kontrollkästchen "Drucker".

4. Tragen Sie im Feld "Ablage" den Namen des Pfades ein, in welchem die Datei abgelegt werden soll. Schließen Sie den Dialog über die Schaltfläche "OK".

5. Wählen Sie im Menü "Datei" den Eintrag "Projektdokumentation drucken" aus. Die Druckausgabe erfolgt in eine oder mehrere .emf-Dateien. Die Dateien werden mit dem Namen Page<nnnnnn>.emf in dem Pfad abgelegt, wobei <nnnnn> eine fünfstellige fortlaufende Nummer darstellt.



1.6 WinCC CrossReferenceAssistant

1.6.1 WinCC CrossReferenceAssistant

KurzbeschreibungWinCC CrossReferenzAssistant ist ein Tool, welches Skripte nach Bildnamen und Variablen durchsucht und die betreffenden Skripte so ergänzt, dass die WinCC-Komponente Cross Reference die Bildnamen und Variablen findet und in der Querverweisliste aufführt.

1.6.2 Installation des CrossReferenceAssistantDen WinCC CrossReferenceAssistant gibt es mit deutscher, englischer und französischer Bedienoberfläche.



Den WinCC CrossReferenceAssistant starten Sie über "SIMATIC > WinCC > Tools".

Alternative VorgehensweiseSie können den WinCC CrossReferenceAssistant auch von der WinCC-DVD installieren.



3. Wählen Sie im Dialog "Komponenten" den Eintrag "CrossReferenceAssistant".


1.6.3 Allgemein

EinleitungWinCC besitzt die Fähigkeit CrossReference-Listen erstellen zu können. Damit bei der Erstellung dieser Listen Variablen in Funktionsaufrufen richtig erkannt werden können, wurde WinCC um eine Projektierungsvorschrift erweitert, die Folgendes vorsieht:

SmartTools1.6 WinCC CrossReferenceAssistant


Um die Variablen- bzw. Bildnamen, die in C-Aktionen benutzt werden, suchen und ersetzen zu können, muss das Skript folgendermaßen geschrieben werden:

PrinzipAm Anfang des Skriptes müssen in zwei Abschnitten alle benutzten Variablen und Bildnamen deklariert werden. Innerhalb der Abschnitte dürfen Sie keine weitere Anweisungen eintragen.

Diese Abschnitte haben folgenden Aufbau:

// WINCC:TAGNAME_SECTION_START// syntax: #define TagNameInAction DMTagName// next TagID : 1#define ApcVarName1 "VarName1"// WINCC:TAGNAME_SECTION_END

// WINCC:PICNAME_SECTION_START// syntax: #define PicNameInAction PictureName// next PicID : 1#define ApcBildname1 "Bildname1"#define ApcBildname2 "Bildname2"#define ApcBildname3 "Bildname3"// WINCC:PICNAME_SECTION_END

Der Aufruf der Standardfunktionen zum Lesen bzw. Schreiben der Variablen muss dann über die definierten Variablen und Bilder erfolgen.

GetTagDWord (ApcVarName1);OpenPicture(ApcBildname1);SetPictureName( ApcBildname2, "Bildfenster1",ApcBildname3);

Bei Nichteinhaltung der Projektierungsvorschrift können keine CrossReference-Listen erstellt werden, da die Referenzen der Variablen und Bilder in den Skripten nicht aufgelöst werden können.

Mit Hilfe des WinCC CrossReferenceAssistant werden nun alle in der Skriptverwaltung bekannten Funktionsaufrufe durch die oben beschriebene Form ersetzt. Konvertiert werden lediglich Projektfunktionen, Bilder und Aktionen.

Die Laufzeitumgebung für den WinCC CrossReferenceAssistant ist WinCC. Ist WinCC nicht gestartet, oder ist das zu konvertierende Projekt nicht geladen, so wird WinCC durch den WinCC CrossReferenceAssistant gestartet und/oder veranlasst das Projekt zu laden.

Siehe auchBekannte Funktionen (Skriptverwaltung) (Seite 107)

1.6.4 Bekannte Funktionen (Skriptverwaltung)Folgende Funktionen sind dem Wizard standardmäßig bekannt und werden bei der Konvertierung umgesetzt:



Funktionen mit Variablen als Parameter:GetTagBit()

GetTagByte()

GetTagChar()

GetTagDouble()

GetTagDWord()

GetTagFloat()

GetTagRaw()

GetTagSByte()

GetTagSDWord()

GetTagSWord()

GetTagWord()

SetTagBit()

SetTagByte()

SetTagChar()

SetTagDouble()

SetTagDWord()

SetTagFloat()

SetTagRaw()

SetTagSByte()

SetTagSDWord()

SetTagSWord()

SetTagWord()

GetTagBitWait()

GetTagByteWait()

GetTagCharWait()

GetTagDoubleWait()

GetTagDWordWait()

GetTagFloatWait()

GetTagRawWait()

GetTagSByteWait()

GetTagSDWordWait()

GetTagSWordWait()



GetTagWordWait()

SetTagBitWait()

SetTagByteWait()

SetTagCharWait()

SetTagDoubleWait()

SetTagDWordWait()

SetTagFloatWait()

SetTagRawWait()

SetTagSByteWait()

SetTagSDWordWait()

SetTagSWordWait()

SetTagWordWait()

GetTagBitState()

GetTagByteState()

GetTagCharState()

GetTagDoubleState()

GetTagDWordState()

GetTagFloatState()

GetTagRawState()

GetTagSByteState()

GetTagSDWordState()

GetTagSWordState()

GetTagWordState()

SetTagBitState()

SetTagByteState()

SetTagCharState()

SetTagDoubleState()

SetTagDWordState()

SetTagFloatState()

SetTagRawState()

SetTagSByteState()

SetTagSDWordState()



SetTagSWordState()

SetTagWordState()

GetTagBitStateWait()

GetTagByteStateWait()

GetTagCharStateWait()

GetTagDoubleStateWait()

GetTagDWordStateWait()

GetTagFloatStateWait()

GetTagRawStateWait()

GetTagSByteStateWait()

GetTagSDWordStateWait()

GetTagSWordStateWait()

GetTagWordStateWait()

SetTagBitStateWait()

SetTagByteStateWait()

SetTagCharStateWait()

SetTagDoubleStateWait()

SetTagDWordStateWait()

SetTagFloatStateWait()

SetTagRawStateWait()

SetTagSByteStateWait()

SetTagSDWordStateWait()

SetTagSWordStateWait()

SetTagWordStateWait()

Funktionen mit Bildnamen als Parameter:SetPictureName()

GetPictureName()

GetVisible()

SetVisible()

GetLink()

SetLink()



Set_Focus()

OpenPicture()

GetLinkedVariable()

1.6.5 Projektauswahl

Ein Klick auf den Button "..." führt zum Öffnen eines OpenFile-Dialogs, der es ermöglicht, ein beliebiges Projekt auszuwählen. Ein Klick auf "Aktuelles Projekt" bewirkt, dass der WinCC CrossReferenceAssistant versucht, das aktuell in WinCC geladene Projekt auszulesen und anzuzeigen. Ist WinCC nicht gestartet oder kein Projekt geladen, wird es gestartet bzw. das gewünschte Projekt geladen.

Wenn bereits ein anderes Projekt geladen aber nicht aktiviert ist, wird das Projekt geschlossen und das gewünschte Projekt geöffnet. Dieser Vorgang kann unter Umständen einige Zeit dauern.

Sobald in die Eingabezeile mit der Aufforderung "Wählen Sie ein WinCC-Projekt aus:" Text eingegeben worden ist, kann auf den Button "Weiter >" geklickt werden. Es wird überprüft, ob es sich beim angegebenen Projekt um ein gültiges WinCC-Projekt handelt. Ist das nicht der Fall, so wird der Fokus auf die Eingabezeile gesetzt, und ein Meldungsfenster mit einem Hinweis auf den entsprechenden Fehler wird angezeigt.

"Abbrechen" beendet den WinCC CrossReferenceAssistant.



1.6.6 DateiauswahlAlle zum Projekt gehörende Bilder, Projektfunktionen und C-Aktionen werden in der rechten Liste des Dialogs angezeigt. In der Standardeinstellung werden alle Dateien, die zum Projekt gehören, konvertiert.

Es steht dem Benutzer frei, bestimmte Dateien aus der Konvertierung auszuschließen um sie eventuell später einzufügen. Ein Löschen aus der Konvertierungsliste erfolgt durch (Mehrfach-) Auswahl der entsprechenden Dateien in der Liste "Zu konvertierende Dateien" und anschließendes Klicken des Buttons "<--Entfernen".

Entfernte Dateien werden in der linken Liste angezeigt und können wieder in die Konvertierung aufgenommen werden. Zu diesem Zweck müssen diese Dateien in der Liste "Wählen Sie Dateien aus" selektiert werden. Diese werden anschließend beim Drücken des Buttons "Hinzufügen-->" wieder in die rechte Liste "Zu konvertierende Dateien" aufgenommen.

Nach Beendigung der Dateiauswahl klicken Sie auf "Weiter >". Das bewirkt, dass alle angegeben Dateien gelesen und analysiert werden.

„< Zurück„ blättert zurück auf die Projektauswahl, "Abbrechen" beendet den WinCC CrossReferenceAssistant.

Siehe auchProjektauswahl (Seite 111)



1.6.7 Konvertierung

EinleitungAls letzte Seite des Wizards wird eine Seite angezeigt, die es einerseits ermöglicht, noch "Erweiterte Einstellungen" vorzunehmen (siehe Erweiterte Einstellungen), und andererseits nach Starten der Konvertierung den Fortschritt und die gerade bearbeitete Datei zu sehen.

Beschreibung

"< Zurück" blättert zurück auf die Dateiauswahl, "Abbrechen" beendet den WinCC CrossReferenceAssistant.

Zum Starten der Skriptkonvertierung klicken Sie "Fertig stellen". Nachdem die Konvertierung gestartet worden ist, kann weder zurück geblättert ("< Zurück"), noch auf "Erweiterte Einstellungen" geklickt werden.

Während der Konvertierung wird im Fortschrittsbalken angezeigt, wie viel Prozent der Konvertierung bereits abgeschlossen ist. Außerdem können Sie sehen, welche Datei gerade konvertiert wird.

Bei der Konvertierung wird folgendermaßen vorgegangen: Die Skripts werden nach Funktionsaufrufen untersucht, die Bild- oder Variablenparameter erwarten. Wird eine solche



Funktion im Skript gefunden, wird die Zeichenkette, die als Parameter übergeben worden ist, durch ein Define ersetzt (siehe Projektierungsvorschriften).

Welche Funktionen Bild- oder Variablenparameter erwarten, wird über eine Skriptverwaltungsdatei kontrolliert. Daher müssen alle diese Funktionen in diese Datei eingetragen und dadurch dem System bekannt gemacht worden sein. Die Liste dieser Funktionen kann über die Skriptkonvertierung um Projektfunktionen und Standardfunktionen, die ebenfalls Bild- oder Variablenparameter erwarten, erweitert werden (Erweiterte Einstellungen).

Nach Abschluss der Konvertierung wird eine Zusammenfassung eingeblendet, die Auskunft darüber gibt, wie viele Funktionen, Bilder und Skripte in den Bildern, und wie viele Variablen konvertiert worden sind.

Sollte ein Fehler aufgetreten sein, können Sie genauere Auskunft über die Fehlerursache bekommen, indem Sie die während der Konvertierung angelegte Logdatei inspizieren. Diese Datei liegt Projektverzeichnis und heißt CCCrossReferenceAssistant.log.

Siehe auchErweiterte Einstellungen (Seite 114)

Allgemein (Seite 106)

Dateiauswahl (Seite 112)

1.6.8 Erweiterte EinstellungenHier können Sie bei Bedarf selbst erstellte Funktionen bekannt machen.

In der Liste "Wählen Sie eine Funktion mit Variablen- oder Bildparametern aus:" werden alle Projektfunktionen angezeigt. Wird die Checkbox "Standardfunktionen anzeigen" aktiviert, werden auch die in WinCC enthaltenen Standardfunktionen angezeigt.



Der Benutzer kann aus der Liste der Funktionen jene auswählen, die an einer bestimmten Stelle eine Variable oder ein Bild als Parameter erwarten. Alle hier ausgewählten Funktionen werden in eine projektspezifische Skriptverwaltungsdatei aufgenommen.

Der CrossReferenceAssistant erkennt nur solche Funktionen als Funktionen mit Bild- oder Variablenparametern, die dem System als solche bekannt gemacht worden sind. Damit auch Aufrufe von benutzerdefinierten Funktionen, die Variablenparameter erwarten entsprechend der Projektierungsvorschriften angepasst werden können, müssen diese im Zuge der Konvertierung in die Skriptverwaltung aufgenommen werden.

Im Dialogfeld "Funktionen in der Scriptverwaltung" werden alle Funktionen angezeigt, die bereits in die Skriptverwaltung aufgenommen worden sind. Wenn dieser Dialog eingeblendet wird, werden die Standard- und die Projektkonfigurationsdatei ausgelesen, und der gemeinsame Inhalt beider Dateien angezeigt.

Um nun eine Funktion, die einen Variablen- oder Bildparameter erwartet, zu kennzeichnen, muss sie zuerst aus dem Kombinationsfeld "Wählen Sie eine Funktion mit Variablen- oder Bildparametern aus:" ausgewählt werden.

Anschließend kann mittels Parameterliste festgelegt werden ob der spezielle Parameter eine Variable oder ein Bild darstellt. Mittels Klick auf "..." wird ein Kontextmenü geöffnet, das dem Anwender eine Auswahl anbietet, ob es sich bei dem ausgewählten Parameter um eine Variable oder ein Bild handelt.

Für alle Parameter, für die eines der beiden Kriterien zutrifft, muss dieser Vorgang wiederholt werden.

"Funktion hinzufügen -->" bestätigt die Eingabe und fügt die ausgewählte Funktion in die Liste auf der rechten Seite des Dialogs hinzu. Fehlerhafte Eingaben können rückgängig gemacht werden, indem die zu löschenden Funktionen in der Liste "Funktionen in der Scriptverwaltung" ausgewählt werden und anschließend mittels "<-- Ausgewählte Funktionen entfernen" aus der Liste entfernt werden.



Ein Klick auf "Schließen" bewirkt das Schreiben der gesammelten Informationen in die Konfigurationsdateien und die Berücksichtigung der geänderten Informationen bei der Konvertierung und das Schließen des Dialogs.

Siehe auchAllgemein (Seite 106)



1.7 WinCC Communication Configurator

KurzbeschreibungDer WinCC Communication Configurator (CCComunicationConfigurator.exe) ist ein Werkzeug, mit dem die Einstellung der WinCC Kommunikationsparameter auf die vorhandene Netzwerkumgebung auf einfache Weise erfolgen kann.

BeschreibungDer WinCC Communication Configurator (CCComunicationConfigurator.exe) ist ein Werkzeug, mit dem die Einstellung der WinCC Kommunikationsparameter auf die vorhandene Netzwerkumgebung auf einfache Weise erfolgen kann.

Der Einsatz des WinCC Communication Configurator ist immer dann sinnvoll, wenn kein Ethernet LAN mit einer Übertragungsrate von 100 Mbit/s zur Verfügung steht. Auch bei sporadischen Verbindungsinstabilitaeten aufgrund von Hochlastsituationen ( wie z.B. keine Verbindung zu den Datenservern, EA-Felder ohne Anzeigewert) empfiehlt sich die Verwendung des Configurators.

Die WinCC Kommunikation ist mit den Standardparametern so eingestellt, dass sie sehr empfindlich gegenüber Kommunikationsfehlern reagiert, z.B. um auftretende Störungen sehr schnell an den Anwender zu melden oder auch um bei einem Client-Rechner eine kurze "Failover"-Zeit zum redundanten Server zu garantieren.

In einem Netzwerk mit niedrigen Übertragungsraten oder bei hoher Netzwerk-/CPU-Auslastung wird durch dieses störungssensitive Verhalten die Stabilität der logischen Netzwerkverbindungen von WinCC beeinflusst, da in den unterlagerten Mechanismen der Lebenszeichenüberwachung die erwarteten Rückmeldungszeiten nicht erreicht werden können.

Der Communication Configurator passt die Kommunikationsparameter so an die vorhandenen Gegebenheiten an, dass eine optimale Abstimmung zwischen Störungsempfindlichkeit und Verbindungsstabilität gewährleistet ist.

Hinweis

Wird der WinCC Communication Configurator eingesetzt, so muss dies auf dem WinCC Client- und auf dem WinCC Server-Rechner erfolgen.

Der Communication Configurator verändert nur die Einstellungen für die WinCC Kommunikation, nicht jedoch die Parametrierungen für die Kommunikationsverbindungen des Betriebssystems.

Feld / Option Beschreibung100 MBit/s Anwendbar bei Ethernet LANs mit einer Übertragungsrate von 100 MBit/s

(Standardeinstellung).10 MBit/s Für Ethernet LANs mit einer Übertragungsrate von 10 MBit/s.1 MBit/s Für Netzwerke mit einer Übertragungsrate von 1 MBit/s.

SmartTools1.7 WinCC Communication Configurator


Feld / Option Beschreibung0,1 MBit/s Für Netzwerke oder Kommunikationsverbindungen mit einer Übertragungsrate

von 0,1 MBit/s. Diese Einstellung ist geeignet für Verbindungen über ISDN (MultiLink), ISDN und Modem.

Kontrollkästchen "Server Pings Client"

Überprüft die Verbindung zum Client durch den Server.

Schaltfläche "Default"

Setzt die Einstellung auf die Standardeinstellung "Ethernet LAN (100 Mbit/s)"

Hinweis

Wir empfehlen die Verwendung von Clients mit einer Übertragungsrate von mindestens 128 KBit/s.

SmartTools1.7 WinCC Communication Configurator


1.8 WinCC ConfigurationTool

1.8.1 Einführung

Einleitung Das ConfigurationTool bietet Ihnen eine einfache und performante Möglichkeit zur Projektierung von Massendaten in WinCC. Als Benutzerinterface dient Microsoft Excel. So können Sie ein WinCC-Projekt in Microsoft Excel erzeugen, und dabei die Vorteile nutzen, die Ihnen Microsoft Excel bei der Bedienung bietet.

In diesem Kapitel wird Ihnen ein Überblick über die Funktionalität des ConfigurationTools sowie dessen Bedienung selbst gegeben.

ÜbersichtZiel des ConfigurationTools ist es, eine einfache und performante Möglichkeit zur Projektierung von Massendaten in WinCC zu bieten.

Als Benutzerinterface dient Microsoft Excel. Diese Software eignet sich auf Grund des Tabellenformats gut zur Handhabung und zur Darstellung der Daten von WinCC. Des Weiteren bringt es eine Vielzahl an Editiermöglichkeiten (z.B. Autoausfüllen) mit. Außerdem können erfahrene Benutzer, denen die angebotene Funktionalität nicht ausreicht, mittels VBA Programmen (Makros) die Editiermöglichkeiten nach belieben erweitern.

Das ConfigurationTool bietet die Möglichkeit, ein neues WinCC-Projekt anzulegen und dieses von Anfang an aus Excel heraus zu projektieren. Des Weiteren können auch bestehende WinCC-Projekte eingelesen und in Excel weiterbearbeitet werden. Dazu verwenden Sie die lokalen Projektierungsdaten. Nur Clients ohne eigenem Projekt können remote eingelesen werden. Auf dem Server muss im Projekt der Rechnername des Client eingetragen sein, auf dem das ConfigurationTool läuft. Die Rechte für "Remote Projektieren" müssen vergeben sein.

Die Projektierung erfolgt in einer speziellen Art von Excelmappe, einer sogenannten WinCC-Projektmappe. Diese enthält verschiedene Arten von Tabellenblättern, welche jeweils zur Projektierung eines bestimmten Typs von WinCC-Objekten dienen. Mit dem ConfigurationTool können die Daten des Datenmanagers, des Alarm Logging, des Tag Logging und der Text Library projektiert werden.

Hinweis

Im ConfigurationTool können Sie nur Verbindungen oder Variablen von Kanälen bearbeiten, die standardmäßig von WinCC mitgeliefert werden.

SmartTools1.8 WinCC ConfigurationTool


1.8.2 Systemvoraussetzungen

Einleitung Das ConfigurationTool unterliegt den Systemvoraussetzungen von WinCC und von Microsoft Excel. Das ConfigurationTool kann auch ohne WinCC verwendet werden. In diesem Fall können Sie keine Daten nach WinCC schreiben.

Systemvoraussetzungen● Windows XP SP3

Windows 7 32-Bit und 64-BitWindows Server 2003 (R2) SP2Windows Server 2008 SP2 32-Bit und 64-Bit

● Microsoft Office 2003, Office 2007 und Office 2010. Microsoft Office wird nur mit 32-Bit unterstützt.Visual Basic für Applikationen muss installiert sein.

● Internet Explorer 7, 8 oder 9

Hinweis

Für Microsoft Office 2003 benötigen Sie den "Office-Assistenten", damit die Warnmeldungen des ConfigurationTool ausgegeben werden.

Siehe auchBeispiel für ein Mengengerüst im ConfigurationTool (Seite 243)

1.8.3 Installation des ConfigurationToolDas WinCC ConfigurationTool kann auf zwei verschieden Arten installiert werden.



Das WinCC ConfigurationTool starten Sie über "SIMATIC > WinCC > Tools".



Alternative VorgehensweiseSie können das WinCC ConfigurationTool auch von der WinCC-DVD installieren.

1. Wechseln Sie auf der WinCC-DVD in das Verzeichnis "WinCC\InstData\ConfigurationTool\Setup".


3. Folgen Sie den Anweisungen auf dem Bildschirm.Das WinCC ConfigurationTool wird installiert.

1.8.4 Oberfläche

1.8.4.1 Oberfläche

EinleitungDas ConfigurationTool liefert eine Reihe von neuen Funktionen. Des Weiteren eine eigene Symbolleiste und einen Systemmenüeintrag. Zu bestehenden Excel Menüs werden ebenfalls neue Menüpunkte hinzugefügt. Eine nähere Erläuterung der soeben genannten Änderungen finden Sie in den nachfolgenden Kapiteln.

Siehe auchStatuszeile (Seite 126)

Symbolleiste (Seite 121)

Kontextmenü (Seite 125)

Dropdown-Menü (Seite 122)

1.8.4.2 Symbolleiste

Einleitung Das ConfigurationTool liefert eine eigene Symbolleiste mit folgenden Elementen.



Projektmappe erstellenEs wird der Wizard "Neue Projektmappe" geöffnet. Über diesen Wizard ist es möglich eine neue Projektmappe anzulegen.Sprache umschaltenÖffnet den Dialog "Sprache wählen".HilfeÖffnet die Online-Hilfe des ConfigurationTools.WinCC-Projekt erstellenEs wird der Wizard "Neues WinCC-Projekt" geöffnet. Über diesen Wizard ist es möglich, ein neues WinCC-Projekt aus einer bestehenden Projektmappe zu erstellen. Die Projektmappe wird mit dem neuen WinCC-Projekt verbunden.Projektverbindung herstellenIst nur selektierbar, wenn die aktive Projektmappe bereits einem WinCC-Projekt zugeordnet und das WinCC-Projekt nicht aktiv ist.Tabelle hinzufügenEs wird der Dialog "Tabelle hinzufügen" geöffnet. Über diesen Dialog ist es möglich der Projektmappe ein neues Tabellenblatt hinzuzufügen.Nach WinCC schreibenEs wird der Dialog "Schreiben" geöffnet. Über diesen Dialog ist es möglich, alle Daten der Projektmappe nach WinCC zu schreiben.

1.8.4.3 Dropdown-Menü

Einleitung Unter Dropdown-Menü versteht man die Menüs, die über das Systemmenü erreicht werden. Das ConfigurationTool fügt zum Excel Systemmenü einen weiteren Menüpunkt hinzu.

Elemente des Dropdown-MenüsDas Dropdown-Menü bietet abhängig vom Verbindungsstatus und Projektmappentyp verschiedene Auswahlmöglichkeiten.



Keine Projektmappe ist aktiv

Projektmappe erstellen

Es wird der Wizard "Neue Projektmappe" geöffnet. Über diesen Wizard ist es möglich, eine neue Projektmappe anzulegen.

Sprache umschalten

Öffnet den Dialog "Sprache wählen".

Hilfe Öffnet die Online-Hilfe des ConfigurationTools.

Eine Projektmappe mit Verbindung zu einem WinCC-Projekt ist aktiv

WinCC-Projekt erstellen

Es wird der Wizard "Neues WinCC-Projekt" geöffnet. Über diesen Wizard ist es möglich, ein neues WinCC-Projekt zu erstellen. Die Projektmappe wird mit diesem WinCC-Projekt verbunden.

Projektverbindung herstellen

Stellt die Verbindung mit dem der Projektmappe zugeordneten WinCC Projekt her.

Tabelle hinzufügen Es wird der Dialog "Tabelle hinzufügen" geöffnet. Über diesen Dialog ist es möglich, der Projektmappe ein neues Tabellenblatt hinzuzufügen.



WinCC-Projekt erstellen

Es wird der Wizard "Neues WinCC-Projekt" geöffnet. Über diesen Wizard ist es möglich, ein neues WinCC-Projekt zu erstellen. Die Projektmappe wird mit diesem WinCC-Projekt verbunden.

RT Sprache umschalten

Öffnet den Dialog "RT-Sprache wählen"

Objekte schreiben Abhängig von der Art des aktiven Tabellenblattes werden weitere Menüpunkte angezeigt. Es sind dies in erster Linie Menüpunkte zum Schreiben der Objekte, welche auf dem aktiven Tabellenblatt projektiert werden können.

Projektieren mehrerer Sprachen im Configuration ToolIm WinCC Configuration Tool können Sie wie in WinCC die WinCC-Oberflächensprache und die Runtime-Sprache umschalten:

● Wenn Sie die Oberflächensprache umschalten wollen, wählen Sie den Menüpunkt "Sprache umschalten" .

● Wenn Sie die Runtime-Sprache umschalten wollen, wählen Sie den Menüpunkt "RT Sprache umschalten". Der Menüpunkt ist nur verfügbar, wenn die Projektmappe mit einem WinCC-Projekt verbunden ist.

Zum Beispiel sind die Anwendertextblöcke und die Meldetexte von der Runtime-Sprache abhängig. Wenn Sie die Runtime-Sprache umschalten, werden die Texte in dieser Sprache dargestellt, und Sie können die Texte erweitern.



1.8.4.4 Kontextmenü

Einleitung Das ConfigurationTool fügt dem Zeilenkontextmenü von Excel zwei weitere Menüpunkte hinzu. Das Zeilenkontextmenü ist nur verfügbar, wenn ganze Zeilen eines Tabellenblattes selektiert sind.



WinCC - Selektion schreiben

Der Menüpunkt ist nur bedienbar, wenn eine Verbindung zum zugeordneten WinCC-Projekt besteht. Über den Menüpunkt "WinCC - Selektion schreiben" werden alle selektierten Objekte nach WinCC geschrieben. Nur über diesen Menüpunkt ist es möglich, einzelne Objekte nach WinCC zu schreiben.

WinCC - Selektion löschen

Über den Menüpunkt "WinCC - Selektion löschen" werden alle selektierten Objekte aus der Projektmappe und aus WinCC gelöscht. Nur über dieses Menü ist es möglich, einzelne Objekte aus WinCC zu löschen.

1.8.4.5 Statuszeile

Einleitung Im ConfigurationTool werden in der Statuszeile von Excel Informationen über WinCC angezeigt. Wenn in WinCC ein Projekt geöffnet ist, dann wird in der Statuszeile der Pfad und Projektname des aktuell in WinCC geöffneten WinCC-Projekts angezeigt.

1.8.5 Bedienung des ConfigurationTools

1.8.5.1 So bedienen Sie das ConfigurationTool

Einleitung Im Allgemeinen können Sie jede Funktionalität, die Excel bietet, uneingeschränkt nutzen. Eine Ausnahme stellen dabei jedoch die Sortierfunktion und die Löschfunktion dar. Diese werden vom ConfigurationTool selbst implementiert.

Das ConfigurationTool unterstützt Sie durch verschiedene Funktionen bei der Eingabe von Daten.



Dropdown-ListenfelderDropdown-Listenfelder werden durch Doppelklick auf die jeweilige Zelle geöffnet. Die Eingabe vieler Parameter erfolgt als Text. Erfolgt die Eingabe dieser Parameter über das Dropdown-Listenfeld, wird sichergestellt, dass ein gültiger Wert eingegeben wird.

Automatisches AusfüllenDurch das Automatische Ausfüllen, eine Standardfunktion von Excel, können viele Objekte auf einmal angelegt werden. Das ConfigurationTool kann Sie beim Automatischen Ausfüllen



von Objekten auf zwei verschiedene Arten unterstützen. Welche dieser beiden Arten verwendet werden soll, kann auf der Projekteigenschaftentabelle eingestellt werden.

● Automatisches Ausfüllen mit DefaultwertenDer Vorteil des Automatischen Ausfüllen mit Defaultwerten besteht darin, dass Sie die Parameter die automatisch vom Projektierungstool ausgefüllt werden, auf den entsprechenden Defaultwerttabellen einstellen können.Zum Beispiel haben Sie auf der Variablentabelle nur den Variablennamen sowie den Datentyp der Variablen einzustellen, die restlichen Parameter werden von der Defaultwerttabelle geladen. Bei sinnvoll gewählten Werten auf der Defaultwerttabelle kann dies zu einer erheblichen Arbeitsersparnis führen.

● Automatisches Ausfüllen ohne DefaultwerteDer Vorteil des Automatischen Ausfüllen ohne Defaultwerte besteht darin, dass die Parameter nicht automatisch vom Projektierungstool ausgefüllt werden. Stattdessen wird der Wert in der Zelle überprüft, und wird wenn er gültig ist nicht überschrieben. Ein Anwendungsfall für diese Option ist das Kopieren gesamter Objekte.

Hinweis

Weiter Informationen über das Automatische Ausfüllen finden Sie in der Microsoft Excel Hilfe.



Eindeutige NamenseingabeDas ConfigurationTool überprüft Objektnamen auf Eindeutigkeit. Werden bereits verwendete Namen erkannt, können automatisch eindeutige Namen generiert werden. Dem ursprünglichen Namen wird dabei eine fortlaufende Nummer beigefügt.

Sollen fortlaufend nummerierte Objektnamen generiert werden, sollte jedoch auf die Standardfunktionalität, die Excel für diesen Zweck bietet, zurückgegriffen werden (einfügen des ersten Namens, z.B. Variable_1, und herunterziehen).

EingabehinweiseDas ConfigurationTool überprüft jede Dateneingabe. Geben Sie ungültige Daten ein, werden diese automatisch korrigiert. Jede Änderung, die das ConfigurationTool durchführen muss, wird durch einen Eingabehinweis kommentiert. Dieser wird durch den Office Assistenten ausgegeben. Der Eingabehinweis muss von Ihnen nicht bestätigt werden, sondern wird automatisch abgeblendet, wenn Sie weiterarbeiten.

Hinweis

Ist der Office Assistent nicht installiert, ist es nicht möglich, die Eingabehinweise zu nutzen.

1.8.5.2 Anlegen einer neuen Projektmappe

So legen Sie eine neue Projektmappe an

Einleitung In einer Projektmappe werden die Projektierungsdaten eines WinCC-Projekts verwaltet. Sie enthält verschiedene Arten von Tabellenblättern, welche jeweils zur Projektierung eines bestimmten Typs von WinCC-Objekten dienen. Sie können eine neue Projektmappe entweder über die Symbolleiste oder das Dropdown-Menü anlegen.



Vorgehensweise1. Betätigen Sie die Schaltfläche in der Symbolleiste. Es wird der Wizard "Neue

Projektmappe" geöffnet.

2. Auf der ersten Seite des Wizards stehen die folgenden 3 Auswahlmöglichkeiten zur Verfügung:Keine VerbindungEs wird eine Projektmappe erstellt, der kein WinCC-Projekt zugeordnet ist.Verbindung mit neuem Projekt herstellenEs wird eine neue Projektmappe erstellt. Für diese wird ein neues WinCC-Projekt erzeugt, welches der Projektmappe zugeordnet wird.Verbindung mit bereits existierendem Projekt herstellenEs wird eine neue Projektmappe erstellt. Diese wird einem bereits bestehenden WinCC-Projekt zugeordnet. Die Daten des WinCC-Projekts werden ausgelesen.

3. Wählen Sie die entsprechende Option aus und drücken Sie die Schaltfläche "Fertigstellen". Bei den Optionen "Verbindung mit neuem Projekt herstellen" und "Verbindung mit bereits existierendem Projekt herstellen" drücken Sie die Schaltfläche "Weiter".

4. Die weitere Vorgehensweise finden Sie in den unten aufgeführten Kapiteln.



Siehe auchSo legen Sie eine Projektmappe mit Verbindung zu einem existierenden WinCC-Projekt an (Seite 132)

So legen Sie eine Projektmappe mit Verbindung zu einem neuen WinCC Projekt an (Seite 134)

So legen Sie eine Projektmappe ohne Verbindung an (Seite 131)

So legen Sie eine Projektmappe ohne Verbindung an

Einleitung Das ConfigurationTool bietet Ihnen die Möglichkeit eine Projektmappe zu erstellen die keinem WinCC-Projekt zugeordnet ist. In einer Projektmappe ohne Verbindung können Sie ohne Einschränkungen projektieren. Es ist jedoch nicht möglich Daten nach WinCC zu schreiben. Um die projektierten Daten nach WinCC schreiben zu können, müssen Sie ein neues WinCC-Projekt erstellen.





2. Wählen Sie die Option "Keine Verbindung" aus. Über die Schaltfläche "Fertigstellen" wird der Wizard abgeschlossen.

Siehe auchSo erstellen Sie ein neues WinCC-Projekt (Seite 137)

So legen Sie eine Projektmappe mit Verbindung zu einem existierenden WinCC-Projekt an

Einleitung Das ConfigurationTool bietet Ihnen die Möglichkeit, eine neue Projektmappe zu erstellen und dieser ein bereits existierendes WinCC-Projekt zuzuordnen. Die Daten des WinCC-Projekts werden dabei in die neue Projektmappe eingelesen.





2. Wählen Sie die Option "Verbindung mit bereits existierendem Projekt herstellen" aus. Über die Schaltfläche "Weiter" wird die zweite Seite des Wizards geöffnet.

3. Wählen Sie das gewünschte WinCC-Projekt aus. Über die Schaltfläche "Fertigstellen" wird der Wizard abgeschlossen.



Hinweis

Beim Auslesen von großen WinCC Projekten kann es vorkommen, dass Microsoft Excel einen OLE - Hinweisbox aufblendet. Diese Box wird vom Configuration Tool automatisch quittiert. Während die OLE - Hinweisbox angezeigt wird treten Performanceeinbußen auf.

So legen Sie eine Projektmappe mit Verbindung zu einem neuen WinCC Projekt an

Einleitung Das ConfigurationTool bietet Ihnen die Möglichkeit, eine neue Projektmappe zu erstellen und dieser ein neues WinCC-Projekt zuzuordnen. Die bereits vorhandenen Daten des Projekts werden ausgelesen.





2. Wählen Sie die Option "Verbindung mit einem neuen Projekt herstellen" aus. Über die Schaltfläche "Weiter" wird die zweite Seite des Wizards geöffnet.



3. Wählen Sie den Typ des neuen WinCC-Projekts aus. Über die Schaltfläche "Weiter" wird die dritte Seite des Wizards geöffnet.

4. Auf der dritten Seite des Wizards wird der Ablageort des neuen WinCC-Projekts festgelegt. Es ist der Name des neuen WinCC-Projekts anzugeben. Des Weiteren ist das Verzeichnis, in welchem das Projektverzeichnis angelegt werden soll, anzugeben. Über die Schaltfläche "Fertigstellen" wird der Wizard abgeschlossen.



So erstellen Sie ein neues WinCC-Projekt

Einleitung Das ConfigurationTool bietet Ihnen die Möglichkeit, für eine bestehende Projektmappe ein neues WinCC-Projekt anzulegen. Dieses WinCC-Projekt wird der Projektmappe zugeordnet.





2. Wählen Sie den Typ des neuen WinCC-Projekts aus. Über die Schaltfläche "Weiter" wird die zweite Seite des Wizards geöffnet.

3. Auf der zweiten Seite des Wizards wird der Ablageort des neuen WinCC-Projekts festgelegt. Sie müssen den Namen des neuen WinCC-Projekts angeben. Des Weiteren müssen Sie das Verzeichnis, in welchem das Projektverzeichnis angelegt werden soll, angeben. Über die Schaltfläche "Fertigstellen" wird der Wizard abgeschlossen.



1.8.5.3 Tabellenblätter

Tabellenblätter

Einleitung Bei der Erzeugung einer neuen Projektmappe wird von jedem benötigten Tabellentyp mindestens ein Exemplar erzeugt. Sie können jedoch auch selbst weitere Tabellen hinzufügen.

Aufbau eines TabellenblattesFür jedes zu projektierende Objekt steht in der Tabelle eine Zeile zur Verfügung. Die farbigen Zeilen sind Überschriften, wobei die grau eingefärbten Zellen die Parameterüberschriften sind.



Der Datenbereich sind alle Zellen unter den Parameterüberschriften. Außerhalb des Datenbereichs stehen Ihnen die Zellen frei zur Verfügung.

Anlegen eines neuen TabellenblattesDurch Drücken der entsprechenden Schaltfläche der Symbolleiste oder der Auswahl über das Dropdown-Menü öffnen Sie den Dialog "Tabelle hinzufügen". Sie können in diesem Dialog



den gewünschten Typ der Tabelle auswählen. Wenn Sie die Schaltfläche "Ok" drücken, wird die entsprechende Tabelle der Projektmappe hinzugefügt.



So bedienen Sie das Tabellenblatt "Projekteigenschaften"

Einleitung Auf dem Tabellenblatt Projekteigenschaften sind Informationen über das WinCC-Projekt enthalten. Des Weiteren können Sie Einstellungen, welche die gesamte Projektmappe betreffen, vornehmen.





WinCC-Projekt

Projektname Der Pfad und die Projektdatei des verbundenen WinCC-Projekts.Projekttyp Der Typ des Projekts.Verbindungsherstellung Hier können Sie zwischen "Manuell" und "Beim Öffnen" wählen.

Bei "Manuell" müssen Sie beim Öffnen der Projektmappe über die Symbolleiste oder das Dropdown-Menü selbst eine Verbindung zum zugehörigen WinCC-Projekt herstellen.Bei "Beim Öffnen" wird die Verbindung zum zugehörigen WinCC-Projekt automatisch beim Öffnen der Projektmappe hergestellt.

Verbindungsstatus Gibt Auskunft darüber, ob das zugehörige WinCC-Projekt geöffnet ist oder nicht. Daten können nur nach WinCC geschrieben werden, wenn eine Verbindung zum Projekt besteht.

Dateneingabe

Defaultwerte verwenden Sie können festlegen, ob Defaultwerte verwendet werden sollen oder nicht.Wenn ja, werden beim Projektieren die Defaultwerte von den Defaultwertetabellenblättern verwendet.Wenn nein, werden die Defaultwerte nicht verwendet. Das Verwenden der Defaultwerte bringt einen erheblichen Performancegewinn.

Add-In

Maximale Zeilenanzahl Hier können Sie festlegen, nach wie vielen Zeilen beim Auslesen der Daten ein neues Tabellenblatt angelegt werden soll.Die Begrenzung der Zeilenanzahl bringt Verbesserungen in der Performance, da Excel ab einer gewissen Zeilenanzahl unverhältnismäßig viel Zeit benötigt, um neue Daten anzulegen

Meldungen erzeugen

Bereits existierende Meldungen löschen

Hier können Sie festlegen, ob beim Erzeugen von Meldungen aus der Variablentabelle die für die selektierten Variablen bereits existierenden Meldungen gelöscht werden sollen oder nicht.

Dialog anzeigen Hier können Sie festlegen, ob Sie den Dialog zum Erzeugen von Meldungen aus der Variablentabelle verwenden wollen oder nicht.Wenn nicht, werden die Einstellungen vom Tabellenblatt "Defaultwerte Alarm Logging" verwendet.



Grenzwertüberwachung erzeugen

Bereits existierende Grenzwerte löschen

Hier können Sie festlegen, ob beim Erzeugen von Grenzwerten aus der Variablentabelle die für die selektierten Variablen bereits existierenden Grenzwerte gelöscht werden sollen oder nicht.

Dialog anzeigen Hier können Sie festlegen, ob Sie den Dialog zum Erzeugen von Grenzwerten aus der Variablentabelle verwenden wollen.Wenn nicht, dann werden die Einstellungen vom Tabellenblatt "Defaultwerte Alarm Logging" verwendet.

Archivvariablen erzeugen

Bereits existierende Archivvariablen löschen

Hier können Sie festlegen, ob beim Erzeugen von Archivvariablen aus der Variablentabelle die für die selektierten Variablen bereits existierenden Archivvariablen gelöscht werden sollen oder nicht.

Dialog anzeigen Hier können Sie festlegen, ob Sie den Dialog zum Erzeugen von Archivvariablen aus der Variablentabelle verwenden wollen.Wenn Sie den Dialog deaktivieren, wird der Dialog einmal geöffnet. Geben Sie im Dialog ein Prozesswertarchiv als Standardarchiv an. Aktivieren Sie die Option "Einstellungen beibehalten", damit der Dialog zukünftig nicht mehr geöffnet wird. Die Einstellungen vom Tabellenblatt "Defaultwerte Tag Logging" werden verwendet.

Alarm Logging

Bits auf Verwendung prüfen Hier können Sie festlegen, ob das ConfigurationTool die Variablen-Bit Kombination im Alarm Logging überprüfen soll.

Abfrage auf Änderung aller verwendeten Zustandstexte anzeigen

Hier können Sie festlegen, ob beim Ändern eines Zustandtextes an einer Meldeklasse eine Abfrage auf Änderung aller identischen Zustandstexte angezeigt werden soll oder nicht.

Abfrage auf Änderung aller verwendeten Meldetexte anzeigen

Hier können Sie festlegen, ob beim Ändern eines Meldetextes eine Abfrage auf Änderung aller identischen Meldetexte angezeigt werden soll oder nicht.

Löschen nicht verwendeter Texte Hier können Sie festlegen, ob beim Löschen von Objekten des Meldesystems nicht mehr verwendete Texte automatisch aus der Text Library gelöscht werden sollen oder nicht.

Löschen von Grenzwerten beim Löschen ihrer Einzelmeldung

Hier können Sie festlegen, ob Grenzwerte beim Löschen der eingestellten Einzelmeldung mitgelöscht werden sollen oder eine Defaultmeldenummer eingestellt werden soll.

Kommentare

Kommentare anzeigen Hier können Sie festlegen, ob die Kommentare auf dem Tabellenblatt Projekteigenschaften angezeigt werden sollen oder nicht.



Datenmanager

Datenmanager

Einleitung Auf den Tabellenblättern des Datenmanager können Sie Verbindungen, Variablen, Strukturvariablen und Strukturtypen projektieren. Des Weiteren können Sie auf dem Tabellenblatt "Defaultwerte Datenmanager" Defaultwerte für Variablen einstellen. Die Vorgehensweise zum Projektieren von Daten im Datenmanager finden Sie in den unten aufgeführten Kapiteln.

Siehe auchSo bedienen Sie das Tabellenblatt "Verbindungen/Gruppen" (Seite 149)

So bedienen Sie das Tabellenblatt "Strukturvariablen" (Seite 155)

So bedienen Sie das Tabellenblatt "Strukturtypen" (Seite 157)

So bedienen Sie das Tabellenblatt "Variablen" (Seite 152)

So bedienen Sie das Tabellenblatt "Defaultwerte Datenmanager" (Seite 146)

So bedienen Sie das Tabellenblatt "Defaultwerte Datenmanager"

Einleitung Das ConfigurationTool bietet Ihnen die Möglichkeit, die Parameter neu angelegter Objekte mit Defaultwerten vorzubelegen. Diese Defaultwerte können Sie auf dem Tabellenblatt "Defaultwerte Datenmanager" festlegen.

Die hier getroffenen Einstellungen werden auch für Strukturtypelemente verwendet.



VorgehensweiseEs ist für jeden für Variablen einstellbaren Datentyp eine Zeile vorhanden. In dieser Zeile können Sie die Einstellungen für diesen Datentyp vornehmen.

Defaultwerte deaktivierenAuf dem Tabellenblatt "Projekteigenschaften" kann die Verwendung der Defaultwerte deaktiviert werden. Ist die Verwendung der Defaultwerte deaktiviert, werden alle Parameter eines neu angelegten Objekts auf Gültigkeit überprüft und gegebenenfalls korrigiert (z.B. leere Zellen). Dies führt jedoch beim Anlegen der Objekte zu einer schlechteren Performance. Deshalb ist die Verwendung der Defaultwerte standardmäßig aktiviert.



Aufbau der TabelleIn der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Defaultwerte Datenmanager" für Variablen einzustellenden Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.

Spalte KurzbeschreibungDatentyp Alle verfügbaren Datentypen einer Variable. Diese Spalte ist

schreibgeschützt.Länge Die Länge der Variablen in WinCC in Byte. Diese ist bei einem Großteil

der Datentypen nicht veränderbar.

Formatanpassung

Die Formatanpassung der Variable. Diese ist nur bei externen Variablen einstellbar. Nicht alle Datentypen verfügen über eine Formatanpassung.

Verbindung

Die Verbindung der Variable.

Gruppe

Die Gruppe der Variable. Die Angabe dieses Parameters ist optional.

Adresse Die Adresse der Variable. Diese ist nur bei externen Variablen einstellbar. Der Aufbau der Adresse ist abhängig vom für die Verbindung eingestellten Kommunikationstreiber. Der Aufbau der Adresse ist im WinCC Explorer unter Variablen in der Spalte Parameter zu entnehmen. Die Adresse wird zur Zeit nicht auf Gültigkeit überprüft. Alle Eingaben werden als gültig angesehen.

Aktualisierung

Die Aktualisierung der Variable. Diese kann nur bei internen Variablen eingestellt werden. Es kann zwischen projektweit und rechnerlokal gewählt werden.

lineare Skalierung ja/nein

Gibt an, ob die lineare Skalierung verwendet werden soll. Die lineare Skalierung ist nur bei externen Variablen einstellbar. Nicht alle Datentypen verfügen über die Möglichkeit der linearen Skalierung.

lineare Skalierung Prozess von

Der Skalierungsbereich im Prozess (Quellskalierung).

lineare Skalierung Prozess bis Der Skalierungsbereich im Prozess (Quellskalierung).lineare Skalierung Variable von

Der Skalierungsbereich der Variable (Darstellungsskalierung).

lineare Skalierung Variable bis Der Skalierungsbereich der Variable (Darstellungsskalierung).Obergrenze Der obere Grenzwert der Variable.Untergrenze Der untere Grenzwert der Variable.Startwert Der Startwert der Variable.Ersatzwert Ersatzwert der Variable. Der Ersatzwert kann nur bei externen

Variablen eingestellt werden.

Ersatzwert verwenden bei Obergrenze

Bei einer Überschreitung der Obergrenze soll der Ersatzwert verwendet werden.



Spalte Kurzbeschreibung

Ersatzwert verwenden bei Untergrenze

Bei einer Unterschreitung der Untergrenze soll der Ersatzwert verwendet werden.

Ersatzwert verwenden als Startwert

Der Ersatzwert soll als Startwert verwendet werden.

Ersatzwert verwenden bei Fehlern

Der Ersatzwert soll bei Verbindungsfehlern verwendet werden.

Variablensynchronisation Interne Variablen werden auf den Partnerrechnern abgeglichen, sobald sich auf einem der redundanten Server eine der Variablen ändert.

Siehe auchSo bedienen Sie das Tabellenblatt "Projekteigenschaften" (Seite 142)

So bedienen Sie das Tabellenblatt "Verbindungen/Gruppen"

Einleitung Die Verbindungstabelle dient Ihnen zur Projektierung zwei verschiedener Arten von WinCC-Objekten. Es handelt sich dabei um die Verbindung sowie die den Verbindungen



untergeordneten Gruppen. Die logische Zuordnung zwischen Verbindung und Gruppe ergibt sich aus der Position des jeweiligen Objekts in der Tabelle.

Vorgehensweise

VerbindungenUm eine neue Verbindung anzulegen, müssen Sie dieser einen Namen geben. Damit wird die Verbindung bereits zu einem gültigen Objekt und könnte nach WinCC geschrieben werden. Die Parameter der Verbindung werden mit Defaultwerten belegt. Die Defaultwerte sind jedoch nicht einstellbar.

GruppenGruppen können Sie nur zu bereits existierenden Verbindungen hinzufügen. Um eine Gruppe zu projektieren, müssen Sie der Gruppe nur einen Namen geben.

SchreibenGruppen werden automatisch mit der zugehörigen Verbindung nach WinCC geschrieben. Um Gruppen schreiben zu können, müssen Sie die zugehörige Verbindung schreiben.

LöschenWenn Sie eine Verbindung löschen, werden alle untergeordneten Gruppen mitgelöscht. Des Weiteren werden alle Variablen dieser Verbindung mitgelöscht. Die Verbindung "Interne



Variablen" kann nicht gelöscht werden. Wenn Sie eine Gruppe löschen, werden alle Variablen dieser Gruppe mitgelöscht.

Hinweis

Die Daten werden unwideruflich aus der Projektmappe und aus WinCC gelöscht. Das Löschen von Daten kann nicht rückgängig gemacht werden.

Aufbau der TabelleIn der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Verbindungen/Gruppen" für Verbindungen einzustellenden Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.

Spalte KurzbeschreibungName Der Name der Verbindung. Dieser muss eindeutig sein.

Kommunikationstreiber

Der Kommunikationstreiber der Verbindung.

Kanalunit

Die Kanalunit der Verbindung.

Parameter Der Parameterstring der Verbindung. Der Aufbau des Parameterstrings ist abhängig vom eingestellten Kommunikationstreiber. Der Parameterstring wird zur Zeit nicht auf Gültigkeit überprüft. Alle Eingaben werden als gültig angesehen.

Fehlertext Eine Kurzbeschreibung eines beim Schreiben nach WinCC aufgetretenen Fehlers. Fehlerfreie Objekte haben den Fehlertext OK.

In der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Verbindungen/Gruppen" für Gruppen einzustellenden Parameter aufgelistet.

Spalte KurzbeschreibungName Der Name der Gruppe. Dieser muss eindeutig sein.Fehlertext Eine Kurzbeschreibung eines beim Schreiben nach WinCC aufgetretenen Fehlers.

Fehlerfreie Objekte haben den Fehlertext OK.



So bedienen Sie das Tabellenblatt "Variablen"

Einleitung Auf dem Tabellenblatt "Variablen" können Sie die benötigten Variablen projektieren. Beim Projektieren von Strukturvariablen werden deren "Strukturinstanzelemente" automatisch auf der Variablentabelle angelegt.

VorgehensweiseUm eine neue Variable anzulegen, müssen Sie dieser einen Name geben. Mit dem Namen alleine ist die Variable jedoch noch kein gültiges Objekt und Sie können die Variable somit auch nicht nach WinCC schreiben.

Solange Sie keinen Variablennamen eingegeben haben, können Sie die restlichen Parameter der Variable nicht editieren. Wenn Sie einen Variablennamen angegeben haben, kann nur der Datentyp editiert werden. Die Variable wird erst zu einem gültigen Objekt, wenn Sie einen Datentyp einstellen.

Wenn Sie das Ausfüllen von Defaultwerten aktiviert haben, werden die übrigen Parameter der Variable mit den auf der Defaultwertetabelle eingestellten Werten belegt.

SchreibenSobald die Variable ein gültiges Objekt ist, können Sie die Variable nach WinCC schreiben. Strukturinstanzelemente können Sie nicht von der Variablentabelle aus schreiben. Diese werden beim Schreiben der entsprechenden Strukturvariablen automatisch mitgeschrieben.



LöschenLöschen Sie eine Variable, werden alle für diese Variable projektierten Grenzwertüberwachungen mitgelöscht. Bei allen anderen Objekten werden nur die Verweise auf die Variable gelöscht.

Hinweis


SonderfunktionenDas ConfigurationTool bietet Ihnen die Möglichkeit, Einzelmeldungen, Grenzwertüberwachungen und Archivvariablen aus der Variablentabelle zu projektieren. Über das Zeilenkontextmenü der Variablentabelle erhalten Sie die verschiedenen Auswahlmöglichkeiten. Die Vorgehensweise zum Erzeugen von Objekten über das Zeilenkontextmenü der Variablentabelle finden Sie in den unten aufgeführten Kapiteln.

Aufbau der TabelleIn der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Variablen" für Variablen einzustellenden Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.

Spalte KurzbeschreibungName Der Name der Variable. Dieser muss eindeutig sein. Es darf auch keine

Strukturvariable mit diesem Namen existieren.

Datentyp

Alle verfügbaren Datentypen einer Variable.

Länge Die Länge der Variablen in WinCC in Byte. Diese ist bei einem Großteil der Datentypen nicht veränderbar.

Formatanpassung

Die Formatanpassung der Variable. Diese ist nur bei externen Variablen einstellbar. Nicht alle Datentypen verfügen über Formatanpassungen.

Verbindung

Die Verbindung der Variable.

Gruppe

Die Gruppe der Variable. Die Angabe dieses Parameters ist optional.

Adresse Die Adresse der Variable. Diese ist nur bei externen Variablen einstellbar. Der Aufbau der Adresse ist abhängig vom für die Verbindung eingestellten Kommunikationstreiber. Der Aufbau der Adresse ist im WinCC Explorer unter Variablen in der Spalte Parameter zu entnehmen. Die Adresse wird zur Zeit nicht auf Gültigkeit überprüft. Alle Eingaben werden als gültig angesehen.




Aktualisierung

Die Aktualisierung der Variable. Diese kann nur bei internen Variablen eingestellt werden. Es kann zwischen projektweit und rechnerlokal gewählt werden.





lineare Skalierung Prozess bis


lineare Skalierung Variable von


lineare Skalierung Variable bis


Obergrenze Der obere Grenzwert der Variable.Untergrenze Der untere Grenzwert der Variable.Startwert Der Startwert der Variable.Ersatzwert Ersatzwert der Variable. Der Ersatzwert kann nur bei externen

Variablen eingestellt werden.

Ersatzwert verwenden bei Obergrenze

Bei einer Überschreitung der Obergrenze soll der Ersatzwert verwendet werden.

Ersatzwert verwenden bei Untergrenze

Bei einer Unterschreitung der Untergrenze soll der Ersatzwert verwendet werden.

Ersatzwert verwenden als Startwert

Der Ersatzwert soll als Startwert verwendet werden.

Ersatzwert verwenden bei Fehlern

Der Ersatzwert soll bei Verbindungsfehlern verwendet werden.

Variablensynchronisation Interne Variablen werden auf den Partnerrechnern abgeglichen, sobald sich auf einem der redundanten Server eine der Variablen ändert.


Hinweis

Wenn externe Variablen im Variablenhaushalt von WinCC über den Mapper von STEP7 angelegt werden, darf auch über das WinCC Configuration Tool die Verbindungszugehörigkeit nicht geändert werden.



Siehe auchSo erzeugen Sie Archivvariablen aus der Variablentabelle (Seite 224)

So erzeugen Sie Grenzwertüberwachungen aus der Variablentabelle (Seite 233)

So erzeugen Sie Einzelmeldungen aus der Variablentabelle (Seite 228)

Adressstrings für die Simatic S7 ProtocolSuite (Seite 251)

So bedienen Sie das Tabellenblatt "Strukturvariablen"

Einleitung Auf dem Tabellenblatt "Strukturvariablen" können Sie die benötigten Strukturvariablen projektieren. Dazu müssen Sie jedoch zumindest einen Strukturtyp in der Projektmappe bereits projektiert haben.

VorgehensweiseUm eine neue Strukturvariable anzulegen, müssen Sie dieser einen Name geben. Mit dem Namen alleine ist die Strukturvariable jedoch noch kein gültiges Objekt und kann somit auch nicht nach WinCC geschrieben werden.

Solange Sie keinen Variablennamen eingegeben haben, können Sie die restlichen Parameter der Strukturvariablen nicht editieren. Wenn Sie einen Variablennamen angegeben haben, kann nur der Datentyp editiert werden. Die Strukturvariable wird erst zu einem gültigen Objekt, wenn Sie einen Datentyp einstellen.

Nach der Festlegung des Strukturtyps werden die für die Strukturvariable benötigten Strukturinstanzelemente automatisch auf einer Variablentabelle angelegt. Bei Änderungen an der Strukturvariablen werden deren Strukturinstanzelemente automatisch aktualisiert. Das gleiche gilt für Änderungen am Strukturtyp selbst.

Wenn neue Strukturelemente hinzugefügt oder Datentypen von Strukturelementen geändert werden, dann muss die Adresse aller Strukturvariablen dieses Typs erneut eingegeben werden.



StrukturinstanzelementeWenn Sie eine Strukturvariable anlegen, werden deren Strukturinstanzelemente automatisch auf einer Variablentabelle angelegt. Strukturinstanzelemente unterscheiden sich von normalen Variablen dadurch, dass der Großteil ihrer Parameter schreibgeschützt ist. Sie können lediglich die Adresse, die Aktualisierung sowie die Obergrenze, Untergrenze, Startwert und Ersatzwert einstellen.

Hinweis

Bei den folgenden SIMATIC-Kanälen werden die Adressen der Strukturinstanzelemente automatisch aus der Anfangsadresse der Strukturvariablen generiert:● SIMATIC S7 Protocol Suite● SIMATIC S5 Ethernet Layer 4● SIMATIC S5 PMC Ethernet● SIMATIC TI Ethernet Layer 4● SIMATIC S5 PMC Profibus● SIMATIC S5 Serial 3964R● SIMATIC S5 Programmers Port AS511

SchreibenVersuchen Sie, eine Strukturvariable, deren eingestellter Strukturtyp in WinCC noch nicht existiert oder dessen Parameter in WinCC noch nicht aktuell sind, nach WinCC zu schreiben, wird eine Abfrage aufgeblendet, ob der Strukturtyp ebenfalls geschrieben werden soll. Wenn Sie die Abfrage verneinen, werden die selektierten Strukturvariablen nicht nach WinCC geschrieben.

Die Strukturinstanzelemente werden automatisch mit nach WinCC geschrieben.

LöschenLöschen Sie eine Strukturvariable, werden alle dazugehörigen Strukturinstanzelemente ebenfalls gelöscht.

Hinweis




Aufbau der TabelleIn der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Strukturvariablen" einzustellenden Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.

Spalte KurzbeschreibungName Der Name der Strukturvariable. Dieser muss eindeutig sein. Es darf auch keine

Variable mit diesem Namen existieren.

Strukturtyp

Der Strukturtyp der Strukturvariable.

Verbindung

Die Verbindung der Strukturvariable.

Gruppe

Die Gruppe der Strukturvariable. Die Angabe dieses Parameters ist optional.

Adresse Die Adresse der Strukturvariable. Diese ist nur bei externen Strukturvariablen einstellbar. Der Aufbau der Adresse ist abhängig vom für die Verbindung eingestellten Kommunikationstreiber. Der Aufbau der Adresse ist im WinCC Explorer unter Variablen in der Spalte Parameter zu entnehmen. Die Adresse wird zur Zeit nicht auf Gültigkeit überprüft. Alle Eingaben werden als gültig angesehen.

Aktualisierung

Die Aktualisierung der Strukturvariable. Diese kann nur bei internen Strukturvariablen eingestellt werden. Es kann zwischen projektweit und rechnerlokal gewählt werden.


Siehe auchAdressstrings für die Simatic S7 ProtocolSuite (Seite 251)

So bedienen Sie das Tabellenblatt "Strukturtypen"

Einleitung Die Strukturtyptabelle dient Ihnen zur Projektierung zwei verschiedener Arten von WinCC-Objekten. Dem Strukturtyp selbst, sowie den diesem zugeordneten Strukturtypelementen. Die



logische Zuordnung zwischen Strukturtyp und Strukturtypelement ergibt sich aus der Position des jeweiligen Objekts in der Tabelle.

Vorgehensweise

StrukturtypenUm einen neuen Strukturtyp anzulegen, müssen Sie diesem einen Namen geben. Damit wird der Typ bereits zu einem gültigen Objekt und könnte nach WinCC geschrieben werden. Die weiteren Parameter des Strukturtyps sind optional.

Strukturtypen ändernWenn Strukturtypen geändert werden, mit denen schon eine oder mehrere Strukturvariablen angelegt wurden, dann muss im Tabellenblatt "Strukturvariablen" die Adresse erneut eingegeben werden.

StrukturtypelementeSie können Strukturtypelemente nur projektieren, wenn schon ein Strukturtyp existiert. Um ein neues Strukturtypelement anzulegen, müssen Sie diesem einen Namen geben. Mit dem Namen alleine ist das Strukturtypelement jedoch noch kein gültiges Objekt. Erst wenn Sie einen Datentyp angeben wird das Strukturtypelement zu einem gültigen Objekt.

Solange Sie keinen Strukturtypelementnamen eingegeben haben, können Sie die restlichen Parameter des Strukturtypelements nicht editieren. Wenn Sie einen Strukturtypelementnamen angegeben haben, kann nur der Datentyp editiert werden. Das Strukturtypelement wird erst zu einem gültigen Objekt, wenn Sie einen Datentyp einstellen.

Wenn das Ausfüllen von Defaultwerten aktiviert ist, werden die übrigen Parameter des Strukturtypelements mit den auf der Defaultwertetabelle für Variablen eingestellten Werten belegt.



SchreibenEs ist Ihnen nicht möglich, Strukturtypelemente einzeln nach WinCC zu schreiben. Sie müssen immer den gesamten Strukturtyp nach WinCC schreiben. Dabei ist es unerheblich, ob Sie den Strukturtyp mit all seinen Strukturtypelementen selektieren oder nur der Strukturtyp alleine. Es wird immer der gesamte Strukturtyp mit allen Elementen nach WinCC geschrieben.

LöschenLöschen Sie einen Strukturtyp, werden alle zugehörigen Strukturtypelemente, Strukturvariablen sowie Strukturinstanzelemente mitgelöscht. Löschen Sie ein Strukturtypelement, werden die zugehörigen Strukturinstanzelemente ebenfalls gelöscht. Das Löschen des Strukturinstanzelementes aus WinCC erfolgt jedoch erst beim nächsten Schreiben des Strukturtyps.

Hinweis


Aufbau der TabelleIn der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Strukturtypen/Strukturtypelemente" für Strukturtypen einzustellenden Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.

Spalte KurzbeschreibungName Der Name des Strukturtyps.

Kommunikationstreiber

Der Kommunikationstreiber der zur Formatierung zu verwendenden Kanalunit. Dieser Parameter ist optional.

Kanalunit

Die Kanalunit, deren Formatierungen verwendet werden sollen. Dieser Parameter kann nur eingestellt werden, wenn ein Kommunikationstreiber eingestellt ist.

In der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Strukturtypen/Strukturtypelemente" für Strukturtypelemente einzustellenden Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.

Spalte KurzbeschreibungName Der Name des Strukturtypelements. Dieser Name muss innerhalb eines

Strukturtyps eindeutig sein.

Datentyp

Der Datentyp der Variable.



Spalte KurzbeschreibungLänge Die Länge der Variable im Prozess in Byte. Beim Großteil der Datentypen ist

diese Länge abhängig von der Formatanpassung und kann nicht geändert werden.

Offset Der Offset der Adresse eines Strukturinstanzelements zur an der Strukturvariable eingestellten Adresse (Startadresse).

Offsetbit Das Offsetbit des Strukturtypelements der Startadresse der eingestellten Strukturvariable

Formatanpassung

Die Formatanpassung der Variable. Diese ist nur bei externen Strukturtypelementen einstellbar. Nicht alle Datentypen verfügen über eine Formatanpassung.

externe Variable

Gibt an, ob das Strukturtypelement extern oder intern sein soll.




Der Skalierungsbereich des Prozesses Quellskalierung).

lineare Skalierung Prozess bis

Der Skalierungsbereich des Prozesses (Quellskalierung).

lineare Skalierung Variable von


lineare Skalierung Variable bis



Alarm Logging

Alarm Logging

Einleitung Auf den Tabellenblättern des Alarm Logging können Sie Meldeblöcke, Meldeklassen, Gruppenmeldungen, Einzelmeldungen sowie Grenzwertüberwachungen projektieren. Des Weiteren können Sie auf dem Tabellenblatt "Defaultwerte Alarm Logging" Defaultwerte für Einzelmeldungen und Grenzwertüberwachungen einstellen. Die Vorgehensweise zum Projektieren von Daten im Alarm Logging finden Sie in den unten aufgeführten Kapiteln.



Siehe auchSo bedienen Sie das Tabellenblatt "Grenzwertüberwachungen" (Seite 177)

So bedienen Sie das Tabellenblatt "Einzelmeldungen" (Seite 174)

So bedienen Sie das Tabellenblatt "Gruppenmeldungen" (Seite 173)

So bedienen Sie das Tabellenblatt "Meldeklassen/Meldearten" (Seite 169)

So bedienen Sie das Tabellenblatt "Meldeblöcke" (Seite 167)

So bedienen Sie das Tabellenblatt "Defaultwerte Alarm Logging" (Seite 161)

So bedienen Sie das Tabellenblatt "Defaultwerte Alarm Logging"

Einleitung Das ConfigurationTool bietet Ihnen die Möglichkeit, die Parameter neu angelegter Objekte mit Defaultwerten vorzubelegen. Diese Defaultwerte können Sie auf dem Tabellenblatt "Defaultwerte Alarm Logging" festlegen.



VorgehensweiseIm Alarm Logging können Sie Defaultwerte für Einzelmeldungen, für den Dialog "Einzelmeldungen generieren", für Grenzwertüberwachungen und für den Dialog "Grenzwerte generieren" einstellen.





Defaultwerte deaktivierenAuf dem Tabellenblatt "Projekteigenschaften" kann die Verwendung der Defaultwerte deaktiviert werden. Ist die Verwendung der Defaultwerte deaktiviert, werden alle Parameter eines neu angelegten Objekts auf Gültigkeit überprüft und gegebenenfalls korrigiert (z.B. leere Zellen). Dies führt jedoch beim Anlegen der Objekte zu einer schlechteren Performance. Deshalb ist die Verwendung der Defaultwerte standardmäßig aktiviert.

Aufbau der Tabelle

EinzelmeldungenIn der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Defaultwerte Alarm Logging" für Einzelmeldungen einzustellende Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.

Spalte KurzbeschreibungNummer Dieser Parameter ist schreibgeschützt.

Klasse

Die Meldeklasse der Einzelmeldung.

Art

Die Meldeart der Einzelmeldung

Gruppe

Die Gruppenmeldung der Einzelmeldung. Dieser Parameter ist optional.

Priorität Die Priorität der Einzelmeldung.

Meldevariable

Die Meldevariable der Einzelmeldung. Es können nicht alle Datentypen als Meldevariable verwendet werden. Dieser Parameter ist optional.

Meldebit Das Meldebit der Einzelmeldung. Wenn eine Meldevariable eingestellt ist, dann muss ein Meldebit angegeben werden.

Zustandsvariable

Die Zustandsvariable der Einzelmeldung. Es können nicht alle Datentypen als Zustandsvariable verwendet werden. Dieser Parameter ist optional.

Zustandsbit Das Zustandsbit der Einzelmeldung. Wenn eine Zustandsvariable eingestellt ist, dann muss ein Zustandsbit angegeben werden.

Quittiervariable

Die Quittiervariable der Einzelmeldung. Es können nicht alle Datentypen als Quittiervariable verwendet werden. Dieser Parameter ist optional.

Quittierbit Das Quittierbit der Einzelmeldung. Wenn eine Quittiervariable eingestellt ist, dann muss ein Quittierbit angegeben werden.

AG Nummer Die AG Nummer der Einzelmeldung.CPU Nummer Die CPU Nummer der Einzelmeldung.Meldetext1 bis Meldetext10

Die Meldetexte der Einzelmeldung. Um einen Meldetext einzustellen, muss zuerst der entsprechende Meldeblock aktiviert werden.



Spalte KurzbeschreibungProzesswertvariable1 bis Prozesswertvariable10

Die Prozesswertvariablen der Einzelmeldung. Um eine Prozesswertvariable einzustellen, muss zuerst der entsprechende Prozesswertblock aktiviert werden.

Infotext Der Infotext der Einzelmeldung.

Ist einzelquittierpflichtig

Gibt an, ob die Einzelmeldung einzelquittierpflichtig ist oder nicht.

Steuert zentralen Melder an

Gibt an, ob die Einzelmeldung den zentralen Melder ansteuern soll oder nicht.

Wird archiviert

Gibt an, ob die Einzelmeldung archiviert werden soll oder nicht.

Wird bei fallender Flanke erzeugt

Gibt an, ob die Einzelmeldung bei fallender Flanke ausgelöst werden soll oder nicht.

Löst eine Aktion aus

Gibt an, ob die Standardfunktion GMsgFunction ausgelöst werden soll oder nicht.

Loop in Alarm Funktion Der Name der Funktion die von der Einzelmeldung ausgelöst werden soll.Loop in Alarm Parameter Der Übergabeparameter der Loop in Alarm Funktion.

NormierDll

Die NormierDll, welche eingehende Rohdatentelegramme an das WinCC Meldesystem anpasst.

Meldungen generierenIn der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Defaultwerte Alarm Logging" für den Dialog "Meldungen generieren" einzustellende Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.


Bit 0 bis Bit 31

Gibt an, ob für dieses Bit eine Meldung generiert werden soll, oder nicht.

Anzahl Rohdaten

Gibt an, wie viele Meldungen für eine Rohdatenvariable generiert werden sollen.



Grenzwertüberwachung/GrenzwertIn der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Defaultwerte Alarm Logging" für Grenzwertüberwachungen einzustellende Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.

Spalte KurzbeschreibungVariable Dieser Parameter ist schreibgeschützt. Eine Meldung für alle Grenzwerte

Die Einzelmeldung die bei allen Grenzwerten verwendet werden soll.

Verzögerungszeit Gibt an, wie lange der Grenzwert über bzw. unterschritten sein muss, bis die Einzelmeldung ausgelöst wird.

Einheit Verzögerungszeit

Die Einheit der Verzögerungszeit.

In der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Defaultwerte Alarm Logging" für Grenzwerte einzustellende Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.

Spalte KurzbeschreibungGrenzwert Dieser Parameter ist schreibgeschützt.Grenzwert indirekt aus Variable

Dieser Parameter ist schreibgeschützt.

Grenze

Gibt an, ob der Grenzwert eine Obergrenze oder eine Untergrenze sein soll.

Meldungsnummer Die Einzelmeldung, die ausgelöst werden soll. Ist bei der Grenzwertüberwachung der Parameter "Eine Meldung für alle Grenzwerte" gesetzt, kann hier keine Meldenummer mehr eingetragen werden.

Meldung bei Qualitycode ungleich "GOOD" unterdrücken

Gibt an, ob die Meldungen von Variablen, deren Qualitycode nicht dem Status "GOOD" entspricht, unterdrück werden sollen.

Hysterese

Gibt an, ob die Hysterese absolut oder prozentual sein soll.

Hysterese Wert Der Hysteresenwert. 0 bedeutet, dass keine Hysterese verwendet wird.

Hysterese Wirksam bei

Gibt an, wann die Hysterese wirksam sein soll.



Grenzwerte generierenIn der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Defaultwerte Alarm Logging" für den Dialog "Grenzwerte generieren" einzustellende Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.

Spalte KurzbeschreibungGrenzwert Der Grenzwert der Variable.

Grenzwert indirekt aus Variable

Variable, aus welcher der Grenzwert indirekt übernommen werden soll.

Grenze Gibt an, ob der Grenzwert eine Obergrenze oder eine Untergrenze sein soll.

So bedienen Sie das Tabellenblatt "Meldeblöcke"

Einleitung Auf dem Tabellenblatt "Meldeblöcke" können Sie Systemblöcke, Anwendertextblöcke und Prozesswertblöcke aktivieren bzw. deaktivieren.



VorgehensweiseUm einen Meldeblock zu aktivieren, müssen Sie in der Spalte "Verwenden" den Parameter auf "ja" stellen. Es sind nicht bei allen Meldeblöcken sämtliche Parameter einstellbar. Deaktivieren Sie einen Meldeblock, werden alle auf der Einzelmeldungstabelle für diesen Meldeblock gemachten Parametrierungen gelöscht.

Aktivieren Sie einen Anwendertextblock oder Prozesswertblock, wird auf der Einzelmeldungstabelle eine neue Spalte eingefügt. Als Überschrift wird der Name des Meldeblocks eingetragen.

Sie können keine weiteren Meldeblöcke hinzufügen.

SchreibenDa bereits alle verfügbaren Meldeblöcke vorhanden sind, können Sie die Meldeblöcke sofort nach WinCC schreiben.

LöschenSie können Meldeblöcke im ConfigurationTool nicht löschen, sondern nur deaktivieren.

Aufbau der TabelleIn der nachfolgenden Tabelle werden alle für Meldeblöcke einzustellende Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol

gekennzeichnet.


Verwenden

Gibt an, ob ein Meldeblock verwendet werden soll, oder nicht.

Name Der Name des Meldeblocks.Blocktyp Der Typ des Meldeblocks. Dieser Parameter dient nur zur Information und ist

schreibgeschützt.Länge Die Länge des Meldeblocks. Dieser Parameter kann nicht bei allen Meldeblöcken

eingestellt werden.

Blinken

Gibt an, ob die angezeigten Texte im Meldefenster blinken sollen oder nicht.

Ausrichtung

Gibt die Ausrichtung der angezeigten Texte im Meldefenster an.

Format1

Die Darstellung im Meldefenster. Das Format1 ist abhängig vom Meldeblock und ist nicht bei allen Meldeblöcken einstellbar.




Format2

Die Darstellung im Meldefenster. Das Format2 ist abhängig vom Meldeblock und ist nicht bei allen Meldeblöcken einstellbar.


So bedienen Sie das Tabellenblatt "Meldeklassen/Meldearten"

Einleitung Das Tabellenblatt "Meldeklassen/Meldearten" dient Ihnen zur Projektierung zwei verschiedener Arten von WinCC-Objekten. Der Meldeklassen sowie die den Meldeklassen untergeordneten Meldearten. Die logische Zuordnung zwischen Meldeklassen und Meldearten ergibt sich aus der Position des jeweiligen Objekts in der Tabelle.



Vorgehensweise

MeldeklassenUm eine neue Meldeklasse anzulegen, müssen Sie dieser einen Namen geben. Die übrigen Parameter werden mit Defaultwerten belegt. Mit der Eingabe eines Namens wird die Meldeklasse bereits zu einem gültigen Objekt und Sie können die Meldeklasse nach WinCC schreiben. Der Name der Meldeklasse muss eindeutig sein und darf auch nicht gleich dem Namen einer Meldeart oder Gruppenmeldung sein.

Sie können maximal 16 benutzerdefinierte Meldeklassen mit jeweils 16 Meldarten anlegen. Des Weiteren sind 2 Systemmeldeklassen mit jeweils 2 Systemmeldearten vorhanden, welche nur eingeschränkt parametrierbar sind.

MeldeartenWenn Sie eine neue Meldart anlegen wollen, muss bereits eine Meldeklasse vorhanden sein. Sie müssen der neuen Meldeart einen Namen geben. Die übrigen Parameter werden mit Defaultwerten belegt. Die Farbgebungen der Meldearten müssen Sie über die Excel Standardfunktion zur Zellenformatierung einstellen.

Hinweis

Die Parameter der, in WinCC automatisch zu jeder Meldeklasse und Meldeart generierten, Gruppenmeldungen sind, anders als in WinCC, bereits auf diesem Tabellenblatt einzustellen.

SchreibenMeldearten können Sie nicht einzeln nach WinCC schreiben. Sie müssen die übergeordnete Meldeklasse nach WinCC schreiben, um Meldearten nach WinCC zu schreiben. Die untergeordneten Meldearten werden automatisch mitgeschrieben.

LöschenLöschen Sie eine Meldeklasse, werden alle zugehörigen Meldearten mitgelöscht. Die Systemmeldeklassen können Sie nicht löschen. Meldearten können Sie einzeln aus der Tabelle löschen. Um die Meldearten aus WinCC zu löschen, müssen Sie jedoch die zugehörige Meldeklasse nach WinCC schreiben.

Die zu einer Meldeklasse oder Meldeart gehörigen Einzelmeldungen werden beim Löschen ebenfalls gelöscht.

Hinweis




Aufbau der TabelleIn der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Meldeklassen/Meldearten" für Meldeklassen einzustellenden Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.

Spalte KurzbeschreibungName Der Name der Meldeklasse. Dieser muss eindeutig sein.

Quittierung gekommen

Gibt an, ob kommende Meldungen quittiert werden müssen.

Quittierung gegangen

Gibt an, ob gehende Meldungen quittiert werden müssen.

Blinken

Gibt an, ob anstehende Meldungen blinken sollen.

Blinken nur Erstwert

Gibt an, ob nur die erste anstehende Meldung dieser Meldeklasse blinkten soll.

ohne Zustand "gegangen"

Gibt an, ob im Archiv nur der Zustand Meldung gekommen archiviert wird.

Quittierung zentraler Melder

Gibt an, ob der zentrale Melder über eine separate Quittiertaste oder über Einzelquittierung quittiert werden soll.

Variable zentraler Melder

Die Variable, über die der zentrale Melder angesteuert wird.

Zustandstext gekommen Der Text für den Zustand gekommen. Der Text darf maximal 63 Zeichen lang sein.

Zustandstext gegangen Der Text für den Zustand gegangen. Der Text darf maximal 63 Zeichen lang sein.

Zustandstext quittiert Der Text für den Zustand quittiert. Der Text darf maximal 63 Zeichen lang sein.

Zustandstext gekommen und gegangen

Der Text für den Zustand gekommen und gegangen. Der Text darf maximal 63 Zeichen lang sein.

Gruppenmeldung Zustandsvariable

Die Zustandsvariable der Gruppenmeldung der Meldeklasse. Dieser Parameter ist optional.

Gruppenmeldung Zustandsbit

Das Zustandsbit der Gruppenmeldung der Meldeklasse. Es werden immer zwei Bits der Variable verwendet. Ist eine Zustandsvariable eingetragen, dann muss auch ein Zustandsbit eingetragen werden.

Gruppenmeldung Sperrvariable

Die Sperrvariable der Gruppenmeldung der Meldeklasse. Dieser Parameter ist optional.



Spalte KurzbeschreibungGruppenmeldung Sperrbit Das Sperrbit der Gruppenmeldung der Meldeklasse. Ist eine Sperrvariable

eingetragen, dann muss auch ein Sperrbit eingetragen werden.

Gruppenmeldung Quittiervariable

Die Quittiervariable der Gruppenmeldung der Meldeklasse. Dieser Parameter ist optional.

Gruppenmeldung Quittierbit

Das Quittierbit der Gruppenmeldung der Meldeklasse. Ist eine Quittiervariable eingetragen, dann muss auch ein Quittierbit eingetragen werden.


In der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Meldeklassen/Meldearten" für Meldearten einzustellenden Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.

Spalte KurzbeschreibungName Der Name der Meldeart. Dieser muss eindeutig sein. Farbgebung Meldung gekommen

Die Textfarbe und die Hintergrundfarbe der Meldung beim Zustand Meldung gekommen.

Farbgebung Meldung gegangen

Die Textfarbe und die Hintergrundfarbe der Meldung beim Zustand Meldung gegangen.

Farbgebung Meldung quittiert

Die Textfarbe und die Hintergrundfarbe der Meldung beim Zustand Meldung quittiert.

Gruppenmeldung Zustandsvariable

Die Zustandsvariable der Gruppenmeldung der Meldeart. Dieser Parameter ist optional.

Gruppenmeldung Zustandsbit

Das Zustandsbit der Gruppenmeldung der Meldeart. Es werden immer zwei Bits der Variable verwendet. Ist eine Zustandsvariable eingetragen, dann muss auch ein Zustandsbit eingetragen werden.

Gruppenmeldung Sperrvariable

Die Sperrvariable der Gruppenmeldung der Meldeart. Dieser Parameter ist optional.

Gruppenmeldung Sperrbit Das Sperrbit der Gruppenmeldung der Meldeart. Ist eine Sperrvariable eingetragen, dann muss auch ein Sperrbit eingetragen werden.

Gruppenmeldung Quittiervariable

Die Quittiervariable der Gruppenmeldung der Meldeart. Dieser Parameter ist optional.

Gruppenmeldung Quittierbit

Das Quittierbit der Gruppenmeldung der Meldeart. Ist eine Quittiervariable eingetragen, dann muss auch ein Quittierbit eingetragen werden.




So bedienen Sie das Tabellenblatt "Gruppenmeldungen"

Einleitung Auf dem Tabellenblatt "Gruppenmeldungen" können Sie Gruppenmeldungen aller sechs möglichen Ebenen projektieren.

VorgehensweiseUm eine neue Gruppenmeldung anzulegen, müssen Sie dieser einen Namen geben. Mit der Eingabe eines Namens wird die Gruppenmeldung bereits zu einem gültigen Objekt und Sie können die Gruppenmeldung nach WinCC schreiben. Der Name der Gruppenmeldung muss eindeutig sein.

Gruppenmeldungen sind hierarchisch aufgebaut. Das bedeutet, dass Sie zuerst Gruppenmeldungen erster Ebene projektieren müssen, bevor Sie eine Gruppenmeldung zweiter Ebene projektieren können. Um eine Gruppenmeldung dritter Ebene projektieren zu können, muss zuerst eine Gruppenmeldung zweiter Ebene projektiert werden usw.

SchreibenSie können nur Gruppenmeldungen erster Ebene nach WinCC schreiben. Alle existierenden Untergruppen werden automatisch mit nach WinCC geschrieben.

LöschenSie können Gruppenmeldungen aller Ebenen löschen. Alle existierenden Untergruppen werden automatisch gelöscht.



Einzelmeldungen, bei denen eine gelöschte Gruppenmeldung eingetragen war, werden nicht gelöscht. Es werden nur die Verweise auf die Gruppenmeldung gelöscht.

Hinweis


Aufbau der TabelleIn der nachfolgenden Tabelle werden alle für Gruppenmeldungen einzustellende Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol

gekennzeichnet.

Spalte KurzbeschreibungName Ebene 1 bis Name Ebene 6

Der Name der Gruppenmeldung.

Zustandsvariable

Die Zustandsvariable der Gruppenmeldung. Dieser Parameter ist optional.

Zustandsbit Das Zustandsbit der Gruppenmeldung. Es werden immer zwei Bits der Variable verwendet. Ist eine Zustandsvariable eingetragen, dann muss auch ein Zustandsbit eingetragen werden.

Sperrvariable

Die Sperrvariable der Gruppenmeldung. Dieser Parameter ist optional.

Sperrbit Das Sperrbit der Gruppenmeldung. Ist eine Sperrvariable eingetragen, dann muss auch ein Sperrbit eingetragen werden.

Quittiervariable

Die Quittiervariable der Gruppenmeldung. Dieser Parameter ist optional.

Quittierbit Das Quittierbit der Gruppenmeldung. Ist eine Quittiervariable eingetragen, dann muss auch ein Quittierbit eingetragen werden.

Ausblendvariable Die Ausblendvariable einer anwenderdefinierten Gruppenmeldung wird für das automatische Ausblenden von Einzelmeldungen genutzt, die zu dieser Gruppenmeldung gehören.


So bedienen Sie das Tabellenblatt "Einzelmeldungen"

Einleitung Auf dem Tabellenblatt "Einzelmeldungen" können Sie die benötigten Einzelmeldungen projektieren. Die Anzahl der einzustellenden Parameter variiert, je nachdem wie viele



Meldeblöcke Sie aktiviert bzw. deaktiviert haben. Einzelmeldungen können Sie auch von der Variablentabelle aus generieren.

VorgehensweiseUm eine Einzelmeldung anzulegen, müssen Sie dieser eine Nummer geben. Wenn Sie das Ausfüllen von Defaultwerten aktiviert haben, werden die übrigen Parameter der Einzelmeldung mit den auf der Defaultwertetabelle eingestellten Werten belegt. Ansonsten werden die übrigen Parameter mit vordefinierten Werten belegt.

Mit der Eingabe einer Nummer wird die Einzelmeldung zu einem gültigen Objekt und kann nach WinCC geschrieben werden.

Sie können Einzelmeldungen auch von der Variablentabelle aus generieren. Die Vorgehensweise dazu finden Sie im unten aufgeführten Kapitel.

SchreibenSobald die Einzelmeldung ein gültiges Objekt ist, kann sie nach WinCC geschrieben werden. Die projektierten Meldetexte werden ebenfalls nach WinCC geschrieben. Des Weiteren ist darauf zu achten, dass auf der Einzelmeldungstabelle verwendete Variablen bereits nach WinCC geschrieben sein müssen.

LöschenLöschen Sie eine Einzelmeldung, werden gegebenenfalls alle nicht mehr benötigten Meldetexte mitgelöscht. Dies hängt von Ihren Einstellungen in der Projekteigenschaftentabelle



ab. Grenzwerte werden ebenfalls gemäß der Einstellung auf der Projekteigenschaftentabelle behandelt (löschen oder Defaultmeldenummer einstellen).

Hinweis


Aufbau der TabelleIn der nachfolgenden Tabelle werden alle für Einzelmeldungen einzustellende Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol

gekennzeichnet.

Spalte KurzbeschreibungNummer Die Nummer der Einzelmeldung

Klasse

Die Meldeklasse der Einzelmeldung.

Art

Die Meldeart der Einzelmeldung

Gruppe

Die Gruppenmeldung der Einzelmeldung. Dieser Parameter ist optional.

Priorität Die Priorität der Einzelmeldung.

Meldevariable

Die Meldevariable der Einzelmeldung. Es können nicht alle Datentypen als Meldevariable verwendet werden. Dieser Parameter ist optional.

Meldebit Das Meldebit der Einzelmeldung. Wenn eine Meldevariable eingestellt ist, dann muss ein Meldebit angegeben werden.

Zustandsvariable

Die Zustandsvariable der Einzelmeldung. Es können nicht alle Datentypen als Zustandsvariable verwendet werden. Dieser Parameter ist optional.

Zustandsbit Das Zustandsbit der Einzelmeldung. Wenn eine Zustandsvariable eingestellt ist, dann muss ein Zustandsbit angegeben werden.

Quittiervariable

Die Quittiervariable der Einzelmeldung. Es können nicht alle Datentypen als Quittiervariable verwendet werden. Dieser Parameter ist optional.

Quittierbit Das Quittierbit der Einzelmeldung. Wenn eine Quittiervariable eingestellt ist, dann muss ein Quittierbit angegeben werden.

AG Nummer Die AG Nummer der Einzelmeldung.CPU Nummer Die CPU Nummer der Einzelmeldung.Meldetext1 bis Meldetext10

Die Meldetexte der Einzelmeldung. Um einen Meldetext einzustellen, muss zuerst der entsprechende Meldeblock aktiviert werden.

Prozesswertvariable1 bis Prozesswertvariable10

Die Prozesswertvariablen der Einzelmeldung. Um eine Prozesswertvariable einzustellen, muss zuerst der entsprechende Prozesswertblock aktiviert werden.



Spalte KurzbeschreibungInfotext Der Infotext der Einzelmeldung.

Ist einzelquittierpflichtig

Gibt an, ob die Einzelmeldung einzelquittierpflichtig ist oder nicht.

Steuert zentralen Melder an

Gibt an, ob die Einzelmeldung den zentralen Melder ansteuern soll oder nicht.

Wird archiviert

Gibt an, ob die Einzelmeldung archiviert werden soll oder nicht.

Wird bei fallender Flanke erzeugt

Gibt an, ob die Einzelmeldung bei fallender Flanke ausgelöst werden soll oder nicht.

Löst eine Aktion aus

Gibt an, ob die Standardfunktion GMsgFunction ausgelöst werden soll oder nicht.

Loop in Alarm Funktion Der Name der Funktion, die von der Einzelmeldung ausgelöst werden soll.Loop in Alarm Parameter Der Übergabeparameter an die Loop in Alarm Funktion.

NormierDll

Die NormierDll, welche eingehende Rohdatentelegramme an das WinCC Meldesystem anpasst.

Ausblendmaske Sie legen über die Ausblendmaske die Anlagenzustände für das Ausblenden der Einzelmeldung fest.


Siehe auchSo erzeugen Sie Einzelmeldungen aus der Variablentabelle (Seite 228)

So bedienen Sie das Tabellenblatt "Grenzwertüberwachungen"

Einleitung Das Tabellenblatt "Grenzwertüberwachungen" dient Ihnen zur Projektierung zwei verschiedener Arten von WinCC-Objekten. Der Grenzwertüberwachung sowie die den Grenzwertüberwachungen untergeordneten Grenzwerte. Die logische Zuordnung zwischen



Grenzwertüberwachung und Grenzwert ergibt sich aus der Position des jeweiligen Objekts in der Tabelle.

Vorgehensweise

GrenzwertüberwachungenUm eine Grenzwertüberwachung anzulegen, müssen Sie eine Variable einstellen. Durch das Einstellen einer Variablen wird die Grenzwertüberwachung bereits zu einem gültigen Objekt und Sie können die Grenzwertüberwachung nach WinCC schreiben. Die Parameter der Grenzwertüberwachung werden mit Defaultwerten belegt. Die Defaultwerte können Sie auf dem Tabellenblatt "Defaultwerte Alarm Logging" einstellen.

GrenzwerteGrenzwerte können Sie nur zu bereits existierenden Grenzwertüberwachungen hinzufügen. Um einen Grenzwert anzulegen ist entweder ein Grenzwert oder eine Variable, aus welcher der Grenzwert indirekt übernommen werden kann, einzutragen. Damit wird der Grenzwert bereits zu einem gültigen Objekt und Sie können den Grenzwert nach WinCC schreiben. Die Parameter des Grenzwerts werden mit Defaultwerten belegt. Die Defaultwerte können Sie auf dem Tabellenblatt "Defaultwerte Alarm Logging" einstellen.



SchreibenGrenzwerte werden automatisch mit der übergeordneten Grenzwertüberwachung geschrieben. Sie können Grenzwerte nicht einzeln nach WinCC schreiben.

Hinweis

In WinCC müssen Sie im Editor Alarm Logging die Grenzwertüberwachungen über "Extras - Erweiterungen" aktivieren.

LöschenLöschen Sie eine Grenzwertüberwachung, werden alle ihr untergeordneten Grenzwerte ebenfalls gelöscht. Grenzwerte können Sie auch einzeln löschen.

Hinweis


Über das Kontextmenü der Variablentabelle können Sie Grenzwertüberwachungen samt Grenzwerte generieren. Die weitere Vorgehensweise finden Sie in dem unten aufgeführten Kapitel.

Über das Kontextmenü des Tabellenblattes "Grenzwertüberwachungen/Grenzwert" können Sie Grenzwerte zu bestehenden Grenzwertüberwachungen generieren. Dazu sind die Grenzwertüberwachungen, zu denen Grenzwerte hinzugefügt werden sollen, zu selektieren. Im Kontextmenü des Tabellenblattes müssen Sie den Punkt "WinCC - Grenzwerte erzeugen" wählen.



Es wird der Dialog "Grenzwertüberwachen" aufgeblendet. Die weitere Vorgehensweise finden Sie im unten aufgeführten Kapitel ab Punkt drei.



Aufbau der TabelleIn der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Grenzwertüberwachungen/Grenzwert" für Grenzwertüberwachungen einzustellende Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.


Variable

Die Variable, welche überwacht wird.

Eine Meldung für alle Grenzwerte

Eine Einzelmeldung, welche bei allen Grenzwerten verwendet werden soll. Ist eine Meldenummer eingetragen, kann bei den einzelnen Grenzwerten keine andere Einzelmeldung mehr eingetragen werden.

Verzögerungszeit Gibt an, wie lange der Grenzwert über bzw. unterschritten sein muss, bis die Einzelmeldung ausgelöst wird. Ein Wert von 0 bedeutet keine Verzögerungszeit. Die gesamte Verzögerungszeit darf maximal 24 Stunden betragen.

Einheit Verzögerungszeit

Die Einheit der Verzögerungszeit.


In der nachfolgenden Tabelle werden alle auf dem Tabellenblatt "Grenzwertüberwachungen/Grenzwert" für Grenzwerte einzustellende Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.

Spalte KurzbeschreibungGrenzwert Der Grenzwert der Variable. Kann nur eingestellt werden, wenn der

Grenzwert nicht bereits indirekt aus einer Variable übernommen werden soll.

Grenzwert indirekt aus Variable

Der Grenzwert der grenzwertüberwachten Variable soll indirekt aus einer anderen Variable übernommen werden.

Grenze

Gibt an, ob der Grenzwert eine Obergrenze oder eine Untergrenze sein soll.

Meldungsnummer Die Einzelmeldung, die ausgelöst werden soll.

Meldung bei Qualitycode ungleich "GOOD" unterdrücken

Gibt an, ob die Meldungen von Variablen, deren Qualitycode nicht dem Status "GOOD" entspricht, unterdrück werden sollen.

Hysterese






Hysterese Wirksam bei

Gibt an, wann die Hysterese wirksam sein soll.


Siehe auchSo erzeugen Sie Grenzwertüberwachungen aus der Variablentabelle (Seite 233)

Tag Logging

Tag Logging

Einleitung Auf den Tabellenblättern des Tag Logging können Sie Zeiten, Prozesswertarchive, und Verdichtungsarchive projektieren. Des Weiteren können Sie auf dem Tabellenblatt "Defaultwerte Tag Logging" Defaultwerte für Prozesswertarchive und Verdichtungsarchive einstellen. Die Vorgehensweise zum Projektieren von Daten im Tag Logging finden Sie in den unten aufgeführten Kapiteln.

Siehe auchSo bedienen Sie das Tabellenblatt "Verdichtungsarchive" (Seite 193)

So bedienen Sie das Tabellenblatt "Prozesswertarchive" (Seite 189)

So bedienen Sie das Tabellenblatt "Zeiten" (Seite 187)

So bedienen Sie das Tabellenblatt "Defaultwerte Tag Logging" (Seite 182)

So bedienen Sie das Tabellenblatt "Defaultwerte Tag Logging"

Einleitung Das ConfigurationTool bietet Ihnen die Möglichkeit, die Parameter neu angelegter Objekte mit Defaultwerten vorzubelegen. Diese Defaultwerte können Sie auf dem Tabellenblatt "Defaultwerte Tag Logging" festlegen.



VorgehensweiseIm Tag Logging sind Defaultwerte für Prozesswertarchive, für Prozesswertarchivvariablen, für Verdichtungsarchive und für Verdichtungsarchivvariablen einstellbar.

Defaultwerte deaktivierenAuf dem Tabellenblatt "Projekteigenschaften" können Sie die Verwendung der Defaultwerte deaktivieren. Ist die Verwendung der Defaultwerte deaktiviert, werden alle Parameter eines neu angelegten Objekts auf Gültigkeit überprüft und gegebenenfalls korrigiert (z.B. leere Zellen). Dies führt jedoch beim Anlegen der Objekte zu einer schlechteren Performance. Deshalb ist die Verwendung der Defaultwerte standardmäßig aktiviert.



Aufbau der TabelleIn den nachfolgenden Tabellen werden alle auf dem Tabellenblatt einzustellende Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol

gekennzeichnet.

Prozesswertarchive

Spalte KurzbeschreibungArchivname Dieser Parameter ist schreibgeschützt.

Archivtyp


Kommentar Ein beliebiger Kommentar.

Archivierung bei Systemstart

Gibt an, ob die Archivierung bei Systemstart beginnen soll, oder nicht.

Aktion Starten/Freigeben Die Aktion die beim Starten oder Freigeben der Archivierung aufgerufen wird.

Größe Die Größe des Archivs in Datensätzen.

Speicherort

Der Parameter ist nur bei Umlaufarchiven einstellbar. Gibt an, ob das Archiv im Hauptspeicher oder auf der Festplatte gespeichert werden soll.

Prozesswertarchivvariablen

Spalte KurzbeschreibungVariable Dieser Parameter ist schreibgeschützt.Archivvariable Name Dieser Parameter ist schreibgeschützt.Archivvariable Typ Dieser Parameter ist schreibgeschützt.Kommentar Ein beliebiger Kommentar.



Variablenversorgung

Gibt an, ob die Daten der Variable automatisch oder von Hand übernommen werden sollen.

Erfassungsart

Die Art der Erfassung der Daten.

Erfassungszyklus

Der Zyklus der zur Erfassung der Daten verwendet werden soll.

Archivierungszyklus

Die Zeitbasis des Zyklus der zur Archivierung und zur Anzeige der Daten verwendet werden soll. Der Archivierungszyklus ergibt sich aus dem Produkt Zeitbasis und des Archivierungszyklus Faktor. Dieser muss ein ganzzahliges Vielfaches vom Erfassungszyklus sein.



Spalte KurzbeschreibungArchivierungszyklus Faktor Der Archivierungszyklus Faktor. Der

Archivierungszyklus ergibt sich aus dem Produkt Zeitbasis und des Archivierungszyklus Faktor. Dieser muss ein ganzzahliges Vielfaches vom Erfassungszyklus sein.

Zusätzlich in Variable schreiben Die Variable in die der letzte archivierte Wert übernommen werden soll.

Bearbeitung

Die Bearbeitung der erfassten Daten. Bei zyklisch selektiver und zyklisch kontinuierlicher Archivierung stehen alle Auswahlmöglichkeiten zur Verfügung. Bei azyklischer Archivierung und der Archivierung bei Änderung kann nur der Momentanwert verwendet werden.

Aktion zur Bearbeitung Die Aktion mit der die Daten bearbeitet werden sollen. Dieser Parameter ist nur einstellbar, wenn die Bearbeitung auf Aktion gestellt wurde.

Einheit Die Einheit des eingetragenen Zeitwertes.Langzeitrelevant Gibt an, ob die Archivvariable auf dem zentralen

Archivserver (WinCC CAS) ins Archiv geschrieben wird.

Archivierung bei Änderung

Gibt an, ob die Variable nur archiviert werden soll wenn sie sich geändert hat, oder nicht.

Hysterese



Archivierung bei

Der Trigger bei binären Prozesswertarchivvariablen. Bei analogen und prozessgesteuerten Variablen ist dieser Parameter schreibgeschützt.

Speichern bei Störung

Gibt an, ob bei einer Störung der letzte Wert oder der Ersatzwert gespeichert werden soll.

Anzahl Werte Vorlauf Die Anzahl der Werte die vor dem Archivierungszeitpunkt mitberücksichtigt werden sollen. Der Parameter ist nur bei zyklisch selektiver Archivierung einstellbar.

Anzahl Werte Nachlauf Die Anzahl der Werte die nach dem Archivierungszeitpunkt mitberücksichtigt werden sollen. Der Parameter ist nur bei zyklisch selektiver Archivierung einstellbar.

Darstellungsbegrenzung Untere Grenze Die untere Grenze des Wertebereichs der Variable. 0 bedeutet keine Begrenzung.

Darstellungsbegrenzung Obere Grenze Die obere Grenze des Wertebereichs der Variable. 0 bedeutet keine Begrenzung.

Start Ereignis Der Funktionsname der Funktion, die eine Archivierung auslöst.

Start Variable Binäre Variable.



Spalte KurzbeschreibungStop Ereignis Der Funktionsname der Funktion, die eine

Archivierung anhält.Stop Variable Binäre Variable.Langzeitrelevant Hier kann festgelegt werden, ob die Archivvariable

auf dem zentralen Archivserver (WinCC CAS) ins Archiv geschrieben wird.

Archivieren nach Segmentwechsel Hier kann festgelegt werden, ob bei einem Segmentwechsel die azyklisch archivierten Archivvariablen archiviert werden.

Normier Dll

Das zur Variable gehörende Anpassungsprogramm. Es ist abhängig vom Hersteller der AS.

Verdichtungsarchive

Spalte KurzbeschreibungArchivname Dieser Parameter ist schreibgeschützt.Kommentar Ein beliebiger Kommentar.




Bearbeitungsmethode

Die Methode mit der das Quellarchiv oder die Verdichtungsarchivvariable bearbeitet wird.

Verdichtungszeitraum

Der Zeitraum der im eingerichteten Archiv verdichtet wird. Der Verdichtungszeitraum muss mindestens eine Minute sein.

Verdichtungsarchivvariablen

Spalte KurzbeschreibungQuellarchiv Dieser Parameter ist schreibgeschützt.Quellvariable Dieser Parameter ist schreibgeschützt.Archivvariable Name Dieser Parameter ist schreibgeschützt.Kommentar Ein beliebiger Kommentar.



Bearbeitung

Die Bearbeitungsmethode der im Archivierungszyklus erfassten Werte.

Einheit Die Einheit der zu archivierenden Variable.Langzeitrelevant Hier kann festgelegt werden, ob die Archivvariable




So bedienen Sie das Tabellenblatt "Zeiten"

Einleitung Auf dem Tabellenblatt "Zeiten" können Sie die bei den Archiven benötigten Zeitzyklen projektieren. Beim Anlegen einer neuen Projektmappe oder eines neuen WinCC-Projekts sind immer fünf Zeiten vorhanden. Diese können Sie ändern und auch löschen.

VorgehensweiseUm eine neue Zeit anzulegen müssen Sie dieser einen Namen geben. Die übrigen Parameter werden mit vordefinierten Werten belegt. Mit der Eingabe des Namens wird die Zeit bereits zu einem gültigen Objekt und Sie können diese nach WinCC schreiben.

SchreibenSobald die Zeit ein gültiges Objekt ist, können Sie diese nach WinCC schreiben. Schreiben Sie eine Zeit nach WinCC werden alle modifizierten Objekte des Archivsystems ebenfalls nach WinCC geschrieben.



LöschenSie können nur Zeiten löschen, die bei keinem Archiv verwendet werden.

Hinweis


Aufbau der TabelleIn der nachfolgenden Tabelle werden alle für Zeiten einzustellende Parameter aufgelistet. Die durch ein Dropdown-Listenfeld unterstützten Parameter sind durch das Symbol gekennzeichnet.

Spalte KurzbeschreibungName Der Name der Zeit.

Basis

Die Basis der Zeit. Das Produkt aus Basis*Faktor ergibt die Zykluszeit.

Faktor Der Faktor mit dem die Basis multipliziert werden soll. Das Produkt aus Basis*Faktor ergibt die Zykluszeit.

Auslösen bei Systemstart

Gibt an, ob der Zyklus bei Systemstart ausgelöst werden soll.

Auslösen bei Startpunkt

Gibt an, ob der Zyklus bei einem Startpunkt ausgelöst werden soll.

Startpunkt Monat Der "Startpunkt Monat" ist nur einstellbar wenn der Parameter Auslösen bei Startpunkt auf ja ist und die Zykluszeit mindestens eine Stunde beträgt.

Startpunkt Tag Der "Startpunkt Tag" ist nur einstellbar wenn der Parameter Auslösen bei Startpunkt auf ja ist und die Zykluszeit mindestens eine Stunde beträgt.

Startpunkt Stunde Der "Startpunkt Stunde" ist nur einstellbar wenn der Parameter Auslösen bei Startpunkt auf ja ist und die Zykluszeit mindestens eine Minute beträgt.

Startpunkt Minute Der "Startpunkt Minute" ist nur einstellbar wenn der Parameter Auslösen bei Startpunkt auf ja ist.

Startpunkt Sekunde Der "Startpunkt Sekunde" ist nur einstellbar wenn der Parameter Auslösen bei Startpunkt auf ja ist.




So bedienen Sie das Tabellenblatt "Prozesswertarchive"

Einleitung Die Prozesswertarchivtabelle dient Ihnen zur Projektierung zwei verschiedener Arten von WinCC-Objekten. Es handelt sich dabei um das Prozesswertarchiv sowie die den Prozesswertarchiven zugehörigen Prozesswertarchivvariablen. Die logische Zuordnung zwischen Archiv und Variable ergibt sich aus der Position des jeweiligen Objekts in der Tabelle.

Vorgehensweise

ProzesswertarchiveUm ein neues Prozesswertarchiv anzulegen, müssen Sie diesem einen Namen geben. Sobald Sie einen Namen eingegeben haben, wird das Archiv bereits zu einem gültigen Objekt und könnte nach WinCC geschrieben werden. Wenn Sie das Ausfüllen von Defaultwerten aktiviert haben, werden die übrigen Parameter des Archivs mit den auf der Defaultwertetabelle eingestellten Werten belegt.

ProzesswertarchivvariablenUm eine neue Prozesswertarchivvariable anzulegen, müssen Sie eine bereits existierende Variable in die Spalte "Variable" eintragen. Um eine Variable in die Spalte "Variable" einzutragen, steht Ihnen der Variablenauswahldialog zur Verfügung, den Sie über Doppelklick auf die entsprechende Zelle öffnen können. Sobald Sie eine Variable eingegeben haben, wird die Prozesswertarchivvariable bereits zu einem gültigen Objekt und könnte nach WinCC geschrieben werden.



Wenn Sie das Ausfüllen von Defaultwerten aktiviert haben, werden die übrigen Parameter der Prozesswertarchivvariable mit den auf der Defaultwertetabelle eingestellten Werten belegt.

Hinweis

Sie können Prozesswertarchive und Prozesswertarchivvariablen auch von der Variablentabelle aus projektieren. Die Vorgehensweise zum Projektieren von der Variablentabelle aus, finden Sie in dem unten aufgeführten Kapitel.

SchreibenWenn Sie ein Prozesswertarchiv oder eine Prozesswertarchivvariable nach WinCC schreiben, dann werden alle modifizierten Objekte des Tag Logging automatisch nach WinCC geschrieben.

LöschenWenn Sie ein Prozesswertarchiv löschen, werden alle untergeordneten Prozesswertarchivvariablen mitgelöscht. Des Weiteren werden alle Verdichtungsarchivvariablen, bei denen das Prozesswertarchiv oder die Prozesswertarchivvariable eingestellt waren, mitgelöscht.

Hinweis



gekennzeichnet.

Prozesswertarchive

Spalte KurzbeschreibungArchivname Der Name des Prozesswertarchivs. Dieser muss

eindeutig sein.

Archivtyp


Kommentar Ein beliebiger Kommentar.






Spalte KurzbeschreibungGröße Die Größe des Archivs in Datensätzen.

Speicherort

Der Parameter ist nur bei Umlaufarchiven einstellbar. Gibt an, ob das Archiv im Hauptspeicher oder auf der Festplatte gespeichert werden soll.

Prozesswertarchivvariablen

Spalte KurzbeschreibungVariable Die Variable die archiviert werden soll..Archivvariable Name Der Name der Prozesswertarchivvariable. Dieser

muss eindeutig sein.Archivvariable Typ Dieser Parameter ist schreibgeschützt.Kommentar Ein beliebiger Kommentar.



Variablenversorgung

Gibt an, ob die Daten der Variable automatisch oder von Hand übernommen werden sollen.

Erfassungsart

Die Art der Erfassung der Daten.

Erfassungszyklus

Der Zyklus der zur Erfassung der Daten verwendet werden soll.

Archivierungszyklus

Die Zeitbasis des Zyklus der zur Archivierung und zur Anzeige der Daten verwendet werden soll. Der Archivierungszyklus ergibt sich aus dem Produkt Zeitbasis und des Archivierungszyklus Faktor. Dieser muss ein ganzzahliges Vielfaches vom Erfassungszyklus sein.

Archivierungszyklus Faktor Der Archivierungszyklus Faktor. Der Archivierungszyklus ergibt sich aus dem Produkt Zeitbasis und des Archivierungszyklus Faktor. Dieser muss ein ganzzahliges Vielfaches vom Erfassungszyklus sein.

Zusätzlich in Variable schreiben Die Variable in die der letzte archivierte Wert übernommen werden soll.

Bearbeitung

Die Bearbeitung der erfassten Daten. Bei zyklisch selektiver und zyklisch kontinuierlicher Archivierung stehen alle Auswahlmöglichkeiten zur Verfügung. Bei azyklischer Archivierung und der Archivierung bei Änderung kann nur der Momentanwert verwendet werden.

Aktion zur Bearbeitung Die Aktion mit der die Daten bearbeitet werden sollen. Dieser Parameter ist nur einstellbar, wenn die Bearbeitung auf Aktion gestellt wurde.

Einheit Die Einheit des eingetragenen Zeitwertes.




Archivierung bei Änderung

Gibt an, ob die Variable nur archiviert werden soll wenn sie sich geändert hat, oder nicht.

Hysterese



Archivierung bei

Der Trigger bei binären Prozesswertarchivvariablen. Bei analogen und prozessgesteuerten Variablen ist dieser Parameter schreibgeschützt.

Speichern bei Störung

Gibt an, ob bei einer Störung der letzte Wert oder der Ersatzwert gespeichert werden soll.

Anzahl Werte Vorlauf Die Anzahl der Werte die vor dem Archivierungszeitpunkt mitberücksichtigt werden sollen. Der Parameter ist nur bei zyklisch selektiver Archivierung einstellbar.

Anzahl Werte Nachlauf Die Anzahl der Werte die nach dem Archivierungszeitpunkt mitberücksichtigt werden sollen. Der Parameter ist nur bei zyklisch selektiver Archivierung einstellbar.

Darstellungsbegrenzung Untere Grenze Die untere Grenze des Wertebereichs der Variable. 0 bedeutet keine Begrenzung.

Darstellungsbegrenzung Obere Grenze Die obere Grenze des Wertebereichs der Variable. 0 bedeutet keine Begrenzung.

Start Ereignis Der Funktionsname der Funktion, die eine Archivierung auslöst.

Start Variable Binäre Variable.Stop Ereignis Der Funktionsname der Funktion, die eine

Archivierung anhält.Stop Variable Binäre Variable.Langzeitrelevant Hier kann festgelegt werden, ob die Variable auf

dem zentralen Archivserver (WinCC CAS) ins Archiv geschrieben wird.

Archivieren nach Segmentwechsel Hier kann festgelegt werden, ob bei einem Segmentwechsel die azyklisch archivierten Archivvariablen archiviert werden.

Fehlertext Hier kann ein Fehlertext angegeben werden.

Normier Dll

Das zur Variable gehörende Anpassungsprogramm. Es ist abhängig vom Hersteller der AS.




So bedienen Sie das Tabellenblatt "Verdichtungsarchive"

Einleitung Die Verdichtungsarchivtabelle dient Ihnen zur Projektierung zwei verschiedener Arten von WinCC-Objekten. Es handelt sich dabei um das Verdichtungsarchiv sowie die den Verdichtungsarchiven zugehörigen Verdichtungsarchivvariablen. Die logische Zuordnung zwischen Archiv und Variable ergibt sich aus der Position des jeweiligen Objekts in der Tabelle.

Vorgehensweise

VerdichtungsarchiveUm ein neues Verdichtungsarchiv anzulegen, müssen Sie diesem einen Namen geben. Sobald Sie einen Namen eingegeben haben, wird das Archiv bereits zu einem gültigen Objekt und könnte nach WinCC geschrieben werden.

Wenn Sie das Ausfüllen von Defaultwerten aktiviert haben, werden die übrigen Parameter des Archivs mit den auf der Defaultwertetabelle eingestellten Werten belegt.

VerdichtungsarchivvariablenUm eine neue Verdichtungsarchivvariable anzulegen, müssen Sie ein Quellarchiv eintragen. Durch Doppelklick auf die Spalte Quellarchiv können Sie den Dialog Archivvariablenauswahl öffnen. Über diesen Dialog können Sie die Prozesswertarchivvariablen auswählen, die verdichtet werden sollen.

Wenn Sie das Ausfüllen von Defaultwerten aktiviert haben, werden die übrigen Parameter der Verdichtungsarchivvariable mit den auf der Defaultwertetabelle eingestellten Werten belegt.



SchreibenWenn Sie ein Verdichtungsarchivarchiv oder eine Verdichtungsarchivvariable nach WinCC schreiben, dann werden alle modifizierten Objekte des Tag Logging automatisch nach WinCC geschrieben.

LöschenWenn Sie ein Verdichtungsarchiv löschen, werden alle untergeordneten Verdichtungsarchivvariablen mitgelöscht.

Hinweis



gekennzeichnet.

Verdichtungsarchive

Spalte KurzbeschreibungArchivname Der Name des Verdichtungsarchivs.Kommentar Ein beliebiger Kommentar.




Bearbeitungsmethode

Die Methode mit der das Quellarchiv oder die Verdichtungsarchivvariable bearbeitet wird.

Verdichtungszeitraum

Der Zeitraum der im eingerichteten Archiv verdichtet wird. Der Verdichtungszeitraum muss mindestens eine Minute sein.

Verdichtungsarchivvariablen

Spalte KurzbeschreibungQuellarchiv Das Quellarchiv in dem die Quellvariable

enthalten ist.Quellvariable Die Prozesswertarchivvariable die verdichtet

werden soll.Archivvariable Name Der Name der Verdichtungsarchivvariable.Kommentar Ein beliebiger Kommentar.






Bearbeitung

Die Bearbeitungsmethode der im Archivierungszyklus erfassten Werte.

Einheit Die Einheit der zu archivierenden Variable.Langzeitrelevant Hier kann festgelegt werden, ob die Archivvariable


Fehlertext Hier kann ein Fehlertext angegeben werden.

Text Library

Text Library

EinleitungMit der "Text Library" können Sie Texte bearbeiten, die im Runtimesystem von den verschiedenen Modulen verwendet werden.



So bedienen Sie das Tabellenblatt "Texte"

Einleitung Auf dem Tabellenblatt "Texte" werden die Texte der Text Library verwaltet. Defaultmäßig sind die Sprachen Deutsch, Englisch, Französisch, Italienisch und Spanisch vorhanden. Sie können Texte sowie auch Sprachen hinzufügen und löschen.

VorgehensweiseAuf dem Tabellenblatt Texte können Sie bestehende Texte ändern sowie neue Texte hinzufügen.

Sie können einen neuen Text auf zwei verschiedene Arten anlegen. Sie können einen neuen Text anlegen, indem Sie eine neue Text ID vergeben. Sie können des Weiteren einen neuen Text anlegen, in dem Sie einen Eintrag in eine beliebige Text Spalte machen. Die Text ID wird in diesem Fall automatisch vorgegeben, kann jedoch geändert werden.

Meldetexte können Sie direkt auf den entsprechenden Tabellenblättern projektieren. Diese werden automatisch in der Text Library angelegt.

SchreibenSobald ein Text eingegeben wurde, können Sie diesen nach WinCC schreiben. Wenn Sie ein Tabellenblatt, auf dem Meldetexte vorhanden sind, nach WinCC schreiben, dann wird die Text Library ebenfalls nach WinCC geschrieben.



LöschenMeldeblocknamen, Meldeklassennamen und Meldeartennamen können Sie nicht löschen. Wenn Sie einen Meldetext oder einen Zustandstext löschen, dann wird er an der verwendeten Stelle ebenfalls gelöscht. Nicht im Meldesystem verwendete Texte können Sie löschen.

Hinweis


SonderfunktionenUm der Text Library eine Sprache hinzuzufügen, müssen Sie über das Systemmenü "WinCC" den Punkt "RT Sprache hinzufügen" wählen. Es wird der Dialog "Sprache wählen" aufgeblendet. In diesem sind alle verfügbaren Sprachen aufgelistet. Die Sprache die hinzugefügt werden soll, müssen Sie selektieren und den Dialog über die Schaltfläche "OK" schließen. Für die ausgewählte Sprache wird eine neue Spalte eingefügt.



Aufbau der Tabelle

Spalte KurzbeschreibungText ID Die ID des Textes. Solange der Text noch nicht nach WinCC geschrieben wurde, können

Sie die ID des Textes ändern.Sprachen

In diesen Spalten sind alle projektierten Texte aufgelistet. Die Anzahl der Sprachspalte hängt von der Anzahl der projektierten Sprachen ab.

Fehlertext

Eine Kurzbeschreibung eines beim Schreiben nach WinCC aufgetretenen Fehlers. Fehlerfreie Objekte haben den Fehlertext OK.

So bedienen Sie das Tabellenblatt "Schreibfehler"

Einleitung Auf diesem Tabellenblatt werden Ihnen alle fehlerhaften Objekte, die in der Projektmappe vorhanden sind, aufgelistet.

VorgehensweiseDie Fehlerliste wird der Projektmappe erst hinzugefügt, wenn ein Fehler beim Schreiben eines Objekts aufgetreten ist.

In der ersten Spalte der Fehlerliste steht der Objektname, bei dem ein Fehler aufgetreten ist. In der zweiten Spalte steht der Tabellentyp, nicht der Tabellenname. In der dritten Spalte steht eine kurze Beschreibung des aufgetretenen Fehlers.

Durch Doppelklick auf einen Eintrag der Fehlerliste gelangen Sie direkt zum fehlerhaften Objekt.



Aufbau der Tabelle

Spalte KurzbeschreibungObjektname

Der Objektname, bei dem ein Fehler aufgetreten ist.

Tabellentyp

Der Tabellentyp, bei dem ein Fehler aufgetreten ist.

Fehlertext

Eine Kurzbeschreibung des aufgetretenen Fehlers.

Siehe auchFehlerspalte (Seite 240)

So bedienen Sie das Tabellenblatt "Lesefehler"

Einleitung Auf diesem Tabellenblatt werden Ihnen alle fehlerhaften Objekte, die beim Lesen aus WinCC aufgetreten sind, aufgelistet.

VorgehensweiseDie Fehlerliste wird der Projektmappe erst hinzugefügt, wenn ein Fehler beim Lesen eines Objekts aufgetreten ist.

In der ersten Spalte der Fehlerliste steht der Typ des Fehlers. Es können Warnungen und Fehler auftreten. Bei Warnungen wird das Objekt in die Tabelle eingetragen und der fehlerhafte Parameter korrigiert. Bei Fehlern wird das Objekt nicht in die Tabelle eingetragen da der Fehler nicht korrigiert werden kann.



In der zweiten Spalte steht der Tabellentyp(nicht der Tabellenname). In der dritten Spalte steht eine kurze Beschreibung des aufgetretenen Fehlers.

In den weiteren Spalten werden die gelesenen fehlerhaften Objektdaten eingetragen.

Aufbau der Tabelle

Spalte KurzbeschreibungTyp Der Typ des Fehlers.Tabellentyp Der Tabellentyp, bei dem ein Fehler aufgetreten ist.Fehlertext Eine Kurzbeschreibung des aufgetretenen Fehlers.Param 1 bis Param 89

Alle Parameter des Fehlerhaften Objektes.

1.8.5.4 Dialoge

Dialoge

EinleitungÜbersicht über die Dialoge im ConfigurationTool. Auf die Dialoge des ConfigurationTools wird in den folgenden Kapiteln näher eingegangen.

Siehe auchSo bedienen Sie den Archivvariablendialog (Seite 203)

So bedienen Sie den Variablendialog (Seite 200)

So bedienen Sie den Variablendialog

Einleitung Zur Eingabe von Variablen steht Ihnen im ConfigurationTool ein Variablendialog zur Verfügung. Sie sollten den Variablendialog immer verwenden. Zum Einen ist dadurch sichergestellt, dass die Variable schon existiert, zum Anderen können Sie über den Variablendialog mehrere Variablen auf einmal eintragen. Über das Dropdown-Listenfeld am



unteren Ende des Dialoges können Sie die Variablentabelle auswählen, von der Sie die Variablen einfügen möchten.

Bedienung des VariablendialogsDen Variablendialog können Sie durch Doppelklick, auf eine Spalte im ConfigurationTool in der Variablen einzutragen sind, öffnen. Selektieren Sie die Variable, die Sie einfügen wollen. Stellen Sie über das Drehfeld ein, wie oft die Variable eingefügt werden soll. Über die Schaltfläche "Einfügen" werden die Variablen eingefügt.

Über den Variablendialog können Sie auch mehrere verschiedene Variablen auf einmal einfügen. Dazu sind die Variablen die Sie einfügen möchten zu selektieren.



Über die Schaltfläche "Einfügen" werden die selektierten Variablen so oft hintereinander eingefügt, wie Sie übe das Drehfeld eingestellt haben.

Schaltflächen des Variablendialoges● Sortieren der Variablen nach Namen

Über die beiden Schaltflächen können Sie Variablen nach ihren Namen auf - oder absteigend sortieren.

● Sortieren der Variablen nach DatentypÜber die Schaltfläche können Sie die Variablen absteigend nach ihrem Datentyp sortiert.



● Setzen eines FiltersÜber die Schaltfläche können Sie über die Spalten Name und Datentyp einen Filter setzen. Die Auswahl eines Filters erfolgt über die hinzugefügten Dropdown-Listenfelder.Durch nochmaliges Drücken der Schaltfläche können Sie die Filter wieder zurücksetzen.

● Die Spaltenbreiten im Dialog einstellenÜber die Schaltfläche können Sie den Dialog "Spaltenbreite" öffnen. In diesem Dialog können Sie die Spaltenbreite der beiden Spalten verändern.

So bedienen Sie den Archivvariablendialog

Einleitung Zur Eingabe von Prozesswertarchivvariablen auf der Verdichtungsarchivtabelle steht Ihnen im ConfigurationTool ein Archivvariablendialog zur Verfügung. Sie sollten den Archivvariablendialog immer verwenden. Zum Einen ist dadurch sichergestellt, dass die Archivvariable schon existiert, zum Anderen können Sie über den Archivvariablendialog mehrere Variable auf einmal eintragen. Über das Dropdown-Listenfeld am unteren Ende des



Dialoges können Sie die Prozesswerttabelle auswählen, von der Sie die Variablen einfügen möchten.

Bedienung des VariablendialogsDen Archivvariablendialog können Sie durch Doppelklick, auf eine Spalte im ConfigurationTool in der Variablen einzutragen sind, öffnen. Selektieren Sie die Variable, die Sie einfügen wollen. Über die Schaltfläche "Einfügen" werden die Variablen eingefügt.

Über den Archivvariablendialog können Sie auch mehrere verschiedene Variablen auf einmal einfügen. Dazu sind die Variablen die Sie einfügen möchten zu selektieren.



Schaltflächen des Variablendialoges● Die Anzeige aktualisieren

Über die Schaltfläche können Sie die Anzeige des Archivvariablendialoges aktualisieren.

● Die Spaltenbreiten im Dialog einstellenÜber die Schaltfläche können Sie den Dialog "Spaltenbreite" öffnen. In diesem Dialog können Sie die Spaltenbreite der beiden Spalten verändern.

1.8.5.5 Bearbeiten von projektierten Daten

Bearbeiten von projektierten Daten

EinleitungIm Allgemeinen können Sie jede Funktionalität, die Excel bietet, uneingeschränkt nutzen. Beim Bearbeiten von bereits projektierten Daten im ConfigurationTool müssen Sie jedoch Besonderheiten beachten. In den folgenden Kapiteln wird auf diese Besonderheiten näher eingegangen.

Siehe auchSo sortieren Sie Daten (Seite 217)

So setzen Sie einen Filter (Seite 218)

So schneiden Sie Daten aus (Seite 216)

So kopieren Sie Daten (Seite 216)

So löschen Sie Daten aus der Projektmappe und aus WinCC (Seite 211)

So schreiben Sie Daten nach WinCC (Seite 206)



So schreiben Sie Daten nach WinCC

Einleitung Wenn Sie Daten nach WinCC schreiben wollen, dann muss eine Verbindung mit dem dazugehörigen WinCC-Projekt vorhanden sein. Folgende Möglichkeiten zum Schreiben von Daten nach WinCC stehen ihnen zur Verfügung.

Hinweis

Falls nach dem Schreiben die Daten im WinCC-Projekt und in der Projektmappe nicht übereinstimmen, dann kann dies auf ein Aktualisierungsproblem des WinCC Explorer zurückzuführen sein. Um die Ansicht zu aktualisieren, müssen Sie das WinCC-Projekt schließen und wieder öffnen.

Schreiben nach WinCC über die Symbolleiste 1. Betätigen Sie die Schaltfläche in der Symbolleiste. Es wird der Dialog "Schreiben"

geöffnet.

2. Im Dialog können Sie die Tabellenblätter auswählen, deren Daten nach WinCC geschrieben werden sollen.



3. Über das Kontrollkästchen "Nur Änderungen" können Sie festlegen, dass nur geänderte Objekte nach WinCC geschrieben werden sollen. Wird das Kontrollkästchen abgewählt, werden alle Objekte erneut nach WinCC geschrieben.

4. Durch Drücken der Schaltfläche "OK" werden die Daten der Tabellenblätter nach WinCC geschrieben.



Schreiben nach WinCC über das Dropdown-Menü 1. Öffnen Sie das "WinCC" Dropdown-Menü.

2. Abhängig von der in der Projektmappe aktiven Tabelle steht im Dropdown-Menü ein Menüpunkt zum Schreiben von Objekten zur Verfügung. Über diesen wird der Dialog "Schreiben geöffnet.



3. Im Dialog können Sie die Tabellenblätter auswählen, deren Daten nach WinCC geschrieben werden sollen. Es stehen jedoch nur die Tabellen vom Typ der aktiven Tabelle zur Auswahl.

4. Die weitere Vorgehensweise ist dieselbe wie beim "Schreiben nach WinCC über die Symbolleiste".



Schreiben nach WinCC über das Kontextmenü 1. Selektieren Sie die zu schreibenden Objekte. Es muss die gesamte Zeile selektiert werden.

2. Öffnen Sie das Zeilenkontextmenü über die rechte Maustaste und wählen Sie den Punkt "WinCC - Selektion schreiben" aus. Es werden alle selektierten Objekte nach WinCC geschrieben. Über das Kontextmenü werden nur geänderte Objekte nach WinCC geschrieben.



So löschen Sie Daten aus der Projektmappe und aus WinCC

Einleitung Sie können keine Zeilen, Spalten oder Zellen des Datenbereichs von WinCC-Objekten löschen. Zum Löschen von WinCC-Objekten steht Ihnen der Kontextmenüeintrag "WinCC -



Selektion löschen" zur Verfügung. Beim Löschen ganzer Tabellenblätter werden alle darauf projektierten WinCC-Objekte gelöscht. Es können nicht alle Tabellenblätter gelöscht werden.

Hinweis

Falls nach dem Löschen die Daten im WinCC-Projekt und in der Projektmappe nicht übereinstimmen, dann kann dies auf ein Aktualisierungsproblem des WinCC Explorer zurückzuführen sein. Um die Ansicht zu aktualisieren, müssen Sie das WinCC-Projekt schließen und wieder öffnen.



Löschen über das Kontextmenü1. Selektieren Sie die zu löschenden Objekte. Es muss die gesamte Zeile selektiert werden.

2. Öffnen Sie das Zeilenkontextmenü über die rechte Maustaste und wählen Sie den Punkt "WinCC - Selektion löschen" aus. Es werden alle selektierten Objekte gelöscht.





Löschen eines Tabellenblatts1. Öffnen Sie das Kontextmenü des Tabellenblattes über die rechte Maustaste und wählen

Sie den Punkt "Löschen" aus. Es wird das Tabellenblatt und alle darauf projektierten Daten gelöscht.

Löschen ohne Verbindung zu WinCCDamit Sie Objekte löschen können, muss keine Verbindung mit dem zugeordneten WinCC-Projekt bestehen. Bei der nächsten Verbindungsaufnahme mit dem zugeordneten WinCC-Projekt wird ein Abgleich durchgeführt und alle aus der Projektmappe gelöschten Objekte auch aus WinCC gelöscht.



Löschen mit Verbindung zu WinCCWerden Objekte aus einer Projektmappe gelöscht, werden diese, sofern sie bereits im WinCC-Projekt existierten, auch aus diesem gelöscht. Es ist darauf zu achten, dass gelöschte Daten nicht wiederhergestellt werden können.

So kopieren Sie Daten

Einleitung In Excel können Sie Daten über die Kontextmenüs, das Dropdown-Menü, die Symbolleiste und die Tastenkombination kopieren. Daten können Sie im ConfigurationTool ohne Einschränkungen kopieren und einfügen. Wenn Sie Daten einfügen, werden diese überprüft und gegebenenfalls korrigiert. Um gesamte WinCC-Objekte zu kopieren gehen Sie wie folgt vor.

Kopieren von WinCC-Objekten1. Wechseln Sie auf das Tabellenblatt "Projekteigenschaften" und setzen Sie den Parameter

"Defaultwerte verwenden" auf "nein".

2. Kopieren Sie die gesamte Zeile der Objekte.

3. Fügen Sie die kopierten Objekte auf einer Tabelle des gleichen Typs ein. ZB: können Variablen nur wieder auf einer Variablentabelle eingefügt werden.

4. Das ConfigurationTool überprüft nun die eingefügten Daten. Da eine eindeutige Namensvergabe vorhanden sein muss, werden Sie über den Office Assistenten gefragt, ob ein eindeutiger Name generiert werden soll. Bestätigen Sie mit "Ok".

Hinweis

Wenn Sie vor dem kopieren von WinCC-Objekten bereits Namen eingegeben haben, dann können Sie auch nur die Parameter der Objekte kopieren.

So schneiden Sie Daten aus

Einleitung In Excel können Sie beliebige Daten ausschneiden, und auch wieder einfügen. Im ConfigurationTool ist dies jedoch nicht möglich. Um im ConfigurationTool Daten auszuschneiden müssen Sie immer das gesamte Objekt selektieren. Die ausgeschnittenen Daten können Sie auch nur auf Tabellenblättern einfügen, die vom selben Typ sind, wie das Tabellenblatt von dem Sie die Daten ausgeschnitten haben. Zum Ausschneiden von Daten stehen Ihnen alle Möglichkeiten zur Verfügung, die Excel bietet.



Ausschneiden1. Selektieren Sie die Objekte die ausgeschnitten werden sollen. Sie müssen entweder die

gesamte Zeile, oder alle Objektparameter selektiert werden.

2. Schneiden Sie die Daten aus.

Einfügen1. Selektieren Sie entweder den Bereich in den die ausgeschnittenen Daten eingefügt werden

sollen, oder die Zelle von der aus begonnen werden soll die Daten einzufügen. Wenn Sie einen Bereich selektieren müssen Sie darauf achten, dass er gleich groß ist, wie der Bereich der einzufügenden Daten.

2. Fügen Sie die Daten ein.

So sortieren Sie Daten

Einleitung Im ConfigurationTool können Sie die Daten auf der Projektmappe nach Spalten sortieren. Dazu bietet das ConfigurationTool zwei Möglichkeiten.



Sortieren über Doppelklick1. Wenn Sie im ConfigurationTool Daten auf - oder absteigend sortieren möchten, genügt ein

Doppelklick auf die Parameterüberschrift. Die Daten auf dem Tabellenblatt werden dann nach dieser Spalte sortiert.

Sortieren über das Menü1. Wählen Sie im Systemmenü "Daten" den Punkt sortieren. Es wird der Dialog "Sortieren"

aufgeblendet.

2. Im Dialog "Sortieren" können Sie bis zu drei Spalten angeben, nach denen entweder auf - oder absteigend sortiert werden soll. Durch Drücken der Schaltfläche "OK" werde die Daten sortiert

So setzen Sie einen Filter

Einleitung Eine Standardfunktion von Excel ist das Setzen eines Filters. Mit dieser Standardfunktion können Sie auf einem Tabellenblatt mit vielen Objekten eine Übersichtlichere Darstellung



erreichen. So können Sie z.B.: auf der Variablentabelle einen Filter über die Spalte "Datentyp" setzten, um sich nur einen Datentyp anzeigen zu lassen.

Hinweis

Ist ein Filter gesetzt, und Sie versuchen Daten über das Kontextmenü nach WinCC zu schreiben oder zu löschen, dann werden nur die sichtbaren Daten geschrieben oder gelöscht.

Filter setzen1. Markieren Sie die gesamte Spalte "Datentyp" auf dem Tabellenblatt "Variablen".

2. Im Systemmenü "Daten" wählen Sie den Punkt "Filter". Im Unterpunkt Filter wählen Sie den Punkt "Auto Filter". Es wird über die Spalte "Datentyp" ein Filter gelegt.



3. Ob ein Filter gesetzt ist, erkennen Sie daran, dass in der ersten Zeile in der Spalte "Datentyp" ein Dropdown-Listenfeld hinzugefügt wurde. Über dieses Dropdown-Listenfeld können Sie nun den Filter auf "Rohdatentyp" setzten.

4. In der Tabelle werden nur noch Variablen des Datentyps "Rohdatentyp" angezeigt.



Filter rücksetzen1. Im Dropdown-Listenfeld des Filters wählen Sie den Punkt "(Alle)". Es werden nun wieder

alle existierenden Variablen angezeigt.

2. Um einen Filter gänzlich zu entfernen wählen Sie im Systemmenü "Daten". Wählen Sie den Punkt "Filter". Im Unterpunkt Filter wählen Sie den Punkt "Auto Filter". Der Filter wird wieder entfernt.



1.8.5.6 Erzeugen von Objekten über das Kontextmenü der Variablentabelle

So erzeugen Sie Objekte über das Kontextmenü der Variablentabelle

Einleitung Das ConfigurationTool bietet Ihnen die Möglichkeit von der Variablentabelle aus Objekte zu erzeugen. Dies erfolgt über das Zeilenkontextmenü der Variablentabelle. Über dieses Menü können Sie auf einfache Weise Einzelmeldungen, Grenzwertüberwachungen und



Archivvariablen erzeugen. Die weiteren Vorgehensweisen finden Sie in den unten aufgeführten Kapiteln.




So erzeugen Sie Grenzwertüberwachungen aus der Variablentabelle (Seite 233)

So erzeugen Sie Einzelmeldungen aus der Variablentabelle (Seite 228)

So erzeugen Sie Archivvariablen aus der Variablentabelle

Einleitung Das ConfigurationTool bietet Ihnen die Möglichkeit aus der Variablentabelle heraus Variablen zu archivieren. Dies erfolgt über das Kontextmenü der Variablentabelle.



Vorgehensweise1. Selektieren Sie alle Variablen die archiviert werden sollen.

2. Öffnen Sie das Zeilenkontextmenü und wählen Sie den Punkt "WinCC - Archivieren". Es wird der Dialog "Archivieren" aufgeblendet.





3. Im Dialog "Archivieren" können Sie über das DropDown-Listenfeld auswählen, in welchem Prozesswertarchiv die Variablen archiviert werden sollen. Wenn Sie ein neues Prozesswertarchiv anlegen wollen, müssen Sie den Namen des Prozesswertarchivs in das Dropdown-Listenfeld eintragen. Wenn Sie die Schaltfläche "OK" drücken, werden die Archivvariablen angelegt.

4. Auf der Prozesswertarchivtabelle wurden nun die entsprechenden Prozesswertarchivvariablen erzeugt.



So erzeugen Sie Einzelmeldungen aus der Variablentabelle

Einleitung Das ConfigurationTool bietet Ihnen die Möglichkeit aus der Variablentabelle heraus Einzelmeldungen zu generieren. Dies erfolgt über das Kontextmenü der Variablentabelle.

Hinweis

Sie können die Einstellungen der Dialoge auf dem Tabellenblatt "Defaultwerte Alarm Logging" verändern.



Vorgehensweise1. Selektieren Sie alle Variablen, für die Meldungen erzeugt werden sollen.

2. Öffnen Sie das Zeilenkontextmenü und wählen Sie den Punkt "WinCC - Melden". Es wird der Dialog "Melden" aufgeblendet.





3. Im Dialog "Melden" wählen Sie die Bits der Variablen, für die Sie Einzelmeldungen erzeugen möchten. Das Kontrollkästchen "Bereits existierende Meldungen löschen" bedeutet, dass, wenn für diese Variable bereits Meldungen existieren, diese gelöscht und neue Einzelmeldungen angelegt werden. Andernfalls werden die bereits existierenden Einzelmeldungen beibehalten, und nur noch nicht existierende generiert.



4. Geben Sie bei Rohdatenvariablen die Anzahl der Einzelmeldungen ein, die generiert werden sollen.

Durch Drücken der Schaltfläche "Ok" werden die entsprechenden Meldungen generiert.

5. Auf der Einzelmeldungstabelle wurden nun die entsprechenden Meldungen erzeugt.



So erzeugen Sie Grenzwertüberwachungen aus der Variablentabelle

Einleitung Das ConfigurationTool bietet Ihnen die Möglichkeit aus der Variablentabelle heraus Grenzwertüberwachungen zu generieren. Das Generieren erfolgt über das Kontextmenü der Variablentabelle.

Hinweis

Sie können die Einstellungen der Dialoge auf dem Tabellenblatt "Defaultwerte Alarm Logging" verändern.



Vorgehensweise1. Selektieren Sie alle Variablen, die Sie Grenzwertüberwachen wollen.

2. Öffnen Sie das Zeilenkontextmenü der Variablentabelle und wählen Sie den Punkt "WinCC - Grenzwertüberwachen". Es wird der Dialog "Grenzwertüberwachen" aufgeblendet.



3. Im Dialog "Grenzwertüberwachen" sind bereits die auf der Defaultwerttabelle vorhandenen Grenzwerte eingetragen. Über die Schaltfläche "Hinzufügen" können Sie weitere Grenzwerte für die Variablen hinzufügen. Es wird der Dialog "Grenzwert hinzufügen" aufgeblendet.



4. Im Dialog"Grenzwerte hinzufügen" können Sie einen Grenzwert eingeben. Es ist jedoch darauf zu achten, dass der Grenzwert innerhalb der variablenspezifischen Grenzen liegt. Wenn Sie einen Grenzwert indirekt aus einer Variable auslesen möchten, dann müssen Sie das Kontrollkästchen "indirekt" anwählen, und den Namen einer existierenden Variable anstatt des Grenzwertes eintragen. Über das Dropdown-Listenfeld "Grenze" können Sie festlegen, ob der Grenzwert eine Obergrenze oder Untergrenze sein soll. Über die Schaltfläche "OK" wird der Grenzwert in den Dialog "Grenzwertüberwachen" übernommen.



5. Über das Kontrollkästchen "Bereits existierende Grenzwerte löschen" können Sie wählen, ob für die selektierte Variable existierende Grenzwerte gelöscht werden sollen, oder nicht. Durch Drücken der Schaltfläche "OK" werden die Grenzwerte generiert.

6. Auf dem Tabellenblatt "Grenzwertüberwachungen/Grenze" wurden die Grenzwerte für die Variablen generiert.



1.8.5.7 Ändern des Ablageortes der Daten

Ändern des Ablageortes der Daten

EinleitungDas ConfigurationTool bietet Ihnen die Möglichkeit, den Ablageort der Daten zu verändern. So ist es zum Beispiel möglich, die Projektmappe auf einen anderen Rechner zu transferieren, oder den Ablageort des WinCC-Projekts zu ändern.

Siehe auchSo transferieren Sie ein WinCC-Projekt (Seite 238)

So transferieren Sie eine Projektmappe (Seite 239)

So transferieren Sie ein WinCC-Projekt

Einleitung Das mit einer Projektmappe verbundene WinCC-Projekt können Sie ohne Probleme auf einen anderen Ablageort transferieren. Sie müssen lediglich eine neue Projektverbindung herstellen.



Vorgehensweise1. Schließen Sie das WinCC-Projekt und transferieren Sie es auf den gewünschten Ablageort.

Öffnen Sie die mit dem Projekt verbundene Projektmappe. Stellen Sie über das Dropdown-Menü oder die Symbolleiste eine neue Projektverbindung her.

2. Es wird der Office Assistent "Projektverbindung" aufgeblendet. Diesen müssen Sie mit ja beantworten, damit die Projektmappe den neuen Pfad des WinCC-Projekts übernehmen kann.

3. Es wird ein "Öffnen" Dialog aufgeblendet. In diesem müssen Sie das WinCC-Projekt auswählen, und den Dialog mit "Öffnen" schließen. Es wird die Projektverbindung wieder hergestellt.

So transferieren Sie eine Projektmappe

Einleitung Das ConfigurationTool bietet Ihnen die Möglichkeit eine Projektmappe auf einen anderen Rechner zu transferieren. Durch diese Option ist es möglich, eine vorhandene Projektmappe auf einem anderen Rechner weiter zu bearbeiten.

Vorgehensweise1. Speichern Sie die vorhandene Projektmappe und transferieren Sie diese auf den

gewünschten Rechner.

2. Öffnen Sie die Projektmappe auf dem neuen Rechner. Excel blendet den Office Assistenten mit einer Abfrage auf. Die Abfrage können Sie mit Nein beantworten.

3. Das ConfigurationTool blendet die Abfrage "Referenzen aktualisieren!" auf. Diese Abfrage müssen Sie mit "Ja" beantworten, damit das ConfigurationTool die Referenzen der Projektmappe dem neuen Rechner anpassen kann.

1.8.6 Diagnose

1.8.6.1 Diagnose

Einleitung Im ConfigurationTool stehen ihnen zur Diagnose und Fehlersuche der Office Assistent und die Fehlerspalte zur Verfügung. Der Office Assistent unterstützt Sie während des Projektierens von Daten. Jede Änderung oder Korrektur die vom ConfigurationTool durchgeführt wird, wird über den Office Assistenten ausgegeben.

Wenn beim Schreiben nach WinCC Fehler auftreten, werden diese in der Fehlerspalte angezeigt. Des Weiteren wird das Tabellenblatt "Fehlerliste" erzeugt. Auf diesem Tabellenblatt werden alle Fehler der Projektmappe aufgelistet.



Siehe auchFehlerspalte (Seite 240)

So bedienen Sie das Tabellenblatt "Lesefehler" (Seite 199)

1.8.6.2 Fehlerspalte

Einleitung Auf jedem Tabellenblatt auf dem Sie Daten projektieren können ist eine Fehlerspalte vorhanden. In dieser werden im Fehlerfalle Fehlertexte ausgegeben. In der darrunterliegenden Liste sind alle Fehlertexte die auftreten könnten aufgelistet.

Fehlerliste

Fehlertext Ursache FehlerbehebungOK kein Fehler kein FehlerAllgemeiner Fehler beim Erzeugen!

Das Schreiben des gesamten Datenblocks nach WinCC ist fehlgeschlagen.

Ist die Verbindung zu WinCC noch intakt?

Fehler beim Erzeugen des Objekts!

Wurde das Objekt direkt in WinCC angelegt?

Allgemeiner Fehler beim Modifizieren!

Das Schreiben des gesamten Datenblocks nach WinCC ist fehlgeschlagen.

Ist die Verbindung zu WinCC noch intakt?

Fehler beim Modifizieren des Objekts!

Wurde das Objekt direkt aus WinCC gelöscht?



Fehlertext Ursache FehlerbehebungDie eingestellte Verbindung existiert noch nicht!

Die eingestellte Verbindung wurde noch nicht nach WinCC geschrieben.

Schreiben Sie die eingestellte Verbindung nach WinCC.

Der Meldeblockname existiert noch nicht in der Text Library!

Die Text Library wurde noch nicht nach WinCC geschrieben.

Schreiben Sie die Text Library nach WinCC.

Der Kommunikationstreiber kann nicht installiert werden!

Der eingestellte Kommunikationstreiber ist nicht auf ihrem System installiert.

Verwenden Sie einen anderen Kommunikationstreiber oder installieren Sie den eingestellten.

Die eingestellte Hupvariable existiert noch nicht!

Die eingestellte Hupvariable wurde noch nicht nach WinCC geschrieben.

Schreiben Sie die eingestellte Hupvariable nach WinCC.

Die eingestellte Gruppe existiert noch nicht!

Die eingestellte Gruppe wurde noch nicht nach WinCC geschrieben.

Schreiben Sie die eingestellte Gruppe nach WinCC.

Der eingestellte Strukturtyp existiert noch nicht!

Der eingestellte Strukturtyp wurde noch nicht nach WinCC geschrieben.

Schreiben Sie den eingestellten Strukturtyp nach WinCC.

Der Meldeklassenname existiert noch nicht in der Text Library!



Eine oder mehrere Gruppenmeldungsvariablen existieren noch nicht!

Die eingestellte Gruppenmeldungsvariable existiert noch nicht in WinCC.

Schreiben Sie die eingestellte Gruppenmeldungsvariable nach WinCC.

Der Meldeartenname existiert noch nicht in der Text Library!



Die eingestellte Meldeklasse existiert noch nicht!

Die eingestellte Meldeklasse existiert noch nicht in WinCC.

Schreiben Sie die eingestellte Meldeklasse nach WinCC.

Die eingestellte Meldeart existiert noch nicht!

Die eingestellte Meldeart existiert noch nicht in WinCC.

Schreiben Sie die eingestellte Meldeart nach WinCC.

Ein oder mehrere Meldungstexte existieren noch nicht in der Text Library!



Ein oder mehrere Prozesswertblockvariablen existieren noch nicht!

Die eingestellte Prozesswertblockvariable existiert noch nicht in WinCC.

Schreiben Sie die eingestellte Prozesswertblockvariable nach WinCC.

Fehler beim Anlegen des Infotexts! Sie haben Änderungen direkt in WinCC durchgeführt.

Schreiben Sie alle Daten die in WinCC noch nicht existieren nach WinCC.Schließen Sie die aktuelle Projektmappe. Legen Sie eine neue Projektmappe mit Verbindung zu ihrem WinCC-Projekt an.



Fehlertext Ursache FehlerbehebungFehler beim Anlegen des LoopInAlarms!

Sie haben Änderungen direkt in WinCC durchgeführt.


Beim Schreiben des übergeordneten Objekts sind Fehler aufgetreten!

Das übergeordnete Objekt konnte nicht nach WinCC geschrieben werden.

Überprüfen Sie den Fehlertext des übergeordneten Objekts. Versuchen Sie den Fehler zu korrigieren und schreiben Sie erneut nach WinCC.

Fehler beim Erzeugen des Filters! Sie haben Änderungen direkt in WinCC durchgeführt.


Die eingestellte Variable existiert noch nicht!

Die eingestellte Variable existiert noch nicht in WinCC.

Schreiben Sie die eingestellte Variable nach WinCC.

Die eingestellte Meldung existiert noch nicht!

Die eingestellte Meldung existiert noch nicht in WinCC.

Schreiben Sie die eingestellte Meldung nach WinCC.

Ein oder mehrere Zustandstexte existieren noch nicht in der Text Library!



Die eingestellte Meldevariable existiert noch nicht!

Die eingestellte Meldevariable existiert noch nicht in WinCC.

Schreiben Sie die eingestellte Meldevariable nach WinCC.

Die eingestellte Zustandsvariable existiert noch nicht!

Die eingestellte Zustandsvariable existiert noch nicht in WinCC.

Schreiben Sie die eingestellte Zustandsvariable nach WinCC.

Die eingestellte Quittiervariable existiert noch nicht!

Die eingestellte Quittiervariable existiert noch nicht in WinCC.

Schreiben Sie die eingestellte Quittiervariable nach WinCC.

Die eingestellte Gruppenmeldung existiert noch nicht!

Die eingestellte Gruppenmeldung existiert noch nicht in WinCC.

Schreiben Sie die eingestellte Gruppenmeldung nach WinCC.

Die eingestellte Sperrvariable existiert noch nicht!

Die eingestellte Sperrvariable existiert noch nicht in WinCC.

Schreiben Sie die eingestellte Sperrvariable nach WinCC.

Die eingestellte Grenzwertvariable existiert noch nicht!

Die eingestellte Grenzwertvariable existiert noch nicht in WinCC.

Schreiben Sie die eingestellte Grenzwertvariable nach WinCC.



1.8.7 Tips und Tricks

1.8.7.1 Tips und Tricks

EinleitungIn den folgenden Kapiteln erhalten Sie Tips und Tricks, die Ihnen das Arbeiten mit dem ConfigurationTool erleichtern.

Siehe auchPackages (Seite 253)

Adressstrings für die Simatic S7 ProtocolSuite (Seite 251)

Sonderzeichen (Seite 250)

VBA-Makros (Seite 250)

Adressgenerierung (Seite 246)

Zeilenbeschränkung (Seite 246)

So wechseln Sie das Tabellenblatt (Seite 244)

Beispiel für ein Mengengerüst im ConfigurationTool (Seite 243)

1.8.7.2 Beispiel für ein Mengengerüst im ConfigurationTool

Einleitung Mit dem ConfigurationTool können Sie auf einmal eine große Anzahl von z.B. Variablen, Meldungen und Archivvariablen in WinCC anlegen. Die Performance wird jedoch beeinflusst von der eingesetzten Hardware und der Office-Version.

Zur Orientierung finden Sie hier ein Beispiel für eine typische Konfiguration mit den entsprechenden Werten.

Mengengerüst - Beispiel

ProjektierungEin WinCC-Projekt wird über das ConfigurationTool in Excel eingelesen.

Ein neues WinCC-Projekt wird über das ConfigurationTool erstellt. Die Daten aus dem ersten Projekt werden in das neue WinCC-Projekt geschrieben.

Mengengerüst● 20.000 interne Variablen

● 40.000 Prozessvariablen

● 40.000 Archivvariablen



● 10.000 Meldungen

● 80.000 Texte

Eingesetzte Hardware● Pentium 4, 3,1 GHz

● Arbeitsspeicher: 1024 MByte

● Virtueller Arbeitsspeicher: 756 MByte

Eingesetzte Software● Windows XP Professional SP1

● Internet Explorer 6.0 SP1

● Office 2003

● WinCC V6.0 SP3

Performance● Einlesen in Excel: ca. 30 Minuten

● Schreiben nach WinCC: ca. 3,5 Stunden

Hinweis

Die Zahlen in diesem Beispiel sind abhängig von zusätzlichen Faktoren, z.B. Systemkonfiguration und Projektierung des WinCC-Projekts.

Siehe auchSystemvoraussetzungen (Seite 120)

1.8.7.3 So wechseln Sie das Tabellenblatt

Einleitung Ab einer gewissen Anzahl an Tabellen ist es sehr umständlich, zwischen den einzelnen Tabellenblättern zu wechseln. Excel bietet Ihnen dazu eine einfache Möglichkeit.



VorgehensweiseSie können über ein Kontextmenü am linken unteren Fensterrand bequem und schnell zwischen den Tabellenblättern hin- und herschalten.



1.8.7.4 Zeilenbeschränkung

Einleitung Beim Projektieren in Excel sollten Sie nicht die maximal mögliche Zeilenzahl von 65536 verwenden. Die verwendete Zeilenzahl sollte beschränkt werden, da Excel bei zu vollen Tabellen erheblich an Performance verliert. Deshalb bietet Ihnen das ConfigurationTool die Möglichkeit, die Daten auf mehrere Tabellenblätter aufzuteilen.

Als Defaultwert ist im ConfigurationTool eine Zeilenbeschränkung von 16.000 Zeilen pro Tabellenblatt eingestellt. Diese Zeilenbeschränkung sollte beibehalten werden.

1.8.7.5 Adressgenerierung

Einleitung Zur Generierung von Adressen für externe Variablen können Sie im ConfigurationTool Standardfunktionen von Excel verwenden.

Im nachfolgenden Beispiel wird der Adressstring vom Datentyp Vorzeichenbehafteter 8 Bit Wert einer SIMATIC S7 Protocol Suite generiert.

VorgehensweiseDer Adressstring des Beispiels ist folgendermaßen aufgebaut:

DB50,DBB0,QC

Die Datenbausteinnummer 50 und die Bytenummer 0 sind veränderbare Komponenten des Adressstrings. Der String ,QC ist optional und dient zur Festlegung des Quality Codes.



1. Legen Sie im benutzerdefinierten Bereich der Variablentabelle für jede veränderbare Komponente des Adressstrings eine Spalte an. Die erste und zweite Zeile ausfüllen.

2. Markieren Sie die ersten beiden Adressen. Durch Automatisches Ausfüllen die restlichen Adressen automatisch generieren.





3. Geben Si in der Adressspalte die unten gezeigte Formel ein. Die Spaltenangaben AJ3, AK3 und AL3 sind abhängig davon, wo die Komponenten des Adressstrings im benutzerdefinierten Bereich angelegt wurden.

4. Die erste Adresse markieren. Durch Automatisches Ausfüllen werden die restlichen Adressstrings automatisch generiert.



1.8.7.6 VBA-Makros

EinleitungDa die Daten im ConfigurationTool in einer Excel Mappe vorliegen, können Sie diese über VBA-Makros ansprechen. So können Sie zum Beispiel über ein Makro automatisch Objekte anlegen.

VBA-Makros sollten jedoch nur von versierten Benutzern verwendet werden, da das ConfigurationTool in der Bedienung sich von normalen Excel Mappen unterscheidet.

1.8.7.7 Sonderzeichen

Einleitung Microsoft Excel interpretiert Texte die mit speziellen Sonderzeichen beginnen oder diese enthalten als Formel. Dies kann Probleme beim Arbeiten mit dem Configuration Tool verursachen.

Diese Sonderzeichen sind "=", "+" und "-". Diese Zeichen sollten daher nicht als Teil von Objektnamen (Gruppennamen, Variablennamen, Texten usw.) verwendet werden.



1.8.7.8 Adressstrings für die Simatic S7 ProtocolSuite

Einleitung Die Adressstrings werden im Configuration Tool nicht automatisch generiert. Sie müssen die Adressstrings im Configuration Tool selbst eingeben. In der unten aufgeführten Tabelle sind alle Adressstrings für die SIMATIC S7 ProtocolSuite aufgeführt.

Adressstrings

Tabelle 1-1 Binäre Variable

Datenbereich Adressierung AdresstringBit Bit DB1,D0.0Merker Bit M0.0Eingang Bit E0.0Ausgang Bit A0.0

Tabelle 1-2 Vorzeichenloser 8 Bit Wert/Vorzeichenbehafteter 8 Bit Wert

Datenbereich Adressierung AdressstringDB Byte DB1,DBB0Merker Byte MB0Eingang Byte EB0Ausgang Byte AB0DB Wort DB1,DBW0Merker Wort MW0Eingang Wort EW0Ausgang Wort AW0Zähler Wort Z0Zeiten Wort T0DB Doppelwort DB1,DD0Merker Doppelwort MD0Eingang Doppelwort ED0Ausgang Doppelwort AD0


Datenbereich Adressierung AdressstringDB Byte DB1,DBB0Merker Byte MB0Eingang Byte EB0Ausgang Byte AB0DB Wort DB1,DBW0Merker Wort MW0



Datenbereich Adressierung AdressstringEingang Wort EW0Ausgang Wort AW0Zähler Wort Z0Zeiten Wort T0DB Doppelwort DB1,DD0Merker Doppelwort MD0Eingang Doppelwort ED0Ausgang Doppelwort AD0



Tabelle 1-5 Gleitkommazahl 32 Bit IEEE 754/Gleitkommazahl 64 Bit IEEE 754




Tabelle 1-6 Textvariable 8 Bit Zeichensatz/Textvariable 16 Bit Zeichensatz

Datenbereich Adressierung AdressstringDB Byte DB1,DBB0Merker Byte MB0Eingang Byte EB0Ausgang Byte AB0DB Wort DB1,DBW0Merker Wort MW0Eingang Wort EW0Ausgang Wort AW0Zähler Wort Z0Zeiten Wort T0

Tabelle 1-7 Rohdatentyp

Datenbereich Adressierung AdressstringDB Byte RAW_BSEND(DB1,DBB0)Merker Byte RAW_BSEND(MB0)Eingang Byte RAW_BSEND(EB0)Ausgang Byte RAW_BSEND(AB0)DB Wort RAW_BSEND(DB1,DBW0)Merker Wort RAW_BSEND(MW0)Eingang Wort RAW_BSEND(EW0)Ausgang Wort RAW_BSEND(AW0)DB Doppelwort RAW_BSEND(DB1,DD0)Merker Doppelwort RAW_BSEND(MD0)Eingang Doppelwort RAW_BSEND(ED0)Ausgang Doppelwort RAW_BSEND(AD0)

1.8.7.9 Packages

Einleitung Sie können im Configuration Tool auch mit aus Packages geladenen Variablen arbeiten. Dazu erstellen Sie ein neues WinCC Projekt im WinCC Explorer (Mehrplatz-Projekt) und laden die gewünschten Packages. Lesen Sie dieses WinCC Projekt mit dem Configuration Tool aus. Jetzt werden Ihnen die in den Packages vorhandenen Variablen im Variablendialog zur Auswahl angeboten.



Erzeugen eines neuen WinCC ProjektsSie können ein neuens WinCC Projekt aus einer Projektmappe erstellen, in welcher Packages verwendet werden. Die verwendeten Packages müssen jedoch nach dem Erstellen des WinCC Projektes (Mehrplatz-Projekt) in dieses geladen werden.



1.9 WinCC Archive ConfigurationTool

1.9.1 Einführung

Einleitung Das WinCC Archive ConfigurationTool ist ein Excel Add-In. Das Tool ermöglicht die einfache und performante Projektierung von Massendaten für die Archivierung von WinCC Prozesswerten.

Dabei ist es möglich, Mengengerüste zu handhaben, für welche der Tag Logging Editor unzureichende Unterstützung bietet.

Arbeiten mit dem WinCC Archive ConfigurationToolDas WinCC Archive ConfigurationTool bietet die Möglichkeit zur Erstellung eines neuen Archivs. Des Weiteren können bestehende Archive ausgelesen und bearbeitet werden. Dabei wird empfohlen, bei umfangreichen Änderungen bereits existierende Daten zu löschen und das komplette Archiv neu anzulegen. Daneben besteht die Möglichkeit, geringfügige Änderungen selektiv ins WinCC Projekt zurückzuschreiben.

Die Projektierung eines Archivs erfolgt innerhalb einer Excelmappe. Diese Excelmappe besteht aus einer Archivtabelle sowie einer oder mehreren Archivvariablentabellen. Die Archivtabelle dient zur Projektierung der allgemeinen Eigenschaften des Archivs. Die Archivvariablentabellen dienen zur Projektierung der Archivvariablen und deren Eigenschaften.

WinCC Archive stellt keinen vollständigen Ersatz für den Tag Logging Editor dar. Die Projektierung der Zeiten sowie der Archivkonfiguration (Tag Logging Fast und Slow) muss weiterhin im Tag Logging Editor durchgeführt werden.

Die Daten werden während der Eingabe nicht geprüft. Es wird jedoch eine Prüfung des kompletten Archivs hinsichtlich verschiedener Aspekte angeboten. Dazu zählen allgemein die Korrektheit der eingestellten Parameter, die Eindeutigkeit der verwendeten Namen sowie die Existenz der eingestellten Objekte (Variablen, Zeiten usw.).

SmartTools1.9 WinCC Archive ConfigurationTool


Gegenüberstellung

Tag Logging Editor WinCC ConfigurationTool WinCC Archive ConfigurationTool

Zweck Standard Projektierungsoberfläche für das Archivsystem.

Komfortable Projektierungsoberfläche für komplette WinCC Projekte.

Performante Projektierungsoberfläche für Archive mit außergewöhnlich großen Mengengerüsten.

Projektierung des Archivsystems

Das Archivsystem ist vollständig projektierbar.

Das Archivsystem ist vollständig pojektierbar bis auf die Archivkonfiguration (TagLogging Fast und Slow).

Es ist jeweils ein Archiv projektierbar.

Empfehlung zum Mengengerüst

Einzusetzen bis ca. 100 - 200 Archivvariablen.

Einzusetzen bis ca. 10.000 - 30.000 Archivvariablen.

Einzusetzen ab ca. 10.000 Archivvariablen.

Dateneingabe Dateneingabe über Eigenschaftsdialoge sowie eingeschränkt nutzbare Tabellenoberfläche.

Dateneingabe in Tabellenform mit umfangreicher Unterstützung (Defaultwerte, Kombinationsfelder, Dialoge, Office Assistent).

Dateneingabe in Tabellenform mit eingeschränkter Unterstützung.

Prüfung der Daten

Daten werden während der Eingabe geprüft.

Daten werden während der Eingabe geprüft.

Daten werden vor dem Schreiben ins WinCC Projekt geprüft. Verschiedene Prüfungen können auch deaktiviert werden.

Erweiterbarkeit Keine. Erweiterbar über VBA Makros.

Erweiterbar über VBA Makros.

Siehe auchSchnelleinstieg (Seite 258)

Systemvoraussetzungen (Seite 257)



1.9.2 Systemvoraussetzungen

Systemvoraussetzungen ● Windows XP SP3

Windows 7 32-Bit und 64-BitWindows Server 2003 (R2) SP2Windows Server 2008 SP2 32-Bit und 64-Bit

● Microsoft Office 2003, Office 2007 und Office 2010. Microsoft Office wird nur mit 32-Bit unterstützt.Visual Basic für Applikationen muss installiert sein.

● Internet Explorer 7, 8 oder 9

Arbeiten ohne WinCCEs besteht die Möglichkeit, das WinCC Archive ConfigurationTool ohne WinCC Installation zu benutzen. Sie können in diesem Fall jedoch keine Daten von WinCC lesen oder nach WinCC schreiben. Die Möglichkeiten zur Projektierung innerhalb von Excel stehen jedoch in vollem Umfang zur Verfügung.

1.9.3 Installation des Archive ConfigurationToolDas WinCC Archive ConfigurationTool kann auf zwei verschieden Arten installiert werden.



Das WinCC Archive ConfigurationTool starten Sie über "SIMATIC > WinCC > Tools".

Alternative VorgehensweiseSie können das WinCC Archive ConfigurationTool auch von der WinCC-DVD installieren.

1. Wechseln Sie auf der WinCC-DVD in das Verzeichnis "WinCC\InstData\ArchiveTool\Setup".


3. Folgen Sie den Anweisungen auf dem Bildschirm.Das WinCC Archive ConfigurationTool wird installiert.



1.9.4 Schnelleinstieg

Einleitung Diese Beschreibung bietet einen Schnelleinstieg in den Umgang mit dem Excel Add-In WinCC Archive. Die wichtigsten der zur Verfügung stehenden Funktionen werden kurz vorgestellt.

Neues Archiv erstellen



Vorgehen1. Öffnen Sie Excel. Das Excel Add-In WinCC Archive wird automatisch mit gestartet. Im Menü

von Excel finden Sie den Eintrag "WinCC Archive". Wählen Sie aus diesem den Menüpunkt "Neues Archiv".

2. Es wird ein Dialog zur Festlegung der grundlegenden Eigenschaften des neu zu erstellenden Archivs geöffnet. Geben Sie dem Archiv einen Namen. Wählen Sie den gewünschten Typ des Archivs aus. Diese Beschreibung führt durch die Erstellung eines Prozesswertarchivs. Betätigen Sie die Schaltfläche "OK".

3. Es wird eine neue Excelmappe erstellt, welche zur Projektierung des neuen Archivs dient. Die neue Excelmappe enthält die nachfolgend aufgelisteten Tabellen:

– "Archiv": Tabelle zur Festlegung der Eigenschaften des Archivs.

– "Archivvariablen (1)": Tabelle zur Projektierung von binären und analogen Archivvariablen.

– "Archivvariablen (2)": Tabelle zur Projektierung von prozessgesteuerten Archivvariablen.



4. Legen Sie in der Tabelle "Archiv" die Eigenschaften des Archivs fest. Alle Zellen sind frei editierbar. Bei verschiedenen Parametern wird die Eingabe durch ein Kombinationsfeld unterstützt. Klicken Sie beispielsweise doppelt in die Zelle zur Eingabe des Parameters "Archivierung bei Systemstart". Es wird ein Kombinationsfeld mit den für diesen Parameter möglichen Werten angezeigt.



5. Wechseln Sie in die Tabelle "Archivvariablen (1)". In dieser Tabelle können bis zu 65634 binäre und analoge Archivvariablen projektiert werden. Alle Zellen sind frei editierbar. Bei verschiedenen Parametern wird die Eingabe durch ein Kombinationsfeld unterstützt. Ist ein WinCC Projekt geöffnet, steht des weiteren ein Dialog zur Auswahl von WinCC Variablen zur Verfügung. Öffnen Sie diesen Dialog durch Doppelklick im Datenbereich der Spalte "Variable".

6. Der Dialog zur Auswahl von WinCC Variablen bietet die Möglichkeit der Mehrfachselektion. Ist der Dialog geöffnet, kann weiterhin in der Exceltabelle gearbeitet werden. Selektieren Sie im Dialog mehrere Variablen. Selektieren Sie in der Exceltabelle die Zelle, ab der die Namen der selektierten Variablen eingefügt werden sollen. Klicken Sie im Dialog auf die Schaltfläche "Einfügen". Der Dialog bleibt geöffnet. Die Namen der selektierten Variablen sind in die Exceltabelle eingefügt worden. Klicken Sie auf die Schaltfläche "Schließen", um den Dialog zu schließen.



7. Legen Sie in der Spalte "Archivvariable Name" die Namen der neuen Archivvariablen fest. Diese Namen müssen innerhalb des Archivs eindeutig sein. Stellen Sie in der Spalte "Archivvariable Typ" den korrekten Typ der neuen Archivvariablen ein. Bei diesem Parameter wird die Eingabe durch ein Kombinationsfeld unterstützt. Legen Sie die restlichen Eigenschaften der neuen Archivvariablen fest.



8. Während der Eingabe der Daten in die Exceltabelle werden keine Prüfungen durchgeführt. Wählen Sie den Menüpunkt "WinCC Archive" > "Archiv prüfen". Es wird ein Dialog zur Prüfung des gesamten Archivs geöffnet. Die zu prüfenden Archiveigenschaften können eingeschränkt werden. Lassen Sie alle eingestellten Kontrollkästchen aktiviert und betätigen Sie die Schaltfläche "OK".

Hinweis: Sollten Sie in Ihrem WinCC Projekt noch keine Projektierungen im Tag Logging Editor durchgeführt haben, sind die notwendigen Zykluszeiten noch nicht vorhanden. Sie werden zwar im Tag Logging Editor angezeigt, jedoch erst nach einer beliebigen Änderung der Projektierungsdaten in der Datenbank gespeichert. Um den Tag Logging Editor dazu zu veranlassen, die Zykluszeiten zu speichern, können Sie beispielsweise die Zykluszeit "500 ms" in "_500 ms" umbenennen und das Projekt speichern. Den Namen der Zykluszeit können Sie daraufhin natürlich wieder auf den ursprünglichen Wert setzen.



9. Das Prüfergebnis wird angezeigt. Sind Fehler gefunden worden, werden Sie gefragt, ob eine Liste der Fehler angezeigt werden soll. Bestätigen Sie diese Frage mit "Ja". Es wird ein Dialog geöffnet, der eine Liste der fehlerhaften Objekte mit der jeweiligen Fehlerursache enthält. Durch Doppelklicken auf einen Eintrag in der Liste kann direkt zum fehlerhaften Objekt in der Exceltabelle gesprungen und der Fehler behoben werden. In der Spalte "Fehlertext" des entsprechenden Objekts wird ebenfalls die Fehlerursache angezeigt. Die angezeigte Fehlerursache hat den folgenden Aufbau: "Spalte : Fehler". Beheben Sie alle gefundenen Fehler und führen Sie die Prüfung erneut durch.

10.Wählen Sie den Menüpunkt "WinCC Archive->Archiv erzeugen". Es wird ein Dialog zur Erzeugung des gesamten Archivs geöffnet. Betätigen Sie die Schaltfläche "OK". Existiert bereits ein Archiv mit dem Namen des neu zu erstellenden Archivs, muss dieses gelöscht werden. Aus diesem Grund wird eine entsprechende Abfrage angezeigt. Diese ist mit "OK" zu bestätigen. Das Archiv wird im WinCC Projekt erzeugt. Schließen Sie die Excelmappe.



11.Das neu erzeugte Archiv kann nicht mit dem Tag Logging Editor geöffnet werden. Die einzige Möglichkeit, um das Archiv bearbeiten zu können, besteht darin, es wieder in eine Exceltabelle einzulesen. Wählen Sie den Menüpunkt "WinCC Archive->Archiv lesen". Es wird ein Dialog geöffnet, in welchem alle im WinCC Projekt vorhandenen Archive aufgelistet sind. Selektieren Sie das zu Lesende Archiv und betätigen Sie die Schaltfläche "OK". Es wird eine neue Excelmappe erstellt. In diese werden die Daten des ausgewählten Archivs eingelesen.

12.Die Eigenschaften des Archivs oder die Eigenschaften einzelner Archivvariablen können jetzt geändert werden. Die durchgeführten Änderungen können selektiv ins WinCC Projekt übertragen werden. Markieren Sie dazu die geänderten Objekte. Öffnen Sie über die rechte Maustaste das Kontextmenü und betätigen Sie den Menüpunkt "WinCC - Selektion schreiben". Vor dem Schreiben von Archivvariablen wird ein Dialog zur Festlegung der Prüfkriterien geöffnet. Bestätigen Sie diesen Dialog mit "OK".



1.9.5 Bedienung von WinCC Archive

1.9.5.1 Bedienung von WinCC Archive

EinleitungIn diesem Abschnitt werden alle Aspekte der Bedienung von WinCC Archive im Detail beschrieben.



Siehe auchErzeugen, Ändern und Löschen (Seite 307)

Prüfen der Archivdaten (Seite 300)

Projektieren eines Verdichtungsarchivs (Seite 292)

Projektieren eines Prozesswertarchivs (Seite 274)

Anlegen einer Archivmappe (Seite 267)

1.9.5.2 Anlegen einer Archivmappe

Anlegen einer Archivmappe

Einleitung In diesem Abschnitt werden allgemeine Vorgehensweisen zur Erstellung und Handhabung von Archivmappen beschrieben. Als Archivmappe wird eine Excelmappe bezeichnet, welche von WinCC Archive erzeugt wird. Eine Archivmappe dient zur Projektierung der Eigenschaften eines Archivs und der dazu gehörenden Archivvariablen.

Siehe auchSo fügen Sie eine neue Tabelle hinzu (Seite 272)

So lesen Sie ein existierendes Archiv aus (Seite 270)

So legen Sie eine neue Archivmappe an (Seite 267)

So legen Sie eine neue Archivmappe an

Einleitung Diese Beschreibung erläutert die Vorgehensweise beim Anlegen einer neuen Archivmappe.



Vorgehensweise1. Öffnen Sie Excel. Das Excel Add-In WinCC Archive wird automatisch mit gestartet. Im Menü

von Excel finden Sie den Eintrag "WinCC Archive". Wählen Sie aus diesem den Menüpunkt "Neues Archiv".

2. Es wird ein Dialog zur Festlegung der grundlegenden Eigenschaften des neu zu erstellenden Archivs geöffnet. Geben Sie dem Archiv einen Namen. Wählen Sie den gewünschten Typ des Archivs aus.Sie können mit WinCC Archive zwei verschieden Typen von Archiven projektieren. Es handelt sich dabei um Prozesswertarchive und Verdichtungsarchive. Abhängig vom gewählten Archivtyp wird eine entsprechende Archivmappe erstellt. Archivmappen für Prozesswertarchive und Archivmappen für Verdichtungsarchive unterscheiden sich im Aufbau der enthaltenen Tabellen.



3. Betätigen Sie die Schaltfläche "OK".

4. Es wird eine neue Excelmappe erstellt, welche zur Projektierung des gewünschten Archivtyps dient.Eine Archivmappe enthält standardmäßig eine Tabelle mit der Bezeichnung "Archiv". In dieser werden die Eigenschaften des Archivs festgelegt. Das Festlegen der Eigenschaften des Archivs erfolgt in der ersten Zeile des Datenbereichs der Tabelle (Zeile 3).Eine Archivmappe enthält mindestens eine Tabelle mit der Bezeichnung "Archivvariablen" und einer fortlaufenden Nummer. Diese Tabellen dienen zur Projektierung der zum Archiv gehörenden Archivvariablen. Zur Projektierung der Archivvariablen kann der gesamte Datenbereich der Tabelle genutzt werden (ab der dritten Zeile). Es besteht die Möglichkeit, zur Archivmappe weitere Archivvariablentabellen hinzuzufügen.

Hinweis

Microsoft Excel interpretiert Texte, die mit speziellen Sonderzeichen beginnen oder diese enthalten, als Formel. Dies kann Probleme beim Arbeiten mit dem Configuration Tool verursachen.

Diese Sonderzeichen sind "=", "+" und "-". Diese Zeichen sollten daher nicht als Teil von Objektnamen (Gruppennamen, Variablennamen, Texten usw.) verwendet werden.


So lesen Sie ein existierendes Archiv aus (Seite 270)



So lesen Sie ein existierendes Archiv aus

Einleitung Diese Beschreibung erläutert die Vorgehensweise beim Lesen eines Archivs aus einem WinCC Projekt.




von Excel finden Sie den Eintrag "WinCC Archive". Wählen Sie aus diesem den Menüpunkt "Archiv lesen".

2. Es wird ein Dialog geöffnet, in welchem alle im WinCC Projekt vorhandenen Archive aufgelistet sind. Selektieren Sie das zu Lesende Archiv und betätigen Sie die Schaltfläche "OK".

3. Es wird eine neue Archivmappe erstellt. In diese werden die Daten des ausgewählten Archivs eingelesen. Der Typ der erzeugten Archivmappe hängt vom Typ des auszulesenden Archivs ab. Sie können mit WinCC Archive Prozesswertarchive und Verdichtungsarchive bearbeiten.Die Archivmappe enthält eine Tabelle mit der Bezeichnung "Archiv". Diese enthält die Eigenschaften des Archivs. Des weiteren enthält die Archivmappe mindestens eine Tabelle mit der Bezeichnung "Archivvariablen" und einer fortlaufenden Nummer. Diese Tabellen enthalten die zum Archiv gehörenden Archivvariablen.





So fügen Sie eine neue Tabelle hinzu

Einleitung Diese Beschreibung erläutert die Vorgehensweise beim Hinzufügen einer neuen Tabelle zu einer Archivmappe.



Vorgehensweise1. Öffnen Sie die Archivmappe, der eine neue Tabelle hinzugefügt werden soll. Wählen Sie

den Menüpunkt "WinCC Archive->Neue Tabelle".

2. Es wird ein Dialog geöffnet, in welchem der Typ der neuen Tabelle ausgewählt werden kann. Es stehen die folgenden Typen von Tabellen zur Verfügung.

– Standardtabelle: Normale Exceltabelle.

– Archivtabelle: Tabelle zur Festlegung der Eigenschaften des Archivs. Dieser Typ steht nur zur Auswahl, falls die bereits vorhandene Archivtabelle gelöscht wurde.

– Archivvariablentabelle: Tabelle zur Projektierung von Archivvariablen. Bei Prozesswertarchiven stehen zwei verschiedene Typen von Archivvariablentabellen zur Auswahl. Bei Verdichtungsarchiven steht nur ein Typ zur Auswahl.

Selektieren Sie den gewünschten Typ und betätigen Sie die Schaltfläche "OK".



3. Der Archivmappe wurde eine neue Tabelle hinzugefügt. Diese kann umbenannt werden, falls dies gewünscht ist.

Siehe auchSo lesen Sie ein existierendes Archiv aus (Seite 270)


1.9.5.3 Projektieren eines Prozesswertarchivs

Projektieren eines Prozesswertarchivs

EinleitungIn diesem Abschnitt wird die allgemeine Vorgehensweise bei der Projektierung eines Prozesswertarchivs mit WinCC Archive beschrieben.

Siehe auchSo verwenden Sie den Dialog zur Variablenauswahl (Seite 290)

So projektieren Sie die Archivvariablenparameter (prozessgesteuert) (Seite 286)

So projektieren Sie die Archivvariablenparameter (binär und analog) (Seite 278)

So projektieren Sie die Archivparameter (Seite 275)



So projektieren Sie die Archivparameter

Einleitung Diese Beschreibung führt durch die Projektierung der Archivparameter. Die einzelnen Archivparameter werden im einzelnen erläutert.

Vorgehensweise1. Aktivieren Sie die Archivtabelle. Diese hat standardmäßig den Namen "Archiv". Der Name

der Tabelle kann geändert werden.

2. Die Parameter des Archivs sind in der ersten Zeile des Datenbereichs der Archivtabelle festzulegen. Nur der Inhalt dieser Zeile wird von WinCC Archive ausgewertet.



ArchivparameterIn der folgenden Tabelle sind alle für das Prozesswertarchiv anzugebenden Parameter aufgelistet.

Spalte Liste Parameter Beschreibung1 Archivname Hier ist der Name des Archivs anzugeben.2 Kommentar Hier kann ein Kommentar zum Archiv

eingetragen werden.3 Archivierung bei

SystemstartHier ist festzulegen, ob die Archivierung nach Systemstart "freigegeben" oder "gesperrt" sein soll.

4 Aktion Starten/Freigeben

Hier kann eine Aktion angegeben werden, die beim Starten der Archivierung ausgeführt werden soll.

5 Größe Hier kann die Anzahl der Datensätze des Archivs angegeben werden. Dieser Parameter ist nur für Archive im Hauptspeicher relevant.

6 Speicherort Hier ist der Speicherort des Archivs festzulegen. Es kann zwischen "Festplatte" oder "im Hauptspeicher" gewählt werden.

Im folgenden wird die Bedeutung der in der Spalte Liste verwendeten Symbole beschrieben.

Bei Doppelklick wird ein Kombinationsfeld geöffnet.

Tag Logging EditorIn den folgenden Abbildungen wird der Zusammenhang zwischen der Projektierung mit dem Tag Logging Editor und der Projektierung mit WinCC Archive dargestellt. Zu den im Tag



Logging Editor einzustellenden Parametern werden jeweils die entsprechenden Spalten in WinCC Archive angegeben.

1. Die folgende Abbildung zeigt den Dialog "Eigenschaften Prozesswertarchiv". Die Registerkarte "Allgemein" ist angewählt. Zu jedem Parameter wird die entsprechende Spalte in der Tabellenstruktur von WinCC Archive dargestellt.

2. Die folgende Abbildung zeigt den Dialog "Eigenschaften Prozesswertarchiv". Die Registerkarte "Speicherort" ist angewählt. Zu jedem Parameter wird die entsprechenden Spalte in der Tabellenstruktur von WinCC Archive dargestellt.



Siehe auchSo projektieren Sie die Archivvariablenparameter (prozessgesteuert) (Seite 286)


So projektieren Sie die Archivvariablenparameter (binär und analog)

Einleitung Diese Beschreibung führt durch die Projektierung von binären und analogen Archivvariablen. Die bei binären und analogen Archivvariablen einzustellenden Parameter werden im einzelnen erläutert.



Vorgehensweise1. Aktivieren Sie die Tabelle zur Projektierung der binären und analogen Archivvariablen.

Diese hat standardmäßig den Namen "Archivvariablen (1)". Der Name der Tabelle kann geändert werden. Da sich die Parameter binärer und analoger Archivvariablen sehr ähneln, werden beide innerhalb der gleichen Tabellenstruktur projektiert.

2. Der gesamte Datenbereich der Tabelle steht zur Projektierung der Archivvariablen zur Verfügung. Auf der Tabelle können somit bis zu 65534 Archivvariablen projektiert werden. Falls dies nicht ausreicht, können auch weitere Tabellen hinzugefügt werden.

ArchivvariablenparameterIn der folgenden Tabelle sind alle für binäre und analoge Archivvariablen anzugebenden Parameter aufgelistet.

Spalte Liste Parameter Beschreibung1 Variable Hier ist der Name der zu archivierenden

Variable einzutragen.2 Archivvariable Name Hier ist der Name der Archivvariable

anzugeben. Dieser muss innerhalb des Archivs eindeutig sein.

3 Archivvariable Typ Hier ist der Typ der Archivvariable anzugeben. Es ist abhängig vom Typ der zu archivierenden Variable "analog" oder "binär" einzustellen.

4 Kommentar Hier kann ein Kommentar zur Archivvariable eingetragen werden.

5 Archivierung bei Systemstart

Hier können sie festlegen, ob die Archivierung nach Systemstart "freigegeben" oder "gesperrt" sein soll.

6 Variablenversorgung Hier ist die Art der Variablenversorgung festzulegen. Es kann zwischen vom "System" oder durch "Handeingabe" gewählt werden.



Spalte Liste Parameter Beschreibung7 Erfassungsart Hier ist die Art der Erfassung der

Archivvariable festgelegt. Es kann zwischen "azyklisch", "zyklisch-kontinuierlich", "zyklisch-selektiv" oder "Bei Änderung" gewählt werden.

8 Erfassungszyklus Hier ist der Zyklus anzugeben, in dem der Wert der Variable erfasst werden soll.

9 Archivierungszyklus Hier ist der Zyklus anzugeben, in dem der Wert der Variable archiviert werden soll.

10 Archivierungszyklus Faktor

Hier kann ein Faktor zum Archivierungszyklus angegeben werden. Der Zyklus, in dem der Wert der Variable archiviert werden soll, ergibt sich aus dem Produkt aus "Archivierungszyklus" und "Archivierungszyklus Faktor".

11 Zusätzlich in Variable schreiben

Hier kann der Name einer Variable angegeben werden, in welche der archivierte Wert zusätzlich geschrieben werden soll.

12 Bearbeitung Hier ist anzugeben, wie die erfassten Variablenwerte bearbeitet werden sollen. Es sind die Optionen "Momentanwert", "Mittelwert", "Summe", "Minimalwert", "Maximalwert" und "Aktion" einstellbar.

13 Aktion zur Bearbeitung Hier kann eine Aktion angegeben werden, welche die erfassten Variablenwerte bearbeiten soll. Dafür ist jedoch in der Spalte "Bearbeitung" die Option "Aktion" einzustellen.

14 Einheit Hier kann eine Einheit für die archivierten Variablenwerte angegeben werden.

15 Archivierung bei Änderung

Hier kann festgelegt werden, dass die Archivierung nur erfolgen soll, wenn sich der Variablenwert geändert hat.

16 Hysterese Hier ist die Art der Hysterese festzulegen, wenn "Archivierung bei Änderung" aktiviert ist. Es kann zwischen "absolut" und "prozentual" gewählt werden.

17 Hysterese Wert Hier ist der Zahlenwert der Hysterese festzulegen, wenn "Archivierung bei Änderung" aktiviert ist.

18 Archivierung bei Hier ist anzugeben, wann binäre Archivvariablen archiviert werden sollen. Es sind die Optionen bei "jedem Signalwechsel", "immer", "Signalwechsel 0 ->1" und "Signalwechsel 1 -> 0" einstellbar.

19 Speichern bei Störung Hier ist festzulegen, welcher Wert bei einer Störung archiviert werden soll. Es kann zwischen "letzten Wert" und "Ersatzwert" gewählt werden.



Spalte Liste Parameter Beschreibung20 Anzahl Werte Vorlauf Hier kann die Anzahl der Werte

angegeben werden, die vor dem Archivierungszeitpunkt mitberücksichtigt werden sollen.

21 Anzahl Werte Nachlauf Hier kann die Anzahl der Werte angegeben werden, die nach dem Archivierungszeitpunkt mitberücksichtigt werden sollen.

22 Darstellungsbegrenzung untere Grenze

Hier kann die unter Grenze des Wertebereichs der Archivvariable angegeben werden.

23 Darstellungsbegrenzung obere Grenze

Hier kann die obere Grenze des Wertebereichs der Archivvariable angegeben werden.

24 Start Ereignis Hier kann als Aktion eine Funktion angegeben werden, über welche die Archivierung gestartet werden kann.

25 Start Variable Hier kann als Aktion eine binäre Variable angegeben werden, über welche die Archivierung gestartet werden kann.

26 Stopp Ereignis Hier kann als Aktion eine Funktion angegeben werden, über welche die Archivierung gestoppt werden kann.

27 Stopp Variable Hier kann als Aktion eine binäre Variable angegeben werden, über welche die Archivierung gestoppt werden kann.

28 Langzeitrelevant Hier kann festgelegt werden, ob die Archivvariable auf dem zentralen Archivserver (WinCC CAS) ins Archiv geschrieben wird.

29 Archivieren nach Segmentwechsel

Hier kann festgelegt werden, ob bei einem Segmentwechsel die azyklisch archivierten Archivvariablen archiviert werden.

30 AD Status Hier kann der Status eines Archives angezeigt werden.

31 AE Fehlertext Hier kann ein Fehlertext angegeben werden.



Bei Doppelklick wird ein Kombinationsfeld geöffnet. Es muss jedoch ein WinCC Projekt geöffnet sein.



Bei Doppelklick wird der Variablendialog geöffnet. Es muss jedoch ein WinCC Projekt geöffnet sein.





1. Die folgende Abbildung zeigt den Dialog "Eigenschaften Prozessvariable". Die Registerkarte "Archivvariable" ist angewählt. Zu jedem Parameter wird die entsprechende Spalte in der Tabellenstruktur von WinCC Archive dargestellt.

2. Die folgende Abbildung zeigt die Parameter der Registerkarte "Archivierung". Zu jedem Parameter wird die entsprechende Spalte in der Tabellenstruktur von WinCC Archive dargestellt.





3. Der Aufbau der Registerkarte "Parameter" ist bei binären und analogen Archivvariablen unterschiedlich. Dargestellt ist der Aufbau bei analogen Archivvariablen. Bei binären Archivvariablen sind die Bereiche "Bearbeitung", "Einheit" und "Archivierung bei Änderung" nicht vorhanden. Die entsprechenden Spalten in der Tabellenstruktur von WinCC Archive sind bei binären Archivvariablen leer zu lassen. Bei binären Archivvariablen ist hingegen ein Bereich mit der Bezeichnung "Archivierung bei" vorhanden. Dieser Bereich ist in der Tabellenstruktur von WinCC Archive der Spalte "R" zugeordnet. Diese Spalte ist bei analogen Archivvariablen nicht relevant und bei diesen leer zu lassen.

4. Die folgende Abbildung zeigt die Parameter der Registerkarte "Darstellung". Zu jedem Parameter wird die entsprechende Spalte in der Tabellenstruktur von WinCC Archive dargestellt. Die Registerkarte "Darstellung" ist bei binären Archivvariablen nicht vorhanden. Die entsprechenden Spalten in der Tabellenstruktur von WinCC Archive sind bei binären Archivvariablen leer zu lassen.



Siehe auchSo projektieren Sie die Archivparameter (Seite 275)

So verwenden Sie den Dialog zur Variablenauswahl (Seite 290)

So projektieren Sie die Archivvariablenparameter (prozessgesteuert) (Seite 286)

So projektieren Sie die Archivvariablenparameter (prozessgesteuert)

Einleitung Diese Beschreibung führt durch die Projektierung von prozessgesteuerten Archivvariablen. Die bei prozessgesteuerten Archivvariablen einzustellenden Parameter werden im einzelnen erläutert.



Vorgehensweise1. Aktivieren Sie die Tabelle zur Projektierung der prozessgesteuerten Archivvariablen. Diese

hat standardmäßig den Namen "Archivvariablen (2)". Der Name der Tabelle kann geändert werden.

2. Der gesamte Datenbereich der Tabelle steht zur Projektierung der Archivvariablen zur Verfügung. Auf der Tabelle können somit bis zu 65534 Archivvariablen projektiert werden. Falls dies nicht ausreicht, können auch weitere Tabellen hinzugefügt werden.Bei der Projektierung von prozessgesteuerten Archivvariablen ist die zu verwendende Normier DLL anzugeben. WinCC Archive unterstützt nur die Projektierung von prozessgesteuerten Archivvariablen für die Normier DLL "nrms7pmc.nll".

ArchivvariablenparameterIn der folgenden Tabelle sind alle für prozessgesteuerte Archivvariablen anzugebenden Parameter aufgelistet.

Spalte Liste Parameter Beschreibung11 Variable Hier ist der Name der Rohdatenvariable anzugeben,

über welche die Archivierung durchgeführt wird.2 Archivvariabl

e NameHier ist der Name der Archivvariable anzugeben. Dieser muss innerhalb des Archivs eindeutig sein.


4 Normier DLL Hier ist die zu verwendende Normier DLL einzustellen. Es wird nur die Normier DLL "nrms7pmc.nll" unterstützt.

5 Normier DLL Parameter 1

Bei "nrms7pmc.nll": AR_ID

6 Normier DLL Parameter 2

Bei "nrms7pmc.nll": AR_ID-Subnumber





Bei Doppelklick wird der Variablendialog geöffnet. Es muss jedoch ein WinCC Projekt geöffnet sein.

Prozessgesteuerte Archivvariablen verfügen über einen Parameter "Archivvariable Name". Dieser ist in der Tabellenstruktur von WinCC Archive vorhanden. Des weiteren verfügen prozessgesteuerte Archivvariablen über einen internen Archivvariablennamen. Dieser kann vom Benutzer nicht direkt bearbeitet werden und wurde deshalb auch nicht in die Tabellenstruktur von WinCC Archive übernommen. Der interne Archivvariablenname wird von während dem Übertragen ins WinCC Projekt automatisch vergeben.





1. Die folgende Abbildung zeigt den Dialog "Eigenschaften Prozessgesteuerte Variable". Zu jedem Parameter wird die entsprechende Spalte in der Tabellenstruktur von WinCC Archive dargestellt.

2. Die folgende Abbildung zeigt den Dialog "nrms7pmc.nll". Dieser kann durch das Betätigen der Schaltfläche "Optionen" im Dialog "Eigenschaften Prozessgesteuerte Variable" geöffnet werden. Voraussetzung dafür ist jedoch, dass als "Normierungs-DLL" "nrms7pmc.nll" eingestellt ist (siehe Schritt 1). Zu jedem Parameter wird die entsprechende Spalte in der Tabellenstruktur von WinCC Archive dargestellt.



Siehe auchSo verwenden Sie den Dialog zur Variablenauswahl (Seite 290)



So verwenden Sie den Dialog zur Variablenauswahl

Einleitung Der erste bei der Projektierung einer Archivvariable anzugebende Parameter ist der Name der zu archivierenden WinCC Variable. Die Eingabe dieses Parameters kann wie bei jedem anderen auch direkt in die entsprechende Zelle erfolgen. WinCC Excel bietet des weiteren die Möglichkeit, einen speziellen Dialog zur Variablenauswahl zu verwenden. Dieser bietet alle Variablen des aktuell geöffneten WinCC Projekts zur Auswahl an. Ist kein WinCC Projekt geöffnet, steht der Dialog nicht zur Verfügung.



Vorgehensweise1. Stellen Sie sicher, dass ein WinCC Projekt geöffnet ist. Öffnen oder erstellen Sie eine

Archivmappe zur Projektierung eines Prozesswertarchivs. Aktivieren Sie eine beliebige Archivvariablentabelle. Doppelklicken Sie in eine Zelle des Datenbereichs der Spalte "Variable". Der Dialog zur Variablenauswahl wird geöffnet.

2. Der Dialog zur Variablenauswahl sperrt nicht die Bedienbarkeit von Excel. Das heißt, Sie können Ihre Arbeit in der Archivmappe auch fortsetzen, wenn der Dialog zur Variablenauswahl geöffnet ist.Selektieren Sie die Zelle in der Archivvariablentabelle, in welcher der Name einer WinCC Variable eingefügt werden soll. Selektieren Sie im Dialog zur Variablenauswahl die gewünschte WinCC Variable. Betätigen Sie im Dialog zur Variablenauswahl die Schaltfläche "Einfügen". Der Name der ausgewählten WinCC Variable wird in die Archivvariablentabelle eingefügt. Der Dialog zur Variablenauswahl bleibt weiterhin geöffnet.Das Einfügen einzelner WinCC Variablen können Sie auch durch Doppelklick auf die gewünschte Variable in der Auswahlliste durchführen.

3. Der Dialog zur Variablenauswahl unterstützt Mehrfachselektion. Das heißt, Sie können durch Drücken der Ctrl-Taste oder der Shift-Taste mehrere WinCC Variablen gleichzeitig selektieren.Selektieren Sie die Zelle in der Archivvariablentabelle, ab welcher die Namen der WinCC Variablen eingefügt werden sollen. Selektieren Sie im Dialog zur Variablenauswahl die gewünschten WinCC Variablen. Betätigen Sie im Dialog zur Variablenauswahl die Schaltfläche "Einfügen". Die Namen der ausgewählten WinCC Variablen werden in die Archivvariablentabelle eingefügt. Der Dialog zur Variablenauswahl bleibt weiterhin geöffnet.



4. Die Anzahl der im Dialog zur Variablenauswahl angezeigten WinCC Variablen kann durch Angabe eines Filterkriteriums eingeschränkt werden.Tragen Sie im Eingabefeld "Filter" das gewünschte Filterkriterium ein. Beispielsweise werden bei der Verwendung von "B*" als Filterkriterium nur Variablen angezeigt, deren Name mit dem Buchstaben B beginnen. Betätigen Sie die Schaltfläche zur Übernahme des Filterkriteriums. Es werden nur WinCC Variablen angezeigt, deren Namen mit dem gewählten Filterkriterium übereinstimmen.Stellen Sie als Filterkriterium "*" ein, um wieder die Anzeige aller vorhandenen WinCC Variablen zu erreichen.

5. Betätigen Sie die Schaltfläche "Schließen", um die Arbeit mit dem Dialog zur Variablenauswahl zu beenden.

Siehe auchSo projektieren Sie die Archivvariablenparameter (prozessgesteuert) (Seite 286)


1.9.5.4 Projektieren eines Verdichtungsarchivs

Projektieren eines Verdichtungsarchivs

EinleitungIn diesem Abschnitt wird die allgemeine Vorgehensweise bei der Projektierung eines Verdichtungsarchivs mit WinCC Archive beschrieben.

Siehe auchSo projektieren Sie die Archivvariablenparameter (Seite 296)


So projektieren Sie die Archivparameter

Einleitung Diese Beschreibung führt durch die Projektierung der Archivparameter. Die einzelnen Archivparameter werden im einzelnen erläutert.



Vorgehensweise1. Aktivieren Sie die Archivtabelle. Diese hat standardmäßig den Namen "Archiv". Der Name

der Tabelle kann geändert werden.

2. Die Parameter des Archivs sind in der ersten Zeile des Datenbereichs der Archivtabelle festzulegen. Nur der Inhalt dieser Zeile wird von WinCC Archive ausgewertet.

ArchivparameterIn der folgenden Tabelle sind alle für das Verdichtungsarchiv anzugebenden Parameter aufgelistet.

Spalte Liste Parameter Beschreibung1 Archivname Hier ist der Name des Archivs anzugeben.2 Kommentar Hier kann ein Kommentar zum Archiv

eingetragen werden.



Spalte Liste Parameter Beschreibung3 Archivierung bei

SystemstartHier ist festzulegen, ob die Archivierung nach Systemstart "freigegeben" oder "gesperrt" sein soll.

4 Aktion Starten/Freigeben

Hier kann eine Aktion angegeben werden, die beim Starten der Archivierung ausgeführt werden soll.

5 Bearbeitungsmethode

Hier ist festzulegen, wie die zu verdichtenden Archivvariablen bearbeitet werden sollen. Es kann zwischen den Optionen "Berechnen", "Berechnen und kopieren", "Berechnen und löschen" und "Berechnen, kopieren und löschen" gewählt werden.

6 Verdichtungszeitraum

Hier ist der Zyklus anzugeben, über welchem die Werte der Archivvariablen zu einem Eintrag im Verdichtungsarchiv verdichtet werden sollen.



Bei Doppelklick wird ein Kombinationsfeld geöffnet. Es muss jedoch ein WinCC Projekt geöffnet sein.





1. Die folgende Abbildung zeigt den Dialog "Eigenschaften Verdichtungsarchiv". Die Registerkarte "Allgemein" ist angewählt. Zu jedem Parameter wird die entsprechende Spalte in der Tabellenstruktur von WinCC Archive dargestellt.

2. Die folgende Abbildung zeigt den Dialog "Eigenschaften Verdichtungsarchiv". Die Registerkarte "Verdichtung" ist angewählt. Zu jedem Parameter wird die entsprechenden Spalte in der Tabellenstruktur von WinCC Archive dargestellt.



Siehe auchSo projektieren Sie die Archivvariablenparameter (Seite 296)

So projektieren Sie die Archivvariablenparameter

Einleitung Diese Beschreibung führt durch die Projektierung von Verdichtungsarchivvariablen. Die bei Verdichtungsarchivvariablen einzustellenden Parameter werden im einzelnen erläutert.



Vorgehensweise1. Aktivieren Sie die Tabelle zur Projektierung der Verdichtungsarchivvariablen. Diese hat

standardmäßig den Namen "Archivvariablen (1)". Der Name der Tabelle kann geändert werden.

2. Der gesamte Datenbereich der Tabelle steht zur Projektierung der Archivvariablen zur Verfügung. Auf der Tabelle können somit bis zu 65534 Archivvariablen projektiert werden. Falls dies nicht ausreicht, können auch weitere Tabellen hinzugefügt werden.

ArchivvariablenparameterIn der folgenden Tabelle sind alle für Verdichtungsarchivvariablen anzugebenden Parameter aufgelistet.

Spalte Liste Parameter Beschreibung1 Quellarchiv Hier ist der Name des Archivs anzugeben, in

dem sich die zu verdichtende Archivvariable befindet.

2 Quellarchivvariable

Hier ist der Name der zu verdichtenden Archivvariable anzugeben.

3 Archivvariable Name

Hier ist der Name der Archivvariable anzugeben. Dieser muss innerhalb des Archivs eindeutig sein.


5 Archivierung bei Systemstart

Hier können sie festlegen, ob die Archivierung nach Systemstart "freigegeben" oder "gesperrt" sein soll.

6 Bearbeitung Hier ist anzugeben, wie die zu verdichtenden Archivvariablenwerte bearbeitet werden sollen. Es sind die Optionen "Mittelwert", "Summe", "Minimalwert" und "Maximalwert" einstellbar.

7 Einheit Hier kann eine Einheit für die verdichtenden Archivvariablenwerte angegeben werden









1. Die folgende Abbildung zeigt den Dialog "Eigenschaften Verdichtungsvariable". Die Registerkarte "Archivvariable" ist angewählt. Zu jedem Parameter wird die entsprechende Spalte in der Tabellenstruktur von WinCC Archive dargestellt.

2. Die folgende Abbildung zeigt den Dialog "Eigenschaften Verdichtungsvariable". Die Registerkarte "Parameter" ist angewählt. Zu jedem Parameter wird die entsprechende Spalte in der Tabellenstruktur von WinCC Archive dargestellt.



Siehe auchSo projektieren Sie die Archivparameter (Seite 292)

1.9.5.5 Prüfen der Archivdaten

Prüfen der Archivdaten

Einleitung In diesem Abschnitt wird die Vorgehensweise zum Prüfen der projektierten Daten beschrieben.

WinCC Archive führt während der Projektierung keinerlei Prüfungen der Daten durch. Somit stehen dem Anwender alle Möglichkeiten zur Dateneingabe offen. Vor dem Übertragen eines



Archivs ins WinCC Projekt ist trotzdem zu gewährleisten, dass die Projektierung fehlerfrei ist. Zu diesem Zweck bietet WinCC Archive spezielle Möglichkeiten zur Prüfung der Archivdaten.

Siehe auchFehlerliste (Seite 305)

So verwenden Sie den Fehlerdialog (Seite 303)

So prüfen Sie die Archivdaten (Seite 301)

So prüfen Sie die Archivdaten

Einleitung Diese Beschreibung führt durch die Benutzung der von WinCC Archive zur Verfügung gestellten Möglichkeiten zur Prüfung der Archivdaten.



Vorgehensweise1. Öffnen Sie die zu prüfende Archivmappe. Betätigen Sie den Menüpunkt "WinCC Archive-

>Archiv prüfen". Es wird der Dialog "Archiv prüfen" geöffnet.Der Dialog "Archiv prüfen" bietet die Möglichkeit, die Archivdaten verschiedenen Prüfungen zu unterziehen. Im folgenden werden die zur Auswahl stehenden Prüfungen kurz erläutert.

– Archivparameter prüfen: Es werden die in der Archivtabelle gemachten Einstellungen geprüft. Die Prüfung betrifft nicht die Archivvariablentabellen.

– Archivvariablenparameter prüfen: Es werden die in den Archivvariablentabellen gemachten Einstellungen geprüft. Dabei wird geprüft, ob alle erforderlichen Parameter eingestellt sind und einen korrekt interpretierbaren Wert aufweisen.

– Objektnamen prüfen: Es werden die Namen der Archivvariablen auf Eindeutigkeit innerhalb des Archivs geprüft. Des weiteren wird die Einhaltung der für Archivvariablen geltenden Namenskonvention geprüft.

– Zykluszeiten prüfen: Es wird geprüft, ob die eingestellten Zykluszeiten im WinCC Projekt vorhanden sind. Des weiteren wird geprüft, ob diese einen für die gewünschte Verwendung gültigen Wert besitzen.

– Variablen prüfen: Es wird geprüft, ob die eingestellten Variablen im WinCC Projekt vorhanden sind. Des weiteren wird geprüft, ob diese einen für die gewünschte Verwendung gültigen Datentyp besitzen.

– Archivvariablen prüfen: Diese Prüfung wird für Verdichtungsarchive anstatt der Prüfung "Variablen prüfen" angeboten. Es wird geprüft, ob alle eingestellten Archivvariablen im WinCC Projekt vorhanden sind.

2. Selektieren Sie die gewünschten Prüfungen durch Anwahl der entsprechenden Kontrollkästchen. Standardmäßig sind alle Prüfungen selektiert. Betätigen Sie die Schaltfläche "OK".Die Prüfungen "Zykluszeiten prüfen" und "Variablen prüfen" (oder "Archivvariablen prüfen") können nur durchgeführt werden, wenn ein WinCC Projekt geöffnet ist. Eine entsprechende Meldung macht Sie bei einer Fehleingabe auf diesen Umstand aufmerksam.



3. Die gewählten Prüfungen werden nacheinander ausgeführt. Eine Prüfung wird nur durchgeführt, wenn die vorhergehenden Prüfungen erfolgreich absolviert wurden und keine Fehler gefunden wurden. Jedes geprüfte und als fehlerfreie befundene Objekt wird in der Spalte "Fehlertext" durch den Text "OK" gekennzeichnet. Jedes fehlerhafte Objekt wird in der Spalte "Status" durch den Wert "1" gekennzeichnet. In der Spalte "Fehlertext" wird der gefundene Fehler näher beschrieben.Werden bei einer Prüfung Fehler gefunden, wird dies durch eine entsprechende Meldung angezeigt. Es wird die Möglichkeit geboten, eine Liste aller aufgetretenen Fehler zu öffnen. Dies ist vor allem bei großen Archiven von Vorteil.

4. Beheben Sie alle gefundenen Fehler und führen Sie die Prüfung erneut durch. Dies ist so lange zu wiederholen, bis keine Fehler mehr gefunden werden. In diesem Fall wird die folgende Meldung angezeigt.


So verwenden Sie den Fehlerdialog (Seite 303)

So verwenden Sie den Fehlerdialog

Einleitung WinCC Archive stellt Ihnen ein Hilfsmittel zur Verfügung, um eine Übersicht über alle bei der Prüfung der Archivdaten aufgetretenen Fehler zu erhalten. Es handelt sich dabei um den Fehlerdialog. Diese Beschreibung führt durch die Benutzung des Fehlerdialogs.



Vorgehensweise1. Nach der Prüfung der Archivdaten wird eine Meldung angezeigt. Diese gibt Auskunft über

das Ergebnis der Prüfung. Wurden Fehler gefunden, wird die nachfolgend abgebildete Meldung angezeigt. Betätigen Sie die Schaltfläche "Ja", um den Fehlerdialog zu öffnen.

2. Der Fehlerdialog wird geöffnet. Der Fehlerdialog enthält eine Liste aller fehlerhaften Objekte. In der Liste wird für jedes Objekt dessen Name, der Name der zugehörigen Tabelle und die zugehörige Zeilennummer sowie der Fehlertext angezeigt.

3. Durch Doppelklick auf einen Eintrag in der Liste kann direkt zum fehlerhaften Objekt gesprungen werden. Das Objekt wird in der Exceltabelle markiert, der Fehler kann behoben werden. Der Fehlerdialog muss dazu nicht geschlossen werden. Während der Fehlerdialog geöffnet ist, kann in der Exceltabelle weitergearbeitet werden.

4. Wurde der Fehlerdialog geschlossen, kann er durch Doppelklick in die Spalte "Status" oder die Spalte "Fehlertext" wieder geöffnet werden. Dies gilt jedoch nur für den Fall, dass in der Archivmappe Fehler vorhanden sind.





Fehlerliste

Einleitung Dieser Abschnitt enthält eine Liste aller Fehler, die beim Prüfen der Archivdaten auftreten können. Sie finden zu jedem Fehler eine Beschreibung und eine Anleitung zu dessen Behebung.

Die Spalte StatusDie Spalte Status kann die im folgenden aufgelisteten Inhalte haben.

Status Beschreibung1 Die Zelle ist leer. Das in dieser Zeile enthaltene Objekt wurde noch

nicht geprüft oder die durchgeführten Prüfungen kamen zu einem erfolgreichen Ergebnis.

3 1 Die Zelle enthält den Wert 1. Das in dieser Zeile enthaltene Objekt wurde geprüft. Es wurde ein Fehler festgestellt.

Die Spalte Status dient dazu, fehlerhafte Objekte schneller auffinden zu können. Selektieren Sie z.B. eine beliebige Zelle innerhalb der Spalte Status. Betätigen Sie die Taste "Ende". Betätigen Sie daraufhin eine der Cursortasten nach oben oder nach unten. Die Selektion springt zur nächsten Zelle mit dem Inhalt 1, also zum nächsten fehlerhaften Objekt.

Die Spalte FehlertextDie Spalte Fehlertext kann die im folgenden aufgelisteten Inhalte haben.

Fehlertext Beschreibung1 Die Zelle ist leer. Das in dieser Zeile enthaltene Objekt wurde noch

nicht geprüft. Archivvariablen werden nur geprüft, wenn eine zu archivierende Variable (oder bei Verdichtungsarchiven eine Archivvariable) angegeben ist.

2 OK Die Zelle enthält den Text "OK". Das in dieser Zeile enthaltene Objekt wurde geprüft. Die durchgeführten Prüfungen kamen zu einem positiven Ergebnis.

3 Bearbeitung : Unbekannter Wert.

Die Zelle enthält einen Fehlertext. Das in dieser Zeile enthaltene Objekt wurde geprüft. Es wurde ein Fehler festgestellt. Der Fehlertext enthält zum einen die Bezeichnung der Spalte, welche die Fehlerquelle enthält, zum anderen eine nähere Beschreibung des aufgetretenen Fehlers.



Fehlerliste

Fehler Beschreibung1 Unbekannter Fehler Es ist ein Fehler aufgetreten, der nicht näher eingegrenzt werden

konnte.2 Falscher Datentyp Für diesen Parameter wird ein anderen Datentyp erwartet. Es wurde

z.B. ein Text angegeben, es wird jedoch ein Zahlenwert erwartet.3 Der Text ist zu lang Die Länge des angegebenen Textes überschreitet den für diesen

Parameter zulässigen Wert.4 Wert liegt außerhalb der

erlaubten GrenzenDer angegebene Zahlenwert liegt außerhalb des für diesen Parameter zulässigen Wertebereichs.

5 Ungültiges Verhältnis der Zykluszeiten

Das Verhältnis zwischen Erfassungszyklus und Archivierungszyklus ist nicht korrekt. Der Archivierungszyklus muss ein ganzzahliges Vielfaches des Erfassungszyklus sein.

6 Keine Zykluszeit angegeben

Für diesen Parameter ist die Angabe einer Zykluszeit erforderlich.

7 Unbekannter Wert Der angegebene Text entspricht keiner der für diesen Parameter zur Auswahl stehenden Optionen. Die Eingabe des Parameters wird durch ein Kombinationsfeld unterstützt.

8 Variable wurde nicht gefunden

Die angegebene Variable wurde im WinCC Projekt nicht gefunden.

9 Zykluszeit wurde nicht gefunden

Die angegebene Zykluszeit wurde im WinCC Projekt nicht gefunden.

10 Variable ist nicht analog Für diesen Parameter ist die Angabe einer analogen Variable erforderlich. Dies ist z.B. für den Parameter Variable der Fall, wenn als Typ der Archivvariable analog eingestellt ist.

11 Variable ist nicht binär Für diesen Parameter ist die Angabe einer binären Variable erforderlich. Dies ist z.B. für den Parameter Variable der Fall, wenn als Typ der Archivvariable binär eingestellt ist.

12 Ungültiger Name Der Name des Objekts entspricht nicht den erforderlichen Konventionen. Er kann z.B. ungültige Sonderzeichen enthalten.

13 Name ist nicht eindeutig Der Name des Objekts ist nicht eindeutig. Er wird innerhalb des Archivs mehrmals verwendet.

14 Kein Name angegeben Dem Objekt wurde kein Name gegeben.15 Keine Rohdatenvariable Für diesen Parameter ist die Angabe einer Rohdatenvariable

erforderlich. Dies ist für den Parameter Variable bei prozessgesteuerten Archivvariablen der Fall.

16 Parametrierung bereits in Verwendung

Die Parametrierung dieser prozessgesteuerten Archivvariable ist bereits in Verwendung. Diese muss jedoch innerhalb des Archivs eindeutig sein. Aus der Parametrierung wird der interne Archivvariablenname erzeugt.

17 Ungültige Quelle Die Angabe der Quelle der Verdichtungsarchivvariable ist nicht korrekt. Sie fehlt z.B. ganz oder teilweise.

18 Quelle existiert nicht Die angegebene Quelle der Verdichtungsarchivvariable wurde im WinCC Projekt nicht gefunden. Als Quellarchiv darf nicht das eigene Archiv angegeben werden.

19 Zeitwert unter einer Minute

Als Verdichtungszeitraum ist eine Zykluszeit größer oder gleich eine Minute einzustellen.



Siehe auchSo verwenden Sie den Fehlerdialog (Seite 303)


1.9.5.6 Erzeugen, Ändern und Löschen

Erzeugen, Ändern und Löschen

EinleitungIn diesem Abschnitt werden allgemeine Vorgehensweisen zum Erzeugen, Ändern und Löschen gesamter Archive sowie einzelner Archivvariablen beschrieben.

Siehe auchSo löschen Sie beliebige Archive (Seite 309)

So löschen Sie einzelne Archivvariablen (Seite 313)

So erzeugen und ändern Sie einzelne Archivvariablen (Seite 311)

So erzeugen Sie das gesamte Archiv (Seite 307)

So erzeugen Sie das gesamte Archiv

Einleitung Diese Beschreibung erläutert die Vorgehensweise zum Erzeugen des in einer Archivmappe projektierten Archivs. Über die beschriebene Möglichkeit lassen sich nur vollständige Archive erzeugen. Falls das entsprechende Archiv bereits vorhanden ist, wird es gelöscht.

Prüfen der ArchivdatenDie projektierten Daten sollten vor dem Erzeugen bereits allen zur Verfügung stehenden Prüfungen unterzogen worden sein. Es ist prinzipiell auch möglich, die Prüfungen erst während des Erzeugens des Archivs durchzuführen. Dabei werden alle fehlerfreien Objekte erzeugt, alle fehlerhaften Objekte jedoch nicht. Nach dem Beheben der gefundenen Fehler kann das gesamte Archiv erneut erzeugt werden (alle bereits vorhandenen Objekte werden zuvor wieder gelöscht). Des weiteren besteht die Möglichkeit, die fehlerhaften Objekte selektiv zu erzeugen. Im Gegensatz zur Prüfung der Daten vor dem Erzeugen erfordern jedoch beide beschriebenen Möglichkeiten einen höheren Zeitaufwand.



Vorgehensweise1. Öffnen Sie die Archivmappe, welche das zu erzeugende Archiv enthält. Die projektierten

Daten sollten zuvor bereits geprüft worden sein. Betätigen Sie den Menüpunkt "WinCC Archive->Archiv erzeugen". Es wird der Dialog "Archiv erzeugen" geöffnet.Der Dialog "Archiv erzeugen" zeigt alle Prüfungen, die während dem Erzeugen des Archivs durchgeführt werden. Der Großteil der Prüfungen wird immer durchgeführt und kann nicht deaktiviert werden. Es handelt sich dabei um alle Prüfungen, die mit einem vergleichsweise geringen Zeitaufwand verbunden sind.Das Prüfen der Variablen, bei Verdichtungsarchiven das Prüfen der Archivvariablen, kann deaktiviert werden. Diese Prüfungen können bei großen WinCC Projekten mit einem erhöhten Zeitaufwand verbunden sein. Wurde die Prüfung bereits vor dem Erzeugen des Archivs durchgeführt, ist diese während des Schreibens nicht mehr zwingend erforderlich. Sie kann in diesem Fall deaktiviert werden.

2. Führen Sie die gewünschte Einstellung im Dialog durch. Betätigen Sie die Schaltfläche "OK".



3. Vor dem Erzeugen des Archivs wird eine Meldung angezeigt. Diese macht darauf aufmerksam, dass das Archiv gelöscht wird, falls es bereits existiert. Betätigen Sie die Schaltfläche "OK", um das Archiv zu erzeugen.

4. Das Archiv wird erzeugt. Die Archivvariablen werden in Blöcken zu je 256 Objekten ins WinCC Projekt geschrieben. Ist der Vorgang des Erzeugens abgeschlossen, wird eine Meldung angezeigt. Diese gibt Auskunft darüber, ob Fehler aufgetreten sind oder nicht. Falls Fehler aufgetreten sind, kann der Fehlerdialog zum Auffinden der fehlerhaften Objekte eingesetzt werden.




So löschen Sie beliebige Archive

Einleitung Diese Beschreibung erläutert die Vorgehensweise beim Löschen eines beliebigen Archivs aus einem WinCC Projekt.




von Excel finden Sie den Eintrag "WinCC Archive". Wählen Sie aus diesem den Menüpunkt "Archiv löschen".

2. Es wird ein Dialog geöffnet, in welchem alle im WinCC Projekt vorhandenen Archive aufgelistet sind. Selektieren Sie das zu löschende Archiv und betätigen Sie die Schaltfläche "Löschen". Das Archiv wird aus dem WinCC Projekt gelöscht. Der Dialog bleibt geöffnet. Betätigen Sie die Schaltfläche "Schließen", um den Dialog zu schließen.

Siehe auchSo löschen Sie einzelne Archivvariablen (Seite 313)





So erzeugen und ändern Sie einzelne Archivvariablen

Einleitung Diese Beschreibung erläutert die Vorgehensweise zum Hinzufügen einzelner Archivvariablen zu einem bestehenden Archiv sowie die Vorgehensweise zum Ändern bereits existierender Archivvariablen.

Vorgehensweise1. Öffnen Sie die Archivmappe, welche das zu bearbeitende Archiv enthält. Sie können das

zu bearbeitende Archiv auch über den Menüpunkt "WinCC Archive -> Archiv lesen" aus dem WinCC Projekt einlesen.

2. Führen Sie die gewünschten Änderungen am Archiv durch. Fügen Sie neue Archivvariablen hinzu oder ändern Sie bereits existierende Archivvariablen. Selektieren Sie die neu hinzugefügten oder geänderten Objekte. Öffnen Sie das Kontextmenü und wählen Sie den Menüpunkt "WinCC - Selektion schreiben".



3. Es wird der Dialog "Archivvariablen schreiben" geöffnet. Der Dialog zeigt alle Prüfungen, die während dem Schreiben der Archivvariablen durchgeführt werden. Der Großteil der Prüfungen wird immer durchgeführt und kann nicht deaktiviert werden. Es handelt sich dabei um alle Prüfungen, die mit einem vergleichsweise geringen Zeitaufwand verbunden sind.Das Prüfen der Variablen, bei Verdichtungsarchivvariablen das Prüfen der Archivvariablen, kann deaktiviert werden. Diese Prüfungen können bei großen WinCC Projekten mit einem erhöhten Zeitaufwand verbunden sein. Wurde die Prüfung bereits zuvor durchgeführt, ist diese während des Schreibens nicht mehr zwingend erforderlich. Sie kann in diesem Fall deaktiviert werden.

4. Führen Sie die gewünschte Einstellung im Dialog durch. Betätigen Sie die Schaltfläche "OK".

5. Die Archivvariablen werden geschrieben. Ist der Vorgang des Schreibens abgeschlossen, wird eine Meldung angezeigt. Diese gibt Auskunft darüber, ob Fehler aufgetreten sind oder nicht. Falls Fehler aufgetreten sind, kann der Fehlerdialog zum Auffinden der fehlerhaften Objekte eingesetzt werden.






So löschen Sie einzelne Archivvariablen

Einleitung Diese Beschreibung erläutert die Vorgehensweise zum Löschen einzelner Archivvariablen aus einem bestehenden Archiv.

Vorgehensweise1. Öffnen Sie die Archivmappe, welche das zu bearbeitende Archiv enthält. Sie können das

zu bearbeitende Archiv auch über den Menüpunkt "WinCC Archive -> Archiv lesen" aus dem WinCC Projekt einlesen.

2. Selektieren Sie die zu löschenden Archivvariablen. Öffnen Sie das Kontextmenü und wählen Sie den Menüpunkt "WinCC - Selektion löschen".



3. Die Archivvariablen werden gelöscht. Ist der Vorgang des Löschens abgeschlossen, wird eine Meldung angezeigt.

4. Die aus dem WinCC Projekt gelöschten Archivvariablen werden nicht aus der Exceltabelle gelöscht. Um die Archivvariablen aus der Exceltabelle zu löschen, drücken Sie die Taste "Entf" oder Öffnen das Kontextmenü und Wählen den Menüpunkt "Inhalte löschen".

Siehe auchSo erzeugen und ändern Sie einzelne Archivvariablen (Seite 311)

So löschen Sie beliebige Archive (Seite 309)




User Archive 22.1 Einführung User Archive/Anwenderarchive

Einleitung In Anwenderarchiven können Sie Daten zusammenfassen, die sich aus der Produktion oder Maschinenparametrierung ergeben. Die Datensätze werden zwischen Anwenderarchiv und Automatisierungssystem kontinuierlich oder bei Bedarf übertragen.

Mit dem Editor "User Archive" legen Sie die Struktur des Anwenderarchivs fest. Sie können Sichten projektieren, um Daten aus verschiedenen Anwenderarchiven zu verbinden.

Einsatz von AnwenderarchivenFür folgende Fälle bietet sich der Einsatz von Anwenderarchiven an:

● Das Anwenderarchiv schickt online per Knopfdruck geänderte Rezepturen bzw. Fertigungsparameter an das Automatisierungssystem.

● Die Chargendaten oder Daten zur Produktqualität werden kontinuierlich im Anwenderarchiv erfasst, um über die lückenlose Aufzeichnung gesetzliche Nachweispflichten zu erfüllen.

● Die Betriebsdaten des Automatisierungssystems werden über das Anwenderarchiv analysiert.

● Produktionsdaten, die in einer externen Datenbank gespeichert sind, können Sie in Runtime über eine CSV-Datei in das Anwenderarchiv importieren und dann an das Automatisierungssystem übertragen.

● Die Daten des Anwenderarchivs werden mit SQL selektiert, um eine Auswahl in einer Sicht darzustellen.

● Die Daten des Anwenderarchivs werden als Sollkurven in einem WinCC FunctionTrendControl dargestellt, um Sollwerte mit Werten aus dem Prozesswertarchiv zu vergleichen.

Anwenderarchiv projektierenNachdem Sie die Struktur des Anwenderarchivs festgelegt haben, projektieren Sie im Editor "User Archive" das Anwenderarchiv:

● Sie erstellen und bearbeiten das Anwenderarchiv und die zugehörigen Datenfelder.

● Sie konfigurieren die Kommunikation und die Steuerung zwischen Archiv und Automatisierungssystem.

● Sie geben neue Datensätze ein oder importieren die Werte aus einer CSV-Datei. Ändern Sie gegebenenfalls vorhandene Runtime-Daten.

● Wenn Sie Anwenderarchive zusammenfassen wollen, projektieren Sie eine Sicht.


Alternativ verwenden Sie User Archive Skripte, um Anwenderarchive zu projektieren und zu konfigurieren oder in Runtime zu bedienen.

Runtime-Daten aus Anwenderarchiven anzeigen und ändernIn einem Prozessbild zeigt das WinCC UserArchiveControl die Daten des Anwenderarchivs oder der Sicht in einer Tabelle an. Sie projektieren das UserArchiveControl im Editor "Graphics Designer". Sie können im UserArchiveControl die Daten ändern bzw. neue Datensätze anlegen, die dann in das Anwenderarchiv übernommen werden.

Hinweis

Vor WinCC V7 wurde die Darstellung der Anwenderarchive in einem User Archives Table Element projektiert.

Siehe auchWinCC UserArchiveControl (Seite 412)

So erstellen Sie ein Anwenderarchiv (Seite 319)

User Archive2.1 Einführung User Archive/Anwenderarchive


2.2 User Archive und Redundanz

Einleitung Anwenderarchive können Sie über WinCC Redundancy in ein redundantes System einbinden. Durch den parallelen Betrieb zweier Server werden beim Ausfall eines Servers die Daten der Anwenderarchive online abgeglichen. Informieren Sie sich im WinCC Information System über die Funktionsweise und Projektierung von WinCC Redundancy bezüglich Anwenderarchive in den Kapiteln zu "Redundante Systeme".

Voraussetzungen bei der Verwendung redundanter Anwenderarchive● Die Anwenderarchive werden nur abgeglichen, wenn WinCC-Komponenten verwendet

werden, z.B. Funktionen der UA-API, Steuervariablen, WinCC UserArchivControl. Die Anwenderarchive werden nicht abgeglichen, wenn auf die Datenbank über ODBC und mit dem Connectivity Pack zugegriffen wird.

● Für die abzugleichenden Anwenderarchive wird die gleiche Struktur auf beiden Servern vorausgesetzt. Die Projektierung der Anwenderarchive und der Eigenschaften muss deshalb identisch sein. Das gewährleisten Sie über das Exportieren und Importieren der Konfigurationsdaten.

● Für den Online-Abgleich muss die Archiveigenschaft "Feld - Letzter Zugriff" aktiviert sein. Sie aktivieren die Option im User Archive auf der Registerkarte "Rechte und Flags" im Dialog "Eigenschaften" des Archivs.

● Bei einer Kommunikation der Anwenderarchive über Rohdatenvariablen muss der Name der verwendeten Rohdatenvariablen auf beiden Servern identisch sein.

● Das Speichern von Projektierungsänderungen während Runtime ist nur möglich, wenn in den Anwenderarchiven momentan kein Redundanzabgleich stattfindet.

User Archive2.2 User Archive und Redundanz


2.3 Arbeiten mit dem Editor "User Archive"

2.3.1 Aufbau des Editors "User Archive"

Einleitung Über die Bedienoberfläche im Editor "User Archive" erstellen Sie Anwenderarchive oder Sichten. Im Tabellenfenster des Editors können Sie die Felder des Archivs mit Daten versorgen.

Die Bedienoberfläche von User ArchiveDie Arbeitsumgebung des Editors "User Archive" teilt sich in drei Bereiche auf:

① Navigationsfenster② Datenfenster③ Tabellenfenster

User Archive2.3 Arbeiten mit dem Editor "User Archive"


● Im Navigationsfenster wählen Sie eines der projektierten Archive oder Sicht aus, um neue Felder anzulegen oder zu bearbeiten.

● Im Datenfenster werden die Eigenschaften und Felder des im Navigationsfenster ausgewählten Archivs und Sicht angezeigt. Nur im Datenfenster stehen die Menü-Funktionen "Ausschneiden", "Kopieren" und "Einfügen" zur Verfügung. Jeweils ein Anwenderarchiv, Feld oder Sicht können Sie ausschneiden, kopieren oder einfügen. Die Runtime-Daten dürfen dabei nicht aktiviert sein.

● Im Tabellenfenster werden die Runtime-Daten des ausgewählten Anwenderarchivs bzw. Sicht angezeigt. Wählen Sie dafür das Menü "Bearbeiten/Runtime Daten" oder klicken Sie auf in der Symbolleiste. Hier können Sie auch die Daten in den Feldern des ausgewählten Archivs bearbeiten.

Hinweis

Wenn nach dem Start des Editors alle Felder der Symbolleiste, außer "Wiederherstellen", gegraut sind, müssen Sie im Projektpfad die Datei "UAEditor.loc" löschen. Das gilt auch für ein nicht mehr bedienbares WinCC UserArchiveControl.

2.3.2 Projektierung eines Anwenderarchivs

2.3.2.1 So erstellen Sie ein Anwenderarchiv

Einleitung Ein Wizard führt Sie durch die Projektierung von Anwenderarchiven. Mit der Option "Archive in Schleife anlegen" des Editors können Sie mehrere Anwenderarchive nacheinander erstellen.

Vorgehensweise1. Starten Sie mit Doppelklick den User Archive im WinCC Explorer.

2. Klicken Sie mit der rechten Maustaste auf "Archive" und wählen Sie "Neues Archiv". Der Wizard wird mit dem Dialog "Allgemein" gestartet.

3. Geben Sie einen Archivnamen ein. Wenn Sie ein Alias angeben, wird in Runtime das Alias verwendet. Über die Schaltfläche "Text Lib..." ordnen Sie über die Text Library ein Text für das Alias zu. Dadurch wird bei einer Sprachumschaltung in Runtime der Text der entsprechenden Sprache verwendet.

4. Wählen Sie den Archivtyp aus. Mit der Option "Begrenzt" können Sie die maximale Anzahl von Datensätzen des Anwenderarchivs festlegen.

5. Klicken Sie auf "Weiter", um die Kommunikation mit Variablen, die Steuervariablen und die Rechte des Anwenderarchivs zu projektieren.



6. Wenn Sie mehrere Anwenderarchive erstellt haben, können Sie im Dialog "Reihenfolge" die Reihenfolge der Archive im Editor festlegen.

7. Speichern Sie nach dem "Fertigstellen" die Projektierung im Editor.

Hinweis

Schlüsselwörter oder reservierte Wörter von SQL dürfen Sie nicht als Archivnamen verwenden.

Archivnamen, die nicht aus dem westeuropäischen Sprachraum stammen, dürfen Sie nicht verwenden. Legen Sie stattdessen über die Text Library ein Text für das Alias an.

Projektierungen und Änderungen an Anwenderarchiven werden erst durch das Speichern im Editor übernommen.

Siehe auchÜbersicht der nicht verwendbaren Namen (Seite 335)

So projektieren Sie mehrsprachige Texte (Seite 330)

So gehen Sie bei Änderungen des Anwenderarchivs vor (Seite 332)

So legen Sie die Rechte des Archivs fest (Seite 326)

So projektieren Sie die Steuervariablen (Seite 321)

So projektieren Sie die Kommunikation zu Variablen (Seite 320)

2.3.2.2 So projektieren Sie die Kommunikation zu Variablen

Einleitung Mit der Projektierung der Kommunikation legen Sie die Übertragung von Daten zwischen WinCC-Variablen bzw. Automatisierungssystem und Anwenderarchiv fest. Pro Anwenderarchiv können Sie eine Verbindung zum Automatisierungssystem projektieren.

Folgende Kommunikationsarten sind möglich:

● keine Kommunikation mit dem Anwenderarchiv.

● Über eine WinCC-Rohdatenvariable werden ganze Datensätze zwischen Automatisierungssystem und Anwenderarchiv übertragen.

● Über WinCC-Variablen werden einzelne Datenfelder eines Datensatzes übertragen.



Vorgehensweise1. Wählen Sie im Wizard im Dialog "Kommunikation" eine Kommunikationsart aus.

2. Wenn Sie die Option "über Rohdatenvariable" wählen, geben Sie als eindeutigen Namen des Anwenderarchivs eine frei wählbare "PLCID" an. Die "PLCID" muss aus exakt 8 ASCII-Zeichen bestehen und ist im WinCC-Projekt eindeutig. Die "PLCID" wird benötigt, damit das Automatisierungssystem die Prozessdaten wieder zum richtigen Anwenderarchiv zurückschickt. Die in der Rohdatenvariablen projektierte "R_ID" können Sie nicht verwenden, da die "R_ID" nur für die Kommunikation mit dem Automatisierungssystem relevant ist. Außerdem können mehrere Anwenderarchive über die gleiche Rohdatenvariable versorgt werden.

3. Wählen Sie über "Auswählen" eine Rohdatenvariable aus oder lassen Sie über WinCC eine Variable erzeugen.

4. Wenn Sie die Option "über WinCC-Variablen" wählen, projektieren Sie die Zuordnung der Variablen beim Erstellen der Anwenderarchivfelder.

5. Klicken Sie auf "Weiter" bzw. "Fertigstellen", um die Projektierung fortzusetzen bzw. zu beenden.


Siehe auchSo projektieren Sie den Datenaustausch über Rohdatenvariablen (Seite 345)

So legen Sie Werte der Anwenderarchivfelder fest (Seite 329)

2.3.2.3 So projektieren Sie die Steuervariablen

Einleitung Mit den Steuervariablen können Sie ein Anwenderarchiv ansteuern und auf Anwenderarchivfelder zugreifen. Wenn Sie Steuervariablen verwenden, müssen Sie immer alle vier Steuervariablen projektieren.

Die Steuervariablen bieten zwei Methoden, um auf Anwenderarchive zuzugreifen:

● Sie verwenden die Steuervariablen der Datensatz-ID und des Auftrags, um gezielt Werte in einen Datensatz zu schreiben, zu lesen oder zu löschen.

● Sie verwenden die Steuervariablen des Archivfelds und des Wert des Archivfelds, um einen Datensatz zu suchen. Mit der Steuervariable des Auftrags können Sie auf diese Weise ausgewählte Datensätze schreiben, lesen oder löschen. Z.B. um Datensätze aus der Tabelle zu löschen und am Tabellenende wieder anzuhängen.



Vorgehensweise1. Weisen Sie im Wizard im Dialog "Steuervariablen" den Steuervariablen WinCC-Variablen

zu.

2. Wählen Sie jeweils mit der Schaltfläche "Auswählen" über den Variablenauswahldialog eine Variable aus. Die Variablen sollen von folgenden Datentyp sein:

ID Vorzeichenbehafteter 32-Bit WertAuftrag Vorzeichenbehafteter 32-Bit WertFeld Textvariable 8 BitWert Textvariable 8 Bit

3. Oder lassen Sie über die Schaltfläche "Erzeugen..." die Steuervariablen von WinCC erstellen. Legen Sie im Dialog "Steuervariablen erzeugen" die Eigenschaften der Variablen fest. Die Steuervariablen werden in der Form @UA_[Archivname]_ID, @UA_[Archivname]_Job etc. angelegt.


5. Speichern Sie die nach dem "Fertigstellen" Projektierung im Editor.

Hinweis

Der Datentyp der Steuervariablen darf nicht verändert werden.

Funktion der SteuervariablenMit Hilfe der Steuervariablen steuern Sie das Anwenderarchiv an:

Funktion der SteuervariablenID Die Datensatz-Nummer des AnwenderarchivsAuftrag Folgende Aufträge sind möglich:

"6" = Lesen eines Datensatzes aus den Variablen in das Anwenderarchiv "7" = Schreiben eines Datensatzes aus dem Anwenderarchiv in die Variablen "8" = Löschen eines Datensatzes im AnwenderarchivNach Ausführung des Auftrags steht in "Auftrag" eine Fehlerkennung:"0" = Kein Fehler "-1" = Fehler

Feld Das bestimmte Feld des AnwenderarchivsWert Der Wert eines bestimmten Anwenderarchivfeldes

Weitere Kombinationen der Steuervariablen "ID" und "Auftrag":

ID Auftrag = "6" Auftrag = "7" Auftrag = "8"-1 Datensatz anhängen - Datensatz mit der kleinsten ID löschen



-6 Datensatz mit der kleinsten ID lesen

Datensatz mit der kleinsten ID schreiben

Datensatz mit der kleinsten ID löschen

-9 Datensatz mit der größten ID lesen Datensatz mit der größten ID schreiben

Datensatz mit der größten ID löschen

Siehe auchBeispiel zur Verwendung der Steuervariablen (Seite 323)

2.3.2.4 Beispiel zur Verwendung der Steuervariablen

Einleitung Das folgende Beispiel zeigt die Verwendung der Steuervariablen für die Kommunikation zwischen internen WinCC-Variablen und Anwenderarchiv. Ein WinCC UserArchivControl stellt den Inhalt des Anwenderarchivs dar. Über EA-Felder werden die Werte der Steuervariablen und WinCC-Variablen eingegeben bzw. ausgegeben.



Voraussetzung● Sie kennen die Grundlagen der Editoren "User Archive" und "Graphics Designer".

Projektierung im User Archive1. Erstellen Sie ein Anwenderarchiv. Wählen Sie die Kommunikation über WinCC-Variablen.

2. Lassen Sie über die Schaltfläche "Erzeugen..." die Steuervariablen automatisch von WinCC erstellen.

3. Erstellen Sie für das Anwenderarchiv das Feld "name" (Typ "String") und die Felder "red", "green", "blue" (Typ "Integer").

4. Erzeugen Sie in der Feldeigenschaft "Werte" für die Felder "red", "green" und "blue" jeweils eine interne Variable mit dem Datentyp "Vorzeichenloser 8-Bit Wert".

5. Speichern Sie das projektierte Anwenderarchiv.

Projektierung im Graphics Designer1. Öffnen Sie ein neues Bild und erstellen Sie ein WinCC UserArchiveControl.

2. Verbinden Sie In den "Eigenschaften von WinCC UserArchiveControl" auf der Registerkarte "Allgemeines" das Control mit dem projektierten Anwenderarchiv. Aktivieren Sie die Zugriffsarten "Ändern", "Hinzufügen" und "Löschen".

3. Projektieren Sie nach Wunsch weitere Eigenschaften des Controls. Schließen Sie den Dialog.



4. Fügen Sie für die projektierten Archivfelder "red", "green", "blue" jeweils ein Objekt "Statischer Text" für die Beschriftung und ein EA-Feld in das Bild ein. Wählen Sie jeweils im Konfigurationsdialog des EA-Felds die interne Variable aus, die mit dem entsprechenden Archivfeld verbunden ist. Wählen Sie im Feld "Aktualisierung" die Eigenschaft "Bei Änderung".

5. Fügen Sie für die projektierten Steuervariablen jeweils ein Objekt "Statischer Text" für die Beschriftung und ein EA-Feld in das Bild ein. Wählen Sie jeweils im Konfigurationsdialog des EA-Felds die entsprechende Steuervariable aus. Wählen Sie im Feld "Aktualisierung" die Eigenschaft "Bei Änderung". Legen Sie in der Eigenschaftsgruppe "Ausgabe/Eingabe" folgenden Einstellungen fest:

Steuervariable Datenformat Ausgabeformat@UA_xx_ID Dezimal s999@UA_xx_Job Dezimal S9@UA_xx_Field String *@UA_xx_Value String *

6. Speichern Sie das projektierte Bild.

Bedienung in RuntimeAktivieren Sie WinCC Runtime. Geben Sie im UserArchiveControl mehrere Datensätze ein, wie z. B. im obigen Beispielbild. Testen Sie folgende Beispiele und weitere Kombinationen der Steuervariablen "ID" und "Job".



Schreiben eines Datensatzes in die VariablenGeben Sie in das EA-Feld "ID" "3" ein und in das EA-Feld "Job" "7". Klicken Sie auf die "Enter"-Taste.

Die Werte des Datensatzes mit der "ID 3" werden in die Variablen geschrieben und in den verbundenen EA-Feldern "red", "green" und "blue" ausgegeben.

Wenn die Aktion erfolgreich war, wird im EA-Feld "Job" die Fehlernummer "0" angezeigt. Im Fehlerfall wird die Fehlernummer "-1" angezeigt.

Schreiben eines bestimmten Datensatzes in die VariablenGeben Sie in das EA-Feld "Field" "name" ein und in das EA-Feld "Value" z. B. "silver". Geben Sie in das EA-Feld "Job" "7" ein. Die Steuervariable "ID" wird nicht benötigt. Daher muss im EA-Feld "ID" "0" eingetragen sein.

Der Datensatz mit dem Namen "silver" wird in die Variablen geschrieben und in den entsprechenden EA-Feldern ausgegeben.

Ändern eines vorhandenen Datensatzes über das Lesen der Variablen Ändern Sie die Werte in den EA-Feldern "red", "green" und "blue". Geben Sie im EA-Feld "ID" z. B. "5" ein und in das EA-Feld "Job" "6".

Die geänderten Werte werden aus den EA-Feldern der Archivfelder und der damit verbundenen Variablen in den Datensatz mit der "ID" "5" geschrieben. Die bisher in diesem Datensatz enthaltenen Werte werden überschrieben.

Datensatz einfügen über das Lesen der VariablenGeben Sie Werte in den EA-Feldern der Archivfelder "red", "green" und "blue" ein. Geben Sie im EA-Feld "ID" "-1" ein und in das EA-Feld "Job" "6".

Die Werte von "red", "green" und "blue" und der damit verbundenen Variablen werden an das Tabellenende des Anwenderarchivs angehängt und im UserArchiveControl als letzter Datensatz angezeigt.

Siehe auchSo projektieren Sie die Steuervariablen (Seite 321)

2.3.2.5 So legen Sie die Rechte des Archivs fest

Einleitung Das Anwenderarchiv hat in der Standardeinstellung kein Zugriffschutz. Über den Dialog "Rechte und Flags" projektieren Sie die Zugriffsrechte für das Anwenderarchiv. Der Zugriffsschutz des Archivs wird in Runtime beim Bildaufschlag eines UserArchiveControl abgefragt. Den Zugriffsschutz für die Steuervariablen eines geschützten Archivs projektieren Sie über die Objekt-Eigenschaften im Graphics Designer, z.B. das EA-Feld.



Mit den Optionen zu "Flags" werden zusätzlich Felder für Datum/Uhrzeit des letzten Zugriffs und letzter Benutzer angelegt, die Sie im UserArchivControl als Spalten anzeigen lassen können.

Vorgehensweise1. Bestimmen Sie im Wizard im Dialog "Rechte und Flags" die Rechte für den lesenden und

schreibenden Zugriff auf das Anwenderarchiv.

2. Klicken Sie auf die Schaltfläche "Auswählen". Im Dialog "Berechtigungen" wählen Sie eine vom User Administrator zur Verfügung gestellte Berechtigung aus. Wenn Sie für das Anwenderarchiv eine eigene Berechtigung verwenden wollen, müssen Sie zuvor im User Administrator eine Berechtigung anlegen. Dann können Sie diese Berechtigung für das Anwenderarchiv aus der Liste auswählen.

3. Aktivieren Sie die Option "Feld - Letzter Zugriff", wenn Sie ein zusätzliches Feld für Datum/Uhrzeit des letzten Zugriffs verwenden wollen.

4. Aktivieren Sie die Option "Feld - Letzter Benutzer", wenn Sie ein zusätzliches Feld für den Benutzer verwenden wollen, der zuletzt auf das Anwenderarchiv zugegriffen hat.



Hinweis

Wenn das Anwenderarchiv über ein redundantes System abgeglichen wird, muss die Option ""Feld - Letzter Zugriff" aktiviert sein.

Siehe auchSo erstellen Sie ein Anwenderarchiv (Seite 319)

2.3.2.6 So erstellen Sie Anwenderarchivfelder

Einleitung Ein Wizard führt Sie durch die Projektierung von Feldern des Anwenderarchivs. Mit der Option "Felder in Schleife anlegen" des Editors können Sie mehrere Felder nacheinander erstellen.

Vorgehensweise1. Klicken Sie im Navigationsfenster des Editors mit der linken Maustaste auf das gewünschte

Anwenderarchiv.

2. Klicken Sie mit der rechten Maustaste auf das Anwenderarchiv und wählen Sie "Neues Feld". Der Wizard wird mit dem Dialog "Allgemein" gestartet.



3. Geben Sie einen Feldnamen ein. Der Feldname erscheint in Runtime als Spaltenname im UserArchivControl. Wenn Sie ein Alias angeben, wird in Runtime das Alias als Spaltenname verwendet. Über die Schaltfläche "Text Lib..." weisen Sie ein Text aus der Text Library dem Alias zu. Dadurch wird in Runtime bei einer Sprachumschaltung der entsprechende übersetzte Text angezeigt.

4. Wählen Sie aus der Liste den Datentyp des Feldes aus. Folgende Datentypen stehen zur Verfügung:

Zahl (integer) Vorzeichenbehafteter 32-Bit WertZahl (float) Gleitkommazahl 32-Bit IEEE 754Zahl (double) Gleitkommazahl 64-Bit IEEE 754Zeichenkette Textvariable 8-BitDatum/Uhrzeit Eingabeformat bzw. Ausgabeformat richtet sich

nach der Projekteinstellung


6. Wenn Sie mehrere Anwenderarchivfelder erstellt haben, können Sie im Dialog "Reihenfolge" die Reihenfolge der Felder im Anwenderarchiv festlegen. Die Reihenfolge wird im Editor in der Spalte "Pos." angezeigt. Im UserArchivControl werden die Spalten nach der festgelegten Reihenfolge der Felder dargestellt. Die Reihenfolge hat Auswirkung bei der Vergabe der Indizes für den Zugriff über die Funktionen der WinCC-Skriptsprache.


Hinweis

Für jedes Anwenderarchiv können Sie 500 Felder anlegen.

Sonderzeichen oder reservierte Wörter von SQL dürfen Sie nicht als Feldnamen verwenden.

Wenn Sie nach der Projektierung die Eigenschaften der Anwenderarchivfelder ändern, können unter folgenden Umständen Daten verloren gehen:● Wenn bei bereits vorhandenen Daten eine geänderte Konsistenzbedingung nicht mehr

erfüllt werden kann, z. B. die Option "Feld muss einen Wert besitzen".● Wenn Sie ein Feldname umbenennen.● Wenn durch einen neuen Datentyp die Daten aus der Quelle nicht mehr konvertiert

werden.

Siehe auchSo projektieren Sie mehrsprachige Texte (Seite 330)

Übersicht der nicht verwendbaren Namen (Seite 335)



2.3.2.7 So legen Sie Werte der Anwenderarchivfelder fest

Einleitung Im Dialog "Werte" können Sie für das Anwenderarchivfeld Grenzwerte vorgeben und ein Startwert festlegen. Wenn Sie eine Kommunikation des Anwenderarchivs über WinCC-Variablen projektiert haben, wählen Sie hier für das Anwenderarchivfeld die Variable aus.

Vorgehensweise1. Legen Sie im Wizard im Dialog "Werte" für das Anwenderarchivfeld vorgegebene Werte

fest.

2. Wenn Sie als Datentyp des Feldes "Zahl" projektiert haben, können Sie den Minimalwert, Maximalwert und Startwert festlegen.

3. Wenn Sie als Datentyp des Feldes "Zeichenkette" projektiert haben, können Sie einen Text als Startwert vorgeben.

4. Wenn das Feld über eine WinCC-Variable kommuniziert, legen Sie wie folgt eine Variable fest:

– Geben Sie den Variablennamen direkt in das Eingabefeld ein.

– Oder wählen Sie über die Schaltfläche "Auswählen" eine Variable aus bzw. erstellen Sie im Variablenauswahldialog eine neue Variable. Der Variablentyp muss mit dem Datentyp des Feldes übereinstimmen.

– Oder lassen Sie über die Schaltfläche "Erzeugen" eine neue Variable erstellen. Legen Sie im Dialog "WinCC Variable erzeugen" die Eigenschaften der Variablen fest.



Siehe auchSo projektieren Sie die Kommunikation zu Variablen (Seite 320)

2.3.2.8 So legen Sie die Rechte und Bedingungen des Felds fest

Einleitung Das Anwenderarchivfeld hat in der Standardeinstellung kein Zugriffschutz. Über den Dialog "Rechte und Flags" projektieren Sie die Zugriffsrechte für das Feld. Der Zugriffsschutz des Anwenderarchivfeldes wird in Runtime beim Bildaufschlag eines UserArchiveControl abgefragt.

Mit den Optionen zu "Flags" legen Sie Bedingungen für das Feld fest.



Vorgehensweise1. Bestimmen Sie im Wizard im Dialog "Rechte und Flags" die Rechte für den lesenden und

schreibenden Zugriff auf das Anwenderarchivfeld.

2. Klicken Sie auf die Schaltfläche "Auswählen". Im Dialog "Berechtigungen" wählen Sie eine vom User Administrator zur Verfügung gestellte Berechtigung aus. Wenn Sie für das Anwenderarchivfeld eine eigene Berechtigung verwenden wollen, müssen Sie zuvor im User Administrator eine Berechtigung anlegen. Dann können Sie diese Berechtigung für das Anwenderarchivfeld aus der Liste auswählen.

3. Aktivieren Sie die Option "Feld muss einen Wert besitzen", wenn das Feld nicht leer sein darf.

4. Aktivieren Sie die Option "Feld muss einen eindeutigen Wert besitzen", wenn die Werte des Feldes sich voneinander unterscheiden müssen.

5. Aktivieren Sie die Option "Feld soll durch Index unterstützt werden", wenn das Feld durch einen Index für ein schnelles Suchen unterstützt wird. Nur bei bestimmten Feldern ist die Indexunterstützung möglich.



2.3.2.9 So projektieren Sie mehrsprachige Texte

Einleitung Den Text für den Alias in den Komponenten des Anwenderarchivs können Sie mehrsprachig projektieren. Über den Dialog "Textbibliothek" wählen Sie entweder den Text aus, der in der



Text Library hinterlegt ist, oder Sie geben einen neuen Text an. Der Dialog öffnet sich, wenn Sie in den Wizards auf der Seite "Allgemein" auf die Schaltfläche "Text Lib..." klicken.

So wählen Sie einen vorhandenen Text aus der Text Library aus1. Stellen Sie unter "Sprache" die Sprache ein, in der Sie projektieren.

2. Wenn in der Text Library die Texte schon in den gewünschten Sprachen angelegt sind, klicken Sie in die leere Liste unterhalb des Auswahlfilters. In die Liste werden alle vorhandenen Texte der Text Library in der eingestellten Sprache geladen.

3. Wenn Sie die Anzeige der Texte in der Liste einschränken wollen, verwenden Sie unter "Auswählen" das Eingabefeld "Filter". Z.B. listet der Filter "a%" nur die Texte auf, die mit dem Buchstaben "a" beginnen. Nach der Eingabe eines Filterkriteriums müssen Sie erneut in die Liste klicken, um die Textauswahl zu aktualisieren.

4. Klicken Sie auf den gewünschten Text in der Liste. Der ausgewählte Text wird im Feld "Text" angezeigt.

5. Bestätigen Sie den Dialog mit "OK".

6. Als Alias wird nun die Positionsnummer des Textes in der Text Library angezeigt.

Wenn Sie die Sprache in Runtime umschalten, wird der entsprechende Text aus der Text Library in der gewählten Sprache angezeigt.

So geben Sie einen neuen Text ein1. Stellen Sie unter "Sprache" die Sprache ein, in der Sie projektieren.

2. Geben Sie unter "Text" den Text für das Alias ein, den Sie mehrsprachig verwenden wollen.

3. Bestätigen Sie den Dialog mit "OK".



4. Als Alias wird nun die Positionsnummer des neuen Textes in der Text Library angezeigt.

5. Öffnen Sie den Editor "Text Library". Tragen Sie die Übersetzungen des neuen Textes in die Spalten der gewünschten Sprachen ein.

6. Schließen Sie die Text Library.

Wenn Sie die Sprache in Runtime umschalten, wird der entsprechende Text aus der Text Library in der gewählten Sprache angezeigt.

Hinweis

Bei Client-Projekten müssen Sie für den Text in der Text Library des Servers und Clients die gleiche Text-ID verwenden. Sonst wird auf dem Client in Runtime ein falscher Text angezeigt.

2.3.2.10 So gehen Sie bei Änderungen des Anwenderarchivs vor

Einleitung Wenn Sie ein Anwenderarchiv ändern oder erweitern wollen, können bereits vorhandene Daten im Archiv verloren gehen. Das betrifft vor allem die Änderung der Struktur eines Anwenderarchivs oder die Änderung der Eigenschaften eines Feldes.

VorgehensweiseUm den Verlust von Daten zu vermeiden, gehen Sie wie folgt vor:

1. Deaktivieren Sie Runtime. Öffnen Sie den Editor "User Archive".

2. Wählen Sie das Archiv aus und projektieren Sie die Änderungen. Speichern Sie die Projektierung erst dann, wenn Sie die Änderungen vollständig eingebracht haben. Führen Sie kein Zwischenspeichern durch.

3. Klicken Sie nach dem Speichern auf die Schaltfläche "Runtimedaten" in der Symbolleiste. Im Tabellenfenster sehen Sie, ob die bestehenden Daten des Anwenderarchivs noch vorhanden sind.

4. Wenn die Daten noch vorhanden sind, können Sie das geänderte Archiv verwenden oder weitere Änderungen projektieren. Prüfen Sie bei jedem Speichern von Änderungen, ob die Daten noch vorhanden sind.

5. Wenn nach einer Änderung die Daten nicht mehr vorhanden sind, müssen Sie zuerst alle projektierten Änderungen im Archiv rückgängig machen, ohne anschließend zu speichern.

6. Klicken Sie im Navigationsfenster auf das Archiv. Wählen Sie über die rechte Maustaste "Rt-Daten wieder herstellen". Dadurch werden die bestehenden Daten des Archivs wieder im Tabellenfenster angezeigt

7. Speichern Sie das Archiv und prüfen Sie, ob die Daten wieder im Archiv vorhanden sind.



Hinweis

Die bestehenden Daten sind endgültig verloren, wenn nach einer gespeicherten Änderung die bestehenden Daten nicht mehr vorhanden sind und Sie danach eine weitere Änderung speichern.

Hinweis

Wenn Sie nach einer Änderung Runtime starten und dann den Datenverlust feststellen, können die bestehenden Daten über den Befehl "Rt-Daten wieder herstellen" des Editors in der Tabelle wieder angezeigt werden. Dabei kann der Editor "User Archive" bereits geschlossen oder WinCC beendet gewesen sein. Ausschlaggebend ist das einmalige Speichern einer Änderung.

Bei umfangreichen Änderungen sollen Sie die bestehenden Daten vorher exportieren, um ein Datenverlust vorzubeugen. Die Daten können Sie dann durch Anpassen der exportierten Datentabelle gezielt in das geänderte Archiv zurückschreiben.

Wenn Sie das Anwenderarchiv auf dem Server ändern, benötigt der Client ohne eigenes Projekt eine Aktualisierung des Packages. Sie können die Aktualisierung manuell oder durch ein implizites Update durchführen.

2.3.3 Projektierung einer Sicht

2.3.3.1 So erstellen Sie eine Sicht

Einleitung Eine Sicht fasst Daten aus verschiedenen Anwenderarchiven zusammen. So können Sie z.B. mit SQL Verknüpfungen über die Felder verschiedener Anwenderarchive erstellen, um Zusammenhänge in Runtime in einer Sicht anzuzeigen. Die verknüpften Anwenderarchive müssen dann mindestens ein gemeinsames Datenfeld haben.

Ein Wizard führt Sie durch die Projektierung von Sichten. Mit der Option "Sichten in Schleife anlegen" des Editors können Sie mehrere Sichten nacheinander erstellen.

Vorgehensweise1. Starten Sie mit Doppelklick den User Archive im WinCC Explorer.

2. Klicken Sie mit der rechten Maustaste auf "Sichten" und wählen Sie "Neue Sicht". Der Wizard wird mit dem Dialog "Allgemein" gestartet.

3. Geben Sie einen Sichtnamen ein. Wenn Sie ein Alias angeben, wird in Runtime das Alias verwendet. Über die Schaltfläche "Text Lib..." ordnen Sie über die Text Library ein Text für das Alias zu. Dadurch wird bei einer Sprachumschaltung in Runtime der Text der entsprechenden Sprache verwendet.



4. Klicken Sie auf die Schaltfläche "Fertig stellen". Danach erstellen Sie die Spalten einer Sicht.

5. Speichern Sie nach dem Erstellen der Sicht und der Spalten die Projektierung im Editor.

6. Projektieren Sie die Eigenschaften der Sicht über das Kontextmenü "Eigenschaft" der Sicht. Z.B. können Sie im Dialog "Reihenfolge" die Reihenfolge der Sichten im Editor festlegen, wenn Sie mehrere Sichten erstellt haben.

Siehe auchSo gehen Sie bei Änderungen des Anwenderarchivs vor (Seite 332)

So projektieren Sie mehrsprachige Texte (Seite 330)

So erstellen Sie die Spalten einer Sicht (Seite 334)

2.3.3.2 So erstellen Sie die Spalten einer Sicht

Einleitung Ein Wizard führt Sie durch die Projektierung von den Spalten einer Sicht. Mit der Option "Spalten einer Sicht in Schleife anlegen" des Editors können Sie mehrere Spalten nacheinander erstellen.

Vorgehensweise1. Klicken Sie im Navigationsfenster des Editors mit der linken Maustaste auf die gewünschte

Sicht.

2. Klicken Sie mit der rechten Maustaste auf die Sicht und wählen Sie "Neue Spalte". Der Wizard wird mit dem Dialog "Allgemein" gestartet.

3. Wählen Sie aus der Liste von "Archiv" und "Feld" ein projektiertes Anwenderarchiv aus und ein zugehöriges Feld, das Sie mit der Spalte der Sicht verbinden wollen.

4. Klicken Sie in das Feld "Spaltenname", um der Spalte der Sicht im UserArchivControl einen eindeutigen Namen zu geben. Der Name des ausgewählten Felds wird übernommen. Sie können auch einen anderen Spaltennamen angeben.

5. Wenn Sie ein Alias angeben, wird in Runtime das Alias als Spaltenname verwendet. Über die Schaltfläche "Text Lib..." weisen Sie ein Text aus der Text Library dem Alias zu. Dadurch wird in Runtime bei einer Sprachumschaltung der entsprechende übersetzte Text angezeigt.

6. Klicken Sie auf die Schaltfläche "Fertig stellen". Danach können Sie weitere Spalten einer Sicht erstellen.

7. Speichern Sie nach dem Erstellen der Spalten die Projektierung im Editor.

8. Projektieren Sie die Eigenschaften der Spalte über das Kontextmenü "Eigenschaft" der Spalte. Wenn Sie mehrere Spalten erstellt haben, können Sie im Dialog "Reihenfolge" die Reihenfolge der Spalten in der Sicht festlegen. Die Reihenfolge wird im Editor in der Spalte "Pos." angezeigt. Im UserArchivControl werden die Spalten nach der festgelegten Reihenfolge dargestellt.



Siehe auchSo projektieren Sie mehrsprachige Texte (Seite 330)

So erstellen Sie eine Sicht (Seite 333)

2.3.3.3 So legen Sie die Relation einer Sicht fest

Einleitung In einer Sicht können Sie eine Verknüpfung zwischen Feldern verschiedener Anwenderarchive herstellen. Dafür legen Sie die Relationen der Feldinhalte fest. Die Felder, die miteinander in Beziehung gesetzt werden, müssen den gleichen Datentyp haben.

Vorgehensweise1. Klicken Sie mit der rechten Maustaste auf die gewünschte Sicht und wählen Sie

"Eigenschaften".

2. Gehen Sie zur Registerkarte "Relation".

3. Geben Sie unter "Beziehung" die Verknüpfung der Feldinhalte direkt in SQL ein.

4. Oder verwenden Sie die Auswahl an Operatoren. Wählen Sie aus der rechten und linken Liste jeweils ein Feld aus. Bestimmen Sie in der Liste "OP:" den gewünschten Operator. Klicken Sie auf "Hinzufügen". Die Verknüpfung wird als Sichteigenschaft übernommen und unter "Beziehung" angezeigt.

5. Speichern Sie nach der Eigenschaftsänderung der Sicht die Projektierung im Editor.

Die Daten einer Sicht können Sie auch in Runtime editieren. Die geänderten Daten werden in das Anwenderarchiv übernommen.

Hinweis

Die verknüpften Anwenderarchive müssen mindestens eine Gemeinsamkeit oder einen Zusammenhang aufweisen.

2.3.4 Übersicht der nicht verwendbaren Namen

Einleitung Die Namen von Archiven, Sichten und Felder im User Archive dürfen nur Buchstaben, Ziffern und "_" beinhalten sowie maximal aus 25 Zeichen bestehen. Das erste Zeichen muss immer ein Buchstabe sein.

Folgende Namen dürfen Sie nicht verwenden:



● Archive

● View

● Field

● ViewCol

Übersicht der SQL-SchlüsselwörterFolgende Schlüsselwörter bzw. reservierte Wörter von SQL dürfen Sie nicht als Namen im User Archive verwenden:

Verwendete Schlüsselwörter in der SQL Spracheadd all alter andany as asc beginbetween binary break bycall cascade cast charchar_convert character check checkpointclose comment commit connectconstraint continue convert createcross current cursor datedba dbspace deallocate decdecimal declare default deletedesc distinct do doubledrop else elseif encryptedend endif escape exceptionexec execute exists fetchfirst float for foreignfrom full goto grantgroup having holdlock identifiedif in index innerinout insert instead intinteger into is isolationjoin key left likelock long match membershipmessage mode modify namednatural noholdlock not nullnumeric of off onopen option options ororder others out outerpassthrough precision prepare primaryprint privileges proc procedureraiserror readtext real referencereferences release remote renameresource restrict return revoke



Verwendete Schlüsselwörter in der SQL Spracheright rollback save savepointschedule select set sharesmallint some sqlcode sqlstatestart stop subtrans subtransactionsynchronize syntax_error table temporarythen time tinyint totran trigger truncate tsequalunion unique unknown updateuser using validate valuesvarbinary varchar variable varyingview when where whilewith work writetext

2.3.5 So exportieren Sie die Konfigurationsdaten des User Archive

Einleitung Die Konfigurationsdaten von Anwenderarchiven und Sichten des geöffneten WinCC-Projekts können Sie exportieren, um die Daten z.B. in anderen Projekten wiederzuverwenden oder ein Backup zu erstellen.



Vorgehensweise1. Wählen Sie im Editor den Befehl "Exportieren" im Menü "Projekt". Der Dialog "Projekt

exportieren" öffnet sich.

2. Im Dateiauswahlfeld ist ein Verzeichnis innerhalb des Projekts voreingestellt. Wählen Sie gegebenenfalls über "..." ein anderes Verzeichnis aus.

3. In den Listen "Archive" und "Sichten" werden alle projektierten Anwenderarchive und Sichten angezeigt. Wählen Sie mit Mausklick die Archive und Sichten aus. Die Einfach- und Mehrfachselektion ist möglich. Wenn Sie eine Sicht auswählen, wird auch das zugehörige Archiv exportiert.

4. Klicken Sie auf die Schaltfläche "Exportieren". Die Konfigurationsdaten werden mit der Dateierweiterung "uap" gespeichert.

Hinweis

Um Runtime-Daten zu exportieren, müssen Sie den Befehl "Exportieren" im Menü "Runtime Daten" verwenden.



2.3.6 So importieren Sie die Konfigurationsdaten des User Archive

Einleitung Die Konfigurationsdaten von Anwenderarchiven und Sichten können Sie in das WinCC-Projekt importieren, wenn bereits Konfigurationsdaten exportiert wurden.

Vorgehensweise1. Wählen Sie im Editor den Befehl "Importieren" im Menü "Projekt". Der Dialog "Projekt

importieren" öffnet sich.

2. Wählen Sie über "..." das Verzeichnis aus, in dem die zu importierenden Daten abgelegt sind.

3. Laden Sie über die Schaltfläche "Datei laden" die importierten Konfigurationsdaten.

4. In den Listen "Archive" und "Sichten" werden alle importierten Anwenderarchive und Sichten angezeigt. Wählen Sie mit Mausklick die Archive und Sichten aus. Die Einfach- und Mehrfachselektion ist möglich. Wenn Sie eine Sicht auswählen, wird auch das zugehörige Archiv importiert.

5. Klicken Sie auf die Schaltfläche "Importieren". Die Konfigurationsdaten werden in den Editor geladen.

Bestehende, gleichnamige Archive dürfen Sie bei einem Import nicht überschreiben. Wenn Sie die Archivnamen beibehalten wollen, müssen Sie vor dem Import die im Projekt



bestehenden, gleichnamigen Archive löschen. Vorhandene Runtime-Daten müssen Sie zuvor sichern, da diese beim Löschen der Archive ebenfalls gelöscht werden.

Hinweis

Um Runtime-Daten zu importieren, müssen Sie den Befehl "Importieren" im Menü "Runtime Daten" verwenden.

2.3.7 So bearbeiten Sie die Runtime-Daten im User Archive

Einleitung Im Tabellenfenster des Editors bearbeiten Sie die Daten der projektierten Anwenderarchive.

Vorgehensweise1. Klicken Sie im Navigationsfenster des Editors mit der linken Maustaste auf das gewünschte

Anwenderarchiv.

2. Wählen Sie das Menü "Bearbeiten/Runtime Daten" oder klicken Sie auf in der Symbolleiste. Die Felder im Tabellenfenster werden aktiviert.

3. Mit einem Doppelklick auf ein Feld können Sie die Daten eingeben, ändern oder löschen. Bestätigen Sie die Änderung mit der "Enter"-Taste, damit die Daten übernommen werden.

4. Wenn Sie nach der Anwahl eines Feldes auf klicken, können Sie mit den Cursor-Steuertasten oder mit den "Blättern"-Symbolen durch die Tabelle bewegen und die Felder sofort editieren.

2.3.8 So exportieren Sie die Runtime-Daten des User Archive

Einleitung Sie können die Runtime-Daten eines ausgewählten Anwenderarchivs exportieren, um die Daten z.B. in MS-Excel zu bearbeiten oder ein Backup zu erstellen.



Voraussetzung● Die Funktion "Runtime Daten" ist nicht aktiviert.

Vorgehensweise1. Wählen Sie im Editor den Befehl "Exportieren" im Menü "Runtime Daten" oder klicken Sie

auf in der Symbolleiste. Der Dialog "Exportieren" öffnet sich.

2. Im Dateiauswahlfeld geben Sie Pfad und Name der Exportdatei an. Der Pfad ist auf das Verzeichnis "ua" im aktuellen Projekt voreingestellt. Wählen Sie gegebenenfalls über "..." ein anderes Verzeichnis aus.

3. Wählen Sie unter "Dateiformat" das Format der Exportdatei aus. Über die Schaltfläche "Optionen" können Sie das Trennzeichen der Einträge in der Datei vorgeben. Die Standardeinstellung ist ";".

4. Wählen Sie unter "Archivauswahl" ein Anwenderarchiv aus dem aktuellen Projekt aus.

5. Bestimmen Sie über die Option "Filter", welche Inhalte des Anwenderarchivs Sie exportieren wollen. Wenn Sie nur die Daten eines Anwenderarchivfeldes exportieren wollen, aktivieren Sie die Option "auf Feld". Wählen Sie aus der Liste das Feld aus. Dazu können Sie in den Eingabefeldern "von" und "bis" den Wertebereich angeben, auf den Sie den Export der Daten beschränken wollen.



6. Mit der Option "SQL-Ausdruck" können Sie über das Eingabefeld ein SQL-Ausdruck angeben, der den Export der Archivdaten beschränkt.

7. Über die Schaltfläche "Exportieren" exportieren Sie die Daten in die festgelegte Datei.

Beim Export werden in der Exportdatei Datensatz-IDs eingetragen, um beim Import eine eindeutige Zuordnung der importierten Daten zu ermöglichen.

HinweisDatumsfelder beim Export von Runtime-Daten

Bei der Weiterverarbeitung der exportierten Runtimedaten müssen Sie die Datumsfelder immer in der Sprache bzw. Schreibweise ändern, in der die Datumsfelder exportiert wurden. Sonst ist ein Import der Daten in das Anwenderarchiv nicht mehr möglich.

Hinweis

Wenn bei einem Client-Server-Projekt das Anwenderarchiv sich auf dem Server befindet, z.B. unter "c:\Projekte\Test\UA", wird das Archiv unter diesem Standardpfad freigegeben. Der Client bildet die Freigabe über ein Netzlaufwerk ab, z.B. "I:\Test\UA". Der Standardpfad des Anwenderarchivs ist demnach auf dem Client "I:\Test\UA". Dieses Verzeichnis existiert aber unter dieser Bezeichnung nicht auf dem Server. Wenn Sie Anwenderarchivdaten auf den Server exportieren wollen, müssen Sie auf dem Client den Standardpfad ändern, in dem Beispiel auf "C:\Projekte\Test\UA".

HinweisExportieren der Konfigurationsdaten von Anwenderarchiven und Sichten

Um Konfigurationsdaten von Anwenderarchiven und Sichten zu exportieren, müssen Sie den Befehl "Exportieren" im Menü "Projekt" verwenden.

2.3.9 So importieren Sie die Runtime-Daten des User Archive

Einleitung Sie können Runtime-Daten, die aus einer Datenbank stammen, in ein ausgewähltes Anwenderarchiv importieren. Z.B. Eine CSV-Datei, die auf einem externen Speichermedium gespeichert ist.

Beim Export wurden zu den Exportdaten Datensatz-IDs eingetragen, um beim Import eine eindeutige Zuordnung der importierten Daten zu ermöglichen. Wenn WinCC beim Import feststellt, dass eine zu importierende ID im Anwenderarchiv bereits besteht, wird eine Fehlermeldung und ein Eintrag in die Log-Datei "UALogFile.txt" generiert. Die Daten mit einer neuen Datensatz-ID werden als neue Datensätze im Anwenderarchiv hinzugefügt.



Voraussetzung● In der Datei, die Sie importieren wollen, sind keine Informationen über Datentyp und Anzahl

der Felder enthalten. Daher muss der Aufbau der Importdaten und des Zielarchivs übereinstimmen.

● Alternativ importieren Sie in das Anwenderarchiv, aus dem Sie die Daten zuvor exportiert haben.

● Die Funktion "Runtime Daten" ist nicht aktiviert.

Vorgehensweise1. Wählen Sie im Editor den Befehl "Importieren" im Menü "Runtime Daten" oder klicken Sie

auf in der Symbolleiste. Der Dialog "Importieren" öffnet sich.

2. Im Dateiauswahlfeld geben Sie Pfad und Name der Datei an, deren Runtime-Daten Sie in ein Anwenderarchiv importieren wollen. Der Pfad ist auf das Verzeichnis "ua" im aktuellen Projekt voreingestellt. Wählen Sie gegebenenfalls über "..." ein anderes Verzeichnis aus.

3. Wählen Sie unter "Dateiformat" das Format der Importdatei aus. Über die Schaltfläche "Optionen" geben Sie das Trennzeichen der Einträge in der Datei an. Die Standardeinstellung ist ";".

4. Wählen Sie unter "Archivauswahl" ein Anwenderarchiv aus dem aktuellen Projekt als Zielarchiv aus.

5. Über die Schaltfläche "Importieren" importieren Sie die Daten in das ausgewählte Anwenderarchiv.

Hinweis

Sie haben außerhalb von WinCC die exportierten Runtime-Daten eines Anwenderarchivs editiert und wollen nun die Daten dieses Anwenderarchivs überschreiben. Wenn Sie die geänderten Daten importieren wollen, müssen Sie zuerst alle Datensätze des Anwenderarchivs löschen. Ansonsten erhalten Sie Fehlermeldungen beim Import wegen den gleichen Datensatz-IDs.



Hinweis

Wenn bei einem Client-Server-Projekt das Anwenderarchiv sich auf dem Server befindet, z.B. unter "c:\Projekte\Test\UA", wird das Archiv unter diesem Standardpfad freigegeben. Der Client bildet die Freigabe über ein Netzlaufwerk ab, z.B. "I:\Test\UA". Der Standardpfad des Anwenderarchivs ist demnach auf dem Client "I:\Test\UA". Dieses Verzeichnis existiert aber unter dieser Bezeichnung nicht auf dem Server. Wenn Sie Anwenderarchivdaten auf den Client importieren wollen, müssen Sie auf dem Client den Standardpfad ändern, in dem Beispiel auf "C:\Projekte\Test\UA".

Hinweis

Um Konfigurationsdaten von Anwenderarchiven und Sichten zu importieren, müssen Sie den Befehl "Importieren" im Menü "Projekt" verwenden.



2.4 Datenaustausch mit Automatisierungssystemen

2.4.1 SIMATIC-Schnittstellen

Einleitung Runtime-Daten können zwischen Anwenderarchiv und S5-/S7-Automatisierungssystemen über WinCC-Variablen und mit S7-400 auch über Rohdatenvariablen ausgetauscht werden. Alle SIMATIC-Schnittstellen stehen zur Verfügung mit Ausnahme der AS511-Programmierschnittstelle.

Datenaustausch über WinCC-VariablenDer Datenaustausch über WinCC-Variablen mit S5- bzw. S7-Automatisierungssystemen ist einfach. Sie müssen darauf achten, dass Sie für die Anwenderarchive nur bestimmte Datentypen des WinCC-Variablenhaushalts verwenden dürfen.

Für die Datentypen "Integer", "Double" und "String" im Anwenderarchiv müssen die folgenden Datentypen des Variablenhaushalts verwendet werden. Für "Datum/Uhrzeit" im Anwenderarchiv besteht kein entsprechender Datentyp im Variablenhaushalt.

Auswahl im Editor User Archive WinCC-Variable im VariablenhaushaltZahl (integer) Vorzeichenbehafteter 32-Bit-WertZahl (float) Gleitkommazahl 32-Bit IEEE 754Zahl (double) Gleitkommazahl 64-Bit IEEE 754Zeichenkette (String) Textvariable 8-Bit ZeichensatzDatum/Uhrzeit Kein entsprechender Datentyp

Auf den folgenden Seiten wird der Datenaustausch über Rohdatenvariablen ausführlich dargestellt.

Siehe auchSo projektieren Sie den Datenaustausch über Rohdatenvariablen (Seite 345)

2.4.2 Datenaustausch mit S7 über Rohdatenvariablen

2.4.2.1 So projektieren Sie den Datenaustausch über Rohdatenvariablen

Einleitung Für den Datenaustausch zwischen Anwenderarchiv und Automatisierungssystem über WinCC-Rohdatenvariablen wird die Funktion "BSEND/BRCV" der S7-Kommunikation

User Archive2.4 Datenaustausch mit Automatisierungssystemen


verwendet. Die Rohdatenvariablen werden vom Automatisierungssystem als aktiver Partner gesendet.

PrinzipDie Telegramme der Rohdatenvariablen beinhalten eine oder mehrere Schreib- bzw. Leseaufträge für das Anwenderarchiv. Als Antwort auf diese Aufträge schickt WinCC die angeforderten Daten und eine Bearbeitungsquittung zurück. Deshalb muss im STEP7-Programm immer ein "BRCV" projektiert sein.

Da das Automatisierungssystem der aktive Partner ist, muss ein vom Anwender veranlasster Auftrag direkt im Automatisierungssystem angestoßen werden, z.B. über eine externe WinCC-Variable. Der im Auftragskopf und Quittungskopf des Telegramms verwendete Parameter "Auftragstyp" kann zum Anstoß von Funktionen des Automatisierungssystems nicht verwendet werden, weil der Auftragstyp nur für Funktionen des Anwenderarchivs genutzt wird.

Voraussetzung● Sie haben Hintergrund-Informationen über Rohdatenvariablen.

● Sie haben das STEP7-Programm für das Automatisierungssystem projektiert.

● Der Kanal "SIMATIC S7 Protocol Suite" ist in das WinCC-Projekt eingebunden.

Vorgehensweise1. Erstellen Sie eine neue Verbindung einer Kanal-Unit im "SIMATIC S7 Protocol Suite", z.B.

"Industrial Ethernet". Sie können auch eine vorhandene Verbindung verwenden.

2. Öffnen Sie im Dialog "Eigenschaften Verbindung" über die Schaltfläche "Eigenschaften" den Dialog "Verbindungsparameter - Industrial Ethernet".

3. Geben Sie die Parameter ein und aktivieren Sie das Kontrollkästchen "Rohdatenblock senden/empfangen". Übernehmen Sie als "Verbindungsressource" den Hexadezimal-Wert aus der STEP7-Projektierung.



4. Erstellen Sie eine neue Variable vom Datentyp "Rohdatentyp".

5. Öffnen Sie im Dialog "Eigenschaften Variable" über die Schaltfläche "Wählen" den Dialog "Eigenschaften Adresse".

6. Aktivieren Sie das Kontrollkästchen "Rohdaten". Übernehmen Sie die "R_ID" aus der STEP7-Projektierung. Im STEP7-Programm muss bezüglich "BSEND" und "BRCV" für das Anwenderarchiv immer die gleiche "R_ID" projektiert sein.

7. Aktivieren Sie als "Rohdatentyp" die Option "BSEND/BRCV".

8. Speichern Sie die Projektierung.

Hinweis

Verwenden Sie als Rohdatentyp immer die Option "BSEND/BRCV", nicht die Option "Block senden/empfangen".

2.4.2.2 Datenformat-Unterschiede zwischen WinCC und S5/S7

Einleitung Die Datenformate in WinCC unterscheiden sich grundsätzlich zu den Datenformaten in den S7-Automatisierungssytemen. Das müssen Sie berücksichtigen, um Fehler zu vermeiden.



In WinCC werden die Datenformate von Intel und Microsoft eingehalten, in denen zuerst niederwertige Bytes und dann höherwertige Bytes gespeichert werden. Dieses Datenformat ist sehr verbreitet und als "Intel-Format" bekannt.

Intel-FormatBeim Intel-Format wird die Dezimalzahl 300 wie folgt abgelegt:

Bit 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0Binär 0 0 0 0 0 0 0 1 0 0 1 0 1 1 0 0

Hex 0 1 2 C

Die Dezimalzahl "300" entspricht nach dem Intel-Format der Hexzahl "12C" (1*256 + 2*16 + 12).

SIMATIC-FormatBeim SIMATIC-Format werden niederwertige Bytes auf höherwertigen Stellen abgelegt. Die Dezimalzahl "300" wird beim SIMATIC-Format wie folgt abgelegt:

Bit 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0Binär 0 0 1 0 1 1 0 0 0 0 0 0 0 0 0 1

Hex 2 C 0 1

Die Dezimalzahl "300" entspricht nach dem SIMATIC-Format der Hexzahl "2C01". Wenn "2C01" fälschlicherweise nach dem Intel-Format interpretiert wird, würde man als Dezimalzahl "11265" erhalten.

Für die Automatisierungssysteme stehen Funktionsbausteine zur Verfügung, die entsprechende Datenkonvertierungen durchführen können. Die Funktionsbausteine müssen Sie immer vor und nach dem Datentransfers zwischen S7 und WinCC aufrufen. Sie können die Funktionsbausteine unter "http://support.automation.siemens.com/" herunterladen.

Geben Sie als Suchbegriff "Funktionsbausteine ANSI_S5" ein. Die komprimierte Datei "ANSI_S5.EXE" wird zum Download angeboten. In der Datei befindet sich der Funktionsbaustein "IEEE:GP".

Das aktive Senden ist in den Referenzhandbüchern der Steuerungen bzw. der "Communication Processors" beschrieben.



2.4.2.3 Senden der Aufträge und Daten aus der S7 an WinCC

Aufbau der Rohdatenvariablen Im Folgenden sehen Sie den Aufbau der Rohdatenvariablen, die zum Senden von Aufträgen und Daten aus dem S7-Automatisierungssystem an WinCC User Archive verwendet wird. Die Daten werden in der Steuerung über STEP 7 projektiert.

Telegramm von S7 an WinCC User ArchiveTelegrammkopfAuftragskopf 1Daten des Auftrags 1Evtl. Auftragskopf 2Evtl. Daten des Auftrags 2Auftrag n

Siehe auchAufbau des Telegrammkopfes (Seite 350)

Daten des Auftrags (Seite 351)

2.4.2.4 Empfang der Daten und der Bearbeitungsquittierung in der S7

Aufbau der Rohdatenvariablen Im Folgenden sehen Sie den Aufbau der Rohdatenvariablen, die zum Empfangen von Bearbeitungsquittierungen und Daten aus WinCC User Archive im S7-Automatisierungssystem verwendet wird. Die Daten werden in der Steuerung über STEP 7 projektiert.

Rohdatenvariable zum Empfangen in der S7BearbeitungsquittungQuittungskopfQuittungsdaten

Siehe auchDer Quittungskopf (Seite 352)



2.4.2.5 Aufbau des Telegrammkopfes

Aufbau des Telegrammkopfs Der Telegrammkopf besteht im Einzelnen aus folgenden Teilen (Aufteilung in Bytes):

Funktion des Feldes KommentarTelegrammlänge in Byte LSB *) Länge des Felds 4 Bytes. max. Länge 4091 Bytes . .(wg. S7-Transport)Telegrammlänge in Byte MSB **) .Transfertyp 1 von WinCC, 2 von der SteuerungReserviert Anzahl der Aufträge im Telegramm LSB Länge des Feldes 2 BytesAnzahl der Aufträge im Telegramm MSB .PLCID 1.Zeichen Namen in ASCII. Länge des Feldes 8 Bytes. .. .. .. .. .PLCID 8.Zeichen .

*) LSB = Least Significant Byte (niederwertiges Byte)

**) MSB = Most Significant Byte (höherwertiges Byte)

Siehe auchDer Auftragskopf (Seite 350)

2.4.2.6 Der Auftragskopf

Aufbau des Auftragskopfs Der Auftragskopf besteht im Einzelnen aus folgenden Teilen (Aufteilung in Bytes):

Funktion des Feldes KommentarAuftragslänge in Byte LSB *) Länge des Feldes 2 BytesAuftragslänge in Byte MSB**) .Auftragstyp siehe Beschreibung der AuftragtypenReserviert Feldnummer LSB Länge des Feldes 2 BytesFeldnummer MSB .



Datensatznummer LSB Länge des Feldes 4 Bytes. .. .Datensatznummer MSB .Selektionskriterium LSB Selektiert nach der Feldnummer, wenn Sie eine Selektion

verwenden wollen.Selektionskriterium MSB Selektiert nach der Feldnummer, wenn Sie eine Selektion

verwenden wollen.Daten des Selektionskriteriums LSB Selektiert nach dem Feldinhalt, wenn Sie eine Selektion

verwenden wollen.Daten des Selektionskriteriums MSB Selektiert nach dem Feldinhalt, wenn Sie eine Selektion

verwenden wollen.



Siehe auchBeschreibung der Auftragstypen (Seite 353)

2.4.2.7 Daten des Auftrags

Daten des Auftrags Die Daten des Auftrags entsprechen je nach Auftragstyp dem Inhalt eines Datensatzes oder eines adressierten Feldes.

Beachten Sie folgendes:

● Die Textfelder sind nicht \0-terminiert.

● Die Zahlen müssen im Intel-Format, LSB zuerst und MSB zuletzt, übertragen werden.

● Ein Feld mit Datentyp "Integer" hat die Länge 4 Bytes, "Float" hat 4 Bytes und "Double" hat 8 Bytes.

● Wenn Sie ein Selektionskriterium im Auftragskopf verwenden wollen, verschieben sich die Daten des Auftrags nach hinten, nämlich um 2 Bytes für die Feldnummer plus der Anzahl der Bytes für den Feldinhalt. Z. B. die Datensätze werden nach der Feldnummer mit dem Datentyp "Integer" selektiert. Die Daten des Auftrags verschieben sich dann um 2 Bytes für die Feldnummer plus den 4 Bytes für die Integer nach hinten. Wenn Sie keine Selektionskriterien verwenden wollen, lassen Sie "Selektionskriterium" und "Daten des Selektionskriteriums" im Auftragskopf weg. Die Daten des Auftrags beginnen dann direkt nach der Datensatznummer des Auftragskopfs.



2.4.2.8 Der Quittungskopf

Aufbau des Quittungskopfs Der Quittungskopf besteht im Einzelnen aus folgenden Teilen (Aufteilung in Bytes):

Funktion des Feldes KommentarTelegrammlänge in Byte LSB*) Länge des Feldes 4 Bytes. .. .Telegrammlänge in Byte MSB**) .Transfertyp 1 von WinCC, 2 von der SteuerungReserviert Fehlercode siehe Beschreibung der FehlercodesAuftragstyp siehe Beschreibung der AuftragtypenReserviert Reserviert Feldnummer LSB Länge des Feldes 2 BytesFeldnummer MSB .Datensatznummer LSB Länge des Feldes 4 Bytes. .. .Datensatznummer MSB .PLCID 1.Zeichen Namen in ASCII. Länge des Feldes 8 Bytes. .. .. .. .. .PLCID 8.Zeichen .



Daten der QuittungDie Quittung enthält entweder den Datensatz oder das adressierte Feld (bei einer Leseanforderung) oder sie ist leer (Schreibauftrag, Archivauftrag).

Siehe auchBeschreibung der Fehlercodes (Seite 353)

Beschreibung der Auftragstypen (Seite 353)



2.4.2.9 Beschreibung der Auftragstypen

Beschreibung der Auftragstypen Im Folgenden sehen Sie die Auflistung der Aufträge, mit denen Sie auf das Anwenderarchiv zugreifen können:

Typ Beschreibung4 Anwenderarchiv auf Vorhandensein prüfen5 Alle Datensätze aus dem Anwenderarchiv löschen6 Datensatz lesen7 Datensatz schreiben8 Datensatz löschen9 Datensatzfeld lesen10 Datensatzfeld schreiben

2.4.2.10 Beschreibung der Fehlercodes

Beschreibung der Fehlercodes Im Folgenden sehen Sie die Auflistung der Fehlercodes, die bei der Ausführung der Aufträge auftreten können:

Gruppe Nr. Beschreibung Mögliche FehlerursachenAllgemein 0 Funktion ist ausgeführt worden --Archiv 2 Nicht vorhandene Daten Kein Archiv ist mit dieser PLCID

projektiertDatensatz 101 Nicht zulässige Daten - Das Datensatz-Layout stimmt nicht

überein, z.B. Anzahl oder Datentyp der Felder- Das Einfügen bzw. Aktualisieren des Datensatzes schlägt fehl, da z.B. das Archiv vom Typ "begrenzt" ist oder zu einem Feld ein Min- bzw. Max-Wert projektiert ist- Das Filterkriterium ist falsch

Datensatz 102 Nicht vorhandene Daten (nur für Auftragstyp 6) - Keine Daten vorhanden- Das Filterkriterium ist falsch

Feld 201 Nicht zulässige Daten (nur für Auftragstyp 10) Das Filterkriterium ist falsch, da z.B. das Feld nicht vorhanden ist oder zu einem Feld ein Min- bzw. Max-Wert projektiert ist



Feld 202 Nicht vorhandene Daten (nur für Auftragstyp 9) Das Filterkriterium ist falsch oder kein Feld gefunden, das dem Filterkriterium entspricht

Allgemein 254 Funktion nicht vorhanden --Allgemein 255 Undefinierter Fehler --



2.5 User Archive Funktionen

2.5.1 Allgemeine Informationen

Einleitung Die Funktionen für User Archive verwenden Sie für die Konfiguration von Anwenderarchiven und für die Bedienung der Archive in Runtime. WinCC bietet eine Reihe von Standardfunktionen, um dem Benutzer eine flexible Verwendung von User Archive zu ermöglichen.

ÜberblickDie Standardfunktionen benötigen Handles, die von den Funktionen "uaQueryConfiguration", "uaConnect", "uaQueryArchive" und "uaOpen" zurückgegeben werden.

Alle Funktionen für User Archive beginnen mit "ua", z.B. "uaConnect". Die Runtime-Funktionen beginnen immer mit "uaArchive", z.B. "uaArchiveOpen".

Für die API-Aufrufe werden zwei Präfixe unterschieden:

● "ua" für Skripte, wie Global Script und Programmierung von Aktionen.

● "UA" für Programme, die außerhalb von WinCC laufen. Wenn Sie Aufrufe für User Archive in einem Dynamic Wizard verwenden, müssen Sie den Präfix "UA" verwenden.

Hinweis

Beim Anlegen eines Datensatzes wird nicht überprüft, ob der Datensatz vollständig oder richtig ist. Insbesondere darf ein Feld nicht leer sein.

Innerhalb eines Skripts muss die Aktualität der Daten gewährleistet sein.

Bei folgendem Szenario wird das Skript z.B. nicht über Änderungen informiert. Ein Skript hat ein Anwenderarchiv geöffnet. In das Anwenderarchiv wird über ein UserArchiveControl oder über den Editor "User Archive" ein Datensatz eingefügt bzw. gelöscht. Erst nach einem "Requery" sind die Änderungen im Skript bekannt.

Siehe auchBeispiel eines User Archive-Skripts (Seite 358)

So verwenden Sie die Funktionen des User Archive (Seite 356)

User Archive2.5 User Archive Funktionen


2.5.2 So verwenden Sie die Funktionen des User Archive

Einleitung Um die Funktionen des User Archive zur Konfiguration von Anwenderarchiven und in Runtime effizient zu nutzen, müssen Sie den Zusammenhang der Funktionen berücksichtigen.

Die folgenden Ebenen der Verbindungen zu User Archive bei der Verwendung von Runtime-Funktionen müssen Sie unbedingt einhalten:

● uaConnect <--> uaDisconnect

● uaQueryArchiveByName bzw. uaQueryArchive <--> uaReleaseArchive

● uaArchiveOpen <--> uaArchiveClose

Nach dem dreistufigen Öffnen der Verbindungen haben Sie mit den Runtime-Funktionen Zugriff auf das Anwenderarchiv. Danach müssen Sie die geöffneten Verbindungen wieder dreistufig schließen.

Funktionen zur Konfiguration von Anwenderarchiven Die Funktion "uaQueryConfiguration" leitet den Abschnitt der Konfiguration ein und liefert das Handle "UAHCONFIG" für die Konfigurationsfunktionen. Mit dem Handle werden z.B. die Funktionen "uaAddArchive" oder "uaAddField" aufgerufen, um ein neues Anwenderarchiv bzw. ein neues Datenfeld anzulegen. Mit der Funktion "uaReleaseConfiguration" muss der Konfigurationsabschnitt beendet werden.

Verbindung zum Anwenderarchiv für die Runtime-Funktionen aufbauenFür den Zugriff in Runtime müssen Sie die Funktion "uaConnect" aufrufen, um eine Verbindung zu "User Archive" aufzubauen. "uaConnect" erstellt den Handle "UAHCONNECT", der zum Öffnen der Anwenderarchive benötigt wird. Mit der Funktion "uaDisconnect" müssen Sie die Verbindung zu "User Archive" wieder abbauen.

Anwenderarchiv für die Runtime-Funktionen öffnenFür die Verwendung der Runtime-Funktionen wird ein projektiertes Anwenderarchiv vorausgesetzt. Mit den Funktionen "uaQueryArchive" bzw. "uaQueryArchiveByName" wird die Verbindung zum aktuellen Anwenderarchiv aufgebaut und ein Handle für die Runtime-Funktionen geliefert. Nach dem Öffnen des Anwenderarchivs mit der Funktion "uaArchiveOpen" können Sie die Runtime-Funktionen verwenden.

Nach dem Zugriff der Runtime-Funktionen müssen Sie zunächst mit der Funktion "uaArchiveClose" das Anwenderarchiv schließen. Dann bauen Sie mit der Funktion "uaReleaseArchive" die Verbindung zum aktuellen Anwenderarchiv ab.

Runtime-Funktionen verwendenMit den Runtime-Funktionen bedienen Sie die Anwenderarchive in Runtime, z.B. das folgende Beispiel mit "uaArchiveSetFieldValueLong". Über den Handle "hArchive" besteht eine



eindeutige Zuordnung zu einem Datensatz des Anwenderarchivs. Die Zuordnung erlaubt auch eine indirekte Adressierung, z.B. für die Bedienoberfläche.

Mit den Funktionen "uaArchiveNext", "uaArchivePrevious", "uaArchiveFirst" und "uaArchiveLast" wird der Positionszeiger verschoben. Die Funktion "uaArchiveUpdate" speichert den temporären Datensatz im Anwenderarchiv und überschreibt den Datensatz auf dem der Positionszeiger aktuell steht. Der Datensatz muss vorher über die Funktionen "uaArchiveNext", "uaArchivePrevious", "uaArchiveFirst" oder "uaArchiveLast" gelesen werden.

Beispiel einer Runtime-Funktion#include "apdefap.h"void OnClick(char* lpszPictureName, char* lpszObjectName, char* lpszPropertyName){UAHCONNECT hConnect = 0;UAHARCHIVE hArchive = 0;if ( uaConnect( &hConnect ) ){ if ( uaQueryArchiveByName( hConnect, "VarTest", &hArchive ) ) { if ( uaArchiveOpen( hArchive ) ) { //------------------------------------------------------------------ uaArchiveSetFieldValueLong( hArchive, 1, GetTagSDWord("UA_VarTest_Int1")); uaArchiveSetFieldValueLong( hArchive, 2, GetTagSDWord("UA_VarTest_Int2")); if (! uaArchiveInsert( hArchive ) ) { printf("Fehler (%d) bei uaArchiveInsert\r\n",uaGetLastError() ); } //------------------------------------------------------------------ uaArchiveClose( hArchive ); } else { printf( "Open failed.<%d>\r\n",uaGetLastError() ); } uaReleaseArchive( hArchive ); } else { printf( "Query failed.<%d>\r\n",uaGetLastError() ); } uaDisconnect( hConnect );}else



{printf( "Connect failed.<%d>\r\n",uaGetLastError() );}}

2.5.3 Beispiel eines User Archive-Skripts

Einleitung Hier finden Sie ein Skript-Beispiel, das einige der Standardfunktionen von User Archive verwendet. Das Beispiel umfasst Funktionen zum Lesen und Schreiben eines Anwenderarchivs in Runtime, die durch einen Klick auf die Schaltflächen aufgerufen werden:

● Die Funktion "UAReadFromArchive" liest den ersten Datensatz des Anwenderarchivs.

● Die Funktion "UAWriteToArchive" schreibt einen Datensatz in das Anwenderarchiv.

Die Daten werden im WinCC UserArchivControl und die Skript-Ausgaben im Diagnosefenster angezeigt.



Voraussetzung● Sie kennen die Grundlagen der Editoren "User Archive", "Graphics Designer" und "Global

Script".

● Sie haben ein Anwenderarchiv erstellt, z.B. "color" aus dem Beispiel auf der Seite "Beispiel zur Verwendung der Steuervariablen".



● Sie haben den Graphics Designer geöffnet und ein Bild mit einem WinCC UserArchivControl projektiert, z.B. aus dem Beispiel auf der Seite "Beispiel zur Verwendung der Steuervariablen".

● Sie haben in den WinCC-Eigenschaften des Rechners in der Anlaufliste den Eintrag "Global Script Runtime" aktiviert.

Vorgehensweise1. Öffnen Sie den C-Editor von "Global Script" im WinCC Explorer.

2. Klicken Sie im Editor im Menü "Datei" auf "neue Projekt-Funktion".

3. Kopieren Sie einen der untenstehenden Beispiel-Skripte in das Editierfenster. Klicken Sie auf , um die Funktion zu kompilieren.

4. Speichern Sie über die übersetzte, fehlerfreie Funktion mit dem Namen "UAReadFromArchive".

5. Verfahren Sie mit dem zweiten Skript nach der gleichen Vorgehensweise.

6. Fügen Sie im Graphics Designer aus der Objektpalette das Smart-Objekt "Applikationsfenster" in das Bild ein. Das Applikationsfenster dient als Diagnosefenster der Skripte.

7. Wählen Sie im Dialog "Fensterinhalt" den Eintrag "Global Script" und als Vorlage "GSC - Diagnose". Setzen Sie in den Eigenschaften des Applikationsfensters auf der Registerkarte "Sonstige" alle Eigenschaften auf "ja".

8. Erstellen Sie die Schaltflächen "read" und "write" mit dem Objekt "Button" aus der Objektpalette unter "Windows-Objekte".

9. Klicken Sie mit der rechten Maustaste auf die Schaltfläche "read" und wählen Sie den Menüeintrag "Eigenschaften".

10.Gehen Sie auf die Registerkarte "Ereignis". Klicken Sie auf "Maus".

11.Klicken Sie mit der rechten Maustaste bei "Mausklick" in die Spalte "Aktion" und wählen Sie "C-Aktion". Das Fenster "Aktion editieren" öffnet sich.

12.Klicken Sie im Editierfenster in die Aktion "OnClick" zwischen "{" und "}".

13.Doppelklicken Sie im Navigationsfenster im Verzeichnis "Projekt-Funktionen" auf "UAReadFromArchive".

14.Klicken Sie auf und dann rechts unten auf "OK". Das Beispiel-Skript ist nun in der Aktion bei Mausklick auf die Schaltfläche eingebunden.

15.Verfahren Sie mit der Schaltfläche "write" nach der gleichen Vorgehensweise.

16.Speichern Sie das Bild im Graphics Designer.

17.Aktivieren Sie das Beispielprojekt für Runtime.

Beispiel-Skript "UAReadFromArchive"#include "apdefap.h"void UAReadFromArchive(){UAHCONNECT hConnect = 0;



UAHARCHIVE hArchive = 0;LONG IndexArchive;LONG FieldLength;LONG FieldType;LONG NumberOfFields;LONG Index;long IntValue;float FloatValue;double DoubleValue;char ArchivName[255], StringField[255];SYSTEMTIME SysDate;//******* Connect to Component User Archives ****************************if (uaConnect( &hConnect ) == FALSE ){printf("uaConnect error: %d\n", uaGetLastError() );return;}if (hConnect == NULL){printf("Handle UAHCONNECT equals NULL\n" );return;}//******* Connect to Archive via Archive Name ****************************if (uaQueryArchiveByName( hConnect, "color", &hArchive ) == FALSE ){printf("uaQueryArchive Error: %d\n" , uaGetLastError() );goto finish;}//******* Opens Archive ******************************************************if ( uaArchiveOpen( hArchive ) == FALSE ){printf("uaArchive Open Error\n" );goto finish;}//******* Move to first record set ****************************************************if (uaArchiveMoveFirst(hArchive) == FALSE ){printf("uaArchiveMoveFirst Error = %d\n" , uaGetLastError() );goto finish;}//******* Get Number of Fields **********************************************NumberOfFields = uaArchiveGetFields( hArchive );printf("Number of Fields = %u\n", NumberOfFields );//******* Read and show Data Fields ****************************************for ( Index = 1; Index < NumberOfFields; Index++ ){



printf("Data of Field %u: \n", Index ); FieldType = uaArchiveGetFieldType( hArchive, Index );switch ( FieldType ){case UA_FIELDTYPE_INTEGER :printf("Field Type = Integer\n");if (uaArchiveGetFieldValueLong ( hArchive, Index, &IntValue ) == TRUE )printf("Field Value = %u\n", IntValue );elseprintf("Error callinguaArchiveGetFieldValueLong: %d\n", uaGetLastError() );break;case UA_FIELDTYPE_FLOAT :printf("Field Type = Float\n");if (uaArchiveGetFieldValueFloat ( hArchive, Index, &FloatValue ) == TRUE )printf("Field Value = %f\n", FloatValue );elseprintf("Error callinguaArchiveGetFieldValueFloat: %d\n", uaGetLastError() );break;case UA_FIELDTYPE_DOUBLE :printf("Field Type = Double\n");if (uaArchiveGetFieldValueDouble (hArchive, Index, &DoubleValue ) == TRUE )printf("Field Value = %g\n", DoubleValue );elseprintf("Error calling uaArchiveGetFieldValueDouble: %d\n", uaGetLastError() );break;case UA_FIELDTYPE_STRING :printf("Field Type = String\n");if (uaArchiveGetFieldValueString ( hArchive, Index, StringField, 20 ) == TRUE )printf("Field Value = %s\n", StringField );elseprintf("Error callinguaArchiveGetFieldValueString: %d\n", uaGetLastError() );break;case UA_FIELDTYPE_DATETIME :printf("Field Type = Date & Time\n");if (uaArchiveGetFieldValueDate ( hArchive, Index, &SysDate ) == TRUE )printf("%d.%d.%d\n ",SysDate.wDay, SysDate.wMonth, SysDate.wYear );elseprintf("Error calling uaArchiveGetFieldValueLong: %d\n", uaGetLastError() );break;case -1 :default :printf("Error executing uaArchiveGetFieldType\n");



}//******* Read and show Field Length **************************************FieldLength = uaArchiveGetFieldLength( hArchive, Index );if ( FieldLength != -1 )printf("Field Length = %u\n", FieldLength );elseprintf("Error executing uaArchiveGetFieldLength\n");}//******* Close all handles and connections ***************************finish:;//******* Close Archive *******************************************************if( NULL != hArchive ){if (uaArchiveClose ( hArchive ) == FALSE ){printf("error on closing archive\n" );}}//****** Release Connection to Archive *************************************if( NULL != hArchive ){if (uaReleaseArchive ( hArchive ) == FALSE ){printf("error on releasing archive\n" );}hArchive = 0;}//******* Disconnect to Component User Archives *************************if( NULL != hConnect ){if (uaDisconnect ( hConnect ) == FALSE ){printf("error on disconnection\n" );}hConnect = 0;}}

Beispiel-Skript "UAWriteToArchive"#include "apdefap.h"void UAWriteToArchive(){UAHCONNECT hConnect = 0;UAHARCHIVE hArchive = 0;LONG IndexArchive;LONG FieldLength;



LONG FieldType;LONG NumberOfFields;LONG Index;long IntValue;char StringField[255];SYSTEMTIME SysDate;//******* Connect to Component User Archives ****************************if (uaConnect( &hConnect ) == FALSE ){printf("uaConnect error: %d\n", uaGetLastError() );return;}if (hConnect == NULL){printf("Handle UAHCONNECT equals NULL\n" );return;}//******* Connect to Archive via Name ****************************if (uaQueryArchiveByName( hConnect, "color", &hArchive ) == FALSE ){printf("uaQueryArchive Error: %d\n" , uaGetLastError() );goto finish;}//******* Opens Archive ******************************************************if ( uaArchiveOpen( hArchive ) == FALSE ){printf("uaArchive Open Error\n" );goto finish;}//******* Get Number of Fields **********************************************NumberOfFields = uaArchiveGetFields( hArchive );printf("Number of Fields = %u\n", NumberOfFields );//******* Read Last Data Set ************************************************if (uaArchiveMoveLast( hArchive ) == TRUE )printf("Number of Fields = %u\n", NumberOfFields );else{printf("uaArchiveMoveLast Error: %d\n" , uaGetLastError() );goto finish;}//******* Write into Data Fields *********************************************IntValue = 105;//RGB for darkgraystrcpy(StringField, "darkgray" );GetSystemTime( &SysDate );for (Index = 1; Index < NumberOfFields; Index++ ){printf("Data of Field %u: \n", Index );



FieldType = uaArchiveGetFieldType( hArchive, Index );switch ( FieldType ){case UA_FIELDTYPE_INTEGER :printf("Field Type = Integer\n");if (uaArchiveSetFieldValueLong ( hArchive, Index, IntValue ) == TRUE )printf("Field Value = %u\n", IntValue );elseprintf("Error callinguaArchiveSetFieldValueLong: %d\n", uaGetLastError() );break;case UA_FIELDTYPE_FLOAT :printf("Field Type = Float\n");if (uaArchiveSetFieldValueFloat ( hArchive, Index, FloatValue ) == TRUE )printf("Field Value = %f\n", FloatValue );elseprintf("Error callinguaArchiveSetFieldValueFloat: %d\n", uaGetLastError() );break;case UA_FIELDTYPE_DOUBLE :printf("Field Type = Double\n");if (uaArchiveSetFieldValueDouble (hArchive, Index, DoubleValue ) == TRUE )printf("Field Value = %g\n", DoubleValue );elseprintf("Error calling uaArchiveSetFieldValueDouble: %d\n", uaGetLastError() );break;case UA_FIELDTYPE_STRING :printf("Field Type = String\n");if (uaArchiveSetFieldValueString ( hArchive, Index, StringField ) == TRUE )printf("Field Value = %s\n", StringField );elseprintf("Error callinguaArchiveSetFieldValueString: %d\n", uaGetLastError() );break;case UA_FIELDTYPE_DATETIME :printf("Field Type = Date & Time\n");if (uaArchiveSetFieldValueDate ( hArchive, Index, &SysDate ) == TRUE )printf("%d.%d.%d\n ",SysDate.wDay, SysDate.wMonth, SysDate.wYear );elseprintf("Error calling uaArchiveSetFieldValueLong: %d\n", uaGetLastError() );break;case -1 :default :printf("Error executing uaArchiveSetFieldType\n");}



FieldLength = uaArchiveGetFieldLength( hArchive, Index );if ( FieldLength != -1 )printf("Field Length = %u\n", FieldLength );elseprintf("Error executing uaArchiveGetFieldLength\n");}// ******* Update Archive *******************************************if (uaArchiveUpdate(hArchive) == FALSE ){printf("uaArchiveUpdate Error:\n" );}//******* Close all handles and connections ***************************finish:;//******* Close Archive *******************************************************if( NULL != hArchive ){if (uaArchiveClose ( hArchive ) == FALSE ){printf("error on closing archive\n" );}}//****** Release Connection to Archive *************************************if( NULL != hArchive ){if (uaReleaseArchive ( hArchive ) == FALSE ){printf("error on releasing archive\n" );}hArchive = 0;}//******* Disconnect to Component User Archives *************************if( NULL != hConnect ){if (uaDisconnect ( hConnect ) == FALSE ){printf("error on disconnection\n" );}hConnect = 0;}}



2.5.4 Funktionen zur Konfiguration von Anwenderarchiven

2.5.4.1 Funktionen zur Konfiguration von Anwenderarchiven

Überblick Um Anwenderarchive zu konfigurieren, müssen Sie zunächst die Funktion "uaQueryConfiguration" aufrufen, der den Handle "UAHCONFIG" erstellt. Mit dem Handle können Sie dann die folgenden Funktionen verwenden. Nach der Konfiguration müssen Sie "uaReleaseConfiguration" aufrufen.

Funktion BeschreibunguaAddArchive Ein neues Anwenderarchiv hinzufügenuaAddField Ein neues Feld hinzufügenuaGetArchive Archivkonfiguration lesenuaGetField Feldkonfiguration lesenuaGetNumArchives Anzahl der angelegten Archive lesenuaGetNumFields Anzahl der Felder lesenuaQueryConfiguration Verbindung zur Konfiguration des User Archive aufbauenuaReleaseConfiguration Verbindung nach der Konfiguration abbauenuaRemoveAllArchives Alle Archive löschenuaRemoveAllFields Alle Felder löschenuaRemoveArchive Bestimmtes Archiv löschenuaRemoveField Bestimmtes Feld löschenuaSetArchive Archivkonfiguration schreibenuaSetField Feldkonfiguration schreiben

2.5.4.2 uaAddArchive

Beschreibung Legt ein neues Anwenderarchiv an. Das entspricht der Projektierung eines neuen Anwenderarchivs mit dem Editor "User Archive".

LONG uaAddArchive ( UAHCONFIG hConfig,UACONFIGARCHIVE* pArchive )

ParameterUAHCONFIG hConfig,Handle zur Konfiguration eines Anwenderarchivs. Der Handle wird mit "uaQueryConfiguration" eingerichtet.



UACONFIGARCHIVE* pArchiveZeiger auf Puffer zum Speichern der Anwenderarchiv-Konfiguration.

ReturnwertIndex des neuen Anwenderarchivs. Bei Fehler "-1".

Siehe auchStruktur der Anwenderarchiv-Konfiguration "uaCONFIGARCHIVE" (Seite 377)

2.5.4.3 uaAddField

Beschreibung Hinzufügen eines neuen Datenfelds.

LONG uaAddField ( UAHCONFIG hConfig,long lArchive,UACONFIGFIELD* pField )

ParameterUAHCONFIG hConfig,Konfigurations-Handle des Anwenderarchivs. Der Handle wird mit "uaQueryConfiguration" eingerichtet.

long lArchive,Archive-Index (0 bis (uaGetNumArchives()-1))

UACONFIGFIELD* pArchiveZeiger auf Puffer der Feld-Konfiguration.

ReturnwertIndex des neuen Datenfelds. Bei Fehler "-1".

Siehe auchStruktur der Feld-Konfiguration "uaCONFIGFIELD" (Seite 376)



2.5.4.4 uaGetArchive

Beschreibung Liest die Anwenderarchiv- Konfiguration.

BOOL uaGetArchive ( UAHCONFIG hConfig,long lArchive,UACONFIGARCHIVE* pArchive )



UACONFIGARCHIVE* pArchiveZeiger auf Puffer zum Empfangen der Anwenderarchiv-Konfiguration.

ReturnwertTRUE: Erfolgreicher Zugriff auf das Anwenderarchiv

FALSE: Fehler


2.5.4.5 uaGetField

Beschreibung Liest die Feld-Konfiguration.

BOOL uaGetField ( UAHCONFIG hConfig,long lArchive,long lField,UACONFIGFIELD* pField )





long lField,Die Feldnummer, wobei "lField = 0" das erste Feld adressiert.

UACONFIGFIELD* pArchiveZeiger auf Puffer zum Empfangen der Feld-Konfiguration.


FALSE: Fehler


2.5.4.6 uaGetNumArchives

Beschreibung Liest die Anzahl der momentan konfigurierten Anwenderarchiven.

LONG uaGetNumArchives ( UAHCONFIG hConfig )

ParameterUAHCONFIG hConfigKonfigurations-Handle des Anwenderarchivs. Der Handle wird mit "uaQueryConfiguration" eingerichtet.

ReturnwertAnzahl momentan konfigurierter Anwenderarchive. Bei Fehler "-1".



2.5.4.7 uaGetNumFields

Beschreibung Liefert die Anzahl der projektierten Felder. Die Felder "ID", "Letzter Benutzer" und "Letzter Zugriff" werden nicht mitgezählt. In den Konfigurationsaufrufen werden die Indizes mit "0 bis uaGetNumFields() -1" angegeben.

LONG uaGetNumFields ( UAHCONFIG hConfig,long lArchive )



ReturnwertAnzahl der projektierten Felder. Bei Fehler "-1".

2.5.4.8 uaQueryConfiguration

Beschreibung Baut die Verbindung zum Anwenderarchiv für die Konfiguration auf.

BOOL uaQueryConfiguration ( UAHCONFIG* phConfig )

ParameterUAHCONFIG* phConfig,Zeiger auf Handle des Anwenderarchivs.


FALSE: Fehler



2.5.4.9 uaReleaseConfiguration

Beschreibung Baut die Verbindung nach der Konfiguration des Anwenderarchivs ab.

BOOL uaReleaseConfiguration ( UAHCONFIG hConfig,BOOL bSave )


BOOL bSaveSichert die Konfigurationsänderungen vor dem Abbau der Verbindung des Anwenderarchivs.

TRUE: Änderungen sichern

FALSE : Änderungen verwerfen

Hinweis

Der Befehl "bSave = TRUE" dürfen Sie nur durchführen, wenn WinCC Runtime nicht aktiv ist!

Mit der Funktion "uaIsActive" prüfen Sie, ob Runtime aktiv ist.

ReturnwertTRUE: Erfolgreicher Abbau der Verbindung

FALSE: Fehler

Siehe auchuaIsActive (Seite 380)

2.5.4.10 uaRemoveAllArchives

Beschreibung Löscht alle Anwenderarchive, die nicht in Sichten verwendet werden.

BOOL uaRemoveAllArchives( UAHCONFIG hConfig )




ReturnwertTRUE: Erfolgreiches Löschen

FALSE: Fehler

Hinweis

Nach dem Aufrufen der Funktion können Sie mit "uaGetNumArchives()" abfragen, ob alle Archive gelöscht wurden.

2.5.4.11 uaRemoveAllFields

Beschreibung Löscht alle Datenfelder eines Anwenderarchivs.

BOOL uaRemoveAllFields ( UAHCONFIG hConfig,long lArchive )


long lArchive,Archiv-Index (0 bis (uaGetNumArchives()-1))

ReturnwertTRUE: Erfolgreiches Löschen der Datenfelder

FALSE: Fehler



2.5.4.12 uaRemoveArchive

Beschreibung Löscht das angegebene Anwenderarchiv.

BOOL uaRemoveArchive ( UAHCONFIG hConfig,long lArchive )



ReturnwertTRUE: Erfolgreiches Löschen des Anwenderarchivs.

FALSE: Fehler

2.5.4.13 uaRemoveField

Beschreibung Entfernt ein bestimmtes Datenfeld eines Anwenderarchivs.

BOOL uaRemoveField ( UAHCONFIG hConfig,long lArchive,long lField )



long lField,



Die Feldnummer, wobei "lField = 0" das erste Datenfeld adressiert.

ReturnwertTRUE: Erfolgreiches Löschen des Feldes

FALSE: Fehler

2.5.4.14 uaSetArchive

Beschreibung Setzt die Konfiguration eines Anwenderarchivs.

BOOL uaSetArchive ( UAHCONFIG hConfig,long lArchive,UACONFIGARCHIVE* pArchive )



UACONFIGARCHIVE* pArchiveZeiger auf Puffer der Anwenderarchiv-Konfiguration.

ReturnwertTRUE: Erfolgreicher Zugriff auf Anwenderarchiv.

FALSE: Fehler




2.5.4.15 uaSetField

Beschreibung Setzt die Datenfeld-Konfiguration.

BOOL uaSetField ( UAHCONFIG hConfig,long lArchive,long lField,UACONFIGFIELD* pField )



long lField,Die Feldnummer, wobei "lField = 0" das erste Feld adressiert.

UACONFIGFIELD* pFieldZeiger auf Puffer der Feld-Konfiguration.

ReturnwertTRUE: Erfolgreicher Zugriff auf das Anwenderarchiv.

FALSE: Fehler


2.5.4.16 Struktur der Feld-Konfiguration "uaCONFIGFIELD"

Struktur "uaCONFIGFIELDA"typedef struct tagUACONFIGFIELD{LONG lArchiveId; // Eindeutige ID des Anwenderarchivs

LONG lFieldId; // Eindeutige ID des Datenfelds



LONG lPosition; // Position des Anwenderarchivs

CHAR szName[UA_MAXLEN_NAME+1]; // Archivname max. 20 Zeichen

CHAR szAlias[UA_MAXLEN_ALIAS+1]; // Aliasname max. 50 Zeichen

LONG lType; //Archivtyp

LONG lLength; /* Maximale Zeichenanzahl, wenn das Datenfeld vom Typ STRING ist; ansonsten nicht verwendet */

LONG lPrecision; // Wird intern verwendet; keine Belegung notwendig

CHAR szMinValue[UA_MAXLEN_VALUE+1]; /* Minimum für Datenfelder vom Typ ungleich STRING oder DATUM; ansonsten nicht verwendet */

CHAR szMaxValue[UA_MAXLEN_VALUE+1]; /* Maximum für Datenfelder vom Typ ungleich STRING oder DATUM; ansonsten nicht verwendet */

CHAR szStartValue[UA_MAXLEN_VALUE+1]; // Startwert

CHAR szDMVarName[UA_MAXLEN_DMVARNAME+1]; /* Variable aus dem Datenmanager (wird bei Archiven mit Kommunikation über WinCCVariablen verwendet) */

DWORD dwReadRight; //Zugriffsrechte lesen

DWORD dwWriteRight; //Zugriffsrechte schreiben

DWORD dwFlags; // Letzter Zugriff

} UACONFIGFIELD;

Siehe auchuaAddField (Seite 368)

2.5.4.17 Struktur der Anwenderarchiv-Konfiguration "uaCONFIGARCHIVE"

Strukturtyp "uaCONFIGARCHIVE"typedef struct tagUACONFIGARCHIVE

{

LONG lArchiveId; // Eindeutige ID des Anwenderarchivs

LONG lPosition; // Position des Anwenderarchivs

CHAR szName[UA_MAXLEN_NAME+1]; // Archivname max. 20 Zeichen

CHAR szAlias[UA_MAXLEN_ALIAS+1]; // Aliasname max. 50 Zeichen

LONG lType;UA_ARCHIVETYPE_UNLIMITED // Archivtyp "unbegrenzt"

UA_ARCHIVETYPE_LIMITED // Archivtyp "begrenzt"

LONG lNumRecs; // max. Anzahl Datensätze

LONG lCommType;UA_COMMTYPE_NONE // keine Kommunikation



UA_COMMTYPE_RAW // Kommunikation über Rohdaten

UA_COMMTYPE_DIRECT //Kommunikation über Datenmanager-Variablen

CHAR szPLCID[UA_MAXLEN_PLCID+1]; // PLCID der Rohdatenvariablen

CHAR szDMVarName[UA_MAXLEN_DMVARNAME+1]; // Name der Rohdatenvariablen

CHAR szIDVar[UA_MAXLEN_DMVARNAME+1]; // Steuervariable "ID"

CHAR szJobVar[UA_MAXLEN_DMVARNAME+1]; // Steuervariable "Auftrag"

CHAR szFieldVar[UA_MAXLEN_DMVARNAME+1]; // Steuervariable "Feld"

CHAR szValueVar[UA_MAXLEN_DMVARNAME+1]; // Steuervariable "Wert"

DWORD dwReadRight; // Zugriffsrechte lesen

DWORD dwWriteRight; // Zugriffsrechte schreiben

DWORD dwFlags; UA_ARCHIVEFLAG_ACCESS // Flag "Letzter Zugriff"

UA_ARCHIVEFLAG_USER // Flag "Letzter Benutzer"

} UACONFIGARCHIVE;

HinweisLONG lArchiveId; //Eindeutige ID des Anwenderarchivs

Bei "0" wird automatisch eine eindeutige ID verwendet und bei "uaGetArchive" zurückgegeben. Die zurückgegebene "ID" wird dann bei "uaSetField" angegeben. Bei der Rückgabe von ID "-1" konnte das Archiv nicht angelegt werden.

Siehe auchuaAddArchive (Seite 367)

2.5.5 Allgemeine Runtime-Funktionen

2.5.5.1 Allgemeine Runtime-Funktionen

Überblick Die allgemeinen Runtime-Funktionen werden zum Öffnen und Schließen von Anwenderarchiven und Sichten in Runtime verwendet.

Für den Zugriff in Runtime müssen Sie zunächst die Funktion "uaConnect" aufrufen. "uaConnect" erstellt den Handle "UAHCONNECT", der zum Öffnen der Anwenderarchive benötigt wird. Mit dem Handle können Sie dann die folgenden Funktionen verwenden. Mit der Funktion "uaDisconnect" müssen Sie die Verbindung zu "User Archive" wieder abbauen.



Die Funktion "uaQueryArchive" bzw. "uaQueryArchiveByName" erstellt den Handle "UAHARCHIVE". Der Handle ist die Voraussetzung für die Nutzung der Funktion "uaArchiveOpen". Mit "uaArchiveOpen" wird das Anwenderarchiv für Runtime geöffnet.

Nach dem Zugriff der Runtime-Funktionen müssen Sie zunächst mit der Funktion "uaArchiveClose" das Anwenderarchiv schließen. Dann bauen Sie mit der Funktion "uaReleaseArchive" die Verbindung zum aktuellen Anwenderarchiv ab.

Funktion BeschreibunguaConnect Verbindung zu User Archive aufbauen. Die Verbindung

gilt in Runtime für alle Anwenderarchive uaDisconnect Baut die Verbindung zu User Archive abuaGetLocalEvents Liest die lokalen EreignisseuaIsActive Abfrage, ob Runtime aktiviert istuaOpenArchives Ermittelt die Anzahl der geöffneten AnwenderarchiveuaOpenViews Ermittelt die Anzahl der geöffneten SichtenuaQueryArchive Baut eine Verbindung zu einem Anwenderarchiv aufuaQueryArchiveByName Baut eine Verbindung zu einem Anwenderarchiv über den

Archivnamen aufuaReleaseArchive Baut die Verbindung zum Anwenderarchiv ab.uaSetLocalEvents Setzt die lokalen EreignisseuaUsers Findet die Anzahl der aktiven Verbindungen bzw. der

aktiven Anwender

2.5.5.2 uaConnect

Beschreibung Verbindung zu User Archive in Runtime aufbauen.

BOOL uaConnect ( UAHCONNECT* phConnect )

ParameterUAHCONNECT* phConnectZeiger auf Handle zum verbundenen User Archive.

ReturnwertTRUE: Erfolgreiche Verbindung zu User Archive

FALSE: Fehler



2.5.5.3 uaDisconnect

Beschreibung Wenn eine Verbindung in Runtime zu User Archive besteht, wird die Verbindung abgebaut.

BOOL uaDisconnect ( UAHCONNECT hConnect )

ParameterUAHCONNECT hConnectHandle zum verbundenen User Archive in Runtime. Der Handle wird mit "uaConnect" eingerichtet.

ReturnwertTRUE: Erfolgreicher Abbau der Verbindung zu User Archive

FALSE: Fehler

2.5.5.4 uaGetLocalEvents

Beschreibung Die lokalen Ereignisse werden gelesen.

BOOL uaGetLocalEvents ( UAHCONNECT hConnect )


ReturnwertDas lokale Ereignis "bLocalEvents"

2.5.5.5 uaIsActive

Beschreibung Prüft, ob das Anwenderarchiv in Runtime aktiv ist.



BOOL uaIsActive ( UAHCONNECT hConnect )

ParameterUAHCONNECT hConnectHandle zum verbundenen User Archive in Runtime. Dieser Handle wird mit "uaConnect" eingerichtet.

ReturnwertTRUE: Das Anwenderarchiv ist in Runtime aktiv

FALSE: Das Anwenderarchiv ist in Runtime nicht aktiv

2.5.5.6 uaOpenArchives

Beschreibung Abfrage, wie viele Anwenderarchive in Runtime geöffnet sind.

LONG uaOpenArchives ( UAHCONNECT hConnect )


ReturnwertAnzahl der aktuell geöffneten Anwenderarchive

2.5.5.7 uaOpenViews

Beschreibung Abfrage, wie viele Sichten in Runtime geöffnet sind.

LONG uaOpenViews ( UAHCONNECT hConnect )




ReturnwertAnzahl der aktuell geöffneten Sichten

2.5.5.8 uaQueryArchive

Beschreibung Baut die Verbindung zu einem Anwenderarchiv auf. "uaQueryArchive" erstellt den Handle "UAHARCHIVE".

BOOL uaQueryArchive (UAHCONNECT hConnect, LONG lArchive, UAHARCHIVE* phArchive )


LONG lArchiveArchiv-ID (1... uaGetNumArchives). Eine durchgehende Nummerierung der Archiv-IDs kann nicht gewährleistet werden, da Lücken bei der ID-Vergabe entstehen können, z. B. durch Löschen von Archiven.

UAHARCHIVE* phArchiveZeiger auf Handle zum verbundenen Anwenderarchiv.

ReturnwertTRUE: Erfolgreiche Erstellung des Handles zum Anwenderarchiv.



FALSE: Fehler

Hinweis

Wenn Sie die User Archive-Funktionen in einem Client-Projekt verwenden, das auf redundante Serverpaare schaut, schaltet beim Wechsel des Masters die User Archive-Verbindung nicht automatisch auf den neuen Master. In diesem Fall liefern alle User Archive-Aufrufe den Fehler "UA_ERROR_SERVER_UNKNOWN = 1004". Sie müssen erneut die Funktionen "uaQueryArchive" bzw. "uaQueryArchiveByName" und "uaArchiveOpen" aufrufen.

2.5.5.9 uaQueryArchiveByName

Beschreibung Baut die Verbindung zu einem Anwenderarchiv über den Archivnamen auf. "uaQueryArchiveByName" erstellt den Handle "UAHARCHIVE".

BOOL uaQueryArchiveByName (UAHCONNECT hConnect, LPCSTR pszName, UAHARCHIVE* phArchive )


LPCSTR pszNameName des Anwenderarchivs. Wenn bei einem Client-Projekt nicht der Standardserver verwendet wird, können Sie dem Archivnamen ein Serverpräfix und "::" voranstellen.

UAHARCHIVE* phArchiveZeiger auf Handle zum verbundenen Anwenderarchiv.

ReturnwertTRUE: Erfolgreiche Erstellung des Handles zum Anwenderarchiv



FALSE: Fehler

Hinweis

Wenn Sie die User Archive-Funktionen in einem Client-Projekt verwenden, das auf redundante Serverpaare schaut, schaltet beim Wechsel des Masters die User Archive-Verbindung nicht automatisch auf den neuen Master. In diesem Fall liefern alle User Archive-Aufrufe den Fehler "UA_ERROR_SERVER_UNKNOWN = 1004". Sie müssen erneut die Funktionen "uaQueryArchive" bzw. "uaQueryArchiveByName" und "uaArchiveOpen" aufrufen.

2.5.5.10 uaReleaseArchive

Beschreibung Baut die Verbindung zum aktuell verbundenen Anwenderarchiv ab.

BOOL uaReleaseArchive ( UAHARCHIVE hArchive )

ParameterUAHARCHIVE hArchiveHandle des Anwenderarchivs. Der Handle wird mit "uaQueryArchive" bzw. "uaQueryArchiveByName" eingerichtet.

ReturnwertTRUE: Erfolgreicher Abbau der Verbindung zum Anwenderarchiv.

FALSE: Fehler

Hinweis

Beim erfolgreichen Abbau der Verbindung müssen Sie den Handle "hArchive" auf "NULL" setzen. Damit ist gewährleistet, dass bei einer weiteren Verwendung des nicht mehr gültigen Handles der Fehler "UA_ERROR_INVALID_HANDLE" generiert wird. Eine unnötige Speicherbelastung wird vermieden.

2.5.5.11 uaSetLocalEvents

Beschreibung Setzt die lokalen Ereignisse.



void uaSetLocalEvents ( UAHCONNECT hConnect BOOL bLocalEvents )


BOOL bLocalEvents Lokales Ereignis

2.5.5.12 uaUsers

Beschreibung Liefert die Anzahl aller Benutzer, die über "uaConnect" mit dem Anwenderarchiv verbunden sind. Hierbei werden neben den Aufrufen durch den Anwender, z.B. durch Skripte, auch WinCC-interne Aufrufe an das Anwenderarchiv berücksichtigt.

LONG uaUsers ( UAHCONNECT hConnect )


ReturnwertAnzahl der aktiven Verbindungen bzw. Benutzer

2.5.6 Archivspezifischen Runtime-Funktionen

2.5.6.1 Archivspezifische Runtime-Funktionen

Überblick Nach dem Öffnen des Anwenderarchivs mit der Funktion "uaArchiveOpen" können Sie die folgenden Funktionen für die Bedienung des Anwenderarchivs in Runtime verwenden.



Die allgemeine Runtime-Funktion "uaQueryArchive" bzw. "uaQueryArchiveByName" erstellt den Handle "UAHARCHIVE". Der Handle ist die Voraussetzung für die Nutzung der Funktion "uaArchiveOpen".

Nach dem Zugriff der Runtime-Funktionen müssen Sie mit der Funktion "uaArchiveClose" das Anwenderarchiv schließen. Dann bauen Sie mit der allgemeinen Runtime-Funktion "uaReleaseArchive" die Verbindung zum aktuellen Anwenderarchiv ab.

Hinweis

Die Funktionen "uaArchiveSetSort" und "uaArchiveSetFilter" können Sie verwenden, ohne das Anwenderarchiv mit "uaArchiveOpen" zu öffnen.

Funktion BeschreibunguaArchiveClose Die Verbindung zum aktuellen Anwenderarchiv wird

abgebautuaArchiveDelete Löscht einen Datensatz im aktuellen AnwenderarchivuaArchiveExport Exportiert das aktuelle Anwenderarchiv uaArchiveGetCount Liest die Anzahl der DatensätzeuaArchiveGetFieldLength Liest die Länge des aktuellen FeldsuaArchiveGetFieldName Liest den Namen des aktuellen FeldsuaArchiveGetFields Liest die Anzahl der FelderuaArchiveGetFieldType Liest den Typ des aktuellen FeldsuaArchiveGetFieldValueDate Liest Datum und Uhrzeit des aktuellen DatenfelduaArchiveGetFieldValueDouble Liest den Double-Wert des aktuellen DatenfeldsuaArchiveGetFieldValueFloat Liest den Float-Wert des aktuellen DatenfeldsuaArchiveGetFieldValueLong Liest den Long-Wert des aktuellen DatenfeldsuaArchiveGetFieldValueString Liest den String des aktuellen DatenfeldsuaArchiveGetFilter Liest den Filter des aktuellen DatenfeldsuaArchiveGetID Liest die ID des aktuellen DatenfeldsuaArchiveGetName Liest den Namen des aktuellen DatenfeldsuaArchiveGetSort Liest die Sortierung des aktuellen DatenfeldsuaArchiveImport Importiert das AnwenderarchivuaArchiveInsert Fügt neuen Datensatz in das Anwenderarchiv einuaArchiveMoveFirst Geht zum ersten DatensatzuaArchiveMoveLast Geht zum letzten DatensatzuaArchiveMoveNext Geht zum nächsten DatensatzuaArchiveMovePrevious Geht zum vorherigen DatensatzuaArchiveOpen Die Verbindung zum aktuellen Anwenderarchiv wird

erstelltuaArchiveReadTagValues Liest die Variablen-WerteuaArchiveReadTagValuesByName Liest die Variablen- Werte bezogen auf den NamenuaArchiveRequery Neue AnfrageuaArchiveSetFieldValueDate Schreibt das aktuelle DatenfelduaArchiveSetFieldValueDouble Schreibt den Double-Wert des aktuellen Datenfelds



uaArchiveSetFieldValueFloat Schreibt den Float-Wert des aktuellen DatenfeldsuaArchiveSetFieldValueLong Schreibt den Long-Wert des aktuellen DatenfeldsuaArchiveSetFieldValueString Schreibt den String des aktuellen DatenfeldsuaArchiveSetFilter Setzt den FilteruaArchiveSetSort Setzt das SortierkriteriumuaArchiveUpdate Aktualisiert das geöffnete AnwenderarchivuaArchiveWriteTagValues Schreibt die Werte des aktuellen Datensatzes in die

VariableuaArchiveWriteTagValuesByName Schreibt die Werte des aktuellen Datensatzes in die

Variable bezogen auf den Namen

2.5.6.2 uaArchiveClose

Beschreibung Schließt das aktuell geöffnete Anwenderarchiv.

BOOL uaArchiveClose ( UAHARCHIVE hArchive )


ReturnwertTRUE: Erfolgreiches Schließen des Anwenderarchivs

FALSE: Fehler

2.5.6.3 uaArchiveDelete

Beschreibung Löscht die Daten aus einem Anwenderarchiv. Das projektierte Anwenderarchiv bleibt erhalten.

BOOL uaArchiveDelete ( UAHARCHIVE hArchive, LPCSTR pszWhere )

ParameterUAHARCHIVE hArchive



Handle des Anwenderarchivs. Der Handle wird mit "uaQueryArchive" bzw. "uaQueryArchiveByName" eingerichtet.

LPCSTR pszWhereString mit der SQL-Selektion der zu löschenden Datensätze. Der String entspricht der SQL-Anweisung "DELETE FROM <archive> WHERE pszWhere".

Hinweis

Wenn "pszWhere" leer ist, wird das gesamte Anwenderarchiv gelöscht.

ReturnwertTRUE: Erfolgreiches Löschen des Anwenderarchivs

FALSE: Fehler

2.5.6.4 uaArchiveExport

Beschreibung Exportiert das aktuelle Anwenderarchiv in eine CSV-Datei.

BOOL uaArchiveExport ( UAHARCHIVE hArchive, LPCSTR pszDestination, LONG lType, LONG lOptions )


LPCSTR pszDestinationName der Zieldatei. Beim Aufruf der Funktion auf Clients bezieht sich die Pfadangabe auf den Serverrechner.

LONG lTypeDatenformat der Zieldatei. Zwei Formate stehen zur Verfügung:

● "UA_FILETYPE_DEFAULT = 0": Das voreingestellte Dateiformat "CSV".

● "UA_FILETYPE_CSV = 1": CSV-Dateiformat

LONG lOptions



Optionen, für spätere Erweiterungen reserviert. "lOptions" muss den Wert "0" haben.

ReturnwertTRUE: Erfolgreiches Exportieren des Anwenderarchivs

FALSE: Fehler

2.5.6.5 uaArchiveGetCount

Beschreibung Liest die Anzahl der Datensätze.

LONG uaArchiveGetCount( UAHARCHIVE hArchive, LONG * plCount )


LONG plCount Zeiger auf eine Variable, in der die Anzahl der Datensätze abgelegt werden.

ReturnwertAnzahl der Datensätze. Bei "0" ist das Archiv leer oder ein Fehler ist aufgetreten. Die Abfrage mit "uaGetLastError" ist erforderlich.

2.5.6.6 uaArchiveGetFieldLength

Beschreibung Liest die Länge eines Felds im aktuellen Datensatz.

LONG uaArchiveGetFieldLength( UAHARCHIVE hArchive, LONG lField )





LONG lFieldDie Feldnummer, wobei "lField = 1" das erste projektierte Feld adressiert. Mit "lField = 0" wird das Feld "ID" adressiert.

ReturnwertLänge des aktuellen Felds

2.5.6.7 uaArchiveGetFieldName

Beschreibung Liest den Namen eines Felds im aktuellen Datensatz.

VOID uaArchiveGetFieldName ( UAHARCHIVE hArchive, LONG lField, LPCSTR pszName, LONG cMaxLen )



LPCSTR pszNameFeldname

LONG cMaxLenMaximale Länge

2.5.6.8 uaArchiveGetFields

Beschreibung Liest die Anzahl der projektierten Datenfelder. Die Felder "ID", "Letzter Benutzer" und "Letzter Zugriff" werden mitgezählt. In den Aufrufen in Runtime werden die Indizes der projektierten



Felder mit "1" bis "N" angegeben. Das Feld "ID" hat den Index "0". Die Felder "Letzter Benutzer" und "Letzter Zugriff" werden am Ende der projektierten Felder angehängt.

LONG uaArchiveGetFields ( UAHARCHIVE hArchive )


ReturnwertAnzahl der projektierten Felder.

2.5.6.9 uaArchiveGetFieldType

Beschreibung Liest den Typ eines Felds im aktuellen Datensatz.

LONG uaArchiveGetFieldType (UAHARCHIVE hArchive,LONG lField )



ReturnwertTyp des aktuellen Felds.

Die symbolischen Bezeichnungen für die Feldtypen sind:

● UA_FIELDTYPE_INTEGER

● UA_FIELDTYPE_FLOAT

● UA_FIELDTYPE_DOUBLE



● UA_FIELDTYPE_STRING

● UA_FIELDTYPE_DATETIME

2.5.6.10 uaArchiveGetFieldValueDate

Beschreibung Liest Datum und Uhrzeit eines Felds im aktuellen Datensatz.

BOOL uaArchiveGetFieldValueDate (UAHARCHIVE hArchive,LONG lField, LPSYSTEMTIME pstDateTime )



LPSYSTEMTIME pstDateTimeZeiger auf Variable vom Typ "SYSTEMTIME"

ReturnwertTRUE: Erfolgreiches Lesen von Datum und Uhrzeit

FALSE: Fehler

2.5.6.11 uaArchiveGetFieldValueDouble

Beschreibung Liest "Double"-Wert eines Felds im aktuellen Datensatz.

BOOL uaArchiveGetFieldValueDouble (UAHARCHIVE hArchive,LONG lField, double* pdValue )





double* pdValueZeiger auf Variable für den aktuellen Feldinhalt.

ReturnwertTRUE: Erfolgreiches Lesen des Werts.

FALSE: Fehler

2.5.6.12 uaArchiveGetFieldValueFloat

Beschreibung Liest "Float"-Wert eines Felds im aktuellen Datensatz.

BOOL uaArchiveGetFieldValueFloat (UAHARCHIVE hArchive,LONG lField, FLOAT* pfValue )



FLOAT* pfValueZeiger auf Variable für den aktuellen Feldinhalt.

ReturnwertTRUE: Erfolgreiches Lesen des Werts

FALSE: Fehler



2.5.6.13 uaArchiveGetFieldValueLong

Beschreibung Liest "Long"-Wert eines Felds im aktuellen Datensatz.

BOOL uaArchiveGetFieldValueLong (UAHARCHIVE hArchive,LONG lField, LONG* pdValue )



LONG* pdValueZeiger auf Variable für den aktuellen Feldinhalt.

ReturnwertTRUE: Erfolgreiches Lesen des Werts.

FALSE: Fehler

2.5.6.14 uaArchiveGetFieldValueString

Beschreibung Liest den String eines Felds im aktuellen Datensatz.

BOOL uaArchiveGetFieldValueString (UAHARCHIVE hArchive,LONG lField, LPSTR pszString,LONG cMaxLen )






LPCSTR pszStringWert als String.

LONG cMaxLenMaximale Länge des String.

ReturnwertTRUE: Erfolgreiches Lesen des Werts

FALSE: Fehler

2.5.6.15 uaArchiveGetFilter

Beschreibung Liest die Selektionskriterien des aktuellen Datensatzes.

VOID uaArchiveGetFilter ( UAHARCHIVE hArchive, LPSTR pszFilter, LONG cMaxLen )


LPSTR pszFilterSelektionskriterium in SQL.

LONG cMaxLenMaximale Länge.

2.5.6.16 uaArchiveGetID

Beschreibung Liest die "ID" des Anwenderarchivs.



LONG uaArchiveGetID ( UAHARCHIVE hArchive )


Returnwert"ID" des Anwenderarchivs

2.5.6.17 uaArchiveGetName

Beschreibung Liest den Namen des Anwenderarchivs.

VOID uaArchiveGetName (UAHARCHIVE hArchive,LPSTR pszName,LONG cMaxLen )


LPSTR pszNameZeiger auf Puffer für Name des Anwenderarchivs.


Beispielchar tank [40];

uaArchiveGetName( hArchive, tank, 39 );



2.5.6.18 uaArchiveGetSort

Beschreibung Liest die Sortierungskriterien des Anwenderarchivs.

VOID uaArchiveGetSort (UAHARCHIVE hArchive,LPSTR pszSort,LONG cMaxLen )


LPCSTR pszSortSortierungskriterien in SQL.


2.5.6.19 uaArchiveImport

Beschreibung Importiert ein Anwenderarchiv mit CSV-Datenformat. Die Struktur des Zielarchivs muss identisch sein mit dem importierten CSV-Archiv.

BOOL uaArchiveImport (UAHARCHIVE hArchive,LPCSTR pszSource,LONG lType,LONG lOptions )


LPCSTR pszSourceDateiname des Quellarchivs.

LONG lType



Datenformat des Quellarchivs. Zwei Formate stehen zur Verfügung:

● "UA_FILETYPE_DEFAULT = 0": Das voreingestellte Dateiformat "CSV".

● "UA_FILETYPE_CSV = 1": CSV-Dateiformat

LONG lOptionsOptionen, für spätere Erweiterungen reserviert. "lOptions" muss den Wert "0" haben.

ReturnwertTRUE: Erfolgreiches Importieren des Anwenderarchivs

FALSE: Fehler

2.5.6.20 uaArchiveInsert

Beschreibung Fügt den lokalen Datensatzpuffer in das Archiv ein. Damit sinnvolle Daten im neuen Datensatz stehen, müssen Sie die Felder des lokalen Datensatzpuffers vor dem Aufruf von "uaArchiveInsert" mit den Funktionen "uaArchiveSetFieldValue..." beschreiben.Das interne Feld "ID" müssen Sie mit der Funktion "uaArchiveSetFieldValueLong" mit einer im Archiv noch nicht vorhandenen ID oder mit 0 beschreiben."

BOOL uaArchiveInsert (UAHARCHIVE hArchive )


ReturnwertTRUE: Erfolgreiches Einfügen des Datensatzes.

2.5.6.21 uaArchiveMoveFirst

Beschreibung Geht zum ersten Datensatz.

BOOL uaArchiveMoveFirst (UAHARCHIVE hArchive )




ReturnwertTRUE: Erfolgreicher Sprung im Anwenderarchiv

FALSE: Fehler

2.5.6.22 uaArchiveMoveLast

Beschreibung Geht zum letzten Datensatz.

BOOL uaArchiveMoveLast (UAHARCHIVE hArchive )



FALSE: Fehler

2.5.6.23 uaArchiveMoveNext

Beschreibung Geht zum nächsten Datensatz.

BOOL uaArchiveMoveNext (UAHARCHIVE hArchive )





FALSE: Fehler

2.5.6.24 uaArchiveMovePrevious

Beschreibung Geht zum vorherigen Datensatz.

BOOL uaArchiveMovePrevious (UAHARCHIVE hArchive )



FALSE: Fehler

2.5.6.25 uaArchiveOpen

Beschreibung Öffnet ein vorhandenes Anwenderarchiv. Der Aufruf von "uaArchiveOpen" ist notwendig, wenn Sie Lese- oder Schreiboperationen im Anwenderarchiv nutzen. Z.B. vor Aufruf der Funktionen "uaArchiveMoveNext", "uaArchiveDelete" oder "uaArchiveUpdate".

BOOL uaArchiveOpen (UAHARCHIVE hArchive )


ReturnwertTRUE: Erfolgreiches Öffnen des Anwenderarchivs



FALSE: Fehler

2.5.6.26 uaArchiveReadTagValues

Beschreibung Liest die aktuellen Werte aus den Feldvariablen.

BOOL uaArchiveReadTagValues (UAHARCHIVE hArchive,LONG* pnFields,LONG cFields,LONG lOptions )


LONG* pnFieldsFür spätere Erweiterungen reserviert. "pnFields" muss den Wert "0" haben.

LONG cFieldsAnzahl der übergebenen Feldindizes. Entspricht der Größe des Arrays "pnFields". Für spätere Erweiterungen reserviert. "cFields" muss den Wert "0" haben.

LONG lOptionsOptionen. Für spätere Erweiterungen reserviert. "lOptions" muss den Wert "0" haben. Für alle anderen Werte von "lOptions" werden die Daten an der Position des Zeigers eingefügt.

ReturnwertTRUE: Erfolgreiches Lesen im Anwenderarchiv

FALSE: Fehler

2.5.6.27 uaArchiveReadTagValuesByName

Beschreibung Liest die Variablenwerte in den aktuellen Daten.

BOOL uaArchiveReadTagValuesByName (UAHARCHIVE hArchive,LPCSTR pszFields,



LONG lOptions )


LPCSTR pszFieldsFür spätere Erweiterungen reserviert. "pszFields" muss den Wert "NULL" haben.

LONG lOptionsOptionen. Für spätere Erweiterungen reserviert. "lOptions" muss den Wert "0" haben.

ReturnwertTRUE: Erfolgreiches Lesen im Anwenderarchiv

FALSE: Fehler

2.5.6.28 uaArchiveRequery

Beschreibung Nach dem Aufruf von "uaArchiveSetFilter" und "uaArchiveSetSort" müssen Sie das Anwenderarchiv mit "uaArchiveRequery" neu laden.

Rufen Sie "uaArchiveRequery" auch auf:

● Wenn Sie Werte im UserArchive Control eingegeben haben.

● Wenn Sie Werte im Editor "User Archive" eingegeben haben, die im Tabellenfenster übernommen werden.

Hinweis

Die Funktionen "uaArchiveSetSort" und "uaArchiveSetFilter" können Sie verwenden, ohne das Anwenderarchiv mit "uaArchiveOpen" zu öffnen. In diesem Fall müssen Sie die Funktion "uaArchiveRequery" nicht aufrufen.

BOOL uaArchiveRequery(UAHARCHIVE hArchive )




ReturnwertTRUE: Erfolgreiche Abfrage der Daten

FALSE: Fehler

2.5.6.29 uaArchiveSetFieldValueDate

Beschreibung Schreibt Datum und Uhrzeit in ein Feld im aktuellen Datensatz.

BOOL uaArchiveSetFieldValueDate (UAHARCHIVE hArchive,LONG lField, LPSYSTEMTIME pstDateTime )



LPSYSTEMTIME pstDateTimeDatum und Uhrzeit für das bestimmte Feld.

ReturnwertTRUE: Erfolgreiches Schreiben von Datum und Uhrzeit

FALSE: Fehler

2.5.6.30 uaArchiveSetFieldValueDouble

Beschreibung Schreibt "Double"-Wert in ein Feld im aktuellen Datensatz.

BOOL uaArchiveSetFieldValueDouble (UAHARCHIVE hArchive,LONG lField, double dValue )





double dValueWert für das bestimmte Feld.

ReturnwertTRUE: Erfolgreiches Schreiben des Werts

FALSE: Fehler

2.5.6.31 uaArchiveSetFieldValueFloat

Beschreibung Schreibt "Float"-Wert in ein Feld im aktuellen Datensatz.

BOOL uaArchiveSetFieldValueFloat (UAHARCHIVE hArchive,LONG lField, float fValue )



float fValueWert für das bestimmte Feld.


FALSE: Fehler



2.5.6.32 uaArchiveSetFieldValueLong

Beschreibung Schreibt "Long"-Wert in ein Feld im aktuellen Datensatz.

BOOL uaArchiveSetFieldValueLong (UAHARCHIVE hArchive,LONG lField, LONG dValue )



LONG dValueWert für das bestimmte Feld.


FALSE: Fehler

2.5.6.33 uaArchiveSetFieldValueString

Beschreibung Schreibt einen String in ein Feld im aktuellen Datensatz.

BOOL uaArchiveSetFieldValueString (UAHARCHIVE hArchive,LONG lField, LPCSTR pszString )





LPCSTR pszStringString für das bestimmte Feld.

ReturnwertTRUE: Erfolgreiches Schreiben des String

FALSE: Fehler

2.5.6.34 uaArchiveSetFilter

Beschreibung Setzt die Selektionskriterien für das Anwenderarchiv. Sie können die Funktion auch aufrufen, ohne das Archiv mit "uaArchiveOpen" zu öffnen.

Hinweis

Wenn Sie das Anwenderarchiv mit "uaArchiveOpen" geöffnet haben, laden Sie mit "uaArchiveRequery" das Anwenderarchiv nach dem Filtern neu.

VOID uaArchiveSetFilter ( UAHARCHIVE hArchive, LPSTR pszFilter )


LPSTR pszFilterSelektionskriterium in SQL.



2.5.6.35 uaArchiveSetSort

Beschreibung Setzt die Sortierung des Anwenderarchivs. Sie können die Funktion auch aufrufen, ohne das Archiv mit "uaArchiveOpen" zu öffnen.

Hinweis

Wenn Sie das Anwenderarchiv mit "uaArchiveOpen" geöffnet haben, laden Sie mit "uaArchiveRequery" das Anwenderarchiv nach dem Sortieren neu.

BOOL uaArchiveSetSort (UAHARCHIVE hArchive,LPSTR pszSort )


LPCSTR pszSortSortierungskriterien in SQL.

ReturnwertTRUE: Erfolgreiche Sortierung

FALSE: Fehler

2.5.6.36 uaArchiveUpdate

Beschreibung Aktualisiert das geöffnete Anwenderarchiv. Alle Datenänderungen eines Anwenderarchivs werden in die Datenbank übernommen. Die Projektierung des Anwenderarchivs bleibt unverändert.

BOOL uaArchiveUpdate (UAHARCHIVE hArchive )





ReturnwertTRUE: Erfolgreiche Aktualisierung des Anwenderarchivs

FALSE: Fehler "Update_failed = 106". Der Fehler tritt bei einer Konsistenz-Verletzung auf. Z.B. ist für ein Feld die Option "Feld muss einen Wert besitzen" gesetzt, im Feld ist aber kein Wert vorhanden.

2.5.6.37 uaArchiveWriteTagValues

Beschreibung Schreibt die Werte des aktuellen Datensatzes in die Variable. Erst wenn dieser synchrone Schreibauftrag abgearbeitet wurde, werden darauf folgende Skripte weiterverarbeitet.

BOOL uaArchiveWriteTagValues (UAHARCHIVE hArchive,LONG* pnFields,LONG cFields,LONG lOptions )


LONG* pnFieldsFür spätere Erweiterungen reserviert. "pnFields" muss den Wert "0" haben.

LONG cFieldsAnzahl der übergebenen Feldindizes. Entspricht der Größe des Arrays "pnFields". Für spätere Erweiterungen reserviert. "cFields" muss den Wert "0" haben.


ReturnwertTRUE: Erfolgreiches Schreiben im Anwenderarchiv

FALSE: Fehler



2.5.6.38 uaArchiveWriteTagValuesByName

Beschreibung Schreibt die Werte des aktuellen Datensatzes in die Variable.

BOOL uaArchiveWriteTagValuesByName (UAHARCHIVE hArchive,LPCSTR pszFields,LONG lOptions )


LPCSTR pszFieldsFür spätere Erweiterungen reserviert. "pszFields" muss den Wert "NULL" haben.


ReturnwertTRUE: Erfolgreiches Schreiben im Anwenderarchiv

FALSE: Fehler

2.5.7 Funktionen zur Fehlersuche

2.5.7.1 uaGetLastError

Beschreibung Viele User Archive-Funktionen geben einen BOOL-Wert zurück. Der Wert "TRUE" bedeutet eine fehlerfreie Verarbeitung der Funktion. Wenn der Wert "FALSE" zurückgegeben wird, kann mit den Funktionen "uaGetLastError" und "uaGetLastHResult" der Fehler der zuletzt verwendeten Funktion ausgelesen werden.

Wenn "uaGetLastError" aufgerufen wird, nachdem schon mehrere Funktionen abgearbeitet wurden, wird der zuletzt aufgetretene Fehler zurückgegeben. Damit Sie genau wissen, bei welcher Funktion der Fehler auftrat, müssen Sie nach jedem Aufruf einer Funktion mit einem BOOL-Wert die Funktionen "uaGetLastError" und "uaGetLastHResult" aufrufen.



Beispielif ( uaArchiveGetFieldValueLong ( hArchive, Index, &IntValue ) == TRUE )printf( "Field Value = %u\n", IntValue );elseprintf("Error calling uaArchiveGetFieldValueLong: %d / %08lx\n", uaGetLastError(), uaGetLastHResult());Bei Funktionen, die keinen Rückgabewert liefern (VOID), müssen Sie in jedem Fall die Funktion "uaGetLastError" aufrufen:

uaArchiveGetFilter(hArchive, pszFilter, cMaxLen); INT nUAError = uaGetLastError ( ); if ( UA_ERROR_SUCCESS != nUAError) { printf( "Filter = [%s]\n", pszFilter ); } else { printf("Error calling uaArchiveGetFilter: %d, hr=0x%08lX\n", nUAError, uaGetLastHResult()); }INT uaGetLastError()

ReturnwertFehlerstatus der zuletzt ausgeführten Funktion. Die Fehler-Konstanten und die "Predefines" der User Archive-Funktionen befinden sich in "CCUACAPI.H".

Folgende Fehler werden von "uaGetLastError" zurückgegeben:

● UA_ERROR_SUCCESS

● UA_ERROR_GENERIC

● UA_ERROR_CONNECT_FAILED

● UA_ERROR_OPEN_FAILED

● UA_ERROR_CLOSE_FAILED

● UA_ERROR_REQUERY_FAILED

● UA_ERROR_MOVE_FAILED

● UA_ERROR_INSERT_FAILED

● UA_ERROR_UPDATE_FAILED

● UA_ERROR_DELETE_FAILED

● UA_ERROR_IMPORT_FAILED



● UA_ERROR_EXPORT_FAILED

● UA_ERROR_READ_FAILED

● UA_ERROR_WRITE_FAILED

● UA_ERROR_GET_FAILED

● UA_ERROR_SET_FAILED

● UA_ERROR_INVALID_NAME

● UA_ERROR_INVALID_TYPE

● UA_ERROR_INVALID_NUMRECS

● UA_ERROR_INVALID_COMMTYPE

● UA_ERROR_INVALID_LENGTH

● UA_ERROR_INVALID_PRECISION

● UA_ERROR_NULL_POINTER

● UA_ERROR_INVALID_POINTER

● UA_ERROR_INVALID_HANDLE

● UA_ERROR_INVALID_INDEX

● UA_ERROR_SERVER_UNKNOWN

2.5.7.2 uaGetLastHResult

Beschreibung Liest den zuletzt aufgetretenen COM-Fehler. Die Funktion dient vor allem der Diagnose von Inkompabilitäten bei der verwendeten COM-Implementierung oder zum Auffinden von Registrierungsfehlern und Kommunikationsstörungen.Die Funktion sollen Sie zusätzlich zu "uAGetLastError" verwenden, wenn eine User Archive-Funktion ein "FALSE" zurückgibt.

LONG uaGetLastHResult()

ReturnwertZuletzt aufgetretener COM-Fehler



2.6 WinCC UserArchiveControl

2.6.1 WinCC UserArchiveControl

Funktionsumfang Das WinCC UserArchiveControl bietet Zugriffsmöglichkeiten auf Archive und Sichten von Anwenderarchiven. Sie können in Runtime:

● Datensätze anlegen, löschen oder ändern

● Im Anwenderarchiv blättern

● Variablen bei direkter Variablenanbindung lesen und schreiben

● Anwenderarchive importieren und exportieren

● Selektionskriterien definieren, um nur einen bestimmten Teil des Anwenderarchivs anzuzeigen

● Sortierbedingungen für die angezeigten Spalten definieren

EigenschaftenEin UserArchiveControl verbinden Sie bei der Projektierung mit einem ausgewählten Anwenderarchiv oder einer Sicht. Für den Zugriff muss das Anwenderarchiv oder die Sicht freigegeben sein. Wenn Sie den Zugriffsschutz aufheben, müssen Sie im Konfigurationsdialog das WinCC UserArchiveControl neu mit dem Anwenderarchiv verbinden.

Der Zugriffsschutz für ein Anwenderarchiv oder Feld wird beim Bildaufschlag des UserArchiveControl abgefragt:

User Archive2.6 WinCC UserArchiveControl


● Wenn der Benutzer keine Berechtigung zum Lesen des Anwenderarchivs hat, werden keine Daten, aber die Spaltenüberschriften in der Tabelle angezeigt.

● Wenn der Benutzer keine Berechtigung zum Lesen eines Feldes hat, wird die entsprechende Spalte in der Tabelle nicht angezeigt.

● Wenn der Benutzer keine Berechtigung zum Schreiben des Anwenderarchivs hat, kann der Benutzer die Daten in der Tabelle nicht bearbeiten.

● Wenn der Benutzer keine Berechtigung zum Schreiben eines Feldes hat, kann der Benutzer die Daten der entsprechenden Spalte in der Tabelle nicht bearbeiten.

Einen Zugriffsschutz für die Steuervariablen eines geschützten Archivs müssen Sie über die Objekteigenschaften z.B. eines Bildes, eines EA-Feldes oder einer Schaltfläche separat projektieren.

Siehe auchEinführung User Archive/Anwenderarchive (Seite 315)

2.6.2 Projektierung des UserArchiveControl

2.6.2.1 So projektieren Sie das UserArchiveControl

Einleitung Die Werte des Anwenderarchivs werden in Runtime in einem ActiveX Control angezeigt. Im Graphics Designer projektieren Sie dafür ein WinCC UserArchiveControl.



Voraussetzung● Sie haben ein Archiv oder eine Sicht im Anwenderarchiv projektiert.

Projektierungsschritte1. Binden Sie das WinCC UserArchiveControl in ein Bild des Graphics Designer ein.

2. Projektieren Sie auf der Registerkarte "Allgemeines" die Grundeigenschaften des UserArchiveControl:

– die Eigenschaften des Tabellenfensters

– die allgemeinen Eigenschaften des Controls

– die Zeitbasis des Controls

– die Bearbeitungsmöglichkeiten der Inhalte im Control

3. Verbinden Sie das UserArchiveControl mit einem Archiv oder einer Sicht des Anwenderarchivs.

4. Legen Sie den Inhalt der Tabelle des UserArchiveControl fest, indem Sie die ausgewählten Spalten aus dem Anwenderarchiv konfigurieren.

5. Projektieren Sie die Darstellung und Eigenschaften der Tabelle auf den Registerkarten "Parameter", "Darstellung" und "Markierung".

6. Konfigurieren Sie die Symbolleiste und Statuszeile des Tabellenfensters auf den entsprechenden Registerkarten




2.6.2.2 So bestimmen Sie die Inhalte des UserArchiveControl

Einleitung Das WinCC UserArchiveControl zeigt in einer Tabelle die Daten des verbundenen Anwenderarchivs. Der angezeigte Inhalt der Tabelle wird bestimmt von den ausgewählten Spalten des Anwenderarchivs und der Selektion von Inhalten der Spalten.

Voraussetzung● Sie haben ein oder mehrere Anwenderarchive bzw. Sichten angelegt.

● Sie haben das UserArchiveControl mit einem Anwenderarchiv oder einer Sicht verbunden.



Konfigurieren der Spalten des Anwenderarchivs1. Gehen Sie zur Registerkarte "Spalten".

2. In der Liste "Spalten" sehen Sie die Felder des verbundenen Archivs bzw. Sicht. Wenn ein Haken im Optionskästchen vor den Namen der Spalte gesetzt ist, wird die Spalte in der Tabelle angezeigt. Deaktivieren Sie mit der Maus das Optionkästchen, wenn die Spalte nicht dargestellt wird.

3. Legen Sie die Reihenfolge der Spalten in der Tabelle mit den Schaltflächen "Auf" bzw. "Ab" fest.

4. Wählen Sie eine Spalte aus, um die Eigenschaften und das Format zu konfigurieren.

5. Ändern Sie bei Bedarf die Breite der Spalte in der Tabelle. Geben Sie einen Wert in das Feld "Länge in Zeichen" ein.



6. Einige Spalten können den Inhalt und die Überschrift auch als Symbol darstellen. Bestimmen Sie im Feld "Darstellung", wie diese Spalten dargestellt werden. Text und Symbol können gemeinsam angezeigt werden.


Selektion der Inhalte der Spalte, die in der Tabelle angezeigt werdenIm Bereich "Selektion" projektieren Sie Kriterien, die bei der Anzeige der Inhalte in den Spalten berücksichtigt werden.

Vorgehensweise1. Klicken Sie auf "Bearbeiten...". Der Selektionsdialog wird geöffnet.

2. Legen Sie die Kriterien für Anzeige fest. Nähere Informationen zur Selektion von Spalten erfahren Sie unter So selektieren Sie Daten des Anwenderarchivs .

3. Beenden Sie den Selektionsdialog mit "OK". Die Selektion wird beim Start von Runtime in der Tabelle des UserArchiveControl berücksichtigt.



Projektierung der Sortierung von SpaltenIm Bereich "Sortierung" projektieren Sie die Sortierung der Spalten in der Tabelle des UserArchiveControl. Sie können auch in Runtime über Tastenfunktionen die Sortierkriterien festlegen.

1. Klicken Sie auf die Schaltfläche "Bearbeiten...". Der Sortier-Dialog öffnet sich.

2. Legen Sie eine Sortierabfolge fest. Nähere Informationen zur Sortierung von Spalten erfahren Sie unter So sortieren Sie die Anzeige der Anwenderarchivdaten .

3. Beenden Sie den Sortier-Dialog mit "OK".

4. Speichern Sie die Projektierung der Inhalte des UserArchiveControl.

2.6.2.3 So projektieren Sie die Darstellung der Tabelle

So projektieren Sie die Eigenschaften der Tabellenelemente

EinleitungSie können die Eigenschaften der Tabellenelemente in den WinCC Controls ihren Bedürfnissen anpassen.

Voraussetzung● Sie haben den Graphics Designer geöffnet und ein Bild mit einem WinCC Control projektiert.

● Der Konfigurationsdialog des WinCC Control ist geöffnet.



Vorgehensweise1. Gehen Sie zur Registerkarte "Parameter".

2. Legen Sie hier die Eigenschaften fest bezüglich:

– Spaltenüberschrift

– Zeilenbeschriftung

– Sortieren

– Tabelleninhalt


So projektieren Sie die Farben der Tabellenelemente

Einleitung Sie können die Farben der Tabellenelemente in den WinCC Controls ihren Bedürfnissen anpassen.





Vorgehensweise1. Gehen Sie zur Registerkarte "Darstellung".

2. Legen Sie hier die Farben für Hintergrund bzw. Schrift fest bezüglich:

– Tabelleninhalt. Für gerade und ungerade Zeilennummern können Sie zur besseren Unterscheidung verschiedene Farben festlegen.

– des Inhalts in der Tabellenüberschrift

– Trennlinien in der Tabelle und um die Tabellenüberschriften

3. Legen Sie im Bereich "Allgemeines" die Farbe und die Linienstärke fest bezüglich:

– Rahmen um das Control

– Fenster-Trennlinien um die Elemente des Controls




So projektieren Sie die Markierung der ausgewählten Zellen und Zeilen

EinleitungSie können die Markierungen der der ausgewählten Zellen und Zeilen in den WinCC Controls ihren Bedürfnissen anpassen.



Vorgehensweise1. Gehen Sie zur Registerkarte "Markierung".

2. Legen Sie fest, ob Zeilen oder nur Zellen mit der Maus markierbar sind.

3. Projektieren Sie die Eigenschaften des Auswahlrechtecks, das um die markierten Zellen bzw. Zeilen der Tabelle dargestellt werden kann.

4. Projektieren Sie bei Bedarf die Markierungsfarben für die markierbaren Zellen und/oder Zeilen. Mit der Eigenschaft "Automatische Farbgebung" wird für die Markierung die vom System festgelegte Farbe verwendet.


So projektieren Sie das Sortieren über die Spaltenüberschrift

EinleitungSie können das Sortieren über die Spaltenüberschrift einer Tabelle in den WinCC Controls ihren Bedürfnissen anpassen.





Vorgehensweise1. Gehen Sie zur Registerkarte "Parameter".

2. Legen Sie fest, ob und wie ein Sortieren über die Spaltenüberschrift zulässig ist. Im WinCC AlarmControl können Sie nur dann über die Spaltenüberschrift sortieren, wenn die Option "Auto-Scrolling" deaktiviert ist. Sie deaktivieren "Auto-Scrolling " entweder auf der Registerkarte "Allgemeines" oder über das Symbol "Autoscroll" in der Symbolleiste des WinCC AlarmControl.

3. Bestimmen Sie die Sortierabfolge beim Mausklick auf die Spaltenüberschrift. Zur Auswahl stehen entweder die Sortierung aufwärts, abwärts und keine oder die Sortierung aufwärts und abwärts.

4. Projektieren Sie Sortiersymbol und Sortierindex, die rechtsbündig in der Spaltenüberschrift dargestellt werden. Sie zeigen Sortierabfolge und Sortierreihenfolge der Spalten an.

5. Wenn Sie die Option "Sortiertaste verwenden" aktivieren, wird über dem vertikalem Rollbalken das Sortiersymbol als Sortiertaste angezeigt. Über die Sortiertaste sortieren Sie mit einem Mausklick die ausgewählte Spalte in der projektierten Sortierreihenfolge. Wenn in der Tabelle kein vertikaler Rollbalken vorhanden ist, wird die Sortiertaste nicht angezeigt.




2.6.2.4 So konfigurieren Sie die Symbolleiste und die Statuszeile

Einleitung Sie bedienen die WinCC Controls in Runtime über die Tastenfunktionen in der Symbolleiste. Die Statuszeile enthält Hinweise zum aktuellen Stand des WinCC Controls. Sie können die Symbolleiste und die Statuszeile für jedes WinCC Control bei der Projektierung oder während Runtime anpassen.

Voraussetzung● Bei der Projektierung haben Sie im Graphics Designer ein Bild mit einem WinCC Control

geöffnet.

● In Runtime enthält das WinCC Control die Tastenfunktion "Konfigurationsdialog", um den Konfigurationsdialog zu öffnen.




So projektieren Sie die Symbolleiste1. Gehen Sie zur Registerkarte "Symbolleiste". Hier z.B. im WinCC AlarmControl:

2. Aktivieren Sie in der Liste der Tastenfunktionen die Tasten, die Sie zur Bedienung des WinCC Controls in Runtime benötigen. Informationen zu der Funktion der einzelnen Taste erhalten Sie bei der Beschreibung des jeweiligen WinCC Controls unter "Bedienung in Runtime".

3. Bestimmen Sie die Reihenfolge bei der Anzeige der Tastenfunktionen in der Symbolleiste. Wählen Sie Tastenfunktionen in der Liste aus und verschieben Sie die Tastenfunktionen mit den Schaltflächen "Auf" und "Ab".

4. Legen Sie bei Bedarf für die Tastenfunktionen der Symbolleiste ein Hotkey fest.



5. Wenn Sie Bedienberechtigungen den einzelnen Tastenfunktionen zuweisen, wird in Runtime die Tastenfunktion nur für die Benutzer freigegeben, die die entsprechende Berechtigung haben.

6. Wenn Sie die Option "Aktiv" für eine Tastenfunktion deaktivieren, wird die aktivierte Tastenfunktion in Runtime angezeigt, ist aber nicht bedienbar.

7. Zwischen den einzelnen Tastenfunktionen können Sie Trennzeichen setzen. Aktivieren Sie die Option "Separator" bei der Tastenfunktion, die durch ein Trennzeichen begrenzt wird.

8. Konfigurieren Sie die allgemeinen Eigenschaften der Symbolleiste, z.B. Ausrichtung oder Hintergrundfarbe.



So projektieren Sie die Statuszeile1. Gehen Sie zur Registerkarte "Statuszeile". Hier z.B. im WinCC AlarmControl:

2. Aktivieren Sie in der Liste mit den Elementen der Statuszeile die Elemente, die Sie in Runtime benötigen. Informationen zu den Elementen der Statuszeile erhalten Sie bei der Beschreibung des jeweiligen WinCC Controls unter "Bedienung in Runtime".

3. Bestimmen Sie die Reihenfolge bei der Anzeige der Elemente in der Statuszeile. Wählen Sie Elemente in der Liste aus und verschieben Sie die Elemente mit den Schaltflächen "Auf" und "Ab".



4. Wenn Sie die Breite eines Elements der Statuszeile anpassen wollen, deaktivieren Sie die Option "Automatisch" und geben Sie einen Pixel-Wert für die Breite an.

5. Konfigurieren Sie die allgemeinen Eigenschaften der Statuszeile, z.B. Ausrichtung oder Hintergrundfarbe.

2.6.2.5 So exportieren Sie Runtime-Daten

Einleitung Die in den WinCC Controls angezeigten Runtimedaten können Sie über eine Tastenfunktion exportieren. Sie projektieren im Konfigurationsdialog die Bedienung des Datenexports in Runtime.


geöffnet.




So projektieren Sie die Bedienung des Datenexports1. Gehen Sie zur Registerkarte "Export".

2. In "Datenexport-Voreinstellungen" ist bereits ein Standard-Dateiname und ein Standard-Verzeichnis eingetragen. Hier z.B. für das AlarmControl. Legen Sie bei Bedarf einen eigenen Dateinamen und ein Verzeichnis für die Exportdatei fest.Der Dateiname kann sich aus dem selbst gewählten Namen und folgenden Platzhalter zusammensetzen:@OBJECTNAME - Objektname des Controls@CURRENTDATE - aktuelles Datum@CURRENTTIME - aktuelle Zeit

3. Als Datenformat steht zur Zeit das CSV-Format zur Verfügung. Klicken Sie auf , um das Trennzeichen und das Datenformat in der CSV-Datei festzulegen.

4. Bestimmen Sie den Umfang des Datenexports:

– alle Runtimedaten werden exportiert

– ausgewählte Runtimedaten werden exportiert. Dieser Datenexport ist nur in den WinCC Controls mit Tabellendarstellung möglich.

5. Projektieren Sie die Bedienung des Datenexportes in Runtime. Legen Sie fest:

– ob der Benutzer den Dateinamen oder das Verzeichnis ändern darf.

– ob in Runtime der Dialog "Datenexport-Voreinstellungen" angezeigt wird.

6. Wenn "Dialog anzeigen" deaktiviert ist, werden die Daten bei Bedienung der Tastenfunktion "Daten exportieren" sofort in die festgelegte Exportdatei exportiert.


8. Gehen Sie zur Registerkarte "Symbolleiste", um die Tastenfunktion "Daten exportieren" für Runtime zu aktivieren.



ErgebnisIn Runtime können Sie alle oder ausgewählte Daten über die Tastenfunktion in eine festgelegte Datei exportieren.

2.6.2.6 So bestimmen Sie die Auswirkung der Online-Projektierung

Einleitung Ein Benutzer kann in Runtime die WinCC Controls parametrieren. Sie müssen festlegen, wie sich die Online-Projektierung in Runtime auswirkt.

Die in Runtime projektierten Änderungen werden im Konfigurationssystem gesondert zum Bild gespeichert. Dadurch wird das Bild im Konfigurationssystem in seiner ursprünglichen Projektierung beibehalten.


geöffnet.




Vorgehensweise1. Gehen Sie zur Registerkarte "Online-Projektierung". Hier z.B. im OnlineTrendControl:

2. Die Optionsschaltflächen im Feld "Online-Projektierung" können Sie nur im Konfigurationssystem zur Voreinstellung der Online-Projektierung bedienen. In Runtime sind diese Optionsschaltflächen nicht bedienbar.Wählen Sie eine der drei Auswirkungen der Online-Projektierung:

– "nicht beibehalten". Die Online-Projektierungen werden in Runtime nicht beibehalten. Diese Voreinstellung lässt den Benutzer in Runtime keine Optionen zu. Die Online-



Projektierungen gehen beim nächsten Bildwechsel und beim Deaktivieren/Aktivieren des Projekts verloren.

– "während Runtime beibehalten". Diese Voreinstellung lässt den Benutzer in Runtime die Optionen "verwerfen", "beibehalten" oder "zurücksetzen" zu. Mit der Option "beibehalten" werden die Online-Projektierungen beim nächsten Bildwechsel beibehalten, gehen aber beim Deaktivieren/Aktivieren des Projekts verloren.

– "permanent beibehalten". Diese Voreinstellung lässt den Benutzer in Runtime die Optionen "verwerfen", "beibehalten" oder "zurücksetzen" zu. Mit der Option "beibehalten" werden die Online-Projektierungen beim nächsten Bildwechsel und beim Deaktivieren/Aktivieren des Projekts beibehalten.

3. Legen Sie fest, welche Bedienberechtigung der Benutzer haben muss, um Online projektieren zu können.

4. Die Optionsschaltflächen im Feld "Online-Projektierung beim nächsten Bildwechsel" können Sie im Konfigurationssystem und in Runtime bei den Voreinstellungen "während Runtime beibehalten" und "permanent beibehalten" bedienen. Die Option "zurücksetzen" ist nur in Runtime bedienbar, da sich im Konfigurationssystem die ursprüngliche Projektierung befindet.Wählen Sie eine der drei Auswirkungen der Online-Projektierung beim nächsten Bildwechsel:

– Aktivieren Sie "verwerfen", wenn die Online-Projektierung beim nächsten Bildwechsel nicht übernommen werden soll.

– Aktivieren Sie "beibehalten", wenn die Online-Projektierung abhängig von der Voreinstellung beim nächsten Bildwechsel bzw. auch beim Deaktivieren/Aktivieren des Projekts übernommen werden soll.

– Aktivieren Sie "zurücksetzen", wenn das im Konfigurationssystem gespeicherte Bild in Runtime übernommen werden soll. Alle online projektierten Änderungen gehen verloren.

Hinweis

Auch beim Speichern des Bilds im Graphics Designer oder beim Online-Änderungsladen wird das Bild in Runtime ersetzt. Alle online projektierten Änderungen gehen verloren.


Hinweis

Bei einem Benutzerwechsel werden die unterschiedlichen Projektierungen erst übernommen, wenn Sie einen Bildwechsel durchgeführt haben.

2.6.2.7 So dynamisieren Sie die Symbollleiste des UserArchiveControl

Einleitung Die Standardfunktionen zur Bedienung des WinCC UserArchiveControl werden für das neue WinCC UserArchiveControl ab WinCC V7.0 nicht mehr unterstützt. Sie können aber die



Dynamisierungsarten von WinCC verwenden, um z.B. eine Tastenfunktion der Symbolleiste über ein Skript zu bedienen.

ÜberblickMit den WinCC Controls ab V7.0 werden keine spezielle Funktionen mehr benötigt, um eine Bedienung des Controls über eine Dynamisierung der Symbolleiste zu realisieren. Die bisher verwendeten Standardfunktionen "Tlg..." werden nicht mehr unterstützt.

Wenn Sie das Control nicht über die Symbolleiste bedienen möchten, können Sie über eine beliebige Dynamisierungsart die "ID" der gewünschten Taste in die Objekteigenschaft "ToolbarButtonClick" schreiben.

Die "ID" einer Taste der Symbolleiste ermitteln Sie:

● über die Tabelle auf der Seite "Bedienung des UserArchiveControl in Runtime".

● im Konfigurationsdialog des UserArchiveControl auf der Registerkarte "Symbolleiste" über das Feld "Objekt-ID".

Beispiel: Konfiguartionsdialog des Controls öffnenUm den Konfiguartionsdialog des Controls zu öffnen, haben Sie folgende Möglichkeiten der Dynamisierung:

● VBSkript:

– ScreenItems("Control1").ToolbarButtonClick = 2

– Alternativ zu der Eigenschaft "ToolbarButtonClick" stehen in VBS auch Methoden zur Bedienung der Symbolleiste zur Verfügung: ScreenItems("Control1").ShowPropertyDialog

– Oder in folgender Schreibweise mit Unterstützung von "Intellisense": Dim objSet obj = ScreenItems("Control1")obj.ShowPropertyDialog

● C-Skript:

– SetPropWord(lpszPictureName, "Control1", "ToolbarButtonClick", 2);

● Direktverbindung

– Geben Sie im Dialog der Direktverbindung für die Quelle als Konstante "2" ein

– Wählen Sie für das Ziel "Objekt im Bild" die Eigenschaft "ToolbarButtonClick" für das Objekt "Control1"

Siehe auchBedienung des UserArchiveControl in Runtime (Seite 433)



2.6.3 Bedienung in Runtime

2.6.3.1 Bedienung des UserArchiveControl in Runtime

Einleitung Die Bedienung des WinCC UserArchiveControl in Runtime erfolgt über die Schaltflächen der Symbolleiste. Wenn Sie das Tabellenfenster nicht über die Symbolleiste bedienen möchten, können Sie über eine beliebige Dynamisierungsart die "ID" der gewünschten Taste in die Objekteigenschaft "ToolbarButtonClick" schreiben.

Hinweis

Wenn Sie beim Start von Runtime die Fehlermeldung "Error while connecting the data!" eingeblendet wird, hat das UserArchiveControl keine Anbindung an ein Anwenderarchiv oder eine Sicht. Prüfen Sie die folgenden möglichen Fehlerquellen:● Ist die Anbindung korrekt angegeben?● Wurde die Projektierung geändert?● Existiert das verbundene Anwenderarchiv bzw. die Sicht noch?

Navigation in der Tabelle des WinCC UserArchiveControlIn der Tabelle können Sie wie folgt navigieren:

● Zur nächsten Zelle gelangen Sie mit der Taste "ENTER" oder mit der Cursortaste "Rechts".

● Zur vorherigen Zelle gelangen Sie mit der Taste "SHIFT+ENTER" oder mit der Cursortaste "Links".

● Zur nächsten Zeile gelangen Sie durch Mausklick in die Zeile oder mit der Cursortaste "Ab".

● Zur vorherigen Zeile gelangen Sie durch Mausklick in die Zeile oder mit der Cursortaste "Auf".

ÜbersichtDie Übersicht zeigt alle Symbole im Stil "Standard". Wenn Sie ein Design der Controls mit dem Stil "Einfach" erstellen, entspricht die Darstellung der Symbole dem UserArchiveControl vor WinCC V7. Eine Übersicht finden Sie auf der Seite "Vor WinCC V7: WinCC User Archives Table Element > User Archives Table Elements in Runtime > Die Symbolleiste des User Archives Table Element".

Symbol Bechreibung ID"Hilfe"Ruft die Hilfe zum WinCC UserArchiveControl auf.

1

"Konfigurationsdialog"Öffnet den Konfigurationsdialog, in dem Sie die Eigenschaften des UserArchiveControl verändern.

2



"Datenanbindung wählen"Öffnet ein Dialog zur Auswahl eines Anwenderarchivs. Der Inhalt des ausgewählten Anwenderarchivs wird in der Tabelle des UserArchiveControl dargestellt.

3

"Erste Zeile"Über die Schaltfläche wird in der Tabelle der erste Wert des Anwenderarchivs dargestellt.

4

"Vorhergehende Zeile"Über die Schaltfläche wird in der Tabelle der vorgehende Wert des Anwenderarchivs dargestellt.

5

"Nächste Zeile"Über die Schaltfläche wird in der Tabelle der nächste Wert des Anwenderarchivs dargestellt.

6

"Letzte Zeile"Über die Schaltfläche wird in der Tabelle der letzte Wert des Anwenderarchivs dargestellt.

7

"Zeilen löschen"Der Inhalt der markierten Zeilen wird gelöscht.

8

"Zeilen ausschneiden"Der Inhalt der markierten Zeilen wird ausgeschnitten.

9

"Zeilen kopieren"Der Inhalt der markierten Zeilen wird kopiert.

10

"Zeilen einfügen"Der Inhalt der kopierten bzw. ausgeschnittenen Zeilen wird ab der markierten Zeile eingefügt.

11

"Variablen lesen"Über die Schaltfläche werden die Inhalte der verbundenen WinCC-Variablen gelesen und in die Spalten geschrieben. Um die Schaltfläche nutzen zu können, muss beim Anwenderarchiv die Kommunikationsart "Kommunikation über WinCC-Variablen" aktiviert sein. Die Spalten müssen mit Variablen verbunden sein.

12

"Variablen schreiben"Über die Schaltfläche werden die Inhalte der Spalten in die verbundenen WinCC-Variablen geschrieben. Um die Schaltfläche nutzen zu können, muss beim Anwenderarchiv die Kommunikationsart "Kommunikation über WinCC-Variablen" aktiviert sein. Die Spalten müssen mit Variablen verbunden sein.

13

"Archiv importieren"Über die Schaltfläche wird der Inhalt eines Anwenderarchivs in die Tabelle des UserArchiveControl importiert. Das Anwenderarchiv muss als CSV-Datei im Verzeichnis "ua" des Projektordners vorliegen.

14

"Archiv exportieren"Über die Schaltfläche wird der Inhalt der Tabelle des UserArchiveControl exportiert. Das Anwenderarchiv wird als CSV-Datei im Verzeichnis "ua" des Projektordners abgelegt.

15

"Sortier-Dialog"Öffnet einen Dialog zur Einstellung einer benutzerdefinierten Sortierung der angezeigten Spalten des Anwenderarchivs.

16



"Selektions-Dialog"Festlegen von Selektionskriterien für die in der Tabelle darzustellenden Spalten des Anwenderarchivs.

17

"Drucken"Startet den Ausdruck der angezeigten Werte. Der beim Druck verwendete Druckauftrag legen Sie im Konfigurationsdialog auf der Registerkarte "Allgemeines" fest.

18

"Daten exportieren"Über die Schaltfläche exportieren Sie alle oder ausgewählte Runtime-Daten in eine "CSV"-Datei. Wenn die Option "Dialog anzeigen" aktiviert ist, öffnet sich ein Dialog, in dem Sie die Einstellungen zum Export sehen und den Export starten können. Mit den entsprechenden Berechtigungen dürfen Sie auch die Datei und das Verzeichnis für den Export auswählen.Wenn kein Dialog angezeigt wird, startet sofort der Export der Daten in die voreingestellte Datei.

20

"Zeitbasis-Dialog"Öffnet einen Dialog zur Einstellung der Zeitbasis für die in dem Anwenderarchiv verwendeten Zeiten.

19

"Benutzerdefiniert 1"Zeigt die erste, vom Benutzer erstellte Tastenfunktion an. Die Funktion der Taste ist benutzerdefiniert.

1001

Mögliche Elemente der StatuszeileIn der Statuszeile des UserArchiveControl können folgende Elemente erscheinen:

Symbol Name BeschreibungArchivname Zeigt den Namen des ausgewählten Anwenderarchivs an.

Zeile Zeigt die Nummer der markierten Zeile an.

Spalte Zeigt die Nummer der markierten Spalte an.

Datum Zeigt das Systemdatum.

Zeit Zeigt die Systemzeit.

Zeitbasis Zeigt die Zeitbasis, die bei der Anzeige von Zeiten verwendet wird.



2.6.3.2 So bearbeiten Sie die Daten im UserArchiveControl

Einleitung Sie können im WinCC UserArchivControl Daten bearbeiten. Folgende Möglichkeiten stehen zur Verfügung:

● Neue Daten eingeben

● Bestehende Daten ändern

● Zeilen löschen

● Zeilen ausschneiden, kopieren und wieder einfügen

Voraussetzung● Sie haben im Konfigurationsdialog auf der Registerkarte "Allgemeines" das Bearbeiten

zugelassen.

● Für die zu bearbeitende Spalte haben Sie im Konfigurationsdialog auf der Registerkarte "Spalten" die Eigenschaft "Schreibgeschützt" deaktiviert.

● Die Spalte "ID" können Sie nicht bearbeiten.

● Wenn das UserArchivControl mit einer Sicht verbunden ist, können Sie eine Zeile nicht löschen und ausschneiden.

Neue Daten in die Tabelle eingeben1. Klicken Sie auf , um zur letzten Zeile zu gelangen. Die Zeile ist markiert.

2. Doppelklicken Sie in die erste Zelle der markierten Zeile. Sie können auch in der Zelle auf "F2", "ALT+ENTER" oder "CTRL+ENTER" drücken.

3. Geben Sie nacheinander die Werte in die Zellen ein und bestätigen Sie jedesmal mit der Eingabetaste. Nachdem Sie alle Werte in die Zeile eingegeben haben und eine andere Zeile markieren, wird der neue Datensatz in das Anwenderarchiv geschrieben. Zu einer anderen Zeile gelangen Sie durch Mausklick, mit der Taste "ENTER" oder mit den Cursortasten "Auf" und "Ab".

4. Sie können die Daten einer markierten Zelle mit "CTRL+C" bzw. "CTRL+X" in die Zwischenablage kopieren. Mit "CTRL+V" fügen Sie die kopierten Daten in eine markierte Zelle ein.

Bestehende Daten in der Tabelle ändern1. Klicken Sie auf oder , um zur gewünschten Zeile zu gelangen. Sie können auch über

den Rollbalken zur gewünschten Zeile gelangen.

2. Doppelklicken Sie in die gewünschte Zelle der markierten Zeile. Sie können auch in der Zelle auf "F2", "ALT+ENTER" oder "CTRL+ENTER" drücken.

3. Geben Sie nacheinander die Werte in die Zellen ein und bestätigen Sie jedesmal mit der Eingabetaste. Nachdem Sie alle Werte in die Zeile eingegeben haben und eine andere Zeile markieren, wird der geänderte Datensatz in das Anwenderarchiv geschrieben.



Eine Zeile in der Tabelle löschen1. Klicken Sie auf oder , um zur gewünschten Zeile zu gelangen. Sie können auch über


2. Klicken Sie auf , um die markierte Zeile zu löschen.

Ausschneiden, Kopieren und Einfügen von Zeilen1. Klicken Sie auf oder , um zur gewünschten Zeile zu gelangen. Sie können auch über


2. Klicken Sie auf oder , um die Daten der Zeile auszuschneiden bzw. zu kopieren. Alternativ können Sie auch die Tastenkombination "CTLR+ALT+X" bzw. "CTLR+ALT+C" verwenden.

3. Gehen Sie zur gewünschten Zeile, in die Sie die Daten hinkopieren wollen. Klicken Sie auf , um die ausgeschnittenen bzw. kopierten Daten einzufügen. Wenn Sie die Daten der

markierten Zeile nicht überschreiben wollen, gehen Sie zur letzten Zeile um die Daten einzufügen.

2.6.3.3 So selektieren Sie Daten des Anwenderarchivs

Einleitung Welche Inhalte des Anwenderarchivs Sie in der Tabelle des WinCC UserArchiveControl darstellen oder exportieren wollen, können Sie in Runtime über den Selektionsdialog festlegen. Im Selektionsdialog definieren Sie Auswahlkriterien bezüglich der angezeigten Spalten des Anwenderarchivs.



Voraussetzung● Sie haben die Tastenfunktion "Selektions-Dialog" auf der Registerkarte "Symbolleiste" des

UserArchiveControl projektiert.

Vorgehensweise1. Klicken Sie in Runtime auf . Der Dialog "Selektion" öffnet sich.

2. Doppelklicken Sie in der Spalte "Kriterium" in die erste leere Zeile. Die Liste mit den Spalten des Anwenderarchivs wird angezeigt. Wählen Sie die gewünschte Spalte aus, z. B. "feld1".

3. Doppelklicken Sie in die Spalte "Operand", um einen Operand auszuwählen.

4. Doppelklicken Sie in die Spalte "Einstellung", um einen Vergleichswert einzugeben.

5. Doppelklicken Sie in die Spalte "Verknüpfung", um eine "AND" oder "OR"-Verknüpfung auszuwählen.



6. Wiederholen Sie das Vorgehen, wenn Sie weitere Kriterien festlegen wollen.

7. Beenden Sie den Selektionsdialog mit "OK". Die Selektion wird in der Tabelle des UserArchiveControl angezeigt.

HinweisAnzeige der Inhalte der Spalten sicherstellen

Achten Sie auf die richtige Verwendung der Einstellungen und Verknüpfung von Kriterien.

Falsche Verknüpfungen können dazu führen, dass im UserArchiveControl Daten des verbundenen Anwenderarchivs nicht angezeigt werden.

Testen Sie deshalb vor der Verknüpfung von Kriterien jedes Kriterium separat und danach jeweils die verknüpften Kriterien. Prüfen Sie, dass auch in Kombination alle erwarteten Inhalte angezeigt werden.

Damit stellen Sie sicher, dass die Selektion im UserArchiveControl vollständig angezeigt wird.

2.6.3.4 So sortieren Sie die Anzeige der Anwenderarchivdaten

Einleitung Die Daten im UserArchiveControl können Sie in Runtime nach Spalten sortieren. Sie sortieren die Spalten entweder über die Tastenfunktion "Sortier-Dialog" oder direkt über die Überschrift der Spalten.

Hinweis

Sie können bereits bei der Projektierung im UserArchiveControl die Sortierkriterien festlegen, indem Sie auf der Registerkarte "Spalten" unter "Sortierung" auf die Schaltfläche "Bearbeiten..." klicken.



So sortieren Sie über den Sortier-Dialog

Voraussetzung● Sie haben die Tastenfunktion "Sortier-Dialog" auf der Registerkarte "Symbolleiste" des

UserArchiveControl projektiert.

Vorgehensweise1. Klicken Sie auf die Schaltfläche "Sortier-Dialog" .

2. Wählen Sie aus der Liste "Sortieren nach" die Spalte des verbundenen Anwenderarchivs aus, nach dem zuerst sortiert wird. Klicken Sie in ein Optionskästchen, um eine aufsteigende oder absteigende Sortierung festzulegen. Wenn Sie nach mehreren Spalten sortieren wollen, wählen Sie aus den Listen von "Anschließend sortieren nach" die weiteren Spalten in der gewünschten Reihenfolge aus.

So sortieren Sie die Spalteninhalte über die Spaltenüberschrift Beim Sortieren über die Spaltenüberschrift haben Sie die Möglichkeit eine Sortierreihenfolge für mehr als vier Spalten festzulegen. Ein Sortiersymbol und ein Sortierindex, rechtsbündig in der Spaltenüberschrift dargestellt, zeigen Sortierabfolge und Sortierreihenfolge der Spalteninhalte an.



Voraussetzung● Sie haben auf der Registerkarte "Parameter" des WinCC UserArchiveControl das Sortieren

im Listenfeld "Sortieren über Spaltenüberschrift" per Klick oder Doppelklick zugelassen.

● Sie haben die Optionskästchen "Sortiersymbol anzeigen" und "Sortierindex anzeigen" aktiviert.

Vorgehensweise1. Klicken Sie in die Spaltenüberschrift, dessen Spalte Sie als erste Spalte sortieren wollen.

Der Sortierindex "1" wird angezeigt mit dem Sortiersymbol nach oben für die aufsteigende Sortierung.

2. Wenn Sie absteigend sortieren wollen, klicken Sie erneut in die Spaltenüberschrift.

3. Wenn Sie die Sortierabfolge mit "auf/ab/keine" festgelegt haben, können Sie mit einem dritten Klick die Sortierung der Spalte aufheben.

4. Wenn Sie mehrere Spalten sortieren wollen, klicken Sie in der gewünschten Reihenfolge in die jeweilige Überschrift der Spalte.



2.7 Vor WinCC V7: WinCC User Archives Table Element

2.7.1 User Archives Table Element

2.7.2 Funktionalität

FunktionsumfangDas User Archives Table Element bietet Zugriffsmöglichkeiten auf Anwenderarchive und Sichten der User Archives. Mit dem User Archives Table Element können Sie in Runtime:

● Datensätze anlegen, löschen oder ändern

● im Anwenderarchiv blättern

● Variablen bei direkter Variablenanbindung lesen und schreiben

● Anwenderarchive importieren und exportieren und

● Filter- und Sortierbedingungen definieren

AnsichtenDas User Archives Table Element bietet zwei Ansichten: die Tabellenansicht und die Formularansicht.

User Archive2.7 Vor WinCC V7: WinCC User Archives Table Element


● Die TabellenansichtDie Tabellenansicht dient der tabellarischen Darstellung der Anwenderarchive. Jeder Datensatz belegt eine Zeile, die Datenfelder eines Datensatzes erscheinen als Spalten.

● Die FormularansichtDie Formularansicht bietet eine Bedienoberfläche, welche vom Anwender selbst gestaltet werden kann. Die Formularansicht von User Archives bietet drei Feldtypen: statische Texte, Eingabefelder und Schaltflächen.

Hinweis

Ein User Archives Table Element wird bei der Projektierung mit einem ausgewählten Anwenderarchiv bzw. einer Sicht verbunden und kann nur auf dieses Anwenderarchiv / Sicht zugreifen. Für den Zugriff muss das Anwenderarchiv / Sicht freigegeben sein (Zugriffsschutz). Über den User Administrator können Sie dem Control gezielte Berechtigungen zuweisen.

Wird dieser Zugriffsschutz aufgehoben , so muss das Control im Graphics Designer neu mit dem Anwenderarchiv verbunden werden, damit das Control den aufgehoben Zugriffsschutz erkennt.

Der Zugriffsschutz für ein Archiv oder Feld wird beim Bildaufschlag eines User Archives Table Elements abgefragt. Ein Zugriffsschutz für die Steuervariablen eines geschützen Archivs muss über die Objekt-Eigenschaften z.B. des Bildes, EA-Feldes oder der Schaltfläche separat realisiert werden.

Siehe auchProjektierung eines User Archives Table Element (Seite 443)

2.7.3 Projektierung eines User Archives Table Elements

2.7.3.1 Projektierung eines User Archives Table Element

Vorgehensweise

Zur Projektierung eines WinCC User Archives Table Elements müssen Sie folgendermaßen vorgehen:

1. Projektieren Sie ein Anwenderarchiv mit dem Editor User Archives oder mit den Funktionen der WinCC Skriptsprache. In der Beschreibung des Editors User Archives, können Sie erfahren, wie das Anwenderarchiv "Cola" projektiert wurde.

2. Platzieren Sie ein neues User Archives Table Element in ein Bild des Graphics Designers.

3. Projektieren Sie die Eigenschaften des User Archives Table Elements.

4. Projektieren Sie eine User Archives Formularansicht.



2.7.3.2 User Archives Table Element in einem Prozessbild platzieren

Vorgehensweise

Zur Einrichtung eines User Archives Table Element in einem Prozessbild müssen Sie es im Graphics Designer projektieren. Dies geschieht durch die folgenden Schritten:

1. Wählen Sie aus der Objektpalette die Objektgruppe "Smart Objekte" aus.

2. Klicken Sie auf das Objekt "Control" und ziehen Sie in der Bildfläche ein Fenster ausreichender Größe auf.

3. Wählen Sie im nun erscheinenden Auswahldialog "Control einfügen" die Option "WinCC User Archive Table Element" aus und bestätigen Sie die Auswahl mit OK.



Alternative Vorgehensweise● Wählen in der Objektpalette die Registerkarte "Controls", im Fenster "Objektpaletten"

werden Ihnen dann einige Standardcontrols zur Auswahl angeboten.

● Wählen Sie das WinCC User Archive Table Element.

Siehe auchDie Eigenschaften des User Archives Table Element festlegen (Seite 445)

2.7.3.3 Die Eigenschaften des User Archives Table Element festlegen

Vorgehensweise

Im folgenden Leitfaden erfahren Sie wie Sie (im Graphics Designer) mit der Dialogbox "Eigenschaften von WinCC User Archive Table Element" ein User Archives Table Element für das Anwenderarchiv "Cola" projektieren können.



1. Doppelklicken Sie innerhalb der Fläche des "WinCC User Archive Table Element". Es erscheint daraufhin die Dialogbox "Eigenschaften von WinCC User Archive Table Element" mit der Registerkarte "Allgemein".

2. Im Eingabefeld Quelle legen Sie das Archiv oder die Sicht fest, welche im Control angezeigt werden soll. Klicken Sie auf "Auswählen" und wählen Sie im Dialog Package Browser das Anwenderarchiv "Cola" aus.

3. Im Feld Bearbeiten können Sie die Zugriffsart zur Laufzeit festlegen. Die Zugriffsarten "Einfügen", "Ändern" und "Löschen" sind standardmäßig aktiviert. Sie können statt dessen auch "Nur Lesen" aktivieren.

4. Mit der Checkbox "Rahmen" legen Sie fest, ob das Control-Fenster mit oder ohne Rahmen erscheinen soll. Aktivieren Sie diese Optionen.

5. Die Voreinstellungen in den übrigen Registerkarten können Sie unverändert übernehmen.

Siehe auchRegisterkarte "Allgemein" (Seite 448)

Das User Archives Table Element löschen (Seite 447)



2.7.3.4 Das User Archives Table Element löschen

Vorgehensweise

Das Löschen des User Archives Table Elements erfolgt im Graphics Designer in zwei Schritten:

1. Selektion des zu löschenden User Archives Table Element durch Mausklick

2. Löschen-Taste drücken oder Menü "Bearbeiten - Löschen" auswählen.

Hinweis

Das Löschen wird dann sofort ohne Vorwarnung vorgenommen! Den Löschvorgang können Sie nur mit dem Menü "Bearbeiten - Rückgängig" oder "Ctrl-Z" rückgängig machen.

2.7.4 Eigenschaften des WinCC User Archives Table Element

2.7.4.1 Eigenschaften des User Archives Table Element

Vorgehensweise1. Sie können die Attribute eines User Archives Table Element verändern, indem Sie mit der

rechten Maustaste auf das Objekt klicken und im sich öffnenden Kontextmenü den Menüpunkt "Eigenschaften" wählen.Hier können Sie die Statik der Attribute Filter, Form, PressTBButton und Sort editieren. Um Inkonsistenzen in der Datenbank zu vermeiden, sollten Änderungen an den übrigen Objekteigenschaften stets über die Dialogbox "Eigenschaften von WinCC Anwenderarchive - Tabellenelement" gemacht werden (Doppelklick auf das Control).

2. Im geöffneten Dialog "Objekteigenschaften" wählen Sie in der Registerkarte "Eigenschaften" die Gruppe "Control Eigenschaften".

Die Projektierung des User Archives Table Element erfolgt üblicherweise im Graphics Designer durch einen Doppelklick auf eines der Controls. In der sich öffnenden Dialogbox können Sie die gewünschten Änderungen vornehmen. Da bereits bestehende Anwenderarchive, Sichten, Variablen etc. in den Dialogboxen der verschiedenen Registerkarten zur Auswahl angeboten werden, können Änderungen leicht und sicher durchgeführt werden.




2.7.4.2 Registerkarte "Allgemein"

Aufbau

Symbol BeschreibungTitelleiste Im Feld "Titelleiste" legen Sie die Fensterüberschrift fest. Sie bestimmen hier,

ob die Titelleiste angezeigt und das Fenster geschlossen und verschoben werden kann.

Quelle Über die Schaltfläche "Auswählen" erreichen Sie den Package Browser, in dem Sie ein vorher projektiertes Anwenderarchiv, bzw. eine Sicht, auswählen können.

Bearbeiten Im Feld "Bearbeiten" können Sie die Zugriffsart zur Laufzeit festlegen. Wenn Sie die Checkbox "Nur Lesen" deaktivieren, werden für Anwenderarchive die Zugriffsarten "Einfügen", "Ändern" und "Löschen" freigegeben. Bei Sichten wird nur die Checkbox "Ändern" freigegeben.

Rahmen Mit der Checkbox legen Sie fest, ob das Control-Fenster mit oder ohne Rahmen erscheinen soll.

Formular Mit der Checkbox legen Sie fest, ob die Formularansicht im Control-Fenster die Startansicht sein soll.

Zeitbasis des Last Access Feldes

In diesem Auswahlfeld legen Sie die Zeitbasis für die Zeitanzeige im Feld "Last Acess" fest.

Druckauftrag für Schnelldruck

In diesem Feld legen Sie den Druckauftrag fest, der beim Druck der angezeigten Daten verwendet wird.

Hinweis

Wird im Editor User Archives die Konfiguration des Anwenderarchivs geändert z.B. in dem der Zugriffsschutz aufgehoben wird, so muss das Control im Graphics Designer neu mit diesem Anwenderarchiv verbunden werden. Dadurch erkennt das Control die geänderte Archivkonfiguration.

Der Package BrowserÜber die Schaltfläche "Auswählen" im Eigenschaftendialog des User Archives Table Elements wird der Package Browser aktiviert. Hier werden Ihnen die bereits projektierten Anwenderarchive und Sichten zur Auswahl angeboten.

Bei einem WinCC Client können Sie im Navigationsfeld des Dialogs "Package Browser" diejenigen Server auswählen, von denen Packages geladen und auf denen ein Anwenderarchiv mit Variablen projektiert wurde. In einem Projekt eines WinCC Clients können Sie auf die Anwenderarchive aller im Projekt eingebundenen Server zugreifen. Eigene Anwenderarchive auf dem WinCC Client selbst sind nicht vorgesehen. Im Bereich "Hierarchie" wird der Pfad zum ausgewählten Server angezeigt. Dieser ist editierbar, so das Sie den Pfad zum gewünschten Server auch von Hand eingeben können.



Ist ein benötigter Server nicht in der Serverliste enthalten, muss zuerst über die Funktion Serverdata "Laden" ein Package dieses Servers geladen werden. Weitere Informationen zur WinCC Client Funktionalität finden Sie in der Hilfe zum WinCC Explorer.

Hinweis

Ist das Control nicht mit einem bestehenden Anwenderarchiv oder einer Sicht verbunden, so erscheint beim Wechsel ins Runtime die Fehlermeldung "Error while connecting the data!".

Siehe auchListe der Eigenschaften des User Archives Table Element (Seite 466)

2.7.4.3 Registerkarte "Spalten"

Aufbau

Symbol BeschreibungSpalten Im Eingabefeld Spalten können Sie festlegen, welche im Editor User Archives

angelegten Felder im Prozessbild angezeigt werden sollen.Eigenschaften Im Eingabefeld Eigenschaften können Sie die Eigenschaften der im Eingabefeld

Spalten aktuell ausgewählten Feldes festlegen.Gesperrt Mit der Checkbox "Gesperrt" können Sie das ausgewählte Feld gegen

überschreiben schützen. Format Mit dem Feld "Format" wird die Wertedarstellung festgelegt:

● Fixed (Festpunktzahl "%.2f")● Scientific (Exponentialdarstellung "%e")● Date (Nur Datumsausgabe "%x")● Time (Nur Uhrzeitausgabe "%X")● TimeStamp (Ausgabe von Datum und Uhrzeit "%c")Die Anzeige eines Datumsfeldes erfolgt in dem Datumsformat, welches im Betriebssystem eingestellt ist.

Ausrichtung Bei der Auswahl "Ausrichtung" können Sie zwischen "Links", "Zentriert" und "Rechts" auswählen.

Zurücksetzen Die Schaltfläche "Zurücksetzen" stellt die vorherige Einstellung ein.

Hinweis

Im Feld Format können Sie auch die Formatierung der Nachkommastellen (z.B. "%3f" für drei Nachkommastellen) oder das Hexadezimalformat "%x" für Integerwerte vornehmen.




2.7.4.4 Registerkarte "Symbolleiste"

Aufbau

Symbol BeschreibungSymbole In der Auswahl "Symbole" legen Sie fest, welche Symbole die Symbolleiste

beinhalten soll.Zugriffsrechte Im Feld "Zugriffsrechte" werden die Zugriffsrechte zum ausgewählten Symbol

angezeigt. Auswahl Mit einen Klick auf die Schaltfläche "Auswahl" erscheint die Dialogbox

"Berechtigungen", in welcher Sie den gewünschten Zugriff festlegen können. Ausschalten Mit dem Feld "Ausschalten" wird die Symbolleiste ein- oder ausgeschaltet.Hotkey Über das Feld Hotkey können Sie den einzelnen Funktionen Hotkeys zuordnen.

Berechtigungen

In der Dialogbox "Berechtigungen" können Sie den gewünschten Zugriff festlegen. Die im Dialog angezeigten Berechtigungen wurden vorher im User Administrator projektiert.


2.7.4.5 Registerkarte "Statuszeile"

Aufbau

Symbol BeschreibungBereiche Mit den Kontrollkästchen im Bereich "Bereiche" legen Sie fest, welche Elemente die

Statuszeile des Controls beinhalten soll. Ausschalten Mit der Schaltfläche "Ausschalten" wird die Statuszeile ein- oder ausgeschaltet.

Wenn alle Bereiche der Statuszeile aktiviert wurden, sieht die Statuszeile folgendermaßen aus:




2.7.4.6 Registerkarte "Filter/Sortierung"

Aufbau

FilterbedingungIm Dialog "Filterbedingung" legen Sie die Filterbedingungen fest. Geben Sie die Regeln für die Filterbedingungen direkt ein. Diese Bedingungen werden in der Datenbank-Programmiersprache SQL (Structured Query Language) formuliert. Im Anhang finden Sie eine Beschreibung von SQL mit mehreren praktischen Beispielen.

Beispiel: FieldC > 100Es werden alle Datensätze selektiert, welche in der Spalte "FieldC" ein Wert größer als 100 besitzen.

Über die Schaltfläche "Erstellen..." erreichen Sie eine automatisierte Filtermaske, über die Sie die Filterbedingungen definieren können.

In der Zeile "Filtern nach" können Sie die Filterkriterien festlegen, im linken Auswahlfenster werden Ihnen alle Datenfelder des Anwenderarchivs angeboten. Über die Zeilen "Anschließend nach" und "Zuletzt nach" können Sie nachfolgende Filterbedingungen vorgeben. Die Filter werden in dieser Reihenfolge abgearbeitet.

SortierungIm Dialog "Sortierung" legen Sie die Sortierbedingungen fest. Geben Sie die Regeln für die Sortierung direkt in der Datenbank-Programmiersprache SQL an.

Über die Schaltfläche "Erstellen..." erreichen Sie eine automatisierte Sortiermaske, über die Sie die Sortierbedingungen definieren können.

In dem Auswahlfeld "Sortieren nach" können Sie die Sortierkriterien festlegen, es werden Ihnen alle Datenfelder des Anwenderarchivs zur Auswahl angeboten. Über die Auswahlfelder "Anschließend nach" und "Zuletzt nach" können Sie nachfolgende Sortierbedingungen vorgeben. Die Filter werden in dieser Reihenfolge abgearbeitet. Mit der Option "Aufsteigend" wird aufsteigend, mit der Option "Absteigend" wird absteigend sortiert




2.7.4.7 Registerkarte "Schriftarten"

Aufbau

In der Registerkarte "Schriftarten" bestimmen Sie die Schrift, welche im Control verwendet werden soll.


2.7.4.8 Registerkarte "Farben"

Aufbau

In der Registerkarte "Farben" bestimmen Sie die Farben, welche im Control verwendet werden sollen.


2.7.5 Projektierung einer Formularansicht

2.7.5.1 Projektierung einer Formularansicht

Vorgehensweise

Das User Archives Table Element-Formular kann vom Anwender im Graphics Designer selbst projektiert werden und wird zum Editieren und für die Darstellung der Anwenderarchivdaten verwendet.

Voraussetzung für das Erstellen einer Formularansicht ist ein projektiertes User Archives Table Element.

Der folgende Leitfaden zeigt Ihnen die Projektierung einer neuen Formularansicht im Graphics Designer.



1. Drücken Sie gleichzeitig die "Steuerungstaste" und doppelklicken Sie auf das "User Archives Table Element". Es erscheint daraufhin die Tabellenansicht des Controls. Nun können Sie die Breite der einzelnen Spalten für den Runtimebetrieb festlegen.

2. Mit diesem Symbol können Sie zwischen Formular- und Tabellenansicht umschalten. Klicken Sie auf dieses Symbol um in die Formularansicht zu gelangen.

Nun können Sie mit der Projektierung eines Formulars beginnen.

Wir werden im folgenden dieses Formular erstellen:



Hinweis

Nach einem Rechtsklick in das leere Formular können Sie sich mit Hilfe der Funktion "Erzeugen, alle" aus dem Kontextmenü die Formularfelder aller im Anwenderarchiv vorhandenen Datenfelder automatisch erzeugen lassen. Dabei wird zu jedem Datenfeld auch ein Textfeld mit der entsprechenden Beschriftung (Aliasname) angelegt. Mit der Option "Erzeugen, selektiert" werden die Formularfelder lediglich für die in der Registerkarte "Spalten" selektierten Spalten erzeugt.

Hinweis

Das User Archives Table Element unterstützt nicht die Zoomfunktionaltität. Die Projektierung der Zoomfunktionaltität kann in Runtime zu Darstellungsproblemen führen.

2.7.5.2 Formularfeld "Text" anlegen

Vorgehensweise

1. Öffnen Sie die Formularansicht, falls diese noch nicht geöffnet ist.

2. Um ein neues Formularfeld "Text" anzulegen klicken Sie im Graphics Designer mit der rechten Maustaste in die Arbeitsfläche des User Archives Table Element an der Stelle, wo Sie den Text positionieren wollen. Es erscheint daraufhin folgendes Auswahlfeld:



3. Nach der Auswahl von "Textfeld einfügen" gelangen Sie in die Dialogbox "Textfeld-Eigenschaften":

4. Im Feld "Text" können Sie den gewünschten Text eingeben. Geben Sie hier als Überschrift des Formulars den Text "Eingabe-Formular Cola" ein.

Hinweis

Wenn Sie das Feld "Text" über das Auswahlfeld expandieren, erhalten Sie alle Feldnamen eines Archivs als statischen Text angeboten. Wurden in der Textlibrary bereits Textreferenzen für eine Sprachumschaltung angelegt, so werden diese zur Auswahl angeboten.

Siehe auchFormularfeld "Edit" anlegen (Seite 455)

2.7.5.3 Formularfeld "Edit" anlegen

Vorgehensweise


2. Um ein neues Formularfeld "Edit" anzulegen Klicken Sie im Graphics Designer mit der rechten Maustaste in die Arbeitsfläche des User Archives Table Elements an der Stelle, an der Sie das Editierfeld positionieren wollen. Es erscheint daraufhin folgendes Auswahlfeld:



3. Nach der Auswahl von "Editfeld einfügen" gelangen Sie zum Dialog "Editfeld-Eigenschaften":

Im Auswahlfeld des Dialoges werden alle projektierten Felder des Anwenderarchivs zur Auswahl angeboten.

4. Wählen Sie das Feld "Wasser" aus. Sie können jetzt selbst weitere Editierfelder anlegen, wie zum Beispiel Zucker, Farbstoff7, Koffein und Phosphorsaeure.

Siehe auchFormularfeld "Button" anlegen (Seite 456)

2.7.5.4 Formularfeld "Button" anlegen

Vorgehensweise


2. Um eine neue Schaltfläche anzulegen klicken Sie im Graphics Designer mit der rechten Maustaste in die Arbeitsfläche des User Archives Table Elemets an der Stelle, an der Sie die Schaltfläche positionieren wollen. Es erscheint daraufhin folgendes Auswahlfeld:



3. Nach der Auswahl von "Button einfügen" gelangen Sie zum Dialog "Button-Eigenschaften":

4. Im Feld "Text" können Sie den Text festlegen, mit welchem die neue Schaltfläche beschriftet wird. Geben Sie den Text "Tabellenansicht" an.

5. Im Feld "Action" können Sie eines der Symbole der Formularansicht auswählen. Ihre neu projektierte Schaltfläche führt dann die gleiche Aktion aus, wie das entsprechende Symbol in der Symbolleiste. Wählen Sie "Form" aus, um ein Umschalten zur Tabellenansicht zu ermöglichen.

Hinweis

Es können sämtliche Funktionen der Symbolleiste aus der Formularansicht mit einer Schaltfläche verbunden werden. So können Sie die Größe und das Layout der Schaltflächen selbst gestalten um z.B. die Funktionen der Symbolleiste über einen Touch Screen zu bedienen.

Siehe auchFormularfelder nachträglich bearbeiten (Seite 457)

2.7.5.5 Formularfelder nachträglich bearbeiten

Vorgehensweise

1. Um ein Formularfeld nachträglich zu ändern klicken Sie mit der rechten Maustaste auf das vorprojektierte Formularfeld und klicken Sie daraufhin auf die Schaltfläche "Eigenschaften"oderdoppelklicken Sie auf das vorprojektierte Formularfeld.

Es erscheint daraufhin der entsprechende Dialog zum Ändern des Formularfelds, wie in den Kapiteln zu den Formularfeldern Text, Edit und Button beschrieben.

Siehe auchFormularfelder löschen (Seite 458)



2.7.5.6 Formularfelder löschen

Vorgehensweise

1. Um ein Formularfeld zu löschen klicken Sie mit der rechten Maustaste auf das vorprojektierte Formularfeld.

2. Klicken Sie auf den Menüpunkt "Löschen".

Das Formularfeld wird daraufhin gelöscht. Benutzen Sie nicht die Löschen- Taste, da diese das ganze Control löscht.

2.7.6 User Archives Table Elements in Runtime

2.7.6.1 Die Tabelle des User Archives Table Element

Anwendung

Die Tabelle des User Archives Table Element dient zur Darstellung und Eingabe der Anwenderarchivdaten in Runtime in Tabellenform. Texte können Sie in einer Zelle mehrzeilig durch die Tastenkombination <STRG+ RETURN> erfassen. Mehrzeilig erfasster Text einer Zelle wird in der Tabellenansicht einzeilig dargestellt, alle Zeilen werden in einer einzigen Zeile zusammengefasst.

Das Tabellen- und Formularfenster des Controls wird mit dieser Symbolleiste bedient:

Die Bearbeitung innerhalb der Tabelle erfolgt analog der Bearbeitung im Tabellenfenster des Editors User Archives.

Hinweis

Verändern Sie in einer Control-Tabelle einen oder mehrere Werte, so müssen Sie nach Abschluss der Eingaben den Datensatz verlassen, d.h. in eine andere Tabellenzelle oder Zeile wechseln, damit der Wert in die Datenbank übernommen und in anderen Anzeigen aktualisiert wird.

Aktionen in der WinCC Skriptsprache müssen selbst für die Auswahl von Datensätzen sorgen. Eine Auswahl von Datensätzen durch das Control ist nicht möglich.




2.7.6.2 Das Formular des User Archives Table Element

Anwendung

Das Formular des User Archives Table Element kann vom Anwender im Graphics Designer selbst projektiert werden und dient zur Eingabe und Darstellung der Anwenderarchivdaten in Runtime. Texte können Sie mehrzeilig erfassen und darstellen.

Hinweis

Verändert man in einem User Archives Table Element-Formular einen oder mehrere Werte, so muss nach Abschluss der Eingaben zu einem anderen Datensatz geblättert werden, damit der Wert in die Datenbank übernommen und in anderen Anzeigen aktualisiert wird.

2.7.6.3 Die Symbolleiste des User Archives Table Element

FunktionenDie Symbolleiste bietet folgende Bedienmöglichkeiten:

Symbol BeschreibungUmschalten

Datensatz löschen



Symbol BeschreibungAnlegen von neuem Datensatz

Bestehendes Feld ändern

Im Tabellenfenster blättern

Lesen und Schreiben von Variablen

Anwenderarchive importieren und exportieren

Filterbedingung definierenSortierbedingung definierenZeitbasis des Feldes "LastAccess"

Drucken

Hilfe anfordern

UmschaltenMit diesem Symbol wird zwischen Formular- und Tabellenansicht umgeschaltet.

Datensatz löschenDer markierte Datensatz wird gelöscht.

Anlegen von neuem Datensatz.Sie geben nacheinander die Werte der Datenfelder ein und bestätigen jedesmal mit der Eingabetaste. Nachdem alle Datenfelder eingegeben wurden, wird der neue Datensatz mit den eingegebenen Werten angelegt.

Bestehendes Feld ändernNach dem Klick auf dieses Symbol klicken Sie auf das Feld, welches Sie ändern wollen. Daraufhin erscheint der Textmarker, welcher Ihnen die Editierbarkeit des Feldes signalisiert. Solange das Symbol "Bestehendes Feld ändern" aktiv ist befindet sich das User Archives Table Element im "Ändern"- Modus. Sie können dann den Cursor in der Tabelle bewegen und sofort Änderungen vornehmen. Bei ausgeschaltetem "Ändern"- Modus können Sie Änderungen erst nach Drücken des F2-Hotkeys oder einem Doppelklick auf das zu ändernde Feld vornehmen.

Im Tabellenfenster blätternMit diesen Schaltflächen können Sie im Tabellenfenster vor- und zurückblättern und den Anfang oder das Ende des Anwenderarchivs anspringen.

Lesen und Schreiben von VariablenDiese Schaltflächen bieten das Lesen und Schreiben von WinCC-Variablen.



Beim Einrichten des Anwenderarchivs in der Dialogbox "Eigenschaften von Archiv" in der Registerkarte "Kommunikation" können Sie die Kommunikationsart "Kommunikation über WinCC- Variable" wählen.

Archive importieren und exportierenNach einem Klick auf eine dieser Schaltflächen werden Anwenderarchive im CSV- Format (Coma Seperated Value) importiert bzw. exportiert.

Hinweis

Vor dem Einlesen in Excel muss der Dateityp CSV angegeben werden, da die von WinCC exportierte CSV-Datei sonst nicht richtig eingelesen wird.

Hinweis

Bei einem Mehrplatz-Projekt ist folgendes zu beachten: Existiert auf dem Server ein Anwenderarchiv z.B. unter "c:\Projekte\Test\UA", so wird es unter dieser Pfadangabe freigegeben. Der Client mapped die Freigabe seinerseits über ein Netzlaufwerk z.B. "I:\Test\UA". Der Standardpfad des Anwenderarchivs ist demnach auf dem Client "I:\Test\UA". Dieses Verzeichnis existiert aber auf dem Server nicht unter dieser Bezeichnung. Wollen Sie Anwenderarchivdaten importieren/ exportieren, so müssen Sie auf dem Client den Standardpfad ändern, in unserem Beispiel auf "C:\Projekte\Test\UA".

Filterbedingung definierenDiese Option erlaubt Ihnen die Eingabe von Filterbedingungen. Es werden alle angezeigten Daten exportiert. Soll nur eine Teilmenge exportiert werden, dann müssen Sie zunächst die Filterbedingungen so formulieren, daß nur noch die gewünschten Daten angezeigt werden. Anschließend können Sie diese gefilterten Daten exportieren.

Die Filterbedingungen werden direkt in der Datenbank-Programmiersprache SQL (Structured Query Language) formuliert. Im Anhang finden Sie eine Beschreibung von SQL mit mehreren praktischen Beispielen. Weitere Informationen erhalten Sie aus der einschlägigen Fachliteratur.



Beispiel: ID < 100Es werden nur die Datenfelder mit den ID's 1 bis 99 selektiert, alle anderen Datenfelder werden nicht angezeigt.

Über die Schaltfläche "Erstellen..." erreichen Sie eine automatisierte Filtermaske, über die Sie die Filterbedingungen definieren können.

In der Zeile "Filtern nach" können Sie die Filterkriterien festlegen, im linken Auswahlfenster werden Ihnen alle Datenfelder des Anwenderarchivs angeboten. Über die Zeilen "Anschließend nach" und "Zuletzt nach" können Sie nachfolgende Filterbedingungen vorgeben. Die Filter werden in dieser Reihenfolge abgearbeitet.

Hinweis

Die hier definierten Filterbedingungen sind temporär, d.h. nach einem neuen Bildaufbau sind die im Eigenschaftendialog festgelegten Filterkriterien wieder gültig.

Sortierbedingung definierenDiese Option erlaubt Ihnen die Eingabe von Sortierbedingungen.



Die Regeln für die Sortierung werden direkt in der Datenbank-Programmiersprache SQL angegeben.

Sehen Sie auch die Beschreibung von SQL im Anhang. Weitergehende Informationen erhalten Sie aus der einschlägigen Fachliteratur.

Über die Schaltfläche "Erstellen..." erreichen Sie eine automatisierte Sortiermaske, über die Sie die Sortierbedingungen definieren können.

In dem Auswahlfeld "Sortieren nach" können Sie die Sortierkriterien festlegen, es werden Ihnen alle Datenfelder des Anwenderarchivs zur Auswahl angeboten. Über die Auswahlfelder "Anschließend nach" und "Zuletzt nach" können Sie nachfolgende Sortierbedingungen vorgeben. Die Filter werden in dieser Reihenfolge abgearbeitet. Mit der Option "Aufsteigend" wird aufsteigend, mit der Option "Absteigend" wird absteigend sortiert

Hinweis

Die hier definierten Sortierbedingungen sind temporär, d.h. nach einem neuen Bildaufbau sind die im Eigenschaftendialog festgelegten Sortierkriterien wieder gültig.

Zeitbasis des Feldes "Last Access"Über diese Option können Sie die Zeitbasis des Feldes "Last Access" ändern.

DruckenDiese Option startet den Ausdruck der angezeigten Werte.

Hilfe anfordernKlicken Sie auf diese Schaltfläche um Hilfe zum User Archives Table Element anzufordern.



2.7.6.4 Bedienung des Controls über dynamisierte Objekte

BedienmöglichkeitenDas User Archives Table Element bietet Ihnen die Möglichkeit, alle Schaltflächen der Symbolleiste auf selbst definierte Schaltflächen bzw. EA-Felder zu verschalten. Damit kann jede der Schaltflächen in Größe und Aussehen selbst definiert werden, um das Table Element z.B. über einen Touch Screen zu bedienen

Beispiel zur Verwendung des Attributs "Press TB Button"Um eine Verbindung des User Archives Table Element mit einer Schaltfläche herzustellen müssen Sie die folgenden Schritte ausführen:

1. Legen Sie im Graphics Designer einen Button an und rufen Sie durch einen Rechtsklick mit der Maus die Objekteigenschaften auf.

2. Wählen Sie in der Registerkarte "Ereignis" die Option "Maus". Selektieren Sie im rechten Fenster Ausführung bei "Mausklick". Nach einem Rechtsklick auf den Pfeil in der Spalte "Aktion" öffnet sich ein Auswahlfenster, wählen Sie hier die Option "Direktverbindung".

3. Im Bereich "Quelle" selektieren Sie "Konstante" und tragen hier eine Konstante z.B. "Form" ein (Eine Übersicht der zur Verfügung stehenden Konstanten für das User Archives Table Element finden Sie weiter unten).



4. Wählen Sie nun im Bereich "Ziel" die Option "Objekt im Bild" und selektieren Sie das zu verbindende Table Element im Objektauswahlfeld. Im Auswahlfeld "Eigenschaft" wählen Sie "PressTBButton" und bestätigen den Dialog mit "OK".

5. Speichern Sie das Bild im Graphics Designer und gehen Sie in Runtime. Wenn Sie nun die projektierte Schaltfläche "Form" betätigen, dann wechselt die Darstellung des Controls von der Tabellenansicht in die Formularansicht und umgekehrt.

Konstanten für eine Direktverbindung mit dem User Archives Table ElementFür die o.g. Direktverbindungen des User Archives Table Element steht Ihnen zu jeder Schaltfläche des Controls eine Konstante zur Verfügung. Die Zuordnung zu den einzelnen Schaltflächen können Sie der folgenden Tabelle entnehmen.

Konstante Zugehörige SchaltflächeForm

Delete

New

Edit

First

Previous

Next

Last

WriteVar

ReadVar

ImportExportFilter

Sort

Timezone

Print

Help



Hinweis

Bei der Bedienung des Tabellenfensters mit der Tastatur ist der Zellcursor für die gewählte Datensatzzelle nach dem Betätigen der Tasten "Tabulator" und "Position 1" nicht mehr sichtbar. Um die Anzeige zu dem zuletzt bearbeiteten Datensatz zurückzubringen, legen Sie nach o.g. Schema eine Schaltfläche an und wählen Sie die Konstante "VTB_Focus". Durch Betätigen dieser Schaltfläche springt der Zellcursor an seine letzte Position zurück.


2.7.6.5 Liste der Eigenschaften des User Archives Table Element

ÜbersichtSie können folgende Eigenschaften des User Archives Table Controls einstellen:

Attribut Beschreibung dynamisierbarBackColor Legt die Hintergrundfarbe des Tabellenfensters im User Archives Table

Element fest.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Farben" können Sie diese Einstellungen ändern.

nein

Border Legt fest, ob die Formularansicht des User Archives Table Elements im Runtime mit einem Rahmen dargestellt wird oder nicht.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Allgemein" können Sie diese Einstellungen ändern.

nein

Buttons Legt fest, dass die von der Software generierten Zeiger der in der Toolbar aktivierten Schaltflächen ausgegeben werden.Um Inkonsistenzen in der Datenbank zu vermeiden, darf die Statik dieses Attributs nicht editiert werden.

nein

Caption Legt die Beschriftung der Titelleiste im User Archives Table Element fest. neinClosable Legt fest, ob das User Archives Table Element über das "X" in der

Titelleiste geschlossen werden kann.nein

Delete Legt fest, ob im Runtime Löschvorgänge im User Archives Table Element durchgeführt werden dürfen.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. Im Bereich "Bearbeiten" der Registerkarte "Allgemein" steht dafür eine Checkbox zur Verfügung.

nein



Attribut Beschreibung dynamisierbarFilter Definiert Filterbedingungen für die Datenbank. Die Bedingungen werden

in der Datenbank-Programmiersprache SQL (Structured Query Language) formuliert.Beispiel: FieldC>100Es werden alle Datensätze selektiert, welche in der Spalte "FieldC" einen Wert größer als 100 besitzen.In der Registerkarte "Filter/Sortierung" können Sie die Filterbedingungen ebenfalls eingeben.

ja, mit dem Namen Filter

Form Legt die Ansicht des User Archives Table Elements beim Start in Runtime fest:Status "Ja": Gibt die Formularansicht ausStatus "Nein": gibt die Tabellenansicht aus.In der Registerkarte "Allgemein" können Sie diese Einstellung ebenfalls ändern

ja, mit dem Namen Form

GridBackColor Legt die Hintergrundfarbe des Datensatzes im User Archives Table Element fest.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Farben" können Sie diese Einstellungen ändern.

nein

GridFont Legt die Schriftart im User Archives Table Element fest.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Schriftarten" können Sie diese Einstellungen ändern.

nein

GridForeColor Legt die Schriftfarbe der Datensätze im User Archives Table Element fest.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Farben" können Sie diese Einstellungen ändern.

nein

HeaderBackColor Legt die Hintergrundfarbe der Kopfzeile und der Spalte mit der fortlaufenden Zeilennummer im User Archives Table Element fest.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Farben" können Sie diese Einstellungen ändern.

nein

HeaderForeColor Legt die Schriftfarbe der Kopfzeile und der Spalte mit der fortlaufenden Zeilennummer im User Archives Table Element fest.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Farben" können Sie diese Einstellungen ändern.

nein

Insert Legt fest, ob in Runtime Eingaben im User Archives Table Element gemacht werden können.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. Im Bereich "Bearbeiten" der Registerkarte "Allgemein" steht dafür eine Checkbox zur Verfügung.

nein



Attribut Beschreibung dynamisierbarLocaleSpecificSettings Legt das sprachabhängige Verhalten der Texte und Schriftarten fest, die

Sie im Eigenschaftendialog des Controls konfigurieren.Wert = "Ja": Sie können für jede Runtimesprache separat Texte und Schriftarten festlegen.Um einer Runtimesprache eine Schriftart zuzuweisen, wählen Sie im Graphics Designer im Menü "Ansicht/Sprache" eine Sprache aus und stellen Sie in den Controls die gewünschte Schriftart ein.Wert = "Nein": Sie können keine sprachabhängige Texte und Schriftarten festlegen.Die Konfiguration des Controls gilt stets für alle verfügbare Runtimesprachen.

ja, mit dem Namen LocaleSpecificSettings

Movable Legt fest, ob das User Archives Table Element verschiebbar ist. neinName Legt fest, welches Anwenderarchiv oder welche Sicht angezeigt wird.

Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. Im Bereich "Quelle" der Registerkarte "Allgemein" erhalten Sie hierfür eine Auswahl aller projektierten Anwenderarchive und Sichten.

nein

PressTBButton Verbindet alle Schaltflächen der Symbolleiste des Table Elements mit selbst definierten Schaltflächen oder EA-Feldern.

ja, mit dem Namen Press TB Button

PrintJob Legt fest, welches Layout für die Druckausgabe verwendet wird. neinPrintVisColsOnly Legt fest, ob beim Schnelldruck nur die aktuell sichtbaren Spalten

gedruckt werden.nein

Readonly Legt fest, ob das User Archives Table Element im Runtime editiert oder nur gelesen werden kann.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Allgemein" steht dafür eine Checkbox zur Verfügung.

nein

SelBackColor Legt die Hintergrundfarbe des selektierten Datensatzes im User Archives Table Element fest.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Farben" können Sie diese Einstellungen ändern.

nein

SelForeColor Legt die Schriftfarbe des selektierten Datensatzes im User Archives Table Element fest.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Farben" können Sie diese Einstellungen ändern.

nein

SelectedID Zeigt die ID des im Controlfenster angewählten Datensatzes.SelectedID = "0": wenn kein gültiger Datensatz gewählt ist, z.B. bei VerbindungsfehlerSelectedID = "-1" , wenn die Bearbeitungszeile angewählt ist.

nein

Sort Definiert die Sortierbedingungen für die Datenbank. Die Bedingungen werden in der Datenbank-Programmiersprache SQL (Structured Query Language) formuliert.In der Registerkarte "Filter/Sortierung" können Sie die Filterbedingungen ebenfalls eingeben.

ja, mit dem Namen Sort



Attribut Beschreibung dynamisierbarStatusbarDisabled Legt fest, ob die Statuszeile des User Archives Table Elements im

Runtime aktiviert wird.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Statuszeile" steht dafür die Checkbox "Ausschalten" zur Verfügung.

nein

StatusbarShowArc Legt fest, ob der Archivname in der Statuszeile des User Archives Table Elements ausgegeben wird.

ja, mit dem Namen StatusbarShowArc

StatusbarShowCol Legt fest, ob die laufende Nummer der aktuell angewählten Datensatzspalte in der Statuszeile des User Archives Table Elements ausgegeben wird.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Statuszeile" können Sie diese Einstellung unter "Aktuelle Spalte" ändern.

nein

StatusbarShowRecord Legt fest, ob die Feldkoordinaten des aktuell angewählten Datensatzes in der Statuszeile des User Archives Table Elements ausgegeben werden.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Statuszeile" können Sie diese Einstellung unter "Aktueller Datensatz" ändern.

nein

StatusbarShowRow Legt fest, ob die laufende Nummer der aktuell angewählten Datensatzzeile in der Statuszeile des User Archives Table Elements ausgegeben wird.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Statuszeile" können Sie diese Einstellung unter "Aktuelle Zeile" ändern.

nein

StatusbarShowText Legt fest, ob der aktuelle Zustand der Datenbank in der Statuszeile des User Archives Table Elements ausgegeben wird.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Statuszeile" können Sie diese Einstellung unter "Statustext" ändern.

nein

Titleline Legt fest, ob die Titelleiste im User Archives Table Element angezeigt wird.

nein

TimeZone Legt die Zeitbasis fest, die bei der Anzeige von Zeiten in Runtime verwendet wird.Die Zeitbasis wird über folgende Zahlenwerte eingestellt:Wert = 0: Projekteinstellungen übernehmenWert = 1: Zeitzone des ServersWert = 2: Lokale ZeitzoneWert = 3: Koordinierte Weltzeit UTCEmpfohlen ist die Standard-Einstellung "Projekteinstellungen übernehmen". Damit wird für die Anzeige immer die gleiche Zeitzone verwendet wie im restlichen Projekt.

nein

TimeZoneMark Legt fest, ob in der Spaltenüberschrift des LastAccess-Feldes die eingestellte Zeitzone angezeigt werden soll.Als Anzeige für die Zeitzone werden folgende Kürzel verwendet:LOC: Lokale ZeitzoneUTC: Koordinierte WeltzeitSVR: Zeitzone des Servers

nein



Attribut Beschreibung dynamisierbarToolbarDisabled Legt fest, ob die Symbolleiste des User Archives Table Elements im

Runtime aktiviert wird.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. In der Registerkarte "Symbolleiste" steht dafür die Checkbox "Ausschalten" zur Verfügung.

nein

Type Legt fest ob im User Archives Table Element ein Anwenderarchiv oder eine Sicht angezeigt wird.Wert Type= 0: Steht für ein AnwenderarchivWert Type= 1: Steht für eine Sicht.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. Im Bereich "Quelle" der Registerkarte "Allgemein" erhalten Sie hierfür eine Auswahl aller projektierten Anwenderarchive und Sichten.

nein

Update Legt fest, ob im Runtime Änderungen im User Archives Table Element gemacht werden können.Um Inkonsistenzen in der Datenbank zu vermeiden, sollte die Statik dieses Attributs nur in der Dialogbox des Eigenschaftendialoges editiert werden. Im Bereich "Bearbeiten" der Registerkarte "Allgemein" steht dafür die Checkbox "Change" zur Verfügung.

nein

2.7.6.6 Übersicht der dynamisierbaren Eigenschaften im Layout

FilterMit der Eigenschaft "Filter" können Sie Filterbedingungen für die Datenbank definieren. Die Bedingungen formulieren Sie in der Datenbank-Programmiersprache SQL. Format: SQL-TextVariablentyp: Textvariable

Sort

Mit der Eigenschaft "Sort" können Sie Sortierkriterien für die Datenbank definieren. Die Kriterien formulieren Sie in der Datenbank-Programmiersprache SQL. Format: SQL-TextVariablentyp: Textvariable

TimeZone

Legt die Zeitbasis fest, die bei der Anzeige von Zeiten in Runtime verwendet wird.Format: Zahl

Wert Beschreibung0 Lokale Zeitzone1 Zeitzone des Server2 Koordinierte Weltzeit UTC3 Projekteinstellungen übernehmen

Variablentyp: Alle Variablentypen, außer Binär-, Text- und Rohdatenvariable



COM-Provider im Seitenlayout-Editor 33.1 COM-Provider im Seitenlayout-Editor

InhaltIm Reportsystem von WinCC kann mit Hilfe einer COM-Schnittstelle ein anwenderspezifisches Protokollobjekt eingebunden werden. Damit können Daten, die nicht aus WinCC stammen in einem WinCC Protokoll ausgegeben werden. Diese Dokumentation informiert Sie über:

● Einsatzmöglichkeiten des COM-Provider

● Einbindung des COM-Providers in WinCC

● Ausgabe von Daten mit Hilfe eines COM-Objekts

● Details der COM-Schnittstelle für die Protokollierung


3.2 Arbeiten mit COM Server-Objekten

Einleitung Für die Integration von anwenderspezifischen Daten in ein WinCC Protokoll wird die Möglichkeit geboten, einen COM-Server in das Protokollsystem einzubinden. Dieser COM-Server stellt in der Objektauswahl ein COM-Objekt zur Verfügung, das im Seitenlayout-Editor ausgewählt und in ein Seitenlayout eingefügt werden kann. Das COM-Objekt liefert dann die anwenderspezifischen Daten für die Ausgabe im Protokoll. Das COM-Objekt kann vom Typ Text, Table oder Picture sein.

Über das COM-Objekt selbst kann an dieser Stelle keine Aussage gemacht werden. Die Informationen darüber erhalten Sie vom Schreiber des COM-Servers.

Einbinden eines COM-Server-ObjektesFolgende Schritte sind notwendig, um ein COM-Objekt im Protokollsystem zu nutzen:

1. COM-Objekt registrieren

2. Falls notwendig (hängt von dem COM-Objekt ab) Registrydatei des COM-Objektes ausführen

3. COM-Objekt durch einen Registryeintrag in der Objektpalette des Seitenlayout-Editor einhängen

4. COM-Objekt in der Objektauswahl selektieren

5. COM-Objekt im Layout platzieren und parametrieren

Die Schritte 1 bis 3 müssen auf jedem Server und WinCC-Client durchgeführt werden, auf dem Sie ein solches COM-Objekt benutzen möchten. Diese Schritte sind auch dann durchzuführen, wenn das COM-Objekt nur in Runtime genutzt werden soll.

Für die Erstellung eines COM-Servers für das Protokollsystem von WinCC muss auf dem Entwicklungsrechner die Type Library "WinCCProtProvider.tlb" registriert sein. Auf einem Rechner mit WinCC Installation ist diese Type Library automatisch registriert. Für die Registrierung auf einem Rechner ohne WinCC Installation gibt es folgend Möglichkeit:

Kopieren Sie von einem Rechner mit WinCC Installation die Datei "WinCCProtProvider.tlb". Die Datei liegt Im Verzeichnis "..\Siemens\WinCC\Interfaces". Fügen Sie die Datei auf dem Zielrechner ein und registrieren Sie sie.

Ein korrekt eingebundenes COM-Objekt wird in der Objektauswahl des Seitenlayout-Editor in der Registerkarte COM-Server angezeigt. Dort kann es selektiert und in das Layout eingefügt werden.

Weitere Hinweise erhalten Sie im Kapitel "Beschreibung der COM-Schnittstelle für die Protokollierung".

Siehe auchSo geben Sie Daten aus einem COM-Server in einem Bericht aus (Seite 473)

Beispiel zur Integration eines COM-Servers (Seite 474)

Beschreibung der COM-Schnittstelle für die Protokollierung (Seite 475)

COM-Provider im Seitenlayout-Editor3.2 Arbeiten mit COM Server-Objekten


3.3 So geben Sie Daten aus einem COM-Server in einem Bericht aus

Einleitung Für die Integration von anwenderspezifischen Daten in ein WinCC Protokoll wird die Möglichkeit geboten, einen COM-Server in das Protokollsystem einzubinden. Dieser COM-Server stellt in der Objektpalette ein Protokollobjekt zur Verfügung, das im Seitenlayout-Editor ausgewählt und in ein Seitenlayout eingefügt werden kann. Das COM-Objekt liefert dann die anwenderspezifischen Daten für die Ausgabe im Protokoll.

Verfügbare Protokollobjekte

Vom Anwender definiertes COM-Objekt

Dient zur Ausgabe von Daten aus eigenen Datenquellen des Anwenders in einem WinCC Protokoll.

Voraussetzungen● Kenntnisse über die Erstellung von Layouts und das Einfügen von Protokollobjekten.

Vorgehensweise1. Erstellen Sie ein Seitenlayout und öffnen Sie es im Seitenlayout-Editor.

2. Wählen Sie in der Objektpalette auf der Registerkarte COM-Server ein vom Anwender integriertes COM-Objekt aus und ziehen Sie es im Arbeitsbereich auf die gewünschte Größe auf.

3. Die Angaben zur Verbindung und Selektion der Daten stellt der Verfasser des COM-Objektes zur Verfügung.

4. Projektieren Sie das COM-Objekt entsprechend der dort gemachten Angaben.

5. Speichern Sie das Layout.

6. Erstellen Sie einen Druckauftrag und wählen Sie dort das projektierte Seitenlayout aus.

7. Starten Sie die Ausgabe über den Druckauftrag im WinCC Explorer, oder z.B. über einen projektierten Aufruf in einem WinCC Bild.

AusgabeoptionenAngaben zu möglichen Ausgabeoptionen erhalten Sie vom Schreiber des COM-Objektes.

Siehe auchArbeiten mit COM Server-Objekten (Seite 472)

Beschreibung der COM-Schnittstelle für die Protokollierung (Seite 475)


COM-Provider im Seitenlayout-Editor3.3 So geben Sie Daten aus einem COM-Server in einem Bericht aus


3.4 Beispiel zur Integration eines COM-Servers

Einleitung Auf der WinCC CD werden zwei Beispiele mitgeliefert, die je einen COM-Server enthalten. Ein Beispiel ist in Visual Basic geschrieben, das zweite Beispiel ist in Visual C geschrieben. Die Beispiele sind als ZIP-Datei im Pfad "Options\ODK\Samples" auf der WinCC CD abgelegt. Die Datei "CCProtTableServerExampleVB.zip" enthält das Beispiel in Visual Basic. Die Datei "CCProtPicturerExampleCPP.zip" enthält das Beispiel in Visual C++.

VorgehensweiseEntpacken Sie die komprimierte Datei in ein temporäres Verzeichnis. Binden Sie die Dateien in das System ein.

1. Bereitstellen der Type Library

2. Beispiel Kompilieren

3. COM-Server registrieren

4. Integration des COM-Servers in das Protokollsystem

Für die Integration des COM-Servers in das System benötigen Sie vertiefte Kenntnisse in der Programmierung, die in dieser Dokumentation nicht vermittelt werden können. Im Kapitel "Anforderungen an eine COM-Schnittstelle für die Protokollierung" finden Sie Hinweise zu den formalen Anforderungen an einen COM-Server.

Die mit den Beispielen mitgelieferten "*.REG"-Dateien sind kein Bestandteil der Beispielprojekte in Visual Basic bzw. Visual C, sondern dienen dazu, die COM-Server in die Objektpalette des Seitenlayout-Editor einzuhängen.

Hinweis

Die ClassID liegt bei Visual Basic nur in der kompilierten DLL. Wenn diese Datei nicht mitgeliefert wird, dann wird beim Übersetzen eine neue ClassID erzeugt. Diese neue ClassID muss im Regfile des Report-Providers eingetragen werden.

Die neue ClassID finden Sie über das Tool "OleView". Suchen Sie nach der ProgID.

Siehe auchBeschreibung der COM-Schnittstelle für die Protokollierung (Seite 475)

So geben Sie Daten aus einem COM-Server in einem Bericht aus (Seite 473)

COM-Provider im Seitenlayout-Editor3.4 Beispiel zur Integration eines COM-Servers


3.5 Beschreibung der COM-Schnittstelle für die Protokollierung

Einleitung In diesem Kapitel finden Sie Informationen und Anforderungen zu einer COM-Schnittstelle für die Protokollierung. Weitere Hinweise erhalten Sie in den Kapiteln "Ausgabe von Daten eines COM-Servers" und "Beispiel zur Integration eines COM-Servers".

Aufruf-SchnittstelleFolgende COM Schnittstellen kann/muss ein Objekt zur Verfügung stellen, damit das WinCC Protokollsystem dieses Objekt benutzen kann:

interface IWinCCProtProvider : IDispatch

{

HRESULT Register([in]IDispatch* pIDispWinCCProtReportParams);

HRESULT Unregister();

HRESULT GetName([out, retval]BSTR* pName);

HRESULT ShowPrivateDialog([in]long hwndParent, [out, retval]BOOL* pfOK);

HRESULT SetPrivateData([in]VARIANT PrivateInfo);

HRESULT GetNameOfPrivateData([out, retval]BSTR* pPrivateInfoName);

HRESULT GetPrivateData([out, retval]VARIANT* pPrivateData);

};

interface IWinCCProtProviderText : IDispatch

{

HRESULT GetText([out, retval]BSTR* pName);

};

interface IWinCCProtProviderTable : IDispatch

{

HRESULT GetNumCols([out, retval]int* pnNumCols);

HRESULT GetNumLines([out, retval]int* pnNumLines);

HRESULT GetText([in]int nLine, [in]int nCol, [out, retval]BSTR* pName);

HRESULT HasHeader([out, retval]BOOL* pfHasHeader);

HRESULT GetHeader([in]int nCol, [out, retval]BSTR* pName);

};

interface IWinCCProtProviderPicture : IDispatch

{

HRESULT Draw( [in]long hdc, [in]int lef, [in]int top,

[in]int right, [in]int bottom);

COM-Provider im Seitenlayout-Editor3.5 Beschreibung der COM-Schnittstelle für die Protokollierung


};

Das Objekt muss auf jeden Fall die Schnittstelle IWinCCProtProvider und eine der Schnittstellen IWinCCProtProviderText, IWinCCProtProviderTable, IWinCCProtProviderPicture unterstützen.

Als Zeilenvorschubzeichen beim Interface IWinCCProtProviderText dient CR +

LF (CR = "Carrage return" und LF = "line feed").

Interface IWinCCProtProvider

Register Wird nach dem Start des COM-Servers aufgerufen um dem Server einen Pointer auf das IWinCCProtReportParams zu übergeben.

Unregister Wird aufgerufen um dem COM-Server zu sagen, dass er den Pointer auf das Interface IWinCCProtReportParams wieder freigeben muss.

GetName Liefert den Namen des COM-Servers zur Anzeige an der Projektierungsoberfläche.

ShowPrivateDialog Öffnet den Selektionsdialog des COM-Servers.SetPrivateData Übergibt die im Layout gespeicherten SelCrit-Daten an den COM-

Server.GetPrivateData Liest die SelCrit-Daten aus dem COM-Server um sie im Layout

abzuspeichern.GetNameOfPrivateData Liefert den Namen des Selektionskriteriums zur Anzeige an der

Projektierungsoberfläche.

Interface IWinCCProtProviderTable

GetNumCols Liefert die Anzahl der Spalten die im Protokoll gedruckt werden sollen.GetNumLines Liefert die Anzahl der Zeilen die im Protokoll gedruckt werden sollen.HasHeader Liefert die Information, ob ein Tabellenkopf im Protokoll gedruckt werden soll.GetHeader Liefert den Tabellenkopf-Text der im Protokoll gedruckt werden soll.GetText Liefert den Text der im Report gedruckt werden soll.

Besonderheiten bei den Daten: Die Steuerzeichen für Farben, Ausrichtung etc. stehen immer am Anfang des Ausgabetextes und können miteinander kombiniert werden (z.B. "Ausgabetext"). Die Groß-/Kleinschreibung spielt keine Rolle.

<END> Beendet die Interpretation von Steuersequenzen, der Rest des Textes wird so übernommen wie er angegeben ist.

<COLOR=#rrggbb> Schriftfarbe in hexadezimaler Notation (default = wie bei der Tabelleneinstellung)

<BGCOLOR=#rrggbb> Hintergrundfarbe in hexadezimaler Notation (default = wie bei der Tabelleneinstellung)



 Schriftstil fett Schriftstil unterstrichen Schriftstil kursiv<STRIKE> Schriftstil durchgestrichen<ALIGN=left> Textausrichtung linksbündig<ALIGN=center> Textausrichtung zentriert<ALIGN=right> Textausrichtung rechtsbündig

Interface IWinCCProtProviderText

GetText Liefert den Text der im Protokoll gedruckt werden soll.

Interface IWinCCProtProviderPicture

Draw Übergibt dem COM-Server ein Handle auf den Device Kontext und die Koordinaten des Objektes in dem gezeichnet werden darf.

Zeichnen Sie hier das Ausgabebild in den angegebenen Device Kontext. Es handelt sich um ein Enhanced Metafile. Die Zeichnung erfolgt im MM_HIMETRIC-Mode.

Interface zum Auslesen von Parametern aus dem ProtokollkontextDas Protokollsystem stellt ein Interface zur Verfügung, um Parameter aus dem Protokollkontext (Einstellungen aus dem Protokollsystem und den JobProperties ) auszulesen.

interface IWinCCProtReportParams : IDispatch

{

HRESULT GetParameter ( [in]BSTR PropertyName, [out]VARIANT* Value );

};

Derzeit können folgende Properties ausgelesen werden:

TimeFrom Parameter aus dem DruckauftragTimeTo Parameter aus dem DruckauftragPrivateSelCrit Wird z.B. genutzt, wenn die Schaltfläche "Drucken" in einem WinCC Control

betätigt wird. Über dieses PrivateSelCrit werden die aktuellen Selektionen des WinCC Controls an den COM-Server übergeben.

ProjectName WinCC ProjektnameLCID_APP Aktuell eingestellte Sprache in der Applikation, die den COM-Server aufruft

(PrintIt/ProtCS). Die WinCC Systemsprache ist gegebenenfalls unterschiedlich, da die Runtime-Sprache von WinCC nicht aktiv unterstützt wird.

LCID_RT Aktuelle Runtime-Sprache von WinCC. Diese ist auch nur in Runtime ermittelbar.



RegistryeinträgeDie Einträge in der Registry erfolgen je nach COM-Objekt automatisch oder müssen durch Aufruf einer Registry-Datei in die Registry eingetragen werden. Die Registry-Datei muss von dem COM-Objekt mitgeliefert werden. Ohne diese Registryeinträge ist ein COM-Objekt für das Reportsystem nicht vorhanden, auch wenn das COM-Objekt registriert ist. Die Registrierung der COM-Objekte erfolgt durch den Anwender.

Beispiel für die Registry-Einträge eines COM-Servers:[HKEY_LOCAL_MACHINE\SOFTWARE\SIEMENS\WinCC\Report Designer\ReportClientDLLs\{4BF175C2-8BFF-11D0-840D-0080AD1374C8}] (GUI-ID des COM-Objektes als eindeutiger Schlüssel)

"DllClientGUID"="{4BF175C2-8BFF-11D0-840D-0080AD1374C8}" (GUID des COM-Objekts)

"DllFileName"="CCPComProvider.dll"

"NeedsRuntime"="NO"

"RunsOnServer"="YES"

"RunsOnClient"="YES"

"RunsOnMultiClient"="YES"

"UseReportDesignerObjTab"="COM-Server"

Verhalten der ApplikationsobjekteDie Aufrufe im COM-Server sind zeitüberwacht.

Debugunterstützung:Damit das Debugen von COM-Servern nicht durch das Timeout-Verhalten unnötig erschwert wird, kann die Timeout-Zeit eingestellt werden. Ist der Registrykey nicht definiert wird der Defaultwert (10000 Millisekunden) benutzt.

HKEY_CURRENT_USER\Software\SIEMENS\WINCC\ReportSystem\TimeOuts\

InvokeTimeOut (vom Typ DWORD) --> TimeOut Zeit in Millisekunden

Wird als Timeout-Zeit 0xffffffff (-1) als Wert eingetragen, so wartet das Reportsystem infinite auf die Funktion.

Siehe auchSo geben Sie Daten aus einem COM-Server in einem Bericht aus (Seite 473)




OPC - Open Connectivity 44.1 OPC - Open Connectivity

InhaltÜber die standardisierte Softwareschnittstelle OPC lassen sich Geräte und Anwendungen unterschiedlicher Hersteller in einheitlicher Weise miteinander kombinieren.

WinCC kann als OPC-Server und als OPC Client eingesetzt werden. Der Kanal "OPC" ist die OPC Client Anwendung von WinCC.

Dieses Kapitel zeigt Ihnen,

● welche OPC-Server WinCC hat.

● wie Sie OPC in WinCC verwenden.

● wie Sie verschiedene OPC-DA-Kopplungen projektieren.

● wie Sie den Zugriff auf das WinCC Meldesystem projektieren.

● wie das WinCC Meldesystem auf dem OPC-A&E-abgebildet wird.

● wie Sie den Zugriff auf das WinCC Archivsystem projektieren.


4.2 Funktionsweise von OPCOPC bezeichnet standardisierte herstellerunabhängige Softwareschnittstellen für den Datenaustausch in der Automatisierungstechnik.

Über die OPC-Schnittstellen haben sie die Möglichkeit, Geräte und Anwendungen unterschiedlicher Hersteller in einheitlicher Weise miteinander zu verknüpfen.OPC basiert auf den Windows-Technologien von COM (Component Object Model) und DCOM (Distributed Component Object Model).

Mit OPC XML DA steht eine weitere Softwareschnittstelle zur Verfügung, die auf den Internetstandards XML, SOAP und HTTP basiert.

OPC UA (Unified Architecture) ist die Nachfolgetechnologie von OPC. OPC UA ist plattformunabhängig und kann verschiedene Protokolle als Kommunikationsmedium verwenden.

OPC - Open Connectivity4.2 Funktionsweise von OPC


4.3 OPC SpezifikationenOPC spezifiziert Schnittstellen für den Zugriff auf folgende Objekte in WinCC:

● Prozesswerte (OPC Data Access 2.05a, 3.0; OPC XML Data Access 1.01; OPC UA 1.01)

● Archivierte Prozesswerte (OPC Historical Data Access 1.20; OPC UA 1.01)

● Historische Meldungen (OPC Historical Alarms and Events v1.10

● Meldungen (OPC Alarms and Events 1.10)

Detaillierte Informationen zu den einzelnen OPC Spezifikationen finden sie auf der Webseite der OPC Foundation (http://www.opcfoundation.org).

OPC - Open Connectivity4.3 OPC Spezifikationen


http://www.opcfoundation.org

4.4 KompatibilitätDie Unterstützung der genannten Spezifikationen wird regelmäßig durch das "Compliance Test Tool" (CTT) der OPC Foundation kontrolliert. Die Interoperabilität mit OPC-Produkten anderer Hersteller wird durch die Teilnahme an "OPC Interoperability Workshops" sichergestellt.

Die eingereichten Testergebnisse werden auf der Webseite der OPC Foundation veröffentlicht. Sie finden dort die Ergebnisse über den Sucheintrag "OPC Self-Certified Products".

Siehe auchwww.opcfoundation.org (http://www.opcfoundation.org)

OPC - Open Connectivity4.4 Kompatibilität



4.5 Verwendung von OPC in WinCC

EinleitungBei WinCC ab V7.2 stehen Server für folgende OPC-Schnittstellen zur Verfügung:

● OPC Data Access / OPC XML Data Access: Zugriff auf den Datenhaushalt von WinCC

● OPC Historical Data Access: Zugriff auf das WinCC Archivsystem

● OPC Alarms&Events: Zugriff auf das WinCC Meldesystem

● OPC Unified Architecture: Zugriff auf den Datenhaushalt und das Archivsystem von WinCC

Zusätzlich ist in WinCC standardmäßig ein OPC-Kanal enthalten. Der OPC-Kanal kann als Client über OPC DA , OPC XML DA oder OPC UA auf entsprechende OPC-Server zugreifen.

Lizenzierung

OPC-Server LizenzierungWinCC-OPC-UA-Server Eine gültige RT-Lizenz von WinCCWinCC-OPC-XML-DA-ServerWinCC-OPC-DA-ServerWinCC-OPC-HDA-ServerWinCC-OPC-A&E-Server

Eine gültige RT-Lizenz von WinCCWinCC-Option Connectivity Pack

OPC - Open Connectivity4.5 Verwendung von OPC in WinCC


OPC-Kommunikationskonzept von WinCCDas folgende Bild zeigt das OPC-Kommunikationskonzept von WinCC:

OPC - Open Connectivity4.5 Verwendung von OPC in WinCC


4.6 WinCC-OPC-XML-DA-Server

4.6.1 Funktionsweise des WinCC-OPC-XML-DA-Servers

Einleitung Der OPC-XML-DA-Server von WinCC ist als Webservice des Microsoft Internet Information Servers (IIS) realisiert.

Der WinCC-OPC-XML-DA-Server stellt dem OPC-XML-Client die OPC-Prozessdaten als Website zur Verfügung. Auf die Webseite wird über das Internet mit HTTP zugegriffen. Die Adresse des WinCC-OPC-XML-DA-Server lautet: <http://<xxx>/WinCC-OPC-XML/DAWebservice.asmx>"

Der WinCC-OPC-XML-DA-Server ist in WinCC nicht sichtbar. Wenn ein OPC-XMLClient Daten anfordert, wird der Webservice automatisch durch den Webserver gestartet.

Damit eine OPC-Kommunikation erfolgreich aufgebaut werden kann, beachten Sie Folgendes:

● Das WinCC Projekt des WinCC-OPC-XML-DA-Servers muss aktiviert sein.

● Der Rechner des WinCC-OPC-XML-DA-Servers muss über HTTP erreichbar sein.

LizenzierungFür den Betrieb WinCC-OPC-XML-DA-Server müssen auf jedem WinCC-Rechner, der als OPC-XML-DA-Server eingesetzt wird, folgende Lizenzen installiert sein:

● Eine gültige RT-Lizenz von WinCC

● WinCC Option Connectivity Pack

Besonderheiten bei Variablen vom Datentyp "String"Wenn Sie Variablen vom Typ "String" verwenden, die logisch Gleitkomma-Werte darstellen, können beim Schreiben und Lesen durch OPC-Clients Probleme auftreten.

BeschreibungEin OPC-Client schreibt auf eine String-Variable und gibt den neuen Wert nicht im Format "String" an, sondern als "Float", "Double" oder "Decimal".

ProblemDas Komma, das die Dezimalstelle angibt, kann verloren gehen. Dadurch wird der Wert verfälscht.

Dies betrifft auch den lesenden Zugriff auf String-Variablen, falls der gelesene Wert im Format "Float", "Double" oder "Decimal" angefordert wird.

AbhilfeVerwenden Sie für Gleitkomma-Werte nur entsprechende Gleitkomma-Variablen. Greifen Sie auf String-Variablen nur im String-Format zu.

OPC - Open Connectivity4.6 WinCC-OPC-XML-DA-Server



4.6.2 Installation

4.6.2.1 Installation

EinleitungOPC-XML erlaubt den Zugriff auf Prozessvariablen über das Internet. Um OPC XML zu betreiben, müssen zusätzliche Software-Komponenten installiert werden.

Hinweis

Halten Sie die nachfolgend beschriebene Installationsschrittreihenfolge unbedingt ein. Anderenfalls kann es zu Problemen bei der Installation kommen.

Installation des WinCC-OPC-XML-Server unter Windows 2000 und Windows XP1. Installation des Internet Information Server (IIS)

2. Bei Windows Server 2003 Installation des ASP.NET

3. Installation Microsoft .NET-Framework V2.0

4. Installation des WinCC-OPC-XML-Servers über WinCC-Setup

4.6.2.2 Installation des Internet Information Service (IIS)

EinleitungDer Internet Information Service (IIS) muss bei Verwendung von Windows 2000 Professional, Windows 2000 Server, Windows 2003 Server oder Windows XP vor dem WinCC-OPC-XML-Server installiert werden.

Hinweis

Um den Internet Information Service unter Windows installieren zu können, benötigen Sie Schreibrechte für die Registrierungsdatenbank. Sie müssen dafür über Administratorrechte verfügen.




Vorgehensweise1. Klicken Sie im Dialog "Software" auf das Symbol "Windows-Komponenten hinzufügen/

entfernen". Es öffnet sich der folgende Dialog.

2. Aktivieren Sie im Auswahlfenster das Kontrollkästchen vor dem Eintrag "Internet Informationsdienste (IIS)". Bei Windows Server 2003 befindet sich der IIS unter "Windows-Komponenten" > "Anwendungsserver" > "Internet-Informationdienst". Bei Windows Server 2003 müssen Sie auch ASP.NET installieren.

3. Klicken Sie anschließend auf "Weiter". Die benötigten Daten werden nun übertragen und die erforderliche Konfiguration von Windows vorgenommen.

4. Beenden Sie den Sie den Assistenten über die Schaltfläche "Fertigstellen".

4.6.2.3 Microsoft .NET-Framework installierenDas Microsoft .NET-Framework ist die Software zur Unterstützung von .NET-Anwendungen. Sie wird auch zum Betrieb von OPC XML-Webdienst benötigt.

Zur Installation sind etwa 80 Mbyte Speicherplatz auf der Festplatte erforderlich.

Die Microsoft .NET-Framework 2.0 steht Ihnen wie folgt zur Verfügung:

● Microsoft bietet die .NET-Framework-Software zum Download an: http://msdn.microsoft.com/downloads.

● Auf der CD des Microsoft Windows 2003 Server.

Installieren Sie die Software wie von Microsoft gefordert.



4.6.2.4 WinCC-OPC-XML-DA-Server installieren

Voraussetzung● Internet Information Service (IIS)

● Bei Windows Server 2003 Installation des ASP.NET

● Microsoft .NET-Framework 2.0

InstallationDer WinCC-OPC-XML-DA-Server kann bei der Installation von WinCC ausgewählt werden. Weitere Informationen finden Sie im WinCC Information System im Kapitel "Installation Notes" > "Installation von WinCC".

Folgende Einstellungen werden bei der Installation vorgenommen:

● Erstellen eines virtuellen Verzeichnisses "WinCC-OPC-XML"

● Festlegen der Zugriffsrechte auf das Verzeichnis

Siehe auchSo testen Sie die Installation (Seite 569)

So stellen Sie die Sicherheitseinstellungen mit IIS ein (Seite 567)



4.7 WinCC-OPC-DA-Server

4.7.1 Funktionsweise des WinCC-OPC-DA-Servers

Einleitung Der WinCC-OPC-DA-Server unterstützt die Spezifikationen OPC Data Access 2.05a und 3.00. Dies wurde durch den Compliance Test bestätigt. Ab WinCC V6.0 SP2 unterstützt der WinCC-OPC-DA-Server die Spezifikation OPC Data Access 3.00.

Der WinCC-OPC-DA-Server ist eine DCOM-Anwendung. Unter Verwendung dieser Softwareschnittstelle stellt der WinCC-OPC-DA-Server dem OPC-DA-Client die benötigten Informationen über WinCC Variablen zur Verfügung.

Der WinCC-OPC-DA-Server wird aktiv, wenn der WinCC-OPC-DA-Client über eine Verbindung auf den WinCC-OPC-DA-Server zugreift. Damit eine OPC-Kommunikation erfolgreich aufgebaut werden kann, beachten Sie Folgendes:

● Das WinCC Projekt des WinCC-OPC-DA-Servers muss aktiviert sein.

● Der Rechner des WinCC OPC-DA-Servers muss über seine IP-Adresse erreichbar sein.

InstallationDer WinCC-OPC-DA-Server kann bei der Installation von WinCC ausgewählt werden. Nach der Installation ist der WinCC-OPC-DA-Server ohne eine Projektierung sofort einsetzbar.

Der WinCC-OPC-DA-Server kann auf einem WinCC-Server oder WinCC-Client eingesetzt werden.

ProjektierungshinweisIn Ihrem WinCC-Projekt können Variablen zur Strukturierung in Variablengruppen zusammengefasst werden. Die Variablen dürfen nicht den selben Namen haben, wie eine Gruppe.

Hinweis

Wenn an einem Rechner bei den Internetoptionen unter "Verbindungen -> LAN Einstellungen" die automatische Suche nach Einstellungen aktiviert ist, wird der Zugriff auf OPC DA per Webservice stark verlangsamt.

OPC - Open Connectivity4.7 WinCC-OPC-DA-Server


Siehe auchKompatibilität (Seite 482)

So können Sie den Namen der OPC-DA-Server abfragen (Seite 491)

Verwendung mehrerer OPC-DA-Server (Seite 490)

Beispiel für die Kopplung WinCC - WinCC (Seite 492)

Beispiel für die Kopplung WinCC - SIMATIC NET FMS-OPC-Server (Seite 496)

Beispiel für die Kopplung WinCC - SIMATIC NET S7-OPC-Server (Seite 499)

Beispiel für die Kopplung von WinCC - Microsoft Excel (Seite 504)

www.opcfoundation.org (http://www.opcfoundation.org)

4.7.2 Verwendung mehrerer OPC-DA-Server

EinleitungAuf einem Rechner können mehrere OPC-DA-Server installiert sein und parallel arbeiten.So kann auf dem gleichen Rechner der OPC-DA-Server von WinCC und der OPC DA Server eines beliebigen Hersteller XYZ unabhängig voneinander betrieben werden.

Über den OPC-Server des Herstellers XYZ kann der WinCC-OPC-DA-Client auf die Prozesswerte des Automatisierungsgerätes zugreifen. Über den WinCC-DA OPC-Server kann der OPC-DA-Client von Microsoft Excel auf die Daten von WinCC zugreifen.

Es gibt eine Vielzahl von OPC-DA-Servern unterschiedlicher Hersteller. Jeder dieser OPC-DA-Server besitzt zur Identifikation einen eindeutigen Namen (ProgID). Diesen Namen muss der OPC-DA-Client verwenden, um den OPC-Server anzusprechen.




Über den OPC-Item-Manager können Sie den Namen des OPC-DA-Servers abfragen. Der Name des OPC-DA-Servers von WinCC V 7 lautet: "OPCServer.WinCC".

Siehe auchSo können Sie den Namen der OPC-DA-Server abfragen (Seite 491)

4.7.3 So können Sie den Namen der OPC-DA-Server abfragen

Einleitung Auf einem Rechner können mehrere OPC-DA-Server installiert sein. Der OPC-Item-Manager zeigt in einem Auswahlfenster die Namen der OPC-DA-Server an, die auf dem Rechner verfügbar sind. Dabei können die OPC-DA-Server auf demselben Rechner oder auf Rechnern in der angeschlossenen Netzwerkumgebung laufen.

VoraussetzungenFügen Sie im WinCC Projekt des WinCC-OPC-DA-Clients den Kanal "OPC" hinzu.



Vorgehensweise1. Wählen Sie auf dem WinCC-OPC-DA-Client im Kontextmenü der Kanal-Unit "OPC

Groups(OPCHN Unit#1)" den Eintrag "Systemparameter" aus. Der "OPC-Item-Manager" wird geöffnet.

2. Klicken Sie im Navigationsfenster des OPC-Item-Manager auf den Rechnernamen, auf den Sie zugreifen wollen.

3. Der OPC-Item-Manager zeigt Ihnen in einem Auswahlfenster die Namen der verfügbaren OPC-DA-Server dieses Rechners an.

4.7.4 Beispiele von OPC-DA-Kopplungen

4.7.4.1 Kopplung WinCC - WinCC

Beispiel für die Kopplung WinCC - WinCC

EinleitungBei der Kopplung WinCC - WinCC werden über die WinCC Variable "OPC_Server_Tag" Daten zwischen dem WinCC-OPC-DA-Server und dem WinCC-OPC-DA-Client ausgetauscht. Die WinCC Variable "Client_OPC_Server_Tag_xyz" auf dem WinCC-OPC-DA-Client greift auf die WinCC Variable "OPC_Server_Tag" zu. Ändert sich der Wert der WinCC Variablen "OPC_Server_Tag" auf dem WinCC-OPC-Server, so ändert sich auch der Wert der WinCC Variablen "Client_OPC_Server_Tag_xyz" auf dem WinCC-OPC-DA-Client. Eine Änderung auf dem WinCC-OPC-DA-Client hat auch eine Änderung auf dem WinCC-OPC-DA-Server zur Folge.



Die Darstellung der Variablen erfolgt auf beiden Rechnern in EA-Feldern.

Voraussetzungen● Zwei Rechner mit WinCC Projekten.

● Die Rechner müssen über Ihre IP-Adresse erreichbar sein.

ProjektierungsschritteFür die Kopplung WinCC-WinCC sind folgende Projektierungen notwendig:

1. WinCC Projekt auf dem WinCC-OPC-DA-Server projektieren.

2. WinCC Projekt auf dem WinCC-OPC-DA-Client projektieren.

Siehe auchSo projektieren Sie das WinCC Projekt auf dem WinCC-OPC-DA-Server (Seite 493)

So projektieren Sie das WinCC Projekt auf dem WinCC-OPC-DA-Client (Seite 494)

So projektieren Sie das WinCC Projekt auf dem WinCC-OPC-DA-Server

EinleitungIn diesem Abschnitt wird im WinCC Projekt des WinCC-OPC-DA-Servers eine WinCC Variable angelegt und in einem EA-Feld angezeigt.

Vorgehensweise1. Wählen Sie auf dem WinCC-OPC-DA-Server im Kontextmenü des Symbols "Interne

Variablen" den Eintrag "Neue Variable" aus. Legen Sie eine Variable "OPC_Server_Tag" vom Datentyp "Vorzeichenbehafteter 16-Bit Wert" an.

2. Starten Sie den Graphics Designer und öffnen Sie ein neues Bild.



3. Fügen Sie ein EA-Feld in das Bild ein. Wählen Sie dazu aus der Objektpalette unter "Smart Objekte" das Objekt "EA-Feld". Es öffnet sich der Dialog "EA-Feld Konfiguration".

4. Tragen Sie im Feld "Variable" den Namen "OPC_Server_Tag" ein.

5. Wählen Sie dazu als Aktualisierung "2s" und stellen Sie als Feldtyp "EA-Feld" ein.

6. Schließen Sie den Dialog über die Schaltfläche "OK" und speichern Sie das Bild.

7. Aktivieren Sie das WinCC Projekt über die Schaltfläche "Aktivieren" im Graphics Designer.

Siehe auchSo projektieren Sie das WinCC Projekt auf dem WinCC-OPC-DA-Client (Seite 494)

So projektieren Sie das WinCC Projekt auf dem WinCC-OPC-DA-Client

EinleitungIn diesem Abschnitt wird auf dem WinCC-OPC-DA-Client eine WinCC Variable angelegt, die auf eine WinCC Variable des WinCC-OPC-DA-Servers zugreift. Diese Variable wird in einem EA-Feld ausgegeben.

Voraussetzungen● Fügen Sie im WinCC Projekt des WinCC-OPC-DA-Clients den Kanal "OPC" hinzu.

● Projektieren Sie im WinCC Projekt des WinCC-OPC-DA-Servers eine interne Variable "OPC_Server_Tag" vom Datentyp "Vorzeichenbehafteter 16-Bit Wert".

● Aktivieren Sie das WinCC Projekt des WinCC-OPC-DA-Servers.


Groups(OPCHN Unit#1)" den Eintrag "Systemparameter" aus. Es öffnet sich der "OPC-Item-Manager".

2. Klicken Sie im Auswahlfenster auf den Namen des Rechners, der als OPC-DA-Server eingesetzt wird. Wählen Sie aus der angezeigten Liste "OPCServer.WinCC" aus. Klicken Sie auf die Schaltfläche "Browse Server". Es öffnet sich der Dialog "Filterkriterien".



3. Klicken Sie im Dialog "Filterkriterien" auf die Schaltfläche "Weiter ->". Wählen Sie im Dialog "OPCServer.WinCC .." die Variable "OPC_Server_Tag" aus. Klicken Sie auf die Schaltfläche "Items hinzufügen".

4. Wenn schon eine Verbindung zum OPC-DA-Server angelegt ist, so fahren Sie mit Schritt 5 fort.Ist noch keine Verbindung angelegt, erscheint eine entsprechende Meldung.Klicken Sie auf die Schaltfläche "Ja". Es öffnet sich der Dialog "Neue Verbindung".

Tragen Sie den Namen "OPCServer_WinCC" für die Verbindung ein. Klicken Sie auf die Schaltfläche "OK".

5. Es öffnet sich der Dialog "Variablen hinzufügen".Tragen Sie im Feld "Präfix" "Client_" und im Feld "Suffix" "_xyz" ein. Wählen Sie die Verbindung "OPCServer_WinCC" aus. Klicken Sie auf die Schaltfläche "Fertigstellen".

6. Klicken Sie im Dialog "OPCServer.WinCC .." auf die Schalfläche "<- Zurück". Klicken Sie im Dialog "OPC-Item-Manager" auf die Schaltfläche "Beenden" um den OPC-Item-Manager zu schließen.



7. Starten Sie den Graphics Designer und öffnen Sie ein neues Bild. Fügen Sie ein EA-Feld in das Bild ein. Wählen Sie dazu aus der Objektpalette unter "Smart Objekte" das Objekt "EA-Feld". Es öffnet sich der Dialog "EA-Feld Konfiguration".

8. Tragen Sie im Feld "Variable" den Namen "Client_OPC_Server_Tag_xyz" ein. Wählen Sie als Aktualisierung "2 s". Stellen Sie als Feldtyp "EA-Feld" ein. Schließen Sie den Dialog und speichern Sie das Bild. Aktivieren Sie das WinCC Projekt über die Schaltfläche "Aktivieren" im Graphics Designer.

9. Im EA-Feld auf dem WinCC-OPC-DA-Server und dem WinCC-OPC-DA-Client wird der Wert der projektierten Variablen angezeigt. Geben Sie im EA-Feld auf dem WinCC-OPC-DA-Server einen neuen Wert ein. Im EA-Feld des WinCC-OPC-DA-Clients wird der geänderte Wert angezeigt.


4.7.4.2 Kopplung WinCC - SIMATIC NET FMS-OPC-Server

Beispiel für die Kopplung WinCC - SIMATIC NET FMS-OPC-Server

EinleitungBei der Installation von SIMATIC NET können Sie auswählen welche OPC-Server installiert werden sollen. Im folgenden Beispiel wird die Kopplung WinCC - SIMATIC NET FMS-OPC-Server projektiert. Durch den SIMATIC NET FMS-OPC-Server werden die Daten des Automatisierungsgeräts WinCC zur Verfügung gestellt.

In diesem Beispiel wird WinCC als WinCC-OPC-DA-Client eingesetzt. Der OPC-Item-Manager zeigt die Indizes der Objektliste, die auf der AG-Seite projektiert sind.

Der aktuelle Wert der Variable wird in einem EA-Feld angezeigt. Sobald sich der Wert der Variablen auf dem SIMATIC NET FMS-OPC-Server ändert, wird der geänderte Wert im Prozessbild auf dem WinCC-OPC-DA-Client dargestellt. Umgekehrt kann ein im EA-Feld eingegebener Wert an das AG übergeben werden.



Voraussetzungen● Ein Rechner mit WinCC, SIMATIC NET Software.

● Eingerichteter SIMATIC NET FMS-OPC-Server. Weiterführende Informationen zur Einrichtung des SIMATIC NET S7-OPC-Servers finden Sie bei der Dokumentation zu SIMATIC NET.

ProjektierungsschritteDazu ist folgende Projektierung im WinCC Projekt des WinCC-OPC-DA-Clients notwendig:

1. Kopplung WinCC - SIMATIC NET FMS-OPC-Server projektieren.

Communication ManualHier finden Sie weitere Informationen mit ausführlichen Beispielen zur Projektierung von Kanälen. Dieses Handbuch wird im Internet zum Download angeboten:

● http://support.automation.siemens.com/

Suchen Sie nach der Bestellnummer:

● A5E00391327



So projektieren Sie die Kopplung WinCC - SIMATIC NET FMS-OPC-Server

EinleitungIn diesem Abschnitt wird im WinCC Projekt des WinCC-OPC-DA-Clients eine WinCC Variable projektiert, die auf einen FMS-Index zugreift. Diese Variable wird in einem EA-Feld angezeigt.

Voraussetzungen● Fügen Sie im WinCC Projekt des WinCC-OPC-DA-Clients den Kanal "OPC" hinzu.


Groups(OPCHN Unit#1)" den Eintrag "Systemparameter" aus. Es öffnet sich der "OPC-Item-Manager".

2. Klicken Sie im Auswahlfenster auf den Namen des Rechners, der als OPC-DA-Server eingesetzt wird. Wählen Sie aus der angezeigten Liste "OPC.SIMATICNet" aus.Klicken Sie auf die Schaltfläche "Browse Server". Es öffnet sich der Dialog "Filterkriterien".

3. Klicken Sie im Dialog "Filterkriterien" auf die Schaltfläche "Weiter ->". Es öffnet sich der Dialog "OPC.SIMATICNet..". Im Auswahlfenster bekommen Sie alle projektieren FMS-Indizes angezeigt. Wählen Sie einen Index aus. Klicken Sie auf die Schaltfläche "Items hinzufügen".

4. Wenn schon eine Verbindung zum SIMATIC NET FMS-OPC-Server angelegt ist, so fahren Sie mit Schritt 5 fort.Ist noch keine Verbindung angelegt, erscheint eine entsprechende Meldung.Klicken Sie auf die Schaltfläche "Ja". Es öffnet sich der Dialog "Neue Verbindung".

Tragen Sie den Namen "OPC_SimaticNET" für die Verbindung ein. Klicken Sie auf die Schaltfläche "OK".

5. Es öffnet sich der Dialog "Variablen hinzufügen".Tragen Sie im Feld "Präfix" "Client_" und im Feld "Suffix" "_xyz" ein. Wählen Sie die Verbindung "OPC_SimaticNET" aus. Klicken Sie auf die Schaltfläche "Fertigstellen".

6. Klicken Sie im Dialog "OPC.SIMATICNet .." auf die Schalfläche "<- Zurück". Klicken Sie im Dialog "OPC-Item-Manager" auf die Schaltfläche "Beenden" um den OPC-Item-Manager zu schließen.

7. Starten Sie den Graphics Designer und öffnen Sie ein neues Bild. Fügen Sie ein EA-Feld in das Bild ein. Wählen Sie dazu aus der Objektpalette unter "Smart Objekte" das Objekt "EA-Feld". Es öffnet sich der Dialog "EA-Feld Konfiguration".



8. Tragen Sie im Feld "Variable" den Namen der Variablen ein. Wählen Sie als Aktualisierung "2s". Stellen Sie als Feldtyp "EA-Feld" ein.

9. Schließen Sie den Dialog über die Schaltfläche "OK" und speichern Sie das Bild. Aktivieren Sie das WinCC Projekt über die Schaltfläche "Aktivieren" im Graphics Designer.

10.Im EA-Feld bekommen Sie den aktuellen Wert des FMS-Indizes angezeigt. Der Wert wird alle 2s aktualisiert. Geben Sie einen Wert in das EA-Feld ein. Der geänderte Wert wird an das AG übergeben.

4.7.4.3 Kopplung WinCC - SIMATIC NET S7-OPC-Server

Beispiel für die Kopplung WinCC - SIMATIC NET S7-OPC-ServerBei der Installation von SIMATIC NET können Sie auswählen welche OPC-Server installiert werden sollen. Im folgenden Beispiel wird die Kopplung WinCC - SIMATIC NET S7-OPC-Server projektiert. Durch den SIMATIC NET S7-OPC-Server werden die Daten des Automatisierungsgerätes dem WinCC Client zur Verfügung gestellt.

Der aktuelle Wert der Variable wird auf dem WinCC-OPC Client in einem EA-Feld angezeigt. Sobald sich der Wert der Variablen auf dem SIMATIC NET S7-OPC-Server ändert, wird der geänderte Wert im Prozessbild dargestellt. Umgekehrt kann ein im EA-Feld eingegebener Wert an das AG übergeben werden.



Voraussetzungen● Ein Rechner mit WinCC, SIMATIC NET Software.

● Eingerichteter SIMATIC NET S7-OPC-Server. Weiterführende Informationen zur Einrichtung des SIMATIC NET S7-OPC-Servers finden Sie bei der Dokumentation zu SIMATIC NET.

ProjektierungsschritteFür die Kopplung WinCC - SIMATIC NET S7-OPC-Server sind folgende Projektierungen notwendig:

1. Variablen zum SIMATIC NET S7-OPC-Server hinzufügen

2. Zugriff auf Variablen des SIMATIC NET S7-OPC-Servers projektieren

Communication ManualHier finden Sie weitere Informationen mit ausführlichen Beispielen zur Projektierung von Kanälen. Dieses Handbuch wird im Internet zum Download angeboten:

● http://support.automation.siemens.com/

Suchen Sie nach der Bestellnummer:

● A5E00391327

So fügen Sie Variablen zum SIMATIC NET S7-OPC-Server hinzu

EinleitungDamit der OPC Item Manager die Variablen anzeigen kann, müssen diese in den Adressraum des SIMATIC NET S7-OPC-Server hinzugefügt werden. Zur Projektierung wird das Programm "OPC Scout" verwendet. Der OPC Scout wird über die Installation von SIMATIC NET hinzugefügt. Für dieses Beispiel wird das Merkerwort 0 im AG angesprochen.

Tabelle der verwendeten Parameter

Parameter WertDatatype WRange Byte 0No. Values 1Itemalias MW0



Voraussetzungen● Projektieren Sie eine S7-Verbindung in der SIMATIC NET Software. Weiterführende

Informationen dazu finden Sie bei der Dokumentation zu SIMATIC NET.

Vorgehensweise1. Starten Sie den "OPC Scout" über Start "Programme" "SimaticNet"

"OPCServer" "OPCScout" .

2. Wählen Sie bei "Local Server(s)" das Element "OPC.SimaticNet" aus. Falls Ihr SIMATIC S7-OPC-Servers nicht auf demselben Rechner ausgeführt wird, wählen Sie im Kontextmenü von "Server(s)" den Eintrag "Add Remote Server(s)". Tragen Sie im Dialog "Add Remote Server(s)" den Namen des Rechners ein, der als OPC-Server eingesetzt wird und schließen Sie den Dialog über die Schaltfläche "OK".

3. Wählen Sie im Kontextmenü von "OPC.SimaticNet" den Eintrag "Connect". Es öffnet sich der Dialog "Add Group". Tragen Sie einen Namen für die Gruppe ein. Schließen Sie den Dialog über die Schaltfläche "OK".



4. Wählen Sie im Kontextmenü der hinzugefügten Gruppe den Eintrag "Add Item". Es öffnet sich der "OPC-Navigator ".

5. Wählen Sie im "OPC Navigator" unter "objects" das Element "M" für Merker aus. Mit einem Doppelklick auf "(New Definition)" öffnet sich der Dialog "Define New Variable".

6. Tragen Sie im Dialog "Define New Variable" die Parameter laut Tabelle ein.

Schließen Sie den Dialog "Define New Variable" über die Schaltfläche "OK".

7. Markieren Sie im "OPC Navigator" im Bereich "Leaves" die Variable "MW0". Klicken Sie auf die Schaltfläche "--> ". Klicken Sie im "OPC-Navigator" auf die Schaltfläche "OK".



Siehe auchSo projektieren Sie den Zugriff auf Variablen des SIMATIC NET S7-OPC-Servers (Seite 503)

So projektieren Sie den Zugriff auf Variablen des SIMATIC NET S7-OPC-Servers

EinleitungIn diesem Abschnitt wird im WinCC Projekt des WinCC-OPC-DA-Clients eine WinCC Variable projektiert, die auf die Variable MW0 im Adressraum des SIMATIC NET S7-OPC-Servers zugreift. Diese Variable wird in einem EA-Feld angezeigt.

Voraussetzungen● Legen Sie mit dem OPC Scout eine Variable MW0 an.

● Fügen Sie im WinCC Projekt des WinCC-OPC-DA-Clients den Kanal "OPC" hinzu.

Vorgehensweise1. Wählen Sie im Kontextmenü des Symbols "OPC Groups(OPCHN Unit#1)" den Eintrag

"Systemparameter" aus. Es öffnet sich der "OPC-Item-Manager".

2. Klicken Sie im Auswahlfenster auf den Namen des Rechners, der als OPC-Server eingesetzt wird. Wählen Sie aus der angezeigten Liste "OPC.SIMATICNet" aus.Klicken Sie auf die Schaltfläche "Browse Server". Es öffnet sich der Dialog "Filterkriterien".

3. Klicken Sie im Dialog "Filterkriterien" auf die Schaltfläche "Weiter ->". Es öffnet sich der Dialog "OPC.SIMATICNet..". Wählen Sie die Variable "MW0" aus. Klicken Sie auf die Schaltfläche "Items hinzufügen".

4. Wenn schon eine Verbindung zum SIMATIC NET FMS-OPC-Server angelegt ist, so fahren Sie mit Schritt 5 fort.Ist noch keine Verbindung angelegt, erscheint eine entsprechende Meldung.Klicken Sie auf die Schaltfläche "Ja". Es öffnet sich der Dialog "Neue Verbindung".

Tragen Sie den Namen "OPC_SimaticNET" für die Verbindung ein. Klicken Sie auf die Schaltfläche "OK".

5. Es öffnet sich der Dialog "Variablen hinzufügen".Tragen Sie im Feld "Präfix" "Client_" und im Feld "Suffix" "_xyz" ein. Wählen Sie die Verbindung "OPC_SimaticNET" aus. Klicken Sie auf die Schaltfläche "Fertigstellen",



6. Klicken Sie im Dialog "OPC.SIMATICNet .." auf die Schalfläche "<- Zurück". Klicken Sie im Dialog "OPC-Item-Manager" auf die Schaltfläche "Beenden" um den OPC-Item-Manager zu schließen.

7. Starten Sie den Graphics Designer und öffnen Sie ein Bild. Fügen Sie ein EA-Feld in das Bild ein. Wählen Sie dazu aus der Objektpalette unter "Smart Objekte" das Objekt "EA-Feld". Es öffnet sich der Dialog "EA-Feld Konfiguration".

8. Tragen Sie im Feld "Variable" den Namen "Client_MW0_xyz" ein. Wählen Sie als Aktualisierung "2s". Stellen Sie als Feldtyp "EA-Feld" ein.

9. Schließen Sie den Dialog und speichern Sie das Bild. Aktivieren Sie das WinCC Projekt über die Schaltfläche "Aktivieren" im Graphics Designer.

10.Im EA-Feld auf dem WinCC-OPC-DA-Client bekommen Sie den aktuellen Wert der S7-Variablen angezeigt. Der Wert wird alle 2s aktualisiert. Geben Sie einen Wert in das EA-Feld ein. Der geänderte Wert wird an das AG übergeben.

Siehe auchSo fügen Sie Variablen zum SIMATIC NET S7-OPC-Server hinzu (Seite 500)

4.7.4.4 Kopplung WinCC - Microsoft Excel

Beispiel für die Kopplung von WinCC - Microsoft Excel

EinleitungIn diesem Beispiel wird ein OPC-DA-Client im Visual Basic Editor von Microsoft Excel erstellt. Der OPC-DA-Client greift auf eine WinCC-Variable im WinCC-Projekt des WinCC-OPC-DA-Servers zu und gibt den Wert in einer Zelle aus. Wird ein neuer Wert in eine Zelle eingegeben, so wird der Wert an den WinCC-OPC-DA-Server übergeben.

Für die Kopplung wird ein Rechner verwendet, auf dem WinCC und Microsoft Excel installiert sind.



ProjektierungsschritteDazu sind folgende Projektierungen in Microsoft Excel notwendig:

1. Erstellen eines OPC-DA-Client im Visual Basic Editor von Microsoft Excel

2. Zugriff auf eine WinCC-Variable in Microsoft Excel projektieren

Siehe auchSo projektieren Sie den Zugriff auf eine WinCC Variable in Microsoft Excel (Seite 507)

So erstellen Sie in Microsoft Excel einen OPC-DA-Client (Seite 505)

So erstellen Sie in Microsoft Excel einen OPC-DA-Client

Einleitung Um Microsoft Excel als OPC-DA-Client zu verwenden, muss im Visual Basic Editor von Microsoft Excel ein entsprechendes Skript erstellt werden.

VoraussetzungenGrundkenntnisse im Arbeiten mit Visual Basic Editors von Microsoft Excel.

Vorgehensweise1. Starten Sie Microsoft Excel mit einer neuen Arbeitsmappe.

2. Klicken Sie im Menü "Extras" auf "Makro" "Visual Basic Editor". Es öffnet sich der Visual Basic Editor von Microsoft Excel.

3. Klicken Sie im Menü "Extras" des Visual Basic Editor auf "Verweise". Es öffnet sich der Dialog "Verweise - VBA Projekt". Suchen Sie in der Liste der "Verfügbaren Verweise" den Eintrag "Siemens OPC DAAutomation 2.0". Setzen Sie im Kontrollkästchen ein Häkchen. Klicken Sie auf die Schaltfläche "OK".

4. Kopieren Sie das Skript im nachfolgenden Abschnitt. Dieses Skript ist nur in der Online-Hilfe verfügbar.

5. Öffnen Sie im Projektfenster des Visual Basic Editor durch einen Doppelklick auf den Eintrag "Tabelle1" ein neues Codefenster.

6. Fügen Sie das Skript in das Codefenster ein.

7. Klicken Sie im Menü "Datei" auf "Speichern". Klicken Sie im Menü "Datei" auf "Schließen und zurück zu Microsoft Excel" .

Beispiel-Skript

Option Explicit



Option Base 1 Const ServerName = "OPCServer.WinCC" Dim WithEvents MyOPCServer As OpcServerDim WithEvents MyOPCGroup As OPCGroupDim MyOPCGroupColl As OPCGroupsDim MyOPCItemColl As OPCItemsDim MyOPCItems As OPCItemsDim MyOPCItem As OPCItem Dim ClientHandles(1) As LongDim ServerHandles() As LongDim Values(1) As VariantDim Errors() As LongDim ItemIDs(1) As StringDim GroupName As StringDim NodeName As String '---------------------------------------------------------------------' Sub StartClient()' Purpose: Connect to OPC_server, create group and add item'---------------------------------------------------------------------Sub StartClient() ' On Error GoTo ErrorHandler '----------- We freely can choose a ClientHandle and GroupName ClientHandles(1) = 1 GroupName = "MyGroup" '----------- Get the ItemID from cell "A1" NodeName = Range("A1").Value ItemIDs(1) = Range("A2").Value '----------- Get an instance of the OPC-Server Set MyOPCServer = New OpcServer MyOPCServer.Connect ServerName, NodeName Set MyOPCGroupColl = MyOPCServer.OPCGroups '----------- Set the default active state for adding groups MyOPCGroupColl.DefaultGroupIsActive = True '----------- Add our group to the Collection Set MyOPCGroup = MyOPCGroupColl.Add(GroupName) Set MyOPCItemColl = MyOPCGroup.OPCItems '----------- Add one item, ServerHandles are returned MyOPCItemColl.AddItems 1, ItemIDs, ClientHandles, ServerHandles, Errors '----------- A group that is subscribed receives asynchronous notifications MyOPCGroup.IsSubscribed = True Exit Sub ErrorHandler: MsgBox "Error: " & Err.Description, vbCritical, "ERROR"End Sub '---------------------------------------------------------------------' Sub StopClient()' Purpose: Release the objects and disconnect from the server'---------------------------------------------------------------------Sub StopClient()



'----------- Release the Group and Server objects MyOPCGroupColl.RemoveAll '----------- Disconnect from the server and clean up MyOPCServer.Disconnect Set MyOPCItemColl = Nothing Set MyOPCGroup = Nothing Set MyOPCGroupColl = Nothing Set MyOPCServer = NothingEnd Sub '---------------------------------------------------------------------' Sub MyOPCGroup_DataChange()' Purpose: This event is fired when a value, quality or timestamp in our Group has changed'---------------------------------------------------------------------'----------- If OPC-DA Automation 2.1 is installed, use:Private Sub MyOPCGroup_DataChange(ByVal TransactionID As Long, ByVal NumItems As Long, ClientHandles() As Long, ItemValues() As Variant, Qualities() As Long, TimeStamps() As Date) '----------- Set the spreadsheet cell values to the values read Range("B2").Value = CStr(ItemValues(1)) Range("C2").Value = Hex(Qualities(1)) Range("D2").Value = CStr(TimeStamps(1))End Sub '---------------------------------------------------------------------' Sub worksheet_change()' Purpose: This event is fired when our worksheet changes, so we can write a new value'---------------------------------------------------------------------Private Sub worksheet_change(ByVal Selection As Range) '----------- Only if cell "B3" changes, write this value If Selection <> Range("B3") Then Exit Sub Values(1) = Selection.Cells.Value '----------- Write the new value in synchronous mode MyOPCGroup.SyncWrite 1, ServerHandles, Values, ErrorsEnd Sub


So projektieren Sie den Zugriff auf eine WinCC Variable in Microsoft Excel

EinleitungDer Excel OPC-DA-Client greift auf eine WinCC Variable des WinCC-OPC-DA-Servers zu und gibt den Wert der Variablen in einer Zelle aus. Im WinCC Projekt des WinCC-OPC-DA-Servers wird der Wert der Variablen in einem EA-Feld angezeigt. Ändern Sie den Wert der Variablen in einer Zelle, so ändert sich der Wert im EA-Feld des WinCC-OPC-DA-Servers.



Voraussetzungen● Legen Sie im WinCC Projekt des WinCC-OPC-DA-Servers eine interne Variable

"OPC_Excel" vom Datentyp "vorzeichenbehafteter 16-Bit Wert" an.

● Geben Sie den Wert der Variablen "OPC_Excel" in einem EA-Feld im WinCC Projekt des WinCC-OPC-DA-Servers aus.

● Aktivieren Sie das WinCC Projekt des WinCC-OPC-DA-Server

Vorgehensweise1. Tragen Sie in "Microsoft Excel" in der Zelle A1 den Namen des Rechners ein, der als OPC-

Server eingesetzt wird. Tragen Sie in der Zelle A2 den Variablenname "OPC_Excel" ein.

2. Klicken Sie im Menü "Extra" von Microsoft Excel auf "Makro" "Makros". Es öffnet sich der Dialog "Makro". Wählen Sie im Feld "Makronamen" den Eintrag "Tabelle1.StartClient" aus. Klicken Sie auf die Schaltfläche "Ausführen" um den OPC Client zu starten.

3. In der Zelle B2 wird der Wert der Variablen, in C2 der Quality Code und in D2 der Zeitstempel ausgegeben.

4. Geben Sie in der Zelle B3 einen neuen Wert ein. Im EA-Feld des WinCC-OPC-Servers wird der geänderte Wert angezeigt.

5. Klicken Sie im Menü "Extras" in Microsoft Excel auf "Makro" "Makros". Es öffnet sich der Dialog "Makro". Wählen Sie im Feld "Makronamen" den Eintrag "Tabelle1.StopClient" aus. Klicken Sie auf die Schaltfläche "Ausführen" um den OPC Client zu stoppen.



4.8 WinCC-OPC-HDA-Server

4.8.1 Funktionsweise des WinCC-OPC-HDA-Servers

Einleitung Der WinCC-OPC-HDA-Server ist eine DCOM-Anwendung und stellt dem OPC-HDA-Client die benötigten Daten des WinCC Archivsystems zur Verfügung. Über Item Handles wird auf die Daten zugegriffen. Auf die Daten können lesend oder schreibend zugegriffen werden. Zusätzlich können die Daten auch analysiert werden.

Der WinCC-OPC-HDA-Server unterstützt die Spezifikation OPC Historical Data Access 1.20. Dies wurde durch den Compliance Test bestätigt.

Die folgenden Kapitel zeigen den Aufbau der Datenstruktur, sowie die vom WinCC-OPC-HDA-Server unterstützten Attribute, Aggregate und Funktionen. Hier erfolgt keine ausführliche Beschreibung, sondern eine Übersicht der spezifischen Informationen. Weiterführende Informationen dazu finden Sie in der Spezifikation zu "OPC Historical Data Access 1.20".

InstallationDer WinCC-OPC-HDA-Server kann bei der Installation von WinCC angewählt werden. Dabei kann gewählt werden, ob mit oder ohne schreibenden Zugriff auf das WinCC Archivsystem. Nach der Installation ist der WinCC-OPC-HDA-Server ohne eine Projektierung sofort einsetzbar.

Bei der Installation ohne schreibenden Zugriff können die Daten des WinCC Archivsystems nur gelesen und analysiert werden. Beim schreibenden Zugriff können die Daten des WinCC Archivsystems analysiert, hinzugefügt, gelöscht und aktualisiert werden.

Der WinCC-OPC-HDA-Server kann auf einem WinCC-Server oder WinCC-Client eingesetzt werden.

LizenzierungFür den Betrieb WinCC-OPC-HDA-Server müssen auf jedem WinCC-Rechner, der als OPC-HDA-Server eingesetzt wird, folgende Lizenzen installiert sein:



OPC-HDA-ClientAlle OPC-HDA-Clients der Spezifikation OPC Historical Data Access 1.20 können auf den WinCC-OPC-HDA-Server zugreifen. Der OPC-HDA-Client kann u.a. eigen erstellt sein. Durch Verwendung von eigen entwickelten OPC-HDA-Clients können die Anforderungen bestmöglich erfüllt werden.

Ein OPC-HDA-Client kann z.B. eingesetzt werden:

OPC - Open Connectivity4.8 WinCC-OPC-HDA-Server


● Zur Analyse und Auswertung von Archivdaten.

● Zur statischen Prozesskontrolle über Archive aus unterschiedlichen OPC-HDA-Server.

Wenn Sie mit dem OPC-HDA-Client historische Werte anfordern, dann beachten Sie bei der Projektierung Folgendes:

● Wählen Sie den Zyklus einer Abfrage so, dass der Client die angeforderten Daten empfangen hat, bevor die nächste Abfrage gestellt wird. Zu kurze Zyklen können einen hohen Zeitversatz beim Empfangen der Daten verursachen.

● Die CPU-Last des WinCC-Servers ist abhängig von der Anzahl der Variablen pro Abfrage.

Schreibender Zugriff auf Umlaufarchive mit projektierter AuslagerungIn Runtime werden die Daten jeweils in den Umlaufarchiven auf dem WinCC-Server geändert.

Die Änderungen werden nur dann in das ausgelagerte Archiv übernommen, wenn die Daten zeitnah zur Entstehung geändert werden.

Wenn das betroffene Archivsegment des Umlaufarchivs bereits ausgelagert ist, wird die Änderung nicht nachträglich in das ausgelagerte Archiv übernommen. Beim Löschen des Archivsegments auf dem WinCC-Server werden auch die geänderten Daten gelöscht.


Quality Codes (Seite 516)

Datenstruktur des WinCC-OPC-HDA-Servers (Seite 510)


4.8.2 Datenstruktur des WinCC-OPC-HDA-Servers

4.8.2.1 Datenstruktur des WinCC-OPC-HDA-Servers

EinleitungDie Daten des WinCC-OPC-HDA-Servers sind strukturiert. In diesem Abschnitt wird die Datenstruktur tabellarisch aufgelistet. Hier erfolgt keine ausführliche Beschreibung, sondern eine Übersicht der spezifischen Informationen. Weiterführende Informationen dazu finden Sie in der Spezifikation zu "OPC Historical Data Access 1.20".




Datenstruktur

BeschreibungAttribute Liefert zusätzliche Qualitätsmerkmale der Raw Data. Attribute sind u.a. Datentyp,

Angaben zur Archivierung. Weitere Informationen dazu finden Sie unter "Übersicht der unterstützten Attribute".

Aggregate Fassen die Raw Data eines bestimmten Zeitintervalls zusammen. Aggregate sind u.a. Mittelwert, Minimum, Maximum. Weitere Informationen dazu finden Sie unter "Übersicht der unterstützten Aggregate".

StartTime/EndTime

Legt den Start- und Endzeitpunkt für das Zeitintervall fest.

Bounding Values Bounding Values sind die Werte, die am Start- und Endzeitpunkt aufgezeichnet wurden. Wenn das nicht der Fall, werden die Werte, die dem Zeitpunkt am nächsten kommen, als Bounding Values verwendet.

Raw Data Raw Data sind die Daten aus dem WinCC Archivsystem für ein angegebenes Zeitintervall. Diese Daten besitzen einen Zeitstempel und eine Qualität.

Item Handle Das Item Handle ist die eindeutige Zuordnung zu einer WinCC Archivvariablen. ItemID Die ItemID ist die eindeutige Identifikation der WinCC Archivvariable. Über die

ItemID kann ein Item Handle geholt werden


Übersicht der unterstützten Funktionen (Seite 513)

Zeitformat des WinCC-OPC-HDA-Servers (Seite 514)

Übersicht der unterstützten Attribute (Seite 511)

Übersicht der unterstützten Aggregate (Seite 512)

4.8.2.2 Übersicht der unterstützten Attribute

EinleitungDie folgende Tabelle listet die vom WinCC-OPC-HDA-Server unterstützten Attribute auf. Weiterführende Informationen dazu finden Sie in der Spezifikation zu "OPC Historical Data Access 1.20".

Attribute

Attribut Attribut ID BeschreibungItemID OPCHDA_ITEMID Gibt an, auf welche WinCC Archivvariable zugegriffen

wird. Item Datatype OPCHDA_DATA_TYPE Gibt den Datentyp der WinCC Archivvariable an.




Attribut Attribut ID BeschreibungDescription OPCHDA_DESCRIPTIO

NGibt die Beschreibung zur WinCC Archivvariable aus. Die Beschreibung wird im WinCC TagLogging festgelegt.

Engineering Units

OPCHDA_ENG_UNITS Legt die Beschriftung der Einheit fest, die in der Anzeige dargestellt wird. Die Beschriftung wird im WinCC TagLogging festgelegt.



4.8.2.3 Übersicht der unterstützten Aggregate

EinleitungDie folgende Tabelle listet die vom WinCC-OPC-HDA-Server unterstützten Aggregate auf. Weiterführende Informationen dazu finden Sie in der Spezifikation zu "OPC Historical Data Access 1.20".

Aggregate

Aggregat BeschreibungOPCHDA_COUNT Ermittelt die Anzahl der Raw Data für das angegebene Zeitintervall.OPCHDA_START Ermittelt den Startwert der Raw Data am Startzeitpunkt.OPCHDA_END Ermittelt den Endwert der Raw Data am Endzeitpunkt.OPCHDA_AVERAGE Ermittelt den Mittelwert der Raw Data für das angegebene

Zeitintervall.OPCHDA_TIMEAVERAGE Ermittelt den zeitlich gewichteten Mittelwert der Raw Data für das

angegebene Zeitintervall.OPCHDA_TOTAL Ermittelt den totalisierten Wert für das angegebene Zeitintervall.OPCHDA_STDEV Ermittelt die Standardabweichung der Raw Data für das

angegebene Zeitintervall.OPCHDA_MINIMUMACTUALTIME

Ermittelt den kleinsten Wert und den Zeitstempel der Raw Data für das angegebene Zeitintervall.

OPCHDA_MINIMUM Ermittelt den kleinsten Wert der Raw Data für das angegebene Zeitintervall.

OPCHDA_MAXIMUMACTUALTIME

Ermittelt den größten Wert und den Zeitstempel der Raw Data für das angegebene Zeitintervall.

OPCHDA_MAXIMUM Ermittelt den größten Wert der Raw Data für das angegebene Zeitintervall.

OPCHDA_DELTA Ermittelt die Differenz zwischen dem ersten und dem letzten Wert der Raw Data für das angegebene Zeitintervall.

OPCHDA_REGSLOPE Ermittelt die Steigung der Regressionsgeraden der Raw Data für das angegebene Zeitintervall.




Aggregat BeschreibungOPCHDA_REGCONST Ermittelt den Wert der Regressionsgeraden der Raw Data am

Startzeitpunkt.OPCHDA_REGDEV Ermittelt die Standardabweichung der Regressionsgeraden der

Raw Data für das angegebene Zeitintervall.OPCHDA_VARIANCE Ermittelt die Varianz der Raw Data für das angegebene

Zeitintervall.OPCHDA_RANGE Ermittelt die Differenz zwischen OPCHDA_MAXIMUM und

OPCHDA_MINMUM der Raw Data für das angegebene Zeitintervall.

OPCHDA_DURATIONGOOD Ermittelt die Zeitdauer, in der die Qualität der Raw Data gut war. Die Zeitdauer wird in Sekunden angegeben.

OPCHDA_DURATIONBAD Ermittelt die Zeitdauer, in der die Qualität der Raw Data schlecht war. Die Zeitdauer wird in Sekunden angegeben.

OPCHDA_PERCENTGOOD Ermittelt den prozentualen Anteil, in der die Qualität der Raw Data gut war.

OPCHDA_PERCENTBAD Ermittelt den prozentualen Anteil, in der die Qualität der Raw Data schlecht war.

OPCHDA_WORSTQUALITY Ermittelt die schlechteste Qualität der Raw Data für das angegebene Zeitintervall.



Funktionsweise des WinCC-OPC-HDA-Servers (Seite 509)

4.8.2.4 Übersicht der unterstützten Funktionen

EinleitungDie folgenden Tabellen listen die vom WinCC-OPC-HDA-Server unterstützten Funktionen auf. Diese Funktionen können vom OPC-HDA-Client zum Datenaustausch verwendet werden. Weiterführende Informationen dazu finden Sie in der Spezifikation zu "OPC Historical Data Access 1.20".

Read

Funktion BeschreibungReadRaw Gibt die Raw Data, deren Qualität und deren Zeitstempel für das angegebene

Zeitintervall aus.ReadProcessed Gibt den berechneten Wert, die Qualität des Wertes und den Zeitstempel für das

angegebene Zeitintervall aus. Der berechnete Wert ist abhängig vom ausgewählten Aggregat.




Funktion BeschreibungReadAtTime Gibt die Raw Data, deren Qualität und deren Zeitstempel für einen bestimmten

Zeitpunkt aus. Wenn kein Wert vorhanden ist, wird dieser für diesen Zeitpunkt interpoliert.

ReadAttribute Gibt die Attribute des Items und den Zeitstempel für das angegebene Zeitintervall aus.



4.8.2.5 Zeitformat des WinCC-OPC-HDA-Servers

Einleitung.Das Zeitintervall wird durch den Start- und Endzeitpunkt am WinCC-OPC-HDA-Server festgelegt. Das angegebene Zeitintervall bestimmt den Betrachtungszeitraum für die historischen Daten. Bei der Angabe der Zeitpunkte müssen bestimmte Formate eingehalten werden.

Es gibt folgende Möglichkeiten zur Angabe eines Zeitpunktes:

● absolut nach UTC.

● relativ zur lokalen Zeit des Servers.

Absolute Angabe nach UTCDer WinCC-OPC-HDA-Server arbeitet standardmäßig mit der koordinierten Weltzeit UTC als Zeitbasis. Die Uhrzeit entspricht der Zeitzone von Greenwich (= mitteleuropäische Winterzeit minus eine Stunde).

ZeitformatYYYY/MM/DD hh:mm:ss.msmsms

ParameterYYYY = Jahr

MM = Monat

DD = Tag

hh = Stunde

mm = Minute

ss = Sekunde

ms = Millisekunde




Eingabebeispiel2002/06/10 09:27:30.000

Angabe des Zeitpunktes relativ zur lokalen ZeitBei dieser Angabe wird der Zeitpunkt relativ zur lokalen Zeit des Servers eingegeben. Die lokale Zeitzone stellen Sie in der Systemsteuerung Ihres Rechners unter "Datum/Uhrzeit" ein.

ZeitformatKeyword +/-Offset1 +/-Offset(n)

Der Offset ist die Abweichung zur lokalen Zeit des Servers.

KeywordNOW = aktuelle lokale Uhrzeit des Servers

SECOND = aktuelle Sekunde

MINUTE = aktuelle Minute

HOUR = aktuelle Stunde

DAY = aktueller Tag

WEEK = aktuelle Woche

MONTH = aktueller Monat

YEAR = aktuelles Jahr

Offset+/-S = Abweichung in Sekunden

+/-M = Abweichung in Minuten

+/-H = Abweichung in Stunden

+/-D = Abweichung in Tage

+/-W = Abweichung in Wochen

+/-MO = Abweichung in Monate

+/-Y = Abweichung in Sekunden

Beispiele:DAY - 1D = vorhergehender Tag

DAY-1D + 7H30 = vorhergehender Tag um 7 Uhr 30

MO-1D+5H = letzter Tag des vorhergehenden Monats um 5:00 Uhr.

NOW-1H15M = vor 1 Stunde und 15 Minuten

YEAR+3MO= Monat April diesen Jahres





4.8.3 Quality Codes

Einleitung Der Quality Code wird dazu benötigt, den Status und die Qualität der Raw Data zu prüfen. Die Quality Codes für OPC werden beschrieben in der Spezifikation "Data Access Custom Interface Standard Version 3.00" im Kapitel "6.8 OPC Quality flags".

Quality Codes des WinCC-OPC-HDA-Servers

Code OPC Beschreibung Quality0x00040000 OPCHDA_RAW gibt Informationen über die Qualität der

Werte-Übertragung von Raw Data.GOODBAD UNCERTAIN

0x00080000 OPCHDA_CALCULATED

gibt Informationen über die Qualität der Werte-Übertragung von berechneten Daten.

GOODBADUNCERTAIN

0x00100000 OPCHDA_NOBOUND Am Start- oder Endzeitpunkt wurden keine Bounding Values gefunden.

BAD

0x00200000 OPCHDA_NODATA Für das angegebene Zeitintervall wurden keine Raw Data gefunden.

BAD

0x00400000 OPCHDA_DATALOST Innerhalb des gewählten Zeitintervalls sind die Raw Data nicht vollständig archiviert.

BAD


4.8.4 Unterstützte Schreibzugriffe

EinleitungDie folgende Tabelle listet die vom WinCC-OPC-HDA-Server unterstützten Schreibzugriffe auf.





Tabellen-Element:

BeschreibungUmlaufarchiv Die zu archivierenden Prozesswerte werden in ein Umlaufarchiv gespeichert. Das Umlaufarchiv

besteht aus einer projektierbaren Anzahl von Datenpuffern. Für den Datenpuffer wird eine Größe und ein Zeitraum (z.B. ein Tag) festgelegt. Wenn alle Datenpuffer voll sind, werden die Prozessdaten des ersten Datenpuffers wieder überschrieben.

Umlaufarchiv nach Auslagerung

Damit Prozessdaten des Datenpuffers durch Überschreiben nicht verloren gehen, können sie ausgelagert werden. Wird von WinCC unterstützt.

Wird nicht von WinCC unterstützt.

Schreibzugriffe

Prozesswerte nachträglich einfügen.

Umlauf-archiv


Unterstütztvon WinCC

Beschreibung

JA Nein Wenn der Zeitraum im Umlaufarchiv enthalten ist, kann ein Prozesswert nachträglich eingefügt werden.

JA JA Der Datenpuffer des entsprechenden Zeitraums ist in ein Archivbackup ausgelagert. In einem Archivbackup können Prozesswerte nicht nachträglich eingefügt werden.

Nein Nein Das Umlaufarchiv ist nicht verfügbar. Der Prozesswert kann nicht gespeichert werden.

Nein JA Das Umlaufarchiv ist nicht verfügbar. Der Prozesswert kann nicht gespeichert werden.

Prozesswerte zur Laufzeit einfügen.

Umlauf-Archiv



Beschreibung

JA Nein Der Prozesswert wird in den akutell gültigen Datenpuffer des Umlaufsarchivs eingefügt.



Zukünftige Prozesswerte einfügen.

Umlauf-archiv



Beschreibung

JA Nein Beim schreibenden Zugriff dürfen keine Werte in die Zukunft eingefügt werden.

Nein Nein Beim schreibenden Zugriff dürfen keine Werte in die Zukunft eingefügt werden.

Prozesswerte löschen

Umlauf-archiv



Beschreibung

JA Nein Wenn der Zeitraum im Umlaufarchiv enthalten ist, kann ein Prozesswert gelöscht werden.

JA JA Der Datenpuffer des entsprechenden Zeitraums ist in ein Archivbackup ausgelagert. In einem Archivbackup können Prozesswerte gelöscht werden.


Nein Ja Das Umlaufarchiv ist nicht verfügbar. Der Prozesswert kann nicht gespeichert werden.

Prozesswerte bearbeiten

Umlauf-archiv



Beschreibung

JA Nein Wenn der Zeitraum im Umlaufarchiv enthalten ist, kann ein Prozesswert bearbeitet werden.

JA JA Der Datenpuffer des entsprechenden Zeitraums ist in ein Archivbackup ausgelagert. In einem Archivbackup können Prozesswerte nicht bearbeitet werden.


Nein Ja Das Umlaufarchiv ist nicht verfügbar. Der Prozesswert kann nicht gespeichert werden.



4.8.5 Beispiel einer OPC-HDA-Kopplung

4.8.5.1 Beispiel einer OPC-HDA-Kopplung

EinleitungIm folgenden Beispiel wird die Kopplung WinCC - OPC-HDA-Client projektiert. Durch den WinCC-OPC-HDA-Server werden die Daten des WinCC Archivsystems zur Verfügung gestellt. Der OPC-HDA-Client greift über Item Handles auf die Daten zu. Zur einfacheren Projektierung wird der OPC HDA Browser verwendet.

Es wird der OPC-HDA-Client der OPC Foundation eingesetzt. Alle OPC-HDA-Clients der Spezifikation OPC Historical Data Access 1.20 können auf den WinCC-OPC-HDA-Server zu greifen.

Voraussetzungen● Legen Sie im WinCC Projekt des WinCC-OPC-HDA-Servers eine interne Variable

"OPC_HDA" vom Datentyp "Vorzeichenloser 16-Bit Wert" an.

● Legen Sie im WinCC Archivsystem ein Prozesswertarchiv "HDA_Prozesswertarchiv" an.

● Legen Sie im Prozesswertarchiv "HDA_Prozesswertarchiv" eine WinCC Archivvariable "OPC_HDA_Tag" an. Verknüpfen Sie die WinCC Archivvariable mit der internen Variable "OPC_HDA".

● Aktivieren Sie in der Anlaufliste das Tag Logging Runtime und deaktivieren Sie Graphics Runtime.

● Aktivieren Sie das WinCC Projekt des WinCC-OPC-HDA-Servers.

ProjektierungsschritteFür die Kopplung WinCC - OPC-HDA-Client sind folgende Projektierungen notwendig:

1. Zugriff auf die WinCC Archivvariable mit dem HDA Server Browser projektieren

2. Lesen von Werten der WinCC Archivvariablen

Siehe auchSo projektieren Sie den Zugriff auf eine WinCC Archivvariable mit dem HDA Server Browser (Seite 521)

HDA Server Browser (Seite 520)

So können Sie Werte der WinCC Archivvariable lesen (Seite 522)



4.8.5.2 HDA Server Browser

EinleitungDer OPC-HDA-Client greift über Item Handles auf die Variablenwerte zu. Zur einfacheren Projektierung unterstützt der WinCC-OPC-HDA-Server die Browsingfunktionalität. Der OPC-HDA-Client kann mit dem HDA Server Browser den Adressraum des WinCC-OPC-HDA-Servers durchsuchen. Die Daten werden nach Prozesswertarchiven hierarchisch aufgelistet.

Hinweis

Beim Zugriff auf eine WinCC Archivvariable ohne den HDA Browser Server muss die ItemID manuell projektiert werden.

Bei der Adressierung der WinCC Archivvariablen wird in der Pfadangabe der symbolische Rechnername (Serverpräfix) mit angegeben. Die ItemID hat folgende Syntax: Serverpräfix::Prozesswertarchiv\WinCC Archivvariable.




So projektieren Sie den Zugriff auf eine WinCC Archivvariable mit dem HDA Server Browser (Seite 521)

4.8.5.3 So projektieren Sie den Zugriff auf eine WinCC Archivvariable mit dem HDA Server Browser

EinleitungIn diesem Abschnitt wird mit dem OPC-HDA-Client auf eine WinCC Archivvariable zugegriffen. Der OPC-HDA-Client der OPC Foundation wird eingesetzt. Der Zugriff wird mit dem HDA Server Browser projektiert

Hinweis

Bei dem OPC-HDA-Client handelt es sich um den Demo Client der OPC Foundation. Die Quellen dazu finden Sie im Internet unter http://www.opcfoundation.org .

Vorgehensweise1. Kopieren Sie die Datei " SampleClientHDA.exe " in ein beliebiges Verzeichnis. Diese

Anwendung ist nur in der Online-Hilfe verfügbar.

2. Klicken Sie die Datei "SampleClientHDA.exe " doppelt. Es öffnet sich das Programm "HDA Client".

3. Wählen Sie im Bereich "Servernamen" den Eintrag "OPCServerHDA.WinCC.1". Klicken Sie auf die Schaltfläche "Connect". Bestätigen Sie den folgenden Dialog.




4. Klicken Sie im "HDA Client" auf die Schaltfläche "Browse". Es öffnet sich der Dialog "Browse Dialog". Wählen Sie im Feld "OPCHDA_BROWSETYPE" den Eintrag "OPCHDA_FLAT".

5. Wählen Sie im Auswahlfenster den Eintrag "HDA_Prozessswertarchiv\OPC_HDA_TAG". Klicken Sie auf die Schaltfläche "Add" und schließen Sie den Dialog über die Schaltfläche "Done".

Weitere Informationen finden Sie im Internet unter Http://www.opcfoundation.org

Siehe auchSo können Sie Werte der WinCC Archivvariable lesen (Seite 522)


4.8.5.4 So können Sie Werte der WinCC Archivvariable lesen

EinleitungIn diesem Abschnitt wird gezeigt, wie Sie lesend auf die WinCC Archivvariable zugreifen können.




Voraussetzungen● Der OPC-HDA-Client muss gestartet sein.

Vorgehensweise1. Klicken Sie im "HDAClient" auf die Schaltfläche "Show Items".

2. Klicken Sie im "HDAClient" auf die Schaltfläche "Get Item Handles".

3. Klicken Sie im Auswahlfeld "Value" den Eintrag "HDA_Prozesswertarchiv\OPC_HDA_Tag" doppelt.

4. Geben Sie im Feld "Start Time" den Wert "NOW-10S" ein. Geben Sie im Feld "End Time" den Wert "NOW" ein.

5. Klicken Sie auf die Schaltfläche "Read Raw". Im Auswahlfeld "Values" werden die Werte, deren Quality Code und deren Zeitstempel ausgegeben.



4.8.6 Besonderheiten des OPC-HDA-Servers in WinCC bei azyklischer Archivierung

EinleitungIn WinCC werden TagLogging-Variablen zyklisch oder azyklisch archiviert. In Abhängigkeit der Archivierungsmethode der Variablen arbeitet der WinCC-HDA-OPC-Server unterschiedlich:

● Für alle zyklisch archivierten Werte arbeitet der OPC-HDA-Server konform zur HDA-Spezifikation der OPC-Foundation. Die OPC-Aggregate werden linear interpoliert.

● Azyklisch archivierte Variablen sind in der HDA-Spezifikation der OPC-Foundation nicht vorgesehen. Die OPC-Aggregate werden stufenweise interpoliert. Insbesondere wenn eine Variable eine lange Zeit keine Änderung erfahren hat, würden in einem Zeitbereich keine Daten verfügbar sein. Um dennoch gültige Daten zu erhalten, sind folgende Besonderheiten zu beachten.

Hinweis

Für azyklisch archivierte Variablen ist der OPC-HDA-Server nicht OPC-Compliant. Die HDA-Spezifikation der OPC-Foundation kennt keine azyklisch archivierten Variablen und deckt damit auch keine Archivserver für azyklisch archivierte Variablen ab. Die unterstützten Aggregate werden konform zur OPC-HDA-Spezifikation berechnet. Alle nicht explizit aufgeführten Funktionen werden nicht unterstützt.

Hinweis

Beim schreibenden Zugriff auf Prozesswertarchive dürfen keine Werte in die Zukunft eingefügt werden.

Konfiguration von azyklisch archivierten VariablenBei der Projektierung von azyklisch archivierten Variablen muss bei der Variablen die Einstellung "Archivieren nach Segmentwechsel" gesetzt sein. Damit wird bei jedem Wechsel eines Segments der letzte gültige Wert im neuen Archiv eingetragen.

Unterstützte Aggregate des WinCC-OPC-HDA-Servers für azyklisch archivierte VariablenDer OPC-HDA-Server unterstützt ausschließlich folgende Aggregate:

● OPCHDA_MINIMUM

● OPCHDA_MAXIMUM

● OPCHDA_AVERAGE

● OPCHDA_END

● OPCHDA_INTERPOLATIVE

● OPCHDA_TIMEAVERAGE

● OPCHDA_TOTAL



● OPCHDA_DURATIONGOOD

● OPCHDA_PERCENTGOOD

Unterstützte Funktionen des WinCC-OPC-HDA-Servers für azyklisch archivierte Variablen● ReadRaw nur mit "Boundings". ReadRaw auf eine Variable muss immer mit "Boundings"

ausgeführt werden, um bei einem Bereich ohne archivierte Wertänderung den letzten real gespeicherten Wert zu finden.

● ReadProcessed

● DeleteRaw

● DeleteAtTime

● Insert

● InsertReplace

● Replace

Berechnung der Aggregate für azyklisch archivierte VariablenDie Berechnung der Aggregate basiert auf einem erweiterten Datensatz von "RawData", der nicht nur real gespeicherte Werte enthält, sondern für die Berechnung auch virtuelle Datenpunkte enthält. Entsprechend den Anforderungen des "ReadProcessed", bereitet der WinCC-OPC-HDA-Server die erhaltenen "RawData" auf. Die für die Berechnung erforderlichen virtuellen Datenpunkte werden aus den angrenzenden realen Datenpunkten gebildet. Folgende signifikante Punkte werden für virtuelle Datenpunkte berücksichtigt:

● Wert zur "StartTime"

● Wert zur "EndTime"

● Wert auf Intervallgrenzen

BeispielBei einer azyklischen TagLogging-Variablen sind die Werte für "00:59:00", "01:02:00" und "01:03:00" gespeichert. Ein OPC-HDA-Client fordert mit "ReadProcessed" ein Aggregat mit folgenden Parametern an:

● StartTime = 01:00:00

● EndTime = 01:04:00

● Intervall = 00:02:00

Hinweis

Bei der Generierung von virtuellen Werten an Grenzen ("EndTime"/"Intervall") ist bei der Berechnung der Zeitbereich immer 1 µs kleiner als der Zeitstempel an der Grenze.

Zur besseren Übersicht wird in der folgendenTabelle mit einem Delta von 1 Sekunde gearbeitet. Die nachfolgende Grafik veranschaulicht das Beispiel.

Für die Berechnung des Aggregats verwendet der OPC-Server folgende "RawData":



Nummer Zeitstempel Real gespeicherte Werte Generierte virtuelle Werte1 00:59:00 1,00 2 01:00:00 1,003 01:01:59 1,004 01:02:00 2,00 5 01:02:59 2,006 01:03:00 3,00 7 01:03:59 3,00



4.9 WinCC-OPC-A&E-Server

4.9.1 Funktionsweise des WinCC-OPC-A&E-Servers

Einleitung Der WinCC-OPC-A&E-Server ist eine DCOM-Anwendung. Über Subscriptions wird der OPC-A&E-Client über Statusänderungen von WinCC Meldungen benachrichtigt. Mit der Subscription kann der OPC-A&E-Client einen Filter einstellen. Über diesen Filter wird festgelegt, welche Meldungen und Attribute angezeigt werden.

Der WinCC-OPC-A&E-Server unterstützt die Spezifikation OPC Alarm&Event 1.10. Dies wurde durch den Compliance Test bestätigt.

Die folgenden Kapitel zeigen die Abbildung des WinCC Meldesystems auf OPC A&E, sowie die vom WinCC-OPC-A&E-Server unterstützten Attribute. Hier erfolgt keine ausführliche Beschreibung, sondern eine Übersicht der spezifischen Informationen. Weiterführende Informationen dazu finden Sie in der Spezifikation zu "OPC Alarm&Event 1.10".

InstallationDer WinCC-OPC-A&E-Server kann bei der Installation von WinCC ausgewählt werden. Nach der Installation ist der WinCC-OPC-A&E-Serverr ohne eine Projektierung sofort einsetzbar.

Ab WinCC V6.2 kann der WinCC-OPC-A&E-Server auf einem WinCC-Server und einem WinCC-Client eingesetzt werden.

LizenzierungFür den Betrieb WinCC-OPC-A&E-Server müssen auf jedem WinCC-Server, der als OPC-A&E-Server eingesetzt wird, folgende Lizenzen installiert sein:



ServerartenDer WinCC-OPC-A&E-Server unterstützt Conditional Events und Simple Events. Weiterhin gibt es noch Tracking Events.

Condition Related Event ServerBei einem Condition Related Event Server ist das Ereignis an eine Bedingung geknüpft. Eine Bedingung kann z.B. die Grenzwertverletzung einer Variablen sein. Bei WinCC erfolgt eine Meldung, sobald eine Grenzwertverletzung auftritt. Diese Meldung wird bei OPC A&E als Alarm abgebildet.

OPC - Open Connectivity4.9 WinCC-OPC-A&E-Server


Simple Event ServerSimple Events sind Meldungen, die den OPC-A&E-Client über Ereignisse informiert. Simple Events sind z.B. das Starten oder Beenden von Programmen.

Hinweis

Beachten Sie beim Einsatz von redundanten Systemen:

Simple Events, die auf interne Variablen verschaltet sind, werden beim Variablenabgleich doppelt gesendet.

Die erste Meldung wird vom Master ausgelöst, die zweite vom Standby.

Tracking Event ServerWenn im Prozess eine Veränderung auftritt, bekommt der OPC-A&E-Client eine Meldung. Eine Veränderung kann z.B. das Verschieben eines Reglers sein.

OPC-A&E-ClientAlle OPC-A&E-Clients der Spezifikation OPC Alarm&Event 1.10 können auf den WinCC-OPC-A&E-Server zugreifen. Der OPC-A&E-Client kann u.a. eigen erstellt sein. Durch Verwendung von eigen entwickelten OPC-Clients können die Anforderungen bestmöglich erfüllt werden. Ein OPC-A&E-Client kann z.B.zur Analyse und gemeinsamen Archivierung von Alarmen aus unterschiedlichen OPC-A&E-Servers eingesetzt werden.


Quality Codes für OPC A&E (Seite 534)

Abbildung des WinCC Meldesystems auf OPC A&E (Seite 528)


4.9.2 Abbildung des WinCC Meldesystems auf OPC A&E

4.9.2.1 Abbildung des WinCC Meldesystems auf OPC A&E

EinleitungBei der Projektierung des WinCC Meldesystems legen Sie fest, welches Ereignis im Prozess eine Meldung auslöst. Diese Meldung wird bei OPC A&E als Alarm abgebildet. In der folgenden Tabelle werden die wichtigsten Parameter des Alarms aufgelistet. Es wird auch beschrieben, wie das WinCC Meldesystem die Informationen bereitstellt. Weitere Informationen dazu finden Sie unter "Aufbau des Alarms".




Übersicht

OPC WinCC Meldesystem Source Gibt die Quelle an, wo die Meldung ausgelöst wurde. Die Source hat die

Formatierung "<Serverpräfix>::@LOCALMACHINE::".Time Gibt den Zeitstempel für gekommene, gegangene und quittierte Meldung aus.

Der Zeitstempels wird in UTC (Koordinierte Weltzeit ) angegeben.Type Gibt an, ob es sich um ein Simple, Tracking oder Condition Related Event

handelt. WinCC-OPC A&E Server unterstützt Simple, Condition Related und Tracking Events.

Severity Gibt die Priorität der Meldung von WinCC aus.EventCategory Gibt die Kategorie der Meldungen aus. Weitere Informationen dazu finden Sie

unter "Abbildung der Meldeklassen und Meldearten".Message Gibt den Meldetext der entsprechenden Meldungsnummer aus.ConditionName Gibt die Meldungsnummer aus.ChangeMask Gibt den geänderten Status der Meldung aus. Weitere Informationen dazu finden

Sie unter "Quittierphilosophie".NewState Gibt den Status der Meldung aus. Weitere Informationen dazu finden Sie unter

"Quittierphilosophie".ConditionQuality Gibt die Qualität der Meldung aus. Weitere Informationen dazu finden Sie unter

"Quality Codes".AckRequired Gibt an, ob die Meldung quittierpflichtig ist.ActiveTime Gibt den Zeitstempel für gekommene Meldungen aus.EventAttribute Listet die Attribute auf, die für diese Meldung angefordert wurden. Weitere

Informationen dazu finden Sie unter "Attribute des WinCC Meldesystems".Quality Gibt den Quality Code der Meldung wieder.Cookie Gibt das Cookie aus, das vom OPC A&E Server angeboten wird. Der Cookie

entspricht der Meldenummer im WinCC Alarmsystem

Siehe auchQuittierphilosophie (Seite 532)

Attribute des WinCC Meldesystems (Seite 530)

Abbildung der Meldeklassen und Meldearten von WinCC (Seite 529)

4.9.2.2 Abbildung der Meldeklassen und Meldearten von WinCC

Einleitung Das WinCC Meldesystem informiert über Störzustände und Betriebszustände im Prozess. Eine WinCC-Meldung gehört stets zu einer bestimmten Meldeklasse und Meldeart, die mit der Event Category in Beziehung stehen.

Die Abbildung des WinCC Meldesystems auf OPC wird über die Datei "CcAeProvider.ini" konfiguriert.



Event CategoryJede Kombination aus Meldeklasse und Meldeart wird eine Event Category im WinCC-OPC-A&E-Server abgebildet.

Eine Event Category wird bestimmt durch eine CategoryID und eine beschreibende "Category Description". Die CategoryID setzt sich aus der WinCC internen ID von Meldeklasse und Meldeart zusammen, die Category Description aus den Namen von Meldeklasse und Meldeart.

Hinweis

Wenn der OPC A&E-Server auf einem WinCC-Client einer Connectivity Station betrieben wird, müssen die daran verbundenen OS-Server eine identische Konfiguration von Meldeklassen und Meldearten aufweisen. Wenn das nicht gegeben ist, muss der eingesetzte OPC-Client direkt auf den OS-Server zugreifen.

Die Namen der Meldeklassen und Meldearten können über die Alarm Attribute "CLASSNAME" und "TYPENAME" explizit ermittelt werden.

4.9.2.3 Abbildung der Priorität von WinCC-Meldungen

EinleitungDie Priorität von WinCC-Meldungen wird durch den OPC-Server auf das Attribut "Severity" abgebildet.

Bei der Konfiguration von Alarmen im WinCC-Meldesystem können Sie eine Priorität von 0 bis 16 projektieren. Die OPC A&E Spezifikation definiert für die Severity einen Wertbereich von 1 bis 1000. Dabei steht 1 für die niedrigste und 1000 für die höchste Severity.

Deshalb werden die Werte der WinCC-Priorität geeignet auf die OPC-Severity abgebildet. In der Standard-Abbildung wird die WinCC-Priorität 0 zu OPC Severity 1. Alle anderen Prioritätswerte werden linear bis Severity 1000 interpoliert. Andere Abbildungsregeln der Priorität können Sie in der Datei CcAeProvider.ini konfigurieren.

4.9.2.4 Attribute des WinCC Meldesystems

EinleitungDie folgende Tabelle listet die OPC-Attribute des WinCC Meldesystems auf. Die Attribute werden im WinCC Meldesystem projektiert. Einige Attribute sind nur für den internen Gebrauch in WinCC vorgesehen und daher für einen OPC-A&E-Client nicht relevant. Diese Attribute sind nicht gelistet.



Attribute

OPC Attribute WinCC Meldesystem DatentypCLASSNAME Gibt den Namen Meldeklasse aus. VT_BSTRTYPENAME Gibt den Namen der Meldeart aus. VT_BSTRFORECOLOR Gibt die Textfarbe für gekommene, gegangene oder

quittierte Meldungen aus.VT_I4

BACKCOLOR Gibt die Hintergrundfarbe für gekommene, gegangene oder quittierte Meldungen aus.

VT_I4

FLASHCOLOR Gibt die Blinkfarbe aus. VT_I4FLAGS Gibt an ob, die Meldung quittierpflichtig ist. VT_I4TEXT01 Gibt den Inhalt des Anwendertextblocks01 aus. VT_BSTRTEXT02 Gibt den Inhalt des Anwendertextblocks02 aus. VT_BSTRTEXT03 Gibt den Inhalt des Anwendertextblocks03 aus. VT_BSTRTEXT04 Gibt den Inhalt des Anwendertextblocks04 aus. VT_BSTRTEXT05 Gibt den Inhalt des Anwendertextblocks05 aus. VT_BSTRTEXT06 Gibt den Inhalt des Anwendertextblocks06 aus. VT_BSTRTEXT07 Gibt den Inhalt des Anwendertextblocks07 aus. VT_BSTRTEXT08 Gibt den Inhalt des Anwendertextblocks08 aus. VT_BSTRTEXT09 Gibt den Inhalt des Anwendertextblocks09 aus. VT_BSTRTEXT10 Gibt den Inhalt des Anwendertextblocks10 aus. VT_BSTRPROCESSVALUE01

Gibt den Inhalt des Prozesswertblocks01 aus. VT_VARIANT

PROCESSVALUE02


PROCESSVALUE03


PROCESSVALUE04


PROCESSVALUE05


PROCESSVALUE06


PROCESSVALUE07


PROCESSVALUE08


PROCESSVALUE09


PROCESSVALUE10


STATETEXT Gibt die Statusmeldung aus. VT_BSTRINFOTEXT Gibt den Informationstext zur Meldung aus. VT_BSTRLOOPINALARM Gibt an, ob LoopInAlarm projektiert ist. VT_I4CLASSID Gibt die ID der Meldeklasse aus. VT_I4TYPEID Gibt die ID der Meldeart aus. VT_I4



OPC Attribute WinCC Meldesystem DatentypMODIFYSTATE Gibt den Wert der Zustandvariable der Meldung aus. VT_I4AGNR Gibt die Nummer des AS aus, auf der die Meldung

entstanden ist.VT_I2

CPUNR Gibt die Nummer der CPU aus, auf der die Meldung entstanden ist.

VT_I2

DURATION Gibt den Zeitraum zwischen kommend, gehend und Quittierung einer Meldung aus.

VT_I4

COUNTER Gibt die Anzahl der Meldungen nach dem Start von Runtime aus.

VT_I4

QUITSTATETEXT

Gibt an, ob die Meldung quittiert worden ist. VT_BSTR

QUITCOUNT Gibt die Anzahl der offenen, nichtquittierten Meldungen aus. VT_I4PARAMETER Gibt den Parameter der Meldung aus. (Abbild der

Meldungskonfiguration).VT_BSTR

BLOCKINFO Gibt den aktuellen Inhalt des Meldeblocks aus. VT_BSTRALARMCOUNT Gibt die Anzahl der anstehenden Meldungen aus. VT_I4LOCKCOUNT Gibt die Anzahl der gesperrten Meldungen aus. VT_I4PRIORITY Gibt die projektierte Priorität der Meldung an. VT_I4APPLICATION Gibt die Applikation aus, die die Meldung auslöste. VT_BSTRCOMPUTER Gibt den Rechnername aus, der die Meldung bearbeitete. VT_BSTRUSER Gibt den Benutzer aus, der die Meldung bearbeitete. VT_BSTRCOMMENT Gibt den Kommentar der Meldung aus. VT_BSTR

4.9.2.5 Quittierphilosophie

EinleitungIn WinCC ist die Quittierphilosophie die Art und Weise, wie eine Meldung vom "Kommen" bis zum "Gehen" dargestellt und bearbeitet wird. Beim WinCC-OPC-A&E-Server wird dieser Meldungsstatus in den Parametern ChangeMask und NewState verwaltet

Conditional, Simple und Tracking EventsIn der Regel werden Meldungen vom WinCC System als Conditional Events an den Client gesendet. Damit eine Meldung als Simple Event behandelt wird, müssen in der Projektierung der Meldeklasse folgende Voraussetzungen erfüllt sein:

● "Quittierung gekommen" ist nicht aktiviert.

● "Meldung ohne Zustand gegangen" ist aktiviert.

Abhängig von der Konfiguration der Abbildung werden Meldungen mit der Meldeklasse "System, ohne Quittierung" und mit der Meldeart "Bedienmeldung" als OPC Tracking Events übertragen.



ChangeMaskDer Parameter "ChangeMask" hält fest, wo der Meldezustand sich geändert hat.

Parameterwerte:● OPC_CHANGE_ACTIVE_STATE

● OPC_CHANGE_ENABLE_STATE

● OPC_CHANGE_ACK_STATE

NewStateDer Parameter "NewState" zeigt den Meldungszustand nach Änderung an.

Parameterwerte:● OPC_CONDITION_ACTIVE

● OPC_CONDITION_ENABLED

● OPC_CONDITION_ACKED

Übersicht

WinCC NewState ChangeStateGekommene Meldung OPC_CONDITION_ACTIVE

OPC_CONDITION_ENABLEDOPC_CHANGE_ACTIVE_STATE

Gegangene Meldung mit Quittierung

OPC_CONDITION_ACKEDOPC_CONDITION_ENABLED

OPC_CHANGE_ACTIVE_STATE

Gegangene Meldung ohne Quittierung

OPC_CONDITION_ENABLED OPC_CHANGE_ACTIVE_STATE

Quittierte Meldungen (Meldung steht noch an)

OPC_CONDITION_ACTIVEOPC_CONDITION_ACKEDOPC_CONDITION_ENABLED

OPC_CHANGE_ACK_STATE

Quittierte Meldungen (Meldung steht nicht mehr an)



Gesperrte Meldung -------------------------------------- OPC_CHANGE_ENABLED_STATE

Freigegebene Meldung OPC_CONDITION_ENABLED OPC_CHANGE_ENABLED_STATE

Gekommene, quittierte Meldung OPC_CONDITION_ACTIVEOPC_CONDITION_ACKEDOPC_CONDITION_ENABLED


Gekommene, gegangene Meldung mit Quittierung



Gekommene, gegangene Meldung ohne Quittierung

OPC_CONDITION_ENABLED OPC_CHANGE_ACK_STATE

Vom System quittierte Meldung (Meldung steht noch an)





WinCC NewState ChangeStateVom System quittierte Meldung (Meldung steht nicht mehr an)



Notquittierte Meldung (Meldung steht noch an)



Notquittierte Meldung (Meldung steht nicht mehr an)




4.9.3 Quality Codes für OPC A&E

Einleitung Der Quality Code wird dazu benötigt, den Status und die Qualität einer Meldung zu prüfen. Die Quality Codes für OPC werden beschrieben in der Spezifikation "Data Access Custom Interface Standard Version 3.00" im Kapitel "6.8 OPC Quality flags".

Quality Codes

Code Quality Status0xC0 OPC_GOOD OK0x40 OPC_UNCERTAIN wird bei Unstimmigkeiten ausgegeben z.B.

bei verspäteter Quittierung0x00 OPC_BAD wird ausgegeben, wenn die Verbindung zur

Source unterbrochen ist.

4.9.4 Beispiel einer OPC-A&E-Kopplung

4.9.4.1 Beispiel einer OPC-A&E-Kopplung

Einleitung Im folgenden Beispiel wird die Kopplung WinCC - OPC A&E-Client projektiert. Durch den WinCC-OPC A&E-Server werden die Daten des WinCC Meldesystem zur Verfügung gestellt.

Über eine Subscription wird der OPC-A&E-Client über Statusänderungen von WinCC Meldungen benachrichtigt.




Alle OPC-A&E-Clients der Spezifikation OPC Alarm&Events 1.10 können auf den WinCC-OPC-A&E-Server zugreifen.

ProjektierungsschrittFür die Kopplung WinCC - OPC-A&E-Client ist folgende Projektierung notwendig:

1. Zugriff auf das WinCC Meldesystem projektieren

Siehe auchSo projektieren Sie den Zugriff auf das WinCC Meldesystem (Seite 535)


4.9.4.2 So projektieren Sie den Zugriff auf das WinCC Meldesystem

EinleitungIn diesem Abschnitt wird mit dem OPC-A&E-Client der OPC Foundation auf das WinCC Meldesystem zugegriffen.

Hinweis

Bei dem OPC-A&E-Client handelt es sich um den Demo Client der OPC Foundation. Die Quellen dazu finden Sie im Internet unter http://www.opcfoundation.org.

Voraussetzungen● Legen Sie im WinCC Projekt des WinCC-OPC-A&E-Servers mehrere interne Variablen

vom Datentyp "Binär" an.

● Projektieren Sie im WinCC Projekt des WinCC-OPC-A&E-Servers das WinCC Meldesystem. Verbinden Sie die Meldungen mit den internen Variablen.

● Projektieren Sie mit dem Graphics Designer ein Bild. Fügen Sie in das Bild das WinCC Alarm Control und ein E/A-Feld ein. Verschalten Sie die Grafikobjekte mit den Meldevariablen.

● Aktivieren Sie in der Anlaufliste das "Alarm Logging Runtime".

● Aktivieren Sie das WinCC Projekt des WinCC-OPC-A&E-Servers.




Vorgehensweise1. . Kopieren Sie die Datei "SampleClientAE.exe" in ein beliebiges Verzeichnis. Diese

Anwendung ist nur in der Online-Hilfe verfügbar.

2. Wählen Sie in der Menüleiste den Eintrag "OPC" >"Connect.". Wählen Sie im Dialog "OPC Alarm Server" den Eintrag "OPC.WinCC-AlarmsEvent". Schließen Sie den Dialog über die Schaltfläche "OK".

3. Wählen Sie in der Menüleiste den Eintrag "OPC" >"Event Subscription.". Es öffnet sich der Dialog "Event Subscription".

4. Aktivieren Sie im Dialog das Kontrollkästchen "Active". Tragen Sie in den Feldern "Buffer Time" und "Max Size" "1000" ein. Schließen Sie den Dialog "Event Subscription" über die Schaltfläche "OK".

5. Im "OPC Event Sample Client" werden die Meldungen des WinCC Meldesystems ausgegeben.

6. Wählen Sie in der Menüleiste den Eintrag "OPC" >"Filter ". Es öffnet sich der Dialog "Filter ". Wählen Sie im Auswahlfeld "EventCategory" eine Category. Schließen Sie den Dialog "Filter" über die Schaltfläche "OK".

7. Im "OPC Event Sample Client" werden die Meldungen angezeigt, die dem Filterkriterium entsprechen.

Die Parameter "Buffer Time" und "Max Size"Der OPC Spezifikation folgend, werden die Parameter "Buffer Time" und "Max Size" in WinCC wie folgt abgebildet:

OPC-Client fordert Rückgabewert WinCC verwendetBuffer Time < 100OPC_S_INVALIDBUFFERTIME

Revised Buffer Time = 100

100 <= Buffer Time <= 600000S_OK

Revised Buffer Time = Buffer Time



OPC-Client fordert Rückgabewert WinCC verwendetBuffer Time > 600000OPC_S_INVALIDBUFFERTIME

Revised Buffer Time = 600000

Max Size = 0OPC_S_INVALIDMAXSIZE

Revised Max Size = 1000

0 < Max Size < 10OPC_S_INVALIDMAXSIZE


10 <= Max Size <= 1000S_OK

Revised Max Size = Max Size

Max Size > 1000OPC_S_INVALIDMAXSIZE


Beim Anlegen einer Subscription können Sie die Parameter festlegen. Sie können jedoch nicht nachträglich eine bestehende Subscription mit SetState() ändern.

Weitere Informationen finden Sie im Internet unter Http://www.opcfoundation.org


4.9.5 OPC-A&E-Server mit hierarchischem Zugriff

4.9.5.1 Funktionsweise des OPC-A&E-Servers

Einleitung Der OPC-A&E-Server nutzt DCOM-Dienste für die Übertragung von Meldungen zwischen OPC-fähigen Anwendungen. Der OPC-A&E-Server unterstützt die Spezifikation OPC Alarm&Event 1.10.

Die folgenden Kapitel zeigen die Abbildung des WinCC Meldesystems auf OPC A&E mit hierarchischem Zugriff und die vom OPC-A&E-Server unterstützten Attribute. Diese Dokumentation enthält eine Übersicht der spezifischen Informationen. Weiterführende Informationen finden Sie in der Spezifikation zu "OPC Alarm&Event 1.10".

FunktionsweiseDer OPC-A&E-Client erhält über Subskriptionen WinCC Meldungen. Sie können die Filter der Subskription verwenden, um die Anzahl der Ereignisse zu reduzieren, die mit einer Subskription übertragen werden. Der OPC-A&E-Client kann für jede Event-Kategorie einstellen, welche Meldeattribute angezeigt werden.

InstallationDer WinCC-OPC-A&E-Server kann bei der Installation von WinCC ausgewählt werden. Nach der Installation ist der WinCC-OPC-A&E-Serverr ohne eine Projektierung sofort einsetzbar.




Ab WinCC V6.2 kann der WinCC-OPC-A&E-Server auf einem WinCC-Server und einem WinCC-Client eingesetzt werden.

LizenzierungFür den Betrieb eines OPC-A&E-Server müssen auf jedem Rechner, auf dem der OPC-A&E-Server ausgeführt wird, eine der folgenden Lizenzen installiert sein:



Event-TypenDer OPC-A&E-Server mit hierarchischem Zugriff unterstützt Conditional Events, Simple Events und Tracking Events.

Condition Related Events Bei einem Condition Related Event ist das Ereignis an eine Bedingung geknüpft. Eine Bedingung kann z.B. die Grenzwertverletzung einer Variablen sein. Diese Grenzwertverletzung generiert eine Meldung, die bei OPC A&E als Alarm abgebildet wird.

Simple Events Simple Events sind Meldungen, die den OPC-A&E-Client über Ereignisse informieren. Simple Events sind z.B. das Starten oder Beenden von Programmen.

Hinweis

Beachten Sie beim Einsatz von redundanten Systemen:

Simple Events, die auf interne Variablen verschaltet sind, werden beim Variablenabgleich doppelt gesendet.

Die erste Meldung wird vom Master ausgelöst, die zweite vom Standby.

Tracking EventsEin Tracking Event wird bei einer Bedienmeldung an den OPC-A&E-Client geschickt. Eine Bedienmeldung wird durch das manuelle Eingreifen in den Prozess ausgelöst.

OPC-A&E-ClientAlle OPC-A&E-Clients der Spezifikation OPC Alarm&Event 1.10 können auf den OPC-A&E-Server zugreifen. Der OPC-A&E-Client kann u.a. eigen erstellt sein. Durch Verwendung von eigen entwickelten OPC-Clients können die Anforderungen bestmöglich erfüllt werden. Ein OPC-A&E-Client kann z. B. zur Analyse und gemeinsamen Archivierung von Alarmen aus unterschiedlichen OPC-A&E-Servern eingesetzt werden. Die Quittierung von archivierten



Meldungen ist nicht möglich, sondern nur die Quittierung von aktuellen Alarmen und Ereignissen.

HinweisDokumentation zu OPC

Weitere Informationen zu OPC finden Sie im Kapitel "Schnittstellen > OPC - OLE for Process Control".

4.9.5.2 OPC-A&E-Server ab WinCC V6.2 SP2

Unterschiede zwischen OPC A&E und OPC A&E mit hierarchischem Zugriff

Darstellung der Meldungen mit OPC A&EDer OPC-A&E-Server unterstützt beim Zugriff auf das Meldesystem "Conditional Events" und "Simple Events". Bei "Conditional Events" werden für jede Quelle die Meldungsnummern angezeigt. Da ein WinCC-Server sehr viele Meldungsnummern enthalten kann, geht schnell der Überblick über die Meldungen verloren.

Die folgende Abbildung zeigt ein Beispiel für die Darstellung in einem OPC-Browser:

Darstellung der Meldungen mit OPC A&E und hierarchischem ZugriffDer OPC-A&E-Server mit hierarchischem Zugriff unterstützt die Event-Typen "Conditional Events", "Simple Events" und "Tracking Events".

Bei "Conditional Events" bestimmt der Anwendertextblock 2 die Quelle der Meldungen. Als Standardeinstellung entspricht Anwendertextblock 2 dem Störort. Um Meldungen hierarchisch abzubilden, müssen Sie im Alarm Logging Meldungen in anwenderdefinierten Gruppenmeldungen zusammenstellen. Die Struktur der Gruppenmeldungen bestimmen die Areas in OPC A&E.



Tracking Events entstehen, wenn in der Anlage Bedienmeldungen ausgelöst werden.

Die folgende Abbildung zeigt ein Beispiel für die Darstellung von Conditional Events in einem OPC-Browser. Neben "Area" und "Source" werden die "Condition" angezeigt:

EmpfehlungSetzen Sie beim Anlegen neuer Projekte den OPC-A&E-Server mit hierarchischem Zugriff ein.

Wenn Sie ein bestehendes Projekt ab WinCC V6.2 SP2 hochrüsten, können Sie den OPC-A&E-Server wie bisher verwenden oder den OPC-A&E-Server auf hierarchischem Zugriff umstellen. Die Umstellung können Sie ohne Datenverlust wieder rückgängig machen. Weitere Informationen finden Sie unter "So rüsten Sie OPC A&E ab WinCC V6.2 SP2 hoch".

So rüsten Sie OPC A&E ab WinCC V6.2 SP2 hoch

EinleitungAb WinCC V6.2 SP2 wurde OPC A&E um den hierarchischen Zugriff auf das Meldesystem erweitert. Der Standard ist weiterhin der OPC-A&E-Server mit nicht hierarchischem Zugriff.

Hochrüstung von OPC A&EWenn Sie OPC A&E mit hierarchischem Zugriff verwenden und alle Funktionen nutzen wollen, ist gegebenenfalls eine Anpassung des aktuell verwendeten OPC-A&E-Clients erforderlich.

Ausgehend von der WinCC-Version Ihres Projekts werden die möglichen Hochrüstungsszenarien von OPC A&E beschrieben:

● Hochrüsten des Projekts von WinCC V6.2 auf WinCC V6.2 SP2

● Das Projekt wird mit WinCC V6.2 SP2 oder höher angelegt.



Hochrüsten von WinCC V6.2 auf WinCC V6.2 SP2Sie können ein Projekt mit WinCC V6.2 bezüglich OPC A&E wie folgt auf WinCC V6.2 SP2 hochrüsten:

Bisherigen OPC A&E ohne hierarchischem Zugriff beibehaltenWenn Sie mit dem bisher verwendeten OPC-A&E-Server weiter arbeiten wollen, sind folgende Szenarien möglich:

● Wenn Sie die Standard-Datei"CcAeProvider.ini" nicht geändert haben, müssen Sie keine weitere Einstellungen vornehmen.

● Wenn Sie die Standard-Datei"CcAeProvider.ini" geändert haben und diese behalten wollen, gehen Sie wie folgt vor:

– Sichern Sie die Datei "CcAeProvider.ini" aus dem WinCC-Installationspfad im Ordner "OPC\AlarmEvent\bin".Wenn Sie mit einem verteilten System oder in STEP 7 integriert arbeiten, dann sichern Sie die Datei aus dem Projekt auf dem WinCC-Client bzw. auf der OS.

– Kopieren Sie nach dem Hochrüsten diese Datei in das WinCC-Projektverzeichnis.Wenn Sie mit einem verteilten System oder in STEP 7 integriert arbeiten, dann kopieren Sie die Datei auf dem WinCC-Server bzw. auf der ES in das Projektverzeichnis der Client-Projekte bzw. der OS-Projekte.

● Wenn Sie die Datei "CcAeProvider.ini" geändert haben und durch die vom Produkt gelieferte Standarddatei "CcAeProvider.ini" ersetzen wollen, löschen Sie vor dem Hochrüsten diese Dateien auf den Servern und Clients bzw. ES-Rechnern und OS-Rechnern. Auf einer ES befindet sich der Projektordner im Unterordner "wincproj".

Umstieg auf OPC A&E mit hierarchischem ZugriffWenn Sie mit dem OPC-A&E-Server mit hierarchischen Zugriff arbeiten wollen, gehen Sie wie folgt vor:

1. Kopieren Sie nach dem Hochrüsten die Datei "CcAeProvider.ini" in die Projektordner. Die Datei finden Sie im WinCC-Installationspfad im Ordner "OPC\AlarmEvent\Hierarchical-Access".

2. Aktualisieren Sie die Clients bzw. führen Sie bei OS-Servern ein Gesamtladen durch.

Anlegen eines Projekts mit WinCC V6.2 SP2 oder höherProjekte, die ab WinCC V6.2 SP2 neu angelegt werden, setzen weiterhin den OPC-A&E-Server ohne hierarchischem Zugriff ein. Sie müssen keine weitere Einstellungen vornehmen.

Wenn Sie mit dem OPC-A&E-Server mit hierarchischen Zugriff arbeiten wollen, gehen Sie wie folgt vor:

1. Kopieren Sie nach dem Hochrüsten die Datei "CcAeProvider.ini" in die Projektordner der ES-Projekte. Die Datei finden Sie im Ordner "OPC\AlarmEvent\Hierarchical-Access" unterhalb des Installationspfads von WinCC.

2. Aktualisieren Sie die Clients bzw. führen Sie bei OS-Servern ein Gesamtladen durch.



4.9.5.3 Abbildung des WinCC Meldesystems auf OPC A&E

Abbildung des WinCC Meldesystems

EinleitungDas sich aus der Projektierung resultierende WinCC-Meldesystem legt fest, welches Ereignis im Prozess eine Meldung auslöst. Diese Meldung wird bei OPC-A&E als Event Notification abgebildet.

Abbildung des WinCC-Meldesystems auf OPC-A&E mit hierarischem ZugriffAls Standardeinstellung für die Abbildung des WinCC-Meldesystems wird in WinCC die OPC-Source des WinCC Anwendertextblocks "2" und die OPC-Message des WinCC Anwendertextblocks "1" verwendet.

ÜbersichtDie folgende Tabelle zeigt die wichtigsten Attribute der Event Notifications und die zugeordneten Informationen aus dem WinCC-Meldesystem.

Welche Events die aufgeführten Attribute verwenden, zeigt die dritte Spalte der Tabelle:

● "S" entspricht dem Simple Event

● "C" entspricht dem Conditional Event

● "T" entspricht dem Tracking Event

OPC WinCC Meldesystem Event-TypArea Die Struktur der Gruppenmeldungen bestimmen die Areas in OPC A&E. Wenn keine

Gruppenmeldung für die Meldung projektiert ist, ist nur die OPC Area entsprechend dem Serverpräfix vorhanden.

S, C, T

Source Gibt die Quelle einer Meldung an. Die Source hat die Formatierung "<Serverpräfix>::Area\Anwendertextblock 2". Das Serverpräfix eines lokalen Rechners ist "@LOCALMACHINE". Die Serverpräfixe stellen stets die obersten Areas in der Hierarchie des Servers dar.

S, C, T

Time Gibt den Zeitstempel für gekommene, gegangene und quittierte Meldung aus. Der Zeitstempel wird in UTC (Koordinierte Weltzeit ) angegeben.

S, C, T

Type Gibt an, ob es sich um ein Simple, Tracking oder Conditional Event handelt. S, C, TSeverity Gibt die Priorität der Meldung aus. S, C, TEventCategory Gibt die Meldeklasse aus. "Event Category" setzt sich zusammen aus "CategoryID"

und "Category Description". "CategoryID" entspricht der internen ID der Meldeklasse. "Category Description" entspricht dem Namen der Meldeklasse.

S, C, T

Message Gibt den Meldetext der entsprechenden Meldungsnummer aus. S, C, TCondition Gibt die Meldeart aus. CSub Condition Entspricht dem Parameter "Condition". C



OPC WinCC Meldesystem Event-TypChangeMask Gibt die Änderung der Condition an. Weitere Informationen dazu finden Sie unter

"Quittierphilosophie".C

NewState Gibt den aktuellen Status der Condition aus. Weitere Informationen dazu finden Sie unter "Quittierphilosophie".

C

ConditionQuality Gibt die Qualität der Meldung aus. Weitere Informationen dazu finden Sie unter "Quality Codes".

C

AckRequired Gibt an, ob die Meldung quittierpflichtig ist. CEventAttribute Listet die Attribute auf, die für diese Meldung angefordert wurden. Weitere

Informationen dazu finden Sie unter "Attribute des WinCC Meldesystems".C

Quality Gibt den Quality Code der Meldung wieder. CCookie Enthält für den Client keine verwertbare Informationen CActorID Gibt den Benutzer an, der die Meldung quittiert hat. T

Hinweis

Wenn als Filter für Area ein Text ohne Wildcard angegeben ist, werden nur die Meldungen dieser Area zurückgeliefert. Sollen auch die Sourcen zurückgeliefert werden, die sich in Areas unterhalb der angegebenen Area befinden, müssen Sie Wildcards verwenden.

Hinweis

Die Meldeklassen und Meldearten müssen auf den verbundenen OS-Servern identisch konfiguriert sein, wenn Sie den OPC-A&E-Server wie folgt betreiben:● auf einem WinCC Client● auf einer Connectivity Station

Wenn die OS-Server nicht identisch konfiguriert sind, muss der eingesetzte OPC-Client direkt auf den jeweiligen OS-Server zugreifen.

Abbildung der Priorität von Meldungen

EinleitungDie Priorität von Meldungen wird durch den OPC-A&E-Server auf das Attribut "Severity" abgebildet.

Bei der Konfiguration von Alarmen im Meldesystem können Sie eine Priorität von "0" bis "16" projektieren. Die OPC-A&E-Spezifikation definiert für die Severity einen Wertbereich von "1" bis "1000". Dabei steht "1" für die niedrigste und "1000" für die höchste Severity.

Deshalb werden die Werte der Priorität geeignet auf die OPC-Severity abgebildet. In der Standard-Abbildung wird Priorität "0" zu OPC-Severity "1" und Priorität "16" zu OPC-Severity "1000". Alle anderen Prioritätswerte werden linear zwischen "0" und "1000" interpoliert.



Attribute des WinCC Meldesystems

EinleitungDie folgende Tabelle listet die OPC-Attribute des WinCC Meldesystems auf. Die Attribute werden im WinCC Meldesystem projektiert. Einige Attribute sind nur für den internen Gebrauch in WinCC vorgesehen und daher für einen OPC-A&E-Client nicht relevant. Diese Attribute sind in der Tabelle nicht enthalten.

Attribute

OPC Attribute WinCC Meldesystem DatentypCLASSNAME Gibt den Namen Meldeklasse aus. VT_BSTRTYPENAME Gibt den Namen der Meldeart aus. VT_BSTRFORECOLOR Gibt die Textfarbe für gekommene, gegangene oder quittierte Meldungen

aus.VT_I4

BACKCOLOR Gibt die Hintergrundfarbe für gekommene, gegangene oder quittierte Meldungen aus.

VT_I4

FLASHCOLOR Gibt die Blinkfarbe aus. VT_I4FLAGS Gibt an ob, die Meldung quittierpflichtig ist. VT_I4TEXT01 Gibt den Inhalt des Anwendertextblocks01 aus. VT_BSTRTEXT02 Gibt den Inhalt des Anwendertextblocks02 aus. VT_BSTRTEXT03 Gibt den Inhalt des Anwendertextblocks03 aus. VT_BSTRTEXT04 Gibt den Inhalt des Anwendertextblocks04 aus. VT_BSTRTEXT05 Gibt den Inhalt des Anwendertextblocks05 aus. VT_BSTRTEXT06 Gibt den Inhalt des Anwendertextblocks06 aus. VT_BSTRTEXT07 Gibt den Inhalt des Anwendertextblocks07 aus. VT_BSTRTEXT08 Gibt den Inhalt des Anwendertextblocks08 aus. VT_BSTRTEXT09 Gibt den Inhalt des Anwendertextblocks09 aus. VT_BSTRTEXT10 Gibt den Inhalt des Anwendertextblocks10 aus. VT_BSTRPROCESSVALUE01 Gibt den Inhalt des Prozesswertblocks01 aus. VT_VARIANTPROCESSVALUE02 Gibt den Inhalt des Prozesswertblocks02 aus. VT_VARIANTPROCESSVALUE03 Gibt den Inhalt des Prozesswertblocks03 aus. VT_VARIANTPROCESSVALUE04 Gibt den Inhalt des Prozesswertblocks04 aus. VT_VARIANTPROCESSVALUE05 Gibt den Inhalt des Prozesswertblocks05 aus. VT_VARIANTPROCESSVALUE06 Gibt den Inhalt des Prozesswertblocks06 aus. VT_VARIANTPROCESSVALUE07 Gibt den Inhalt des Prozesswertblocks07 aus. VT_VARIANTPROCESSVALUE08 Gibt den Inhalt des Prozesswertblocks08 aus. VT_VARIANTPROCESSVALUE09 Gibt den Inhalt des Prozesswertblocks09 aus. VT_VARIANTPROCESSVALUE10 Gibt den Inhalt des Prozesswertblocks10 aus. VT_VARIANTSTATETEXT Gibt die Statusmeldung aus. VT_BSTRINFOTEXT Gibt den Informationstext zur Meldung aus. VT_BSTRLOOPINALARM Gibt an, ob LoopInAlarm projektiert ist. VT_I4CLASSID Gibt die ID der Meldeklasse aus. VT_I4



OPC Attribute WinCC Meldesystem DatentypTYPEID Gibt die ID der Meldeart aus. VT_I4MODIFYSTATE Gibt den Wert der Zustandvariable der Meldung aus. VT_I4AGNR Gibt die Nummer des AS aus, auf der die Meldung entstanden ist. VT_I2CPUNR Gibt die Nummer der CPU aus, auf der die Meldung entstanden ist. VT_I2DURATION Gibt den Zeitraum zwischen kommend, gehend und Quittierung einer

Meldung aus.VT_I4

COUNTER Gibt die Anzahl der Meldungen nach dem Start von Runtime aus. VT_I4QUITSTATETEXT Gibt an, ob die Meldung quittiert worden ist. VT_BSTRQUITCOUNT Gibt die Anzahl der offenen, nichtquittierten Meldungen aus. VT_I4PARAMETER Gibt den Parameter der Meldung aus. (Abbild der Meldungskonfiguration). VT_BSTRBLOCKINFO Gibt den aktuellen Inhalt des Meldeblocks aus. VT_BSTRALARMCOUNT Gibt die Anzahl der anstehenden Meldungen aus. VT_I4LOCKCOUNT Gibt die Anzahl der gesperrten Meldungen aus. VT_I4PRIORITY Gibt die projektierte Priorität der Meldung an. VT_I4APPLICATION Gibt die Applikation aus, die die Meldung auslöste. VT_BSTRCOMPUTER Gibt den Rechnername aus, der die Meldung bearbeitete. VT_BSTRUSER Gibt den Benutzer aus, der die Meldung bearbeitete. VT_BSTRCOMMENT Gibt den Kommentar der Meldung aus. VT_BSTRHIDDEN-COUNT Gibt die Anzahl der ausgeblendeten Meldungen aus. VT_I4BIG COUNTER Gibt die Anzahl der Meldungen nach dem Start von Runtime aus. VT_CYOS-HIDDEN Gibt den Zustand aus, ob die Meldung ausgeblendet ist. VT_BOOLOS-EVENTID Gibt die konfigurierte Meldungsnummer der Meldung aus. VT_I4

Quittierphilosophie

EinleitungIn WinCC ist die Quittierphilosophie die Art und Weise, wie eine Meldung vom "Kommen" bis zum "Gehen" dargestellt und bearbeitet wird. Beim OPC-A&E-Server wird dieser Meldungsstatus in den Parametern "ChangeMask" und "NewState" dargestellt.

Conditional Events, Simple Events und Tracking EventsMeldungen mit Quittierung werden vom System als Conditional Events an den Client gesendet.

Damit eine Meldung als Simple Event behandelt wird, muss die Meldeklasse der Meldung folgende Voraussetzungen erfüllen:

● "Quittierung gekommen" ist nicht aktiviert.

● "Meldung ohne Zustand gegangen" ist aktiviert.



In WinCC werden Meldungen der Meldeklasse "System, nicht quittierpflichtig" mit der Meldeart "Bedienmeldung" als Tracking Events übertragen.

Hinweis

Meldungen mit der Meldeklasse "System, nicht quittierpflichtig" und der Meldeart "Leittechnik" werden als Simple Events mit der EventCategory "Systemmeldung" übertragen.

ChangeMaskDer Parameter "ChangeMask" hält fest, wo der Meldezustand sich geändert hat.

Parameterwerte:● OPC_CHANGE_ACTIVE_STATE

● OPC_CHANGE_ENABLE_STATE

● OPC_CHANGE_ACK_STATE

NewStateDer Parameter "NewState" zeigt den Meldungszustand nach Änderung an.

Parameterwerte:● OPC_CONDITION_ACTIVE

● OPC_CONDITION_ENABLED

● OPC_CONDITION_ACKED

Übersicht

WinCC NewState ChangeStateGekommene Meldung OPC_CONDITION_ACTIVE

OPC_CONDITION_ENABLEDOPC_CHANGE_ACTIVE_STATE

Gegangene Meldung mit Quittierung



Gegangene Meldung ohne Quittierung

OPC_CONDITION_ENABLED OPC_CHANGE_ACTIVE_STATE

Quittierte Meldungen (Meldung steht noch an)



Quittierte Meldungen (Meldung steht nicht mehr an)



Gesperrte Meldung -------------------------------------- OPC_CHANGE_ENABLED_STATE

Freigegebene Meldung OPC_CONDITION_ENABLED OPC_CHANGE_ENABLED_STATE



WinCC NewState ChangeStateGekommene, quittierte Meldung OPC_CONDITION_ACTIVE



Gekommene, gegangene Meldung mit Quittierung



Gekommene, gegangene Meldung ohne Quittierung

OPC_CONDITION_ENABLED OPC_CHANGE_ACK_STATE

Vom System quittierte Meldung (Meldung steht noch an)



Vom System quittierte Meldung (Meldung steht nicht mehr an)



Notquittierte Meldung (Meldung steht noch an)



Notquittierte Meldung (Meldung steht nicht mehr an)



Hinweis

Historische Alarme und Events werden nicht quittiert. Die Schnittstelle OPC-A&E historische Events wird nur lesend verwendet.

4.9.5.4 Quality Codes für OPC A&E

Einleitung Der Quality Code wird dazu benötigt, den Status und die Qualität einer Meldung zu prüfen. Die Quality Codes für OPC werden beschrieben in der Spezifikation "Data Access Custom Interface Standard Version 3.00" im Kapitel "6.8 OPC Quality flags".

Quality Codes

Code Quality Status0xC0 OPC_GOOD OK0x40 OPC_UNCERTAIN Wird bei Unstimmigkeiten ausgegeben, z.B.

bei verspäteter Quittierung.0x00 OPC_BAD Wird ausgegeben, wenn die Verbindung zur

Source unterbrochen ist.



4.9.6 Lesen von archivierten Meldungen

4.9.6.1 Zugriff auf archivierte Ereignisse

EinleitungMit einem OPC-Client können Sie über den OPC-A&E-Server auf archivierte Meldungen zugreifen. Beim Zugriff auf archivierte Meldungen werden zwei Methoden unterstützt:

● Ausgabe von archivierten Meldungen aus einem Zeitbereich in der Vergangenheit

● Ausgabe von archivierten Meldungen ab einem Zeitbereich in der Vergangenheit ohne Endzeitpunkt. Nach der Ausgabe der archivierten Meldungen werden alle weiteren neu erzeugten Meldungen automatisch an den OPC-Client gesendet.

Hinweis

Nach dem Lesen von archivierten Meldungen, dürfen Sie die zurückgelieferte "ActiveTime" einer Meldung weder für die Quittierung der Meldung noch für die Verfolgung der Transitionen der Meldung verwenden. Damit dieses sichergestellt ist, muss der OPC-A&E-Client den "EventType" einer Meldung auf das zusätzliche Flag "OPC_HAE_HISTORICAL_EVENTFLAG" überprüfen. Die "ActiveTime" ist bei archivierten Meldungen nicht korrekt. Informationen zu dem zusätzlichen Flag finden Sie unter "Identifizieren von archivierten Meldungen".

Abfrage der Funktionalität "Historische Alarme und Events"Neben den Standardfiltern werden bei dem erweiterten OPC-A&E-Server von WinCC folgende Filter angeboten:

Filter Werte der Filter BeschreibungOPC_HAE_FILTER_BY_TIMEFRAME 0x80000000 Entspricht der Funktion "ReadRaw" bei

OPC Historical Data AccessOPC_HAE_FILTER_BY_STARTTIME 0x40000000 Entspricht der Funktion "AdviseRaw"

bei OPC Historical Data Access

Source Filter und Anforderung der historischen AlarmeDamit Sie archivierte Meldungen anfordern können, muss der OPC-Client die Funktionalität "SetFilter" an einer Subscription unterstützen. Wenn Sie den Array des "Source Filter" einer Subscription zusätzlich das Schlüsselwort "OPCHAEServer" einfügen, sendet der OPC-Server auch archivierte Meldungen. Neben diesem Schlüsselwort legen Sie mit weiteren Parametern fest, wie Meldungen gelesen werden:

● Methode

● Zeitraum

● Mit oder ohne Grenzen



Die Liste der Sourcen, die im Filter angegeben werden, kann neben der Source "OPCHAEServer" weitere Source-Namen enthalten. In diesem Fall liefert die Subscription nur die historischen Ereignisse der angegebenen Sourcen. Die Reihenfolge der Source-Namen hat keine Auswirkung.

Nach dem Konfigurieren des Source Filters können Sie den gewählten Zeitbereich vom Client mit einem "Refresh"-Aufruf abrufen.

4.9.6.2 Syntax für Zugriff auf archivierte Meldungen mit OPC

SyntaxOPCHAEServer hMode=(read|advise) htStartTime=szTime [htEndTime=szTime] [bBounds=(TRUE|FALSE)]

Parameter

hMode = [read|advise]Der Parameter ist erforderlich. Legt fest, wie die archivierten Meldungen und Ereignisse gelesen werden.

read: Gibt archivierte Meldungen und Ereignisse eines definierten Zeitraums der Vergangenheit aus (vergleichbar mit ReadRaw bei OPC Historical Data Access).

Im Folgenden das Beispiel für das Setzen eines Filters zum Lesen über die letzten 30 Minuten:

OPCHAEServer hMode=read htStartTime=NOW-30M bBounds=TRUE advise: Gibt archivierte Meldungen und Ereignisse ab einem definierten Zeitpunkt aus. Nach dem Empfangen aller archivierten Meldungen werden neue Meldungen wie bei einer aktiven Subscription gesendet (vergleichbar mit AdviseRaw bei OPC Historical Data Accesss).

Im folgenden Beispiel werden die Meldungen ab den letzten 30 Minuten gelesen (Subscription muss aktiv sein):

OPCHAEServer hMode=advise htStartTime=NOW-30M

Hinweis

Für die Parameter "htStartTime" und "htEndTime" wird folgende Notation unterstützt:● Relative Notationen, z.B. NOW● Symbolische Werte, z.B. NOW, YEAR, MONTH● Angabe von absoluten UTC Datum-/Uhrzeit Werten entsprechend der XML-Notation:

2006-09-01T10:00:00.000Z

Die Verwendung der symbolischen Notation entspricht der Syntax von OPC Historical Data Access.

htStartTime = Der Parameter ist erforderlich. Legt den Zeitpunkt fest, ab dem die Meldungen und Ereignisse aus dem Archiv gelesen werden.



htEndTime = Der Parameter ist optional. Legt den Zeitpunkt fest, bis zu dem die Meldungen und Ereignisse aus dem Archiv gelesen werden. Wenn "hMode = read" ist, wird als Standardeinstellung "NOW" verwendet.

bBounds = [TRUE|FALSE]Der Parameter ist optional. Legt fest, wie Meldungen nahe der Start- und Endzeit behandelt werden. Die Funktion ist identisch zu OPC Historical Data Access.

bBounds=FALSE:

● Der Zeitstempel der ersten übertragenen Meldung >= htStartTime

● Der Zeitstempel der letzten übertragenen Meldung < htEndTime

bBounds=TRUE:

● Der Zeitstempel der ersten übertragenen Meldung <= htStartTime

● Der Zeitstempel der letzten übertragenen Meldung >= htEndTime

Standardeinstellung ist FALSE.

4.9.6.3 Lesemethoden für archivierte Meldungen

EinleitungBeim Lesen von archivierten Meldungen können Sie eine der beiden Lesemodi verwenden:

● read

● advise

Lesemodus "read"Mit dem Lesemodus "read" werden archivierte Meldungen aus einem definierten Zeitbereich in der Vergangenheit gelesen. Die Reihenfolge der gelesenen Meldungen ist immer chronologisch bezogen auf jeden OS Server, von dem Alarme gelesen werden. Sie können durch das Setzen der Start- und Endzeit festlegen, ob die älteste Meldung zuerst oder zuletzt ausgegeben wird. Wenn die Startzeit kleiner als die Endzeit ist, wird die älteste Meldung zuletzt ausgegeben.

Wenn Sie den Lesemodus "read" anwenden wollen, führen Sie auf die Subscription folgende Funktionen aus:

1. SetFilter

2. Refresh

Ein "SetFilter" während des "Refresh" wird verworfen. Wenn Sie während des "Refresh" die Subscription aktivieren, dann wirkt sich das nicht auf den Ablauf des Refresh aus.

Die historischen Ereignisse werden weiterhin mit der Refresh-Kennung übertragen.



Die neu erzeugten Ereignisse werden entsprechend dem Standardverhalten einer aktiven Subscription übertragen:

● Berücksichtigung der gesetzten Filterwerte, mit Ausnahme der "historischen" Source "OPCHAEServer"

● Ohne Refresh-Kennung

Dadurch kann der Client die empfangenen Ereignisse anhand der Refresh-Kennung unterscheiden. Ein Ereignis-Paket enthält nie historische und neue Ereignisse gleichzeitig.

● Ereignis-Pakete mit der Refresh-Kennung enthalten ausschließlich historische Ereignisse. Diese Ereignisse können auch noch anstehen.

● Ereignis-Pakete ohne Refresh-Kennung enthalten ausschließlich neu erzeugte Ereignisse.

Lesemodus "advise"Mit dem Lesemodus "advise" werden archivierte Meldungen ab einem definierten Zeitpunkt in der Vergangenheit gelesen. Nach dem Lesen aller archivierten Meldungen werden neue Meldungen wie bei einer aktiven Subscription gesendet. Die archivierten Meldungen werden chronologisch, bezogen auf jeden OS Server, übertragen: Zuerst werden die archivierten Meldungen ab der Startzeit übertragen. Danach werden die neuen archivierten Meldungen übertragen.

Beachten Sie, dass Sie bei "advise" keine Endzeit angeben dürfen.

Für Lesemodus "advise" wird eine aktive Subscription verwendet. Wenn Sie die Funktion "SetFilter" auf eine aktive Subscription ausführen, werden die historischen Alarme sofort übertragen.

Wenn Sie die Funktion "SetFilter" auf eine inaktive Subscription ausführen, werden die archivierten Meldungen erst nach dem Aktivieren der Subscription übertragen. Wenn Sie den Lesemodus "advise" bei einem inaktive Subscription verwenden wollen, gehen Sie wie folgt vor:

1. SetFilter

2. Mit SetState Subscription auf Active setzen

Wenn Sie die Subscription deaktivieren, wird die Übertragung unterbrochen.

Wenn Sie die Subscription auf "inactive" setzen, wird die Übertragung beendet. Ein "SetFilter" wird verworfen, während die Subscription aktiv ist.

Ein "Refresh" auf eine aktive "historische" Subscription im "advise"-Modus funktioniert genauso wie bei einer Standard-Subscription:

Alle anstehenden Condition Related Ereignisse werden in Paketen mit Refresh-Kennung übertragen. Das letzte Paket enthält zusätzlich die Kennung "Last Refresh".

Ein "Refresh"-Aufruf hat im Modus "advise" keinen Einfluss auf das Lesen von historischen Alarmen.



4.9.6.4 Identifizieren von archivierten Meldungen

PrinzipArchivierte Meldungen werden über ein zusätzliches Flag im EventType unterschieden. Dieses Flag ist mit dem realen EventType über eine ODER-Verknüpfung verbunden:

Bezeichnung EventType EventType (archivierte Meldung)OPC_SIMPLE_EVENT 0x01 0x81OPC_CONDITION_EVENT 0x04 0x84OPC_TRACKING_EVENT 0x02 0x82OPC_HAE_HISTORICAL_EVENTFLAG 0x80

Beispiele

Beispiel 1Mit dem folgenden Source-Filter werden die archivierten Meldungen und Ereignisse der vergangenen 30 Minuten im "read"-Modus ausgegeben. Die älteste Meldung pro OS-Server wird als Erstes ausgegeben. Außerdem wird der untere Grenzwert geliefert.

OPCHAEServer hmode=read htStartTime=NOW-30M bBounds=TRUE

Beispiel 2Mit dem folgenden Source-Filter werden die archivierten Ereignisse des 1. September 2006 von 10:00 Uhr bis 12:00 Uhr im "read"-Modus ausgegeben. Die neueste Meldung pro OS-Server wird als Erstes ausgegeben. Außerdem werden die Grenzwerte dieses Zeitbereichs geliefert.

OPCHAEServer hMode=read htStartTime=2006-09-01T12:00:00.000Z htEndTime=2006-09-01T10:00:00.000Z bBounds=TRUE

Beispiel 3Mit dem folgenden Source-Filter werden die archivierten Meldungen und Ereignisse der vergangenen 30 Minuten im "advise"-Modus ausgegeben. Nach dem Lesen der archivierten Meldungen werden die neu erzeugten Meldungen wie bei einer aktiven Subscription übertragen:

OPCHAEServer hmode=advise htStartTime=NOW-30M



4.10 WinCC-OPC-UA-Server

4.10.1 Funktionsweise des WinCC OPC-UA-Servers

Funktionsweise Der WinCC-OPC-UA-Server stellt folgende Werte zur Verfügung:

● Prozesswerte

● Werte aus Variablenarchiven

Der WinCC-OPC-UA-Server wird als Windows-Dienst installiert und automatisch gestartet. Der WinCC-OPC-UA-Server unterstützt ausschließlich das Kommunikationsprofil "UA-TCP UA-SC UA Binary". Die verwendete Portnummer ist einstellbar.

Unterstützte Spezifikationen OPC Unified Architecture ist eine Spezifikation zur Übertragung von Prozesswerten und Archivdaten. Der WinCC-OPC-UA-Server unterstützt die Übertragung von Prozesswerten und Archivdaten. Weitere Informationen über die unterstützten UA-Funktionalitäten finden Sie unter "Unterstützte OPC-UA-Services (Seite 556)".

InstallationNach der Installation von WinCC ist der WinCC-OPC-UA-Server ohne eine Projektierung sofort einsetzbar.Der WinCC-OPC-UA-Server kann auf einem WinCC-Server oder WinCC-Client eingesetzt werden.

URL des WinCC-OPC-UA-Servers Sie erreichen den WinCC-OPC-UA-Server über folgenden URL:

● "opc.tcp://[HostName]:[Port]"

Parameter BeschreibungHostName Platzhalter für den Computernamen. Wird automatisch eingesetztPort Portnummer. Voreingestellt ist "4862".

Discovery Server Der "Discovery Server" wird von der OPC Foundation zur Verfügung gestellt. Der "Discovery Server" ist standardmäßig auf dem Bediengerät als Windows-Dienst installiert.

Der "Discovery Server" stellt UA-Clients Informationen über OPC-UA-Server zur Verfügung, die am "Discovery Server" angemeldet sind.

OPC - Open Connectivity4.10 WinCC-OPC-UA-Server


Der WinCC-OPC-UA-Server meldet sich bei Runtime-Start abhängig von seiner Konfiguration an keinem, einem oder allen verfügbaren "Discovery Servern" an. Wenn Sie Runtime beenden, wird der WinCC-OPC-UA-Server automatisch vom "Discovery Server" abgemeldet.

Unterstützte Sprachen im WinCC-AdressraumDer WinCC-OPC-UA-Server unterstützt den WinCC-Adressraum in folgenden Sprachen:

● Deutsch

● Englisch

● Französisch

● Italienisch

● Spanisch

4.10.2 Sicherheitskonzept von OPC UA

EinleitungDer WinCC-OPC-UA-Server verwendet zum Austausch von Daten das TCP/IP-Protokoll. Zur Autorisierung zwischen WinCC-OPC-UA-Server und OPC-UA-Client werden Zertifikate ausgetauscht. Den Datenverkehr können Sie zusätzlich verschlüsseln.

Sicherheitskonzept Der WinCC-OPC-UA-Server und jeder OPC-UA-Client autorisieren sich gegenseitig, indem Sie Zertifikate austauschen.

Der WinCC-OPC-UA-Server erzeugt bei der Installation standardmäßig ein selbst signiertes Instanzzertifikat. Alternativ können Sie dieses Instanzzertifikat durch ein projektspezifisches Instanzzertifikat ersetzen.

HinweisPrivater Schlüssel und eigene Zertifikate

Wenn Sie eine eigene Zertifizierungsstelle besitzen, können Sie Zertifikate selber erzeugen und allen Kommunikationspartnern zur Verfügung stellen. Löschen Sie in diesem Fall das vom WinCC-OPC-UA-Server selbst erzeugte Instanzzertifikat.

Das Instanzzertifikat wird im Zertifikatspeicher abgelegt. Abhängig von der Konfiguration des WinCC-OPC-UA-Servers wird einer der folgenden Zertifikatspeicher verwendet:

● Zertifikatspeicher des WinCC-OPC-UA-Servers unter: "<WinCC-Installationsordner>\OPC\UAServer\PKI"

● Zertifikatspeicher des Betriebssystems im Ordner "UA Applications"

Damit der WinCC-OPC-UA-Server und ein OPC-UA-Client miteinander kommunizieren können, müssen die Zertifikate gegenseitig bekannt sein:



● Verwenden Sie den gemeinsamen Zertifikatspeicher des Betriebssystems.Oder

● Kopieren Sie die Zertifikate in den Zertifikatsspeicher der beteiligten Kommunikationspartner:

– WinCC-OPC-UA-Server

– OPC-UA-Client

– Discovery-Server (optional)

Sicherheitseinstellungen Die folgende Tabelle zeigt die Sicherheitseinstellungen, die vom WinCC-OPC-UA-Server unterstützt werden:

Security Policy Message Security ModeNone1 NoneBasic128Rsa152 None4 Sign5 SignAndEncrypt6

Basic2563 None4 Sign5 SignAndEncrypt6

1: Der Zertifikatsaustausch ist ausgeschaltet. Jeder OPC-UA-Client kann sich am WinCC-OPC-UA-Server anmelden. 2: Zertifikatsaustausch mit Verschlüsselungstiefe von 128 Bit.3: Zertifikatsaustausch mit Verschlüsselungstiefe von 256 Bit.4: Die Datenpakete werden nach Zertifikatsprüfung ungesichert zwischen Client und Server ausgetauscht5: Die Datenpakete werden mit den Zertifikaten signiert, aber nicht verschlüsselt6: Die Datenpakete werden mit den Zertifikaten signiert und verschlüsselt

HinweisUngesicherte Kommunikation zwischen Client und Server

Verwenden Sie die Einstellung "none" ausschließlich zu Test- oder Diagnosezwecken.

Verwenden Sie im Produktivbetrieb für eine sichere Kommunikation zwischen Client und Server mindestens folgende Einstellungen:● SecurityPolicy: Basic128Rsa15● Message Security Mode: Sign

Die Verwendung der SecurityPolicy "none" können Sie über die Konfigurationsdatei des WinCC-OPC-UA-Servers deaktivieren. Weitere Hinweise hierzu finden Sie im Kapitel "WinCC-OPC-UA-Server konfigurieren".

Benutzeridentifizierung Zur Identifizierung des Benutzerkontos eines OPC-UA-Clients unterstützt der WinCC-OPC-UA-Server die Methoden "Anonym" und "Windows-Benutzername / Kennwort". Dazu muss am WinCC-OPC-UA-Server das jeweilige Benutzerkonto in der Windows-Benutzerverwaltung bekannt sein.



Die Benutzeridentifizierung wird ausschließlich zum Aufbau einer Kommunikationssitzung verwendet. Unterschiedliche Zugriffsrechte werden nicht unterstützt.

Sie können die Unterstützung anonymer Benutzer in den Konfigurationseinstellungen des WinCC-OPC-UA-Servers deaktivieren.

4.10.3 Unterstützte OPC-UA-Services

EinleitungDer WinCC-OPC-UA-Server unterstützt die nachfolgend beschriebene Funktionalität.

OPC UA Service Sets Die folgende Tabelle zeigt die unterstützten OPC UA Service Sets:

OPC UA Service Sets Services KommentarDiscovery Service Alle -Secure Channel ServiceSession Service

Alle -

View Service BrowseBrowseNextRegisterNodesUnregisterNodes

Ermitteln der abgebildeten WinCC-Daten: Prozesswerte und archivierte Prozesswerte

Attribute Service ReadWrite

nur WinCC-Variablennur WinCC-Variablen

HistoryReadHistoryUpdate*)

nur Archivvariablennur Archivvariablen

Subscription Service Alle nur "Value"-Attribut von WinCC-VariablenMonitoredItem Service Alle nur "Value"-Attribut von WinCC-Variablen*): Mit Einschränkungen, siehe "Unterstützte Schreibzugriffe (Seite 516)"

OPC-UA-Profile und Conformance Units

Hinweis

Da die OPC-UA-Profile für "Historical Access" noch nicht frei gegeben sind, sind sie in der folgenden Aufzählung nicht berücksichtigt.

Der WinCC-OPC-UA-Server unterstützt die folgenden OPC-UA-Profile ohne Einschränkungen:

● 6.5.17 SecurityPolicy - Basic128Rsa15

● 6.5.18 SecurityPolicy - Basic256



● 6.5.19 SecurityPolicy - None

● 6.5.21 Base Server Behaviour Facet

● 6.5.22 Standard DataChange Subscription Server Facet

● 6.5.28 Enhanced DataChange Subscription Server Facet

● 6.5.39 UA-TCP UA-SC UA Binary

Der WinCC-OPC-UA-Server unterstützt die in der folgenden Tabelle gezeigten OPC-UA-Profile, jedoch mit Einschränkungen:

Profile "Group" Nicht unterstüzte "Conformance Unit"

6.5.25 Core Server Facet Attribute Services Attribute Write Index6.5.26 Data Access Server Facet Data Access Data Access Analog

Data Access MultistateData Access PercentDeadBandData Access Semantic ChangesData Access Two State

6.5.35 Standard UA Server Attribute Services Attribute Write StatusCode & TimeStamp

4.10.4 Namensraum des WinCC-OPC-UA-Servers

EinleitungDer WinCC-OPC-UA-Server stellt OPC-UA-Clients einen hierarchischen Namensraum zum Darstellen folgender Runtime-Daten zur Verfügung:

● Prozesswerte (WinCC-Variablen und WinCC-Variablengruppen)

● Variablenarchive inklusive Archivvariablen

Der Namensraum des WinCC-OPC-UA-Servers wird unter dem Standard-Ordner "Objects" eingehängt.

Das folgende Bild zeigt den Namensraum des WinCC-OPC-UA-Servers eines aktiven WinCC-Projekts auf dem lokalen PC ("@LOCALMACHINE::"):



1

2

3

① Startknoten des spezifischen Namensraums von WinCC. ② Abbildung der WinCC-Variablen; die Struktur entspricht der Strukturierung der Variablen in

WinCC. ③ Abbildung der Variablenarchive

Abbildung der WinCC-Variablen Variablengruppen, Kommunikationstreiber und Verbindungen werden durch OPC-UA-Objekte vom Typ "FolderType" abgebildet. Jeder dieser Ordner hat Referenzen vom Typ "Organizes" zu den unterlagerten Objekten und Variablen.

Interne und externe WinCC-Variablen werden mit OPC-UA-Variablen vom Typ "DataItemType" abgebildet. Wenn eine WinCC-Variable zusätzlich archiviert wird, besitzt die abgebildete OPC-UA-Variable zusätzlich eine Referenz vom Typ "HasHistoricalConfiguration" zu einer Archivkonfiguration. Die Attribute "Historizing" und "AccessLevel" werden entsprechend gesetzt.

Die folgende Tabelle zeigt die wichtigsten Attribute der OPC-UA-Variablen, die eine WinCC-Variable darstellen. Eine vollständige Auflistung der Attribute finden Sie im Dokument "OPC UA Part 3 - Address Space Model 1.01 Specification" unter "§5.6":

Attribut Beschreibung KommentarNodeId Eindeutige Bezeichnung der WinCC-

Variable-

BrowseName Name der WinCC-Variable -DisplayName Name der WinCC-Variable -Value Variablenwert und -status -



Attribut Beschreibung KommentarDataType OPC-UA-Datentyp, der dem WinCC-

Variablentyp entspricht, z. B.:● Int32; vorzeichenbehafteter 32-Bit-

Wert● UInt32; vorzeichenloser 32-Bit-Wert

-

AccessLevel "CurrentRead" / "CurrentWrite" "HistoryRead" / "HistoryWrite"

je nach Projektierung der WinCC-Variable

ValueRank Immer "Scalar" -

Abbildung der Archivvariablen Prozesswert- und Verdichtungsarchive werden durch OPC-UA-Objekte vom Typ "FolderType" abgebildet. Jeder dieser Ordner hat auch Referenzen vom Typ "Organizes" zu den zugehörigen Archivvariablen.

Archivvariablen aus Prozesswert- oder Verdichtungsarchiven werden mit OPC-UA-Variablen vom Typ "BaseDateVariableType" abgebildet. Eine Archivvariable hat immer eine Referenz vom Typ "HasHistoricalConfiguration" zu einer Archivkonfiguration.

Die folgende Tabelle zeigt die wichtigsten Attribute der OPC-UA-Variablen, die eine WinCC-Archivvariable darstellen. Eine vollständige Auflistung der Attribute finden Sie im Dokument "OPC UA Part 3 - Address Space Model 1.01 Specification" unter "§5.6":

Attribut Beschreibung KommentarNodeId Eindeutige Bezeichnung der

Archivvariable -

BrowseName Name der Archivvariable -DisplayName Name der Archivvariable -Description Knotenbeschreibung -Value Nicht vorhanden Bei einer Archivvariablen ist

dieses Attribut weder lesbar noch änderbar.

DataType OPC-UA-Datentyp, der dem WinCC-Variablentyp entspricht, z. B.:● Double; 64-Bt-Gleitkommazahl● UInt32; vorzeichenloser 32-Bit-Wert

-

AccessLevel "HistoryRead" / "HistoryWrite" -ValueRank Immer "Scalar" -

4.10.5 OPC UA Data AccessDie WinCC-Variablen werden auf OPC-UA-Variablen vom Typ "DataItemType" abgebildet. Andere DataAccess-Variablentypen wie "AnalogItem" oder "DiscreteType" werden nicht unterstützt.



Der WinCC-OPC-UA-Server unterstützt den lesenden Zugriff auf die OPC-UA-Variablenattribute wie "DataType" oder "AccessLevel". Schreibender Zugriff und Subscriptions werden nur für das "Value"-Attribut unterstützt.

4.10.6 OPC UA Historical Access

Einleitung "OPC Historical Access" ermöglicht den Zugriff auf Archive und umfasst die Dienste "Historical Data" und "Alarms & Events". Der WinCC-OPC-UA-Server unterstützt nur den Dienst "Historical Data".

Der WinCC-OPC-UA-Server bietet OPC-Clients den Zugriff auf die Rohdaten von Variablenarchiven über folgende Services an:

● HistoryRead (READRAW)

● HistoryUpdate (INSERTDATA, REPLACEDATA, UPDATEDATA, DELETE_RAW)

Mit einem OPC-UA-Client können Sie in Variablenarchiven die Werte von Archivvariablen lesen und eingeschränkt schreiben. Abhängig von der Projektierung des Variablenarchivs kann die Archivvariable entweder Rohdaten oder bereits verarbeitete Prozesswerte enthalten.

Besonderheiten bei ArchivvariablenGemäß des OPC-Dokuments "OPC UA Part 11 - Historical Access 1.00 Specification" müssen zu archivierende Variablen genau eine Referenz zu einer Archivkonfiguration ("HistoricalConfiguration") haben. In WinCC kann eine Prozessvariable aber in mehreren Variablenarchiven enthalten sein. In diesem Fall wird die Prozessvariable mit einer der jeweiligen Archivvariablen willkürlich verknüpft.

Eigenschaften / Properties von ArchivkonfigurationenDie folgende Tabelle zeigt die Properties einer OPC-UA-Archivkonfiguration vom Typ "HistoricalConfigurationType". In der Eigenschaft "Description" wird der in WinCC projektierte Kommentar der Archivvariablen abgebildet. Eine vollständige Auflistung der Eigenschaften finden Sie im Dokument "OPC UA Part 11 - Historical Access 1.00 Specification" unter "§4.7.1.4":

Property Beschreibung / Wert KommentarDefinition Name der WinCC-

ProzessvariableBei einem Prozesswertarchiv

Stepped True -

Folgende optionale Properties werden nicht unterstützt:

● MaxTimeInterval

● MinTimeInterval



● ExceptionDeviation

● ExceptionDeviationFormat

Einschränkungen beim Service "HistoryUpdate"Den Service "HistoryUpdate" können Sie nur auf Prozesswertarchive anwenden.

Die folgende Tabelle zeigt die Funktionen, die vom WinCC-OPC-UA-Server unterstützt werden. Welche Funktionen unterstützt werden, ist von der Konfiguration des WinCC-OPC-UA-Servers sowie der Projektierung des Prozesswertarchivs abhängig. Weiterführende Informationen finden Sie im Dokument "OPC UA Part 11 - Historical Access 1.00 Specification" unter "§5.5":

Service Funktion BeschreibungHistoryUpdate INSERTDATA Neue Archivwerte einfügen REPLACEDATA Existierende Archivwerte

ersetzen UPDATEDATA Archivwerte ersetzen oder

einfügen DELETE_RAW Archivwerte löschen

4.10.7 WinCC-OPC-UA-Server konfigurieren

4.10.7.1 Konfigurationsdatei

EinleitungÜber die Konfigurationsdatei "OPCUAServerWinCC.xml" wird der WinCC-OPC-UA-Server konfiguriert. Dieses Kapitel beschreibt den Aufbau der Konfigurationsdatei. Wie Sie den WinCC-OPC-UA-Server konfigurieren, beschreibt das Kapitel "So konfigurieren Sie den OPC-UA-Server (Seite 562)".

AblageortDie projektspezifische Konfigurationsdatei "OPCUAServerWinCC.xml" wird im WinCC-Dateisystem abgelegt unter:

"<WinCC-Projektordner>\OPC\UAServer"

AufbauDie Konfigurationsdatei ist in mehrere Abschnitte unterteilt.

Abschnitt <Secured Application>In diesem Abschnitt wird gemäß OPC UA Specification / Part 6 / § "Security Settings Management" die OPC-UA-Applikationssicherheit eingestellt.



<Secured Application> <BaseAddresses> <...></...> </BaseAddresses>.

Konfiguration der URL des WinCC-OPC-UA-Servers.Weitere Informationen zur URL erhalten Sie unter "Sicherheitskonzept von OPC UA (Seite 554)".

<SecurityProfileUris> <SecurityProfile> <...></...> </SecurityProfile> ... </SecurityProfileUris>

Konfiguration der unterstützten Security PoliciesVerwenden Sie die Einstellung "none" ausschließlich zu Test- oder DiagnosezweckenWeitere Informationen zu Security Policies erhalten Sie unter "Sicherheitskonzept von OPC UA (Seite 554)".

<ApplicationCertificate> <TrustedCertificateStore> <TrustedCertificates> <...>

Änderung der standardmäßigen Zertifikatskonfiguration gemäß OPC UA Specification / Part 6.(optional)

</Secured Application>

Abschnitt <Server Configuration>In diesem Abschnitt werden weitere serverspezifische Parameter eingestellt.

<Server Configuration> <SecurityPolicies> <SecurityPolicy> <...></...> </SecurityPolicy> ... </SecurityPolicies>

Konfiguration der Message Security Modes. Verwenden Sie die Einstellung "none" ausschließlich zu Test- oder DiagnosezweckenWeitere Informationen zu Message Security Modes erhalten Sie unter "Sicherheitskonzept von OPC UA (Seite 554)".

<UserTokenPolicies> <UserTokenPolicy> <...></...> </UserTokenPolicy> ... </UserTokenPolicies>

Konfiguration der BenutzeridentifizierungVerwenden Sie die Einstellung "Anonymous" ausschließlich zu Test- oder DiagnosezweckenWeitere Informationen zu Message Security Modes erhalten Sie unter "Sicherheitskonzept von OPC UA (Seite 554)".

<FastInsert> <Users> <...></...> </Users> <Clients> <...></...> <Clients> </FastInsert>

Konfiguration des optimierten WinCC-Archiv-Schreibzugriffs

<Server Configuration

4.10.7.2 So konfigurieren Sie den OPC-UA-Server

VoraussetzungEin·WinCC-Projekt·ist·angelegt.



Konfigurationsdatei öffnen 1. Öffnen·Sie·den·Windows-Explorer.·Navigieren·Sie·in·das·Verzeichnis· "<WinCC-

Projektordner>\OPC\UAServer".

2. Öffnen·Sie·die·Konfigurationsdatei·"OPCUAServerWinCC.xml". Weitere Informationen dazu finden Sie unter "Konfigurationsdatei (Seite 561)"

Portnummer des WinCC-OPC-UA-Servers ändern1. Ändern·Sie·bei·Bedarf unter <BaseAdresses>·die·Portnummer 4862.

Verwenden Sie keine Portnummer, die durch eine andere Anwendung belegt ist. Der Parameter [HostName] ist Platzhalter für den Computernamen und wird zur Laufzeit ermittelt. Beispiel:<BaseAdresses><ua:String>opc.tcp://[HostName]:5210</ua:String><BaseAdresses>

Sicherheitseinstellungen festlegen 1. Legen Sie die Sicherheitseinstellungen für die Kommunikation fest .·Weitere Informationen

dazu finden Sie unter "Sicherheitskonzept von OPC UA (Seite 554)"

2. Konfigurieren Sie unter <SecurityProfileUris> die unterstützten "Security·Policies".

– Mit "true" aktivieren Sie die Einstellung.

– Mit "false" deaktivieren Sie die Einstellung.Beispiel:<SecurityProfile> <ProfileUri>http://opcfoundation.org/UA/SecurityPolicy#None</ProfileUri> <Enabled>false</Enabled></SecurityProfile>

3. Konfigurieren Sie·unter <SecurityPolicies> die·dazugehörigen·"Message·security·modes". Um eine Einstellung zu deaktivieren, löschen Sie den kompletten Eintrag <SecurityPolicy>... </SecurityPolicy>.Beispiel:<SecurityPolicy> <ProfileUri>http://opcfoundation.org/UA/SecurityPolicy#None</ProfileUri> <MessageSecurityModes>None</MessageSecurityModes></SecurityPolicy>



HinweisUngesicherte Kommunikation zwischen Client und Server

Verwenden Sie die Einstellung "none" ausschließlich zu Test- oder Diagnosezwecken.

Verwenden·Sie·im·Produktiv-Betrieb·für·eine·sichere·Kommunikation·zwischen·Client·und·Server·mindestens·folgende·Einstellungen:● SecurityPolicy:·Basic128Rsa15

Message·Security·Mode:·Sign

Benutzeridentifizierung festlegen1. Legen·Sie·unter <UserTokenPolicies> die·Benutzeridentifizierung für den

Verbindungsaufbau fest. Weitere Informationen dazu finden Sie unter "Sicherheitskonzept von OPC UA (Seite 554)"Um eine Einstellung zu deaktivieren,·löschen·Sie·den kompletten Eintrag.Beispiel<UserTokenPolicy><TokenType>Anonymous</TokenType></UserTokenPolicy>

Optimierten WinCC-Archiv-Schreibzugriff konfigurieren1. Konfigurieren Sie bei Bedarf unter <FastInsert> den optimierten WinCC-Archiv-

Schreibzugriff.

– Mit "true" aktivieren Sie den optimierten WinCC-Archiv-Schreibzugriff für alle OPC UA-Clients.

– Mit "false" können Sie festlegen, ob bestimmte Windows-Benutzer oder OPC UA-Clients den optimierten WinCC-Archiv-Schreibzugriff nutzen dürfen.Unter <Users> legen Sie die Windows-Benutzer fest. Unter <Clients> legen Sie die OPC-UA-Clients fest. Verwenden Sie als ClientName den "Common Name", der im Client-Zertifikat eingetragen ist. Beispiel:<EnabledByDefault>false</EnabledByDefault><Users> <User>domain\user1</User></Users><Clients> <Client>ClientName1</Client></Clients>



4.11 Inbetriebnahme

4.11.1 Inbetriebnahme - OPC

EinleitungDer Datenaustausch zwischen einem WinCC-OPC-Server und OPC-Client läuft über die Softwareschnittstelle DCOM.

Nach der Installation von WinCC sind die DCOM-Einstellungen des OPC-Servers von WinCC richtig konfiguriert.

Wenn ein WinCC-OPC-Server oder Client mit einem Fremd OPC-System kommuniziert, sind entsprechende Anpassungen vorzunehmen.

Auf dem Client müssen für den Benutzer in der Benutzerverwaltung in "DCOM/Arbeitsplatz/COM-Sicherheit/Zugriffsberechtigung/Standard bearbeiten" die Berechtigungen "Lokaler Zugriff" und "Remotezugriff" eingetragen sein.

4.11.2 Konfiguration von Windows

4.11.2.1 So konfigurieren Sie Windows-Konten für die Benutzung von WinCC-OPC

Einleitung OPC-Client und OPC-Server sind DCOM-Anwendungen. Eine verteilte DCOM-Anwendung kann nur unter dem gleichen Benutzerkonto ausgeführt werden. Dazu muss auf dem OPC-Server das Benutzerkonto des OPC-Clients bekannt sein und umgekehrt.

Wenn die WinCC-OPC-Server mit WinCC-OPC-Clients eingesetzt werden, ist die richtige Konfiguration bereits durch die Installation gewährleistet.

Bekanntmachen des Benutzerkontos, wenn ein Fremd OPC-Server oder Client eingesetzt wird Weiterführende Informationen zur Vergabe von Benutzerrechten finden Sie in der Dokumentation zu Windows XP.

VoraussetzungenMelden Sie sich für die Konfiguration von Benutzerrechten als Administrator jeweils am WinCC-OPC-Server und am OPC- Client an.

OPC - Open Connectivity4.11 Inbetriebnahme


Vorgehensweise1. Gehen Sie zu "Systemsteuerung > Verwaltung > Computerverwaltung > Lokale Benutzer

und Gruppen".

2. Wählen Sie im Kontextmenü "Benutzer" den Eintrag "Neuer Benutzer" aus.Tragen Sie im Dialog "Neuer Benutzer" die Daten des Benutzerkontos des Kommunikationspartners ein. Klicken Sie auf die Schaltfläche "Erstellen" und schließen Sie den Dialog.

3. Klicken Sie auf das Symbol "Benutzer". Klicken Sie die entsprechende Benutzer doppelt. Der Eigenschaftsdialog des Benutzers öffnet sich.

4. Klicken Sie auf die Registerkarte "Mitgliedschaft". Klicken Sie auf die Schaltfläche "Hinzufügen". Der Dialog "Gruppe auswählen" öffnet sich

5. Fügen Sie die Gruppe "Benutzer" hinzu.Wenn Sie sich auf einem Rechner befinden auf dem WinCC installiert ist, fügen Sie außerdem die Gruppe "SIMATIC HMI" hinzu. Schließen Sie alle offenen Dialoge über die Schaltfläche "OK".

4.11.2.2 So passen Sie die Windows Firewall-Einstellungen an

EinleitungNach der Installation von WinCC sind die Windows Firewall-Einstellungen für die OPC-Server von WinCC richtig konfiguriert.

Wenn OPC-Clients auf OPC Server in unterschiedlichen Subnetzen zugreifen, müssen Sie die Konfiguration der erlaubten Netzwerkbereiche für die OPC-Server anpassen.



4.11.3 XML

4.11.3.1 Inbetriebnahme - OPC XML

EinleitungDer OPC-XML-Server von WinCC ist als Webdienst realisiert. Dadurch machen Sie Ihren PC vom Internet aus zugänglich. Deshalb ist es notwendig, entsprechende Zugriffsrechte festzulegen.

4.11.3.2 So stellen Sie die Sicherheitseinstellungen mit IIS ein

EinleitungDie Internet-Informationsdienste machen Ihren PC vom Internet aus zugänglich. Deshalb ist es notwendig, entsprechende Zugriffsrechte festzulegen.

Hinweis

Falls Sie Fragen bzw. Schwierigkeiten mit den folgenden Einstellungen haben, wenden Sie sich an Ihren Intra-/Internet Administrator in Ihrer Abteilung.

Vorgehensweise1. Bei Windows 2003 starten Sie über "Systemsteuerung" > "Verwaltung" >

"Internetinformationsdienste-Manager" die Management Console.Bei Windows XP starten Sie über "Systemsteuerung" > "Verwaltung" > "Internet Informationdienste" die Management Console.

2. Wählen Sie das virtuelle Verzeichnis "WinCC-OPC-XML" aus. Wählen Sie im Kontextmenü den Eintrag "Eigenschaften". Der Dialog "Eigenschaften von "WinCC OPC-XML" öffnet sich.

3. Klicken Sie auf die Registerkarte "Verzeichnissicherheit". In dieser Registerkarte werden die Sicherheitsfunktionen des Web-Servers eingestellt.



4. Bei dem Eintrag "Steuerung des anonymen Zugriffs und der Authentifizierung" auf die Schaltfläche "Bearbeiten" klicken. Der Dialog "Authentifizierungsmethoden" öffnet sich.

5. Aktivieren Sie im Bereich "Authentifizierter Zugriff" den Eintrag "Integrierte Windows-Authentifizierung". Der anonyme Zugriff auf den Webservice ist möglich, sollte aus Sicherheitsgründen jedoch nicht aktiviert werden.

6. Schließen Sie alle geöffneten Dialoge.

Siehe auchSo testen Sie die Installation (Seite 569)



4.11.3.3 So stellen Sie die korrekte Version von ASP.NET ein

EinleitungWenn Sie WinCC-OPC-XML-DA nutzen wollen, achten Sie bei der Installation auf die korrekte Version von "ASP.NET" der Web-Site, unter der der WinCC-OPC-XML-Webservice eingebunden ist.

Hinweis

Falls Sie Fragen bzw. Schwierigkeiten mit den folgenden Einstellungen haben, wenden Sie sich an Ihren Intra-/Internet Administrator in Ihrer Abteilung.

Vorgehensweise1. Bei Windows 2003 starten Sie über "Systemsteuerung" > "Verwaltung" >

"Internetinformationsdienste-Manager" die Management Console.Bei Windows XP starten Sie über "Systemsteuerung" > "Verwaltung" > "Internet Informationdienste" die Management Console.

2. Wählen Sie das virtuelle Verzeichnis "WinCC-OPC-XML" aus. Wählen Sie im Kontextmenü den Eintrag "Eigenschaften". Der Dialog "Eigenschaften von "WinCC OPC-XML" öffnet sich.

3. Klicken Sie auf die Registerkarte "ASP.NET". In dieser Registerkarte nehmen Sie die Einstellungen für "ASP.NET" des Web-Servers vor.

4. Klicken Sie beim Eintrag "ASP.NET-Version" auf das Textauswahlfeld. Wenn die Version "2.x" noch nicht eingestellt ist, wählen Sie die Version "2.x".

5. Schließen Sie alle geöffneten Dialoge.

6. Nach Änderungen muss der Webservice neu gestartet werden.

4.11.3.4 So testen Sie die Installation

Einleitung OPC XML-DA stellt die OPC-Prozessdaten als Webseite zur Verfügung. Auf die Webseite wird über das Internet mittels HTTP zugegriffen. Der folgende Abschnitt zeigt, wie Sie die Installation testen.



Vorgehensweise1. Starten Sie den Internet Explorer auf dem Rechner, der als WinCC-OPC-XML-Server

eingesetzt wird.

2. Tragen Sie in der Adressleiste die URL "http://localhost/WinCC-OPC-XML/DAWebservice.asmx" ein. Bestätigen Sie die Eingabe mit <Return>.

3. Wenn Ihnen die OPC XML-DA-Funktionsaufrufe angezeigt werden, war die Installation erfolgreich.

Siehe auchSo stellen Sie die Sicherheitseinstellungen mit IIS ein (Seite 567)



4.11.4 Trace

EinleitungMit dem Trace können Variablenwerte und Funktionsaufrufe für Testzwecke und zur Fehlersuche protokolliert werden.

Die Einträge werden in einer Trace-Datei gespeichert. Die Trace-Datei zeigt z.B. Schritt für Schritt den Vorgang des Verbindungsaufbaus und erleichtert so die Lokalisierung eines Verbindungsproblems.

EinstellungDie Ausgabe des Traces muss in der Registry des Betriebssystem eingestellt werden. Weitere Informationen dazu erhalten Sie beim SIMATIC Customer Support .



Index

A&E-Server

Abbilden der WinCC Meldeklassen und Meldearten, 542

ConfigurationToolStatuszeile, 126

Kopplung WinCC - OPC A&E ClientBeispiel zu OPC-A&E, 534

OPC-A&E-Server , 529, 542

.

.emf, 105

.emf-Datei, 105

AA&E-Server, 527, 528, 537, 539, 542

abbilden des WinCC Meldesystems, 528Abbilden des WinCC Meldesystems, 542Condition Related Event, 527Conditional Event, 537Hierarchischer Zugriff, 539Simple Event, 537Tracking Event, 527, 537

Alarm LoggingConfigurationTool, 119, 160, 161, 167, 169, 173, 174, 177

AlarmControlOnline-Projektierung, 429Runtime-Daten exportieren, 427Statuszeile, 423Symbolleiste, 423Tabellenelemente projektieren, 418, 419, 421

Amplitude, 24Anwenderarchiv, 315

ändern, 332Archivfelder, 327, 329Berechtigungen, 326, 329Datenaustausch mit SIMATIC, 345, 349, 350, 351, 352, 353exportieren, 337, 340impotieren, 339, 342Kommunikation, 320, 345mehrsprachige Texte, 330Namenskonventionen, 335

projektieren, 319, 320, 321, 326, 327, 332Rohdatenvariable, (Siehe Rohdatenvariable)Runtime-Daten, 340, 342Sichten, 315, 333, 334, 335SIMATIC-Schnittstellen, 345Steuervariable, 321User Archive-Funktionen, 355, 356, 358, 367, 378, 385UserArchiveControl, 436, 437, 439Werte, 329

Archiv, (Siehe Anwenderarchiv)Archive ConfigurationTool, 270, 307, 309Archivmappen, (Siehe Archive ConfigurationTool)

Archive ConfigurationTool, 255Archive bearbeiten, 258, 270, 307, 309Archive erzeugen, 307Archivmappen, 267, 270, 272Archivvariable, 278, 286, 296, 311, 313ConfigurationTool, (Siehe ConfigurationTool)Diagnosen, 300, 301, 303, 305Fehlerlisten, 303, 305installieren, 257Prozesswertarchive, 275, 278, 286, 290Schnelleinstieg, 258Systemvoraussetzungen, 257Tag Logging, 275, 278, 286, 296Verdichtungsarchive, 292, 296

Archivmappe, (Siehe Archive ConfigurationTool)Archivtabelle, 255Archivvariable, 311

Archive ConfigurationTool, 278, 286, 296, 311, 313ConfigurationTool, 152, 182, 189, 193, 203, 224

Archivvariablen-Tabelle, 255ASCII-Datei, 14Aufbau, 34

BBedienung des User Archives Controls, 459Bedienung des User Archives Table Elements, 459Bedienung im Runtime, 464Beispiel

COM-Server, 474Steuervariable verwenden, 323User Archive-Funktionen, 358

Benutzerkonto, 565OPC-Rechnern bekannt machen, 565


BerechtigungAnwenderarchive, 326

Bounding Values, 510Buffer Time, 535

CCommunication Configurator, 117COM-Server

Beispiele, 474COM-Server-Objekte, 472, 473Schnittstelle zur Protokollierung, 475

ConfigurationTool, 119Adress-Strings SIMATIC S7, 251Alarm Logging, 160, 161, 167, 169, 173, 174, 177Archive ConfigurationTool, (Siehe Archive ConfigurationTool)Archivvariable, 152, 182, 189, 193, 203, 224bedienen, 126Beispiel für ein Mengengerüst, 243Daten bearbeiten, 206, 211, 216, 217, 218Daten schreiben, 206Datenmanager, 146, 149, 152, 155, 157Diagnosen, 198, 199, 239, 240Dropdown-Menü, 122Einzelmeldungen, 152, 161, 174, 228Excel, 119, 244, 246, 250Fehlerlisten, 198, 199, 240Filter setzen, 218Grenzwerte, 161, 177Grenzwertüberwachungen, 152, 161, 177, 233Gruppen, 149Gruppenmeldungen, 173installieren, 120Kontextmenü, 125Meldearten, 169Meldeblöcke, 167Meldeklassen, 169Projekte, 119, 137, 238, 253Projekteigenschaften, 142Projektmappen, 119, 129, 131, 132, 134, 239Prozesswertarchive, 182, 189Sprachumschaltung, 122Strukturtypen, 157Strukturvariable, 155Symbolleiste, 121Systemvoraussetzungen, 120Tabellenblätter, 139, 142, 146, 149Tag Logging, 182, 187, 189, 193Text Library, 196Variable, 152

Variablendialog, 200Variablentabelle, 222, 224, 228, 233Verbindungen, 149Verdichtungsarchive, 182, 193

Cross Reference, 106, 107

DDateiauswahl, 112Dateinamen, 13Dateistruktur , 16Datenfenster

User Archive, 318Datenformat

Unterschiede zu S5/S7, 347Datenmanager

ConfigurationTool, 146, 149, 152, 155, 157Datenstruktur, 16Decrement, 22, 24Define New Variable, 500

Beispiel zu OPC-DA, 500Diagnose

Archive ConfigurationTool, 300, 301, 303, 305ConfigurationTool, 198, 199, 239, 240

Druckaufträge, 104Druckauftrageigenschaften, 105Dynamic Wizard Editor, 27

Aufbau, 30Ausgabenfenster, 34Editierfenster, 32Hilfe-Editor, 33Installation, 29Symbolleiste, 30

Dynamic Wizard Funktion, 34

EEA-Feld Konfiguration, 493

Beispiel zu OPC DA, 493Eigenschaften des User Archives Table Elements, 466Einzelmeldung

ConfigurationTool, 152, 161, 174, 228E-Server

Funktionsweise des WinCC-OPC-A&OPC, 485Excel

Archive ConfigurationTool, (Siehe Archive ConfigurationTool)ConfigurationTool, (Siehe ConfigurationTool)

Export, 13, 14, 15, 16Anwenderarchiv-Daten exportieren, 337, 340

Index


Runtime-Daten, 427exportieren, 13

FFehlerliste, 305

Archive ConfigurationTool, 303, 305ConfigurationTool, 198, 199, 240

Filterkriterien, 451Formularansicht, 442, 443, 452, 459

Festlegen, 448Formularansicht:Festlegen, 448Formularfeld

Bearbeiten, 457Button, 456Editierfeld, 455löschen, 458Textfeld, 454

Formularfeld:Bearbeiten, 457Formularfeld:Löschen, 458FunctionTrendControl

Online-Projektierung, 429Runtime-Daten exportieren, 427Statuszeile, 423Symbolleiste, 423

FunktionUser Archive-Funktionen, 355, 356, 358, 367, 378, 385

Funktionen, 107Funktionsbaustein, 347Funktionstest, 21Funktionsweise des OPC-A&E-Server

Conditional Event, 537Simple Event, 537Tracking Event, 537

Funktionsweise des WinCC-OPC-A&E-ServerSimple Event, 527

GGrenzwert

ConfigurationTool, 161, 177Grenzwertüberwachung

ConfigurationTool, 152, 161, 177, 233Gruppe

ConfigurationTool, 149Gruppenmeldung

ConfigurationTool, 173

IImport, 13, 14, 16

Anwenderarchiv-Daten impotieren, 339, 342importieren, 13, 14, 16Inbetriebnahmen, 565, 571Increment, 22, 24Item Handles, 510Item ID, 510

KKompatibilität, 482Konfigurationsdatei

Ablageort, 561Aufbau, 561Benutzeridentifizierung, 562Portnummer, 561Sicherheitseinstellungen, 561URL des WinCC-OPC-UA-Servers, 561WinCC-Archiv-Schreibzugriff, 562

konfigurierenBenutzeridentifizierung, 564Optimierten WinCC-Archiv-Schreibzugriff, 564Portnummer, 563Sicherheitseinstellungen, 563WinCC-OPC-UA-Server, 563

Kopplung WinCC - Microsoft Excel, 504Beispiel zu OPC DA, 504

Kopplung WinCC - OPC A&E Client, 534Kopplung WinCC - OPC-HDA-Client, 519

Beispiel zu OPC HDA, 519Kopplung WinCC - SIMATIC NET FMS-OPC-Server, 496

Beispiel zu OPC DA, 496Kopplung WinCC - SIMATIC NET S7-OPC-Server, 499

Beispiel zu OPC DA, 499Kopplung WinCC - WinCC, 492

Beispiel zu OPC DA, 492

MMassendaten, 119, 255Max Size, 535Mehrsprachigkeit

Anwenderarchive, 330Meldeart

ConfigurationTool, 169Meldearten auf OPC-A&E-Server, 542

Index


MeldeblockConfigurationTool, 167

MeldeklasseConfigurationTool, 169

Meldeklassen auf OPC-A&E-Server, 542Mengengerüst, 243Microsoft Excel

Archive ConfigurationTool, (Siehe Archive ConfigurationTool)ConfigurationTool, (Siehe ConfigurationTool)

NNavigationsfenster

User Archive, 318Neuer Benutzer, 565

OObergrenze, 24Offset, 24Online-Projektierung, 429OnlineTableControl

Online-Projektierung, 429Runtime-Daten exportieren, 427Statuszeile, 423Symbolleiste, 423Tabellenelemente projektieren, 418, 419, 421

OnlineTrendControlOnline-Projektierung, 429Runtime-Daten exportieren, 427Statuszeile, 423Symbolleiste , 423

OPCBeispiel, 492, 493, 494, 496, 498, 499, 500, 503, 504, 505, 507, 519Benutzerkonto auf den OPC-Rechnern bekannt machen, 565Funktionsweise des OPC-A&E-Server, 537Funktionsweise des WinCC-OPC-A&E-Server, 527Funktionsweise des WinCC-OPC-DA-Servers, 489Funktionsweise des WinCC-OPC-HDA-Servers, 509Funktionsweise des WinCC-OPC-UA-Server, 553Funktionsweise des WinCC-OPC-XML-Servers, 485HDA Server-Browser, 520Inbetriebnahme, 565Kommunikationskonzept, 484

Kompatibilität, 482Neuer Benutzer, 565OPC in WinCC, 483ProgID, 491Spezifikationen, 481Trace, 571Verwendung mehrerer OPC-DA-Server, 490Zugriff auf das WinCC Meldesystem projektieren, 535Zugriff auf eine WinCC Archivvariable mit HDA Server Browser projektieren, 521

OPC A&E-ServerQuality Codes, 534Zugriff auf das WinCC Meldesystem projektieren, 535

OPC UA OPC UA Service Sets , 556Abbildung der Archivvariablen, 559Abbildung der WinCC-Variablen, 558Conformance Units, 556Profile, 556

OPC UA Data Access, 560OPC UA Historical Access, 560OPC-A&E Client

Beispiel zu OPC-A&E, 534OPC-A&E-Server, 527, 534, 535, 537, 539

Quality Codes, 547OPC-A&E-Servers, 485OPC-A&Raw Data, 534OPC-DA-Server, 489

Funktionsweise des WinCC-OPC-DA-Servers, 489Verwendung mehrerer OPC-DA-Server, 490

OPC-HDA-Server, 509Aggregate, 512Attribute, 511Bounding Values, 510Datenstruktur, 510, 511Funktionsweise, 509Item Handles, 510Item ID, 510Quality Codes, 516, 534Raw Data, 509Schreibzugriffe, 516Unterstützte Funktionen, 513Zeitformat des WinCC-OPC-HDA-Servers, 514

OPC-Item-Manager, 491OPCScout-New Project1

Beispiel zu OPC DA, 500OPC-UA-Server

Benutzeridentifizierung, 555Funktionsweise, 553

Index


Kommunikationsprofil, 553Konfigurationsdatei, 561Sicherheitseinstellungen, 555Sicherheitskonzept, 554unterstützte Spezifikationen, 553URL, 553

OPC-XML, 567, 569Installation testen, 569Sicherheitseinstellung im IIS, 567

OPC-XML-Server, 485Installation, 486, 488Installation .NET-Framework 1.1, 487

PProgID

abfragen, 491Projekt

Beispiel zu OPC-DA, 494ConfigurationTool, 119, 137, 238, 239, 253Projektmappen, (Siehe ConfigurationTool)

Projektauswahl, 111Projektieren

einer Formularansicht, 452eines User Archives Controls, 443, 444, 445eines User Archives Table Elements, 444, 445

Projektieren:eines User Archives Table Elements, 443Projektmappe, (Siehe ConfigurationTool)Protokollseite, 104Protokollsystem, 472Prozessperipherie, 22Prozessvariable, 22Prozesswertarchiv, 275

Archive ConfigurationTool, 275, 278, 286, 290, 301ConfigurationTool, 182, 189

QQuality Codes, 516, 534, 547Quittierphilosophie, 532, 545

RRaw Data, 509Redundantes Systen

redundante Anwenderarchive, 317Rohdatenvariable

Anwenderarchive, 320Datenaustausch, 345

Datenaustausch mit SIMATIC, 345, 349, 350, 351, 352, 353Datenformate, 347

RulerControlOnline-Projektierung, 429Runtime-Daten exportieren, 427Statuszeile, 423Symbolleiste, 423Tabellenelemente projektieren, 418, 419, 421

RuntimeBedienung des User Archives Controls, 459Bedienung des User Archives Table Elements, 459, 464Formularansicht, 459Schaltflächen, 433Tabellenansicht, 458

Runtime:Formularansicht, 459Runtime:Tabellenansicht, 458

SSchaltfläche

UserArchiveControl, 433Schnittstelle

SIMATIC, 345Schwingung, 22, 24Schwingungsdauer, 24Seitenlayout-Editor

anwendersprezifische Daten ausgeben, (Siehe COM-Server)COM-Server-Objekte, (Siehe COM-Server)

SelektionSelektionsdialog, 437

Sicht, (Siehe Anwenderarchiv)Simulation, 21Simulator, 21Sinus, 22, 24Skript, 107

Beispiel mit User Archive-Funktionen, 358Skriptverwaltung, 114Slider, 22, 24Sollwert, 24Sortierkriterien, 451Sortierung

Sortier-Dialog, 439SQL, 451, 459, 461, 462Startwert, 24Statuszeile, 423

UserArchiveControl, 433Steuervariable, 321

Beispiel, 323Stoppwert, 24

Index


StrukturtypConfigurationTool, 157Strukturtyp-Elemente, 157

Strukturtypen, 16Strukturvariable

ConfigurationTool, 155Strukturinstanz-Elemente, 152, 155

Symbolleiste, 423Bedienung des User Archives Controls, 459Bedienung des User Archives Table Elements, 459UserArchiveControl, 431, 433

SystemvoraussetzungArchive ConfigurationTool, 257ConfigurationTool, 120

TTabelle

Tabellenelemente projektieren, 418, 419, 421Tabellenansicht, 442, 443, 458

Festlegen, 448Tabellenansicht:Festlegen, 448Tabellenfenster

User Archive, 318Tag Logging

Archive ConfigurationTool, 255, 275, 278, 286, 296ConfigurationTool, 119, 182, 187, 189, 193

Text LibraryConfigurationTool, 119, 196

UuaAddArchive, 367uaAddField, 368uaArchiveClose, 387uaArchiveDelete, 387uaArchiveExport, 388uaArchiveGetCount, 389uaArchiveGetFieldLength, 389uaArchiveGetFieldName, 390uaArchiveGetFields, 390uaArchiveGetFieldType, 391uaArchiveGetFieldValueDate, 392uaArchiveGetFieldValueDouble, 392uaArchiveGetFieldValueFloat, 393uaArchiveGetFieldValueLong, 394uaArchiveGetFieldValueString, 394uaArchiveGetFilter, 395uaArchiveGetID, 395

uaArchiveGetName, 396uaArchiveGetSort, 397uaArchiveImport, 397uaArchiveInsert, 398uaArchiveMoveFirst, 398uaArchiveMoveLast, 399uaArchiveMoveNext, 399uaArchiveMovePrevious, 400uaArchiveOpen, 400uaArchiveReadTagValues, 401uaArchiveReadTagValuesByName, 401uaArchiveRequery, 402uaArchiveSetFieldValueDate, 403uaArchiveSetFieldValueDouble, 403uaArchiveSetFieldValueFloat, 404uaArchiveSetFieldValueLong, 405uaArchiveSetFieldValueString, 405uaArchiveSetFilter, 406uaArchiveSetSort, 407uaArchiveUpdate, 407uaArchiveWriteTagValues, 408uaArchiveWriteTagValuesByName, 409uaConfigArchive"Struktur zur Programmierung des Handles", 377uaConnect, 379uaDisconnect, 380uaGetArchive, 369uaGetField, 369uaGetLastError, 409uaGetLastHResult, 411uaGetLocalEvents, 380uaGetNumArchives, 370uaGetNumFields, 371uaIsActive, 380uaOpenArchives, 381uaOpenViews, 381uaQueryArchive, 382uaQueryArchiveByName, 383uaQueryConfiguration, 371uaReleaseArchive, 384uaReleaseConfiguration, 372uaRemoveAllArchives, 372uaRemoveAllFields, 373uaRemoveArchive, 374uaRemoveField, 374uaSetArchive, 375uaSetField, 376uaSetLocalEvents, 384uaUsers, 385Untergrenze, 24URL

OPC-UA-Server, 553

Index


User Archive, 315, 318Anwenderarchive, (Siehe Anwenderarchiv)Funktionen, 355, 356, 358, 367, 378, 385

User Archives Control, 442Ausgabeformat festlegen, 449Bedienung im Runtime, 459Farben festlegen, 452Filterkriterien, 451Formularansicht, 452, 459löschen, 447Projektieren, 443, 444, 445Schriftarten festlegen, 452Sortierkriterien, 451Spalten festlegen, 449Statuszeile, 450Symbolleiste, 450Tabellenansicht, 458

User Archives Table Element, 442Anwenderarchiv festlegen, 448Bedienung im Runtime, 459, 464Eigenschaften, 447Formularansicht, 452Formularansicht festlegen, 448Objekteigenschaften, 447Projektieren, 444, 445Sicht festlegen, 448Tabellenansicht festlegen, 448Zugriffsarten festlegen, 448

User Archives Table Element:Anwenderarchiv festlegen, 448User Archives Table Element:Ausgabeformat festlegen, 449User Archives Table Element:Farben festlegen, 452User Archives Table Element:Filterkriterien, 451User Archives Table Element:Formularansicht, 459User Archives Table Element:Formularansicht festlegen, 448User Archives Table Element:Löschen, 447User Archives Table Element:Projektieren, 443User Archives Table Element:Schriftarten festlegen, 452User Archives Table Element:Sicht festlegen, 448User Archives Table Element:Sortierkriterien, 451User Archives Table Element:Spalten festlegen, 449User Archives Table Element:Statuszeile, 450User Archives Table Element:Symbolleiste, 450User Archives Table Element:Tabellenansicht, 458User Archives Table Element:Tabellenansicht festlegen, 448User Archives Table Element:Zugriffsarten festlegen, 448UserArchiveControl, 412

Daten bearbeiten, 436, 437, 439Online-Projektierung, 429projektieren, 413, 415Runtime-Daten exportieren, 427Schaltflächen, 433Statuszeile, 423, 433Symbolleiste, 423, 431, 433Tabellenelemente projektieren, 418, 419, 421

ÜÜberschwingen, 24

VVariable

Beispiel zu OPC DA, 500, 503, 507Beispiel zu OPC HDA, 521, 522ConfigurationTool, 152HDA Server Browser, 520HDA Server Browser projektieren, 521Steuervariable, 321

Variable hinzufügenBeispiel zu OPC DA, 494

Variablen, 16Variablensimulator, 21Variablentabelle, 222, 224, 228, 233Verbindung

ConfigurationTool, 149Verdichtungsarchiv, 292

Archive ConfigurationTool, 292, 296, 301ConfigurationTool, 182, 193

WWinCC

OPC in WinCC, 483SIMATIC-Schnittstellen, 345

WinCC Archive, (Siehe Archive ConfigurationTool )WinCC Archive ConfigurationTool, (Siehe Archive ConfigurationTool)WinCC ConfigurationTool, (Siehe ConfigurationTool)WinCC CrossReferenceAssistant, 106, 107WinCC Explorer-OPC_Client.MPC, 491WinCC Meldesystem

Abbilden der WinCC Meldeklassen und Meldearten, 529, 530Attribute, 530, 544auf OPC A&OPC-A&WinCC Meldesystem, 528WinCC Meldearten auf OPC A&E-Server, 529WinCC Meldeklassen auf OPC A&E-Server, 529

Index


Zugriff auf das WinCC Meldesystem projektieren, 535

WinCC Redundancyredundante Anwenderarchive, 317

WinCC User Archives Control, 442WinCC User Archives Table Element, 442WinCC UserArchiveControl, (Siehe UserArchiveControl)WinCC-OPC-A&E-Server

Hierarchischer Zugriff, 539WinCC-OPC-UA-Server, 553

Discovery Server, 553konfigurieren, 563

WinCC-Protokollsystem, 104

ZZielmaschine, 15, 16Zufallszahlen, 22, 24

Index

Documents

SIMATIC HMI WinCC V7.2 - WinCC: Tools (SmartTools… · SIMATIC HMI WinCC V7.2 WinCC: Tools (SmartTools, User Archive, Schnittstellen) Systemhandbuch Ausdruck der Online-Hilfe 02/2013