Validation d'adresse avec intégration Spectrum OnDemand (SPOD) - Automate_Studio_Manager - Automate_Evolve - Latest

Implémenter le service SPOD avec les solutions Evolve

Pour implémenter un service SPOD avec les solutions Evolve, procédez comme suit.

1. Facultatif : testez l'appel d'API dans un outil de test d'API, tel que Postman, pour vous assurer qu'il répond à vos besoins et pour voir la structure de sortie JSON.
2. Créez une connexion de données API REST dans Evolve > Connexions, qui peut être ensuite référencées dans les solutions Evolve :

   1. Choisissez le type de connexion : Rest API.

   2. Ajoutez l'URL du site SPOD, par exemple, https://prestaging.spectrum.precisely.com/resthttps://prestaging.spectrum.precisely.com/rest

   3. Choisissez Authentification : De base.

   4. Entrez les informations d'identification SPOD.

   5. Choisissez le type de format de date : ISO.

   6. Cochez la case S'applique à Composer.

   7. Cliquez sur Enregistrer

      Remarque :

      Des connexions de données peuvent être définies pour les différents sites SPOD, tels que Transfert, QA et Production.

3. Ajoutez une connexion de données dans Composer.

   1. Entrez un nom de connexion.

   2. Choisissez Type : API Rest.

   3. Sélectionnez la connexion de données SPOD que vous avez créée dans Evolve.

   4. Par défaut, l'URL est celle que vous avez entrée dans la connexion de données.

   5. Choisissez l'opération HTTP GET pour la validation de l'adresse.

   6. Complétez l'URL dans le générateur d'URL en ajoutant

   Le nom du service SPOD et la spécification des résultats à renvoyer en JSON, par exemple, /ValidateMailingAddressPremium/results.json

4. - Paramètres d'entrée pour le service de validation d'adresse

   &Data.AddressLine1=[/my:myFields/my:BP_Address_Addr1]

   • Le paramètre d'entrée est Data.AddressLine1

   • Utilisez la valeur dans le champ de formulaire BP_Address_Addr1 comme valeur

   Utilisez le générateur d'expression pour faciliter la sélection d'un champ de solution/de formulaire comme valeur.

   - Exemple d'URL complète :

   https://staging.spectrum.precisely.com/rest/ ValidateMailingAddressPremium/results.json?

   &Data.AddressLine1=[/my:myFields/my:BP_Address_Addr1]

   &Data.AddressLine2=[/my:myFields/my:BP_Address_Addr2]

   &Data.City=[/my:myFields/my:BP_Address_City]

   &Data.StateProvince=[/my:myFields/my:BP_Address_State]

   &Data.PostalCode=[/my:myFields/my:BP_Address_Zip]

   &Data.Country=[/my:myFields/my:BP_Address_CountryCode]

5. Les sorties doivent être spécifiées dans le schéma de sortie de l'API. Selon le service que vous sélectionnez, il peut exister un nombre différent de champs de sortie possibles. Exemple :

       { 		"Output": [ 			{ 					"AddressLine1": "string", 					"AddressLine2": "string", 					"AddressLine3": "string", 					"City": "string", 					"StateProvince": "string", 			    	"PostalCode": "string", 				    "Country": "string", 					"HouseNumber": "string", 					“Status” : ”string”, 					"StatusCode": "string", 					"StatusDescription": "string", 					"Confidence": "integer", 			 } 		  ] 		}			

6. Les champs de formulaire peuvent être créés avec n'importe quelle connexion de données Composer. Ils seront les champs de sortie de votre service SPOD.
7. Mappez les champs au formulaire.

   1. Champs de saisie - Les champs de saisie peuvent varier en fonction du service SPOD que vous avez sélectionné. Ligne d'adresse 1, Ligne d'adresse 2, Ville, Région Code postal et Pays sont des exemples de champs. Ils seront utilisés dans le générateur d'URL pour que la connexion de données transmette les entrées. Vous pouvez utiliser l'élément d'adresse ou d'autres champs de formulaire qui contiennent les valeurs d'entrée à transmettre au service Web de validation d'adresse SPOD.

   2. Champs de sortie - Pour créer les champs de formulaire pour le service SPOD, cliquez avec le bouton droit sur la connexion de données et sélectionnez les champs requis. Le service SPOD générera les champs de sortie en fonction du schéma de sortie de l'API utilisé. Les résultats correspondent à du contenu répétitif, qu'il s'agisse d'une adresse unique ou de plusieurs adresses. Mappez-les selon vos besoins dans le formulaire. Le contenu répétitif, qui sera des suggestions/corrections d'adresses peut être mappé à une table extensible ou sélectionnable.

8. Ajoutez un contrôle de service Web à votre formulaire et mappez-le au service Web SPOD. Ajoutez un bouton ou une règle pour déclencher le service Web.
9. Déployez et testez une solution.