Composant Service SOAP
Le composant Service SOAP permet de communiquer avec des services SOAP externes (service web). Ces services peuvent servir à consulter des bases de données externes, à demander une vérification ou une authentification externe et à faire référence à des sources de contenu externes. Le service SOAP externe peut nécessiter des valeurs pour les paramètres d'entrée et sortir ses propres valeurs. Les valeurs de sortie renvoyées par ces services externes sont mémorisées et peuvent être utilisées à l'étape suivante du Journey.
Voici, à titre d'exercice, un Journey très simple qui utilise le service SOAP tempconvert.asmx de W3School (http://www.w3schools.com/webservices/tempconvert.asmx). Ce service SOAP a deux méthodes de conversion : Celsius en Fahrenheit et vice-versa. Nous utiliserons la méthode « Celsius en Fahrenheit ». La première page du Journey est un simple formulaire dans lequel vous pouvez saisir une température en Fahrenheit.
Cette valeur publiée @FAHR sert de valeur pour le paramètre d'entrée « Fahrenheit » du service SOAP.
Le service renvoie le résultat de ses calculs sous forme de «FahrenheitToCelsiusResult ». Nous l'utilisons comme valeur de sortie @CELSIUS pour afficher le résultat sur la deuxième page du Journey (~@CELSIUS~ dans Editor).
Événements
Le composant Service SOAP déclenche deux types d'événement :
- OnSuccess : si l'opération réussit, le composant suivant du Journey sera activé.
- OnFailed : si l'opération échoue, le composant suivant du Journey ne sera pas activé.
Propriétés
Général
1. Saisissez un nom et une description pour le composant. Ces informations s'afficheront sur le canevas.
2. Saisissez l'emplacement et le nom du fichier WSDL. Cliquez sur le bouton [...] situé à côté du champ pour rechercher l'emplacement du fichier. (Le fichier WSDL contient la description du service web.)
3. Cliquez sur « Charger ». Le chargement du fichier WSDL permet de récupérer les informations issues de ce fichier et de les utiliser par la suite.
4. Le champ « Opération » affichera une liste des opérations (méthodes) qui peuvent être exécutées sur le service sélectionné. Sélectionnez une de ces opérations (par exemple Copier, Mettre à jour, GetMaster, etc.).
5. Saisissez le nom du serveur où le service se trouve.
6. Dans la section « Authentification », vous pouvez choisir :
- un identifiant et un mot de passe pour l'authentification de base ;
- un certificat client. Dans ce cas, les certificats clients doivent être installés.
Paramètres d'entrée
Selligent détecte les paramètres à transmettre au service. Tous les paramètres trouvés s'affichent ici. Il suffit de saisir les valeurs qui doivent être transmises pour chacun de ces paramètres d'entrée. 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.
- 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'.
-
- 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
La liste des paramètres de sortie est détectée automatiquement au moment du chargement du fichier WSDL. Saisissez les valeurs qui doivent être affectées à ces paramètres de sortie.
