Créer des définitions de tâches distantes dans Service Bridge pour les fournisseurs

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

    • En tant que fournisseur, créez des définitions de tâches distantes qui déclenchent l’affectation d’une tâche distante.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Fournisseur de Service Bridge > Administration > Définitions de tâches distantes.
    2. Cliquez sur Nouveau.
    3. Renseignez les champs du formulaire.
      Tableau 1. Formulaire de définition de la tâche distante
      Champ Description
      Nom Nom de l’enregistrement de définition de tâche distante.
      Table du fournisseur N’importe quelle table de tâches que vous sélectionnez dans la liste. Par exemple, vous pouvez choisir une table de tickets ou une table d’incidents.
      Table consommateur N’importe quelle table de tâches que vous sélectionnez dans la liste. Par exemple, vous pouvez choisir une table de tickets ou une table d’incidents.
      Envoyer des pièces jointes Si cette option est sélectionnée, si une pièce jointe est ajoutée à l’enregistrement parent, elle est envoyée à la tâche distante.
      Copier la pièce jointe vers le parent Si une pièce jointe est incluse avec une tâche distante, une copie est envoyée à l’enregistrement parent.
      Description courte Informations brèves sur cette définition de tâche distante.
      Description Informations plus détaillées sur cette définition de tâche distante.
    4. Cliquez sur Envoyer.
    5. Ouvrez ce nouvel enregistrement de définition de tâche distante.
    6. Dans l’onglet connexe Champs entrants , cliquez sur Nouveau.
    7. Renseignez les champs du formulaire.
      Les champs entrants vous permettent de recevoir des données de l’instance du consommateur lorsqu’une tâche distante est créée ou mise à jour.
      Remarque :
      Si les valeurs des champs entrants sont mises à jour, les informations mises à jour sont affichées dans une note de travail sur l’enregistrement parent.
      Tableau 2. Formulaire de champ entrant
      Champ Description
      Étiquette de champ Étiquette de champ qui apparaît sur le formulaire de tâche distante.
      Nom de champ Nom de champ utilisé dans le flux de tâches distantes et le script.
      Longueur max. Longueur maximale du nom de champ source.
      Synchroniser quand Permet de spécifier quand un champ cible de l’enregistrement parent de la tâche distante est directement mis à jour. Vous pouvez sélectionner :
      • Insérer: Met à jour le champ cible de l’enregistrement parent de la tâche distante uniquement lorsque la tâche distante est initialement insérée.
      • Insérer ou mettre à jour : met à jour le champ cible sur l’enregistrement parent de la tâche distante chaque fois que la tâche distante est mise à jour.
      • Jamais : le champ entrant ne met jamais à jour directement un champ cible sur l’enregistrement parent de la tâche distante. Par exemple, vous pouvez utiliser ce champ pour le mappage d’états où un flux est utilisé pour convertir la valeur entrante avant de mettre à jour le champ cible.
      Remarque :
      Quelle que soit l’option que vous sélectionnez ici, chaque fois qu’un champ entrant est mis à jour, les modifications sont reflétées dans une note de travail sur l’enregistrement parent.
      Onglet Mappage de source Cet onglet n’est pas affiché si vous avez coché la case Virtuel pour définir un mappage de champs virtuels.
      Table source (lecture seule) La table Consommateur que vous avez sélectionnée lors de la création de la définition de tâche distante.
      Champ source Champ de la table source qui est envoyé à une autre ServiceNow instance.

      Les champs sources permettent de remonter pas à pas vers les données des tables connexes, ce qui est utile lorsque les données de référence ne sont pas disponibles entre ServiceNow les instances. Par exemple, vous pouvez créer plusieurs mappages entrants pour les incidents de changement (CI) afin d’inclure le nom, la classe, l’adresse IP et la balise d’actif.
      Onglet Mappage cible Affiché uniquement dans les conditions suivantes :
      • Synchroniser quand : vous sélectionnez Insérer ou Insérer ou mettre à jour.
      • Virtuel : cochez cette case pour activer le mappage de champs virtuels.
      Table cible (lecture seule) La table Fournisseur que vous avez sélectionnée lors de la création de la définition de tâche distante.
      Champ cible Champ de la table cible qui est envoyé à une autre ServiceNow instance.
      Remarque :
      Si vous définissez un mappage de champs virtuels, le champ que vous sélectionnez dans la table cible ne figure pas dans la table source.
      Actif Ce champ est activé par défaut.
      Virtuel

      Cochez cette case pour activer le mappage des champs entrants virtuels. Un champ virtuel est un champ présent dans la table cible, mais qui n’existe pas dans la table source.

      Lorsqu’une table source ne contient pas de champ qui existe sur une table cible, le champ est configuré en tant que champ virtuel. Les valeurs spécifiées pour le champ virtuel sont transmises de l’instance source à l’instance cible. Le consommateur peut créer une tâche à distance pour synchroniser des données et mettre à jour la valeur du champ virtuel dans l’enregistrement de tâche cible associé.

      Le champ cible peut être mis à jour à l’aide de l’option Virtual Inbound décrite dans ou Créer une transformation dans Service Bridge à l’aide de l’API updateVirtualField .
    8. Cliquez sur Envoyer.
    9. Dans l’onglet connexe Champs sortants , cliquez sur Nouveau.
    10. Renseignez les champs du formulaire.
      Les champs sortants vous permettent d’envoyer des données à l’instance du consommateur lorsqu’une tâche distante est créée ou mise à jour.
      Tableau 3. Formulaire de champ sortant
      Champ Description
      Étiquette de champ Nom de l’étiquette de champ qui apparaît sur le formulaire de tâche distante.
      Nom de champ Nom de champ utilisé dans le flux de tâches distantes et le script.
      Longueur max. Longueur maximale du nom de champ.
      Synchroniser quand la suggestion Vous (le fournisseur) pouvez suggérer au consommateur quand un champ cible de l’enregistrement parent de la tâche distante doit être directement mis à jour. Le consommateur peut modifier ce paramètre avant d’activer la définition
      • Insérer: Met à jour le champ cible de l’enregistrement parent de la tâche distante uniquement lorsque la tâche distante est initialement insérée.
      • Insérer ou mettre à jour : met à jour le champ cible sur l’enregistrement parent de la tâche distante chaque fois que la tâche distante est mise à jour.
      • Jamais : le champ entrant ne met jamais à jour directement un champ cible sur l’enregistrement parent de la tâche distante. Par exemple, vous pouvez utiliser ce champ pour le mappage d’états où un flux est utilisé pour convertir la valeur entrante avant de mettre à jour le champ cible.
      Onglet Mappage de source Cet onglet n’est pas affiché si vous avez coché la case Virtuel pour définir un mappage de champs virtuels.
      Table source (lecture seule) La table Fournisseur que vous avez sélectionnée lors de la création de la définition de tâche distante.
      Champ source Champ de la table source qui est envoyé à une autre ServiceNow instance.

      Les champs sources permettent de remonter pas à pas vers les données des tables connexes, ce qui est utile lorsque les données de référence ne sont pas disponibles entre ServiceNow les instances. Par exemple, vous pouvez créer plusieurs mappages entrants pour les incidents de changement (CI) afin d’inclure le nom, la classe, l’adresse IP et la balise d’actif.
      Onglet Mappage cible Affiché uniquement dans les conditions suivantes :
      • Synchroniser quand : vous sélectionnez Insérer ou Insérer ou mettre à jour.
      • Virtuel : cochez cette case pour activer le mappage de champs virtuels.
      Table cible (lecture seule) La table Consommateur que vous avez sélectionnée lors de la création de la définition de tâche distante.
      Champ cible Champ de la table cible qui est envoyé à une autre ServiceNow instance.
      Remarque :
      Si vous définissez un mappage de champs virtuels, le champ que vous sélectionnez dans la table cible ne figure pas dans la table source.
      Actif Ce champ est activé par défaut.
      Virtuel

      Cochez cette case pour activer le mappage des champs entrants virtuels. Un champ virtuel est un champ présent dans la table cible, mais qui n’existe pas dans la table source.

      Lorsqu’une table source ne contient pas de champ qui existe sur une table cible, le champ est configuré en tant que champ virtuel. Les valeurs spécifiées pour le champ virtuel sont transmises de l’instance source à l’instance cible.

      Le champ cible peut être mis à jour à l’aide de l’option Sortant virtuel décrit dans ou Créer une transformation dans Service Bridge à l’aide de l’API updateVirtualField.
    11. Cliquez sur Envoyer.
    12. Dans l’onglet connexe Critères de consommateur , cliquez sur Nouveau.
    13. Renseignez les champs du formulaire.
      Les critères de consommateur vous permettent de gérer les consommateurs qui peuvent utiliser ces définitions de tâches distantes.
      Tableau 4. Formulaire Critères de consommateur
      Champ Description
      Condition du consommateur Société ou compte client auquel vous souhaitez autoriser cette définition de tâche distante.
      Définition de la tâche distante Nom de cet enregistrement de définition de tâche distante. Ce nom est renseigné automatiquement.

      Pour en savoir plus sur les critères de consommation, reportez-vous à Création d’autorisations dans Service Bridge pour les fournisseurs.

    14. Cliquez sur Publier.

      Les variables de tâches distantes sont automatiquement créées lorsque vous publiez une définition de tâche distante. Ces variables sont les variables de données pour les champs entrants affichés et accessibles sur les tâches distantes.

      Remarque :
      • Cliquez sur Mettre hors service pour désactiver une définition de tâche distante qui n’est plus requise. Les tâches distantes existantes peuvent continuer à utiliser la définition de tâche distante mise hors service, mais vous ne pouvez pas l’utiliser pour créer de nouvelles tâches distantes.
      • Cliquez sur Supprimer pour supprimer une définition de tâche distante mise hors service si elle n’est plus requise.
      • Pour modifier une définition de tâche distante publiée, cliquez sur Modifier. Modifiez la définition de tâche distante au besoin et cliquez sur Publier.

    Résultats

    Un enregistrement de définition de tâche distante est créé sur votre instance. Cet enregistrement est également synchronisé avec l’instance de votre client et est maintenant en attente d’activation sur l’instance de votre consommateur. Si le champ Activer automatiquement la définition de tâche distante a été activé par le consommateur, la définition de tâche distante est automatiquement activée sur l’instance de votre consommateur.