Créer des définitions de tâches à distance pour les Échange de services fournisseurs dans Services digitaux pour le secteur public
En tant que fournisseur d’agence gouvernementale, vous pouvez créer des définitions de tâches distantes qui déclenchent l’affectation de tâches distantes à votre membre. Les tâches à distance proviennent de l’instance du fournisseur de l’agence (où ils créent automatiquement un enregistrement de ticket gouvernemental associé) et sont transmises à votre membre via le Portail des services publics, ce qui permet au fournisseur et au consommateur de synchroniser les enregistrements et les détails des tickets.
Avant de commencer
Rôle requis : admin
Procédure
- Accédez à la Tous > Fournisseur de Pont de services > Administration > Définitions de tâches distantes.
- Cliquez sur Nouveau.
-
Remplissez 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 la tâche distante. Application Il s’agit d’un champ en lecture seule. Il est 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 Échange de services version utilisée par le fournisseur. Si le consommateur utilise une version compatible Échange de services , les données peuvent être synchronisées entre les instances du fournisseur et du consommateur. Toutefois, si le consommateur 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 Échange de services n’est pas mise à niveau. Gérer SysID Si ce champ est coché, l’identificateur unique, SysID, associé au parent qui a créé la tâche distante est utilisé et affecté à la tâche parente créée pour la tâche distante sur l’instance du consommateur. 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 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. - Cliquez sur Envoyer.
- Ouvrez ce nouvel enregistrement de définition de tâche distante.
- Cliquez sur Nouveau dans l’onglet connexe Champs entrants.
-
Remplissez 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 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 du 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 de 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 virtuel. Table source (lecture seule) La table Consumer (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 une remontée pas à pas vers les données dans les 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 : cochez cette case pour activer le mappage de champs virtuel.
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 champ virtuel, le champ que vous sélectionnez dans la table cible n’est pas présent dans la table source.Actives 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 existant 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 les 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 Create a transform in Service Exchange ou à l’aide de l’API updateVirtualField .
- Cliquez sur Envoyer.
- Dans l’onglet connexe des champs sortants , cliquez sur Nouveau.
-
Remplissez 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 du 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.
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 virtuel. 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 une remontée pas à pas vers les données dans les 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 : cochez cette case pour activer le mappage de champs virtuel.
Table cible (lecture seule) La table Consumer (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 champ virtuel, le champ que vous sélectionnez dans la table cible n’est pas présent dans la table source.Actives 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 existant 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 Create a transform in Service Exchange ou à l’aide de l’API updateVirtualField.
- Cliquez sur Envoyer.
- Cliquez sur Nouveau dans l’onglet connexe Critères de consommateur.
-
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 distantes.
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 Creating entitlements in Service Exchange for Providers.
-
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.