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_champIncluez le(s) champ(s) spécifié(s)

    Les champs sont inclus dans l'ordre dans lequel vous les énumérez.

  • FIELDS ALLIncluez tous les champs dans la table

    Les champs sont inclus dans leur ordre d'apparition dans le format de table.

AS nom_affichage

facultatif

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

facultatif

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

  • chiffreLe numéro de ligne ; doit être compris entre 2 et 60 inclus
  • liste_champsChamps à inclure dans cette ligne

TO SCREEN | nom_fichier | PRINT

facultatif

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

  • SCREENAffiche les résultats dans la zone d’affichage d’Analytics.

    Astuce

    Vous pouvez cliquer sur n'importe quelle valeur de résultat liée dans la zone d'affichage pour explorer jusqu'à l'enregistrement ou aux enregistrements associés dans la table source.

  • nom_fichierEnregistre 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 "Output.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:\Output.TXT"
    • TO "Results\Output.TXT"
  • PRINTEnvoie les résultats vers l’imprimante par défaut.

UNFORMATTED

facultatif

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

facultatif

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

Note

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

facultatif

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.

Note

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

facultatif

Le nombre d'enregistrements à traiter :

  • FIRSTPour commencer le traitement à partir du premier enregistrement jusqu’à ce que le nombre d’enregistrements spécifié soit atteint
  • NEXTPour 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

facultatif

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

facultatif

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

facultatif

 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

facultatif

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

facultatif

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.