Commande LIST

Sort les données d'un ou plusieurs champs d'une table Analytics dans un affichage mis en forme en colonnes.

Syntaxe

LIST {FIELDS nom_champ <AS nom_affichage> <...n>|FIELDS ALL} <LINE numéro liste_champs> <TO {SCREEN|nom_fichier|PRINT}> <UNFORMATTED> <IF test> <WHILE test> <FIRST plage|NEXT plage> <HEADER texte_en-tête> <FOOTER texte_pied_page> <SKIP lignes> <EOF> <APPEND>

Paramètres

Nom	Description
FIELDS nom_champ <...n> \| FIELDS ALL	Les champs à inclure dans la sortie : FIELDS nom_champ utilisez les champs spécifiés FIELDS ALL utilisez tous les champs dans la table
AS nom_affichage optionnel	Utilisé uniquement dans le cas d'une énumération des données à l'aide de FIELDS nom_champ. Nom d'affichage (titre de la colonne) pour le champ dans la sortie. 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. 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.
LINE numéro liste_champs optionnel	Plusieurs lignes sont utilisées dans la sortie pour chaque enregistrement : numéro numéro de ligne ; doit être compris entre 2 et 60 inclus liste_champs champs à inclure dans cette ligne
TO SCREEN \| nom_fichier \| PRINT 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
UNFORMATTED optionnel	La sortie s'affiche sous forme de texte sans mise en forme. La sortie est identique à celle créée par la commande EXPORT ASCII. Les données non formatées peuvent être renvoyées dans un fichier pour un traitement ultérieur par d'autres logiciels.
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.
SKIP lignes optionnel	Insère le nombre défini de lignes vides entre chaque enregistrement de la liste. Par exemple, LIST ALL SKIP 1 génère une liste avec un espacement double (une ligne vide entre chaque enregistrement).
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.
APPEND optionnel	Ajoute la sortie de commande à la fin d'un fichier existant au lieu de remplacer ce fichier.

Nom

Description

FIELDS nom_champ <...n> | FIELDS ALL

Les champs à inclure dans la sortie :

FIELDS nom_champ utilisez les champs spécifiés
FIELDS ALL utilisez tous les champs dans la table

AS nom_affichage

optionnel

Utilisé uniquement dans le cas d'une énumération des données à l'aide de FIELDS nom_champ.

Nom d'affichage (titre de la colonne) pour le champ dans la sortie. 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.

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.

LINE numéro liste_champs

optionnel

Plusieurs lignes sont utilisées dans la sortie pour chaque enregistrement :

numéro numéro de ligne ; doit être compris entre 2 et 60 inclus
liste_champs champs à inclure dans cette ligne

TO SCREEN | nom_fichier | PRINT

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

UNFORMATTED

optionnel

La sortie s'affiche sous forme de texte sans mise en forme. La sortie est identique à celle créée par la commande EXPORT ASCII. Les données non formatées peuvent être renvoyées dans un fichier pour un traitement ultérieur par d'autres logiciels.

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.

SKIP lignes

optionnel

Insère le nombre défini de lignes vides entre chaque enregistrement de la liste. Par exemple, LIST ALL SKIP 1 génère une liste avec un espacement double (une ligne vide entre chaque enregistrement).

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.

APPEND

optionnel

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

Exemples

Listage des exceptions et enregistrement dans un fichier texte

Vous utilisez LIST pour créer un rapport qui répertorie les exceptions identifiées dans une table d'inventaire. Le rapport est enregistré en tant que fichier texte :

LIST Numéro_produit Description Quantité Coût_unitaire Valeur IF Quantité < 0 OR Coût_unitaire < 0 HEADER "Valeurs négatives" TO "Exceptions.txt"

Remarques

Quand utiliser LIST

Utilisez LIST pour imprimer des données, afficher des données à l'écran ou les exporter vers un fichier texte.

Mise en forme et totaux

À moins de préciser UNFORMATTED, les informations suivantes figurent automatiquement :

numéros de page
date
heure
identification de l'utilisateur
en-têtes des colonnes

Les colonnes numériques sont également totalisées automatiquement.

[ Retour au début ]

Guide de création de scripts ACL 14.1