Commande GAPS

Information de Concept

Détecte si un champ numérique ou DateHeure dans une table Analytics contient une ou plusieurs omissions dans des données séquentielles.

Syntaxe

GAPS <ON> champ_clé <D> <UNFORMATTED> <PRESORT> <MISSING limite> <HEADER texte_en-tête> <FOOTER texte_pied_page> <IF test> <WHILE test> <FIRST plage|NEXT plage> <TO {SCREEN|nom_table|nom_fichier|PRINT}> <LOCAL><APPEND> <OPEN>

Paramètres

Nom	Description
ON champ_clé D	Champs ou expressions dans lequel ou laquelle rechercher des omissions. Incluez D pour trier le champ clé dans l'ordre décroissant. L'ordre de tri par défaut est croissant.
UNFORMATTED facultatif	Supprime les en-têtes et les sauts de page lorsque les résultats sont renvoyés dans un fichier.
PRESORT facultatif	Trie la table par le champ clé avant d'exécuter la commande. Note Vous ne pouvez pas utiliser PRESORT dans la commande GROUP.
MISSING limite facultatif	Les résultats de sortie contiennent des éléments manquants individuels plutôt que des plages d'omission. La valeur limite indique le nombre maximal d'éléments manquants à rapporter pour chaque omission identifiée. La valeur par défaut est 5. Si la limite est dépassée pour une omission particulière, les éléments manquants sont rapportés sous forme de plage pour cette omission. La valeur limite ne restreint pas le nombre total d'éléments manquants rapportés, mais uniquement le nombre d'éléments manquants rapportés dans une omission spécifique.
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.
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.
TO SCREEN \| nom_table \| 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_tableEnregistre les résultats dans une table Analytics Indiquez nom_table sous forme de chaîne entre guillemets avec une extension de fichier .FIL. Par exemple : TO "Output.FIL" Par défaut, le fichier de données de table (.FIL) est enregistré dans le dossier contenant le projet Analytics. Utilisez un chemin de fichier absolu ou relatif pour enregistrer le fichier de données dans un autre dossier existant : TO "C:\Output.FIL" TO "Results\Output.FIL" Note La longueur des noms des tables est limitée à 64 caractères alphanumériques, sans l'extension .FIL. Le nom peut inclure le caractère de soulignement ( _ ), mais aucun autre caractère spécial ni espace. Le nom ne peut pas commencer par un chiffre. 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.
LOCAL facultatif	Enregistre le fichier de sortie au même emplacement que le projet Analytics. Note Applicable uniquement lorsque vous exécutez la commande sur une table de serveur avec un fichier de sortie qui est une table Analytics. Le paramètre LOCAL doit suivre immédiatement le paramètre TO.
APPEND facultatif	Ajoute la sortie de commande à la fin d'un fichier existant au lieu de remplacer ce fichier. Note 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.
OUVRIR facultatif	Ouvre la table créée par la commande après l'exécution de la commande. Valide uniquement lorsque la commande crée une table de sortie.

Variables de sortie Analytics

Nom	Contient
GAPDUPn	Nombre total d'omissions, de doublons ou de groupes de doublons approximatifs identifiés par la commande.

Exemples

Recherche de numéro de facture manquant

Vous utilisez GAPS pour vérifier qu'aucun numéro de facture ne manque dans une table Factures :

OPEN Factures
GAPS ON Num_Fac PRESORT TO "Omissions_Factures.fil"

Remarques

Pour plus d'informations sur le fonctionnement de cette commande, consultez Recherche d'omissions.

Utilisation de GAPS sur des champs de type caractère

En plus de tester les champs numériques ou DateHeure, vous pouvez aussi rechercher des omissions dans des données numériques apparaissant dans un champ de type caractère. Par exemple, vous pouvez faire un test sur les numéros de chèque, qui sont généralement mis en forme en tant que données de type caractère.

Si des lettres et des nombres apparaissent en même temps dans un champ de type caractère, seuls les nombres sont testés, les lettres sont ignorées.