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 "|" .
Tableau des valeurs
| fonction | description | |
|---|---|---|
| lower | met le texte en minuscule | |
| upper | met le texte en majuscule | |
| capitalize | met le texte en minuscule et la première lettre en majuscule | |
| left(n) | prend les n premiers caractères | |
| right(n) | prend les n derniers caractères | |
| extract(x,y) | prend les y caractères à partir du caractères x | |
| clean | remplace les caractères accentués par leur équivalent non accentué | |
| 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 | |
| match2(CodeTable, CodeColonneRecherche, CodeColonneRecherche2, ValeurRecherche2, CodeColonneResultat, default_value)" | 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). | |
| split(x) | divise une chaîne de caractères par un ou plusieurs caractères spécifiques | |
| 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 | |
| reverse | inverse le sens d'une chaîne de caractères | |
|
getManager_ADAccount_DN obsolète |
récupère le distinguishedName du compte Active Directory du manager | |
| Utilisateur.getManager_Account(xxx,yyy) | récupère la valeur de l'attribut yyy du compte du manager sur le connecteur xxx | {{Utilisateur.getManager_Account(000000,DistinguishedName)}} |
| unitefromconnecteur(x) | récupère l'unité du connecteur x | {{utilisateur.unitefromconnecteur(id du connecteur).Code attribut}} |
| datetimenow.ddMMyyyy | affiche la date actuelle au format spécifié (il est possible de personnaliser le format : yyyy/MM/dd par exemple) | |
| utilisateur.datearrive.dd MM yyyy | permet d'afficher la date au format souhaité | |
| random(n) | renvoie n caractères aléatoires | |
| randomstringnumber(n) | renvoie un nombre à n chiffres aléatoires | |
| ifisnull(x,y) | renvoie x si la valeur est vide et y si la valeur n'est pas vide | {{utilisateur.Email|ifisnull("non renseigné","renseigné"}} |
| ifisnull(x) | renvoie x si la valeur initiale est vide | {{Utilisateur.mailpro|ifisnull(Utilisateur.mailperso)}} |
| replace(x,y) | remplace un caractère par un autre | {{utilisateur.Email|replace(".","-")}} |
| PadLeft(x,y) | complète le début d'une chaîne de caractère avec une répétition d'un caractère | {{utilisateur.Mattricule|PadLeft(8,"X")}} |
| PadRight(x,y) | complète la fin d'une chaîne de caractère avec une répétition d'un caractère | {{utilisateur.Mattricule|PadRight(8,"X")}} |
| initiales_xy | convertit un prénom ou nom composé (séparé par un tiret '-') en initiales. S'il n'y a pas de tiret, c'est le premier caractère qui est renvoyé | {{utilisateur.Prenom|initiales_xy}} |
| Ces fonctions peuvent être chaînées : | ||
| {{Utilisateur.Prenom | left(3) | lower |
|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}}