La valeur d'un contrôle se construit à partir de l'élément affiché dans le formulaire.
Cet élément est décrit dans le Dictionnaire, où sont listés ses attributs.
La valeur dans le contrôle peut être simplement un attribut de l'objet, par exemple :
#{formAnimator.bean.brand} si "brand" est un attribut de l'objet affiché.
Mais elle peut aussi être un attribut indirect de l'objet, que l'on déterminera en remontant les objets du dictionnaire, pour lesquels l'entité est aussi un objet.
Exemple : adresse de commande
Supposons que l'on veuille afficher l'adresse de commande dans l'onglet [Général] de la commande :
- Dans le dictionnaire, ouvrir l'objet PO (Commande), onglet [Attributs].
L'attribut orderAddress désigne l'adresse de commande → #{formAnimator.bean.orderAddress}
L'entité associée à cet attribut est POADDRESS.
- Ouvrir l'objet POADDRESS (Adresse de commande) en cliquant sur l'infozone
, ouvrir l'onglet [Attributs].
L'attribut address désigne la composante adresse → #{formAnimator.bean.orderAddress.address}
L'entité associée à cet attribut est ADDRESS.
- Ouvrir l'objet ADDRESS (Adresse) en cliquant sur l'infozone , ouvrir l'onglet [Attributs].
On y trouve les attributs address1, address2, address3, zipCode, etc.
L'entité associée à ces attributs est STRING → Impossible d'aller plus loin.
→ Les valeurs des contrôles sont :
#{formAnimator.bean.orderAddress.address.address1}
#{formAnimator.bean.orderAddress.address.address2}
#{formAnimator.bean.orderAddress.address.address3}
#{formAnimator.bean.orderAddress.address.zipCode}
etc.
Cas particulier des coordonnées
Les coordonnées sont tous des objets PHONE.
L'attribut phoneNum doit être précédé du type de numéro :
- HOME_PHONE : Téléphone fixe,
- MOBILE_PHONE : Téléphone mobile,
- FAX : fax,
- EMAIL : Adresse électronique.
On obtient ainsi par exemple :
#{formAnimator.bean.orderContact.phones.HOME_PHONE.phoneNum} pour désigner le numéro de téléphone du contact de la commande.
#{formAnimator.bean.contactPo.phones.HOME_PHONE.phoneNum} ou #{formAnimator.bean.contactPoPhoneHome} pour désigner le numéro de téléphone du contact commande du fournisseur, la deuxième version ne pouvant être utilisée qu'en affichage.