Créer des listes connexes définies

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture

    • Vous pouvez ajouter des listes connexes par défaut au formulaire pour que tous les utilisateurs puissent les voir lors de la consultation des enregistrements.

    Avant de commencer

    Rôle requis : administrateur

    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 table plusieurs-à-plusieurs. Si deux tables sont liées via le dictionnaire système, l’une peut apparaître comme une 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 quelconques pouvant avoir une relation logique peuvent apparaître sous forme de 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 que cet utilisateur a effectuées.
    • 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 fournit déjà les informations nécessaires. Procédez comme suit 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és Cochez cette case pour utiliser JavaScript à la place de la table S’applique à 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 lorsque 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 lorsque 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é.
      Insérer un rappel Tapez un script à exécuter après une action d’insertion réussie. Ce champ n’est visible que lorsque la case Avancé est cochée.
    4. Cliquez sur Envoyer.