FB_JsonReadWriteDataType

Zur Verwendung von UTF-8-Zeichen, z. B. bei der automatischen Generierung von Metadaten über den Funktionsbaustein FB_JsonReadWriteDataType, muss im TwinCAT-Projekt das Auswahlkästchen zur Unterstützung von UTF-8 in der Symbolik aktiviert sein. Klicken Sie dazu im Projektbaum doppelt auf SYSTEM, öffnen Sie die Registerkarte Settings und aktivieren Sie das entsprechende Auswahlkästchen.

	Strings im UTF-8-Format Die hier verwendeten Variablen vom Typ STRING nutzen das UTF-8-Format. Diese STRING-Formatierung ist üblich bei IoT/MQTT-Kommunikation sowie JSON-Dokumenten. Um Sonderzeichen und Texte verschiedenster Sprachen empfangen zu können, wird der Zeichensatz in den Bibliotheken Tc3_IotBase und Tc3_JsonXml nicht auf den typischen Zeichensatz vom Datentyp STRING beschränkt. Stattdessen wird der Unicode-Zeichensatz als UTF-8-Format in Verbindung mit dem Datentyp STRING verwendet. Bei Verwendung des ASCII-Zeichensatzes besteht kein Unterschied zwischen der typischen Formatierung in einem STRING und der UTF-8-Formatierung eines STRING. Weitere Informationen zum UTF-8-STRING-Format sowie vorhandenen Anzeige- und Konvertierungsmöglichkeiten finden Sie in der Dokumentation der SPS-Bibliothek Tc2_Utilities.

Ausgänge

Name	Typ
initStatus	HRESULT

Methoden

Name	Beschreibung
FB_JsonReadWriteDataType	Metadaten werden über SPS-Attribute in die JSON-Repräsentation einer SPS-Datenstruktur auf einem FB_JsonSaxWriter-Objekt hinzugefügt.
AddJsonKeyValueFromSymbol	Erzeugt die JSON-Repräsentation einer SPS-Datenstruktur auf einem FB_JsonSaxWriter-Objekt.
AddJsonValueFromSymbol	Erzeugt die JSON-Repräsentation einer SPS-Datenstruktur auf einem FB_JsonSaxWriter-Objekt.
CopyJsonStringFromSymbol	Erzeugt die JSON-Repräsentanz eines Symbols und kopiert diese in eine Variable vom Datentyp STRING.
CopyJsonStringFromSymbolProperties	Erzeugt eine entsprechende JSON-Repräsentation von SPS-Attributen an einem Symbol.
CopySymbolNameByAddress	Liefert den vollständigen (ADS-)Symbolnamen eines übergebenen Symbols.
GetDataTypeNameByAddress	Liefert den Datentypnamen eines übergebenen Symbols.
GetJsonFromSymbol	Erzeugt die entsprechende JSON-Repräsentation eines Symbols.
GetJsonStringFromSymbol	Erzeugt die entsprechende JSON-Repräsentation eines Symbols.
GetJsonStringFromSymbolProperties	Erzeugt eine entsprechende JSON-Repräsentation von SPS-Attributen an einem Symbol.
GetSizeJsonStringFromSymbol	Liest die Größe der JSON-Repräsentanz eines Symbols aus.
GetSizeJsonStringFromSymbolProperties	Liest die Größe der JSON-Repräsentanz von SPS-Attributen an einem Symbol aus.
GetSymbolNameByAddress	Liefert den vollständigen (ADS-)Symbolnamen eines übergebenen Symbols.
SetSymbolFromJson	Extrahiert einen String, der eine gültige JSON-Nachricht beinhaltet.

Voraussetzungen

TwinCAT Version	Hardware	Einzubindende Bibliotheken
TwinCAT 3.1, Build 4022	x86, x64, ARM	Tc3_JsonXml

Weiterführende Informationen