Commande DEFINE COLUMN

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

Syntaxe

DEFINE COLUMN view_name field_name <AS display_name> <POSITION n> <WIDTH characters> <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 table_name.field_name.
AS nom_affichage

facultatif

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

facultatif

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

facultatif

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.

Note

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

facultatif

Note

S'applique aux champs numériques ou DateHeure.

  • Champs numériquesFormat d’affichage des valeurs numériques dans les vues et rapports Analytics.
  • champs DateHeureFormat physique des valeurs DateHeure dans les données source (ordre des caractères date et heure, séparateurs, etc.)

    Note

    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/DD/YYYY".

Le format doit être placé entre guillemets.

SORT | SORT D

facultatif

Trie la colonne :

  • ordre croissantSORT
  • ordre décroissantSORT D

KEY

facultatif

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

facultatif

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

NODUPS

facultatif

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

facultatif

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

facultatif

 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 Ar
DEFINE VIEW AR_Report OK
DEFINE COLUMN AR_Report No AS "Customer Number" WIDTH 7 KEY
DEFINE COLUMN AR_Report Date AS "Invoice Date" WIDTH 10
DEFINE COLUMN AR_Report Due AS "Due Date" WIDTH 10
DEFINE COLUMN AR_Report Reference AS "Reference Number" WIDTH 6
DEFINE COLUMN AR_Report Type AS "Transaction Type" WIDTH 5
DEFINE COLUMN AR_Report Amount AS "Transaction Amount" WIDTH 12 PIC "-9999999999.99"