Commande DEFINE VIEW

Définit une nouvelle vue ou remplace une vue existante.

Syntaxe

DEFINE VIEW nom_vue <RLINES n> <ALL> <SUPPRESS> <SUMMARIZED> <IF test> <WHILE test> <HEADER texte_en-tête> <FOOTER texte_pied_page> <TO nom_fichier_rapport <HTML>> <OK>

Paramètres

Nom Description
nom_vue

Nom de la vue à créer ou à remplacer.

Remarque :

La longueur des noms de vues est limitée à 64 caractères alphanumériques. 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.

RLINES n

optionnel

Interligne utilisé pour les enregistrements de détail dans les vues et les rapports. Les lignes de détail sont formatées par défaut avec un interligne simple.

ALL

optionnel

Tous les champs dans le format de table Analytics actif sont ajoutés à la vue.

SUPPRESS

optionnel

Supprime les lignes de détail vides dans les rapports générés dans la vue. Lors de la génération du rapport, les lignes de détail vides sont ignorées dans la sortie. Cette option s'applique aux rapports basés sur des vues multilignes.

SUMMARIZED

optionnel

Indique que les rapports générés dans la vue doivent inclure les sous-totaux et les totaux, mais pas les lignes de détail.

Les sous-totaux sont générés en fonction des champs de fractionnement définis dans la vue. Si cette option n'est pas sélectionnée, le rapport contient les lignes de détail et les sous-totaux de chaque champ de fractionnement spécifié.

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.

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.

TO nom_fichier_rapport HTML

optionnel

Nom de fichier et type des rapports créés dans cette vue.

Utilisez le mot-clé HTML pour enregistrer les rapports générés dans cette vue en tant que fichiers HTML (.htm). Par défaut, les rapports générés sont rendus en tant que fichiers texte ASCII.

OK

optionnel

Supprime ou écrase des éléments sans demander de confirmation.

Exemples

Création d'une vue

Vous ouvrez la table Ar et créez une vue appelée Rapport_AR, qui inclut tous les champs dans le format de table :

OPEN Comptes_clients
DEFINE VIEW Rapport_AR HEADER "Rapport AR" ALL OK
Guide de création de scripts ACL 14.1