Mise en route de la synchronisation des processus distants

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 21 minutes de lecture
  • Apprenez les bases de la configuration d’une intégration de synchronisation de processus à distance afin de lier les processus automatisés entre deux instances ou plus ServiceNow® .

    Remarque :
    Hub d'intégration La synchronisation de Hub d'intégration processus à distance nécessite un abonnement au package Entreprise. Pour plus d'informations, consultez Demander le Hub d'intégration.

    Avant de commencer votre intégration de synchronisation de processus distants

    Avant de choisir Remote Process Sync comme cadre d'intégration, comparez-le aux autres solutions d'intégration Now Platform® multi-instances. Tandis que les solutions comme Instance Data Replication et le spoke Remote Instance prennent en charge les intégrations multi-instances simples, Remote Process Sync prend en charge les cas d'utilisation multi-instances plus complexes, en mettant l'accent sur l'intégration d'instances par des processus business de haut niveau.
    Remarque :
    Remote Process Sync remplace le spoke eBonding pour les instances d’intégration.
    Figure 1. Comparer Réplication de données d'instance, Remote Instance Spoke et Remote Process Sync
    La réplication de données d’instance et le spoke d’instance distante prennent en charge des intégrations simples pour une table entière ou à l’aide des API Now Platform. Remote Process Sync prend en charge des intégrations multi-instances plus complexes.
    Si vous choisissez d’utiliser Remote Process Sync comme infrastructure d’intégration multi-instances, l’étape suivante consiste à découvrir la différence entre :
    1. la création de votre intégration, et
    2. Gestion de votre intégration

    La création de votre intégration implique la création et la configuration d’une définition de synchronisation de processus et de ses enregistrements connexes. Pour plus d’informations sur la façon de démarrer la création de votre intégration de synchronisation de processus distante, suivez un exemple de procédure ou Créez votre première intégration de synchronisation de processus distantsdécouvrez les définitions de synchronisation de processus.

    Figure 2. Création de votre intégration de synchronisation des processus distants
    Création de votre intégration de synchronisation de processus distants.

    La gestion de votre intégration implique de surveiller les files d’attente sortantes et entrantes, et de rechercher des erreurs liées aux définitions de synchronisation des processus déclenchées. Pour plus d’informations sur la façon de surveiller et de vérifier les erreurs avec votre intégration de synchronisation de processus distants, consultez Files d’attente sortantes et files d’attente entrantes et Surveillance et résolution des problèmes liés à votre intégration. Vous pouvez également évaluer périodiquement les flux sortants et entrants qui s’exécutent automatiquement pour votre intégration et déterminer s’il convient d’apporter des changements à ces flux dans Studio de workflow.

    Remarque :
    La création et la gestion d’une intégration de synchronisation de processus à distance sur votre instance nécessite également une collaboration efficace avec les utilisateurs de l’instance distante ou des instances distantes. Assurez-vous de rencontrer régulièrement les personnes concernées impliquées dans votre intégration pour planifier, gérer et améliorer continuellement les processus business automatisés que votre intégration multi-instances gère.
    Figure 3. Gestion de votre intégration de synchronisation des processus distants
    Gestion de votre intégration de synchronisation des processus distants.

    Définitions de synchronisation des processus

    Une définition de synchronisation de processus contient toutes les configurations de votre intégration de synchronisation de processus distants. Commencez par créer un nouvel enregistrement de définition de synchronisation de processus pour votre intégration. Accédez à la Centre d'intégration > Synchronisation des processus distants > Définitions de synchronisation des processus, puis cliquez sur Nouveau. Dans le formulaire Définition de synchronisation de processus, renseignez les champs suivants :
    Champ Description
    Nom Entrez un nom qui décrit avec précision la partie de votre processus business gérée par votre instance. Par exemple, si les utilisateurs de votre instance travaillent pour répondre aux demandes de Catalogue de services pour vos clients, saisissez un nom tel que Exécution de la demande de Catalogue de services.
    Description Vous pouvez également décrire la partie de votre processus business que cette définition de synchronisation de processus gère.
    Application Défini automatiquement sur votre périmètre d’application actuel.
    Domaine Si votre processus se rapporte à un domaine spécifique, choisissez un domaine autre que global. Pour plus d’informations, consultez Séparation de domaine pour les fournisseurs de services.
    Cliquez sur Soumettre, puis vous pouvez voir votre nouvel enregistrement de définition de synchronisation de processus dans la liste. Sélectionnez ensuite l’enregistrement de définition de synchronisation de processus que vous venez de créer. Vous pouvez voir que votre enregistrement de définition de synchronisation de processus contient les listes connexes suivantes :
    • Définitions de captures
    • Événements de processus
    • Systèmes distants
    • Flux sortants
    • Flux entrants
    Reportez-vous aux sections suivantes pour savoir comment définir les configurations de chacun de ces éléments connexes.

    Définitions de captures

    Une définition de capture spécifie quand votre instance doit envoyer des données à une instance distante et quelles données votre instance doit envoyer. Une définition de capture contient les configurations du déclencheur et des champs capturés de votre définition de synchronisation de processus. Le déclencheur spécifie quelle opération d’enregistrement, telle que la création, la mise à jour ou la suppression d’un enregistrement, entraîne l’envoi de données par votre instance à une instance distante. Lorsqu’une définition de capture est déclenchée, elle crée un objet à partir d’un enregistrement source, qui contient des champs capturés. Ensuite, le flux sortant commence à s’exécuter et met en corrélation les champs capturés de l’enregistrement source avec les champs d’un enregistrement connexe sur le système distant.

    Un enregistrement de définition de capture comporte les champs suivants :

    Champ Description
    Événement de processus Dans le formulaire Définition de capture, utilisez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste) pour choisir l’enregistrement d’événement de processus que vous souhaitez associer à cette définition de capture. Si aucun événement de processus n’existe encore, entrez un nom pour votre événement de processus, et le système crée automatiquement un enregistrement d’événement de processus et l’associe à votre définition de capture. Pour plus d’informations, consultez Événements de processus.
    État Choisissez Actif pour activer cette définition de capture afin que la définition de synchronisation du processus parent se déclenche lorsque les conditions que vous définissez dans la section Déclencheur de ce formulaire sont remplies.
    Ordre Entrez une valeur pour l’ordre dans lequel vous souhaitez que votre définition de capture se déclenche par rapport aux autres définitions de capture. Les valeurs d’ordre inférieur sont honorées avant les valeurs d’ordre supérieur.
    Application Défini automatiquement sur votre périmètre d’application actuel.
    Domaine Si votre processus se rapporte à un domaine spécifique, choisissez un domaine autre que global. Pour plus d’informations, consultez Séparation de domaine pour les fournisseurs de services.

    Dans la section Déclencheur, choisissez une table source autorisée dont vous souhaitez activer les enregistrements pour votre définition de synchronisation de processus. Vous pouvez également ajouter des conditions de champ qui, lorsqu’elles sont réunies, entraînent le déclenchement de votre définition de synchronisation de processus. Lorsque les conditions sont remplies pour le déclencheur spécifié dans votre définition de capture, tous les flux sortants associés à votre définition de synchronisation de processus commencent à s’exécuter. Pour plus d’informations, consultez Flux sortants et flux entrants.

    Champ Description
    Nom de la table source Choisissez une table autorisée dont les enregistrements déclencheront votre définition de synchronisation de processus chaque fois que les enregistrements seront créés, mis à jour et supprimés.
    Filtre Utilisez le créateur de conditions pour ajouter des conditions qui, une fois remplies, déclencheront votre définition de synchronisation de processus. Par exemple, sélectionner [État] > [est] > [Travail en cours] entraîne le déclenchement de votre définition de synchronisation de processus à chaque fois qu’un enregistrement de l’état de la table que vous avez sélectionnée est mis à jour sur Travail en cours.

    Enfin, dans la section Capture, ajoutez à la liste Sélectionné les champs que vous souhaitez inclure dans la charge utile de votre flux sortant.

    Champ Description
    Inclure les champs Ajoutez à la liste sélectionnée les champs que vous souhaitez synchroniser avec les champs de l’instance distante chaque fois que votre définition de synchronisation de processus se déclenche. Utilisez l’icône Ajouter un élément (icône Ajouter un élément) pour ajouter des champs de la liste Disponible à la liste Sélectionné.
    Remarque :
    • Lorsque votre intégration s’exécute, la charge utile sortante envoyée aux instances distantes contient toujours ces champs capturés, qu’ils aient été mis à jour ou non.
    • Vous pouvez mapper ces champs capturés aux champs de l’instance distante en configurant les mappages dans le flux entrant de l’instance distante qui est associé au même événement de processus. Pour plus d'informations, consultez Flux sortants et fluxentrants.
    Inclure les pièces jointes Si cette option est sélectionnée, toutes les pièces jointes associées au déclenchement d’enregistrements sur votre instance locale seront synchronisées avec les pièces jointes des enregistrements corrélés sur l’instance distante. Pour plus d'informations, consultez
    Remarque :
    RPS capture les changements interactifs et non interactifs. Vous pouvez configurer RPS pour qu’il ignore les changements non interactifs, tels que les changements effectués via une tâche planifiée, en définissant la glide.hub.process.sync.capture.non_interactive.changes propriété sur false. Pour plus d’informations, consultez l’article Comment configurer le cadre de travail RPS (Remote Process Synchronization) pour ignorer les modifications non interactives apportées aux enregistrements [KB1565025] dans la Now Support base de connaissances.

    Traiter les événements

    Un événement de processus spécifie quelle partie de votre processus business commence dans votre instance locale et se termine dans l’instance distante. L’enregistrement de l’événement de processus dans votre instance locale et dans l’instance distante doit porter le même nom, car l’événement de processus désigne le lien entre ces instances qui leur permet de partager des parties du même processus business. Un enregistrement d’événement de processus comporte les champs suivants :

    Champ Description
    Nom Entrez un nom qui décrit la partie de votre processus business qui commence dans votre instance locale et se termine dans l’instance distante. Par exemple, si les utilisateurs de votre instance demandent un logiciel qui sera mis en service dans l’instance distante, vous pouvez nommer l’événement de processus : l’utilisateur demande un logiciel.
    Remarque :
    Un administrateur de l’instance distante, ou des instances distantes, doit également créer un événement de processus avec le même nom que celui que vous utilisez ici. La création de ces événements de processus dans des instances distinctes crée le lien logique qui vous permet d’intégrer des données entre plusieurs instances.
    Application Défini automatiquement sur votre périmètre d’application actuel.
    Domaine Si votre processus se rapporte à un domaine spécifique, choisissez un domaine autre que global. Pour plus d’informations, consultez Séparation de domaine pour les fournisseurs de services.

    Systèmes distants

    Un système distant contient les configurations des connexions sortantes et entrantes associées à une autre ServiceNow instance. Un enregistrement de système distant comporte les champs suivants :

    Champ Description
    Nom Entrez un nom décrivant l’instance distante. Par exemple, si l’instance est gérée par l’un de vos clients, le client A, saisissez l’instance du client A dans le champ de nom.
    Description Vous pouvez également entrer plus de détails décrivant l’objectif général de l’instance distante dans votre processus business.
    ID externe Entrez l’ID système de l’enregistrement du système distant qui partage le même événement de processus avec votre instance. Pour obtenir l’ID système d’un enregistrement, sélectionnez Copier sys_id dans le menu contextuel ( icône de menu contextuel) de la vue de formulaire de l’enregistrement. Par exemple, si votre intégration de synchronisation des processus distants s’étend sur deux instances, l’instance A et l’instance B, utilisez l’ID système de l’enregistrement du système distant de l’instance A comme ID externe dans l’instance B et vice-versa. La connexion des ID système et des ID externes de cette manière aide plusieurs instances à savoir à quelle instance se connecter quand les flux sortants et entrants automatisés s’exécutent.
    Application Défini automatiquement sur votre périmètre d’application actuel.
    Domaine Si votre processus se rapporte à un domaine spécifique, choisissez un domaine autre que global. Pour plus d’informations, consultez Séparation de domaine pour les fournisseurs de services.
    Flux secondaire d'erreur Sélectionnez l’icône Rechercher à l’aide de la liste (icône Rechercher à l’aide de la liste) pour rechercher et choisir un flux secondaire que vous souhaitez exécuter en cas d’échec de la connexion à l’instance distante. Le flux secondaire que vous sélectionnez s’exécutera chaque fois que votre instance locale ne pourra pas se connecter à l’instance distante après le déclenchement de votre définition de synchronisation de processus. Vous pouvez afficher les systèmes distants auxquels votre instance ne parvient pas à se connecter en accédant à Centre d'intégration > Synchronisation des processus distants > Systèmes distants – avec des erreurs.
    Alias de connexion Sélectionnez l’icône Rechercher à l’aide d’une liste ( icône Rechercher à l’aide d’une liste) pour rechercher et choisir un enregistrement d’alias de connexion et d’informations d’identification que vous souhaitez utiliser pour vous authentifier avec l’instance distante. Si vous n’avez pas encore configuré d’enregistrement d’alias de connexion et d’informations d’identification à cette fin, créez un nouvel enregistrement avec Connexion et informations d’identification dans le champ Type. Pour plus d’informations, consultez Créer un alias de connexion et d’informations d’identification.
    État sortant Défini sur Désactivé par défaut. Vous pouvez changer la valeur de ce champ en Actif en sélectionnant le lien connexe Valider et activer le système distant dans la vue de formulaire de cet enregistrement de système distant une fois que vous avez terminé de créer l’enregistrement.
    Utilisateur de l'API entrante Utilisateur pouvant se connecter à l’instance distante. Cet utilisateur doit avoir des informations d’identification qui correspondent à celles de l’utilisateur disposant du rôle ih_process_sync_api dans l’instance distante.
    Exécuter les flux entrants en tant que Sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste) pour trouver et choisir un utilisateur dont vous souhaitez exécuter le flux entrant pour l’événement de processus associé. Option que vous pouvez sélectionner pour spécifier que le flux s'exécute en tant qu'utilisateur système ou en tant qu'utilisateur qui initie la session. Sélectionnez l’utilisateur qui lance l’option de session lorsque les mises à jour doivent provenir de l’utilisateur qui a déclenché le flux. Par exemple, utilisez cette option si vous souhaitez que les commentaires sur l’enregistrement d’incident proviennent de l’utilisateur actuel ou si vous souhaitez que les e-mails d’approbation proviennent de l’approbateur. Les paramètres de l’option Exécuter en tant que dans un flux ne s’appliquent pas aux flux secondaires enfants.
    État entrant Défini sur Désactivé par défaut. Vous pouvez changer la valeur de ce champ en Actif en sélectionnant le lien connexe Valider et activer le système distant dans la vue de formulaire de cet enregistrement de système distant une fois que vous avez terminé de créer l’enregistrement.
    Remarque :
    Après avoir créé un enregistrement de système distant avec les champs appropriés renseignés, vous devez cliquer sur le lien connexe Valider et activer le système distant . Cliquez sur ce lien pour vérifier que vous pouvez vous connecter à l’instance distante, puis activez les connexions sortantes et entrantes.

    Après avoir créé un enregistrement d’événement de processus et un enregistrement de système distant, vous pouvez associer Studio de workflow des flux secondaires à ces enregistrements afin que des actions automatisées s’exécutent chaque fois que votre définition de synchronisation de processus se déclenche.

    Flux sortants et fluxentrants

    Un flux sortant spécifie le flux secondaire que Studio de workflow votre instance utilise pour :
    1. Traiter les données locales, en tant que champs capturés dans la définition de capture, qui seront envoyés à l’instance distante
    2. Corréler ces données avec les données de l’instance distante
    3. Envoyer ces données à l’instance distante

    Un enregistrement de flux sortant comporte les champs suivants :

    Champ Description
    Événement de processus Sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste) pour rechercher et choisir l’enregistrement d’événement de processus que vous souhaitez associer à ce flux sortant. L’événement de processus que vous sélectionnez doit logiquement être lié aux actions automatisées que le flux sortant exécutera lorsque votre définition de synchronisation de processus se déclenchera. Par exemple, si votre flux sortant mappe les champs d’un enregistrement de demande d’élément de Catalogue de services soumis par les utilisateurs de votre instance locale aux champs connexes de l’instance distante, choisissez alors un événement de processus lié aux utilisateurs effectuant des demandes d’éléments de Catalogue de services.
    Flux secondaire sortant Sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste) pour rechercher et choisir le Studio de workflow flux secondaire que vous souhaitez exécuter chaque fois que votre définition de synchronisation de processus se déclenche. Votre instance vous fournit un flux sortant de synchronisation de processus distant : flux secondaire de base que vous pouvez utiliser comme modèle dans n’importe quel enregistrement de flux sortant. Toutefois, vous pouvez personnaliser le modèle de flux sortant de synchronisation de processus distant : flux secondaire de base afin qu’il réponde aux besoins de votre processus business. Vous pouvez personnaliser ce flux secondaire à l’aide des actions sortantes de synchronisation du processus distant. Pour plus d’informations, consultez Créer votre première intégration de synchronisation de processus distants.
    Système distant Sélectionnez l’icône Rechercher à l’aide de la liste (icône Rechercher à l’aidede la liste) pour rechercher et choisir l’enregistrement du système distant auquel vous souhaitez vous connecter lorsque votre flux sortant exécute des actions automatisées qui nécessitent une authentification auprès de l’instance distante. L’enregistrement du système distant que vous choisissez doit être l’instance distante qui gère la partie entrante de votre intégration de synchronisation de processus distante.
    Application Défini automatiquement sur votre périmètre d’application actuel.
    Domaine Si votre processus se rapporte à un domaine spécifique, choisissez un domaine autre que global. Pour plus d’informations, consultez Séparation de domaine pour les fournisseurs de services.
    Un flux entrant spécifie le flux secondaire que Studio de workflow votre instance utilise pour :
    1. Corréler les données de l’instance locale avec les données envoyées par l’instance distante
    2. Mapper les champs envoyés depuis l’instance distante aux champs de l’instance locale
    3. Traiter les données envoyées de l’instance distante à l’instance locale

    Un enregistrement de flux entrant comporte les champs suivants :

    Champ Description
    Événement de processus Sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste) pour rechercher et choisir l’enregistrement d’événement de processus que vous souhaitez associer à ce flux entrant. L’événement de processus que vous sélectionnez doit logiquement être lié aux actions automatisées que le flux entrant exécutera lorsque votre instance locale sera prête à gérer la charge utile envoyée par l’instance distante. Par exemple, si votre flux entrant mappe les champs d’un enregistrement de demande d’élément de Catalogue de services que les utilisateurs de l’instance distante ont soumis aux champs connexes de votre instance locale, choisissez un événement de processus lié aux utilisateurs effectuant des demandes d’éléments de Catalogue de services.
    Flux secondaire entrant Sélectionnez l’icône Rechercher à l’aide d’une liste ( icône Rechercher à l’aide d’une liste) pour rechercher et choisir le Studio de workflow flux secondaire que vous souhaitez exécuter chaque fois que votre instance gère des données envoyées par une instance distante. Votre instance vous fournit un flux entrant de synchronisation de processus distant : flux secondaire de base que vous pouvez utiliser comme modèle dans n’importe quel enregistrement de flux entrant. Toutefois, vous pouvez personnaliser le modèle de flux entrant de synchronisation de processus distant : flux secondaire de base afin qu’il réponde aux besoins de votre processus business. Vous pouvez personnaliser ce flux secondaire à l’aide des actions entrantes de synchronisation du processus distant. Pour plus d’informations, consultez Créer votre première intégration de synchronisation de processus distants.
    Système distant Sélectionnez l’icône Rechercher à l’aide de la liste (icône Rechercher à l’aidede la liste) pour rechercher et choisir l’enregistrement du système distant auquel vous souhaitez vous connecter lorsque votre flux entrant exécute des actions automatisées qui nécessitent une authentification auprès de l’instance distante. L’enregistrement du système distant que vous choisissez doit être l’instance distante qui gère la partie sortante de votre intégration de synchronisation de processus distante.
    Application Défini automatiquement sur votre périmètre d’application actuel.
    Domaine Si votre processus se rapporte à un domaine spécifique, choisissez un domaine autre que global. Pour plus d’informations, consultez Séparation de domaine pour les fournisseurs de services.
    Remarque :
    Chaque flux sortant et chaque flux entrant doit toujours être associé à un événement de processus et à un seul système distant.

    Avant de simplement choisir le modèle de flux sortant de synchronisation de processus distant fourni par le système, de base ou de processus distant Modèle de flux entrant de synchronisation de processus : flux secondaires de base Pour votre définition de synchronisation de processus, vous pouvez personnaliser ces flux secondaires dans Studio de workflow.

    Synchronisation des pièces jointes

    vous pouvez choisir d’envoyer des pièces jointes associées à votre enregistrement local en utilisant l’option Inclure les pièces jointes dans votre définition de capture. Toutefois, la synchronisation du processus distant gère les pièces jointes différemment des autres données de votre intégration en raison de problèmes de sécurité et de taille du fichier de pièce jointe :
    • La première fois qu’un enregistrement de votre intégration se synchronise, toutes les pièces jointes sont envoyées dans la charge utile sortante. Les synchronisations suivantes peuvent envoyer des changements aux pièces jointes ou à toutes les pièces jointes.
    • Les métadonnées de pièce jointe sont toujours envoyées avec la charge utile sortante. Ces métadonnées comprennent une clé synthétique chiffrée, un hachage, un nom de fichier, un type de contenu et une taille.
    • L’instance distante décide des pièces jointes à recevoir en comparant chaque hachage et nom de fichier de la charge utile entrante à ceux de l’instance. Ensuite, le processus suivant se produit :
      1. Le système d’origine valide la clé et envoie les pièces jointes à l’enregistrement de corrélation.
      2. Le système d’origine avertit le système distant que les pièces jointes sont terminées.
      3. Le système distant déplace les pièces jointes de l’enregistrement de corrélation vers l’enregistrement cible.

    Synchronisation des commentaires et des notes de travail

    Dans votre intégration, les commentaires sont des notes de travail synchronisées entre les instances uniquement lorsque des changements sont apportés à ces champs journal. Les métadonnées de changement sont incluses dans les charges utiles afin que les systèmes distants puissent identifier quel utilisateur a créé le commentaire ou la note de travail et quand il a été créé.

    Files d’attente sortantes et files d’attente entrantes

    Après avoir créé votre intégration de synchronisation des processus distants en créant et en configurant les enregistrements mentionnés dans les sections précédentes, vous pouvez gérer votre intégration en surveillant la file d’attente sortante et la file d’attente entrante dans votre instance.

    Une file d’attente sortante contient l’état, les informations d’erreur, les données de nouvelle tentative et les informations de contexte de flux pour les flux secondaires sortants exécutés pour les données envoyées hors de votre instance. Pour afficher les enregistrements dans votre file d’attente sortante, accédez à Centre d'intégration > Synchronisation des processus distants > État de la file d'attente sortante.

    Un enregistrement d’état de file d’attente sortante comporte les champs suivants :

    Champ Description
    Créé Date à laquelle l’action automatisée s’est produite dans votre intégration
    Info relative à l'erreur Message d’état de la charge utile sortante
    Événement de processus Événement de processus
    Système distant Système distant
    Métadonnées de nouvelle tentative Métadonnées pour toutes les politiques de nouvelle tentative configurées pour votre charge utile sortante
    Statut État du traitement de la charge utile dans la file d’attente sortante. Les options incluent :
    • Prêt
    • Traité
    • « Erreur »
    • Ignoré
    Domaine Domaine dans lequel l’action automatisée de votre intégration s’est exécutée
    Contexte de flux secondaire sortant ID système de l’enregistrement d’exécution du flux sortant qui a traité la charge utile
    Remarque :
    Vous pouvez obtenir des informations de dépannage plus détaillées pour les charges utiles sortantes dans les enregistrements de file d’attente sortante associés. Pour accéder à ces enregistrements, accédez à Centre d'intégration > Synchronisation des processus distants > File d'attente sortante.

    Une file d’attente entrante contient l’état, la séquence de traitement et les informations de corrélation des flux secondaires entrants exécutés pour les données envoyées d’une instance distante à votre instance locale. Pour afficher les enregistrements dans votre file d’attente entrante, accédez à Centre d'intégration > Synchronisation des processus distants > File d'attente entrante.

    Un enregistrement de file d’attente entrante comporte les champs suivants :

    Champ Description
    Séquence Ordre dans la file d’attente. Un nombre inférieur est traité avant un nombre supérieur.
    Statut État du traitement de la charge utile dans la file d’attente entrante. Les options incluent :
    • Prêt
    • Traité
    • « Erreur »
    • Ignoré
    Remarque :
    Si un enregistrement de file d’attente entrante présente un état Erreur, changez l’état sur Prêt pour réessayer de traiter la charge utile entrante.
    Événement de processus Événement de processus associé à l’action d’intégration
    Opération Type d’opération d’enregistrement effectuée par l’instance distante qui a provoqué le déclenchement et l’envoi de données par l’instance distante. Les options incluent :
    • Créer
    • Mettre à jour
    • Supprimer
    Contexte de transformation ID système de l’enregistrement d’exécution du flux entrant qui a traité la charge utile
    ID de corrélation local ID de corrélation sur l’instance locale
    ID de corrélation distant ID de corrélation sur l’instance distante
    Système distant Enregistrement du système distant associé à l’instance qui a envoyé les données
    Domaine Domaine dans lequel l’action automatisée de votre intégration s’est exécutée
    Charge utile Chaîne en tant que charge utile JSON pour les données entrantes
    Remarque :
    Les tables File d’attente sortante et File d’attente entrante sont gérées par des nettoyeurs de tables qui suppriment les enregistrements de ces tables tous les 30 jours.

    Surveillance et résolution des problèmes liés à votre intégration

    Vous pouvez utiliser les tables suivantes pour surveiller votre intégration de synchronisation de processus distant, une fois qu’elle est créée et en cours d’exécution :
    Table Description
    Statistiques XML Consultez la process_sync_queue section pour obtenir des informations sur les files d’attente sortantes et entrantes pour votre intégration, y compris la taille de la file d’attente, ainsi que les taux d’erreur et de traitement.
    File d'attente sortante Affichez les données de capture des enregistrements qui sont prévus pour être envoyés hors de votre instance.
    État de la file d'attente sortante Affichez l’état des enregistrements dans la table File d’attente sortante.
    File d'attente entrante Affichez la table combinée de file d’attente entrante et d’enregistrement.
    Journaux Commencez par activer le débogage en définissant la glide.ih.process.sync.debug propriété système sur vrai. Ensuite, analysez les journaux à la recherche de messages d’erreur commençant par OutboundQueueDao et InboundQueueDao pour trouver les messages du journal contenant plus d’informations sur les problèmes potentiels de votre intégration.
    Si une erreur se produit avec votre intégration de synchronisation de processus distant, commencez par confirmer s’il s’agit d’une erreur de connexion ou d’une erreur de traitement des données :
    Erreurs de connexion
    Les erreurs de connexion sortante réessayent automatiquement plusieurs fois avant de définir l’état sortant de l’enregistrement du système distant sur Erreur. Si des erreurs continuent de se produire pour une connexion sortante, confirmez que rien n’a changé avec l’utilisateur de l’API entrante du système distant, comme une modification des informations d’identification de l’utilisateur. Ensuite, validez et activez à nouveau l’enregistrement du système distant.
    Erreurs de traitement des données
    Les erreurs de traitement des données se produisent généralement à la suite d’erreurs dans un flux sortant ou entrant. Pour résoudre ces erreurs, vous pouvez ajouter des actions de gestion des erreurs à votre flux, telles qu’une action de journal ou une action d’envoi d’e-mail, lorsque l’état du flux bascule sur Erreur. Vous pouvez également ajouter des actions qui retraitent ou ignorent le traitement des enregistrements dans les tables File d’attente sortante ou File d’attente entrante si une erreur se produit avec le flux.