---
sourceDocument: Interface utilisateur de la Now Platform Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/platform-user-interface

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Interface utilisateur de la Now Platform Xanadu

ft:clusterId :

    - platux

bundleId :

    - platux

workflow :

    - Platform


---

# Configurer l'ajout d'enregistrements à une liste connexe

# Configurer l'ajout d'enregistrements à une liste connexe {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 minutes de lecture

Créez un bouton Ajouter afin que les agents puissent ajouter des enregistrements à une liste connexe.

## Avant de commencer

Rôle requis : workspace_admin

## Pourquoi et quand exécuter cette tâche

Vous pouvez créer un bouton Ajouter qui permet aux agents d'ajouter des enregistrements à des listes. Cette fonctionnalité prend en charge les tables un-à-plusieurs (o2m) et plusieurs-à-plusieurs (m2m). Dans l'exemple suivant, nous utilisons les tables task_location et créons le bouton Ajouter pour les incidents. Ainsi, lorsque vous ouvrez un incident, vous pouvez cliquer sur la nouvelle liste connexe, Emplacements affectés, pour voir les incidents (tâches) qui se sont produits au même emplacement. De nombreux incidents peuvent se produire à un seul endroit, et un incident peut impliquer plusieurs emplacements.

La procédure générale consiste à ajouter la liste connexe, Emplacements affectés associée à la table plusieurs à plusieurs, task_location, puis à créer une action d'espace de travail pour créer le bouton Ajouter qui ajoute, dans notre exemple, des emplacements à un incident.

Lorsqu'un agent clique sur Ajouter, un modal s'ouvre et affiche les emplacements des agents où l'incident peut être ajouté.

Pour comprendre l'exemple suivant, saisissez <kbd class="ph userinput">task_location.list</kbd> dans le navigateur de filtre pour afficher la table task_location.

La table affiche les associations entre les tables d'emplacement (cmn_location) et de tâche (tâche). Dans l'exemple, il n'y en a pas.

## Procédure

1. Ajoutez une nouvelle liste connexe, Emplacements affectés, qui s'ouvre avec les enregistrements d'incidents.
   1. Ouvrez un incident en accédant à IncidentOuvrir et cliquez sur un incident.
   2. Pour confirmer que vous êtes dans la vue Espace de travail, cliquez sur l'icône de votre profil ( ![icône de menu]()), en sélectionnant Configurer la page, puis en sélectionnant Mise en page.
   3. Configurez une liste connexe pour la table Incident en cliquant sur l'icône de votre profil ( ![icône de menu]()), en sélectionnant Configurer la page, puis en sélectionnant Listes connexes.
   4. Dans le formulaire Configurer les listes connexes sur l'incident, dans Nom de la vue, sélectionnez Espace de travail.
   5. Sélectionnez Emplacements affectés et utilisez les flèches pour les déplacer dans la colonne Sélectionné .  
      La valeur task_location est appelée Emplacements affectés.
   6. Cliquez sur Enregistrer.  
      Vous avez ajouté les emplacements affectés en tant que liste connexe pour tous les enregistrements d'incidents.

   {#set-up-adding-records-to-related-lists__substeps_p1g_nbx_njb}
2. Utilisez une action de l'espace de travail pour créer un bouton Ajouter qui permet aux agents d'ajouter des emplacements à un incident.
   1. Accédez à la Expérience d'espace de travailActions et composantsActions sur la liste connexe et cliquez sur Nouveau.
   2. Renseignez les champs du formulaire.  
      {#set-up-adding-records-to-related-lists__table_awd_vvl_kjb__entry__2}

      | Champ | Description |
      |-|-|
      | Étiquette de l'action | Étiquette qui apparaît sur le bouton dans la zone Listes connexes. Faites cet <kbd class="ph userinput">ajout</kbd>. Dans l'image précédente, le bouton Ajouter apparaîtra à côté du bouton Nouveau . |
      | Nom de l'action | Nom de cet enregistrement qui apparaît dans la liste des actions de liste connexe, Expérience d'espace de travailActions et composantsActions sur la liste connexe. |
      | Implémenté en tant que | Sélectionnez Composant de l'interface utilisateur , car vous créez un bouton. |
      | Spécifier le composant d'interface utilisateur | Sélectionnez sn-multi-record-associator. |
      | Type de bouton | Sélectionnez Primaire. Les boutons primaires sont verts. Les boutons secondaires sont gris. |
      | Sélection d'enregistrements obligatoire | Case à cocher pour rendre la sélection d'enregistrement obligatoire. |
      | Info-bulle | Texte qui s'affiche lorsque les agents passent la souris sur le composant de l'interface utilisateur. |
      | Description | Description détaillée de cette action d'espace de travail. |
      | Application | Application à laquelle ce composant s'applique. Global signifie que le composant s'applique à toutes les applications. |
      | Espace de travail | Espace de travail dans lequel ce composant d'interface utilisateur apparaît. |
      | Table | Table dans laquelle cette action de liste connexe s'affiche. * Pour une relation o2m, assurez-vous que la table est votre table de liste connexe o2m. Par exemple, incident. * Pour une relation m2m, assurez-vous que la table est votre table m2m. Par exemple, task_location. {#set-up-adding-records-to-related-lists__ul_fk3_v3t_vlb}Dans notre exemple, sélectionnez task_location. |
      | Vue | Sélectionnez l'espace de travail. |
      | Actif | Activer/désactiver pour activer (sélectionné) et désactiver ce composant d'interface utilisateur. |
      | Ordre | Ordre de séquence dans lequel ce composant d'interface utilisateur apparaît dans une liste horizontale de composants d'interface utilisateur. Plus la valeur est faible, plus l'emplacement est éloigné. |
      [Tableau 1. Formulaire Affectation d'action]

      {#set-up-adding-records-to-related-lists__table_awd_vvl_kjb}
   3. Sous Liens connexes, cliquez sur Vue avancée pour donner au composant les propriétés dont il a besoin pour fonctionner.
   4. Renseignez les champs de l'onglet Component Attributes (Attributs du composant ).  
      {#set-up-adding-records-to-related-lists__table_zw4_2fx_njb__entry__2}

      | Champ | Description |
      |-|-|
      | étiquette | Nom qui apparaît en haut du modal lorsque vous cliquez sur le bouton Ajouter . |
      | extensionPoint | Dans notre exemple, laissez ce champ vide. Ce champ filtre la liste dans le modal. Lorsqu'un agent clique sur Ajouter, toutes les associations possibles s'affichent entre les tables de cmn_location et de tâches. Ce champ empêche certaines de ces associations. Pour savoir comment créer un point d'extension, reportez-vous [à la section Utilisation de points d'extension pour étendre les fonctionnalités de l'application](https://www.servicenow.com/docs/access?context=extension-points&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US). |
      | userGivenTable | Table qui apparaît dans le modal. Dans notre exemple, nous voulons ouvrir les emplacements que les agents peuvent ajouter, alors sélectionnez cmn_location. * Sélectionnez task_location pour les relations M2M. * Pour les relations o2m, sélectionnez la table associée à la partie many de votre o2m. Par exemple, Incident. {#set-up-adding-records-to-related-lists__ul_ab4_wnn_vlb} |
      | hideSelectAll | Champ qui vous permet de masquer Sélectionner tout. Sélectionnez Vrai pour masquer Sélectionner tout. |
      | referencedfieldName | Champ affiché dans le modal à partir de userGivenTable. Dans notre exemple, entrez <kbd class="ph userinput">l’emplacement</kbd> (en minuscules). Pour trouver le nom du champ, cliquez avec le bouton droit sur le titre du champ Emplacement sur le formulaire de table plusieurs-à-plusieurs. Ce champ n'est pas utilisé pour les relations o2m. |
      | type | Type de relation d'enregistrement. Sélectionnez une relation o2m ou m2m pour les enregistrements. * O2M active un enregistrement parent dans une table qui peut faire référence à plusieurs enregistrements enfants. * M2M active plusieurs enregistrements dans une table qui sont associés à plusieurs enregistrements dans une autre table. {#set-up-adding-records-to-related-lists__ul_tpx_yln_vlb} |
      | parentFieldName | Nom du champ à partir duquel vous faites référence, dans cet exemple, il s'agit <kbd class="ph userinput">d’une tâche</kbd>. Pour trouver le nom du champ, cliquez avec le bouton droit sur le titre du champ. |
      | colonnes | Liste séparée par des virgules de colonnes que vous souhaitez afficher dans le modal. Par exemple, dans la table cmn_location, vous pouvez vouloir le nom et la ville. Alors, entrez <kbd class="ph userinput">le nom, la ville</kbd>. |
      | vue | Vue de la liste. N'ajoutez pas de valeur ; La vue par défaut est FINE. |
      [Tableau 2. Formulaire d'attributs de composant]

      {#set-up-adding-records-to-related-lists__table_zw4_2fx_njb}
   5. Cliquez sur Mettre à jour.  
      Vous avez créé un bouton Ajouter qui s'affiche dans la zone Listes connexes lorsqu'un enregistrement d'incident s'ouvre.
   {#set-up-adding-records-to-related-lists__substeps_qnv_4dx_njb}
3. Assurez-vous que le bouton Ajouter s'affiche et fonctionne.
   1. Ouvrez un incident en accédant à IncidentOuvrir et en cliquant sur un incident.
   2. Cliquez sur la liste connexe des emplacements affectés .  
      Vous devriez voir le bouton Ajouter dans les listes connexes.
   3. Cliquez sur Ajouter.  
      Une fenêtre modale s'affiche.

   4. Cochez plusieurs cases pour ajouter ces adresses à l'enregistrement d'incident, puis cliquez sur Ajouter.  
      Les adresses que vous avez sélectionnées apparaissent dans Emplacements affectés.

   5. Entrez <kbd class="ph userinput">task_location.list</kbd> dans le navigateur de filtre pour afficher la table task_location.  
      Les nouveaux emplacements doivent apparaître dans la table.
   {#set-up-adding-records-to-related-lists__substeps_edf_f3x_njb}
4. Ajoutez une action de suppression.  
   Vous pouvez créer un bouton Supprimer qui permet aux agents de supprimer des enregistrements d'une liste connexe et de dissocier cet enregistrement de la table parente. Cette fonctionnalité prend en charge les tables o2m et m2m.
   1. Accédez à la Expérience d'espace de travailActions et composantsActions sur la liste connexe et cliquez sur Nouveau.
   2. Renseignez les champs du formulaire.  
      {#set-up-adding-records-to-related-lists__table_lx5_tht_vlb__entry__2}

      | Champ | Description |
      |-|-|
      | Étiquette de l'action | Étiquette qui apparaît sur le bouton dans la zone Listes connexes. Assurez-vous que l'étiquette de l'action inclut ({{count}}) . |
      | Nom de l'action | Nom de cet enregistrement qui apparaît dans la liste des actions de liste connexe, Expérience d'espace de travailActions et composantsActions sur la liste connexe. |
      | Implémenté en tant que | Sélectionnez Script serveur. |
      | Spécifier le composant d'interface utilisateur | Sélectionnez sn-multi-record-associator. |
      | Type de bouton | Sélectionnez Primaire. Les boutons primaires sont verts. Les boutons secondaires sont gris. |
      | Sélection d'enregistrements obligatoire | Case à cocher pour rendre la sélection d'enregistrement obligatoire. Décochez la case. |
      | Info-bulle | Texte qui s'affiche lorsque les agents passent la souris sur le composant de l'interface utilisateur. |
      | Description | Description détaillée de cette action d'espace de travail. |
      | Application | Application à laquelle ce composant s'applique. Global signifie que le composant s'applique à toutes les applications. |
      | Espace de travail | Espace de travail dans lequel ce composant d'interface utilisateur apparaît. |
      | Table | Table dans laquelle cette action de liste connexe s'affiche. * Pour une relation o2m, assurez-vous que la table est votre table de liste connexe o2m. Par exemple, incident. * Pour une relation m2m, assurez-vous que la table est votre table m2m. Par exemple, task_location. {#set-up-adding-records-to-related-lists__ul_a5q_bjt_vlb}Dans notre exemple, sélectionnez task_location. |
      | Vue | Sélectionnez l'espace de travail. |
      | Actif | Activer/désactiver pour activer (sélectionné) et désactiver ce composant d'interface utilisateur. |
      | Ordre | Ordre de séquence dans lequel ce composant d'interface utilisateur apparaît dans une liste horizontale de composants d'interface utilisateur. Plus la valeur est faible, plus l'emplacement est éloigné. |
      [Tableau 3. Formulaire Affectation d'action]

      {#set-up-adding-records-to-related-lists__table_lx5_tht_vlb}
   3. Cliquez sur l'icône de menu ( ![icône Menu]()), puis cliquez sur Enregistrer.
   4. Sous Liens connexes , cliquez sur Vue avancée.
   5. Cliquez sur l'onglet Script serveur .
   6. Entrez un script serveur dans le champ Scripting. <kbd class="ph userinput">current.deleteRecord()&nbsp;;</kbd> dans le champ de script du serveur.  
      * Pour les relations m2m, entrez <kbd class="ph userinput">current.deleteRecord()&nbsp;;</kbd>.
      * Pour les relations o2m, entrez <kbd class="ph userinput">actuel.[ field_name] = ''&nbsp;; current.update()&nbsp;;</kbd>.
      {#set-up-adding-records-to-related-lists__ul_rxf_ykt_vlb}
   7. Sous Liens connexes , cliquez sur Vue avancée, puis sur l'onglet Paramètres de confirmation .
   8. Activer/désactiver la confirmation requise.
   9. Cliquez sur Mettre à jour.
   {#set-up-adding-records-to-related-lists__substeps_dgs_ygx_wlb}

## Que faire ensuite

Cliquez sur un composant pour le configurer.

|-|-|-|
| * [Onglets](https://servicenow-prod.fluidtopics.net/t8zMmTMOPp5OUp5T8cKoqQ "Permettez aux agents de créer les enregistrements dont ils ont besoin pour effectuer leur travail dans Espace de travail.") * [Notifications](https://servicenow-prod.fluidtopics.net/izfnSsAEiBATZRbt5MoMfw "Envoyez des notifications à un agent ou à un petit groupe d’agents lorsqu’il y a des mises à jour d’enregistrements importants.") * [En-tête de formulaire](https://servicenow-prod.fluidtopics.net/vnoodoX95n5Y2vXmNpuyxg "Configurez le champ primaire et les valeurs secondaires dans les en-têtes de formulaire afin que les agents puissent rapidement s’orienter vers un problème.") * [Actions d'interface utilisateur](https://servicenow-prod.fluidtopics.net/u8DNSR8ofxl3RTLPSvgXdA "Configurez des actions d’interface utilisateur à personnaliser legacy workspace pour votre organisation. Les actions d’interface utilisateur incluent des boutons personnalisés, des éléments de menu et la limitation de l’accès aux formulaires en fonction du rôle d’un utilisateur.") {#set-up-adding-records-to-related-lists__ul_stg_plv_pjb} | * [Ruban](https://servicenow-prod.fluidtopics.net/O4we7wNXOHQjAK6yeemhqw "Configurez des rubans pour legacy workspace aider les agents à analyser rapidement les informations pertinentes sur un enregistrement, telles que la chronologie de l’enregistrement, un résumé du client et les SLA d’enregistrement.") * [Éléments BSM connexes de nouvelle génération](https://servicenow-prod.fluidtopics.net/9Fds2HgtgRK4Wc2SSI~OYA "Configurez les éléments associés à l’enregistrement ouvert afin que les agents puissent mieux comprendre l’enregistrement et son impact.") * [Panneau du formulaire](https://servicenow-prod.fluidtopics.net/bIl0b~qiYY~dS7~~pks_Rw "Sélectionnez les champs qui s’affichent dans le volet de formulaire pour aider les agents à faire leur travail.") * [Actions et composants](https://servicenow-prod.fluidtopics.net/Db3N~_dmbwFGPo5uSDFytA "Interagir avec les formulaires, les champs, les listes et les pages de listes connexes de votre espace de travail en ajoutant des actions personnalisées.") {#set-up-adding-records-to-related-lists__ul_lyk_qlv_pjb} | * [Flux d'activité](https://servicenow-prod.fluidtopics.net/xFsc5NTDleYBgCZq0CYz2A "Configurez les options dont les agents peuvent interagir pour Flux d'activité simplifier leur travail.") * [Panneau latéral contextuel](https://servicenow-prod.fluidtopics.net/zITKaDftKKCWms8wdgXitg "Le panneau latéral contextuel fournit aux agents des outils pour la recherche et la résolution des problèmes. Les différents composants fournissent aux agents différents types d’aide.") {#set-up-adding-records-to-related-lists__ul_hgc_rlv_pjb} |
[ ]

{#set-up-adding-records-to-related-lists__table_dxj_nlv_pjb}