Les règles d’écran sont personnalisables sur ACADEM, pour étendre ou restreindre les actions des utilisateurs :
- chaque champ peut être visible, en lecture seule, rendu obligatoire ou masqué.
- chaque onglet et chaque bouton peut être accessible ou masqué
La configuration des écrans et des champs au sein de l’application, peut se faire pour un rôle donné ou pour l’ensemble des rôles. Il est également possible de configurer les écrans en fonction des valeurs renseignées sélectionnées dans certains champs.
Les règles d’écrans sont accessibles depuis le menu Autre > Administration > Règles d’écran
ℹ️ Pour modifier les règles d’écran, il est conseillé d’ouvrir ACADEM dans deux onglets, pour jongler plus facilement entre les écrans et copier/coller les informations utiles d’un écran à l’autre.
Il existe deux types de règles d’écran :
▫️Les règles standard : sont prédéfinies par défaut et ne peuvent être ni supprimées ni remplacées.
▫️Les règles personnalisées : sont ajoutées par l’utilisateur pour modifier ou préciser les règles standards. Elles peuvent être supprimées ou modifiées directement.
Les règles standard sont donc une base, qui peut être modifiée ensuite grâce aux règles personnalisées.
⚠️Seuls les utilisateurs qui ont un rôle de T1_admin + T1_admin Source System ACADEM peuvent accéder aux modifications de l’interface d’utilisation.
Consulter cet article pour plus d’informations sur les rôles des utilisateurs ➡️ Rôles et extensions
ℹ️ Il est conseillé d’ajouter des commentaires dans les règles personnalisées, pour historiser les modifications.
Pour ajouter un commentaire sans impacter les règles d’écran, utiliser // au début de la ligne de code.
Accéder aux règles d’écran
Pour modifier l’affichage d’un champ, onglet ou bouton à l’écran : positionner la souris sur l’élément à modifier et cliquer droit > un encadré s’affiche sous le champ : Editer les libellés et aides des champs > cliquer sur l’encadré pour accéder à la fenêtre d’édition.
Dans la fenêtre d’édition deux informations sont utiles pour consulter/modifier la règle d’écran associée à ce champ :
- Le nom de l’écran
- L’identifiant du champ
Dans un deuxième onglet : Chercher le nom de l’écran indiqué dans l’Editeur de libellés et texte d’aide, depuis les Règles d’écran dans ACADEM.
Menu Autre > Administration > Règles d’écran :
Cliquer sur Editer pour consulter/modifier les règles de cet écran.
- Utiliser l’onglet Règles standard pour consulter la/les règle(s) existante(s) concernant le champ à personnaliser.
- Utiliser l’onglet Règles personnalisées pour rédiger la ou les nouvelles règles à appliquer.
Rédiger une règle personnalisée pour tous les utilisateurs
ℹ️Les règles d’écran sont rédigées sous forme de lignes de code.
Elles sont construites ainsi :
screen.ID_champ.access=Access.Instruction de base
Par exemple, la règle : screen.typecontrib.access=Access.MANDATORY
Signifie : le type de contribution doit obligatoirement être renseigné.
⚠️Les éléments “screen.”, “.access=” et “Access.” renseignés en gras ci-dessus, ne doivent pas être modifiés dans le code. Il doivent encadrer les variables qui identifient l’écran ou l’instruction ajoutés dans la règle.
⚠️ Le mot Access qui précède l’instruction doit être rédigé avec un A en capitale, pour être compris par le système.
Les instructions de base pour les champs sont :
▫️Pour cacher un champ : Access.HIDDEN
▫️Pour voir le champ en lecture seule : Access.READ
▫️Pour rendre le champ obligatoire : Access.MANDATORY
▫️Pour pouvoir remplir/modifier le champ, sans obligation : Access.WRITE
Les instructions de base pour les onglets et boutons sont :
▫️Pour rendre visible un onglet ou un bouton : Access.SHOW
▫️Pour masquer un onglet ou un bouton : Access.HIDDEN
ℹ️ Ces instructions concernent également l’affichage des encadrés Adresse et Contact dans les profils des enseignants > Informations personnelles
Mise en pratique
Pour masquer le champ “Prénom d’usage” sur le profil des enseignants :
- le nom de l’écran est curriculumvitae.generalinformations
- L’identifiant du champ est : fac_usualfirstname
La règle d’écran à rédiger sera donc :
screen.fac_usualfirstname .access=Access.HIDDEN
En validant cette règle d’écran, le champ prénom d’usage n’apparaît plus dans le profil des enseignants, sur l’écran de tous les utilisateurs.
Rédiger une règle conditionnée
Règles conditionnées aux rôles des utilisateurs
La rédaction d’une règle personnalisée, peut ouvrir ou restreindre l’accès aux champs, onglets/boutons, en fonction du rôle de l’utilisateur.
1/ ⚠️Avant de rédiger une règle conditionnée pour un ou plusieurs rôles, un rappel des règles de définition des rôles doit être copié/collé dans les règles personnalisées.
Ces règles de définition des rôles sont présentées en introduction des règles standard, avec un préfixe def
Copier/coller l’ensemble des règles de définition, qui commencent par le préfixe “def” avant de rédiger les instructions qui s’appliquent à des rôles spécifiques.
De cette manière, le système sait définir les utilisateurs concernés ou non par ces nouvelles règles personnalisées.
2/ Suite à l’ajout des définitions “def”, rédiger une condition pour modifier l’affichage d’un champ (onglet ou bouton) :
Soit avec la formule “if(isROLE) et des {}
ex : if(isFAC)
{
screen.ID_champ.access= Access.HIDDEN
}
La règle signifie : si l’utilisateur a un rôle FAC, on applique toutes les instructions renseignées entre {} = ici, le champ est masqué.
Soit sur une ligne, avec la formule isROLE?Access.instruction: Access.instruction
ex:
screen.ID_champ.access = isDA ?Access.WRITE : Access.HIDDEN
La règle signifie : si l’utilisateur a un rôle de DA le champ est visible et modifiable. Pour tous les autres rôles, le champ est masqué.
La condition sur une ligne peut se traduire ainsi : Est-ce que l’utilisateur a le rôle de DA ? Si oui (vrai) le champ est visible et peut être modifié: si non (faux) le champ est caché
Règles conditionnées à la valeur d’un champ
Il est également possible de conditionner l’accès aux champs, onglets et boutons, aux valeurs sélectionnées dans certains champs de l’écran.
ℹ️Par exemple, sur l’écran d’édition d’une contribution intellectuelle : lorsque le type de contribution est un Article = un onglet Support apparaît, pour renseigner le support dans lequel l’article a été publié.
Pour cela, il faut définir une nouvelle variable qui va récupérer la valeur actuelle d’un champ à l’écran, sous cette forme :
def maValeur = screen.monChamp.value
Si le champ est une table référentielle, on récupère le code de la valeur :
def maValeur = screen.monChamp.value.code
Sous la variable, la règle d’écran peut s’écrire ainsi :
def typecontrib=screen.typecontrib.value.code
switch(typeContrib) { case ’01’: // Article screen.contrib_tab_support.access = Access.SHOW}
Cette règle signifie que si le type de contribution intellectuelle est “Article” l’onglet Support apparait dans la fenêtre d’édition.
Notre équipe est disponible pour vous aider à rédiger la/les règles dont vous avez besoin pour personnaliser vos écrans.
Contactez-nous depuis votre espace Redmine pour nous faire part de vos besoins en la matière ➡️ Utiliser l’outil Redmine