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

Créez une table de jeux d’importation de services Web pour définir comment transférer et 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 vers laquelle vous souhaitez que les données se transforment. Une fois le bouton Créer sélectionné, le service Web est créé et vous êtes immédiatement placé dans 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 suppression 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 jeu d’importation de services web.

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

Mappage 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 le mode de jeu d’importation est défini sur « Synchrone » (la valeur par défaut).

L’image suivante est un exemple de la carte de transformation associée au jeu d’importation de 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 variables peuvent modifier les valeurs de réponse du service Web. En plus des variables normales disponibles dans un script de carte de transformation, le tableau 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 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 génère la réponse suivante vers 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 créée, définissez-la sur vrai pour que toutes les demandes SOAP soient journalisées dans le journal système. Définissez-le sur faux lorsque vous avez terminé de conserver la taille de votre journal système à une longueur gérée.