Gestion des indicateurs sur les vues

Gestion des indicateurs sur les vues

Présentation générale

L’objectif de cette extension est de pouvoir représenter, dans une vue, des colonnes sous forme d’images (puces ou barre de progression).

Exemple de résultat d’affichage :

Fonctionnalités

  • Gestion de l’affichage d’images sur une colonne, affichage calculé à partir de la valeur d’un champ (typiquement un champ liste)
  • Gestion des infobulles au survol de l’image (tooltip en anglais)
  • Gestion de l’ajout d’une colonne.

Utilisation

Extension de vue

Poser l’extension suivante sur la vue de processus souhaitée :

1

com.vdoc.kit.ui.extensions.view.IndicatorViewExtension

Configuration et paramétrage

Un certain nombre de paramètres sont nécessaires à la mise en place d’un tel mécanisme. Ils doivent être configurés dans le groupe de processus.

Il faut remplacer view-name par le nom système de votre vue.

Clé Description
vdoc.kit.behaviors.indicators.view-name.column.name Nom système de la colonne (nom système du champ).
vdoc.kit.behaviors.indicators.view-name.column.field-name Pour chaque valeur de liste, possibilité d’associer une image, une couleur prédéfinie ou une couleur personnalisée.
Il est aussi possible d’utiliser en valeur le charactère %. Dans ce cas, le système tentera de retrouver les valeurs de la liste associée et affichera, dans une barre de progression, le pourcentage calculé à partir des valeurs minimale et maximale.
En option, une valeur maximale peut être forcée en utilisant la syntaxe suivante : %|60 ou encore %|700. Toute valeur supérieure sera plafonnée.
vdoc.kit.behaviors.indicators.view-name.column.field-name.label Association valeur de liste et de l’infobulle.

Exemples

Exemple 1 : utilisation d’images placées dans le dossier skins/<nom de la skin>/images/mandatory/

1
2
3

vdoc.kit.behaviors.indicators.TousLesDocumentsEnCours.column.name=DocumentState
vdoc.kit.behaviors.indicators.TousLesDocumentsEnCours.column.DocumentState=En cours|state_on.gif;Applicable|state_off.gif;Périmé|state_off.gif;Archivé|state_on.gif
vdoc.kit.behaviors.indicators.TousLesDocumentsEnCours.column.DocumentState.label=En cours|LG_EN_COURS;Applicable|LG_APPLICABLE;Périmé|LG_PERIME;Archivé|LG_ARCHIVE

Exemple 2 : utilisation de pastilles de couleurs prédéfinies

1
2
3

vdoc.kit.behaviors.indicators.TousLesDocumentsEnCours.column.name=DocumentState
vdoc.kit.behaviors.indicators.TousLesDocumentsEnCours.column.DocumentState=En cours|red;Applicable|green;Périmé|black;Archivé|blue
vdoc.kit.behaviors.indicators.TousLesDocumentsEnCours.column.DocumentState.label=En cours|LG_EN_COURS;Applicable|LG_APPLICABLE;Périmé|LG_PERIME;Archivé|LG_ARCHIVE

Exemple 3 : utilisation de couleurs personnalisées (avec un code couleur)

1
2
3

vdoc.kit.behaviors.indicators.TousLesDocumentsEnCours.column.name=DocumentState
vdoc.kit.behaviors.indicators.TousLesDocumentsEnCours.column.DocumentState=En cours|#A0522D;Applicable|#32CD32;Périmé|#C0C0C0;Archivé|#800080
vdoc.kit.behaviors.indicators.TousLesDocumentsEnCours.column.DocumentState.label=En cours|LG_EN_COURS;Applicable|LG_APPLICABLE;Périmé|LG_PERIME;Archivé|LG_ARCHIVE

Exemple 4 : utilisation de la balise pourcentage

1
2

vdoc.kit.behaviors.indicators.TousLesDocuments.column.name=PourcentageDeReussite
vdoc.kit.behaviors.indicators.TousLesDocuments.column.PourcentageDeReussite=%

Exemple 4 : utilisation de la balise pourcentage en forçant la valeur maximame

1
2
3

vdoc.kit.behaviors.indicators.TousLesDocuments.column.name=PourcentageDeReussite;DocumentState
vdoc.kit.behaviors.indicators.TousLesDocuments.column.PourcentageDeReussite=%|2000
vdoc.kit.behaviors.indicators.TousLesDocuments.column.DocumentState=En cours|state_on.gif;Périmé|state_off.gif