Gültige Datentypen und Konversionen

Zahlen

TypeScript und JavaScript kennen nur einen numerischen Datentyp (number) – alle Zahlen werden mit diesem Datentyp ans bzw. vom API übergeben. Die Genauigkeit entspricht dem CTRL-Datentyp double, d.h. auch, dass ein 64-bit Integer-Datentyp nicht exakt repräsentiert werden kann.

Deshalb besteht die Möglichkeit, diese Werte als BigInt anstelle von number zurückzugeben. Diese Feature muss über WinccoaManager:setOptions() aktiviert werden:

winccoa.setOptions({longAsBigInt: true});

Mehrsprachige Strings

Mehrsprachige Strings (langText) können vom API in folgenden Formaten zurückgegeben werden:

• Als Objekt ist jede Sprache der Name einer Property, und der Wert der Property ist der String in der jeweiligen Sprache, z.B.

  {"de_AT.utf8": "Deutscher Text", "en_US.utf8": "English Text"}

• Als Array von Strings, sortiert nach Sprach-IDs, z.B.:

  ["Deutscher Text", "English Text"]

• Als einzelner String, entweder in der aktiven Sprache (default) oder einer fixen Sprache

Welches Format vom API zurückgegeben wird, kann über WinccoaManager:setOptions() konfiguriert werden.

Alarmzeiten

Alarmzeiten (atime) werden in TypeScript/JavaScript durch die Klasse WinccoaAlertTime repräsentiert.