Hook azione

Questo argomento illustra l'hook azione di ClearQuest.

Gli hook azione possono controllare chi ha l'autorizzazione a modificare i valori del record e convalidare le voci dell'utente prima che venga eseguito il relativo commit nel database. Ad esempio, è possibile convalidare l'intero record ed inviare le notifiche via e-mail al termine dell'azione.

L'ambito di un hook azione è il record corrente. I tipi supportati di hook azione sono elencati nella seguente tabella in base all'ordine di esecuzione.

Hook azione Utilizzo

Controllo accessi

Viene eseguito quando l'azione sta per essere avviata.

Restituisce un valore booleano che indica se l'utente indicato può avviare l'azione specificata su un record. Questo hook viene definito prima che l'utente esegua l'azione. Per le azioni nidificate, un hook controllo accessi non viene eseguito. È possibile scrivere un hook controllo accessi come una routine secondaria VBScript o Perl. Per eseguire un'azione primaria (di modifica, invio, eliminazione, importazione), l'utente corrente deve trovarsi nell'elenco del controllo accessi per l'azione primaria e per tutte le azioni base. Consultare Limitazione dell'accesso utente alle azioni.

Inizializzazione

Viene eseguito all'avvio dell'azione.

Imposta i valori del campo iniziale (o qualsiasi attività specificata). Consente l'inizializzazione complessa di un record. È possibile utilizzare questo hook per impostare i valori del campo prima che inizi un'azione. Questo hook viene definito dopo l'inizializzazione dell'azione ma prima che il contenuto del record venga visualizzato in un modulo. È necessario scrivere un hook inizializzazione come routine secondaria di script.

Convalida

Viene eseguito quando l'utente esegue il commit dell'azione.

Convalida i valori del campo specificati. Se l'utente immette dati non validi, gli vengono richiesti i dati validi. È possibile utilizzare questo hook per controllare le condizioni difficili da verificare all'interno di hook convalida dei singoli campi. Ad esempio, è possibile utilizzare questo hook per verificare le informazioni su un gruppo di campi. Questo hook viene eseguito prima dell'esecuzione del commit delle modifiche sul database. Gli hook convalida devono utilizzare uno script. Consultare Modifica di un elenco dinamico.

Commit

Viene eseguito immediatamente prima dell'esecuzione del commit della transazione nel database.

Collega un'azione a più record in una singola transazione (ad esempio, la risoluzione di tutti i duplicati di una richiesta di modifica quando viene risolto l'originale). Aggiorna una serie di origini dati esterne per mantenerle congruenti con il contenuto del database. Questo hook viene richiamato dopo che gli aggiornamenti al record corrente sono stati registrati nel database, ma prima di eseguire il commit della transazione di aggiornamento. L'hook di commit consente alla transazione di essere estesa per includere aggiornamenti a record aggiuntivi (ad esempio, risolvendo tutti i duplicati di una richiesta di modifica quando viene risolto l'originale).
Nota: poiché tutti gli aggiornamenti al record corrente sono registrati prima dell'esecuzione di questo hook, una chiamata al metodo SetFieldValue sul record corrente non ha alcun effetto in questo hook. Utilizzare l'hook azione di convalida per modificare il record corrente nella transazione. Tuttavia, è possibile utilizzare l'hook di commit per aggiornare i record che sono correlati al record corrente come parte di una transazione singola.

Notifica

Viene eseguito dopo l'esecuzione del commit della transazione.

Avvia un'azione che avvisa gli utenti quando un'azione viene eseguita. Consultare E-mail di Rational ClearQuest. Gli hook notifica devono utilizzare uno script.

Per ulteriori informazioni consultare:


Feedback