Création d’un service Web de jeu d’importation

Créez une table de jeux d’importation de service Web pour définir la façon de préparer et de transformer les données importées.

Accédez à la Tous > Services web du système > Entrant > Créer.

Figure 1. Créer un service web

Le nom du service Web est le nom de table de la table de jeux d’importation, tandis que le champ Étiquette est le champ de table résultant.

Si vous souhaitez créer une carte de transformation après avoir créé le service Web, cochez la case Créer une carte de transformation et choisissez la table cible dans laquelle vous souhaitez transformer les données. Une fois le bouton Créer sélectionné, le service Web est créé et vous serez immédiatement redirigé vers le formulaire Carte de transformation de table . Vous pouvez ensuite continuer à spécifier la carte ou le script de transformation.

Champs de service Web

Les champs disponibles pour ce service Web. Par défaut, tous les champs sont publiés en tant que type XSD de xsd :string. Le nom est le champ qui est exposé pour le service Web et apparaît donc comme le nom du champ dans le WSDL. L’étiquette est l’étiquette du champ tel qu’il apparaît pour la table des jeux d’importation.

Vous pouvez ajouter, marquer pour supprimer ou modifier (double-cliquez sur le champ) un champ de service Web existant dans cette liste.

Remarque :

Après avoir ajouté des champs de service Web, cliquez sur Créer pour créer la table de jeux d’importation de service Web.

Pour ajouter d’autres champs après la création du service Web, recherchez la table cible, puis ajoutez les champs à cette table.

Mapper des jeux d’importation de services Web

Lors de la création du jeu d’importation du service Web, vous pouvez éventuellement créer la carte de transformation correspondante.

Toutes les cartes de transformation sont exécutées pour le service lorsqu’il est invoqué et que le mode de jeu d’importation est défini sur « Synchrone » (par défaut).

L’image suivante est un exemple de carte de transformation associée au jeu d’importation Notification Web Service.

Figure 2. Carte de transformation de notification

Ajout de valeurs de réponse de service Web

Dans le script de carte de transformation associé à un jeu d’importation de service Web, certaines valeurs variables peuvent modifier les valeurs de réponse du service Web. En plus des variables normales disponibles dans un script de carte de transformation, la table documente les variables disponibles et leurs effets.

Tableau 1. Ajout de valeurs de réponse de service Web

Nom de variable	Type	Description
response	Objet de sortie	Objet JavaScript contenant des éléments de réponse créés dynamiquement et utilisés pour personnaliser la réponse de sortie d’une insertion de jeu d’importation de service Web.

Exemple

// create new elements called "transaction_id" 
// and "hello" in the web service response
response.transaction_id="abc123";
response.hello="world";
 
status_message="message 1";
// this is the normal status_message variable

L’exemple d’extrait de code entraîne la génération de la réponse suivante au consommateur de service web

<soapenv:Envelopexmlns:imp="http://www.service-now.com/imp_notification"                  
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header/><soapenv:Body>
<insertResponse xmlns="http://www.service-now.com/imp_notification">
  <sys_id>969d157c0a0a0baf008ba5770ffa798c</sys_id>
  <table>incident</table>
  <display_name>number</display_name>
  <display_value>INC0010091</display_value>
  <status>inserted</status>
  <status_message>message 1</status_message>
  <transaction_id>abc123</transaction_id>
  <hello>world</hello>
</insertResponse>
</soapenv:Body></soapenv:Envelope>

Débogage des jeux d’importation de services Web

Pour déboguer une demande SOAP entrant dans le système, créez la propriété système glide.processor.debug.SOAPProcessor.

Une fois que vous l’avez créé, définissez-le sur true pour que toutes les demandes SOAP soient consignées dans le journal système. Définissez-la sur false lorsque vous avez terminé de conserver la taille de votre journal système à une longueur gérée.