Editeur de la propriété Agg

Fonctionnalité de JBuilder Professionnel et Entreprise.

Pour afficher ce dialogue, sélectionnez la propriété agg dans l'inspecteur lorsqu'une Column d'un composant DataSet est sélectionnée dans le volet structure.

Utilisez l'éditeur de la propriété Agg pour spécifier les propriétés statistiques des données dans le concepteur d'interface utilisateur de JBuilder. Les colonnes statistiques calculées peuvent être utilisées pour grouper et/ou récapituler les données, par exemple, pour récapituler les ventes totales par trimestre. Les calculs statistiques peuvent être spécifiés entièrement via des paramètres de propriétés et plusieurs colonnes peuvent être incluses dans le regroupement. Quatre types de fonctions statistiques sont supportés (sum, count, min et max) ainsi qu'un mécanisme de création des méthodes de calcul statistique personnalisées.

La fonction statistique peut être calculée pour l'ensemble de données entier ou vous pouvez grouper sur une ou plusieurs colonnes de l'ensemble de données et calculer une valeur statistique pour chaque groupe. La colonne statistique calculée est définie dans l'ensemble de données en cours de récapitulation, ainsi chaque ligne du groupe aura la même valeur dans la colonne calculée (la valeur statistique du groupe en question). La colonne est cachée par défaut. Vous pouvez choisir d'afficher la colonne ou sa valeur dans un autre contrôle. Pour plus d'informations, voir Statistiques sur les données avec des champs calculés dans Guide du développeur d'applications de bases de données. La propriété aggDescriptor est utilisée pour spécifier des colonnes à grouper, la colonne à calculer et l'opération statistique à effectuer. Les propriétés spécifiées dans cette boîte de dialogue sont stockées dans une instance d'un objet AggDescriptor.

Colonnes disponibles

La liste des colonnes du DataSet que vous pouvez choisir pour grouper les données. Les noms de colonnes affichés dans Groupement des colonnes sont exclus de cette liste.

Mettez en évidence le nom d'une colonne, puis sélectionnez Ajouter au groupe pour ajouter une colonne au groupement. Quand vous faites cela, le nom de la colonne disparaît de cette liste et s'ajoute à la liste Groupement des colonnes.

Ajouter au groupe

Retire la colonne sélectionnée de la liste Colonnes disponibles et l'ajoute à la liste Groupement des colonnes.

Groupement des colonnes

Les colonnes du DataSet qui doivent être regroupées par l'opération statistique. Seules les colonnes non calculées et non statistiques sont autorisées dans cette liste.

Retirer du groupe

Retire la colonne sélectionnée de la liste Groupement des colonnes et l'affiche dans la liste Colonnes disponibles.

Fonction statistique personnalisée/Calcul sur fonction statistique

Sélectionnez cette option pour effectuer une opération statistique personnalisée, par exemple, un calcul sur les valeurs agrégées peut impliquer la somme des éléments en ligne multipliés par une valeur constante "marge". La sélection de ce champ affecte une valeur null aux champs Colonne statistique et Opération statistique (qui indiquent une opération statistique calculée) et désactive ces deux champs.

Pour spécifier une opération statistique personnalisée, sélectionnez cette option, puis

  1. Définissez le type de colonne de la colonne statistique par CalcType.AGGREGATE
  2. Recensez un CalcAggFieldsListener avec le DataSet de la colonne statistique.

Colonne statistique

Sélectionne la colonne du DataSet dont les valeurs sont sur le point d'être soumises à l'opération statistique. Cette colonne doit être ajoutée à l'ensemble de données avant de définir les propriétés dans l'éditeur de propriété agg. Lorsque la colonne est créée, vérifiez que la propriété calcType est définie par aggregated, et que sa propriété visible a la valeur Yes.

Attention : si vous définissez pour cette colonne une colonne contenant des données, celles-ci seront écrasées avec les données de l'opération statistique.

Opération statistique

Sélectionnez la classe qui définit les fonctionnalités de l'opération statistique effectuée. Cette liste affiche tous les AggOperators ainsi que ceux qui sont personnalisés dans le même contexte de classe que la valeur de la colonne statistique. Les opérateurs statistiques prédéfinis sont CountAggOperator (qui compte le nombre d'occurrences dans le groupe), MaxAggOperator (qui recherche la valeur maximale du groupe), MinAggOperator (qui recherche la valeur minimale du groupe), SumAggOperator (qui additionne toutes les valeurs du groupe).