Configurer l’ajout d’enregistrements à une liste connexe

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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.

    Bouton Ajouter une liste connexe

    Lorsqu’un agent clique sur Ajouter, un modal s’ouvre et affiche 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 Location-task.

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

        Emplacements affectés.

    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 .

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

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

        Champ Tâche.
        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.

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

    Vue d'enregistrement