Créer une définition de tâche à distance dans Pont de services pour les fournisseurs

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 9 minutes de lecture

    • En tant que fournisseur, créez des définitions de tâches à distance (RTD) qui déclenchent l’affectation d’une tâche à distance.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Avant de pouvoir créer une tâche distante, vous devez d’abord créer un RTD. Une tâche distante est générée en fonction du RTD que vous définissez. Pour en savoir plus sur le fonctionnement de RTD et de la tâche à distance, reportez-vous à la section Tâches à distance.

    Procédure

    1. Accédez à la Tous > Fournisseur de Pont de services > Administration > Définitions de tâches distantes.
    2. Sélectionnez Nouveau.
    3. Remplissez les champs du formulaire.
      Tableau 1. Formulaire de définition de la tâche à distance
      Champ Description
      Nom Nom de l’enregistrement de définition de tâche distante.
      Application Il s’agit d’un champ en lecture seule, défini par défaut en fonction du périmètre de l’application.
      État Affiche l’état de la définition de tâche distante. Lorsque vous créez une définition de tâche distante, ce champ est défini sur l’état Brouillon .
      Remarque :
      Ce champ est automatiquement mis à jour lorsque vous publiez, archivez ou mettez hors service une 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.
      Compatibilité Ce champ est renseigné par défaut. Il affiche la Pont de services version utilisée par le fournisseur. Si le consommateur utilise une version compatible Pont de services , les données peuvent être synchronisées entre les instances du fournisseur et du consommateur. Cependant, si le client n’utilise pas de version compatible, les nouvelles définitions de tâches distantes ne peuvent pas être activées tant que la version correspondante Pont de services n’est pas mise à niveau.
      Envoyer des pièces jointes Si cette case est cochée, si une pièce jointe est ajoutée à l’enregistrement parent, elle est envoyée à la tâche distante.
      Description brève Informations brèves sur cette définition de tâche distante.
      Description Plus d’informations détaillées sur cette définition de tâche distante.
    4. Sélectionnez Soumettre.
    5. Ouvrez ce nouvel enregistrement de définition de tâche distante.
    6. Dans l’onglet connexe des champs entrants , sélectionnez Nouveau.
      À partir de la version 2.2.x, un enregistrement de Pont de services champ sortant est créé avec les champs source et cible définis comme commentaires. Cet enregistrement active les mappages de commentaires à commentaires pour votre RTD.
    7. Remplissez les champs du formulaire.
      Les champs entrants vous permettent de recevoir des données de l’instance du consommateur lorsqu’une tâche à distance est créée ou mise à jour.
      Remarque :
      Si les valeurs de champ entrantes 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 et le script de tâches distantes.
      Longueur max. Longueur maximale du nom de champ source.
      Synchroniser quand Vous permet de spécifier quand un champ cible sur l’enregistrement parent de la tâche distante est directement mis à jour. Vous pouvez sélectionner :
      • Insérer: Met à jour le champ cible sur 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’état 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 changements sont reflétés dans une note de travail sur l’enregistrement parent.
      Onglet Mappage de source Cet onglet ne s’affiche pas si vous avez coché la case Virtual (Virtuel ) pour définir un mappage de champs virtuels.
      Table source (lecture seule) 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érerou Insérer ou mettre à jour.
      • Virtuel : vous cochez cette case pour activer le mappage de champs virtuels.
      Table cible (lecture seule) 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 de 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 dans une table cible, le champ est configuré comme un 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 Entrant virtuel décrite dans le Créer une transformation dans Pont de services ou à l’aide de l’API updateVirtualField .
    8. Cliquez sur Envoyer.
    9. Dans l’onglet connexe des champs sortants , cliquez sur Nouveau.
      À partir de la version 2.2.x, un enregistrement de Pont de services champ sortant est créé avec les champs source et cible définis comme commentaires. Cet enregistrement active les mappages de commentaires à commentaires pour votre RTD.
    10. Remplissez les champs du formulaire.
      Les champs sortants vous permettent d’envoyer des données à l’instance du consommateur lorsqu’une tâche à distance 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 et le script de tâches distantes.
      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 sur 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’état où un flux est utilisé pour convertir la valeur entrante avant de mettre à jour le champ cible.
      Synchroniser les entrées préexistantes Option permettant d’activer la synchronisation de tous les commentaires existants avec la tâche cible lorsqu’une connexion est établie. Si cette option est activée, tous les commentaires formulés avant la connexion sont inclus dans le processus de synchronisation lorsqu’une tâche à distance est créée.
      Remarque :
      Cette fonctionnalité est disponible à partir de la Pont de services version 2.2.x.
      Onglet Mappage de source Cet onglet ne s’affiche pas si vous avez coché la case Virtual (Virtuel ) pour définir un mappage de champs virtuels.
      Table source (lecture seule) 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.

      Remarque :
      À partir de la Pont de services version 2.2.x, vous pouvez créer
      Onglet Mappage cible Affiché uniquement dans les conditions suivantes :
      • Synchroniser quand : Vous sélectionnez Insérerou Insérer ou mettre à jour.
      • Virtuel : vous cochez cette case pour activer le mappage de champs virtuels.
      Table cible (lecture seule) 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 de 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 dans une table cible, le champ est configuré comme un 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écrite dans le Créer une transformation dans Pont de services ou à l’aide de l’API updateVirtualField.
    11. Cliquez sur Envoyer.
    12. Dans l’onglet connexe Critères de consommateur , cliquez sur Nouveau.
    13. Remplissez 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 à distance.
      Tableau 4. Formulaire Critères du consommateur
      Champ Description
      Condition du consommateur Entreprise ou compte client auquel vous souhaitez que cette définition de tâche distante ait droit.
      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 consommateur, reportez-vous à la section Création d’autorisations dans Pont de services 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 des champs entrants affichés et accessibles sur les tâches distantes.

    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.

    Que faire ensuite

    Vous pouvez créer plusieurs révisions de configuration de cette définition de tâche distante publiée. Pour plus d’informations sur la création d’une révision de configuration, reportez-vous à la section Créer des révisions de configuration. Vous pouvez également effectuer les opérations suivantes :