Commande DEFINE FIELD . . . COMPUTED
Définit un champ calculé dans un format de table Analytics.
Syntaxe
Pour définir un champ calculé :
DEFINE FIELD nom_champ COMPUTED expression
Pour définir un champ calculé avec des paramètres facultatifs :
DEFINE FIELD nom_champ COMPUTED <IF test> <STATIC> <PIC format> <AS nom_affichage> <WIDTH caractères> <SUPPRESS> <note_champ> expression
Pour définir un champ calculé conditionnel :
DEFINE FIELD nom_champ COMPUTED *** BLANK_LINE *** valeur IF condition <valeur IF condition> <...n> valeur_par_défaut
Pour définir un champ calculé conditionnel avec des paramètres facultatifs :
DEFINE FIELD nom_champ COMPUTED <IF test> <STATIC> <PIC format> <AS nom_affichage> <WIDTH caractères> <SUPPRESS> <note_champ> valeur IF condition <valeur IF condition> <...n> valeur_par_défaut
Remarque
La syntaxe multiligne doit présenter exactement la même structure que la syntaxe illustrée dans la syntaxe générique ci-dessus et dans les exemples ci-dessous.
Paramètres
| Nom | Description |
|---|---|
| nom_champ |
Le nom du champ calculé. Remarque La longueur des noms des champs ne doit pas dépasser 256 caractères alphanumériques majuscules et minuscules. 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. Un certain nombre de mots-clés réservés ne peuvent pas être utilisés comme noms de champs dans Analytics. Pour consulter la liste complète, voir Mots-clés réservés. |
| expression | Une expression Analytics valide qui définit la valeur du champ calculé. |
| 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). |
|
STATIC optionnel |
Le champ affiche la même valeur sur chaque ligne de la table jusqu'à ce qu'une nouvelle valeur soit rencontrée. Par exemple, les données source contiennent un champ Nom de famille dont :
Dans ce cas, « Smith » s'affiche sur six lignes consécutives, puis « Wong » s'affiche sur la septième ligne. |
| PIC format optionnel |
Remarque S'applique aux champs numériques uniquement. Format d'affichage des valeurs numériques dans les vues et rapports Analytics. Le format doit être placé entre guillemets. |
|
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. |
| 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. La largeur d'affichage ne peut pas être inférieure à la longueur de nom_champ ou de nom_affichage. Si vous ignorez WIDTH, la largeur d'affichage est définie sur la longueur du champ en caractères. 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. |
|
SUPPRESS optionnel |
S'applique aux champs numériques uniquement. Supprime la totalisation automatique des champs calculés numériques dans les rapports Analytics. La totalisation de certains champs numériques n'est pas appropriée : par exemple, un champ coût unitaire ou un champ taux de remise. |
|
note_champ optionnel |
Commentaire de champ qui est ajouté à la définition de champ dans le format de table. note_champ doit être le dernier paramètre, après tous les autres paramètres obligatoires et facultatifs. Le texte ne peut pas être contenu sur plusieurs lignes. Les guillemets ne sont pas obligatoires. |
| valeur IF condition |
Champ calculé conditionnel uniquement.
|
| valeur_par_défaut |
Champ calculé conditionnel uniquement. La valeur ou l'expression à utiliser dans le champ calculé si aucune condition évaluée n'est vraie. Remarque La précision décimale de toutes les valeurs calculées numériques est déterminée par la précision de valeur_défaut. Par exemple, si vous indiquez une valeur par défaut de 0,00, toutes les valeurs calculées sont déterminées avec deux décimales, et sont arrondies si nécessaire. Pour une plus grande précision, augmentez le nombre de décimales dans valeur_défaut. |
Exemples
Définition d'un champ calculé
Vous définissez un champ calculé appelé Valeur en tant que produit des champs Coût et Quantité :
DEFINE FIELD Valeur COMPUTED Coût * Quantité
Définition d'un champ calculé avec des options
Vous définissez un champ calculé nommé Valeur_03, où plusieurs options sont définies. Vous incluez une condition IF qui limite les enregistrements à traiter par le champ calculé :
DEFINE FIELD Valeur_03 COMPUTED IF Product_Class = "03" PIC "($9.999.999,99)" AS "Valeur Prod Class 3" La valeur est le coût multiplié par la quantité Coût * Quantité
Définir un champ calculé conditionnel
Vous définissez un champ calculé conditionnel nommé Taxe_ventes qui calcule une autre taxe sur les ventes selon l'état d'exécution de la transaction. Les transactions exécutées en dehors de ces trois états présentent une taxe sur les ventes par défaut de 0,00 $.
Remarque
La deuxième ligne doit rester vide, car il n'y a pas de paramètres facultatifs.
DEFINE FIELD Taxe_ventes COMPUTED 0,0750 * Montant_vente IF Etat = "CA" 0,0400 * Montant_vente IF Etat = "NY" 0,0625 * Montant_vente IF Etat = "TX" 0,00
Définir un champ calculé conditionnel avec des options
Vous définissez un champ calculé conditionnel nommé Taxe_ventes_100 qui calcule une autre taxe sur les ventes selon l'état d'exécution de la transaction. Le champ calcule uniquement la taxe sur des montants supérieurs ou égaux à 100 $.
Les transactions exécutées en dehors de ces trois états présentent une taxe sur les ventes par défaut de 0,00 $.
Remarque
Lorsque vous spécifiez des paramètres facultatifs, ne laissez pas de lignes vides.
DEFINE FIELD Taxe_ventes_100 COMPUTED IF Montant_vente >= 100 0,0750 * Montant_vente IF Etat = "CA" 0,0400 * Montant_vente IF Etat = "NY" 0,0625 * Montant_vente IF Etat = "TX" 0,00
Remarques
Remarque
Pour plus d'informations sur le fonctionnement de cette commande, consultez le Aide d'Analytics.
Deux types de champs calculés
Il existe deux types de champs calculés :
- champ calculé standard
Un champ calculé standard effectue le même calcul sur chaque enregistrement d'une table.
Par exemple, dans une table Inventaire, vous pourriez créer un champ calculé qui multiplie la valeur du champ Coût par la valeur du champ Quantité pour calculer la Valeur d'inventaire au Coût pour chaque enregistrement.
- champ calculé conditionnel
Un champ calculé conditionnel est capable d'effectuer différents calculs sur les enregistrements d'une table, à partir d'un ensemble de conditions que vous spécifiez. Le calcul effectué sur un enregistrement dépend de la condition remplie par l'enregistrement.
Par exemple, dans une table Transactions, vous pourriez créer un champ calculé conditionnel qui calcule la TVA à l'aide d'un taux ajusté selon l'état où a été effectuée la transaction. Des conditions comme IF Etat = "CA" et IF Etat = "NY" testeraient chaque enregistrement pour identifier quel taux de TVA utiliser.
Instructions pour la création d'un champ calculé conditionnel
Remarque
Lorsque vous définissez un champ calculé conditionnel, si vous n'indiquez pas de paramètres facultatifs sur la deuxième ligne, vous devez la laisser vide.
Outre une valeur par défaut, les champs calculés conditionnels nécessitent au moins une valeur conditionnelle. Vous devez utiliser la syntaxe multiligne suivante pour définir un champ calculé conditionnel :
- les paramètres facultatifs s'affichent sur la deuxième ligne ;
- s'il n'y a pas de paramètres facultatifs, la deuxième ligne doit rester vide ;
- la première instruction de condition s'affiche sur la troisième ligne ;
- chaque instruction de condition supplémentaire nécessite une ligne séparée ;
- la valeur par défaut s'affiche sur la dernière ligne.
Écrasement des définitions de champ
Il est possible d'écraser une définition de champ dans un format de table en définissant un champ utilisant le même nom que le champ existant.
Si SET SAFETY est sur ON, Analytics affiche une boîte de dialogue de confirmation avant d'écraser le champ existant. Pour éviter l'interruption d'un script, vous pouvez définir SET SAFETY sur OFF, et Analytics remplacera le champ existant sans demander de confirmation.
Guide de création de scripts ACL 14.1