Commande AGE
Regroupe les enregistrements en périodes d'antériorité à partir des valeurs dans un champ date ou DateHeure. Compte le nombre d'enregistrements dans chaque période et calcule également le sous-total des champs numériques spécifiés pour chaque période.
Syntaxe
AGE <ON> champ_date <CUTOFF date_référence> <INTERVAL jours <;...n>> <SUPPRESS> <SUBTOTAL champ_numérique <...n>|SUBTOTAL ALL> <IF test> <WHILE test> <FIRST plage|NEXT plage> <TO {SCREEN|nom_fichier|GRAPH|PRINT}> <KEY champ_fractionnement> <HEADER texte_en-tête> <FOOTER texte_pied_page> <APPEND> <LOCAL> <STATISTICS>
Paramètres
| Nom | Description |
|---|---|
| ON champ_date |
Nom du champ de date ou DateHeure ou de l'expression à classer par antériorité. Bien que vous puissiez classer par antériorité un champ de DateHeure, seule la portion date des valeurs DateHeure est prise en compte. La portion heure est ignorée. Vous ne pouvez pas faire un classement par antériorité sur des données de temps uniquement. |
| CUTOFF date_référence optionnel |
Date à laquelle les valeurs dans champ_date sont comparées. Vous devez indiquer la date_référence sous forme de chaîne sans guillemets au format AAMMJJ ou AAAAMMJJ, quel que soit le format du champ de date. Par exemple : CUTOFF 20141231 Si vous ignorez CUTOFF, c'est la date système actuelle qui est utilisée comme date de référence. |
| INTERVAL jours <;...n> optionnel |
Intervalles de date (c'est-à-dire le nombre de jours) servant à calculer les périodes d'antériorité. jours représente le début de chaque période d'antériorité mesurée à rebours à partir de la date_référence :
Vous devez indiquer les intervalles sous forme de chaîne de valeurs séparées par des virgules, sans guillemets : INTERVAL 0;90;180;270;365 Les périodes d'antériorité par défaut sont 0; 30; 60; 90; 120 et 10 000 jours. Un intervalle de 10 000 jours sert à isoler les enregistrements comportant des dates qui sont probablement non valides. Si nécessaire, ces intervalles de dates peuvent être personnalisés pour refléter d'autres rapports internes de classement par antériorité. |
| SUPPRESS optionnel |
Supprime les dates de la sortie de la commande ne tombant pas dans la période d'antériorité. |
| 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. |
| 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 :
Utilisez plage pour indiquer le nombre d'enregistrements à traiter. Si vous ignorez FIRST et NEXT, tous les enregistrements sont traités par défaut. |
| TO SCREEN | nom_fichier | GRAPH | PRINT |
Emplacement vers lequel envoyer les résultats de la commande :
|
| 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. |
| 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. |
| 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 :
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
Classer par antériorité des factures avec des montants sous-totalisés
Vous souhaitez classer par antériorité une table Comptes clients en fonction du champ Date_facture et sous-totaliser le champ Montant_facture.
Les factures sont regroupées par périodes de 30 jours :
- à compter de la date limite jusqu'à 29 jours avant
- à compter des 30 jours précédents jusqu'à 59 jours précédents
- etc.
Les résultats incluent le montant total des factures en attente pour chaque période :
OPEN Comptes_clients AGE ON Date_Facture CUTOFF 20141231 INTERVAL 0;30;60;90;120;10000 SUBTOTAL Montant_Facture TO SCREEN
Remarques
Remarque
Pour plus d'informations sur le fonctionnement de cette commande, consultez le Aide d'Analytics.
Périodes de classement par antériorité
La commande AGE sert à regrouper les enregistrements en périodes d'antériorité à partir des valeurs dans un champ date ou DateHeure. Les résultats de sortie contiennent un seul enregistrement pour chaque période, avec le compte du nombre d'enregistrements de la table source inclus dans chaque période.
Mesure des intervalles
Les périodes d'antériorité sont basées sur des intervalles de date (c'est-à-dire le nombre de jours) mesurés à partir de la date système actuelle en remontant dans le temps ou à partir d'une date de référence que vous spécifiez, par exemple, une date de fin de période fiscale.
Périodes futures
Vous pouvez créer des périodes d'antériorité plus récentes que la date de référence en saisissant des valeurs négatives pour les intervalles de date. Par exemple, ce qui suit crée des périodes d'antériorité à partir de la date limite et jusqu'à la date limite :
INTERVAL -60;-30;0;30;60;90
Cette approche crée un profil de date de tous les enregistrements d'une table utilisant différents points dans le temps.
Cas d'utilisations courantes
Les utilisations courantes du classement par antériorité comprennent l'analyse des tendances de vente, l'observation des volumes de transactions et le regroupement des factures en fonction du nombre de jours échus.
Analytics crée automatiquement une ou deux périodes d'antériorité pour les dates situées en dehors des périodes d'antériorité spécifiées, en supposant que vous n'utilisez pas la commande SUPPRESS.
Guide de création de scripts ACL 14.1