Spécifications

La structure de base d’une grille est décrite dans le paramétrage XML. Chaque grille est définie dans un fichier correspondant à sa chaîne, dans un tag GridView. Les grilles sont regroupées dans le dossier Grids de la configuration.

Chaque grille possède un identifiant qui est unique dans le système et référencé dans les tâches pour définir quelle grille est chargée pour la navigation, dans les couples pour la grille listant les éléments, dans les combos pour sélectionner la grille à charger dans une tâche de vue, …

Une grille simple est utilisée pour passer en revue les différents éléments du paramétrage dans les sections suivantes.

<GridView ID="SYSUS_VUE1">
  <!-- Vue résumée des utilisateurs -->
  <Column ID="1" DataFieldID="SYSUSR.USER_PK" Width="Auto" />
  <Column ID="2" DataFieldID="SYSUSR.FULLNAME" Width="Auto" />
  <Column ID="3" DataFieldID="SYSUSR.CATEGORYLIST" Width="Auto" />
  <Column ID="4" DataFieldID="SYSUSR.GROUPLIST" Width="Auto" />
</GridView>

---

GridView

Ce chapitre passe en revue les différents attributs possibles sur l’élément GridView et leur rôle.

ID (oblig.)

Identifiant unique de la grille.

InternLabel (facult.)

Libellé indicatif. Ce libellé n’est jamais affiché à l’utilisateur et est destinée aux paramétreurs.

CellHeights (falc.)

Définit la hauteur des cellules. Par défaut les cellules font toutes une ligne de hauteur. Il est possible de définir un nombre de lignes ou Auto afin que chaque ligne du tableau soit étirée afin de présenter tout le contenu des cellules.

CalendarStartId (falc.)

Identifiant de la colonne contenant le début de l’événement pour l’affichage dans les calendriers et agendas.

CalendarEndId (falc.)

Identifiant de la colonne contenant le fin de l’événement pour l’affichage dans les calendriers et agendas.

Icon (falc.)

Définition des icônes. Le format de déclaration est défini plus en détail dans la section correspondante TODO.

IdentifyByNote (falc.)

Permet de définir si les entrées doivent être illustrées par leur note associée (dans le cas où elle existe) ou par une icône, quelle soit par défaut ou switchée par le paramètre Icon. Les valeurs possibles sont true ou false. La valeur par défaut est false.

OverlayBottomRight, OverlayBottomLeft, OverlayTopRight, OverlayTopLeft (falc.)

Définition des icônes d’overlay. Se référer à la documentation de Icon.

GridSelectionMode (falc.)

Permet de préciser le mode de sélection des lignes de la grille, valeurs possibles : RowSelect : Sélection d’une ligne à la fois, en entier (toutes les cellules sont sélectionnées). Rangeselect : Permet la sélection de plusieurs lignes à la fois. CheckBoxes : Permet la sélection des lignes via une colonne de cases à cocher qui s’ajoute à gauche.

PopupWindowType (falc.)

Permet de définir le mode de la fenêtre qui va être ouverte pour l’édition du record sélectionnée dans la grille. Par exemple “Popup” pour une fenêtre simplifiée “NoShortcut” pour cacher les raccourcis à droite.

DynamicGridUpdate (falc.)

Permet la mise à jour automatique de la grille quand un record présent dans la grille a été modifié dans l’application. SingleRowUpdateOnRecordChange : La ligne seule contenant le record est mise à jour. Fonctionne uniquement sur les grilles sans formattage. FullUpdateOnRecordChange : Toute la grille est mise à jour si il y a eu un changement.

DomainConstraint (falc.)

Définition du filtre par défaut sur la société courante. Cet attribut permet d’afficher les entrées d’autres sociétés. Les valeurs possibles sont true et false. La valeur par défaut est true.

NoteLinks (falc.)

TODO

OnRefresh (falc.)

TODO

TableID (falc.)

TODO

Type (falc.)

TODO

noOfZebraRows (falc.)

Définition du nombre de lignes par groupe de zébrage dans les listes. La valeur par défaut est 3. Tous les nombres entiers sont acceptés.

---

Column

Ce chapitre passe en revue les différents attributs possibles sur l’élément Column et leur rôle.

ID (obligatoire)

Identifiant unique de la grille.

DataFieldID (obligatoire)

Identifiant du dataField pointé par la colonne.

InternLabel (optionel)

Libellé interne de la colonne, à l’intention du paramétreur.

Label (optionel)

Libellé remplaçant le libellé du DataField. Pour internationaliser un libellé, utiliser la forme “FR={Libellé français} DE={Libellé allemand}”.

Width (optionel)

Largeur de la colonne en nombre d’unités. Les valeurs possibles sont soit un nombre d’unités à partir de 0, soit Auto pour laisser le système gérer automatiquement la largeur nécessaire. La valeur 0 cache la colonne.

GridPreviewColumnWidth (optionel)

taille de la colonne (en pourcentage ou pixels) pour les aperçus de la grille dans les tuiles. Syntaxe : GridPreviewColumnWidth=“40px” ou GridPreviewColumnWidth=“50%”

CellHeights (optionel)

Définit la hauteur des cellules. Par défaut les cellules font toutes une ligne de hauteur. Il est possible de définir un nombre de lignes ou Auto afin que chaque ligne du tableau soit étirée afin de présenter tout le contenu des cellules.

Visible (optionel)

Spécifie si la colonne doit être visible ou cachée. false correspond à Width=“0”.

hideIf (optionel)

TODO

Format (optionel)

Format de la colonne. Permet de remplacer le format du DataField, par exemple dans le cas d’un DataField déclaré uniquement pour la grille ou pour permettre de changer l’affichage d’un DataField. Se référer à la documentation des formats. TODO

TableName (optionel)

Table de la clé distante si le format est “ByForeignKey”.

MaxLength (optionel)

Nombre maximum de caractères à afficher dans la cellule.

EnumName (optionel)

Identifiant de combo utilisée par la colonne. Permet de remplacer la combo du DataField, par exemple dans le cas d’un DataField déclaré uniquement pour la grille ou pour permettre de pointer sur une nouvelle combo contenant d’autres valeurs.

DisplayCode (optionel)

Définit le format d’affichage des colonnes de combo. Les valeurs possibles sont CodeOnly pour n’afficher que le code, TextOnly pour n’afficher que la valeur et cacher le code. La valeur par défaut affiche les deux parties de la combo.

DateFormat (optionel)

Définit le format d’affichage des colonnes de date. Le format est donné en format standard Java SimpleDateFormat.

ColumnSeparator (optionel)

Définit le séparateur inséré après la colonne lors de l’affichage dans un Header. La valeur par défaut est un espace " ".

NbDecimalsNbDecimals (optionel)

Définit le nombre de décimales affichées pour les DataFields de type Financial. Cet attribut est ignoré pour les autres types de DataFields.

Presentation (optionel)

Comme pour les champs, permet de remplacer la présentation dans la colonne. Utilisation principale pour afficher des liens : “Link” comme pour les champs, ou “DynamicLink”, qui conserve la donnée affichée mais permet de cliquer dessus pour ouvrir une tâche, lancer un script ou une notification.

DynamicLinkTaskID (optionel)

Pour les liens dynamiques, tâche à ouvrir quand lors du clique sur le lien.

DynamicLinkFilter (optionel)

Filtre à appliquer dans la tâche à ouvrir.

DynamicLinkScriptOnClick (optionel)

Script à exécuter si il y a plus à faire que simplement ouvrir une tâche. (si la colonne ne contient pas de donnée (DF TaskOnly) revient au même que Presentation=“Link” et un DataField avec ScriptOnClick)

DynamicLinkNotificationOnClick (optionel)

Notification à exécuter si il y a plus à faire que simplement ouvrir une tâche.

DynamicLinkNotificationSource (optionel)

Type de notification (Local ou Remote). Par défaut, c’est une notification Local.

DynamicLinkNotificationRemoteTask (optionel)

Tâche à utiliser si la notification est de type Remote.

DynamicLinkNotificationRemoteArgs (optionel)

Arguments à envoyer à une notification de type Remote. Il est possible d’utiliser les référence itemId pour avoir le DataField de la colonne cliquée et value pour avoir le contenu de la cellule cliquée.

PermanentValue (optionel)

Valeur forcée à affcher dans les cellules… peut être un script qui dépend des autres colonnes…