Commande CLASSIFY

Regroupe les enregistrements en fonction des valeurs identiques d'un champ caractère ou numérique. Compte le nombre d'enregistrements dans chaque groupe et calcule également le sous-total des champs numériques spécifiés pour chaque groupe.

Syntaxe

CLASSIFY <ON> champ_clé <SUBTOTAL champ_numérique <...n>|SUBTOTAL ALL> <INTERVALS nombre> <SUPPRESS> <TO {SCREEN|nom_table|GRAPH|PRINT}> <IF test> <WHILE test> <FIRST plage|NEXT plage> <HEADER texte_en-tête> <FOOTER texte_pied_page> <KEY champ_fractionnement> <OPEN> <APPEND> <LOCAL> <STATISTICS>

Paramètres

Nom Description
ON champ_clé

Champ caractère ou numérique à classer.

La longueur maximale des champs clés est de 2 048 caractères.

Si vous souhaitez classer une table à l'aide d'un champ clé contenant plus de 2 048 caractères, utilisez la commande SUMMARIZE, opération qui ne limite pas la longueur du champ clé. Cela ne limite pas la longueur du champ clé.
SUBTOTAL champ_numérique <...n> | SUBTOTAL ALL

optionnel

Un ou plusieurs champs ou expressions numériques à sous-totaliser pour chaque groupe.

Les champs multiples doivent être séparés par des espaces. Indiquez ALL pour calculer le sous-total de tous les champs numériques de la table.
INTERVALS nombre

optionnel

Nombre maximal de groupes dans le résultat de sortie.

Si le nombre de jeux de valeurs identiques dans le champ en cours de classement dépasse la valeur maximale spécifiée, les jeux sont utilisés à partir du haut de la colonne.

Les jeux dépassant la valeur maximale sont regroupés dans un groupe intitulé « OTHER ».

Si INTERVALS est ignoré, un groupe est créé pour chaque jeu de valeurs identiques dans le champ en cours de classement.

Remarque

Ce paramètre n'est pas disponible dans l'interface utilisateur Analytics et peut uniquement être utilisé en tant que partie intégrante d'une syntaxe ACLScript dans un script ou la ligne de commande.
SUPPRESS

optionnel

Remarque

Ne peut pas être utilisé sauf si INTERVALS est également spécifié. SUPPRESS n'est pas disponible dans l'interface utilisateur Analytics et peut uniquement être utilisé en tant que partie intégrante d'une syntaxe ACLScript dans un script ou la ligne de commande.

Exclut les jeux de valeurs identiques dépassant le maximum spécifié par INTERVALS de la sortie de commande.
TO SCREEN | nom_table | GRAPH | PRINT

Emplacement vers lequel envoyer les résultats de la commande :

  • SCREEN affiche les résultats dans la zone d'affichage d'Analytics.
  • nom_table enregistre les résultats dans une table Analytics

    Indiquez nom_table sous forme de chaîne entre guillemets avec une extension de fichier .FIL. Par exemple : TO "Sortie.FIL"

    Par défaut, le fichier de données de table (.FIL) est enregistré dans le dossier contenant le projet Analytics.

    Utilisez un chemin de fichier absolu ou relatif pour enregistrer le fichier de données dans un autre dossier existant :

    • TO "C:\Sortie.FIL"
    • TO "Résultats\Sortie.FIL"

    Remarque

    La longueur des noms des tables est limitée à 64 caractères alphanumériques, sans l'extension .FIL. Le nom peut inclure le caractère de soulignement ( _ ), mais aucun autre caractère spécial ni espace. Le nom ne peut pas commencer par un chiffre.

  • GRAPH affiche les résultats dans un graphique dans la zone d'affichage d'Analytics
  • PRINT envoie les résultats vers l'imprimante par défaut
IF test

optionnel

Expression conditionnelle qui doit être vraie afin de traiter chaque enregistrement. La commande est exécutée uniquement sur les enregistrements remplissant la condition.

Remarque

La condition IF est évaluée uniquement par rapport aux enregistrements restant dans une table après application des options relevant du champ d'application (WHILE, FIRST, NEXT).
WHILE test

optionnel

Expression conditionnelle qui doit être vraie afin de traiter chaque enregistrement. La commande est exécutée jusqu'à ce que la condition soit évaluée comme fausse ou lorsque la fin de la table est atteinte.

Remarque

Si vous utilisez WHILE conjointement avec FIRST ou NEXT, le traitement des enregistrements s'arrête dès qu'une limite est atteinte.
FIRST plage | NEXT plage

optionnel

Le nombre d'enregistrements à traiter :

  • FIRST pour commencer le traitement à partir du premier enregistrement jusqu'à ce que le nombre d'enregistrements spécifié soit atteint
  • NEXT pour commencer le traitement à partir de l'enregistrement actuellement sélectionné jusqu'à ce que le nombre d'enregistrements spécifié soit atteint

Utilisez plage pour indiquer le nombre d'enregistrements à traiter.

Si vous ignorez FIRST et NEXT, tous les enregistrements sont traités par défaut.
HEADER texte_en-tête

optionnel

Texte à insérer en haut de chaque page d'un rapport.

texte_en-tête doit être indiqué sous forme de chaîne entre guillemets. La valeur remplace la variable système Analytics HEADER.
FOOTER texte_pied_page

optionnel

Texte à insérer en bas de chaque page d'un rapport.

texte_pied_page doit être indiqué sous forme de chaîne entre guillemets. La valeur remplace la variable système Analytics FOOTER.
KEY champ_fractionnement

optionnel

Champ ou expression regroupant les calculs de sous-totaux. Un sous-total est calculé chaque fois que la valeur de champ_fractionnement change.

champ_fractionnement doit être un champ ou une expression de type caractère. Vous ne pouvez indiquer qu'un seul champ, mais vous pouvez utiliser une expression contenant plusieurs champs.
OPEN

optionnel

Ouvre la table créée par la commande après l'exécution de la commande. Valide uniquement lorsque la commande crée une table de sortie.
APPEND

optionnel

Ajoute la sortie de commande à la fin d'un fichier existant au lieu de remplacer ce fichier.

Remarque

Vous devez vous assurer que la structure de la sortie de la commande et du fichier existant est identique :

  • les mêmes champs
  • le même ordre des champs
  • les champs correspondants ont la même longueur
  • les champs correspondants ont le même type de données

Analytics ajoute la sortie à un fichier existant sans tenir compte de sa structure, ce qui peut désordonner les données si la structure de la sortie et du fichier existant ne correspond pas.
LOCAL

optionnel

Enregistre le fichier de sortie au même emplacement que le projet Analytics.

Remarque

Applicable uniquement lorsque vous exécutez la commande sur une table de serveur avec un fichier de sortie qui est une table Analytics.
STATISTICS

optionnel

Remarque

Ne peut pas être utilisée sauf si SUBTOTAL est également spécifié.

Calcule les valeurs moyenne, minimale et maximale pour tous les champs SUBTOTAL.

Exemples

Montant total des transactions par client

Vous souhaitez classer une table Comptes clients en fonction du champ Numéro_client et sous-totaliser le champ Montant_trans. Les résultats de sortie sont regroupés par client et incluent le montant total des transactions pour chaque client :

OPEN Comptes_clients 
CLASSIFY ON Numéro_Client SUBTOTAL Montant_Trans TO "Total_Clients.FIL"

Montants total, moyen, minimum et maximum des transactions par client

Comme dans l'exemple précédent, vous classez une table Comptes clients en fonction du champ Numéro_client et vous sous-totalisez le champ Montant_trans.

Maintenant, vous incluez STATISTICS pour calculer les montants moyen, minimum et maximum des transactions de chaque client :

OPEN Comptes_clients 
CLASSIFY ON Numéro_Client SUBTOTAL Montant_Trans TO "Stats_Clients.FIL" STATISTICS

Montants de facture identiques

Vous devez identifier les montants des factures qui apparaissent plusieurs fois dans la table Comptes_clients.

Pour ce faire, vous classez la table en fonction du champ Montant_facture. Les résultats de la sortie sont regroupés par montant de facture, avec un compte associé que vous pouvez utiliser pour identifier des montants de facture qui apparaissent plusieurs fois :

OPEN Trans_Cf
CLASSIFY ON Montant_Facture TO "Montants_facture_groupés.FIL" OPEN
SET FILTER TO COUNT > 1

Remarques

Remarque

Pour plus d'informations sur le fonctionnement de cette commande, consultez le Aide d'Analytics.

Fonctionnement

CLASSIFY regroupe les enregistrements présentant la même valeur dans un champ caractère ou numérique.

La sortie contient un seul enregistrement pour chaque groupe, avec le compte du nombre d'enregistrements de la table source inclus dans le groupe.

Tri et CLASSIFY

CLASSIFY peut traiter les données triées ou non triées. La sortie est automatiquement triée dans l'ordre croissant.

Noms des champs des sous-totaux et des statistiques générés automatiquement

Si vous utilisez STATISTICS pour effectuer des calculs statistiques sur un ou plusieurs champs SUBTOTAL, et que vous produisez les résultats vers une table Analytics, les champs générés automatiquement par les paramètres ont les noms suivants :

Description du champ généré automatiquement

Nom du champ dans la table de sortie

Autre titre de la colonne (nom d'affichage) dans la table de sortie

Champ Sous-total

nom du champ sous-totalisé dans la table source

Total + autre titre de la colonne sous-totalisé dans la table source

Champ Moyenne

a_nom du champ sous-totalisé dans la table source

Moyenne + autre titre de la colonne sous-totalisé dans la table source

Champ Minimum

m_nom du champ sous-totalisé dans la table source

Minimum + autre titre de la colonne sous-totalisé dans la table source

Champ Maximum

x_nom du champ sous-totalisé dans la table source

Maximum + autre titre de la colonne sous-totalisé dans la table source

[ Retour au début ]

Guide de création de scripts ACL 14.1