La syntaxe de référence servant à examiner ou à modifier les propriétés et les valeurs d’objet peut prendre l’une des formes suivantes :La syntaxe de référence contient la hiérarchie d’objet complète commençant par le nœud racine xfa. La syntaxe de référence complète permet d’accéder précisément à la propriété ou la valeur d’un objet, quel que soit l’emplacement du calcul ou du script contenant la syntaxe.La syntaxe de référence est abrégée en raison du positionnement relatif du calcul ou du script qui contient la syntaxe de référence et les références aux objets de syntaxe ou en raison de l’utilisation de raccourcis. Bien qu’il soit généralement plus rapide de créer une syntaxe de référence abrégée, cette méthode présente l’inconvénient de ne plus être exploitable dès que les objets changent de position les uns par rapport aux autres.Cette illustration présente la syntaxe de référence complète, pour FormCalc et JavaScript, indiquant l’accès à la valeur du champ txtCondition. Cette syntaxe de référence peut être utilisée au sein d’un calcul ou d’un script ou encore avec tout objet du formulaire.
Remarque : même si la syntaxe de référence est commune à FormCalc et à JavaScript, vous devez respecter les conventions de chaque langage de script. Ainsi, dans l’exemple précédent, la syntaxe de référence est compréhensible par FormCalc, mais vous devrez inclure un caractère point-virgule à la fin (;) pour JavaScript.Si deux objets existent dans le même conteneur, tel qu’un sous-formulaire, leur référence indique qu’ils partagent le même contexte. Lorsque des objets existent dans le même contexte, vous pouvez utiliser une syntaxe de référence abrégée comprenant uniquement le nom de l’objet suivi de la propriété ou de la méthode à accéder. Par exemple, dans le cadre de l’exemple précédent, la syntaxe de référence abrégée suivante accède à la valeur du champ txtCondition à partir de n’importe quel champ situé dans le sous-formulaire total :Si deux objets existent dans des conteneurs différents, ils ne partagent pas le même contexte. Dans ce cas, vous pouvez utiliser une syntaxe de référence abrégée. Cependant, elle doit commencer par le nom de l’objet conteneur situé au niveau supérieur non commun aux deux objets. Ainsi, dans le cadre de la hiérarchie ci-dessus, la syntaxe de référence abrégée suivante indique la valeur du champ address du champ txtCondition :En raison de la manière dont le modèle d’objet de formulaire XML est structuré, certaines propriétés et méthodes d’objet existent pour les objets enfant sur le formulaire. Ces objets enfant existent seulement en tant que parties du modèle d’objet de formulaire XML et n’apparaissent pas dans les palettes Hiérarchie et Vue des données. Pour accéder à ces propriétés et méthodes, vous devez inclure les objets enfant dans la syntaxe de référence. La syntaxe de référence suivante définit le texte d’info-bulle pour le champ txtCondition :