Namenskonventionen / Notationen
Alle Namen (Bezeichner) sind sensitiv für Groß-/Kleinschreibung (case sensitive).
Im Sinne der Gestaltung von portierbaren Projekten, sollten auch Pfadangaben (Panel-, Bild oder sonstige Dateipfade) immer mit korrekter Groß-/Kleinschreibung und ohne Leerzeichen referenziert werden.
Für alle Bezeichner gilt, dass diese mit einem Alpha-Zeichen (Buchstaben) bzw. einem Unterstrich "_" beginnen sollen und keine Sonderzeichen enthalten dürfen (:, ., *, #, $, @, ...). Bauen Sie Bezeichner ausschließlich aus den Zeichen "A...Z", "a...z", "_" und den Ziffern "0...9" auf.
Vielfach ist die Verwendung der deutschsprachigen Umlaute "ä","ö", "ü" möglich - es wird jedoch dringend empfohlen, diese grundsätzlich zu vermeiden: Bei internationaler Verwendung stehen sonst möglicherweise keine entsprechenden Tasten für die Eingabe zur Verfügung und auch die Anzeige ist bei manchen (fremdsprachigen) Systemen problematisch.
Die meisten Bezeichner in WinCC OA besitzen keine strikte Limitierung ihrer Länge, so dass eine eindeutige, gut lesbare und kontextorientierte Benennung möglich ist. Im Sinne von Speicherplatzbedarf, Eingabeaufwand und Verarbeitungsgeschwindigkeit wird jedoch empfohlen, auf allzu lange Namen zu verzichten und im Rahmen der üblichen maximal 20 bis 30 Zeichen zu bleiben. Der Wunsch nach vollständiger Anzeige in den Standard-Oberflächen wie Alarm- oder Ereignisschirm definiert überdies sinnvolle Maximallängen.
Element | Eindeutigkeit | Sonstiges |
---|---|---|
Systemnamen | innerhalb der Systeme | Neben anderen Sonderzeichen sind insbesondere der Punkt "." und der Doppelpunkt ":" als Trennzeichen der vollständigen Elementadresse verboten. |
Datenpunkttypen | innerhalb der Datenpunkttypen | Die Verwendung des Unterstrichs "_" als erstes Zeichen ist den internen Datenpunkttypen von WinCC OA vorbehalten. Neben anderen Sonderzeichen sind insbesondere der Punkt "." und der Doppelpunkt ":" als Trennzeichen der vollständigen Elementadresse verboten. |
Datenpunktname | innerhalb aller Datenpunktnamen unabhängig vom Datenpunkttyp | Für die erlaubten Zeichen bei Datenpunktnamen, siehe Funktion nameCheck(). |
Datenpunktelement | siehe Datenpunktnamen (keine Einschränkung auf Elementebene) | Neben anderen Sonderzeichen sind insbesondere der Punkt "." und der Doppelpunkt ":" als Trennzeichen der vollständigen Elementadresse verboten. |
Konfigs und Attribute | keine (fix vorgegeben) | Neben anderen Sonderzeichen sind insbesondere der Punkt "." und der Doppelpunkt ":" als Trennzeichen der vollständigen Elementadresse verboten. |
Beschreibung (Datenpunktelementbeschreibung) | keine |
Beschreibungen können bei mehrsprachigen Projekten auch in mehreren Sprachen vergeben werden. Bei der Anzeige z.B. in Panels können dann auch noch individuelle Schriftarten /-größen je Sprache verwendet werden. Keine Einschränkungen bezüglich Sonderzeichen/Leerzeichen erlaubt. |
Alarmtexte | keine |
Alarmtexte können bei mehrsprachigen Projekten auch in mehreren Sprachen vergeben werden. Bei der Anzeige z.B. in Panels können dann auch noch individuelle Schriftarten /-größen je Sprache verwendet werden. Keine Einschränkungen bezüglich Sonderzeichen/ Leerzeichen erlaubt. |
Variablennamen |
je nach Deklarationsart: - Konstrukt-lokal - lokal - Script-global - Panel-global - Manager-global |
Einschränkungen konform zu den Bezeichnungskonventionen der Programmiersprache C. Unter anderem sind Schlüsselwörter und Funktions-namen nicht als Variablenbezeichnung gestattet. Auch die Verwendung von Namen von Grafikobjekten ist nicht gestattet. |
Panelnamen (Paneltitel) | innerhalb aller, zu einem Zeitpunkt geöffneter Panels |
Da der Panelname als Identifikation des Panels (z.B. zum Schließen) dient, muss innerhalb aller, zu einem Zeitpunkt möglicherweise geöffneten Panels Eindeutigkeit gegeben sein. Leerzeichen sind erlaubt. Es wird stark empfohlen nur ASCII Zeichen für Panelnamen zu werden um jegliche Art von Problemen mit Datei basierten Funktionen zu vermeiden. |
Namen von Grafikobjekten |
innerhalb des Panels, innerhalb der Referenz |
Namen von Grafikobjekten müssen immer mit einem Alpha-Zeichen beginnen und dürfen keinerlei Sonderzeichen enthalten. Es wird dringend empfohlen, aktuell in einem Script vorkommende Variablenbezeichner nicht gleichzeitig als Bezeichner für Grafikobjekte zu verwenden! |
Pfade | innerhalb des Dateisystems aller Platten (bzw. bei UNC-Pfaden netzwerkweit) |
Pfade sollten immer, unabhängig vom Betriebssystem, in der folgenden Form mit Schrägstrichen "/" (forward slash) angegeben werden: //hostname/share/path wincc_oa_path+"panels/vision/dp_monitor.pnl" C:/Siemens/Automation/WinCC_OA/ <Version> |
Windows-Dateinamen |
Windows-Dateinamen dürfen keine Sonderzeichen enthalten: z.B. / \ : ? * < > |
Für Windows-Pfade sind u.a. die folgenden Zeichen nicht erlaubt: ? * < > | |
|
Binärgrößen | - |
Angabe von bool'schen Werten darf auf folgende Arten erfolgen: 0 / 1, true / false, TRUE / FALSE |
Fließkommazahlen | - |
Fließkommazahlen (Gleitpunktzahlen" float) werden in WinCC OA aufgrund der Anlehnung des Scriptings an den internationalen Programmierstandard C mit einem Punkt als Dezimaltrennzeichen geschrieben: z.B. 42.9733 +459.9 -0.0031
Die Angabe des Vorzeichens kann bei positiven Zahlen weggelassen werden, bei negativen Zahlen ist ein Minus "-" unmittelbar voranzustellen. |
Exponentialschreibweise | - |
Die Angabe in Exponentialschreibweise erfolgt in Anlehnung an die Fließkommazahlen. Als Exponentialzeichen wird das kleine "e" verwendet: z.B. 8.859e-12 oder 2.99792e8 (entspricht 2.99792· 108 bzw. 299792000) |
Zeichen (char) | - |
Einzelne Zeichen vom Datentyp char werden unter einfache Hochkomma gestellt: z.B. 'a', 'X' |
Zeichenketten (string) | - |
Zeichenketten (strings) werden durch doppelte Hochkomma (Anführungszeichen) dargestellt: z.B.: "Ventil 17 Störung", "[Text]" |