Mode jeu d’importation de service Web

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 4 minutes de lecture

    • 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 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 aura également un état de chargement par défaut. Par défaut, tous les jeux d’importation synchrones sont automatiquement modifiés pour passer à l’état 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 modeAsynchrone et en état de chargement a pour effet de ne pas transformer les données entrantes au fur et à mesure qu’elles sont insérées, 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 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 du 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 s’effectuer de manière planifiée ou manuelle.
    Synchrones Chargement La transformation des données se produit automatiquement et immédiatement chaque fois que des données sont insérées dans la ligne du jeu d’importation associée.
    Synchrones Chargé Lorsque de nouvelles données sont insérées dans ce jeu d’importation associé, un nouveau jeu d’importation de mode Synchrone et d’état Chargement 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 du 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 en série de la table source en table cible (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 services Web dans une table de jeu d’importation spécifique. Si la valeur est vraie, cette propriété empêche les insertions simultanées identiques de créer des enregistrements en double en sérialisant les opérations d’insertion dans la 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 du jeu d’importation de service Web.

    Remarque :
    La définition de 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 des fonctionnalités équivalentes à 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 Sys_id de l’enregistrement résultant qui a été créé ou modifié
    table Nom de la table qui a été affectée. Dans le cas d’un appel asynchrone, le nom de table serait la table de jeux d’importation, par exemple. imp_notification de la table des jeux d’importation de services 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 Nombre et un exemple de valeur serait INC10001
    statut Valeur de chaîne qui indique l’action qui s’est produite à la suite de l’invocation du service Web, relative à l’enregistrement défini par les valeurs de champ sys_id et 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 (similaires à 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 du 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 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 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.