Créer des listes connexes définies

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • Vous pouvez ajouter des listes connexes par défaut au formulaire pour que tous les utilisateurs puissent les consulter lors de l’affichage des enregistrements.

    Avant de commencer

    Rôle requis : related_list_admin

    Pourquoi et quand exécuter cette tâche

    Par exemple, vous pouvez inclure une liste des incidents associés au bas d’un enregistrement de problème ou une liste des membres au bas d’un enregistrement de groupe. Cette fonctionnalité dépend des champs de référence ou des relations de table plusieurs-à-plusieurs. Si deux tables sont liées via le dictionnaire système, l’une peut apparaître en tant que liste connexe sur l’autre.

    Les listes connexes définies permettent d’exprimer les relations entre des tables arbitraires sous forme de liste connexe. Deux tables pouvant avoir une relation logique peuvent apparaître en tant que paire parent/enfant via une liste connexe. En voici quelques exemples.
    • Sur un enregistrement d’incident, affichez tous les incidents ouverts par le même appelant.
    • Sur un enregistrement utilisateur, affichez les 20 dernières transactions effectuées par l’utilisateur.
    • Sur un enregistrement d’incident, affichez tous les problèmes ouverts sur le CI signalé.

    Ces relations vont au-delà des relations normalement définies dans le dictionnaire système par le biais de champs de référence et de relations plusieurs-à-plusieurs.

    Chaque liste connexe nécessite un enregistrement de relation. Avant de créer une relation, vérifiez qu’il n’existe pas d’enregistrement de relation qui fournit déjà les informations nécessaires. Suivez les étapes ci-dessous pour créer un enregistrement de relation.

    Procédure

    1. Cliquer sur Définition du système > Relations.
    2. Cliquez sur Nouveau.
    3. Spécifiez les champs d’enregistrement de relation.
      Tableau 1. Champs de l'enregistrement de relation
      Champ Description
      Nom Saisissez le nom de la liste connexe. La page de configuration du formulaire affiche ce nom dans la liste des listes disponibles.
      Avancé Activez cette case à cocher pour utiliser JavaScript à la place des champs S’applique à la table et Requêtes à partir de la table .
      Concerne la table Sélectionnez la table sur laquelle la liste connexe s’affiche.

      Par exemple, pour ajouter une liste connexe au formulaire utilisateur, sélectionnez la table Utilisateur [sys_user].

      Ce champ est masqué dans les enregistrements de relations avancées.
      Table d’origine des requêtes Sélectionnez la table à partir de laquelle cette liste connexe récupère les données.

      Par exemple, pour ajouter des enregistrements de tâches connexes à la liste connexe, sélectionnez la table Tâche [task].

      Ce champ est masqué dans les enregistrements de relations avancées.
      Appliquer à Saisissez un script qui définit la variable de réponse sur vrai lorsqu’un utilisateur ouvre un formulaire sur la table souhaitée. Ce champ n’est visible que si la case Advanced (Avancé ) est cochée.
      Requête depuis Saisissez un script qui définit la variable de réponse sur le nom de la table à partir de laquelle la liste connexe récupère les données. Ce champ n’est visible que si la case Advanced (Avancé ) est cochée.
      Requête avec Spécifiez les enregistrements à inclure en tapant un script.

      Par exemple :

      current.addQuery('opened_by', parent.sys_id);
      • L’objet actuel spécifie l’enregistrement actuel sur lequel le script est déclenché.
      • La méthode addQuery ajoute un filtre qui renvoie les enregistrements répondant à une condition spécifiée.
      • La variable opened_by est le nom de champ que vous interrogez dans la table à partir de Requêtes depuis la table.
      • La variable parent.sys_id fait référence à la table S’applique à et à l’ID de l’enregistrement affiché.
      Rappel d’insertion Tapez un script à exécuter après une action d’insertion réussie. Ce champ n’est visible que si la case Advanced (Avancé ) est cochée.
    4. Cliquez sur Envoyer.