Datenblock (Empfang) - Einfaches Telegramm
Ein empfangener Datenblock kann folgende Daten enthalten:
- Beliebige Anzahl an Daten
- Feste Anzahl an Daten
- Text
- Binärdaten
- K.-Objekt als Klartext
- K.-Objekt als Binärdaten
- Text aus vordefinierter Liste
- Text/Wert mit fester Länge
Datenblock: Beliebige Anzahl an Daten
Die Antwort enthält eine beliebige Anzahl an Daten, die nicht verarbeitet werden müssen. Hierauf müssen ein "Text" oder Binärdaten folgen. Verwendet man diese Kennzeichen, so werden die Daten zu diesem Abschnitt nicht verarbeitet.
Datenblock: Feste Anzahl an Daten
Erwartet in der Antwort eine feste Anzahl an Daten. Die jeweilige Länge muß festgelegt werden.
Datenblock: Text
Erwartet einen Text. Dem Text kann optional ein Carriage Return (CR) und/oder ein Line Feed (LF) angehängt werden. Weiterhin kann der Text auch Sonderzeichen in Form von Hexwerten enthalten. Die Sonderzeichen werden dann in der Form \x?? eingegeben, der Hexwert wird mit einem \x eingeleitet und muss immer zweistellig sein. Um \ zu erhalten ist auch die Eingabe von \\ möglich. In der Eingabezeile steht eine Hilfsfunktion zur Eingabe von Hex-Werten zur Verfügung.

Beispiel: \x09 (Erwartet ein Tabulator-Zeichen)
Datenblock: Binärdaten (in Hexform)
Erwartet Daten in Binärform. Der Hexwert FF80FF würde also drei Bytes (255,128,255) als Antwort erwarten.
Datenblock: K.-Objekt als Klartext
Erwartet einen Wert als Klartext. Der empfangene Wert wird in ein Kommunikationsobjekt geschrieben.
Hinweis: Enthält der Wert vor oder nach dem Text Leerzeichen, Tabulatoren oder Zeilenumbrüche werden diese abgeschnitten.
Hinweis: Negative Werte werden nur erkannt, wenn das Minuszeichen direkt vor der Zahl steht.
Kommunikationsobjekt
In dieses K.-Objekt wird der erhaltene Wert geschrieben
Zahlenformat
Legt fest, in welchem Zahlenformat die Daten empfangen werden. Folgende Formate sind möglich:
Hinweis: Numerische Werte enden, sobald ein alphanumerisches Zeichen im Datenblock vorkommt. Beispiel: Enthält der Datenblock den Wert 14.5°C, wird der numerische Wert bis zum Zeichen ° erkannt, hier also 14.5.
Datenblock: K.-Objekt als Binärdaten
Erwartet einen Wert als Binärdaten. Der empfangenen Wert wird in ein Kommunikationsobjekt geschrieben. Der erwartete Wert kann in folgenden Datenformaten definiert werden:
- 1 Byte (0..255)
- 1 Byte (-128..127)
- 2 Byte (0..65535)
- 2 Byte (-32768..32767)
- 4 Byte (-2147483648..2147483647)
- 4 Byte (0..4294967295)
- 4 Byte Fließkomma
- 8 Byte Fließkomma
Datenblock: Text aus vordefinierter Liste
Erwartet einen Text aus einer definerten Auswahlliste. Im nachfolgenden Feld wird die Zuordnung Text zu Wert vorgenommen. Hierzu ist eine entsprechende Schreibweise einzuhalten.
Kommunikationsobjekt
In dieses K.-Objekt wird der durch den empfangenen Text gesteuerte Wert geschrieben.
Liste
Generelle Schreibweise:
Text=Wert

Beispiel:
Regnerisch=0
Heiter bis wolkig=1
Sonnig=2
Undefiniert=4

Jede Text-Wert-Kombination muss in einer eigenen Zeile stehen. Bei der Auswertung der definierten Liste sind Teiltreffer möglich. Enthält das Telegramm bspw. den Text Norden, in der Liste ist aber nur der Text Nord definert und nicht der Wert Norden, dann wird der Text Norden als Treffer akzeptiert. Der Wert des ersten gefundenen Treffers wird verwendet. Groß-/Kleinschreibung ist zu beachten. Wenn der Text keinem Text in der Liste entspricht, bekommt das K.-Objekt den Wert 0.
Datenblock: Text/Wert mit fester Länge
Erwartet einen n-Zeichen langen Wert als Klartext. Der empfangene Wert wird in ein Kommunikationsobjekt geschrieben.
Hinweis: Enthält der Wert vor oder nach dem Text Leerzeichen, Tabulatoren oder Zeilenumbrüche, werden diese abgeschnitten.
Daten umwandeln
Die nachfolgenden Felder sind abhängig vom eingestellten Typ des Datenblocks.
URL-Quoting anwenden
Ja: Der Datenblock wird gemäß des HTTP-Standards kodiert. Beispiel: Aus dem Text Heiter%20bis%20wolkig wird dann Heiter bis wolkig
Nein: Der Text wird unbehandelt verarbeitet.
Umwandlungstabelle anwenden
Ja: Wandelt die Daten vor der Verarbeitung anhand der definierten Umwandlungstabelle um.
Nein: Die Daten werden unbehandelt weiter verarbeitet.
Daten nach Null-Byte abschneiden
Ja: Enthält der Datenblock ein Null-Byte, werden alle hinter dem Null-Byte liegenden Daten abgeschnitten.
Nein: Die Daten werden unbehandelt weiterverarbeitet.