Cette rubrique détaille les valeurs pouvant être prises par les contrôles personnalisés, voir Détail des contrôles .

Affichage d'une valeur d'attribut

La valeur d'un contrôle affichée est le plus souvent dépendante du contexte.

Pour connaître le format de la valeur, consulter la propriété "Expression" d'un contrôle standard. Cela donne un modèle pour affecter la valeur des contrôles personnalisés.

Sinon, utiliser les expressions au format indiqué dans la suite de la page.  

Écran de détail

La valeur est sous la forme #{formAnimator.bean.<attrName> }.

Exemples :

#{formAnimator.bean.PMP} dans le formulaire de détail d'un article, désigne le PMP.

#{formAnimator.bean.purchaseType.description} désigne le libellé de la nature d'achat.

#{formAnimator.bean.firstVendor} correspond à une infozone sur le fournisseur principal de l'article.

#{formAnimator.bean.computeActCost} désigne le total des coûts réalisés sur une intervention (champ calculé, donc en lecture seule).

Voir Déterminer la valeur d'un contrôle.

 

Afficher une information de changement d'état

L'expression #{<bean> .statusHisto.<CODE_ETAT> ['first'|'last'].<attrName> } désigne un attribut de la première ou dernière ligne d'historique concernant l'état de code <CODE_ETAT> .

Exemples :

#{formAnimator.bean.statusHisto.VALIDATED.changedBy.code} dans le formulaire de détail gamme, désigne le code de l'acteur ayant validé la gamme.

#{formAnimator.bean.statusHisto.VALIDATED['first'].comment} désigne le commentaire de la première validation de la gamme.

#{formAnimator.bean.statusHisto.VALIDATED['last'].changedDate} désigne le commentaire de la dernière validation de la gamme.

Si aucune des options ['first'] et ['last'] n'est indiquée, c'est la dernière occurrence qui est prise en compte.

 

Effectuer des comparaisons de dates

Les fonctions disponibles pour comparer un attribut à une date sont les suivantes :

•  isTodayOrBefore(Object value)
•  isYesterdayOrBefore(Object value)
•  isTodayOrAfter(Object value)
•  isTomorrowOrAfter(Object value)
•  isToday(Object value)
•  isTodayOrBeforeWithBeanContext(Object value, TemporalBean bean)
•  isYesterdayOrBeforeWithBeanContext(Object value, TemporalBean bean)
•  isTodayOrAfterWithBeanContext(Object value, TemporalBean bean)
•  isTodayWithBeanContext(Object value, TemporalBean bean)

Exemple :

Sur la fiche d'un matériel, on souhaite afficher un booléen si la date de fin de garantie est supérieure à sysdate.

La syntaxe à renseigner dans le champ affiché est alors : #{cs:isTomorrowOrAfter( formAnimator.bean.endGuarantee )}.

 

Afficher l'élément d'une liste

Pour les listes de type LIST, l'accès à un élément de la liste en précisant sa position s'effectue  sous la forme #{formAnimator.bean.<attrName> [i].<attrName> }.

Exemples :

#{formAnimator.bean.occupations[0].duration} désigne la durée de la première occupation dans le formulaire détail d'une intervention.

#{formAnimator.bean.purchaseLines[0].item.code} désigne le code de l'article de la première LDA d'une demande d'achat.

 

Cas particulier des équipements

#{formAnimator.bean.hierarchicalParents['MAIN'].parent} désigne le père de l'équipement dans l'arborescence principale.

#{formAnimator.bean.hierarchicalParents['MAIN'].linkBegin} désigne la date de rattachement de l'équipement à son père principal.

#{formAnimator.bean.hierarchicalParents['LOCATION'].parent.description} désigne le libellé du père géographique de l'équipement.

Il est possible d'afficher un champ qui permet d'affecter le père de l'équipement à sa création :

Exemples :

[MATERIAL,MAINMATERIAL,LOCATIONMATERIAL] pour un Matériel.

MAIN,LOCATION,LOCATIONMAIN] pour un point de structure.

 

Cas particulier du détail d'un déclencheur de plan d'interventions

#{tableAnimator.activeBean.bean.periodicityValue} désigne la valeur de la périodicité du déclencheur, dans le volet de détail du Plan d'interventions (formulaire détaillé).

Le champ doit être ajouté directement dans le volet de détail.

 

Cas particulier du contrat

Le formulaire affiché correspond à la période sélectionnée.

#{formAnimator.bean.contract.vendor} désigne le fournisseur du contrat.

 

Écran de recherche

La valeur est sous la forme #{formAnimator.searchBean.<attrName> }.

Pour l'ajout de critères de recherche, voir Filtre avancé et Ajout d'un critère de recherche.

 

Liste de résultat ou sous-liste d'un écran de détail

La valeur est sous la forme : #{tableAnimator.rowData.<attrName> }.

Exemple :

#{tableAnimator.rowData.firstVendor} dans le formulaire de résultat des articles affiche le fournisseur principal de l'article.

Cas particulier des équipements

#{tableAnimator.rowData.hierarchicalParents['LOCATION'].parent} désigne le père géographique de l'équipement.

Cas particulier du macroplanning

#{tableAnimator.rowData.data.actionType} désigne la nature de l'intervention.

#{tableAnimator.rowData.data.expLabourCost} désigne les coûts prévus de main d'œuvre.

Cas particulier des déclencheurs de plans d'interventions

#{tableAnimator.bean.periodicityValue} désigne la valeur de la périodicité du déclencheur, dans la liste des déclencheurs du Plan d'interventions.

 

Caractéristiques

L'accès à une caractéristique se fait par le code de la caractéristique.

Exemple :

#{formAnimator.bean.charactsMap['PUISSANCE'].objectValue} dans le formulaire de détail du Matériel affiche la caractéristique de code PUISSANCE si elle existe, et l'associe au Matériel si elle ne l'était pas.

 

Accès à un document

Pour que le clic sur un Lien ou un Bouton provoque l'ouverture d'un document lié, affecter à la propriété "action" la valeur OPENDOCACTION,
→ Une nouvelle propriété apparaît alors : "Paramètre 1".

Sa valeur doit être le code ou la nature du document à ouvrir, document lié à l'élément ou de la bibliothèque.
Elle peut être dynamique.

Exemple de paramètre 1 :

#{formAnimator.bean.item.notice} où "notice" est un champ spécifique contenant, soit le code du document lié à ouvrir, soit le code sa nature (Liste de valeurs DOCNATURE).

La propriété "Valeur" du lien permet de surcharger le libellé du lien avec un texte dynamique.

 

Ouverture d'une page avec son URL

Pour que le clic sur un Lien ou un Bouton provoque l'ouverture d'une page dans le navigateur, affecter à la propriété "action" la valeur OPENURLACTION,
→ Une nouvelle propriété apparaît alors : "Paramètre 1".

Sa valeur doit être l'URL.
La propriété "Cible", si précisée sur le lien (sous forme de texte libre), permet d'indiquer que l'URL sera ouverte dans une nouvelle fenêtre du navigateur.

Les liens qui ont la même valeur de cible dans un formulaire s'ouvriront tous dans la même fenêtre du navigateur.

• Action = OPENURLACTION
• Paramètre 1 = http://....//
• Cible, qui pour un lien, est un paramètre HTML et peut avoir les valeurs suivantes :
  • _blank : ouvre dans une nouvelle fenêtre,
  • _self : ouvre dans la même fenêtre,
  • L'attribut name d'une iframe présente dans la page.

1. Pour un bouton, le lien est toujours ouvert dans la fenêtre en cours.
2. L'attribut URL désigne le chemin de l'image illustrant le lien ou le bouton.

 

Image stockée dans un document

Pour un document de la bibliothèque ou un document lié, à afficher dans une image, l'accès se fait par :

Le code est unique, alors que plusieurs documents peuvent avoir la même nature.

Pour que la valeur soit prise en compte, la propriété "Image" doit être vide.

• Format de la valeur : #{formAnimator.documentURL['<code> ']}.

Exemple :

#{formAnimator.documentURL['CONTRAT_OTIS']} dans un contrôle lien de la fiche fournisseur est un lien hypertexte vers le document "CONTRAT_OTIS".

• Utilisation de la nature : #{formAnimator.documentURL['<nature> ']}.

Exemple :

#{formAnimator.documentURL['IMAGE']} dans un contrôle image de la fiche modèle affiche l'image contenue dans le document de nature "Photo", s'il est défini pour le modèle. (Les natures sont définies dans la liste de valeurs DOCNATURE).

• Le code ou la nature peut avoir une valeur dynamique.
  Dans ce cas, la valeur doit être au format : #{formAnimator.documentURL[formAnimator.bean.<attribut> ]}, où attribut est un attribut de l'élément, qui contient le code ou la nature du document lié.

Exemple :

#{formAnimator.documentURL[formAnimator.bean.code]}, si le document lié image porte le même code que l'élément lui-même.

• Photos : L'image à afficher peut être lue dans les documents liés des attributs, en appliquant une priorité.
  Le format est alors : #{formAnimator.documentURL['IMAGE,this,<attribut1> ,<attribut2> , etc.']}.

Cette syntaxe s'applique uniquement pour les documents liés de nature "Photo".

Exemple :

#{formAnimator.documentURL['IMAGE,this,material,material.item,mainVendor']}, dans le formulaire de l'article, si l'image est à chercher, par ordre de priorité décroissante : sur l'article, sur son Matériel, sur le modèle de son Matériel, sur le fournisseur principal.

 

Indicateur

Il est possible d'ajouter au formulaire des indicateurs, disposant ainsi d'informations calculées sur les éléments connexes.
Par exemple : La liste des Demandes de travaux sur un Matériel.

Dans le cas d'un indicateur filtre, le plus adéquat est d'ajouter un lien, mais dans tous les cas, il est possible d'afficher le libellé et la valeur de l'indicateur.

Voir Création d'un alerteur : Exemple.

• Un contrôle "Lien" :
  • Action : VIEWINDRESULTACTION, pour un indicateur filtre uniquement,
  • Valeur : #{formAnimator.IUFAnimator.indicators['<code indicateur> '].description}
  • Paramètre 1 : Code de l'indicateur (exemple : MR_MAT),
  • Label : vide.

• Un contrôle "Lien" ou "Champ", où est affichée la valeur de l'indicateur :
  • Action : VIEWINDRESULTACTION, pour un indicateur filtre uniquement,
  • Valeur : #{formAnimator.IUFAnimator.indicatorValues['<code indicateur> '].value}
  • Paramètre 1 : Code de l'indicateur,
  • Label : vide.

• Un contrôle "Image", correspondant au pictogramme de l'indicateur :
  • Image : Valeur vide.
  • Valeur : #{formAnimator.IUFAnimator.indicatorValues['<code indicateur> '].URL_bitmap}

 

Indicateur sur élément connexe

Il est aussi possible d'afficher un indicateur se rapportant à un attribut de l'objet.
Par exemple, afficher sur l'écran de détail intervention, l'indicateur retournant la liste des périodes de contrat du Matériel de l'intervention en cours.
Dans ce cas, ajouter un lien, avec les valeurs suivantes :

 

Actualisation de l'indicateur

Pour que l'indicateur soit actualisé lorsque le champ auquel il se rapporte est renseigné,

1. Sélectionner ce champ,
2. Cliquer sur l'icône de rafraîchissement ,
3. Propriété Zones rafraîchies : Renseigner l'identifiant du (ou des) composant(s) contenant l'indicateur.

 

Attribut constitué d'un tableau ou d'une liste

Si un champ pointe sur un élément de tableau ou de liste (cas rare), l'accès se fait en indiquant sa position uniquement.

• Format de la valeur : #{formAnimator.bean.<attrListName> [<idx> ].<attrName> }.

Exemple :

#{formAnimator.bean.preventiveTriggerPatterns[1].symptom désigne le symptôme du premier des déclencheurs du Modèle de plan d'interventions.