Les listes de valeurs

Modifié le 28/05/2022 10:54

Certains champs des fiches proposent un choix de valeurs à l'utilisateur sous la forme d'une grille

  • La liste de valeurs est bâtie sur une requête parent permettant de travailler sur un ensemble d'informations homogènes des bases de données.
  • La grille peut être paramétrée.
    • Sélection des colonnes affichées à partir des champs de la requête parent supportant la liste de valeurs.
    • Uniquement sur les fiches Ticket, sélection des filtres permettant à l'utilisateur de restreindre l'affichage des valeurs possibles lors de la recherche d'un matériel ou d'un service.

Exemples

  • Afficher une liste de valeurs pour le champ Service.
    • Vue Utilisateur : Survolez le champ et cliquez sur List open icon.png.
               Value list parameter - User view.png
    • Paramétrage de la grille : Cliquez sur Circle Edit icon.png.
               Value list parameter - Grid setup.png
  • Sur les fiches Ticket, proposer plusieurs filtres pour afficher uniquement les matériels du bénéficiaire, de son entité ou de sa localisation.
             Value list parameter - Filter user view.png

Remarques

  • Seul un profil ayant les droits d'édition des affichages peut paramétrer une liste de valeurs  - Open url.png voir Profil utilisateurs > Droits d'édition et d'affichage
  • Des champs peuvent être ajoutés manuellement à la requête parent, sous réserve de disposer des droits d'édition des affichages  - Open url.png voir Profil utilisateurs > Droits d'édition et d'affichage
    • Les champs sont affichés sous leur nom d'alias (ou nom logique).
    • Si l'alias n'est pas renseigné, le nom physique du champ est affiché.

      exemple  

      • Nom d'alias : Téléphone  ;  Nom physique : PHONE_NUMBER
      • Nom d'alias : N° de série  ;  Nom physique : AM_ASSET.SERIAL_NUMBER

Spécificités des versions 2016 et antérieures

Le paramétrage des listes de valeurs des versions 2016 et antérieures présente certaines différences.

  • Les droits d'édition sont accordés par profil au niveau du module auquel est rattachée l'entrée de menu utilisant le filtre  - Open url.png voir Profils utilisateur
  • Le paramétrage des filtres se fait uniquement sur la fiche Prise d'appel, sur les champs Matériel et Service.

Accès

Sur une fenêtre affichant une liste de valeurs, Circle Edit icon.png en haut de la page

Description de l'écran

        Value list parameter.png

Nom : Liste des champs définis dans l'une des tables issues de la requête parent, les éventuelles jointures avec des vues SQL et les éventuelles tables liées ajoutées manuellement.

  • Renseignez les alias multilingues via Multilingual labels icon.png.

Nom du champ (Note : Non modifiable) : Nom physique du champ dans le modèle de données.

Open eye icon.png (Note : Uniquement si le champ clé peut être supprimé) : Indique si le champ est visible dans la grille (icône Open eye icon.png) ou masqué (icône Close eye icon.png).

  • Cliquez sur l'icône pour basculer entre les 2 modes de visibilité.
     
AddViewTableField

Ajouter une vue : Crée une liaison entre un champ d'une vue SQL et un champ d'une table liée à la requête parent  - Open url.png voir Procédure Modifier une requête parent

  • La vue SQL devient sélectionnable comme toute autre table de la requête parent.
  • Le type de lignes à retourner peut être sélectionné (Note : En fonction de la requête parent)  - Open url.png voir Exemple
    • option OUTER : Toutes les lignes de la table principale sont retournées, même s'il n'y a pas de correspondance avec la vue
    • option INNER : Seules les lignes de la table principale ayant une correspondance avec la vue SQL sont retournées.
  • Un alias peut être attribué à la vue SQL lors de la sauvegarde.
     

Ajouter une table : Crée une liaison entre l'une des tables de la requête parent et l'une des tables liées dans le modèle de données  - Open url.png voir Procédure Modifier une requête parent

  • La table liée devient sélectionnable comme toute autre table de la requête parent. 
  • Pour chaque table liée, la liste des relations dans le modèle de données est affichée sous la forme Champ clé dans la table liée / Champ clé dans la table de la requête parent.
  • Le type de lignes à retourner peut être sélectionné (Note : En fonction de la requête parent)  - Open url.png voir Exemple
    • option OUTER : Toutes les lignes de la table principale sont retournées, même s'il n'y a pas de correspondance avec la table liée.
    • option INNER : Seules les lignes de la table principale ayant une correspondance avec la table liée sont retournées.
  • Un alias peut être attribué à la table liée lors de la sauvegarde.
     

Ajouter un champ : Ajoute un champ parmi ceux définis dans l'une des tables de la requête parent et les éventuelles tables liées / vues SQL ajoutées manuellement  - Open url.png voir Procédure Modifier une requête parent

  • Le champ est affiché en bas de la liste des champs de la requête parent sous son nom d'alias (ou nom logique).
  • Il est précédé de Delete icon.png (permettant de le supprimer de la requête).
  • Si l'alias n'est pas renseigné, le nom physique du champ est affiché.

    exemple  

    • Nom d'alias : Téléphone  ;  Nom physique : PHONE_NUMBER
    • Nom d'alias : N° de série  ;  Nom physique : AM_ASSET.SERIAL_NUMBER

Gestion des filtres : Ajoute les filtres à proposer à l'utilisateur.

Note : Uniquement sur les fiches Ticket (Prise d'appel, incident, demande de service, demande de changement), pour les champs Matériel et Service
        Value list parameter - Filter.png

Visible : Indique si le filtre est proposé à l'utilisateur (case cochée) ou non (case non cochée).

  • Les filtres sont proposés en fonction du contexte.

exemple  Sur l'écran Prise d'appel, affichage de la liste de valeurs liée au champ Matériel

  • Le champ Demandeur est renseigné ==> Le filtre Matériels du demandeur est affiché.
  • Le champ Demandeur n'est pas renseigné ==> Le filtre n'est pas affiché.

Liste des filtres : Liste des filtres disponibles pour la liste de valeurs.

Option par défaut (Note : Uniquement si la case Visible est cochée pour le filtre) : Indique si le filtre est actif par défaut lorsque la liste de valeurs est affichée la première fois (case cochée) ou non (case non cochée).

  • Lorsque l'utilisateur affiche la liste de valeurs la fois suivante, ce sont ses derniers choix de filtres qui sont rappelés et non les options marquées par défaut, et ce jusqu'à la prochaine ouverture de session.

Procédure : Comment paramétrer une liste de valeurs

Étape 1 : Affichage de la fenêtre de paramétrage de la liste de valeurs

1. Survolez avec la souris la zone de saisie du champ lié à une liste de valeurs et cliquez sur List open icon.png.

2. Cliquez sur Circle Edit icon.png en haut de la fenêtre de la liste de valeurs.

Étape 2 : Paramétrage de la liste de valeurs

1. (optionnel) Ajoutez les champs que vous souhaitez rendre disponibles dans la requête parent, via Ajouter un champ  - Open url.png voir Procédure Modifier une requête parent

  • Vous pouvez sélectionner des champs dans des tables liées à la table principale, et dans les tables liées aux tables liées. Ajoutez au préalable ces tables dans le périmètre de la requête parent, via Ajouter une table  - Open url.png voir Exemple dans le périmètre d'une requête parent
  • Vous pouvez sélectionner des champs dans des vues SQL. Ajoutez au préalable ces vues dans le périmètre de la requête parent, via Ajouter une vue.

2. Sélectionnez les colonnes à afficher dans la grille via Open eye icon.png.

3. (Note : Uniquement sur les fiches Ticket, pour les champs Matériel et Service) Indiquez les filtres à proposer à l'utilisateur.

  • Cliquez sur Gestion des filtres.
  • Cochez la case Visible pour les filtres disponibles à l'ouverture de la liste de valeurs.
  • Cochez la case Option par défaut pour les filtres actifs lorsque la liste de valeurs est affichée la première fois.
  • Cliquez sur Enregistrer.
     

Étape 3 : Sauvegarde et test de la liste de valeurs

1. Cliquez sur Enregistrer.

La fenêtre de paramétrage de la liste de valeurs est fermée.

2. Vérifiez l'affichage des résultats.

  • Survolez le champ appelant la liste de valeurs et cliquez sur List open icon.png.
  • Vérifiez que la grille affiche les informations paramétrées pour la liste de valeurs.
Tags :
Powered by XWiki © EasyVista 2022