Composant HTTP

Le composant HTTP ressemble au composant SOAP, sauf que vous ne devez pas spécifier un fichier WSDL dans le premier. Bien qu'il s'agisse d'une requête HTTP, n'importe quelle page web peut renvoyer les données. Les données renvoyées peuvent être un fichier XML, un fichier texte (plat) ou une page HTML. Comme le composant SOAP, le composant HTML peut nécessiter des valeurs pour les paramètres d'entrée et sortir ses propres valeurs en fonction du type de sortie (XML, TXT ou HTML). La variable réservée RESPONSE contiendra toujours la réponse complète (TXT/HTML/XML) du service HTTP.

Le composant HTTP peut être utilisé pour tout appel vers n'importe quelle page. Les paramètres d'entrée peuvent être envoyés avec la requête HTTP. Les paramètres de sortie peuvent être livrés.

Voici, à titre d'exercice, un Journey très simple qui utilise une page test W3Schools : http://www.w3schools.com/jquery/demo_test_post.asp. Cette page a été créée pour faire un test POST jQuery (http://www.w3schools.com/jquery/tryit.asp?filename=tryjquery_ajax_post), mais nous l'utiliserons pour tester les valeurs POST et voir ce qui sera renvoyé.
L'URL de la page est http://www.w3schools.com/jquery/demo_test_post.asp et les paramètres POST d'entrée sont le nom et la ville.  Dans le Journey, nous avons créé un formulaire « Service HTTP - Recherche » avec les champs d'entrée NAME et CITY. Les valeurs envoyées @NAME et @CITY sont utilisées pour les paramètres d'entrée « Nom » et « Ville » du service HTTP.
Une page de résultats est renvoyée. Nous l'utilisons comme valeur de sortie @HTML pour afficher toute la page de résultats (HTML) sur la deuxième page du Journey (~@HTML~ dans Editor).









 

Événements

Le composant HTTP déclenche deux événements : OnSucces et OnFailed :

  • OnSucces : lorsque l'appel a réussi.
  • OnFailed : lorsque l'appel a échoué.

 

Propriétés

Général

  1. Saisissez un nom et une description pour le composant. Ces informations s'affichent sur le canevas du Journey.
  2. Saisissez une adresse URL valide pour la requête HTTP.
  3. Sélectionnez le type de requête à utiliser pour les paramètres d'entrée : GET ou POST (GET signifie que les paramètres sont ajoutés dans l'URL. POST signifie que les paramètres sont ajoutés dans la page).
  4. Sélectionnez une valeur pour le champ Réponse. Vous pouvez choisir entre les types de renvoi suivants :
  • Paramètres XML

XML :
                <XML>
                                <FIELD1>value1</ FIELD1>
                                <FIELD2>value2</FIELD2>
                                <FIELD3>value3</FIELD3>
                </XML>

  • Paramètres texte

Texte :
FIELD1:value1
FIELD2:value2
FIELD3:value3

  • Contenu HTML

HTML :
Seule la variable RESPONSE est renvoyée. Elle contient le code HTML complet.

 

Paramètres d'entrée

Saisissez manuellement les paramètres d'entrée. Ces paramètres sont utilisés par la requête HTTP.  Ces valeurs peuvent être des valeurs de chaîne ou numériques, des valeurs récupérées dans la liste d'audience ou ses profils étendus, des variables système ou des valeurs récupérées dans un formulaire.

  • des valeurs publiées issues d'un formulaire. Exemple : @FIRSTNAME.
  • Valeurs de la liste
  • Valeurs numériques et de chaîne. Pour les valeurs de chaîne, utilisez des guillemets simples, par exemple 'Spring20'.
  • Variables système. Exemple : SYSTEM.CAMPAIGNID.
  • Fonctions. Exemple : GETDATE() pour récupérer la date du jour.
  • Combinaisons. Exemple : IF(@VALUE=1,1,OPTIN). Si une valeur publiée est égale à 1, transmettez 1, autrement prenez la valeur du champ OPTIN.

 

Paramètres de sortie

Les paramètres de sortie doivent être saisis manuellement. Ce sont les paramètres qui sont renvoyés par la requête HTTP. Le paramètre RESPONSE contient la réponse complète (code XML, texte ou HTML complet).

 

Retour à Composants