Configurer l’ajout d’enregistrements à une liste connexe

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 7 minutes de lecture

    • Créez un bouton Ajouter pour 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 afficher 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, les emplacements affectés qui est 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.

    Bouton Ajouter de la liste connexe

    Lorsqu’un agent clique sur Ajouter, une fenêtre modale s’ouvre indiquant les emplacements des agents où l’incident peut être ajouté.

    Modal pour les emplacements.

    Pour comprendre l’exemple suivant, saisissez task_location.list dans le navigateur de filtre pour afficher la table task_location.

    Table emplacement-tâche.

    La table montre les associations entre les tables d’emplacement (cmn_location) et de tâches (task). 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 > Ouvert et cliquez sur un incident.
      2. Confirmez que vous êtes dans la vue Espace de travail en cliquant 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 Incidents en cliquant sur l’icône de profil ( icône de menu), en sélectionnant Configurer la page, puis en sélectionnant Listes connexes.
      4. Dans le formulaire Configuration des listes connexes sur incident, dans Nom de la vue, sélectionnez Espace de travail.
      5. Sélectionnez les 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.

        Emplacements affectés.

    2. Utilisez une action d’espace de travail pour créer un bouton Ajouter permettant 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 la liste connexes, Expérience d'espace de travail > Actions et composants > Actions sur la liste connexe.
        Implémenté en tant que Sélectionnez Composant d’interface utilisateur parce que 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 de l’espace de travail.
        Demande 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 sur 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 Activez/désactivez (sélectionné) et désactivez ce composant d’interface utilisateur.
        Commande Ordre de séquence dans lequel ce composant de l’interface utilisateur apparaît dans une liste horizontale de composants de l’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 Attributs des composants .
        Tableau 2. Formulaire Attributs du composant
        Champ Description
        étiquette Nom qui apparaît en haut du modal lorsque vous cliquez sur le bouton Ajouter .

        Titre modal.
        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 sont affichées entre les tables cmn_location et de tâches. Ce champ empêche certaines de ces associations. Pour savoir comment créer un point d’extension, consultez Utilisation de points d’extension pour étendre les fonctionnalités de l’application.
        userGivenTable Table qui s’affiche 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 plusieurs 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, saisissez 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 la table plusieurs à plusieurs.

        Nom de champ.

        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 référencer 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 effectuez la 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.

        Champ de tâche.
        colonnes Liste séparée par des virgules des 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 nom, ville.
        vue Vue de la liste. N’ajoutez pas de valeur ; La vue par défaut est correcte.
      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 apparaît et fonctionne.
      1. Ouvrez un incident en accédant à Incident > Ouvert et en cliquant sur un incident.
      2. Cliquez sur la liste connexe Emplacements affectés .
        Le bouton Ajouter doit s’afficher dans les listes connexes.
      3. Cliquez sur Ajouter.
        Un modal apparaît.

        Modal pour les emplacements.

      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 les emplacements affectés.

        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. Ajouter 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 la liste connexes, 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. 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 de l’espace de travail.
        Demande 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 sur 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 Activez/désactivez (sélectionné) et désactivez ce composant d’interface utilisateur.
        Commande Ordre de séquence dans lequel ce composant de l’interface utilisateur apparaît dans une liste horizontale de composants de l’interface utilisateur. Plus la valeur est faible, plus l’emplacement est éloigné.
      3. Cliquez sur l’icône de menu (icône Menu), puis 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 de scripting. current.deleteRecord() ; dans le champ de script serveur.
        • Pour les relations m2m, saisissez 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.

    Vue d'enregistrement