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

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

Accédez à la Tout > 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 jeu 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 la création du service Web, cochez la case Créer unecarte 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 de transformation ou le script.

Champs de service web

Les champs disponibles pour ce service web. Par défaut, tous les champs sont publiés sous le 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 telle qu’elle apparaît pour la table des ensembles 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.

Jeux d’importation de services Web de mappage

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

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 » (valeur par défaut).

L’image suivante est un exemple de carte de transformation associée au jeu d’importation du service Web de notification.

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 de 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
réponse	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’un insert 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 pour le 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-le sur false lorsque vous avez terminé de maintenir la taille de votre journal système à une longueur gérée.