• Accueil
• Bibliothèque de contenu
• Documents d'administration
• Règles

Règles

Les administrateurs définissent des règles basées sur les attributs et les événements des utilisateurs. Ces règles spécifient les conditions dans lesquelles certaines actions doivent être effectuées. Par exemple, une règle peut spécifier que tout utilisateur dont l'attribut de service est défini sur « Ventes » doit être ajouté au groupe « Équipe de vente ».

Pré-requis :

• Attributs de profil par défaut qui peuvent être inclus dans le déclencheur de règle : e-mail, nom d'utilisateur, prénom, nom, numéro de téléphone et e-mail alternatif.
• Les attributs de profil personnalisés sont du type : zone de texte, liste déroulante, case à cocher et sélecteur de date.
• Le groupe et le rôle auxquels vous souhaitez attribuer des utilisateurs doivent être créés ou doivent exister au préalable.
• Tous les attributs de profil personnalisés que vous souhaitez utiliser pour affecter des utilisateurs à des groupes ou à des rôles doivent être créés ou doivent exister au préalable.
• Si les valeurs autorisées pour les attributs de profil personnalisés (comme Dropdown et Textbox) sont modifiées, la règle qui utilise cet attribut personnalisé dans son déclencheur devra également être mise à jour manuellement, car elle ne sera pas mise à jour automatiquement.
• Le provisionnement basé sur des règles fonctionne dans les flux de création ou de mise à jour d'utilisateur suivants : création ou mise à jour d'utilisateur de l'interface utilisateur, téléchargement ou mise à jour d'utilisateur en masse, création ou mise à jour d'utilisateur via les points de terminaison de l'API miniOrange et création d'un nouvel utilisateur à partir de la page d'inscription.

Comment configurer une règle

• Ajouter une règle :
• Rendez-vous dans le menu sur le côté gauche et accédez à Automatisations >> RèglesL’ Règles d'automatisation la page s'ouvrira.



• Pour ajouter une nouvelle règle, cliquez sur le Ajouter une règle bouton. Une boîte de dialogue apparaît. Entrez le nom de la règle et cliquez sur Enregistrer.



• Gardez un nom de règle pertinent, qui vous aidera à comprendre ce que fait la règle lorsqu'elle s'exécute ; Exemple : une règle qui attribue des utilisateurs à des groupes peut être nommée Règle d'affectation de groupe ou quelque chose de similaire à ça.



• Après avoir enregistré la règle, la page sera redirigée vers le Modifier la règle page. Ici vous pouvez ajouter le Déclencheurs de règles et Actions de règle pour la règle nouvellement créée.
• Cliquez sur Ajouter un déclencheur bouton pour ajouter un déclencheur.



• Les déclencheurs peuvent être Créer un utilisateur or Mettre à jour l'utilisateur, ce qui implique que les actions respectives seront effectuées lorsque le déclencheur de la règle sera satisfait lors de la création ou de la mise à jour d'un utilisateur.



• En cliquant sur Déclencher une requête Entrée, une liste d'attributs de profil par défaut et personnalisés (le cas échéant) sera affichée.
• Les attributs requis peuvent être sélectionnés et une valeur peut être transmise pour ces attributs. Si les valeurs d'attribut de l'utilisateur ou des utilisateurs correspondent aux valeurs d'attribut de la requête de déclenchement, l'action de la règle s'exécutera automatiquement.



• Ici, par exemple, nous avons pris Département = Ingénierie et Projet Affecté = P01 comme requête de déclenchement.
• Cliquez à nouveau Enregistrer après avoir créé la requête souhaitée.

À noter :

• Si une règle est créée pour l'affectation de groupe lors des mises à jour d'un utilisateur et que l'utilisateur est ultérieurement mis à jour d'une manière qui viole la règle, l'utilisateur ne sera pas automatiquement désaffecté.
• Opérations Et et Ou :
• Et : toutes les conditions doivent être remplies pour que la règle soit exécutée
• Ou : une condition quelconque doit être vraie pour que la règle soit exécutée
• Actuellement, avec les déclencheurs de règles complexes, vous pouvez choisir « ET » ou « OU », mais pas les deux ensemble. Les combinaisons multiples ne sont pas autorisées.
• Exemples : Département = Ingénierie et ProjetAssigned = P01 et Stagiaire = oui (c'est autorisé)
• Département = Ingénierie or ProjetAssigned = P01 or Stagiaire = oui (c'est autorisé)
• Département = Ingénierie et ProjetAssigned = P01 or Stagiaire = non (ce n'est pas autorisé, cela peut être soit entièrement "ET" soit entièrement "OU".)
• Avec les attributs de profil par défaut :
• Email, nom d'utilisateur, prénom et nom : les opérateurs égal (=), différent de (!=), contient (co), supérieur à (>) et inférieur à (<) fonctionneront
• Les numéros de téléphone : les opérateurs égal (=), différent de (!=), supérieur à (>) et inférieur à (<) fonctionneront
• Avec des attributs de profil personnalisés :
• Zone de texte : Les opérateurs égal (=), différent de (!=), contient (co), supérieur à (>) et inférieur à (<) fonctionneront
• Sélecteur de date : les opérateurs supérieur à (>) et inférieur à (<) fonctionneront
• Menu déroulant et case à cocher : Les opérateurs égal (=), différent de (!=), contient (co), supérieur à (>) et inférieur à (<) fonctionneront
• Les opérateurs égal et différent d'égal sont sensibles à la casse
• L'opérateur Contient n'est pas sensible à la casse.
• Les opérateurs supérieur et inférieur à fonctionnent de manière lexicographique




Exemples:

• Opérateur égal :
• Déclencheur de règle : Créer un utilisateur ; e-mail équivalent à « test@email.com » | Action de règle : Affectation de groupe au groupe G01
• L'utilisateur créé avec l'email = « test@email.com » sera affecté au groupe G01
• Opérateur non égal :
• Déclencheur de règle : Créer un utilisateur ; E-mail : « test@email.com » | Action de règle : Affectation de groupe au groupe G01
• L'utilisateur créé avec l'email = « demo@email.com » sera affecté au groupe G01
• Contient l'opérateur :
• Déclencheur de règle : Créer un utilisateur, une adresse e-mail avec « domaine » et un service avec « ingénieur » | Action de règle : Affectation de groupe au groupe G01 et attribution de rôle au rôle Ingénieur
• L'utilisateur créé avec l'email = « demo@domain.com » et le service = « Engineering » sera affecté au groupe G01 et au rôle Engineer
• Opérateur supérieur et inférieur à :
• Déclencheur de règle : Créer un utilisateur, DOJ gt « 01-08-2024 » et DOJ lt « 01-09-2024 » | Action de règle : Affectation de groupe au groupe « AugustBatch »
• L'utilisateur créé avec DOJ égal à (disons) « 22-08-2024 » sera affecté au groupe « AugustBatch »


• Ajout d'actions :
• Cliquez sur Ajouter une action bouton pour ajouter une ou plusieurs actions.



• In Affectation de groupe or Désaffectation de groupe, plusieurs groupes peuvent être ajoutés dans la même action.
• In Affectation ou désaffectation de rôle, un seul rôle doit être mentionné, car un utilisateur ne peut être affecté qu'à un seul rôle à la fois.
• In Transformation des attributs utilisateur, un seul attribut peut être défini pour transformation dans une action à la fois.



• Ici, par exemple, nous avons créé 2 actions de règle, l'une affectera le(s) utilisateur(s) au groupe P01 et la seconde affectera le(s) utilisateur(s) au rôle d'ingénierie.



• Pour créer une transformation d'attribut utilisateur comme celle-ci par exemple Email attribuer.

À noter :

Cette action vous permet de construire dynamiquement un attribut utilisateur à partir d'attributs existants. Dans l'exemple ci-dessous, l'attribut Email est généré en combinant les attributs de l'utilisateur. Prénom et Nom de famille.

Utilisez le bouton $ Ce symbole permet de référencer des attributs dans la requête de transformation. Ces valeurs sont résolues lors de l'exécution, au moment de la création ou de l'authentification de l'utilisateur.

Exemple :

Si le prénom est John et le nom de famille est Biche, l'e-mail résultant sera John.Doe@gmail.com.








À noter :

• Les actions de règle sont exécutées dans l’ordre dans lequel elles sont définies, l’une après l’autre.
• Les utilisateurs seront toujours affectés au groupe PAR DÉFAUT.





• Une fois le déclencheur et l'action de la règle configurés, la règle créée doit être activée pour qu'elle soit déclenchée lors de la création ou de la mise à jour d'un utilisateur. Cela peut être fait de la manière suivante :
• Cliquez sur le bouton bascule pour activer la règle.



• Allez dans Automatisations >> Règles , cliquez sur les trois points à côté de la règle et sélectionnez «Activer".



• Testez la règle :
• Si le déclencheur de règle est destiné à créer un utilisateur, testez en créant un utilisateur et en vérifiant s'il est affecté aux groupes et rôles mentionnés.
• Si le déclencheur de règle concerne la mise à jour de l'utilisateur, testez en mettant à jour un utilisateur existant et en vérifiant s'il est affecté et/ou non affecté aux groupes et rôles mentionnés.
• Rendez-vous sur le Utilisateurs >> Liste des utilisateurs dans le menu de gauche et cliquez sur Ajouter un utilisateur .



• Si un utilisateur est créé avec Département=Ingénierie et ProjetAssigned=P01, il sera affecté au groupe et aux rôles mentionnés.



• Allez dans Utilisateurs > Rôle de l'utilisateur et vérifiez si l'utilisateur est affecté à Ingenierie rôle comme suit :



• Allez dans Groupes > Gérer les groupes et vérifiez si l'utilisateur est affecté au groupe nommé P01 comme suit: