8.2 Client Web
Nel client Web, è possibile personalizzare le proprietà degli oggetti, i moduli di automazione dei workflow e il branding dell'interfaccia utente. Se implementate correttamente, le personalizzazioni di proprietà e workflow contribuiscono ad automatizzare i task degli amministratori aggiunti durante la gestione degli oggetti e l'invio di workflow automatizzati.
8.2.1 Personalizzazione delle pagine delle proprietà
È possibile personalizzare in base al tipo di oggetto i moduli delle proprietà degli oggetti che gli amministratori aggiunti utilizzano nei loro ruoli di gestione di Active Directory. A tale scopo è necessario creare e personalizzare nuove pagine degli oggetti basate sui tipi integrati in DRA. È anche possibile modificare le proprietà dei tipi di oggetti integrati.
Gli oggetti delle proprietà sono chiaramente definiti nell'elenco Pagine delle proprietà nella Console Web e risulta quindi facile individuare le pagine degli oggetti integrati, quali di esse sono personalizzate e quali pagine non sono invece integrate e sono state create da un amministratore.
Personalizzazione di una pagina delle proprietà degli oggetti
È possibile personalizzare i moduli delle proprietà degli oggetti aggiungendo o rimuovendo pagine, modificando pagine e campi esistenti e creando gestori personalizzati per gli attributi delle proprietà. Quando si creano gestori personalizzati, essi vengono eseguiti automaticamente quando un campo delle proprietà viene modificato o quando un amministratore risponde a un prompt di esecuzione di una query, in base alla configurazione del gestore personalizzato.
L'elenco di oggetti nelle pagine delle proprietà consente di eseguire due tipi di operazioni per ciascun tipo di oggetto: Crea oggetto e Modifica proprietà. Si tratta delle operazioni principali che gli amministratori aggiunti eseguono nel client Web e le personalizzazioni possono migliorare l'efficienza e l'esperienza degli amministratori quando gestiscono gli oggetti Active Directory in DRA.
Per personalizzare la pagina delle proprietà di un oggetto nella Console Web:
-
Eseguire il login alla Console Web come amministratore di DRA.
-
Passare a .
-
Selezionare un oggetto e un tipo di operazione (creazione o modifica) nell'elenco Pagine delle proprietà.
-
Fare clic sul pulsante
.
-
Personalizzare il modulo delle proprietà dell'oggetto effettuando una o più delle operazioni seguenti e applicando successivamente le modifiche:
-
Aggiungere una nuova pagina delle proprietà mediante .
-
Selezionare una pagina delle proprietà e personalizzarla:
-
Per riordinare i campi di configurazione nella pagina:
-
Per modificare i campi o i sottocampi:
-
Per aggiungere uno o più campi:
o
-
Per rimuovere uno o più campi:
-
-
Creare gestori personalizzati per le proprietà utilizzando script, caselle dei messaggi o query (LDAP, DRA o REST)
Per ulteriori informazioni sull'uso dei gestori personalizzati, vedere Aggiunta di gestori personalizzati.
-
Creazione di una nuova pagina delle proprietà dell'oggetto
Per creare una nuova pagina delle proprietà dell'oggetto:
-
Eseguire il login alla Console Web come amministratore di DRA.
-
Passare a .
-
In Task, fare clic su .
-
Creare il modulo iniziale delle proprietà dell'oggetto definendo nome, icona, tipo di oggetto e configurazione dell'operazione.
-
Personalizzare il nuovo modulo secondo necessità. Vedere Personalizzazione di una pagina delle proprietà degli oggetti.
8.2.2 Personalizzazione dei moduli di workflow
Quando si crea o si modifica un modulo di workflow, esso viene salvato nel server Web ed è accessibile mediante la Console Web nella pagina > . Questi moduli sono utili per inviare workflow automatizzati che vengono creati nel server di automazione dei workflow. È possibile personalizzare i moduli per automatizzarne e migliorarne ulteriormente l'utilizzo da parte degli amministratori aggiunti nell'esecuzione dei task di gestione degli oggetti.
È possibile aggiungere e modificare proprietà dei moduli e gestori personalizzati esistenti. Il comportamento dell'interfaccia per aggiungere e personalizzare proprietà è analogo a quello dei moduli di automazione dei workflow per la personalizzazione delle proprietà degli oggetti. Per ulteriori informazioni su come aggiungere e modificare le proprietà, aggiungere gestori personalizzati e comprendere l'automazione dei workflow, vedere gli argomenti trattati di seguito.
Aggiunta di gestori personalizzati
In DRA i gestori personalizzati vengono utilizzati affinché gli attributi delle proprietà interagiscano fra di loro per completare task di workflow e per le personalizzazioni di caricamento e invio in un workflow, una proprietà o un modulo di creazione.
Fra gli esempi di gestori di proprietà personalizzati si ricordano le query relative al valore di altri campi, l'aggiornamento di valori, l'attivazione/disattivazione dello stato di sola lettura di un campo e la visualizzazione o meno dei campi in base alle variabili configurate.
I gestori di caricamento moduli consentono agli utenti di personalizzare i moduli, in genere mediante alcune operazioni d'inizializzazione dei controlli. I gestori di invio moduli permettono invece alcune operazioni di convalida ed eventuale annullamento dell'invio in caso di errori.
DRA semplifica anche la creazione di gestori personalizzati grazie a varie macro JavaScript (JS) che è possibile scegliere durante il processo di creazione e convalida del gestore personalizzato.
Passaggi di base per la creazione di un gestore personalizzato:
La procedura descritta di seguito inizia dalla pagina di un gestore personalizzato precedentemente selezionato. Per arrivare a tale punto, si accede ai gestori personalizzati della proprietà dell'oggetto mediante il pulsante di modifica di un campo delle proprietà. Per accedere a Gestori caricamento modulo e Gestori invio modulo, utilizzare Proprietà modulo in un modulo di workflow o la pagina di creazione di un oggetto.
-
Fare clic sulla scheda applicabile del gestore personalizzato e abilitare la pagina
.
-
Gestori personalizzati
-
Gestori caricamento modulo
-
Gestori invio modulo
-
-
Scegliere un gestore personalizzato nel menu a discesa e selezionare un'ora di esecuzione. In genere, si utilizza la seconda o la terza opzione per l'ora di esecuzione.
NOTA:solitamente è necessario un solo gestore personalizzato, ma è possibile utilizzarne più di uno configurando i controlli di flusso nello script per collegare i gestori fra loro.
-
È necessario configurare
ciascun gestore personalizzato aggiunto alla pagina. Le opzioni di configurazione variano in base al tipo di gestore, ma tutti vengono eseguiti da JavaScript.
È possibile creare le proprie voci Vanilla JavaScript o utilizzare le macro integrate.
-
Gestori di query LDAP o REST:
-
Se si desidera che la query si basi su valori statici, impostare e .
Se si desidera che la query sia dinamica, immettere il testo segnaposto nei campi obbligatori. Questa operazione è necessaria affinché lo script venga eseguito. Lo script sostituisce i valori fittizi.
NOTA:è anche possibile configurare intestazioni e cookie per la query REST.
-
In Azione pre-query, selezionare un tipo di macro: , o .
-
Selezionare una macro dall'elenco a discesa e inserire la macro ().
-
Inserire altre macro in base alle esigenze e specificare i valori desiderati per completare lo script.
In questo esempio, in Azione pre-query utilizzeremo uno script per verificare che il nome di un gruppo immesso da un utente non esista già in Active Directory quando il modulo viene inviato.
Dovremo quindi creare una query LDAP utilizzando il nome immesso dall'utente. A tale scopo, utilizziamo la macro Field() per accedere al valore del campo del nome e creare la stringa di query che impostiamo poi come filtro di query utilizzando la macro Filter().
Filter() = '(&(objectCategory=group)(objectClass=group)(name=' + Field(name) + '))';
-
Continuando con lo stesso esempio, in Azione post-query controlleremo i risultati restituiti dalla query. I risultati vengono restituiti come matrice di oggetti che soddisfano i criteri della query, perciò dobbiamo solo controllare se la lunghezza della matrice è maggiore di 0.
Quando viene individuato un gruppo corrispondente, utilizziamo la macro Cancel() per annullare l'invio del modulo, trasferendo alla macro un messaggio facoltativo da visualizzare per l'utente.
if (QueryResults().length > 0) { Cancel('A group with that name already exists, please enter a unique name.');}
-
-
Script: inserire codice JavaScript personalizzato oppure creare lo script utilizzando le macro.
-
Query DRA: per i parametri della query, definire un payload in formato JSON. Successivamente, utilizzare le macro in modo simile a quanto descritto in precedenza per le query LDAP e REST.
-
Gestori di caselle dei messaggi: dopo aver definito le proprietà della casella del messaggio, utilizzare le macro in modo simile a quanto descritto in precedenza per le query LDAP e REST, componendo gli script delle macro utilizzando Azione prima della visualizzazione e Azione dopo la chiusura anziché Azione pre-query e Azione post-query.
-
-
Fare clic su per convalidare lo script prima di salvare il modulo.
Viene così generato un riepilogo dei risultati della prova in cui è possibile visualizzare i risultati dell'esecuzione.
NOTA:se il gestore dipende dallo stato corrente del modulo (ad esempio, il campo ha un valore), non verrà eseguito correttamente, poiché non sono stati caricati dati al momento della modifica del modulo. In questi casi il gestore dovrà essere provato al di fuori dell'editor dei moduli, salvando la personalizzazione, spostandosi sul modulo appropriato e inserendo i dati necessari.