Bloc de données (réception) - Télégramme simple
Sommaire
Un bloc de données reçu peut contenir les données suivantes:
- Nombre quelconque de données
- Nombre fixe de données
- Texte
- Données binaires
- Objet comm. texte en clair
- Objet comm. en données binaires
- Texte d'une liste prédéfinie
- Texte/valeur de longueur fixe

1.Bloc de données : Nombre quelconque de données

La réponse contient un nombre quelconque de données, qui ne doivent pas être traitées. Ceci doit être suivi d'un "texte" ou de données binaires. Si vous utilisez ce symbole, les données de cette section ne sont pas traitées.

2.Bloc de données : Nombre fixe de données

Attend dans la réponse un nombre fixe de données. La longueur respective doit être définie.

3.Bloc de données : Texte

Attend un texte. Un Carriage Return (CR) et/ou un Line Feed (LF) peuvent être accrochés en option au texte. Le texte peut également contenir des caractères spéciaux sous la forme de valeurs hexadécimales. Les caractères spéciaux sont saisis sous la forme \x??, la valeur hexadécimale commence par \x et doit toujours comporter deux caractères. Pour obtenir \, l'introduction de \\ est également possible. La ligne d'introduction met aussi à disposition une fonction auxiliaire pour l'entrée de valeurs hexadécimales.

Exemple : \x09 (attend un caractère de tabulation)

4.Bloc de données : Données binaires (sous forme hex)

Attend des données sous forme binaire. La valeur hex FF80FF, par exemple, attend donc trois octets (255,128,255) comme réponse.

5.Bloc de données : Objet de communication en texte clair

Attend une valeur en texte clair. La valeur reçue est écrite dans un objet de communication.
Remarque
Si la valeur contient des espaces, des tabulateurs ou des sauts de ligne avant ou après le texte, ceux-ci sont supprimés.
Remarque
Les valeurs négatives sont reconnues seulement si le signe moins se trouve directement devant le nombre.

5.1.Objet de communication

La valeur reçue est écrite dans cet objet de communication

Format numérique

Définit le format numérique dans lequel les données sont reçues. Les formats suivants sont disponibles :
  • Standard
    Les données sont disponibles « normalement ». Le symbole décimal attendu est le point, la valeur peut être précédée d'un signe plus/moins.
  • #
    Une valeur entière est attendue.
    Exemple : si le bloc de données contient la valeur 1234.56, l'objet de communication prend la valeur 1234.
  • #,###
    Une valeur entière est attendue, avec une virgule comme séparateur de milliers.
    Exemple : si le bloc de données contient la valeur 1,234.56, l'objet de communication prend la valeur 1234.
  • #.###
    Une valeur entière est attendue, avec un point comme séparateur de milliers.
    Si le bloc de données contient la valeur 1.234,56, l'objet de communication prend la valeur 1234.
  • #.#
    Une valeur à virgule flottante est attendue, avec un point comme symbole décimal.
    Exemple : si le bloc de données contient la valeur 1234.56, l'objet de communication prend la valeur 1234.56.
  • #,#
    Une valeur à virgule flottante est attendue, avec une virgule comme séparateur décimal.
    Exemple : si le bloc de données contient la valeur 1234,56, l'objet de communication prend la valeur 1234.56.
  • #,###.#
    Une valeur à virgule flottante est attendue, avec une virgule comme séparateur des milliers et un point comme symbole décimal.
    Exemple : si le bloc de données contient la valeur 1,234.56, l'objet de communication prend la valeur 1234.56.
  • #.###,#
    Une valeur en virgule flottante est attendue, avec un point comme séparateur des milliers et une virgule comme symbole décimal.
    Exemple : si le bloc de données contient la valeur 1.234,56, l'objet de communication prend la valeur 1234.56.
Remarque
Les valeurs numériques se terminent dès qu'un caractère alphanumérique apparaît dans le bloc de données. Exemple : si le bloc de données contient la valeur 14.5°C, la valeur numérique est reconnue jusqu'au caractère °, donc 14.5 ici.

6.Bloc de données : Objet de communication en données binaire

Attend une valeur sous forme de données binaires. La valeur reçue est écrite dans un objet de communication. La valeur attendue peut être définie dans les formats de données suivants :
- 1 octet (0..255)
- 1 octet (-128..127)
- 2 octets (0..65535)
- 2 octets (-32768..32767)
- 4 octets (-2147483648..2147483647)
- 4 octets (0..4294967295)
- 4 octets virgule flottante
- 8 octets virgule flottante

7.Bloc de données : Texte d'une liste prédéfinie

Attend un texte issu d'une liste de sélection définie. L'affectation du texte à la valeur a lieu dans le champ suivant. Il convient de respecter une notation appropriée.

7.1.Objet de communication

La valeur commandée par le texte reçu est écrite dans cet objet de communication.

Liste

Notation générale :
Texte=valeur

Exemple :
Pluvieux=0
Dégagé à nuageux=1
Ensoleillé=2
Indéfini=4

Chaque combinaison texte-valeur doit se trouver dans sa propre ligne. L'évaluation de la liste définie permet des correspondances partielles. Si le télégramme contient p. ex. le texte du nord, mais que seul nord est défini dans la liste, mais pas la valeur du nord, le texte du nord est accepté comme étant une correspondance. La valeur de la première correspondance trouvée est utilisée. Il convient de respecter la casse. Si le texte ne correspond à aucun texte de la liste, l'objet de communication prend la valeur 0.

8.Bloc de données : Texte/valeur de longueur fixe

Attend une valeur en texte clair d'une longueur de n caractères. La valeur reçue est écrite dans un objet de communication.
Remarque
Si la valeur contient des espaces, des tabulations ou des sauts de ligne avant ou après le texte, ceux-ci sont supprimés.

Conversion de données

Les champs suivants dépendent du type réglé pour le bloc de données.

8.1.Utiliser la citation d'URL

Oui : le bloc de données est codé selon la norme HTTP. Exemple : le texte Dégagé%20à%20nuageux devient alors Dégagé à nuageux
Non : le texte est utilisé sans être modifié.

8.2.Utiliser un tableau de conversion

Oui : convertit les données avant le traitement à l'aide du tableau de conversion défini.
Non : les données sont utilisées sans être modifiées.

8.3.Découper données après l'octet nul

Oui : si le bloc de données contient un octet nul, toutes les données situées après l'octet nul sont supprimées.
Non : les données sont utilisées sans être modifiées.