Commande REPORT

Met en forme et génère un rapport à partir de la table Analytics ouverte.

Syntaxe

REPORT <ON champ_fractionnement <PAGE> <NODUPS> <WIDTH caractères> <AS nom_affichage>> <...n> FIELD autres_champs <WIDTH caractères> <AS nom_affichage> <...n> <SUPPRESS> <NOZEROS> <LINE n autres_champs> <PRESORT <champ_tri>> <...n> <SUMMARIZED> <SKIP n> <EOF> <TO {SCREEN|PRINT|nom_fichier <HTML>}> <IF >test> <WHILE test> <FIRST plage|NEXT plage> <HEADER texte_en-tête> <FOOTER texte_pied_page> <APPEND>

Paramètres

Nom	Description
ON champ_fractionnement PAGE NODUPS WIDTH caractères AS nom_affichage <...n> optionnel	Le ou les champs de type caractère utilisés pour diviser le rapport en sections. Une nouvelle section de rapport et un nouveau sous-total sont créés à chaque fois que la valeur de champ_fractionnement change. Diviser les rapports en sections peut faciliter leur lecture rapide. champ_fractionnement champ à utiliser comme champ de fractionnement Pour exécuter un rapport à partir d'une vue (DO REPORT), le champ de fractionnement doit se trouver être le champ caractère le plus à gauche dans la vue. PAGE insère un saut de page lorsque la valeur champ_fractionnement diffère NODUPS supprime les valeurs d'affichage dupliquées dans le champ de fractionnement Par exemple, si le nom d'un client est répertorié pour chaque enregistrement de facture, vous pouvez rendre le rapport plus lisible en indiquant seulement la première occurrence du nom du client. WIDTH caractères longueur de sortie du champ en nombre de caractères AS nom_affichage nom d'affichage (titre de la colonne) pour le champ dans le rapport. Indiquez le nom_affichage sous forme de chaîne entre guillemets. Utilisez un point-virgule (;) entre les mots si vous souhaitez insérer un saut de ligne dans le titre de la colonne. Si vous souhaitez que le nom d'affichage soit identique au nom du champ ou à un nom d'affichage existant dans la table source, n'utilisez pas AS. Remarque Vous devez spécifier ON pour utiliser champ_fractionnement , PAGE, NODUPS ou PRESORT.
FIELD autres_champs WIDTH caractères AS nom_affichage <...n>	Champs à inclure dans le rapport. WIDTH caractères longueur de sortie du champ en nombre de caractères AS nom_affichage nom d'affichage (titre de la colonne) pour le champ dans le rapport. Indiquez le nom_affichage sous forme de chaîne entre guillemets. Utilisez un point-virgule (;) entre les mots si vous souhaitez insérer un saut de ligne dans le titre de la colonne. Si vous souhaitez que le nom d'affichage soit identique au nom du champ ou à un nom d'affichage existant dans la table source, n'utilisez pas AS. Les mots-clés SUBTOTAL et ACCUMULATE sont des synonymes de FIELD et sont devenus obsolètes. Tous les champs numériques sont sous-totalisés automatiquement. Remarque Les champs de fractionnement sont inclus automatiquement dans le rapport et ne doivent être spécifiés sous autres_champs.
SUPPRESS optionnel	Exclut les lignes de détail vides du rapport.
NOZEROS optionnel	Substitue des valeurs vides aux valeurs nulles dans le champ. Par exemple, si, dans un rapport, un champ contient un grand nombre de zéros, la lecture du rapport est facilitée si ce dernier n'affiche que les valeurs non nulles.
LINE n autres_champs optionnel	Spécifie le nombre de lignes de sortie dans la colonne et les champs s'affichent sur le numéro de ligne n. Si aucune valeur n'est indiquée, la colonne comprend par défaut une seule ligne. La valeur n doit être comprise entre 2 et 60 inclus. Les titres des colonnes du rapport sont déterminés uniquement par les champs de la première ligne. autres_champs indique des expressions ou des champs appropriés pour le rapport.
PRESORT `champ_tri` <...n> optionnel	Trie champ_fractionnement , si un ou plusieurs champs de fractionnement sont spécifiés. Trie `champ_tri`, si un ou plusieurs champs de tri sont spécifiés. PRESORT ne trie pas les champs répertoriés sous autres_champs sauf s'ils sont aussi répertoriés sous `champ_tri`.
SUMMARIZED optionnel	Génère un rapport contenant uniquement des sous-totaux et des totaux, sans lignes de détail. Les sous-totaux sont générés pour les valeurs de l'unique champ de fractionnement. Si SUMMARIZED n'est pas spécifiée, Analytics génère un rapport contenant des lignes de détail, ainsi que le sous-total de chaque champ de fractionnement clé spécifié.
SKIP n optionnel	Insère des lignes vides entre les lignes de détail dans le rapport. n doit être un nombre entier indiquant le nombre de lignes à insérer. Par exemple, SKIP 1 génère un rapport avec un espacement double.
EOF optionnel	Réexécutez la commande une fois la fin du fichier atteinte. Cela garantit que le dernier enregistrement de la table est traité quand il se trouve à l'intérieur d'une commande GROUP. Utilisez le paramètre de traitement de fin de fichier uniquement si tous les champs sont calculés en se référant à des enregistrements antérieurs.
TO SCREEN \| PRINT\| nom_fichier <HTML> optionnel	Emplacement vers lequel envoyer les résultats de la commande : SCREEN affiche les résultats dans la zone d'affichage d'Analytics. 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" PRINT envoie les résultats vers l'imprimante par défaut Par défaut, les rapports rendus dans un fichier sont enregistrés en tant que fichiers texte ASCII. Indiquez HTML si vous souhaitez sortir le rapport sous forme de fichier HTML (.htm). Si vous ignorez TO, le rapport sort à l'écran.
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.
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.

Nom

Description

ON champ_fractionnement PAGE NODUPS WIDTH caractères AS nom_affichage <...n>

optionnel

Le ou les champs de type caractère utilisés pour diviser le rapport en sections.

Une nouvelle section de rapport et un nouveau sous-total sont créés à chaque fois que la valeur de champ_fractionnement change. Diviser les rapports en sections peut faciliter leur lecture rapide.

champ_fractionnement champ à utiliser comme champ de fractionnement
Pour exécuter un rapport à partir d'une vue (DO REPORT), le champ de fractionnement doit se trouver être le champ caractère le plus à gauche dans la vue.
PAGE insère un saut de page lorsque la valeur champ_fractionnement diffère
NODUPS supprime les valeurs d'affichage dupliquées dans le champ de fractionnement
Par exemple, si le nom d'un client est répertorié pour chaque enregistrement de facture, vous pouvez rendre le rapport plus lisible en indiquant seulement la première occurrence du nom du client.
WIDTH caractères longueur de sortie du champ en nombre de caractères
AS nom_affichage nom d'affichage (titre de la colonne) pour le champ dans le rapport.
Indiquez le nom_affichage sous forme de chaîne entre guillemets. Utilisez un point-virgule (;) entre les mots si vous souhaitez insérer un saut de ligne dans le titre de la colonne. Si vous souhaitez que le nom d'affichage soit identique au nom du champ ou à un nom d'affichage existant dans la table source, n'utilisez pas AS.

Remarque

Vous devez spécifier ON pour utiliser champ_fractionnement , PAGE, NODUPS ou PRESORT.

FIELD autres_champs WIDTH caractères AS nom_affichage <...n>

Champs à inclure dans le rapport.

WIDTH caractères longueur de sortie du champ en nombre de caractères
AS nom_affichage nom d'affichage (titre de la colonne) pour le champ dans le rapport.
Indiquez le nom_affichage sous forme de chaîne entre guillemets. Utilisez un point-virgule (;) entre les mots si vous souhaitez insérer un saut de ligne dans le titre de la colonne. Si vous souhaitez que le nom d'affichage soit identique au nom du champ ou à un nom d'affichage existant dans la table source, n'utilisez pas AS.

Les mots-clés SUBTOTAL et ACCUMULATE sont des synonymes de FIELD et sont devenus obsolètes. Tous les champs numériques sont sous-totalisés automatiquement.

Remarque

Les champs de fractionnement sont inclus automatiquement dans le rapport et ne doivent être spécifiés sous autres_champs.

SUPPRESS

optionnel

Exclut les lignes de détail vides du rapport.

NOZEROS

optionnel

Substitue des valeurs vides aux valeurs nulles dans le champ.

Par exemple, si, dans un rapport, un champ contient un grand nombre de zéros, la lecture du rapport est facilitée si ce dernier n'affiche que les valeurs non nulles.

LINE n autres_champs

optionnel

Spécifie le nombre de lignes de sortie dans la colonne et les champs s'affichent sur le numéro de ligne n.

Si aucune valeur n'est indiquée, la colonne comprend par défaut une seule ligne. La valeur n doit être comprise entre 2 et 60 inclus.

Les titres des colonnes du rapport sont déterminés uniquement par les champs de la première ligne. autres_champs indique des expressions ou des champs appropriés pour le rapport.

PRESORT champ_tri <...n>

optionnel

Trie champ_fractionnement , si un ou plusieurs champs de fractionnement sont spécifiés.
Trie champ_tri, si un ou plusieurs champs de tri sont spécifiés.

PRESORT ne trie pas les champs répertoriés sous autres_champs sauf s'ils sont aussi répertoriés sous champ_tri.

SUMMARIZED

optionnel

Génère un rapport contenant uniquement des sous-totaux et des totaux, sans lignes de détail.

Les sous-totaux sont générés pour les valeurs de l'unique champ de fractionnement. Si SUMMARIZED n'est pas spécifiée, Analytics génère un rapport contenant des lignes de détail, ainsi que le sous-total de chaque champ de fractionnement clé spécifié.

SKIP n

optionnel

Insère des lignes vides entre les lignes de détail dans le rapport.

n doit être un nombre entier indiquant le nombre de lignes à insérer. Par exemple, SKIP 1 génère un rapport avec un espacement double.

EOF

optionnel

Réexécutez la commande une fois la fin du fichier atteinte.

Cela garantit que le dernier enregistrement de la table est traité quand il se trouve à l'intérieur d'une commande GROUP. Utilisez le paramètre de traitement de fin de fichier uniquement si tous les champs sont calculés en se référant à des enregistrements antérieurs.

TO SCREEN | PRINT| nom_fichier <HTML>

optionnel

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

SCREEN affiche les résultats dans la zone d'affichage d'Analytics.
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"
PRINT envoie les résultats vers l'imprimante par défaut

Par défaut, les rapports rendus dans un fichier sont enregistrés en tant que fichiers texte ASCII. Indiquez HTML si vous souhaitez sortir le rapport sous forme de fichier HTML (.htm).

Si vous ignorez TO, le rapport sort à l'écran.

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.

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.

Exemples

Génération d'un rapport HTML

Vous générez un rapport depuis la table Ar puis vous le sortez sous forme de fichier HTML :

OPEN Comptes_clients
REPORT ON No FIELD Montant Type Échéance TO "C:\Reports\AR.htm" HTML

[ Retour au début ]

Guide de création de scripts ACL 14.1