Commande DEFINE COLUMN

Crée et ajoute une ou plusieurs colonnes à une vue existante.

Syntaxe

DEFINE COLUMN nom_vue nom_champ <AS nom_affichage> <POSITION n> <WIDTH caractères> <PIC format> <SORT|SORT D> <KEY> <PAGE> <NODUPS> <NOZEROS> <LINE n>

Paramètres

Nom	Description
nom_vue	Vue à laquelle la colonne doit être ajoutée.
nom_champ	Champ pour lequel la colonne doit être créée. Pour utiliser un champ d'une table associée, spécifiez le nom du champ sous la forme nom_table.nom_champ.
AS nom_affichage optionnel	Nom d'affichage (titre de la colonne) pour le champ dans la vue. Si vous souhaitez que le nom d'affichage soit identique au champ nom, 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.
POSITION n optionnel	Position numérique, de gauche à droite, de la colonne : si vous ignorez ce paramètre, la colonne est placée à l'extrême droite lors de son ajout si un numéro de position est manquant, les positions des colonnes sont ajustées afin de les organiser par ordre séquentiel si une position est déjà utilisée, la nouvelle colonne est placée à gauche de la colonne occupant la position
WIDTH caractères optionnel	Largeur d'affichage du champ en nombre de caractères. La valeur indiquée contrôle la largeur d'affichage du champ dans les vues et rapports Analytics. La largeur d'affichage n'altère jamais les données ; elle peut toutefois masquer des données si elle est plus courte que la longueur du champ. Si vous ignorez WIDTH, la largeur d'affichage est définie sur la largeur de caractères spécifiée pour le champ dans le format de table. Remarque Les caractères spécifiés par WIDTH sont des caractères à largeur fixe. Le même espace est attribué à chaque caractère, quelle que soit la longueur du caractère réel. Par défaut, les vues dans Analytics utilisent une largeur proportionnelle qui ne correspond pas à l'espacement des caractères à largeur fixe. Si vous souhaitez une correspondance un à un entre la valeur WIDTH et les caractères de la vue, vous pouvez modifier le paramètre Police proportionnelle dans la boîte de dialogue Options sur une police à châsse fixe comme Courier New.
PIC format optionnel	Remarque S'applique aux champs numériques ou DateHeure. champs numériques format d'affichage des valeurs numériques dans les vues et rapports Analytics champs DateHeure format physique des valeurs DateHeure dans les données source (ordre des caractères date et heure, séparateurs, etc.) Remarque Pour les champs DateHeure, le format doit correspondre exactement au format physique dans les données source. Par exemple, si les données source sont 12/31/2014, vous devez saisir la date au format "MM/JJ/AAAA". Le format doit être placé entre guillemets.
SORT \| SORT D optionnel	Trie la colonne : ordre croissant SORT ordre décroissant SORT D
KEY optionnel	La colonne est désignée comme champ de fractionnement dans les rapports. Les rapports sont sous-totalisés et sous-divisés lorsque la valeur de la colonne diffère. Les limitations ci-dessous s'appliquent aux champs de fractionnement : doit être un champ ou une expression de type caractère si un champ de fractionnement est défini dans la vue, il doit correspondre à la colonne la plus à gauche la dernière colonne dans la vue ne peut pas être un champ de fractionnement si plusieurs champs de fractionnement existent, toutes les colonnes à gauche d'un champ de fractionnement supplémentaire doivent également être des champs de fractionnement
PAGE optionnel	Insère un saut de page chaque fois que la valeur du champ de fractionnement diffère.
NODUPS optionnel	Substitue des valeurs vides aux valeurs répétées dans le champ. Par exemple, si le nom d'un client est répertorié pour chaque enregistrement de facture, le rapport est plus lisible s'il montre uniquement la première occurrence de chaque nom de client.
NOZEROS optionnel	Substitue des valeurs vides aux valeurs nulles dans le champ. Par exemple, si, dans un rapport, un champ contient un grand nombre de zéros, la lecture du rapport est facilitée si ce dernier n'affiche que les valeurs non nulles.
LINE n optionnel	Nombre de lignes dans la colonne. Si aucune valeur n'est indiquée, la colonne comprend par défaut une seule ligne. La valeur n doit être comprise entre 2 et 60.

Nom

Description

nom_vue

Vue à laquelle la colonne doit être ajoutée.

nom_champ

Champ pour lequel la colonne doit être créée.

Pour utiliser un champ d'une table associée, spécifiez le nom du champ sous la forme nom_table.nom_champ.

AS nom_affichage

optionnel

Nom d'affichage (titre de la colonne) pour le champ dans la vue. Si vous souhaitez que le nom d'affichage soit identique au champ nom, 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.

POSITION n

optionnel

Position numérique, de gauche à droite, de la colonne :

si vous ignorez ce paramètre, la colonne est placée à l'extrême droite lors de son ajout
si un numéro de position est manquant, les positions des colonnes sont ajustées afin de les organiser par ordre séquentiel
si une position est déjà utilisée, la nouvelle colonne est placée à gauche de la colonne occupant la position

WIDTH caractères

optionnel

Largeur d'affichage du champ en nombre de caractères.

La valeur indiquée contrôle la largeur d'affichage du champ dans les vues et rapports Analytics. La largeur d'affichage n'altère jamais les données ; elle peut toutefois masquer des données si elle est plus courte que la longueur du champ.

Si vous ignorez WIDTH, la largeur d'affichage est définie sur la largeur de caractères spécifiée pour le champ dans le format de table.

Remarque

Les caractères spécifiés par WIDTH sont des caractères à largeur fixe. Le même espace est attribué à chaque caractère, quelle que soit la longueur du caractère réel.

Par défaut, les vues dans Analytics utilisent une largeur proportionnelle qui ne correspond pas à l'espacement des caractères à largeur fixe.

Si vous souhaitez une correspondance un à un entre la valeur WIDTH et les caractères de la vue, vous pouvez modifier le paramètre Police proportionnelle dans la boîte de dialogue Options sur une police à châsse fixe comme Courier New.

PIC format

optionnel

Remarque

S'applique aux champs numériques ou DateHeure.

champs numériques format d'affichage des valeurs numériques dans les vues et rapports Analytics
champs DateHeure format physique des valeurs DateHeure dans les données source (ordre des caractères date et heure, séparateurs, etc.)
Remarque
Pour les champs DateHeure, le format doit correspondre exactement au format physique dans les données source. Par exemple, si les données source sont 12/31/2014, vous devez saisir la date au format "MM/JJ/AAAA".

Le format doit être placé entre guillemets.

SORT | SORT D

optionnel

Trie la colonne :

ordre croissant SORT
ordre décroissant SORT D

KEY

optionnel

La colonne est désignée comme champ de fractionnement dans les rapports. Les rapports sont sous-totalisés et sous-divisés lorsque la valeur de la colonne diffère. Les limitations ci-dessous s'appliquent aux champs de fractionnement :

doit être un champ ou une expression de type caractère
si un champ de fractionnement est défini dans la vue, il doit correspondre à la colonne la plus à gauche
la dernière colonne dans la vue ne peut pas être un champ de fractionnement
si plusieurs champs de fractionnement existent, toutes les colonnes à gauche d'un champ de fractionnement supplémentaire doivent également être des champs de fractionnement

PAGE

optionnel

Insère un saut de page chaque fois que la valeur du champ de fractionnement diffère.

NODUPS

optionnel

Substitue des valeurs vides aux valeurs répétées dans le champ.

Par exemple, si le nom d'un client est répertorié pour chaque enregistrement de facture, le rapport est plus lisible s'il montre uniquement la première occurrence de chaque nom de client.

NOZEROS

optionnel

Substitue des valeurs vides aux valeurs nulles dans le champ.

Par exemple, si, dans un rapport, un champ contient un grand nombre de zéros, la lecture du rapport est facilitée si ce dernier n'affiche que les valeurs non nulles.

LINE n

optionnel

Nombre de lignes dans la colonne. Si aucune valeur n'est indiquée, la colonne comprend par défaut une seule ligne. La valeur n doit être comprise entre 2 et 60.

Exemples

Définir une vue avec 6 colonnes

Une fois la table AR ouverte, vous définissez une vue Rapport_AR et vous définissez 6 colonnes. Les colonnes s'affichent dans l'ordre indiqué :

OPEN Comptes_clients
DEFINE VIEW Rapport_AR OK
DEFINE COLUMN Rapport_AR No AS "Numéro client" WIDTH 7 KEY
DEFINE COLUMN Rapport_AR Date AS "Date facture" WIDTH 10
DEFINE COLUMN Rapport_AR Echéance AS "Date échéance" WIDTH 10
DEFINE COLUMN Rapport_AR Référence AS "Numéro référence" WIDTH 6
DEFINE COLUMN Rapport_AR Type AS "Type transaction" WIDTH 5
DEFINE COLUMN Rapport_AR Montant AS "Montant transaction" WIDTH 12 PIC "-9999999999,99"

[ Retour au début ]

Guide de création de scripts ACL 14.1