Configurer l’ajout d’enregistrements à une liste connexe

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 task_location.list 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 à Incident > Ouvrir 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 ( ), 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 ( ), 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.

      

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 travail > Actions et composants > Actions sur la liste connexe et cliquez sur Nouveau.
   2. Renseignez les champs du formulaire.

      Tableau 1. Formulaire Affectation d’action

      Champ	Description
      Étiquette de l'action	Étiquette qui apparaît sur le bouton dans la zone Listes connexes. Faites cet ajout. 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 travail > Actions et composants > Actions 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. 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é.

   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 ).

      Tableau 2. Formulaire d’attributs de composant

      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.
      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.
      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 l’emplacement (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.
      parentFieldName	Nom du champ à partir duquel vous faites référence, dans cet exemple, il s’agit d’une tâche. 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 le nom, la ville.
      vue	Vue de la liste. N’ajoutez pas de valeur ; La vue par défaut est FINE.

   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.
3. Assurez-vous que le bouton Ajouter s’affiche et fonctionne.
   1. Ouvrez un incident en accédant à Incident > Ouvrir 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 task_location.list dans le navigateur de filtre pour afficher la table task_location.
      Les nouveaux emplacements doivent apparaître dans la table.
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 travail > Actions et composants > Actions sur la liste connexe et cliquez sur Nouveau.
   2. Renseignez les champs du formulaire.

      Tableau 3. Formulaire Affectation d’action

      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 travail > Actions et composants > Actions 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. 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é.

   3. Cliquez sur l’icône de 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. current.deleteRecord() ; dans le champ de script du serveur.
      • Pour les relations m2m, entrez current.deleteRecord() ;.
      • Pour les relations o2m, entrez actuel.[ field_name] = '' ; current.update() ;.
   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.

Que faire ensuite

Cliquez sur un composant pour le configurer.

Onglets Notifications En-tête de formulaire Actions d'interface utilisateur

Ruban Éléments BSM connexes de nouvelle génération Panneau du formulaire Actions et composants

Flux d'activité Panneau latéral contextuel