Créer des listes connexes définies

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 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 : admin

    Pourquoi et quand exécuter cette tâche

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

    Les listes connexes définies permettent d’exprimer les relations entre des tables arbitraires sous la forme d’une 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 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 existant qui fournisse déjà les informations nécessaires. Utilisez les étapes suivantes 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 d’enregistrement de relation
      Champ Description
      Nom Saisissez le nom de la liste connexe. La page de configuration de 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 à 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 Avancé est cochée.
      Requête depuis Tapez 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 à partir de 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 Avancé est cochée.
    4. Cliquez sur Envoyer.