JB3 - I livelli
- JB3.1 - Lettore, base, avanzato, staff
- JB3.2 - Cosa può fare ogni livello
- JB3.3 - Assegnare un ruolo
- JB3.4 - Il ruolo di prova
JB3.1 - Lettore, base, avanzato, staff
In una frase. I livelli sono quattro, hanno lo stesso nome e lo stesso significato in ogni servizio, e ognuno comprende quelli prima.
Con quattro livelli uguali ovunque non devi imparare un sistema di permessi per ogni programma. Se sai che una persona è «Utente base», sai già cosa può fare nelle stampe, nelle analisi e nell'ERP.
| Livello | In breve |
|---|---|
| Lettore | Consulta e stampa. Non modifica |
| Utente base | Lavora e personalizza, per sé e per l'azienda |
| Utente avanzato | Disegna, pubblica e gestisce i ruoli del servizio |
| Staff | Personale Genesys: tutto, compresi i ruoli di sistema |
Come ricevi un livello. Non ti viene assegnato a mano, uno per uno. Tu hai già dei ruoli nel gestionale, per esempio «amministrazione» o «magazzino». Arrivano insieme al tuo accesso. Ogni servizio guarda nella sua tabella che livello dà ciascun ruolo. Se ne hai più di uno, vale il livello più alto.
Dal ruolo al livello: i ruoli del gestionale arrivano con l'accesso, la pagina Ruoli e permessi dice che livello danno, il livello decide cosa puoi fare
I quattro livelli esistono anche come ruoli già pronti, uguali in ogni servizio. Chi amministra può darli direttamente a una persona, senza passare da un ruolo del gestionale.
L'elenco dei ruoli di un servizio: i quattro livelli già pronti, ognuno con la sua descrizione. Ambiente di prova
Lo Staff conta solo dove è acceso. Negli ambienti Genesys la gestione staff è accesa e Staff è il livello più alto. Dal cliente è spenta: lì chi ha Staff vale come Utente avanzato, e la pagina lo dice con la nota «Staff vale come Utente avanzato».
Il primo amministratore. Chi ha nel gestionale il ruolo di amministratore entra sempre come Utente avanzato, anche con le tabelle vuote. È lui che configura gli altri.
Nota. I livelli sono provati con l'Accesso spento e il «Ruolo di prova». Con l'Accesso vero acceso sono ancora da provare dal vivo.
Per chi sviluppa.
• Nomi tecnici: UTENTE_LETTORE, UTENTE_BASE, UTENTE_AVANZATO, STAFF.
• Lo Staff si accende con RUOLI_STAFF_ABILITATO=true (di serie è false).
• Il ruolo amministratore è in RUOLO_AMMINISTRATORE; se manca vale SBH_ADMIN_ROLE, poi SYSADMN.
• Regole in RegoleRuoli e Livello, file gemelli in backend/middleware/it_gsba_gpe_next e backend/middleware/it_gsba_ade_next.
Per approfondire.
• Ruoli e permessi: docs/guide/amministrazione/ruoli-e-permessi/README.md
JB3.2 - Cosa può fare ogni livello
In una frase. Ogni servizio dichiara cosa concede a ciascun livello, e te lo mostra in chiaro nella pagina Ruoli e permessi.
Non devi indovinare né chiedere a chi ha scritto il programma. Apri la scheda del servizio e leggi: una riga per ogni cosa che si può fare, una spunta sotto i livelli che la possono fare.
I quattro livelli in fila: ognuno aggiunge qualcosa al precedente. Sotto, un esempio con le stampe e con le analisi
Oggi i servizi concedono questo:
| Livello | Stampe (GPEnext) | Analisi e disegno (ADEnext) |
|---|---|---|
| Lettore | Stampa, anteprima, grafici | Apre i cruscotti |
| Utente base | In più: ritocca documenti, profili, aziende | In più: personalizza i cruscotti e salva le sue copie |
| Utente avanzato | In più: designer completo, gestione dei ruoli | In più: pubblica per tutti, usa lo Studio, gestisce i ruoli |
| Staff | In più: catalogo dei modelli, ruoli di sistema | In più: ruoli di sistema, concede lo Staff |
Così lo mostra la pagina, nella scheda delle stampe:
La scheda delle stampe in Ruoli e permessi: una riga per capacità, una spunta per ogni livello che la possiede. Ambiente di prova
In SIGEAnext oggi i livelli proteggono due cose: la configurazione dei moduli e la scelta dei ruoli, tutte e due da Utente avanzato. Le altre funzioni dell'ERP chiedono solo di essere entrati. Il Lettore in sola lettura modulo per modulo è ancora da fare.
Se non hai il livello che serve, il pulsante è spento e il suggerimento dice perché. Se la richiesta parte lo stesso, il servizio la rifiuta e spiega il motivo.
Nota. «Pubblica per tutti» nelle analisi chiede anche un'opzione accesa sull'installazione. Vedi il libro JF - Analytics, capitolo «JF5 - Salvare e condividere».
Per chi sviluppa.
• Ogni servizio elenca le sue capacità in CapacitaServizio: codice, descrizione, livello minimo.
• Le autorizzazioni passano dalle capacità, mai da nomi di ruolo scritti nel codice.
• Le API dello Studio che chiedono la capacità studio: docs/low-code/permessi-api.md.
• La pagina legge GET /ruoli/livelli e GET /me/permessi di ogni servizio.
Per approfondire.
• Ruoli e permessi: docs/guide/amministrazione/ruoli-e-permessi/README.md
JB3.3 - Assegnare un ruolo
In una frase. Per dare un livello a un gruppo di persone, agganci un loro ruolo del gestionale a uno dei quattro livelli.
Non si lavora utente per utente. Dici una volta sola «chi ha il ruolo amministrazione è Utente base nelle stampe», e vale per tutti quelli che hanno quel ruolo, anche per chi arriverà dopo.
Apri Ruoli e permessi. Dal modulo EE0 Gestione Servizi, Impostazioni, Utenti e accessi, Ruoli e permessi. Oppure dal menu utente, in alto a destra.
Scegli la scheda del servizio. Una scheda per servizio. I ruoli della scheda di ADEnext valgono anche per SIGEAnext, con lo stesso livello.
Premi Nuovo ruolo. Con Scegli fra i ruoli di Keycloak cerchi fra i ruoli che esistono davvero, compresi quelli arrivati dal gestionale: il nome si scrive da solo, senza errori di battitura. Puoi anche scriverlo a mano.
Scegli il livello e premi Salva.
Il riquadro Nuovo ruolo: il nome del ruolo e il livello da dare. Schermata di una versione precedente: oggi c'è anche il pulsante per scegliere il ruolo da un elenco
Controlla. La riga compare nell'elenco. Chi ha quel ruolo ha il livello nuovo dalla richiesta successiva: non serve uscire e rientrare.
Per cambiare un aggancio premi la matita sulla riga. Il cestino lo toglie, dopo una conferma.
Chi può farlo. Serve il livello Utente avanzato nel servizio. Solo lo Staff può concedere il livello Staff e toccare i quattro ruoli già pronti. Utente base e Lettore vedono l'elenco senza poterlo cambiare.
Nota. Lo stesso ruolo può dare livelli diversi in servizi diversi: per esempio Utente avanzato nelle analisi e Lettore nelle stampe.
Attenzione. Se l'elenco dei ruoli non si apre, al posto del pulsante compare un avviso con il motivo e Riprova. Intanto puoi scegliere fra i ruoli del gestionale o scrivere il nome a mano.
Per chi sviluppa.
• Pagina: frontend/shell/src/pages/ruoli, indirizzo /pages/ruoli.
• Ogni servizio tiene i suoi agganci in una tabella ruoli; SIGEAnext legge quelli di ADEnext.
• Nome del ruolo: lettere, cifre, _, ., -, al massimo 64 caratteri. Maiuscole e minuscole non contano.
Per approfondire.
• Ruoli e permessi: docs/guide/amministrazione/ruoli-e-permessi/README.md
JB3.4 - Il ruolo di prova
In una frase. Negli ambienti di prova, dove l'Accesso è spento, un selettore ti fa vedere l'applicazione come la vedrebbe chi ha un certo ruolo.
Serve a chi configura i permessi e a chi sviluppa. Prima di dare un ruolo a venti persone, controlli in un minuto cosa vedranno: quali pulsanti sono accesi, quali pagine si aprono, cosa viene rifiutato. Senza creare utenti finti.
Guarda la barra in alto. Con l'Accesso spento c'è il selettore Ruolo di prova. Parte da Tutti i permessi (sviluppo): puoi fare tutto.
Scegli un ruolo. L'elenco contiene i ruoli di tutti i servizi. Accanto a ognuno c'è scritto quali servizi lo conoscono.
Il selettore Ruolo di prova aperto: i quattro livelli e, per ciascuno, i servizi che lo conoscono. Ambiente di sviluppo
Prova. La pagina si ricarica. Da quel momento ogni servizio si comporta come per un utente con quel ruolo. Apri una stampa, un cruscotto, la pagina Ruoli e permessi: vedi cosa cambia.
Torna indietro. Scegli di nuovo Tutti i permessi (sviluppo).
Dal cliente non c'è. Con l'Accesso acceso il selettore non compare e il Gateway scarta qualunque richiesta che provi a usarlo. Nessuno può fingersi un altro ruolo: valgono solo i ruoli veri, quelli che arrivano con l'accesso.
Nota. Per provare un ruolo che non è ancora agganciato, prima aggiungilo in Ruoli e permessi con il livello che vuoi dare. Poi lo trovi nel selettore.
Per chi sviluppa.
• La scelta viaggia nell'intestazione X-Dev-Roles. Il Gateway la lascia passare solo con AUTH_ENABLED=false.
• Con l'Accesso spento e nessun ruolo scelto, i servizi danno il livello Staff.
• Selettore: frontend/shell/src/layout/components/ruolo-prova-select.ts. Elenco dei servizi: SERVIZI_CON_RUOLI in frontend/shell/src/shared/auth/ruolo-prova.ts.
Per approfondire.
• Ruoli e permessi: docs/guide/amministrazione/ruoli-e-permessi/README.md