Commande SEQUENCE

Information de concept

Test de l'ordre séquentiel

Détermine si un ou plusieurs champs d'une table Analytics sont classés par ordre séquentiel, et identifie les éléments hors séquence.

Syntaxe

SEQUENCE <ON> {<FIELDS> champ_clé <D> <...n>|<FIELDS> ALL <EXCLUDE nom_champ <...n>>} <UNFORMATTED> <ERRORLIMIT n> <IF test> <WHILE test> <FIRST plage|NEXT plage> <TO {SCREEN|nom_fichier|PRINT}> <APPEND> <HEADER texte_en_tête> <FOOTER texte_pied_page> <PRESORT> <ISOLOCALE locale_code>

Paramètres

Nom Description
ON FIELDS champ_clé D <...n> | FIELDS ALL

Un ou plusieurs champs de type caractère, numérique ou DateHeure à tester concernant l'ordre séquentiel.

  • FIELDS champ_clé teste le(s) champ(s) spécifié(s)

    Les champs multiples doivent être séparés par des espaces, et peuvent être de types de données différents.

    Si vous testez en fonction de plusieurs champs, les champs sont testés dans l'ordre dans lequel vous les faites figurer dans la liste.

    Incluez D pour tester les valeurs des champs clés dans l'ordre décroissant. Par défaut, l'ordre des tests est croissant.

  • FIELDS ALL teste tous les champs de la table

    Si vous testez selon tous les champs, les champs sont testés dans l'ordre où ils apparaissent dans le format de table.

    Le test des valeurs des champs clés dans l'ordre croissant est la seule option pour FIELDS ALL.

Remarque

Lorsque vous testez selon plusieurs champs, vous testez un ordre séquentiel imbriqué dans la table source. Pour que l'utilisation de SEQUENCE soit valable, vous devez spécifier les champs de test dans le même ordre que l'ordre séquentiel imbriqué existant dans la table source. Plusieurs champs de test sont testés sous forme de groupe imbriqué. Ils ne sont pas testés indépendamment les uns des autres.
EXCLUDE nom_champ

optionnel

Valide uniquement pour les tests d'ordre séquentiel à l'aide de FIELDS ALL.

Le ou les champs à exclure de la commande. EXCLUDE vous permet de personnaliser le mot-clé ALL, en excluant les champs spécifiés.

EXCLUDE doit suivre immédiatement FIELDS ALL, ou la dernière occurrence du mot-clé ALL si vous incluez des champs d'une ou de plusieurs tables associées. Par exemple :

FIELDS ALL EXCLUDE champ_1 champ_2
FIELDS ALL nom_table_associée.ALL EXCLUDE champ_1 champ_2

UNFORMATTED

optionnel

Supprime les en-têtes et les sauts de page lorsque les résultats sont renvoyés dans un fichier.

ERRORLIMIT n

optionnel

Le nombre d'erreurs toléré avant la fin de la commande. La valeur par défaut est 10.

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.

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

    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_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

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.

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.

PRESORT

optionnel

Trie la table par le champ clé avant d'exécuter la commande.

Remarque

Vous ne pouvez pas utiliser PRESORT dans la commande GROUP.
ISOLOCALE code_paramètres_régionaux

optionnel

Remarque

Applicable dans l'édition Unicode d'Analytics uniquement.

Paramètre système local au format langue_pays. Par exemple, pour utiliser le français canadien, saisissez fr_ca.

Utilisez les codes suivants :

  • langue code linguistique de la norme ISO 639
  • pays code pays de la norme ISO 3166

    Si vous n'indiquez pas de code pays, c'est le pays par défaut pour la langue qui est utilisé.

Si vous n'utilisez pas ISOLOCALE, ce sont les paramètres système régionaux par défaut qui sont utilisés.

Variables de sortie Analytics

Nom Contient
WRITEn

Nombre total des erreurs de séquence identifiées par la commande.

Exemples

Tests sur les ID employés hors séquence

Vous écrivez dans un fichier texte toutes les erreurs de séquence identifiées dans le champ IDEmployé :

SEQUENCE ON IDEmployé ERRORLIMIT 10 to "ErreursSéquence.txt"

Remarques

Pour plus d'informations sur le fonctionnement de cette commande, consultez Test de l'ordre séquentiel.

Utilisation de SEQUENCE dans un GROUP

Si vous utilisez SEQUENCE dans une commande GROUP, la commande s'exécute pour éviter toute interférence avec le traitement du groupe, mais aucune autre erreur de séquence de données n'est signalée.