Atys XE

Cette version (2026/08/18 14:02) est en ébauche.
Approuvés: 0/1

Date de création : 18/08/26
Date de Mise à Jour : 18/08/26
Version v25

Le widget de grille permet d'afficher les données dans une vue en grille.
La grille prend en charge de nombreuses manières différentes de présenter les données, y compris le contexte des couleurs par colonne par exemple. Il est possible de configurer le rendu de base, y compris l'ordre des colonnes, les colonnes à afficher, les en-têtes de colonnes etc…

Vidéo tuto sur l'utilisation des widgets de grille

Une fois le paramétrage du widget conforme à votre attente, pensez à le sauvegarder pour qu'il soit conservé pour les fois prochaines :

* (Etoile en haut à gauche)
Permet d'accéder à la liste de tous les champs disponible à l'affichage pour le widget sélectionné.
(All)
Permet de sélectionner tous les champs.
(Sorted)
Classe les champs par ordre alphabétique.

Cliquer dans les cases pour sélectionner/désélectionner les champs à afficher dans les colonnes de la grille

Pour déplacer une colonne :
- Faire un Alt+Clic sur l'intitulé de la colonne
- Déplacer l'intitulé à l'endroit désiré.

En cliquant dans l'entête de la colonne à classer, il est possible d'accéder à l'icone permettant de classer les données de la colonne :

Pour trier sur plusieurs colonnes, il suffit de cliquer sur l'entête de colonne en maintenant la touche “MAJ” enfoncée.

En cliquant dans l'entête de la colonne à classer, il est possible d'accéder à l'icone permettant de filtrer les données de la colonne :

Cliquer dans les cases pour sélectionner/désélectionner les données à afficher dans la colonne

(Tout)
Permet d'afficher toutes les données de la colonne.
(Personnalisé)
Permet de définir un filtre avec des comparateurs :

Il est possible de paramétrer 2 filtres maximum par colonne.

Une barre de filtre rapide peut être mise en place afin de paramétrer facilement des filtres par colonne.
Dès qu'un filtre est présent dans la grille, une zone de filtres apparait en bas de la gille.

Il est alors possible d'accéder à un constructeur de filtre afin d'affiner la personnalisation en combinant plusieurs filtres.

Cliquer sur la colonne à déplacer, rester cliqué et glisser la colonne à l'endroit désiré. Les flèches vertes sont un indicateur du positionnement à venir de la colonne :

Par un clic droit sur l'entête de la colonne, il est possible d'accéder aux actions suivantes :

Tri Croissant/Tri Décroissant
Même action que par l'icone de tri en entête de colonne.
Effacer le tri
Permet de supprimer les tris paramétrés.
Grouper par ce Champ
Permet de créer un niveau de regroupement supplémentaire:
Initialement :

Après avoir “Groupé par ce champ” :
Zone de regroupement
Permet d'Afficher/Masquer la zone de regroupement
Pied
Permet d'Afficher/Masquer le pied de la grille
Groupe du Pied
Permet d'Afficher/Masquer le pied du groupe
Retirer cette colonne
Permet de supprimer une colonne
Sélecteur de champ
Présente uniquement les champs disponibles, non positionnés dans le tableau. Contrairement à l'étoile qui permet juste une sélection des colonnes à afficher, le sélecteur de champs permet de les placer directement à l'endroit désiré par un simple Glisser-Déposer :
Best Fit
Permet d'optimiser automatiquement la largeur de la colonne sélectionnée
Best Fit (all columns)
Permet d'optimiser automatiquement la largeur de toutes les colonnes

Par un clic droit dans la zone de regroupement, il est possible d'accéder aux actions suivantes :

Tout déplier (récursif)/Tout plier (récursif)
permet de plier/déplier automatiquement tous les regroupements.
Effacer le regroupement
Permet de supprimer les regroupements paramétrés.
Cacher la zone de regroupement
Permet de masquer la zone de regroupement. Il sera possible de la rappeler par un clic droit sur l'entête des colonnes (voir ci-dessus).

Après avoir positionné un pied à la grille, il est possible d'appliquer des formules de calcul aux différentes colonnes :

Selon le type de données de la colonne, toutes les formules ne sont pas accessibles :

Sum
Additionne toutes les données de la colonne.
Min/Max
Affiche la valeur minimum ou maximum de la colonne.
Compteur
Compte le nombre de données dans la colonne.
Moyenne
Calcul la moyenne des données de la colonne.

Le bouton Menu / Paramètre permet d'accéder à la personnalisation avancée des widgets (concepteur de page) :

Une fois le paramétrage réalisé, penser à sauvegarder la personnalisation par l'icone “Enregistrer” :

Cliquer ensuite sur grDataDBTTableViewMaster afin d'accéder au tableau de bord du paramétrage.

Si la ligne de filtre n'est pas présente sous l'entête de la table, il est possible de la rendre apparente en renseignant, dans la catégorie “FilterRow” :

OpératorCustomization
True pour faire apparaitre l'opérateur (contient, =, etc…)
Visible
True pour faire apparaitre la ligne de filtre rapide

Si la Barre de recherche n'est pas présente au dessus de la zone de regroupement de la table, il est possible de la rendre apparente en renseignant, dans la catégorie “FindPanel” :

DisplayMode
- fpdmNever : jamais visible
- fpdmManual : possibilité de la faire apparaitre manuellement par clic droit dans l'entête → Panneau de recherche
- fpdmAlways : Toujours visible

Cliquer sur grDataDBTTableViewMaster[Nom colonne] afin d'accéder au tableau de bord du paramétrage de la colonne.

Dans la catégorie “Visual”, sélectionner :

Intitulé
Modifier le nom de la colonne en cliquant dessus

Après avoir sélectionné la colonne concernée, vérifier que le champ PropertiesClassName est bien renseigné avec TcxMaskEditProperties :

On peut paramétrer le format du groupe de pied (Goup Footer) et/ou du pied (Footer) de la colonne concernée. On paramétre le format des chiffres de la façon suivante :

Group Footer Kind / Footer Kind
Sélectionne le type de formule utilisée ou none s'il n'y en a pas
Group Footer Format / Footer Format
Définit le format des chiffres. On paramètre les nombres positif (avant le ;) et négatif (signe - après le ;). Les règles à appliquer sont les suivantes :
- Séparateur de millier : Virgule en début de format pour les chiffres positifs et négatifs.
- Nombre de décimales : Nombre de 0 après le point
  Ex : 2 décimales, renseigner 0.00 et 3 décimales renseigner 0.000
- Décimales facultatives : # en lieu et place de la décimale facultative
  Pour afficher 3 décimales si 3 chiffres significatifs et seulement 2 décimales sinon, renseigner 0.00#

Ex de format : ,0.00#;-,0.00#

On peut paramétrer de renseigner des formules en entête des regroupements et pour des colonnes choisies.
Contrairement aux formules dans les pieds et groupes du pied, les formules en entête de regroupement ne sont accessible qu'à partir du menu paramètre

Sélectionnez dans un premier temps la colonne concernée. Puis dans le bloc format, renseignez le type de formule à afficher pour le champ Group Kind :

Group Kind
Sélectionne le type de formule utilisée ou none s'il n'y en a pas
Group Format
Définit le format des chiffres. (voir le paragraphe précédent pour les explications). Si rien n'est renseigné, on indiquera, devant la valeur, le type de formule (SUM, MIN, etc…).

Pour que les valeurs à afficher soit situées dans la colonne concernée (et non entre parenthèse dans l'entête du regroupement), il faut renseigner tel que ci-contre :

Tris par Somme de regroupements :

Il est possible d'appliquer une mise en forme des données du tableau en fonction de règles définies par l'utilisateur.

Après avoir sélectionné “grdDataDBTTableViewMaster” cliquer sur “Format conditionnel” dans le menu en haut :

Sélectionner la colonne sur laquelle appliquer la mise en forme
Choisir la règle à appliquer
Paramétrer la mise en forme choisie

Exemple :

Il est possible d'extraire une widget afin de la positionner sur un autre écran par exemple.

Dans la partie de droite “Propriété de la widget” :

Mettre le paramètre “AllowFloating” à “True”
Le valider en tapant sur le touche “Entrée”
Enregistrer le paramétrage par le bouton dans la barre en haut et fermer le paramétrage.

Par un glisser/déposer, déplacer la widget à l'endroit voulu

Exemple :

Pour repositionner la widget à sa place dans le module, cliquer sur le point à côté de l'engrenage.

Il est possible de paramétrer le rafraichissement auto des widgets à chaque changement de paramètre de contexte (date, entité, etc…).

Dans la partie de droite “Propriété de la widget” :

Mettre le paramètre “AutoRefresh” à “True”
Le valider en tapant sur le touche “Entrée”
Enregistrer le paramétrage par le bouton dans la barre en haut et fermer le paramétrage.

Le rafraichissement auto est consommateur de ressources à chaque changement de paramètre de contexte. C'est pour cette raison que de nombreux widgets ont été désactivés. Si vous choisissez de les réactiver, cela peut impacter les performances.

Il est possible de fixer une ou plusieurs colonnes, à gauche du widget, à droite ou à gauche en dynamique (à partir de la V24).

Sélectionner la colonne à figer
Vérifier que le paramètre “PropertiesClassName” soit à TcxTextEditProperties ou TcxMaskEditProperties
Sélectionner le mode de fixation de la colonne : Left, Right ou LeftDynamic

Avec le paramétrage LeftDynamic, la colonne se fixe sur la gauche quand le balayage horizontal avec l'ascenseur l'amène sur la gauche du widget :

Les widgets “compagnon” qui proposent les numéros de pièces, offrent la possibilité de visualiser directement les pièces, côté Atys, en doucle-cliquant sur la ligne concernée.

Certains widgets présentent également des liens interactifs permettant par exemple d'accéder à une messagerie en cliquant sur une adresse mail ou bien d'accéder à un site web en cliquant sur un lien hypertexte.