Bookmark variables
Les variables appelées ‘signets’ sont des éléments dynamiques prévus par Process et utilisables dans différents contextes.
Par exemple, dans certains contextes, ${iUser.fullName} sera remplacé par le Prénom et le nom de l’utilisateur connecté.
Dans les sites web
Dans les sites web, les variables peuvent être utilisés à tout moment dans les éléments de type titre, texte, lien hypertexte,…
Exemples d’utilisation
- Afficher le nom de la page comme titre de niveau 1 dans le modèle de page. Permet un meilleur référencement.
- Paramétrage des plugins (cf. article dédié)
- Ajouter des éléments de partage dans les réseaux sociaux avec le signet de l’url de la page.
- Mettre une image dynamique dans l’en-tête en fonction de la rubrique (variable dans le chemin de l’image).
Les variables sont à la base du fonctionnement des plugins et peuvent être utilisées avec des blocs de développement.
Liste des signets disponibles
Cette liste est non exhaustive et tirée de la documentation produit (p. 53 du guide animateur des sites web).
| Signet | Description |
|---|---|
${iSite.label} |
Affiche le libellé du site courant |
${iSite.name} |
Affiche le nom du site courant |
${iTopic.label} |
Affiche le libellé de la rubrique courante |
${iTopic.name} |
Affiche le nom de la rubrique courante |
${iPageContainer.label} |
Affiche le libellé de la page courante |
${iPageContainer.name} |
Affiche le nom de la page courante |
${SysContentContext.label} |
Affiche le libellé dynamique de la page courante. Si la page est la page d’index, le libellé affiché est celui de la rubrique courante. |
${iSiteExecutionContext.siteUrl} |
Affiche l’url de la racine du site http://server/process/easysite/site/rubrique/page |
${SysContentContext.relativeUri} |
Affiche l’URI relative de la page courante dans le site http://server/process/easysite/site/rubrique/page |
${SysContentContext.url} |
Affiche l’url de la page courante dans le site http://server/process/easysite/site/rubrique/page |
${SysContentContext.versionModificationDate} |
Affiche la date de dernière modification de la page courante |
${SysContentContext.versionActor} |
Affiche l’auteur de la page courante |
${Statistics.views} |
Affiche le nombre de visites de la page courante |
${Statistics.ratingCount} |
Affiche le nombre de votes de la page courante La page doit déjà comporter un élément “Notation de la page” |
${Statistics.averageRating} |
Affiche la moyenne des votes de la page courante La page doit déjà comporter un élément “Notation de la page” |
${iUser.firstName} |
Affiche le prénom de l’utilisateur connecté |
${iUser.lastName} |
Affiche le nom de l’utilisateur connecté |
${iUser.nickName} |
Affiche le surnom de l’utilisateur connecté |
${iUser.email} |
Affiche l’adresse email de l’utilisateur connecté |
${iUser.login} |
Affiche l’identifiant de l’utilisateur connecté |
${iUser.faxNumber} |
Affiche le fax de l’utilisateur connecté |
${iUser.phoneNumber} |
Affiche le téléphone de l’utilisateur connecté |
${iUser.mobilePhoneNumber} |
Affiche le téléphone mobile de l’utilisateur connecté |
${iUser.organization.name} |
Affiche le nom de l’organisation de l’utilisateur connecté |
${iUser.Localization.Label} |
Affiche le libellé de la localisation de l’utilisateur connecté |
${iUser.attribute.xxx} |
Affiche l’attribut étendu xxx de l’utilisateur connecté |
${baseSiteUrl} |
URL du site web (utile pour créer des liens qui s’adaptent dynamiquement au site) |
Since Process2024.1, the user has been redefined to optimize the architecture. Old use is still working but deprecated.
| Signet | Description |
|---|---|
${iSite.label} |
Affiche le libellé du site courant |
${iSite.name} |
Affiche le nom du site courant |
${iTopic.label} |
Affiche le libellé de la rubrique courante |
${iTopic.name} |
Affiche le nom de la rubrique courante |
${iPageContainer.label} |
Affiche le libellé de la page courante |
${iPageContainer.name} |
Affiche le nom de la page courante |
${SysContentContext.label} |
Affiche le libellé dynamique de la page courante. Si la page est la page d’index, le libellé affiché est celui de la rubrique courante. |
${iSiteExecutionContext.siteUrl} |
Affiche l’url de la racine du site http://server/process/easysite/site/rubrique/page |
${SysContentContext.relativeUri} |
Affiche l’URI relative de la page courante dans le site http://server/process/easysite/site/rubrique/page |
${SysContentContext.url} |
Affiche l’url de la page courante dans le site http://server/process/easysite/site/rubrique/page |
${SysContentContext.versionModificationDate} |
Affiche la date de dernière modification de la page courante |
${SysContentContext.versionActor} |
Affiche l’auteur de la page courante |
${Statistics.views} |
Affiche le nombre de visites de la page courante |
${Statistics.ratingCount} |
Affiche le nombre de votes de la page courante La page doit déjà comporter un élément “Notation de la page” |
${Statistics.averageRating} |
Affiche la moyenne des votes de la page courante La page doit déjà comporter un élément “Notation de la page” |
${iUser.firstName} |
Affiche le prénom de l’utilisateur connecté |
${iUser.lastName} |
Affiche le nom de l’utilisateur connecté |
${iUser.personalInformation.nickName} |
Affiche le surnom de l’utilisateur connecté |
${iUser.email} |
Affiche l’adresse email de l’utilisateur connecté |
${iUser.login} |
Affiche l’identifiant de l’utilisateur connecté |
${iUser.faxNumber} |
Affiche le fax de l’utilisateur connecté |
${iUser.phoneNumber} |
Affiche le téléphone de l’utilisateur connecté |
${iUser.mobilePhoneNumber} |
Affiche le téléphone mobile de l’utilisateur connecté |
${iUser.organization.name} |
Affiche le nom de l’organisation de l’utilisateur connecté |
${iUser.Localization.Label} |
Affiche le libellé de la localisation de l’utilisateur connecté |
${iUser.attribute.xxx} |
Affiche l’attribut étendu xxx de l’utilisateur connecté |
${baseSiteUrl} |
URL du site web (utile pour créer des liens qui s’adaptent dynamiquement au site) |
Utiliser ses propres variables
Grâce au SDK ou aux Scripts Java, il est possible d’utiliser des variables “personnalisées” dans vos pages.
- Exemple java : Affichage d’un document des espaces documentaire dans une page web
- Article sur le fonctionnement de scripts dans les sites web
Dans le studio
Les variables sont utilisables dans les formulaires process, soit pour un affichage simple (à travers un élément “texte avec mise en forme” par exemple), soit dans une formule, soit dans le paramétrage des connecteurs.
Liste des variables disponibles
Info
Dans le cadre d’une utilisation dans une formule, il faut retirer le dollar et les accolades (prendre uniquement ce qui est entre “${” et “}”).
Signets Annuaire
Cette liste est non exhaustive, d’autres attributs standards de l’annuaire sont potentiellement utilisables, en revanche il est nécessaire se référer au SDK pour connaître leur nom.
| Variable | Description |
|---|---|
${iUser.firstName} |
Affiche le prénom de l’utilisateur connecté |
${iUser.lastName} |
Affiche le nom de l’utilisateur connecté |
${iUser.email} |
Affiche l’adresse email de l’utilisateur connecté |
${iUser.login} |
Affiche l’identifiant de l’utilisateur connecté |
${iUser.faxNumber} |
Affiche le fax de l’utilisateur connecté |
${iUser.phoneNumber} |
Affiche le téléphone de l’utilisateur connecté |
${iUser.mobilePhoneNumber} |
Affiche le téléphone mobile de l’utilisateur connecté |
${iUser.organization.name} |
Affiche le nom de l’organisation de l’utilisateur connecté |
${iUser.extendedAttributes.values.xxx} |
Affiche l’attribut étendu xxx de l’utilisateur connecté |
Signets Sous-processus
| Variable | Description |
|---|---|
${iWorkflowInstance.parentInstance.values.xxx} |
Affiche la valeur du champ xxx du document père |
Info
Il est aussi possible d’ajouter dans les mails d’intervention des sous-processus une URL vers le document père : voir le paragraphe “Signets Mails”.
Signets Réservoir de données
| Variable | Description |
|---|---|
${nomSystemeChampDonneeReservoir.Values.xxx} |
Affiche la valeur de la colonne xxx de la donnée de réservoir qui correspond au champ nomSystemeChampDonneeReservoir |
Signets Tableau dynamique
| Variable | Description |
|---|---|
${iResource.parentInstance.values.xxx} |
Pour une ligne de tableau dynamique, affiche la valeur du champ xxx du document père |
Signets Mails
| Variable | Description |
|---|---|
${workflowInstanceMailUrl} |
Url d’accès au document émettant le mail (contexte : changement d’étape). Exemple d’utilisation : <a href="${workflowInstanceMailUrl}">${sys_Reference} - ${sys_Title}</a> |
${parentWorkflowInstanceMailUrl} |
Url d’accès au document père, dans une logique de sous-processus (contexte : changement d’étape du fils et lien vers le père). Exemple d’utilisation : <a href="${parentWorkflowInstanceMailUrl}">${iWorkflowInstance.parentInstance.values.sys_Reference} - ${iWorkflowInstance.parentInstance.values.sys_Title}</a> |
Exemples d’utilisation dans les connecteurs
- Connecteur “Espace documentaires”, créer des dossiers portant le nom de l’organisation de l’utilisateur connecté
- Connecteur de mail, positionner l’utilisateur connecté comme expéditeur des mails
Source : https://wiki.myvdoc.net/xwiki/bin/view/Dev+Floor/JavalessVariables