• Casa
• Content Library
• Documenti amministrativi
• Regole

Regole

Gli amministratori definiscono le regole in base agli attributi e agli eventi degli utenti. Queste regole specificano le condizioni in base alle quali devono essere intraprese determinate azioni. Ad esempio, una regola potrebbe specificare che qualsiasi utente con l'attributo di reparto impostato su "Vendite" debba essere aggiunto al gruppo "Team vendite".

Prerequisiti

• Attributi predefiniti del profilo che possono essere inclusi nel trigger della regola: e-mail, nome utente, nome, cognome, numero di telefono ed e-mail alternativa.
• Gli attributi del profilo personalizzato sono del tipo: casella di testo, menu a discesa, casella di controllo e selettore data.
• Il gruppo e il ruolo a cui si desidera assegnare gli utenti devono essere già stati creati o devono esistere in precedenza.
• Tutti gli attributi di profilo personalizzati che si desidera utilizzare per assegnare gli utenti a gruppi o ruoli devono essere creati o devono esistere in precedenza.
• Se vengono modificati i valori consentiti per gli attributi del profilo personalizzato (come Dropdown e Textbox), anche la regola che utilizza quell'attributo personalizzato nel suo trigger dovrà essere aggiornata manualmente, poiché non verrà aggiornata automaticamente.
• Il provisioning basato su regole funziona nei seguenti flussi di creazione o aggiornamento degli utenti: creazione o aggiornamento degli utenti tramite interfaccia utente, caricamento o aggiornamento in blocco degli utenti, creazione o aggiornamento degli utenti tramite endpoint API miniOrange e creazione di nuovi utenti dalla pagina di registrazione.

Come impostare/configurare la regola

• Aggiungi una regola:
• Vai al menu sul lato sinistro e vai a Automazioni >> Regole. Regole di automazione si aprirà la pagina.



• Per aggiungere una nuova regola clicca su Aggiungi regola pulsante. Apparirà una finestra di dialogo. Inserisci il nome della regola e fai clic su Salva.



• Mantieni un nome di regola rilevante, che ti aiuterà a capire cosa fa la regola quando viene eseguita; Esempio: una regola che assegna utenti a gruppi può avere nomi Regola di assegnazione di gruppo o qualcosa di simile.



• Dopo aver salvato la regola, la pagina verrà reindirizzata a Modifica regola pagina. Qui puoi aggiungere il Trigger delle regole and Regola Azioni per la regola appena creata.
• Fare clic su Aggiungi trigger pulsante per aggiungere un trigger.



• I trigger possono essere Crea utente or Aggiorna utente, il che implica che le rispettive azioni verranno eseguite quando il trigger della regola viene soddisfatto durante la creazione o l'aggiornamento dell'utente.



• Cliccando su Query di attivazione Input, verrà visualizzato un elenco degli attributi del profilo predefiniti e personalizzati (se ne sono stati creati).
• È possibile selezionare gli attributi richiesti e passare un valore per questi attributi. Se i valori degli attributi per l'utente o gli utenti corrispondono ai valori degli attributi della query di trigger, l'azione della regola verrà eseguita automaticamente.



• Qui, ad esempio, abbiamo preso Dipartimento = Ingegneria e ProgettoAssegnato = P01 come query di attivazione.
• Clicchi Salva dopo aver creato la query desiderata.

Nota:

• Se durante gli aggiornamenti degli utenti viene creata una regola per l'assegnazione di un gruppo e in seguito l'utente viene nuovamente aggiornato in un modo che viola la regola, l'assegnazione dell'utente non verrà automaticamente annullata.
• Operazioni And e Or:
• e: tutte le condizioni devono essere vere affinché la regola venga eseguita
• oro: una qualsiasi condizione deve essere vera affinché la regola venga eseguita
• Attualmente, con i trigger di regole complesse, puoi scegliere "AND" o "OR", ma non entrambi insieme. Non sono consentite combinazioni multiple.
• Esempi: Dipartimento = Ingegneria and ProgettoAssegnato = P01 and Tirocinante = sì (questo è permesso)
• Dipartimento = Ingegneria or ProgettoAssegnato = P01 or Tirocinante = sì (questo è permesso)
• Dipartimento = Ingegneria and ProgettoAssegnato = P01 or Tirocinante = no (questo non è consentito, può essere tutto "AND" o tutto "OR".)
• Con attributi di profilo predefiniti:
• Email, nome utente, nome e cognome : gli operatori uguale (=), diverso (!=), contiene (co), maggiore di (>) e minore di (<) funzioneranno
• Numeri di telefono : gli operatori uguale (=), diverso (!=), maggiore di (>) e minore di (<) funzioneranno
• Con attributi di profilo personalizzati:
• Casella di testo: gli operatori uguale (=), non uguale (!=), contiene (co), maggiore di (>) e minore di (<) funzioneranno
• Selettore data: gli operatori maggiore di (>) e minore di (<) funzioneranno
• Menu a discesa e casella di controllo: gli operatori uguale (=), non uguale (!=), contiene (co), maggiore di (>) e minore di (<) funzioneranno
• Gli operatori uguale e non uguale sono sensibili alle maiuscole e alle minuscole
• L'operatore contiene non distingue tra maiuscole e minuscole.
• Gli operatori maggiore e minore funzionano lessicograficamente




Esempi:

• Operatore di uguaglianza:
• Trigger regola: Crea utente; Email eq “test@email.com” | Azione regola: Assegnazione gruppo al gruppo G01
• L'utente creato con email = “test@email.com” verrà assegnato al gruppo G01
• Operatore diverso:
• Trigger regola: Crea utente; Email ne “test@email.com” | Azione regola: Assegnazione gruppo al gruppo G01
• L'utente creato con email = “demo@email.com” verrà assegnato al gruppo G01
• Contiene l'operatore:
• Trigger regola: Crea utente, e-mail co “dominio” e dipartimento co “ingegnere” | Azione regola: assegnazione gruppo al gruppo G01 e assegnazione ruolo al ruolo Ingegnere
• L'utente creato con email = “demo@domain.com” e dipartimento = “Engineering” verrà assegnato al gruppo G01 e al ruolo Engineer
• Operatore maggiore e minore:
• Trigger regola: Crea utente, DOJ gt “01-08-2024” e DOJ lt “01-09-2024” | Azione regola: Assegnazione gruppo al gruppo “AugustBatch”
• L'utente creato con DOJ uguale (ad esempio) "22-08-2024" verrà assegnato al gruppo "AugustBatch"


• Aggiunta di azioni:
• Fare clic su Aggiungi azione pulsante per aggiungere azioni.



• In Assegnazione di gruppo or Deassegnazione del gruppoè possibile aggiungere più gruppi nella stessa azione.
• In Assegnazione o rimozione del ruolo, dovrebbe essere menzionato un solo ruolo, poiché a un utente può essere assegnato un solo ruolo alla volta.
• In Trasformazione degli attributi utente, è possibile impostare un solo attributo per la trasformazione in un'azione alla volta.



• Qui, ad esempio, abbiamo creato 2 azioni di regola: una assegnerà l'utente o gli utenti al gruppo P01 e la seconda assegnerà l'utente o gli utenti al ruolo di ingegneria.



• Per creare una trasformazione degli attributi utente come questa, ad esempio Email attributo.

Nota:

Questa azione consente di costruire dinamicamente un attributo utente utilizzando attributi esistenti. Nell'esempio seguente, l'attributo Email viene generato combinando gli attributi dell'utente Nome and Cognome.

Usa il $ Simbolo per fare riferimento agli attributi nella query di trasformazione. Questi valori vengono risolti in fase di esecuzione durante il provisioning o l'autenticazione degli utenti.

Esempio:

Se il Nome è John e il cognome è daino, l'email risultante sarà John.Doe@gmail.com.








Nota:

• Le azioni delle regole vengono eseguite nell'ordine in cui sono definite, una dopo l'altra.
• Gli utenti verranno sempre assegnati al gruppo DEFAULT.





• Dopo aver configurato il trigger e l'azione della regola, la regola creata deve essere attivata, affinché venga attivata durante la creazione o l'aggiornamento dell'utente. Questo può essere fatto nei seguenti modi:
• Fare clic sul pulsante per attivare la regola.



• Vai su Automazioni >> Regole , fai clic sui tre punti accanto alla regola e seleziona "Attivare".



• Prova la regola:
• Se l'attivazione della regola è per la creazione di un utente, effettuare il test creando un utente e verificando se è assegnato ai gruppi e ai ruoli menzionati.
• Se l'attivazione della regola è per l'aggiornamento dell'utente, effettuare il test aggiornando un utente esistente e verificando se è assegnato e/o non assegnato ai gruppi e ai ruoli menzionati.
• Andate a Utenti >> Elenco utenti sezione dal menu di sinistra e clicca su Aggiungi utente pulsante.



• Se un utente viene creato con Dipartimento=Ingegneria e ProgettoAssegnato=P01, verrà assegnato al gruppo e ai ruoli menzionati.



• Vai su Utenti > Ruolo utente e verifica se l'utente è assegnato a Ingegneria ruolo come segue:



• Vai su Gruppi > Gestisci gruppi e controlla se l'utente è assegnato al gruppo denominato P01 come segue: