Variables contextuelles
Tout au long du processus, un grand nombre de variables est disponible pour le developpeur. Certaines variables ne sont disponibles
que lorsque certaines actions sont effectuées, d’autres sont disponibles dès le départ. Une variable est reférencée directement dans les
textes sous la forme ${nom_variable}. Ces valeurs sont remplacées à la volée. 'Ma variable vaut ${mavariable}' donnera
'Ma variable vaut 3' si myvariable vaut 3
La variable la plus simple qui est toujours disponible est la variable de datafield. En effet, tous les écrans fournissent des
variables contextuelles sous le format ${datafieldId}. Exemple : ${CRMPRJ.STATUS} ou ${CRMPRJ.CONTRAT.ACCEUIL} dans le cas d’une
page
CGE_EXERCICE
Cette variable contient l’exercice comptable dans lequel l’utilisateur travaille. Attention, cette variable peut être différente de l’exercice
de la tâche dans lequelle l’utilisateur travaille. Pour avoir l’exercice de la tâche courante, utiliser TASK_CGE_EXERCICE
CURRENT_CHAIN_ID
Correspond à la chaine courante de travail. Cette chaine est définie par la dernière tâche ouverte. Si on ouvre la saisie des utilisateurs, la chaine courante sera SYS même si on clique sur une tâche déjà ouverte qui pointe vers UNI
CURRENT_DATAFIELD_ID
C’est l’identifiant du datafield associé au call. Dans le cas ou le processus s’execute dans uen tâche de vue ou sur une entité de façon globale, cette valeur sera toujours vide.
CURRENT_DATAPAGE_ID (Dossier)
La datapage est l’id unique du type de page du dossier. Cette variable vaut quelque chose uniquement si la tâche est de type dossier
CURRENT_DAY
Donne le jour courant du mois entre 1 et 31 suivant le mois.
CURRENT_DOMAIN
Le domaine courant correspond à la société dans laquelle l’utilisateur travaille. Attention, il est possible que cette société soit différente
pour la tâche en cours. Pour avoir la société de la tâche spécifiquement, voir CURRENT_TASK_DOMAIN
CURRENT_FIELD_ID
Comme pour le datafield, cette variable represente l’id du champ qui a lancé le processus. Dans un cas plus global de processus sur entité ou sur tâche/table, cette variable est vide.
CURRENT_FIELD_VALUE
Dans le cas ou le processus serait lancé depuis un champ, la valeur du champ est disponible sous ce nom.
CURRENT_HOUR
Cette variable basé sur l’instant de l’appel donne la fraction entière d’heure de la journée entre 0 et 23.
CURRENT_LANGUAGE
Cette variable contient la langue actuelle de l’utilisateur
CURRENT_MILLISECOND
Donne le nombre de millisecondes actuels dans la seconde actuelle au moment de l’appel. Sa valeur est donc entre 0 et 1000
CURRENT_MINUTE
Cette variable indique la minute de l’heure au moment de l’appel. Les valeurs possibles sont dont entières entre 0 et 59
CURRENT_MONTH_END_DAY
Contient le dernier jour du mois courant (28/29/30/31)
CURRENT_MONTH_END_ISO
Contient la date complète de la fin du mois courant au format ISO (2016-06-30 23:59:59)
CURRENT_MONTH_END
Contient la date complète de la fin du mois courant (30/06/2016)
CURRENT_MONTH
Permet de récupérer le mois courant. Le numéro du mois est en mois humain (valeurs entre 1 pour Janvier et 12 pour Décembre)
CURRENT_MONTH_START_DAY
Contient le 1er jour du mois courant (1)
CURRENT_MONTH_START_ISO
Contient la date complète du début du mois courant au format ISO (2016-06-01 00:00:00)
CURRENT_MONTH_START
Contient la date complète du début du mois courant (01/06/2016)
CURRENT_PAGE_ID (Dossier)
Correspond à l’occurrence de la page dans le dossier. C’est l’id de la page dans l’ordre de création de celles ci. La liste des occurrences n’est donc pas forcément complete si des pages sont supprimées.
CURRENT_SECOND
C’est la valeur de la seconde de minute courante au moment de l’appel. La valeur varie entre 0 et 59
CURRENT_SITE
Le site est le module principal actif sur le serveur. Il permet la customisation du paramétrage. Cette variable contient la valeur du site actuel
CURRENT_TASK_DOMAIN
Cette valeur correspond à la société de la tâche depuis laquelle le processus s’execute. Cette société peut être différente de la société globale dans
laquelle l’utilisateur travaille. Pour avoir la société globale, utiliser CURRENT_DOMAIN
CURRENT_TASK_ID
Correspond à l’ID de la tâche qui a initialisé le processus
CURRENT_TASK_STATE
Il est possible de connaitre l’état de la tâche au moment du démarrage du processus grâce à cette variable. Les états possibles sont :
- 1 Nouveau
- 2 En modification
- 3 En suppression
- 4 Etat normal
- 5 Suppression virtuelle
CURRENT_TASK_TABLE_ID
Correspond à l’ID de la table principale de la tâche
CURRENT_TASK_TYPE
Retourne le type de tâche de la tâche qui a lancé le processus. Les valeurs possibles sont
- B Saisie simple
- F Saisie double
- R Saisie de dossier
- V Vue
- L Liste / Impression
- M Liste longue
- T Traitement
- U Traitement long
- W Vue longue
- X Super Tâche
CURRENT_USER_CATEGORY
Cette variable contient la liste des categories de user séparé par des virgules ( , ). Les valeurs possibles des catégories sont
- USER Correspond aux utilisateurs standards
- ADMIN Administrateurs du logiciel. Ils ont souvent accès à quasiment toutes les tâches et peuvent créer des utilisateurs
- SUPERADMIN Ont accès généralement à tout et peuvent supprimer des administrateurs
CURRENT_USER_FULLNAME
Contient le nom complet de l’utilisateur tel qu’il est défini dans la tâche de saisie des utilisateurs SYS02. Cet identifiant n’est pas forcément unique.
Pour avoir l’identifiant unique de l’utilisateur, utiliser CURRENT_USER_ID
CURRENT_USER_GROUP
Contient la liste des groupes de l’utilisateur séparé par des virgules ( , ).
CURRENT_USER_ID
Cette variable contient l’id unique de l’utilisateur tel qu’il est défini dans la tâche de saisie des utilisateurs SYS02. Cet identifiant unique set généralement de username lors
du login. Pour avoir le vrai nom de l’utilisateur, utiliser CURRENT_USER_FULLNAME
CURRENT_WEEK_END_ISO
Contient la date de la fin de la semaine au format ISO (2017-03-19 23:59:59)
CURRENT_WEEK_END
Contient la date de la fin de la semaine (19/03/2017)
CURRENT_WEEK
Contient le numéro de la semaine dans l’année
CURRENT_WEEK_START_ISO
Contient la date du début de la semaine au format ISO (2017-03-13 00:00:00)
CURRENT_WEEK_START
Contient la date du début de la semaine (13/03/2017)
CURRENT_YEAR_END
Contient la date complète de la fin de l’année (31/12/2016)
CURRENT_YEAR
Contient le numéro de l’année sur 4 chiffres (ex: 2016)
CURRENT_YEAR_START
Contient la date complète du début de l’année (01/01/2016)
<tileId>.<datafieldId> (Dashboards)
Lorsqu’on filtre une tuile par une tuile de filtre, la tuile a dans les variables
de notification des variables correspondant aux valeurs des colonnes selectionnées
dans les filtre sous la forme <tileId>.<datafieldId>. Par exemple :
DOSSIER_ASSURE.ADRDOS.ID_PK
DOSSIER_ASSURE.ADRDOS.DLABEL
Pour plus de détails sur l’utilisation, consulter la partie sur les variables dynamiques dans les dashboards
FS_USER_TMPDIR
Cette variable contient le chemin vers le dossier temporaire de l’utilisateur (ex: C:\SAINET\Users X\rbl\Temp)
GRID_LAST_SELECTED_COL (Vues)
Contient l’identifiant (nombre entier) de la dernière colonne qui a été selectionnée par l’utilisateur
GRID_LAST_SELECTED_ROW (Vues)
Contient l’identifiant (nombre entier) de la dernière ligne qui a été selectionnée par l’utilisateur
LAST_CHAIN_ID
Contient la dernière chaine utilisée. Dans le cas ou deux tâches de chaine différentes sont ouvertes, la chaine change. Il est possible de récupérer la précédente avec cette variable.
MAINGRID_COL_COUNT (Vues)
Contient le nombre de colonnes dans la grille
MAINGRID_ROW_COUNT (Vues)
Contient le nombre de lignes dans la grille
NAV_NB_SELECTED_ITEMS (Vues avec selections)
Dans le cas d’une vue avec selection, cette variable contient le nombre d’éléments selectionnés. Cette valeur ne prend pas en compte les ruptures.
NAV_SELECTED_KEY_VALUES (Vues avec selections)
Dans le cas d’une grille avec cases à cocher, cette variable contient la liste des valeurs des clés séparées par des virgules ( , ). Pour la version xml des clés,
voir NAV_SELECTED_XML_KEYS
NAV_SELECTED_XML_KEYS (Vues avec selections)
De même que pour NAV_SELECTED_KEY_VALUES, cette variable contient la liste des clés séparées par des virgules ( ,). La différence est
que cette liste contient les versions XML des clés.
NAV_SELECTION_AS_FILTER (Vues avec selections)
Dans le cas d’un navigateur de table, l’utilisateur peut selectionner X entrées dans la liste des entrées visibles et demander de les ouvrir. A ce moment la
la tâche est ouverte en filtrant sur les elements selectionnés. Cette variable contient le filtre tel qu’il est affichée en texte à l’utilisateur. Pour la
version SQL, voir NAV_SELECTION_AS_SQL
NAV_SELECTION_AS_SQL (Vues avec selections)
Dans le cas d’un navigateur de table, l’utilisateur peut selectionner X entrées dans la liste des entrées visibles et demander de les ouvrir. A ce moment la
la tâche est ouverte en filtrant sur les elements selectionnés. Cette variable contient le filtre en SQL. Pour la
version text user friendly, voir NAV_SELECTION_AS_FILTER
TASK_CGE_EXERCICE
Cette variable contient l’exercice comptable de la tâche courante active. Attention, cette variable peut être différente de l’exercice global
dans lequel l’utilisateur travaille. Pour avoir l’exercice global de l’application, utiliser CGE_EXERCICE
VIEW_FILTER_<datafieldId> (Vues)
Cette variable est disponible pour chaque datafield utilisé dans le filtre. Par exemple si le filtre de la vue contient les colonnes pointant vers CRMPRJ.ID_PK et CRMPRJ.STATUS il y aura deux variables disponibles :
- VIEW_FILTER_CRMPRJ.ID_PK
- VIEW_FILTER_CRMPRJ.STATUS
Ces deux variables contiendront la chaine de caractère attribuée dans le filtre