Format-Strings; Text Und Zahlen - LOYTEC L-VIS Benutzerhandbuch

L-VIS Benutzerhandbuch
Die XML Import und Export Funktionen sind hauptsächlich dafür vorgesehen, um dem
Anwender die Entwicklung externer Programme zu erlauben, die mit Hilfe von XML
Vorlagen und Informationen über die vorhandenen Geräte im Netzwerk automatisch ein
komplettes Projekt in XML Format erstellen, das der Anwender nur mehr in die
Konfigurations-Software laden und ins Gerät schreiben muss. Die XML Vorlagen sind
dabei Teile eines Projekts, wie z.B. einer Projekt-Seite mit der die Beleuchtung eines
Standard-Büros gesteuert werden kann, die mit Hilfe der diversen XML Export Funktionen
erstellt wurden. Die externe Software kann dann z.B. mehrere dieser XML Vorlagen
aneinander fügen um ein Projekt für das gesamte Gebäude zu erstellen.
Das vollständige XML Schema für die einzelnen Teile der Konfiguration wird von
LOYTEC bei Bedarf zur Verfügung gestellt.

15.7 Format-Strings

15.7.1 Text und Zahlen

Der Format String der von nicht-lokalisierten Textfeldern und Zahlenfeldern verwendet
wird, ist äquivalent zu den Format Strings die von der ANSI-C Funktion printf verwendet
werden. Der angegebene Format String wird am Gerät dazu verwendet, um exakt ein
Argument zu formatieren. Je nach Art von Control ist das Argument entweder ein String,
eine Ganzzahl oder ein Fließkommawert doppelter Präzision. Daher darf in einem Format
String für Controls immer maximal ein Platzhalter vorkommen und sein Typ muss der Art
des Controls entsprechen. Die Verwendung eines %f Platzhalters wird z.B. nicht bei einem
Textfeld funktionieren, der %s Platzhalter kann wiederum ausschließlich in einem Textfeld
verwendet werden.
Normale Zeichen werden unverändert übernommen, mit % eingeleitete Platzhalter werten
ein Argument aus und formatieren es entsprechend den Angaben im Platzhalter. Zwischen
dem einleitenden % und der eigentlichen Konvertierungs-Spezifikation (Text, Ganzzahl,
Hexadezimalzahl, Fließkommazahl, ...) können optional (in dieser Reihenfolge) ein oder
mehrere Flags, eine minimale Feldbreite, eine Präzision und eine Längenangabe stehen
(siehe weiter unten). Für manche numerischen Konvertierungen wird ein Dezimalpunkt
Zeichen oder Tausender Gruppierungszeichen verwendet. Das tatsächlich verwendete
Zeichen hängt von der Implementierung am Gerät ab. Nicht lokalisierte Zahlenfelder
verwenden immer einen Dezimal-Punkt (.) als Dezimal-Trennzeichen und haben keine
Gruppierungszeichen.
15.7.1.1 Flags
Das einleitende Zeichen % wird optional von ein oder mehreren Flags gefolgt:
Version 6.2

Projekt Einstellungen: Importiert bzw. exportiert die Einstellungen die in den
Dialogen Projekt Einstellungen und Netzwerk Einstellungen gemacht werden.

Datenpunkte: Importiert bzw. exportiert das Set an Datenpunkten, wie es im
Datenpunkt Manager konfiguriert ist. Beachten Sie, dass alle Datenpunkt
Referenz-Objekte im Projekt die Datenpunkte über eine eindeutige ID
referenzieren. Wenn im Projekt also bereits Datenpunkte verwendet werden, sollte
das Set an Datenpunkten nicht mehr ausgewechselt werden, da diese Referenzen
sonst beschädigt sind oder ungültig werden.

Kalender Konfiguration: Importiert bzw. exportiert die aktuelle Konfiguration
eines lokalen Kalenders. Nur verfügbar, wenn ein Kalender angelegt wurde.

Scheduler Konfiguration: Importiert bzw. exportiert die Konfiguration aller
lokalen Scheduler Objekte. Nur verfügbar, wenn mindestens ein lokaler Scheduler
im Projekt vorhanden ist.
319
LOYTEC electronics GmbH
LOYTEC