Experte - 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

1.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.

2.Datenblock: Feste Anzahl an Daten

Erwartet in der Antwort eine feste Anzahl an Daten. Die jeweilige Länge muß festgelegt werden.

3.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)

4.Datenblock: Binärdaten (in Hexform)

Erwartet Daten in Binärform. Der Hexwert FF80FF würde also drei Bytes (255,128,255) als Antwort erwarten.

5.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.

5.1.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:

Standard
Die Daten liegen "normal" vor. Als Dezimaltrenner wird ein Punkt erwartet, der Wert kann mit einem Minus-/Plus-Zeichen eingeleitet werden.
#
Es wird ein ganzzahliger Wert erwartet.
Beispiel: Enthält der Datenblock den Wert 1234.56, erhält das K.-Objekt den Wert 1234.
#,###
Es wird ein ganzzahliger Wert mit Komma als Tausendertrenner erwartet.
Beispiel: Enthält der Datenblock den Wert 1,234.56, erhält das K.-Objekt den Wert 1234.
#.###
Es wird ein ganzzahliger Wert mit Punkt als Tausendertrenner erwartet.
Beispiel: Enthält der Datenblock den Wert 1.234,56, erhält das K.-Objekt den Wert 1234.
#.#
Es wird ein Fließkomma-Wert mit Punkt als Dezimaltrenner erwartet.
Beispiel: Entählt der Datenblock den Wert 1234.56, erhält das K.-Objekt den Wert 1234.56.
#,#
Es wird ein Fließkomma-Wert mit Komma als Dezimaltrenner erwartet.
Beispiel: Entählt der Datenblock den Wert 1234,56, erhält das K.-Objekt den Wert 1234.56.
#,###.#
Es wird ein Fließkomma-Wert mit Komma als Tausendertrenner und Punkt als Dezimaltrenner erwartet.
Beispiel: Entählt der Datenblock den Wert 1,234.56, erhält das K.-Objekt den Wert 1234.56.
#.###,#
Es wird ein Fließkomma-Wert mit Punkt als Tausendertrenner und Komma als Dezimaltrenner erwartet.
Beispiel: Entählt der Datenblock den Wert 1.234,56, erhält das K.-Objekt den Wert 1234.56.

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.

6.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

7.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.

7.1.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.

8.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.

8.1.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.

8.2.Umwandlungstabelle anwenden

Ja: Wandelt die Daten vor der Verarbeitung anhand der definierten Umwandlungstabelle um.
Nein: Die Daten werden unbehandelt weiter verarbeitet.

8.3.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.