Nœud Requête

Le nœud de requête dispose d'un terminal de requête d'entrée unique et d'un terminal de réponse de sortie unique. De même, pour le nœud source, elle permet d'extraire des données d'une source de données. Le nœud de requête diffère du nœud source, car il accepte les données d'entrée d'une requête. Ces données d'entrée peuvent influencer ou déterminer les données extraites de la source de données. La capacité du nœud de requête à accepter l'entrée de requête est un moyen d'introduire des requêtes dynamiques dans l'exécution d'un flux.

Le nœud de requête est analogue à un nœud de mappe qui utilise la fonction GET.

GET("adapter-alias", "command-line", request-data)

A l'aide de la fonction GET dans les mappes, le nœud de requête prend en charge divers types de source de données.

Comme pour les nœuds source et cible, les catégories de paramètres du nœud de requête sont Connexion, Propriétés d'action et Schéma. La catégorie Connexion permet d'utiliser une connexion ou une ligne de commande existante. Lorsqu'une ligne de commande est utilisée, le type de source de données du nœud de demande doit être choisi. La syntaxe et la signification de la valeur de ligne de commande dépendent du type de source de données. Les options disponibles pour la catégorie Propriétés d'action varient en fonction du type de source de données.

Les transactions sont engagées au niveau du nœud si les données ont été extraites ou modifiées avec succès (l'opération GET de l'adaptateur a abouti).

Exemples de cas d'utilisation :

  • API REST où PUT ou POST requiert un corps et où une réponse est renvoyée dans la réponse HTTP.
  • Un appel BAPI SAP possède des paramètres d'entrée et une réponse à l'appel BAPI.
  • Convertisseur qui convertit les données d'une forme en une autre (par exemple, adaptateur SOAP).
  • Un adaptateur de chiffrement chiffre ou déchiffre les données demandées.

Processus de création d'un nœud de requête

Le nœud de requête peut être placé en tant que premier nœud, dernier nœud ou entre deux autres nœuds sur la zone de conception.

Les paramètres de nœud sont les suivants :

  • Connexion : choisissez une connexion existante ou sélectionnez "Utiliser la ligne de commande" pour spécifier l'adaptateur et sa ligne de commande.
  • Définissez des actions de succès et d'échec.
  • Choisissez de préférence un schéma qui définit les données du nœud.

Journalisation

Le nœud génère un journal composé des messages internes du nœud et des messages générés par l'adaptateur sous-jacent. Les messages de l'adaptateur sont le préfixe avec le nom de l'adaptateur. Le niveau de détails dépend du niveau de journal d'exécution du flux.

L'exemple de journal peut ressembler à ce qui suit (sous réserve de modification) :

0 : Appelé l'adaptateur EXCEL.

1 : La ligne de commande de l'adaptateur était : -WRKSHEET invoice1

2 : La valeur success_action de l'adaptateur a été définie sur : créer

3 : La valeur failure_action de l'adaptateur a été définie sur : validation

4 : EXCEL : Feuille de calcul | invoice1

5 : EXCEL : Format Excel | false

6 : EXCEL : Fichier de trace | __memory__

 7 : EXCEL : Ajout de trace | true

8 : EXCEL : Erreur de trace | false

9 : EXCEL : Prolixe trace | false

10 : EXCEL : Données de document Excel transmises en tant que paramètre GET à partir de la mappe

11: EXCEL : Lecture des données de document Excel à partir de la feuille de calcul…

12: EXCEL : Nombre total de lignes dans le document Excel : 5

13: EXCEL : Les données de document Excel ont bien été transmises à la mappe !

14: L'adaptateur EXCEL a effectué l'opération de validation.

15: EXCEL a extrait 193 octets.