Créez votre première intégration de synchronisation de processus distants

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 22 minutes de lecture

    • Suivez un exemple de création d’une intégration de synchronisation de processus distants afin de lier les processus automatisés de deux ServiceNow® instances.

    Avant de commencer

    • Activez la synchronisation de processus à distance sur chaque instance de votre intégration en achetant le Hub d'intégration package Entreprise. Pour plus d'informations, consultez Demander le Hub d'intégration.
    • Activez la fonctionnalité de sécurité des rôles explicites sur chaque instance de votre intégration. Pour plus d’informations, consultez le module d’extension Explicit Role.
    • Découvrez comment créer et gérer une Hub d'intégration intégration de synchronisation de processus à distance en Mise en route de la synchronisation des processus distantsconsultant .
    • Confirmez que les instances que vous allez lier ensemble dans l’exemple suivant ne sont pas des instances de production. Il est recommandé de tester cet exemple uniquement sur des instances de sous-production afin d’éviter d’écraser des données importantes sur l’une ou l’autre des instances. Vous pouvez également utiliser une instance de développeur personnel pour tester cet exemple d’intégration.
    • Vérifiez que vous n’avez pas de règles métier, de workflows ou Studio de workflow de flux existants dont la logique entrera en conflit avec les flux que nous allons créer dans l’exemple suivant.
    • Rôle requis : administrateur

    Pourquoi et quand exécuter cette tâche

    Dans l’exemple suivant, vous expliquerez comment lier les processus automatisés de deux ServiceNow instances. Le cas d’utilisation de cet exemple est qu’un client crée des demandes de matériel qui sont remplies par un fournisseur. Nous nous référerons à l’instance du client en tant qu’instance A et à l’instance du fournisseur en tant qu’instance B. Nous allons commencer par configurer les informations d’identification dans chaque instance qui peut accéder à l’instance distante. Nous allons également créer un utilisateur dans chaque instance qui peut exécuter les flux sortants et entrants.

    Procédure

    1. Dans l’instance A, assurez-vous que votre domaine est défini sur global, puis accédez à Sécurité de système > Utilisateurs et groupes > Utilisateurs.
    2. Sélectionnez Nouveau pour ouvrir une nouvelle vue de formulaire Utilisateur, puis renseignez les champs suivants :
      Champ Description
      ID d'utilisateur Entrez rps.api.instance.a
      Prénom Entrer l’utilisateur de l’API RPS pour l’instance A
      Sélectionnez Enregistrer.
    3. Toujours sur le formulaire Utilisateur, sélectionnez Définir le mot de passe pour définir un mot de passe.
      Pour en savoir plus, reportez-vous aux étapes quatre et cinq de la section Configuring password for a user.
    4. Réinitialisez le mot de passe de l’utilisateur de l’API RPS pour l’instance A.
    5. Revenir à Sécurité de système > Utilisateurs et groupes > Utilisateurs et sélectionnez l’enregistrement utilisateur que vous venez de créer.
      1. Accédez à la liste connexe Rôles et sélectionnez-la.
      2. Sélectionnez Modifier... pour configurer les rôles de l’utilisateur.
      3. Dans la fenêtre de recherche au-dessus de Collection, saisissez ih_process_sync_api.
      4. Sélectionnez ih_process_sync_api et snc_external dans la liste Collection, puis cliquez sur le bouton Ajouter ( bouton Ajouter) pour ajouter ces rôles à la liste des rôles.
        Remarque :
        Le rôle snc_external restreint l’accès des utilisateurs externes aux seules ressources auxquelles ils ont été explicitement autorisés.
      5. Sélectionnez Enregistrer.
    6. Sélectionnez Nouveau pour ouvrir une nouvelle vue de formulaire Utilisateur, puis renseignez les champs suivants :
      Champ Description
      ID d'utilisateur Saisir rps.run.as
      Prénom Entrer l’exécution RPS en tant qu’utilisateur A
      Sélectionnez Enregistrer.
    7. Toujours sur le formulaire Utilisateur, sélectionnez Définir le mot de passe pour définir un mot de passe.
      Pour en savoir plus, reportez-vous aux étapes quatre et cinq de la section Configuring password for a user.
    8. Réinitialisez le mot de passe pour l’exécution de RPS en tant qu’utilisateur A.
    9. Revenir à Sécurité de système > Utilisateurs et groupes > Utilisateurs et sélectionnez l’enregistrement utilisateur que vous venez de créer.
      1. Accédez à la liste connexe Rôles et sélectionnez-la.
      2. Sélectionnez Modifier... pour configurer les rôles de l’utilisateur.
      3. Dans la fenêtre de recherche au-dessus de Collection, saisissez ih_process_sync_run_as.
      4. Sélectionnez ih_process_sync_run_as dans la liste Collection, puis cliquez sur le bouton Ajouter ( bouton Ajouter) pour ajouter ce rôle à la liste des rôles.
      5. Dans la fenêtre de recherche au-dessus de Collection, saisissez incident_manager.
      6. Sélectionnez incident_manager dans la liste Collection, puis sélectionnez le bouton Ajouter ( bouton Ajouter) pour ajouter ce rôle à la liste des rôles.
      7. Sélectionnez Enregistrer.
    10. Dans l’instance B, assurez-vous que votre domaine est défini sur global, puis accédez à Sécurité de système > Utilisateurs et groupes > Utilisateurs.
    11. Sélectionnez Nouveau pour ouvrir une nouvelle vue de formulaire Utilisateur, puis renseignez les champs suivants :
      Champ Description
      ID d'utilisateur Entrez rps.api.instance.b
      Prénom Entrer l’utilisateur de l’API RPS pour l’instance B
      Sélectionnez Enregistrer.
    12. Toujours sur le formulaire Utilisateur, sélectionnez Définir le mot de passe pour définir un mot de passe.
      Pour en savoir plus, reportez-vous aux étapes quatre et cinq de la section Configuring password for a user.
    13. Réinitialisez le mot de passe de l’utilisateur de l’API RPS pour l’instance B.
    14. Revenir à Sécurité de système > Utilisateurs et groupes > Utilisateurs et sélectionnez l’enregistrement utilisateur que vous venez de créer.
      1. Accédez à la liste connexe Rôles et sélectionnez-la.
      2. Sélectionnez Modifier... pour configurer les rôles de l’utilisateur.
      3. Dans la fenêtre de recherche au-dessus de Collection, saisissez ih_process_sync_api.
      4. Sélectionnez ih_process_sync_api et snc_external dans la liste Collection, puis cliquez sur le bouton Ajouter ( bouton Ajouter) pour ajouter ces rôles à la liste des rôles.
        Remarque :
        Le rôle snc_external restreint l’accès des utilisateurs externes aux seules ressources auxquelles ils ont été explicitement autorisés.
      5. Sélectionnez Enregistrer.
    15. Sélectionnez Nouveau pour ouvrir une nouvelle vue de formulaire Utilisateur, puis renseignez les champs suivants :
      Champ Description
      ID d'utilisateur Saisir rps.run.as
      Prénom Entrer RPS Exécuter en tant qu’utilisateur B
      Sélectionnez Enregistrer.
    16. Toujours sur le formulaire Utilisateur, sélectionnez Définir le mot de passe pour définir un mot de passe.
      Pour en savoir plus, reportez-vous aux étapes quatre et cinq de la section Configuring password for a user.
    17. Réinitialisez le mot de passe pour l’exécution RPS en tant qu’utilisateur B à partir de l’instance B.
    18. Revenir à Sécurité de système > Utilisateurs et groupes > Utilisateurs et sélectionnez l’enregistrement utilisateur que vous venez de créer.
      1. Accédez à la liste connexe Rôles et sélectionnez-la.
      2. Sélectionnez Modifier... pour configurer les rôles de l’utilisateur.
      3. Dans la fenêtre de recherche au-dessus de Collection, saisissez ih_process_sync_run_as.
      4. Sélectionnez ih_process_sync_run_as dans la liste Collection, puis cliquez sur le bouton Ajouter ( bouton Ajouter) pour ajouter ce rôle à la liste des rôles.
      5. Dans la fenêtre de recherche au-dessus de Collection, saisissez incident_manager.
      6. Sélectionnez incident_manager dans la liste Collection, puis sélectionnez le bouton Ajouter ( bouton Ajouter) pour ajouter ce rôle à la liste des rôles.
      7. Sélectionnez Enregistrer.
    19. Dans l’instance A, accédez à Centre d'intégration > Connexions et informations d'identification > Informations d'identification, puis sélectionnez Nouveau.
      1. Dans la liste des options de connexion, sélectionnez Informations d’identification pour l’authentification de base.
      2. Renseignez les champs suivants du formulaire :
        Champ Description
        Nom Entrer les informations d’identification du fournisseur RPS
        Nom d'utilisateur Entrez rps.api.instance.b
        Mot de passe Saisissez le mot de passe de l’utilisateur de l’API RPS pour l’instance B.
        Remarque :
        Les informations d’identification que vous entrez doivent correspondre aux informations d’identification de l’utilisateur de l’API RPS que vous avez créé dans l’instance B.
      3. Sélectionnez Soumettre.
    20. Toujours dans l’instance A, naviguez vers Centre d'intégration > Connexions et informations d'identification > Alias de connexion et d'informations d'identification, puis sélectionnez Nouveau.
      1. Dans le champ Nom, saisissez Démo du fournisseur RPS.
        Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
      2. Dans la liste, sélectionnez l’enregistrement de démonstration de fournisseur RPS que vous venez de créer.
      3. Dans la liste connexe Connexions, sélectionnez Nouveau.
      4. Renseignez les champs suivants du formulaire :
        Champ Description
        Nom C’est là qu’intervient le fournisseur RPS.
        Informations d'identification Sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste), puis sélectionnez l’enregistrement Informations d’identification du fournisseur RPS dans la liste.
        URL de connexion Entrez l’URL de base de l’instance B. L’URL doit commencer par https:// et se terminer par .service-now.com/
      5. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
    21. Dans l’instance B, accédez à Centre d'intégration > Connexions et informations d'identification > Informations d'identification, puis sélectionnez Nouveau.
      1. Dans la liste des options de connexion, sélectionnez Informations d’identification pour l’authentification de base.
      2. Renseignez les champs suivants du formulaire :
        Champ Description
        Nom Saisir les informations d’identification du client RPS
        Nom d'utilisateur Entrez rps.api.instance.a
        Mot de passe Saisissez le mot de passe de l’utilisateur de l’API RPS pour l’instance A.
        Remarque :
        Les informations d’identification que vous entrez doivent correspondre aux informations d’identification de l’utilisateur de l’API RPS que vous avez créé dans l’instance A.
      3. Sélectionnez Soumettre.
    22. Toujours dans l’instance B, naviguez vers Centre d'intégration > Connexions et informations d'identification > Alias de connexion et d'informations d'identification, puis sélectionnez Nouveau.
      1. Dans le champ Nom, saisissez Démo client RPS.
        Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
      2. Dans la liste, sélectionnez l’enregistrement de démonstration client RPS que vous venez de créer.
      3. Dans la liste connexe Connexions, sélectionnez Nouveau.
      4. Renseignez les champs suivants du formulaire :
        Champ Description
        Nom C’est là qu’intervient le client RPS.
        Informations d'identification Sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste), puis sélectionnez l’enregistrement Informations d’identification du client RPS dans la liste.
        URL de connexion Entrez l’URL de base de l’instance A. L’URL doit commencer par https:// et se terminer par .service-now.com/
      5. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
      Nous avons créé avec succès des informations d’identification qui peuvent être utilisées pour accéder à chaque instance distante. Assurons-nous maintenant que nous pouvons envoyer et recevoir des données entre les instances en configurant l’enregistrement du système distant pour une définition de synchronisation de processus dans chaque instance.
    23. Dans l’instance A, accédez à Centre d'intégration > Synchronisation des processus distants > Définitions de synchronisation des processus, puis sélectionnez Nouveau.
      1. Renseignez les champs suivants du formulaire :
        Champ Description
        Nom Entrer le processus de demande de matériel
        Description Entrer le processus de demande de matériel et de gestion des demandes de matériel exécutées
      2. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
      3. Dans la liste, sélectionnez l’enregistrement Processus de demande de matériel que vous venez de créer.
    24. Dans la liste connexe Systèmes distants, sélectionnez Nouveau.
      1. Renseignez les champs suivants du formulaire :
        Champ Description
        Nom Entrer le fournisseur Instance : instance B
        Description Entrez l’instance du fournisseur qui répond aux demandes matérielles
        Alias de connexion Sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste), puis sélectionnez l’enregistrement RPS_Vendor_Demo dans la liste.
        Utilisateur de l'API entrante Sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste), puis sélectionnez l’utilisateur de l’API RPS pour l’enregistrement de l’instance A dans la liste.
        Exécuter en tant que Sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste), puis sélectionnez l’enregistrement Exécuter en tant qu’utilisateur RPS dans la liste.
      2. Dans l’en-tête contextuel, sélectionnez l’icône Actions supplémentaires ( icône Actions supplémentaires), puis sélectionnez Copier sys_id.
        Vous aurez besoin de cet ID système comme valeur pour le champ ID externe de l’enregistrement du système distant dans l’instance B.
      3. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
    25. Dans l’instance B, accédez à Centre d'intégration > Synchronisation des processus distants > Définitions de synchronisation des processus, puis sélectionnez Nouveau.
      1. Renseignez les champs suivants du formulaire :
        Champ Description
        Nom Entrer le processus d’exécution du matériel
        Description Entrer le processus pour répondre aux demandes de matériel
      2. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
      3. Dans la liste, sélectionnez l’enregistrement du processus d’exécution du matériel que vous venez de créer.
    26. Dans la liste connexe Systèmes distants, sélectionnez Nouveau.
      1. Renseignez les champs suivants du formulaire :
        Champ Description
        Nom Saisir l’instance client : instance A
        Description Saisir l’instance client qui demande du matériel
        ID externe Collez la valeur de l’ID système que vous avez copié à partir de l’enregistrement du système distant dans l’instance A.
        Alias de connexion Sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste), puis sélectionnez l’enregistrement de RPS_Customer_Demo dans la liste.
        Utilisateur de l'API entrante Sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste), puis sélectionnez l’utilisateur de l’API RPS pour l’enregistrement de l’instance B dans la liste.
        Exécuter en tant que Sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste), puis sélectionnez l’enregistrement Exécuter en tant qu’utilisateur RPS dans la liste.
      2. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
      3. Dans la liste connexe Systèmes distants, sélectionnez l’enregistrement Instance client - Instance A .
      4. Dans l’en-tête contextuel, sélectionnez l’icône Actions supplémentaires ( icône Actions supplémentaires), puis sélectionnez Copier sys_id.
        Vous aurez besoin de cet ID système comme valeur pour le champ ID externe de l’enregistrement du système distant dans l’instance A.
    27. Dans l’instance B, accédez à Centre d'intégration > Synchronisation des processus distants > Systèmes distants – Tout, puis sélectionnez l’enregistrement Instance de client - Instance A dans la liste.
      1. Dans le champ ID externe, collez la valeur de l’ID système que vous avez copié à partir de l’enregistrement du système distant dans l’instance A.
      2. Sélectionnez Mettre à jour pour enregistrer les changements que vous avez apportés à l’enregistrement.
      3. Dans la liste, sélectionnez l’enregistrement Instance client - Instance A .
      4. Dans la section Liens connexes, sélectionnez Valider et activer le système distant.
        Vous devriez voir un message indiquant que le système distant a été validé et activé avec succès. Si un message d’erreur s’affiche à la place, revenez en arrière et vérifiez la configuration de l’enregistrement du système distant.
      Nous avons réussi à connecter l’instance A et l’instance B afin qu’elles puissent partager des données entre leurs workflows de processus. Maintenant, nous allons définir comment notre intégration se déclenchera et s’exécutera automatiquement, ainsi que les champs que nous voulons capturer et synchroniser entre les instances.
    28. Dans l’instance A, accédez à Centre d'intégration > Synchronisation des processus distants > Définitions de synchronisation des processus, puis sélectionnez l’enregistrement Processus de demande de matériel dans la liste.
    29. Dans la liste connexe Événements de processus, sélectionnez Nouveau.
      1. Dans le champ Nom, saisissez Demander du matériel.
        Remarque :
        Ce champ est sensible à la casse. Il fonctionne de la même manière qu’un nom de méthode de point de terminaison d’API.
      2. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
    30. Dans la liste connexe Événements de processus, sélectionnez Nouveau.
      1. Dans le champ Nom, saisissez Demande de matériel exécutée.
      2. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
    31. Dans la liste connexe Définitions de capture, sélectionnez Nouveau.
      1. Renseignez les champs suivants du formulaire :
        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), puis sélectionnez l’enregistrement Demander du matériel dans la liste.
        État Sélectionner Actif
        Nom de la table source Sélectionnez Incident [incident]
        Filtre Dans le générateur de conditions, sélectionnez Groupe d'affectation > est , puis sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste). Choisissez l’enregistrement Matériel dans la liste.
        Inclure les champs Sélectionnez les champs suivants, puis sélectionnez le bouton Ajouter un élément ( bouton Ajouter un élément) pour les ajouter à la liste sélectionnée :
        • Numéro
        • Description brève
        • Groupe d'affectation
        • Gravité
        • État
        Remarque :
        L’ID système est déjà inclus dans la liste Sélectionné. Laissez également ce champ dans la liste sélectionnée.
      2. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
    32. Dans la liste connexe Flux sortants, sélectionnez Nouveau.
      1. Renseignez les champs suivants du formulaire :
        Champ Description
        Événement de processus Dans la liste, sélectionnez Demander du matériel.
        Flux secondaire sortant

        Sélectionner une copie du modèle de flux sortant de synchronisation des processus distants : enregistrement de base.

        Pour faire une copie, procédez comme suit.
        1. Utilisez le bouton Configurer le flux secondaire en regard du champ Flux secondaire sortant pour accéder à Studio de workflow.
        2. Dans Studio de workflow, sélectionnez l’onglet Flux secondaires.
        3. Filtrez la colonne Nom pour localiser l’enregistrement Modèle de flux sortant de synchronisation des processus distants : enregistrement de base et sélectionnez-le.
        4. Dans le flux secondaire, sélectionnez le menu Actions supplémentaires, puis sélectionnez Copier le flux secondaire.
        5. Publiez la copie du flux secondaire.
        Ce flux secondaire de modèle gère la corrélation des enregistrements locaux et distants et envoie la charge utile capturée à l’instance distante.
        Remarque :
        Lors de la création de votre propre intégration, vous pouvez ajouter des actions de synchronisation du processus distant pour personnaliser ce flux secondaire de modèle selon vos besoins. Pour modifier ce flux secondaire de modèle dans Studio de workflow, sélectionnez l’icône Configurer le flux secondaire (icône Configurer le flux secondaire).
        Système distant Sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste), puis sélectionnez l’enregistrement Instance de fournisseur - instance B dans la liste.
      2. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
    33. Dans l’instance B, accédez à Centre d'intégration > Synchronisation des processus distants > Définitions de synchronisation des processus, puis sélectionnez l’enregistrement Processus d’exécution du matériel dans la liste.
    34. Dans la liste connexe Événements de processus, sélectionnez Nouveau.
      1. Dans le champ Nom, saisissez Demander du matériel.
      2. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
    35. Dans la liste connexe Événements de processus, sélectionnez Nouveau.
      1. Dans le champ Nom, saisissez Demande de matériel exécutée.
      2. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
        Remarque :
        Créez des enregistrements d’événements de processus dans les deux instances avec des noms qui correspondent. Cela vous aidera à suivre les workflows de processus liés entre les instances.
    36. Dans la liste connexe Définitions de capture, sélectionnez Nouveau.
      1. Renseignez les champs suivants du formulaire :
        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), puis sélectionnez l’enregistrement Demande matérielle exécutée dans la liste.
        État Sélectionner Actif
        Nom de la table source Sélectionnez Incident [incident]
        Filtre Dans le générateur de conditions, sélectionnez Groupe d'affectation > est , puis sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste). Choisissez l’enregistrement Matériel dans la liste. Ensuite, sélectionnez ET pour ajouter une autre condition et sélectionnez État de l'incident > est > Résolu.
        Inclure les champs Sélectionnez les champs suivants, puis sélectionnez le bouton Ajouter un élément ( bouton Ajouter un élément) pour les ajouter à la liste sélectionnée :
        • Numéro
        • État
        • Résolu par
        • Notes de résolution
        • Code de résolution
        Remarque :
        L’ID système est déjà inclus dans la liste Sélectionné. Laissez également ce champ dans la liste sélectionnée.
      2. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
    37. Dans la liste connexe Flux sortants, sélectionnez Nouveau.
      1. Renseignez les champs suivants du formulaire :
        Champ Description
        Événement de processus Dans la liste, sélectionnez Demande de matériel exécutée.
        Flux secondaire sortant

        Sélectionner une copie du modèle de flux sortant de synchronisation des processus distants : enregistrement de base.

        Pour faire une copie, procédez comme suit.
        1. Utilisez le bouton Configurer le flux secondaire en regard du champ Flux secondaire sortant pour accéder à Studio de workflow.
        2. Dans Studio de workflow, sélectionnez l’onglet Flux secondaires.
        3. Filtrez la colonne Nom pour localiser l’enregistrement Modèle de flux sortant de synchronisation des processus distants : enregistrement de base et sélectionnez-le.
        4. Dans le flux secondaire, sélectionnez le menu Actions supplémentaires, puis sélectionnez Copier le flux secondaire.
        5. Publiez la copie du flux secondaire.
        Ce flux secondaire de modèle gère la corrélation des enregistrements locaux et distants et envoie la charge utile capturée à l’instance distante.
        Remarque :
        Lors de la création de votre propre intégration, vous pouvez ajouter des actions de synchronisation du processus distant pour personnaliser ce flux secondaire de modèle selon vos besoins. Pour modifier ce flux secondaire de modèle dans Studio de workflow, sélectionnez l’icône Configurer le flux secondaire (icône Configurer le flux secondaire).
        Système distant Sélectionnez l’icône Rechercher à l’aide de la liste (icône Rechercher à l’aide d’une liste), puis sélectionnez l’enregistrement Instance client - instance A dans la liste.
      2. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
      Nous avons configuré avec succès le mode de déclenchement de notre intégration de synchronisation des processus distants et les champs qui seront capturés et envoyés à l’une ou l’autre des instances distantes. Dans cette dernière section, nous allons personnaliser les flux entrants afin Studio de workflow qu’ils transforment correctement les données entrantes.
    38. Dans l’instance B, accédez à Centre d'intégration > Synchronisation des processus distants > Définitions de synchronisation des processus, puis sélectionnez l’enregistrement Processus d’exécution du matériel dans la liste.
    39. Effectuez une copie de l’enregistrement de base du modèle de flux entrant de synchronisation des processus distants .
      1. Accédez à l’onglet Studio de workflow Flux secondaires et sélectionnez-le.
      2. Filtrez la colonne Nom pour localiser le modèle de flux entrant de synchronisation des processus distants : enregistrement de base et sélectionnez-le.
      3. Dans le flux secondaire, sélectionnez le menu Actions supplémentaires, puis sélectionnez Copier le flux secondaire.
    40. Dans le flux secondaire, mettez à jour la charge utile.
      1. Développez l’action Transformer la charge utile à partir de l’échantillon entrant .
      2. Dans le champ Exemple de charge utile, saisissez l’exemple de charge utile suivant : 
        {"capture_metadata":{"changed_by":"admin","timestamp":"2020-09-24 19:26:59"},
"changed_fields":[
  {"display_value":"","value":"incident","key":"sys_class_name"},
  {"display_value":"","value":"552c48888c033300964f4932b03eb092","key":"sys_id"},
  {"display_value":"","value":"INC0040015","key":"number"},
  {"display_value":"","value":"","key":"short_description"},
  {"display_value":"Hardware","value":"9f5b572d9cd82010f877a5cfd1fdce30","key":"assignment_group"},
  {"display_value":"","value":"1","key":"severity"},
  {"display_value":"","value":"2","key":"state"}]}
        Remarque :
        Cette charge utile est un objet complexe qui représente les métadonnées capturées et les champs qui sont envoyés de l’instance A à l’instance B.
      3. Sélectionnez Terminé.
    41. Dans le flux secondaire, sous la logique de flux Sinon , sélectionnez Créer un enregistrement d’incident.
      1. Ajoutez les champs suivants et les valeurs associées :
        Champ Valeur
        Description brève Sélectionnez l’icône de sélection de pastilles de données (icône de sélection de pastilles de données). Remonter pas à pas jusqu’à, puis sélectionner 1 : transformer la charge utile à partir d’un échantillon entrant > Champs modifiés > short_description.
        Description Sélectionnez l’icône de sélection de pastilles de données (icône de sélection de pastilles de données). Remonter pas à pas jusqu’à, puis sélectionner 1 : transformer la charge utile à partir d’un échantillon entrant > Champs modifiés > short_description.
        Groupe d'affectation Sélectionnez l’icône de sélection de pastilles de données (icône de sélection de pastilles de données). Remonter pas à pas jusqu’à, puis sélectionner 1 : transformer la charge utile à partir d’un échantillon entrant > Champs modifiés > assignment_group.
        Urgence Sélectionnez l’icône de sélection de pastilles de données (icône de sélection de pastilles de données). Remonter pas à pas jusqu’à, puis sélectionner 1 : transformer la charge utile à partir d’un échantillon entrant > Champs modifiés > severity.
        État Sélectionnez l’icône de sélection de pastilles de données (icône de sélection de pastilles de données). Remonter pas à pas jusqu’à, puis sélectionner 1 : transformer la charge utile à partir d’un échantillon entrant > Champs modifiés > État.
      2. Sélectionnez Terminé.
    42. En regard de la logique de flux Si, sélectionnez Mettre à jour l’enregistrement d’incident.
      1. Dans l’entrée Champs, ajoutez les champs suivants et les valeurs associées :
        Champ Valeur
        Description brève Sélectionnez l’icône de sélection de pastilles de données (icône de sélection de pastilles de données). Remonter pas à pas jusqu’à, puis sélectionner 1 : transformer la charge utile à partir d’un échantillon entrant > Champs modifiés > short_description.
        Description Sélectionnez l’icône de sélection de pastilles de données (icône de sélection de pastilles de données). Remonter pas à pas jusqu’à, puis sélectionner 1 : transformer la charge utile à partir d’un échantillon entrant > Champs modifiés > short_description.
        Groupe d'affectation Sélectionnez l’icône de sélection de pastilles de données (icône de sélection de pastilles de données). Remonter pas à pas jusqu’à, puis sélectionner 1 : transformer la charge utile à partir d’un échantillon entrant > Champs modifiés > assignment_group.
        Urgence Sélectionnez l’icône de sélection de pastilles de données (icône de sélection de pastilles de données). Remonter pas à pas jusqu’à, puis sélectionner 1 : transformer la charge utile à partir d’un échantillon entrant > Champs modifiés > severity.
        État Sélectionnez l’icône de sélection de pastilles de données (icône de sélection de pastilles de données). Remonter pas à pas jusqu’à, puis sélectionner 1 : transformer la charge utile à partir d’un échantillon entrant > Champs modifiés > État.
      2. Sélectionnez Terminé.
    43. Publiez le flux secondaire.
    44. De retour dans l’enregistrement Processus d’exécution du matériel, dans la liste connexe Flux entrants, sélectionnez Nouveau.
      1. Renseignez les champs suivants du formulaire :
        Champ Description
        Événement de processus Dans la liste, sélectionnez Demander du matériel.
        Flux secondaire entrant Sélectionnez Copie du modèle de flux entrant de synchronisation des processus distants : basique.
        Système distant Sélectionnez l’icône Rechercher à l’aide de la liste (icône Rechercher à l’aide d’une liste), puis sélectionnez l’enregistrement Instance client - instance A dans la liste.
      2. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.
    45. Dans l’instance A, accédez à Centre d'intégration > Synchronisation des processus distants > Définitions de synchronisation des processus, puis sélectionnez l’enregistrement Processus de demande de matériel dans la liste.
    46. Effectuez une copie de l’enregistrement de base du modèle de flux entrant de synchronisation des processus distants .
      1. Accédez à l’onglet Studio de workflow Flux secondaires et sélectionnez-le.
      2. Filtrez la colonne Nom pour localiser le modèle de flux entrant de synchronisation des processus distants : enregistrement de base et sélectionnez-le.
      3. Dans le flux secondaire, sélectionnez le menu Actions supplémentaires, puis sélectionnez Copier le flux secondaire.
    47. Dans le flux secondaire, mettez à jour la charge utile.
      1. Développez l’action Transformer la charge utile à partir de l’échantillon entrant .
      2. Dans le champ Exemple de charge utile, saisissez l’exemple de charge utile suivant : 
        {"capture_metadata":{"changed_by":"admin","timestamp":"2020-10-26 14:18:45"},
"changed_fields":[
  {"display_value":"","value":"incident","key":"sys_class_name"},
  {"display_value":"","value":"d4cdfce8db4c2410cfe4d9595e96197b","key":"sys_id"},
  {"display_value":"","value":"INC0040014","key":"number"},
  {"display_value":"","value":"101","key":"state"},
  {"display_value":"","value":"Resolved by caller","key":"close_code"},
  {"display_value":"System Administrator","value":"6816f79cc0a8016401c5a33be04be441","key":"resolved_by"},
  {"display_value":"","value":"","key":"close_notes"}]}
        Remarque :
        Cette charge utile est un objet complexe qui représente les métadonnées capturées et les champs envoyés de l’instance B à l’instance A.
      3. Sélectionnez Terminé.
    48. En regard de la logique de flux Si, sélectionnez Mettre à jour l’enregistrement d’incident.
      1. Dans l’entrée Champs, ajoutez les champs suivants et les valeurs associées :
        Champ Valeur
        État Sélectionnez l’icône de sélection de pastilles de données (icône de sélection de pastilles de données). Remonter pas à pas jusqu’à, puis sélectionner 1 : transformer la charge utile à partir d’un échantillon entrant > Champs modifiés > État.
        Résolu par Sélectionnez l’icône de sélection de pastilles de données (icône de sélection de pastilles de données). Remonter pas à pas jusqu’à, puis sélectionner 1 : transformer la charge utile à partir d’un échantillon entrant > Champs modifiés > resolved_by.
        Notes de résolution Sélectionnez l’icône de sélection de pastilles de données (icône de sélection de pastilles de données). Remonter pas à pas jusqu’à, puis sélectionner 1 : transformer la charge utile à partir d’un échantillon entrant > Champs modifiés > close_notes.
        Code de résolution Sélectionnez l’icône de sélection de pastilles de données (icône de sélection de pastilles de données). Remonter pas à pas jusqu’à, puis sélectionner 1 : transformer la charge utile à partir d’un échantillon entrant > Champs modifiés > close_code.
      2. Sélectionnez Terminé.
    49. Dans le flux secondaire, supprimez l’instruction Else .
    50. Publiez le flux secondaire.
    51. De retour dans l’enregistrement Processus d’exécution du matériel, dans la liste connexe Flux entrants, sélectionnez Nouveau.
      1. Renseignez les champs suivants du formulaire :
        Champ Description
        Événement de processus Dans la liste, sélectionnez Demande de matériel exécutée.
        Flux secondaire entrant Sélectionnez Copie du modèle de flux entrant de synchronisation des processus distants : basique.
        Système distant Sélectionnez l’icône Rechercher à l’aide d’une liste (icône Rechercher à l’aide d’une liste), puis sélectionnez l’enregistrement Instance de fournisseur - instance B dans la liste.
      2. Laissez tous les autres champs tels quels, puis sélectionnez Soumettre.

    Résultats

    Nous avons terminé la création de notre intégration de synchronisation de processus à distance. L’intégration se déclenche désormais chaque fois qu’un utilisateur crée un enregistrement d’incident avec le groupe d’affectation de matériel dans l’incident A. Lorsque cela se produit :
    • Les champs spécifiés dans la définition de capture de l’instance A sont capturés et stockés dans un enregistrement local.
    • L’enregistrement local est corrélé à un enregistrement distant dans l’instance B.
    • Les champs capturés sont mappés aux champs que nous avons spécifiés dans le flux entrant de l’instance B.

    Puis, lorsqu’un utilisateur résout l’enregistrement d’incident corrélé dans l’instance B :

    • Les champs spécifiés dans la définition de capture de l’instance B sont capturés et stockés dans un enregistrement local.
    • L’enregistrement local est corrélé à l’enregistrement distant dans l’instance A.
    • Les champs capturés sont mappés aux champs que nous avons spécifiés dans le flux entrant de l’instance A.

    Que faire ensuite

    Testez votre intégration de synchronisation des processus distants en créant un enregistrement d’incident dans l’instance A avec le groupe d’affectation de matériel. Résolvez ensuite l’enregistrement d’incident corrélé dans l’instance B. Si vos enregistrements corrélés ne se synchronisent pas comme prévu, vérifiez les informations d’identification de votre utilisateur de l’API entrante et la configuration de la définition de synchronisation de processus dans chaque instance. Si vous continuez à rencontrer des problèmes avec votre exemple d’intégration, reportez-vous à Surveillance et résolution des problèmes liés à votre intégration.