24.3 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.

Gestori personalizzati delle proprietà

Alcuni esempi di gestori personalizzati delle proprietà includono:

interrogazione del valore di altri campi
aggiornamento dei valori dei campi
attivazione/disattivazione dello stato di sola lettura di un campo
visualizzazione o occultamento di campi in base alle variabili configurate

Gestori di caricamento modulo

I gestori di caricamento modulo eseguono generalmente controlli di inizializzazione. Vengono eseguiti solo una volta durante il caricamento iniziale del modulo. Nel caso delle pagine delle proprietà, vengono eseguiti prima che il server venga sottoposto a query per le proprietà dell'oggetto selezionato.

Gestori di invio modulo

I gestori di invio modulo permettono di eseguire alcuni tipi di convalida ed eventualmente annullare l'invio del modulo in caso di errori.

Per esempi più dettagliati sull'utilizzo di gestori personalizzati e personalizzazioni nella Console Web, fare riferimento alle sezioni Web Console Customization (Personalizzazione della Console Web) e Workflow Customization (Personalizzazione del workflow) nel riferimento Product Customization (Personalizzazione del prodotto) nella pagina della documentazione DRA.

Abilitazione di JavaScript personalizzato

Per motivi di sicurezza, JavaScript personalizzato è disabilitato per default. L'abilitazione di JavaScript personalizzato consente agli amministratori di scrivere frammenti di codice JavaScript che verranno eseguiti dalla Console Web senza variazioni. È consigliabile abilitare questa eccezione solo se si comprendono e si accettano i rischi correlati.

Per abilitare le personalizzazioni per includere codice JavaScript personalizzato:

Passare all'ubicazione C:\ProgramData\NetIQ\DRARESTProxy.
Aprire il file restProxy.config.
Aggiungere allowCustomJavaScript = "true" all'elemento <consoleConfiguration>.

24.3.1 Passaggi di base per la creazione di un gestore personalizzato:

La procedura riportata di seguito inizia da una pagina preselezionata del gestore personalizzato. Per arrivare a tale punto, è necessario accedere ai gestori personalizzati delle proprietà dell'oggetto tramite l'icona delle proprietà in un campo delle proprietà. È possibile accedere ai gestori di caricamento modulo e di invio modulo dal pulsante Proprietà modulo in un modulo di workflow selezionato, in una pagina Crea oggetto o in una pagina Modifica proprietà.

Selezionare la scheda del gestore appropriata in base alla proprietà o alla pagina che si sta personalizzando:
- Gestori personalizzati
- Gestori caricamento modulo
- Gestori invio modulo
Abilitare la pagina del gestore ed eseguire una delle seguenti operazioni:
- Gestore personalizzato del campo delle proprietà:
  1. Selezionare un orario di esecuzione. Di norma, per l'ora di esecuzione si utilizzerà la seconda o la terza opzione.
  2. Fare clic su + Aggiungi e scegliere un gestore personalizzato dal menu Aggiungi gestore personalizzato.
- Gestore del modulo: fare clic su + Aggiungi e scegliere un gestore personalizzato dal menu Aggiungi gestore personalizzato.
NOTA:In genere è probabile che sia sufficiente un solo gestore personalizzato ma è possibile usarne più di uno. I gestori multipli vengono eseguiti sequenzialmente nell'ordine elencato. Se si desidera modificare l'ordine dei gestori o ignorare un gestore non necessario, è possibile aggiungere macro di controllo del flusso nello script.
Sarà necessario configurare ciascun gestore personalizzato aggiunto alla pagina. Le opzioni di configurazione variano in base al tipo di gestore.

È possibile creare tipi di gestori personalizzati.
- Gestori di query LDAP o REST:
  1. Se si desidera basare la propria query su valori statici, è necessario definire le informazioni di connessione e i parametri della query.
    
    Se si desidera che la query sia dinamica, immettere i valori segnaposto nei campi obbligatori. Questa operazione è necessaria affinché il gestore venga eseguito. Lo script sovrascriverà i valori segnaposto.
    
    NOTA:È anche possibile configurare le intestazioni e i cookie per la query REST.
  2. In Azione pre-query, utilizzare l'editor di script per scrivere codice JavaScript personalizzato che verrà eseguito prima dell'invio della query. Questo script dispone dell'accesso a tutte le informazioni sulla connessione e ai parametri di query ed è in grado di apportare modifiche in modo da personalizzare la query. Ad esempio, impostare i parametri di query in base ai valori immessi dall'utente nel modulo.
  3. Nell'Azione post-query, includere script per elaborare i risultati della query. I task comuni includono il controllo di errori, l'aggiornamento dei valori del modulo in base ai risultati restituiti e la convalida dell'univocità dell'oggetto in base al numero di oggetti restituiti dalla query.
- Script: Inserire codice JavaScript personalizzato per creare lo script.
- Query DRA: Specificare il payload JSON nella scheda Parametri query. Il formato del payload deve corrispondere alla chiave VarSet o alle coppie di valori che verranno inviate al server DRA. Analogamente alle query REST e LDAP, è possibile specificare un'Azione pre-query che può essere utilizzata per modificare il payload prima che venga inviato al server e un'Azione post-query per elaborare i risultati.
- Gestori delle caselle del messaggio: Una volta definite le proprietà della finestra del messaggio, è inoltre possibile scrivere i segmenti JavaScript per l'Azione prima della visualizzazione e l'Azione dopo la chiusura.
  
  Queste azioni sono facoltative. L'Azione prima della visualizzazione consente di personalizzare qualsiasi proprietà della casella di messaggio prima che venga visualizzata all'utente, l'Azione dopo la chiusura viene utilizzata per elaborare la selezione del pulsante dell'utente ed eseguire eventuale logica aggiuntiva sulla base della selezione.
Fare clic su OK per salvare il gestore.