Mode de jeu d’importation de services Web

Lorsqu’un message SOAP insère un enregistrement dans une table de jeu d’importation et qu’il n’existe aucun jeu d’importation pour cette table à l’état de chargement , un nouveau jeu d’importation est créé avec le mode défini sur Synchrone.

Un jeu d’importation avec un modesynchrone transformera les données dès qu’il sera inséré (à condition que la carte de transformation existe déjà). Ce jeu d’importation présente également un état de chargement par défaut. Par défaut, tous les ensembles de données à importer synchrones seront automatiquement modifiés sur Traité à minuit. Par conséquent, lorsqu’une nouvelle insertion se produit dans la même table, un nouveau jeu d’importation synchrone est créé.

Figure 1. Jeu d’importation synchrone

La modification de ce jeu d’importation en mode Asynchrone et en étatde chargement a pour effet de ne pas transformer les données entrantes au fur et à mesure de leur insertion, mais plutôt de « charger » le jeu d’importation et de différer la transformation des données ultérieurement, manuellement ou avec une tâche de script planifiée.

Tableau 1. Mode de jeu d’importation

Mode	État	Fonction
Asynchrone	Chargement	La transformation des données ne se produit pas automatiquement et immédiatement. L’état des données ajoutées à la ligne de jeu d’importation est « En attente ». La transformation peut être planifiée ou exécutée manuellement lorsque l’état est défini sur Chargé
Asynchrone	Chargé	Marque la fin du chargement des données. La transformation des données peut désormais se faire de manière planifiée ou manuelle.
Synchrones	Chargement	La transformation des données se produit automatiquement et immédiatement chaque fois qu’elles sont insérées dans la ligne de jeu d’importation associée.
Synchrones	Chargé	Lorsque de nouvelles données sont insérées dans ce jeu d’importation associé, un nouvel ensemble d’importations des modes Synchrone et Chargement de l’état est créé. Changer l’état en Chargé est un moyen d’indiquer qu’un nouveau jeu d’importation synchrone doit être créé pour la prochaine insertion de ligne de jeu d’importation (et transformé immédiatement)

Contrôle du comportement d’insertion

Dans les jeux d’importation qui spécifient un ou plusieurs champs de fusion, les enregistrements avec une valeur de fusion correspondante sont transformés de la table source en table cible en série (un par un) pour éviter les doublons.

Dans les jeux d’importation qui ne spécifient aucun champ de fusion, les enregistrements sont transformés simultanément. Vous pouvez contrôler ce comportement à l’aide de la glide.import_set_insert_serialized_when_no_coalesce propriété.

La glide.import_set_insert_serialized.<table name> propriété système contrôle la façon dont l’instance insère les enregistrements des appels de service Web dans une table de jeu d’importation spécifique. Si vrai, cette propriété empêche des insertions simultanées identiques de créer des enregistrements en double en sérialisant les opérations d’insertion de base de données. Si une table cible n’a pas de champs de fusion définis dans une carte de transformation, définissez cette propriété sur faux pour améliorer les performances des jeux d’importation de services Web.

Remarque :

Définir cette propriété sur faux peut entraîner la création d’enregistrements en double.

Remarque :

La glide.soap.import_set_insert_serialized.<table name> propriété système fournit une fonctionnalité équivalente à glide.import_set_insert_serialized.<table name>, mais si les deux propriétés sont définies, glide.import_set_insert_serialized.<table name> elle glide.soap.import_set_insert_serialized.<table name>remplace .

Réponse SOAP standard

La réponse SOAP d’un appel d’insertion de jeu d’importation de service Web renvoie les valeurs standard suivantes.

<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"><SOAP-ENV:Body><insertResponse><sys_id>fa648f5f0a0a0b2b0048e7012448b8f1</sys_id><table>incident</table><display_name>number</display_name><display_value>INC10014</display_value><status>inserted</status></insertResponse></SOAP-ENV:Body></SOAP-ENV:Envelope>

Tableau 2. Réponse SOAP standard

Champ	Description
sys_id	Le Sys_id de l’enregistrement obtenu qui a été créé ou modifié
Table	Nom de table de la table qui a été affectée. Dans le cas d’un appel asynchrone, le nom de la table serait la table de l’ensemble d’importations, par exemple. imp_notification pour la table des ensembles de données à importer du service Web Notifications
display_name	Nom du champ défini comme champ d’affichage de l’enregistrement qui a été créé ou modifié
display_value	Valeur du champ désigné comme champ d’affichage. Par exemple, le champ d’affichage de la table Incident est le champ Numéro et une valeur d’exemple serait INC10001
état	Valeur de chaîne qui indique l’action qui s’est produite à la suite de l’invocation de service web, relative à l’enregistrement défini par les valeurs de champ sys_id et de table inséré : l’enregistrement a été inséré Mis à jour : l’enregistrement a été mis à jour Ignoré : l’entrée a été ignorée, l’enregistrement n’a pas été mis à jour et aucun nouvel enregistrement n’a été créé Ignoré : les données d’entrée ont été ignorées (comme ignorées) en raison de valeurs de fusion manquantes erreur : une erreur s’est produite lors du traitement de l’entrée
status_message	Cette valeur se traduit par la valeur trouvée dans le champ Commentaire de la ligne de jeu d’importation et contient généralement des informations relatives à la valeur d’état , par exemple. « Aucune valeur de champ modifiée » lorsque l’état est « ignoré ». Si vous définissez cette valeur sur une valeur de chaîne personnalisée, la réponse SOAP contiendra un champ status_message facultatif.
error_message	Le message associé à un état d’erreur. Lorsqu’une erreur se produit, la définition de cette valeur sur une valeur de chaîne personnalisée entraîne le retour d’un champ de error_message facultatif dans la réponse SOAP

Adaptation de la réponse SOAP

Il est possible d’inclure des informations autres que celles spécifiées dans le WSDL en écrasant le contenu de status_message à l’aide du script de transformation.