Lorsque vous souhaitez créer des comptes à partir d'un utilisateur, vous avez besoin de construire certaines valeurs à partir des informations de l'utilisateur.
Par exemple, pour créer une adresse mail, vous souhaitez qu'elle ait le format prenom.nom@votredomaine.fr.
Pour cela, il faut paramétrer le champ "email" de manière dynamique pour prendre le prenom de l'utilisateur et le concaténer avec le nom de famille puis le domaine.
La syntaxe à utiliser par exemple est :
{{Utilisateur.Prenom}}.{{Utilisateur.Nom}}@{{Instance.DomaineMessagerie}}
Afin de modifier les chaînes de caractères, nous mettons à disposition des fonctions que vous pouvez utiliser en les faisant précéder de "|" .
|Lower
Description
La commande |Lower met le texte en minuscule.
Utilisation
Appliquez la commande dans une fonction, à la suite de la valeur à modifier.
Cas d'utilisation - Exemple
Vous souhaitez utiliser les attributs Nom et Prénom de l'utilisateur pour l'attribution d'une adresse mail :
| {{Utilisateur.Nom|lower}}.{{Utilisateur.Prenom|lower}}@youzer.net |
|Upper
Description
La commande |Upper met le texte en majuscule.
Utilisation
Appliquez la commande dans une fonction, à la suite de la valeur à modifier.
Cas d'utilisation - Exemple
Vous souhaitez afficher le nom en majuscule de vos utilisateurs sur leurs comptes M365 :
Dans le paramétrage de l'unité M365 du package utilisé, sur le champ Nom, utilisez la commande :
{{Utilisateur.Nom|upper}}|Capitalize
Description
La commande |Capitalize met le texte en minuscule et la première lettre en majuscule.
Utilisation
Appliquez la commande dans une fonction, à la suite de la valeur à modifier.
Cas d'utilisation - Exemple
Vous souhaitez normaliser la structure des prénoms avec la première lettre en majuscule et le reste en minuscule.
Utilisez la commande :
{{Utilisateur.Prenom|capitalize}}|Left(n)
Description
La commande |Left(n) permet d'afficher les n premiers caractères de la valeurs.
Utilisation
Appliquez la commande dans une fonction, à la suite de la valeur à conserver partiellement.
Pour la valeur François, si n=1, seulement F sera conservé. Si n=2 > Fr, n=3 > Fra, etc.
Cas d'utilisation - Exemple
Vous souhaitez ne retenir que la première lettre d'un prénom, utilisez la commande:
{{Utilisateur.Prenom|left(1)}}Vous souhaitez utiliser une structure de type première lettre du prénom . nom de famille pour les emails (p.nom@youzer.net).
Utilisez la commande :
{{Utilisateur.Prenom|left(1)|lower}}.{{Utilisateur.Nom|lower}}@youzer.net|Right(n)
Description
La commande |Right(n) affiche les n derniers caractères de la valeur. Il s'agit du comportement inverse de la commande |Left(n).
Utilisation
Appliquez la commande dans une fonction, à la suite de la valeur à modifier.
Cas d'utilisation - Exemple
Vous êtes un original incompris et souhaitez que les adresses mails de vos utilisateurs soient les deux dernières lettres de leur Nom@votre-organisation.com
Utilisez la commande :
{{Utilisateur.Nom|right(2)}}@votre-organisation.com|Extract(x,y)
Description
La commande |Extract(x,y) prend les y caractères à partir du caractères x.
x et y sont des valeurs numériques. x décrit la position du caractère dans la valeur, la première lettre de la valeur étant égale à 0.
y décrit le nombre de caractère (positionnés à la suite de x) à extraire de la valeur .
Utilisation
Appliquez la commande dans une fonction, à la suite de la valeur à modifier.
Cas d'utilisation - Exemple
Pour la valeur "Tartanpion", x=0=T, x=1=a, x=2=r, etc.
Pour extraire tanp, utilisez la commande :
{{Utilisateur.Nom|extract(3,4)}}|Clean
Description
La commande |Clean remplace les caractères accentués par leur équivalent non accentué. Elle retire aussi les espaces.
Utilisation
Appliquez la commande dans une fonction, à la suite de la valeur à modifier.
Cas d'utilisation - Exemple
L'image parle d'elle-même.
|Match(code_table,colonne1,colonne2,valeur_default)
Description
La commande |Match(code_table,colonne1,colonne2,valeur_default) renvoie une valeur d'un tableau en fonction d'une valeur se trouvant dans la première colonne.
Utilisation
Passage obligatoire par les tables de correspondance pour utiliser cette formule. Appliquez la commande dans une fonction, à la suite de la valeur de référence pour la table de correspondance crée en amont.
- Remplacez Code_table par le nom de la table de correspondance à laquelle vous souhaitez faire référence
- Remplacez Colonne1 par l'attribut de référence, soit l'attribut nommé dans la formule.
- Remplacez Colonne2 par l'attribut dont vous souhaitez afficher la valeur identifiée comme correspondante dans la table pour l'attribut de référence.
- valeur_default peut-être laissé tel quel.
Cas d'utilisation - Exemple
Je souhaite attribuer un service AD en fonction du Pôle de mes utilisateurs. Alfred Tartanpion fait partie du pôle 1.
J'utilise la fonction :
| {{Utilisateur.pôle|match(david,pole,servicead,valeur_default)}} |
|Match2(CodeTable, CodeColonneRecherche, CodeColonneRecherche2, ValeurRecherche2, CodeColonneResultat, default_value)
Description
Prend en compte 2 valeurs (val initiale, ex: Utilisateur.Société, ainsi qu'une seconde valeur ValeurRecherche2), et 2 colonnes de recherche (CodeColonneRecherche pour val initiale, et CodeColonneRecherche2 pour ValeurRecherche2) pour trouver un résultat (CodeColoneResultat).
Utilisation
Appliquez la commande dans une fonction, à la suite de la valeur de référence pour la table de correspondance crée en amont.
Cas d'utilisation - Exemple
|Split(x)
Description
La commande |Split(x) divise une chaîne de caractères par un ou plusieurs caractères (x). "x" doit être encadré de "guillemets" et n'apparaît pas dans les valeurs affichées.
Utilisation
Appliquez la commande dans une fonction, à la suite de l'attribut de référence.
Cas d'utilisation - Exemple
Pour retirer le point d'un nom d'utilisateur composé d'un Nom.Prénom, j'utilise la commande :
{{Utilisateur.Nom|split(".")}}J'obtiens Nom Prénom
|Split(x,y)
Description
La commande |Split(x,y) divise une chaîne de caractères par un ou plusieurs caractères spécifiques en prenant le bloc de rang y et affiche la valeur suivant x seulement. x représente le ou les charactère(s) qui divise(nt) la chaîne de caractères. y représente la position de ce ou ces caractères.
Utilisation
Préférez cette commande à |Split(x) si le caractère choisit pour x apparait plusieurs fois dans la valeur, y permettra d'identifier le bon. Appliquez la commande dans une fonction, à la suite de l'attribut de référence.
Cas d'utilisation - Exemple
Dans l'exemple ci-dessous, en choisissant que x = "-", et y = 2, je demande à retenir la valeur qui suit le second tiret de la valeur originale. 
|Reverse
Description
La commande |Reverse inverse le sens d'une chaîne de caractères
Utilisation
Appliquez la commande dans une fonction, à la suite de l'attribut de référence.
Cas d'utilisation - Exemple
{{Utilisateur.Prenom|reverse}}.getManager_Account(xxx,yyy)
Description
La commande |Utilisateur.getManager_Account(xxx,yyy) récupère la valeur de l'attribut yyy du compte du manager sur le connecteur xxx.
Utilisation
L'utilisateur doit avoir un manager renseigné dans ses informations sur Youzer et ce manager doit exister dans Youzer.
xxx n'est pas le nom du connecteur mais l'ID du connecteur, à la rédaction, les noms des connecteurs apparaissent :
Cas d'utilisation - Exemple
Fatima El Amrani a un manager Pavel Dvojavak, dont le matricule renseigné sur le connecteur M365 est 0105. Je souhaite récupérer le numéro de matricule du manager.
{{Utilisateur.getManager_Account(23364,employeeId)}}.Unitefromconnecteur(x)
Description
La commande .Unitefromconnecteur(x) récupère la valeur d'un attribut pour une unité présente sur un connecteur sans avoir à nommer l'unité. Le connecteur est identifié par son ID.
Utilisation
Appliquez la commande dans une fonction, à la suite de "Utilisateur".
Cas d'utilisation - Exemple
{{utilisateur.unitefromconnecteur(id du connecteur).Code attribut}}Fatima a une unité sur le connecteur M365 dont l'ID est 23364. Je souhaite connaitre la valeur pour l'attribut division :
{{Utilisateur.unitefromconnecteur(23364).division}}
datetimenow.ddMMyyyy
Description
Affiche la date actuelle au format spécifié (il est possible de personnaliser le format : yyyy/MM/dd par exemple)
Utilisation
Appliquez la commande seule ou chainée à d'autres commandes dans une fonction.
Cas d'utilisation - Exemple
{{datetimenow.ddMMyyyy}}Vous souhaitez alimenter un champs “date de création”.
.ddMMyyyy, .s, etc
Description
Permet de conditionner le format d'une date.
Utilisation
Appliquez la commande dans une fonction, à la suite de "Utilisateur.datedarrivée" ou tout autre champs contenant une date.
Utilisez dd pour les jours, MM pour les mois, yyyy pour les années, hh pour les heures, mm pour les minutes et ss pour les secondes.
Vous pouvez aussi utiliser le .s directement à la suite de la date dans la fonction pour avoir le format standard, ou .f pour le format Français en toutes lettres.
Cas d'utilisation - Exemple
{{utilisateur.datedarrivée.f}} > vendredi 19 mai 2017 02:00Afin d'afficher la date uniquement, vous pouvez chainer une fonction |left de sorte à ne pas afficher l'heure.
{{Utilisateur.DateArrivee.f|left(20)}} > vendredi 19 mai 2017
random(n)
Description
Renvoie n caractères aléatoires
Utilisation
Appliquez la commande seul ou chainée à une autre fonction
Cas d'utilisation - Exemple
{{Utilisateur.prénom|left(1)}}{{Utilisateur.nom|left(1)}}{{random(4}}Pour créer un matricule unique, vous pouvez suivre l'exemple ci-dessus en prenant les premières lettres du prénom, du nom et 4 caractères aléatoires.
randomstringnumber(n)
Description
Renvoie un nombre à n chiffres aléatoires.
Utilisation
Appliquez la commande seul ou chainée à une autre fonction
Cas d'utilisation - Exemple
{{Utilisateur.prénom|left(1)}}{{Utilisateur.nom|left(1)}}{{randomstringnumber(4}}Pour créer un matricule unique, vous pouvez suivre l'exemple ci-dessus en prenant les premières lettres du prénom, du nom et un nombre à 4 chiffres aléatoires.
|ifisnull(x,y)
Description
Renvoie x si la valeur est vide et y si la valeur n'est pas vide : ce n'est pas la valeur renseigné pour l'attribut utilisateur qui sera affiché mais la valeur donnée à “y” dans la formule {utilisateur.Email|ifisnull("x","y"}}
Si vous utilisez donc |ifisnull("Bonjour","Au revoir") , suite à un attribut utilisateur dont la valeur est vide, vous obtiendrez “Bonjour”.
Utilisation
Appliquez la commande dans une fonction, à la suite de "Utilisateur.AttributUtilisateur".
Cas d'utilisation - Exemple
{{Utilisateur.direction|ifisnull("information absente", "Information présente")}}
Ici, Dimitri ne dispose pas d'information sur sa fiche utilisateur pour l'attribut utilisateur Direction. C'est donc x qui m'est renvoyé : Information absente.
|ifisnull(x)
Description
Renvoie x si la valeur initiale est vide. x peut-être une valeur, alors il faudra l'encadrer de “. x peut aussi être un attribut utilisateur type Utilisateur.fonction, il ne faudra alors pas mettre de ”.
Utilisation
Appliquez la commande dans une fonction, à la suite de "Utilisateur.AttributUtilisateur".
Cas d'utilisation - Exemple
{{Utilisateur.direction|ifisnull(Utilisateur.fonction)}}
La direction de Dimitri n'étant pas renseignée, nous affichons sa fonction, récupéré sur l'attribut utilisateur fonction.
|replace(x,y)
Description
Remplace un ou plusieurs caractère(s) x par y. Peut-être utilisé pour retirer tous les x caractères en les remplaçant par y=vide.
Utilisation
Appliquez la commande dans une fonction, à la suite de "Utilisateur.AttributUtilisateur".
Cas d'utilisation - Exemple
{{utilisateur.Email|replace(".","-")}}Dans cette méthode, je remplace un “.” par un “-”.
{{Utilisateur.telephonemobile|replace(".07","+337")|replace(".06","+336")}}Dans cette méthode, je récupère des numéros de téléphone au format : .0650000000 et je souhaites obtenir le format +33650000000.
Je peux donc identifier “.07” et “.06” comme des caractères à toujours remplacer respectivement par “+337” et “+336”.
Attention, si le format original des numéros était 0650000000, donc sans le ".", il serait dangereux d'utiliser cette méthode car le caractère “06” pourrait être présent dans le numéro par exemple 0650060000 qui donnerait alors : +3360+3360000
|PadLeft(x,y)
Description
Complète le début d'une chaîne de caractères avec une répétition d'un caractère.
Utilisation
Appliquez la commande dans une fonction, à la suite de "Utilisateur.AttributUtilisateur".
Cas d'utilisation - Exemple
{{utilisateur.Matricule|PadLeft(8,"x")}}
Valeur initiale: 11
Valeur avec le PadLeft: xxxxxx11
Le résultat sera donc sur 8 caractères en ajoutant autant de 'x' à gauche nécessaires pour arriver à cet output de 8.
|PadRight(x,y)
Description
Complète la fin d'une chaîne de caractères avec une répétition d'un caractère
Utilisation
Appliquez la commande dans une fonction, à la suite de "Utilisateur.AttributUtilisateur".
Cas d'utilisation - Exemple
{{utilisateur.Matricule|PadRight("x",8)}}
Valeur initiale: 22
Valeur avec le PadLeft: 22xxxxxx
Le résultat sera donc sur 8 caractères en ajoutant autant de 'x' à droite nécessaires pour arriver à cet output de 8.
|initiales_xy
Description
Convertit un prénom ou nom composé (séparé par un tiret '-' ou par des espaces) en initiales. Si il y a un mix de tiret et espaces, c'est le premier caractère après chaque tiret qui est renvoyé.
Utilisation
Appliquez la commande dans une fonction, à la suite de "Utilisateur.AttributUtilisateur".
Cas d'utilisation - Exemple
{{Utilisateur.Prenom|initiales_xy}}Dimitri Franck Albert Marc voit ici son prénom remplacé par les initiales DFAM.
