Gestion des vues

Les vues fournissent aux utilisateurs un accès à un ensemble d'entités préfiltrées en fonction des besoins. Une vue est une liste à laquelle l'administrateur donne accès aux utilisateurs, et pour laquelle il définit les entités visibles, les informations affichées et les filtrages possibles.

Accès aux modèles

Les sections Vue... de l'administration permettent de créer et gérer les vues. L'administrateur habilité l'utilise pour lister les vues existantes, les gérer et en ajouter de nouvelles.

  • Vue Dossiers

  • Vue Documents

  • Vue Utilisateurs

Propriétés des vues

Champ Type Description
Cible de la vue identifiant Le type des entités listées dans la vue.
Identifiant métier texte Le nom utilisé par le système pour identifier la vue. Il ne peut être changé quand la vue est en cours d'utilisation
Libellé texte Le nom affiché aux utilisateurs lorsqu'ils utilisent la vue
Description texte Description de la vue
Position entier La position de la vue dans la liste des vues accessibles aux utilisateurs.

@


En plus de ces informations d'entête, la définition de la vue inclut les éléments suivants :

  • un filtre pour sélectionner les entités à afficher (lignes)
  • les informations à afficher dans les colonnes
  • les facettes de recherche proposées à l'utilisateur pour restreindre les lignes affichées

Filtres

Le filtre est la requête qui définit quelles entités doivent être incluses dans la vue, à la manière d'une clause where dans le langage SQL. La définition de ce filtre répond aux spécifications du langage de requête.

L'exemple ci-dessous montre un filtre qui sélectionne les entrées dont l'indicateur de complétude est actif et dont l'état de cycle de vie est "Copie de travail" :

filter:
  $func: "AND"
  $vars:
    left:
      $func: "equals"
      $vars:
        cast: "bool"
        field: "entry.completeness:complete"
        value: true
    right:
      $func: "equals"
      $vars:
        field: "lifecycle.status"
        value: "workingCopy"

Colonnes

Ce paramètre définit les colonnes affichées dans la vue et les options d'affichage à l'aide des propriétés suivantes :

Champ Type Description
columns Tableau d'objets colonne Une liste des colonnes à afficher
defaultSort texte Le nom d'une colonne utilisée pour le tri par défaut de la vue
defaultSortDirection mot-clé Le tri par défaut, soit asc pour ascendant, soit descpour descendant

Chaque colonne est définie à l'aide des propriétés suivantes :

Champ Type Description
identifier texte Identifiant de la colonne dans le tableau, doit être unique pour la vue
title texte Libellé de la colonne dans la vue
type mot-clé Type de la colonne, parmi les types gérés tels que string, integer ou boolean
expression texte Expression fournissant la valeur à afficher dans la colonne
sortable booléen Indique si la colonne peut être triée par l'utilisateur
format objet indique le format à afficher pour certains types (propriété "id" et "value")

L'exemple ci-dessous montre la définition de quelques colonnes et un tri par défaut sur la date de création :

columns:
  - type: "string"
    title: "Date de création"
    format:
      id: "date"
      value: "dd/MM/YYYY HH:mm"
    sortable: true
    expression: "createdAt"
    identifier: "createdAt"
  - type: "string"
    title: "Nom d'affichage"
    sortable: false
    expression: "displayName"
    identifier: "displayName"
  - type: "string"
    title: "Type de demande"
    sortable: true
    expression: "entryType.displayName"
    identifier: "entryType"
defaultSort: "createdAt"
defaultSortDirection: "asc"

Facettes

Ce paramètre définit les filtres prédéfinis disponibles sur une vue accessibles par un bouton.

Consiste en un tableau d'objets "Facettes".

Chaque facette est définie à l'aide des propriétés suivantes :

Champ Type Description
identifier texte identifiant unique de la facette
displayName texte Libellé affiché dans la vue
filter objet La définition de ce filtre répond aux spécifications du langage de requête.
sequence entier Ordre de présentation des facettes dans la vue

L'exemple ci-dessous montre la définition de quelques facettes :

- filter:
    "$func": equals
    "$vars":
      field: lifecycle.currentStatus
      value: workingCopy_new
  sequence: 1
  identifier: facetDemandeAchatNew
  displayName: Nouvelles demandes d'achat
- filter:
    "$func": equals
    "$vars":
      field: lifecycle.currentStatus
      value: workingCopy_updated
  sequence: 2
  identifier: facetDemandeAchatNotCompleted
  displayName: Demandes d'achat à compléter
- filter:
    "$func": equals
    "$vars":
      field: lifecycle.currentStatus
      value: current_purchased
  sequence: 3
  identifier: facetDemandeAchatAttenteLivraison
  displayName: Demandes d'achat en attente livraison

Exemple affiché dans la vue :

@

Attributs associés

Autres paramètres pouvant être associés à une vue

Champ Type Description
nextEntityAfterAction booleen (true ou false) comportement après une transition

true : après une action de transition, affiche l'élément suivant de la vue d'origine en tenant compte des tris et facettes actives. S'il s'agit du dernier élément, réaffiche la vue d'origine

false : après une action de transition, reste sur l'entité active

Champ Type Description
titlePanelInfo texte Personnaliser le titre du panneau d'information d'une entité affichée dans la vue
titlePanelInfo: "{entityTypeName}"

results matching ""

    No results matching ""