Commande STRATIFY

Regroupe des enregistrements en intervalles numériques par valeurs dans un champ numérique. Compte le nombre d'enregistrements dans chaque intervalle et calcule également le sous-total des champs numériques spécifiés pour chaque intervalle.

Syntaxe

STRATIFY <ON> champ_numérique MINIMUM valeur MAXIMUM valeur {<INTERVALS nombre>|FREE valeur_intervalle <...n> dernier_intervalle} <SUPPRESS> <SUBTOTAL champ_numérique <...n>|SUBTOTAL ALL> <KEY champ_fractionnement> <TO {SCREEN|nom_table|nom_fichier|GRAPH|PRINT}> <IF test> <FIRST plage|NEXT plage> <WHILE test> <APPEND> <OPEN> <HEADER texte_en_tête> <FOOTER texte_pied_page> <LOCAL> <STATISTICS>

Paramètres

Nom Description
ON champ_numérique

Champ ou expression numérique à stratifier.

MINIMUM valeur

S'applique aux champs numériques uniquement. Valeur minimale du premier intervalle numérique.

MINIMUM est facultatif si vous utilisez FREE, sinon il est obligatoire.

MAXIMUM valeur

S'applique aux champs numériques uniquement. Valeur maximale du dernier intervalle numérique.

MAXIMUM est facultatif si vous utilisez FREE, sinon il est obligatoire.

INTERVALS nombre

optionnel

S'applique aux champs numériques uniquement.

Le nombre d'intervalles à taille égale générés par Analytics sur la plage spécifiée par les valeurs MINIMUM et MAXIMUM. Si vous n'indiquez pas de nombre d'intervalles, c'est la valeur par défaut qui est utilisée.

La valeur par défaut est spécifiée par le nombre d'Intervalles dans l'onglet Commande de la boîte de dialogue Options.

FREE valeur_intervalle <...n> dernier_intervalle

optionnel

S'applique aux champs numériques uniquement.

Crée des intervalles de taille personnalisée en spécifiant le point de départ de chaque intervalle et le point de fin du dernier intervalle.

Si vous spécifiez les valeurs MINIMUM et MAXIMUM, ces valeurs se trouvent au point de départ du premier intervalle et au point de fin du dernier intervalle ; chaque valeur_intervalle crée un nouvel intervalle à l'intérieur de la plage. Les valeurs des intervalles que vous spécifiez doivent être supérieures à la valeur MINIMUM et inférieures ou égales à la valeur MAXIMUM.

Les valeurs des intervalles doivent suivre l'ordre numérique et ne peuvent pas contenir de doublons :

FREE -1000; 0; 1000; 2000; 3000

Si vous indiquez à la fois FREE et INTERVALS, INTERVALS est ignoré.

SUPPRESS

optionnel

Les valeurs supérieures à la valeur MAXIMUM et inférieures à la valeur MINIMUM sont exclues de la sortie de commande.

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.

Si vous ne sélectionnez pas de champ de sous-total, le champ par lequel vous effectuez la stratification est automatiquement sous-totalisé.

Vous devez indiquer explicitement le champ Stratifier si vous souhaitez le sous-totaliser avec un ou plusieurs autres champs ou si vous souhaitez inclure des statistiques pour le champ Stratifier sous-totalisé.

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.

TO SCREEN nom_table | nom_fichier | 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.

  • nom_fichier enregistre les résultats dans un fichier

    Indiquez nom_fichier sous forme de chaîne entre guillemets avec l'extension de fichier appropriée. Par exemple : TO "Sortie.TXT"

    Par défaut, le fichier est enregistré dans le dossier contenant le projet Analytics.

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

    • TO "C:\Sortie.TXT"
    • TO "Résultats\Sortie.TXT"
  • 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).

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.

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.

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.

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.

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.

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

Stratifier par montant de facture

Vous devez stratifier une table Comptes clients sur le champ Montant_Facture. Le montant des factures est généralement sous-totalisé automatiquement.

La sortie est regroupée par intervalles de 1000 $ :

  • de 0 $ à 999,99 $
  • de 1 000 $ à 1 999,99 $
  • etc.

Le montant total des factures est inclus pour chaque intervalle.

OPEN Comptes_clients 
STRATIFY ON Montant_Facture MINIMUM 0 MAXIMUM 10000 INTERVALS 10 TO "Factures_Stratifiées.FIL"

Remarques

Remarque

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

Fonctionnement

STRATIFY permet de regrouper les enregistrements par intervalles numériques à taille égale ou personnalisée à partir de valeurs d'un champ numérique.

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

Remplir automatiquement les valeurs MINIMUM et MAXIMUM

Vous pouvez exécuter les commandes STATISTICS ou PROFILE sur un champ Stratifier avant l'exécution de la commande STRATIFY afin de remplir automatiquement les valeurs des paramètres MINIMUM et MAXIMUM avec la valeur la plus faible et la plus élevée dans le champ.

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

Guide de création de scripts ACL 14.1