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 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· 10⁸ 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]"