Créer des listes connexes définies

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

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

    Avant de commencer

    Rôle requis : 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 des relations entre des tables arbitraires sous forme de liste connexe. Deux tables qui peuvent avoir une relation logique peuvent apparaître comme 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 cet 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. Pour créer un enregistrement de relation, procédez comme suit.

    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 d’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és Cochez cette case pour utiliser JavaScript à la place des champs S’applique à la table et Requêtes à partir de la table .
      S'applique à 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 de l'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 à Tapez 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 Avancé est cochée.
      Requête depuis Entrez 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 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 de l’insertion Tapez un script à exécuter après une action d’insertion réussie. Ce champ n’est visible que si la case Avancé est cochée.
    4. Cliquez sur Envoyer.