Un
field hook è utile per un evento che influenza un particolare campo all'interno del record. Un hook field può impostare
un valore iniziale, rispondere agli eventi quando un valore del campo viene modificato,
applicare le autorizzazioni di accesso in modo tale che solo i gruppi utenti specificati
possono modificare i valori del campo e convalidare i valori forniti dagli utenti.
L'ambito di un hook
field è il campo corrente all'interno del record corrente. Vengono supportati i seguenti tipi di
hook field:
- Hook field
- Descrizione
- Choice List
- Restituisce una serie
di valori validi. Utilizzare questo hook con i campi visualizzati utilizzando un controllo list-type, quale una casella di elenco o una casella. È anche possibile fornire i valori senza il linguaggio di script utilizzando una costante o un elenco dinamico. Consultare la Creazione di choice list per un campo.
- Default Value
- Imposta il valore iniziale del campo. Questo hook è definito all'inizio di un'azione Submit. È possibile scrivere un hook default-value con una routine secondaria di script.
È anche possibile assegnare un valore di costante come valore predefinito.
- Permission
- Restituisce una delle costanti
BehaviorType in cui viene indicato l'accesso dell'utente
al campo. Utilizzare questo hook per applicare il flusso di lavoro e/o la sicurezza. (Per le costanti enumerate, consultare la sezione IBM Rational ClearQuest - Riferimento API). Se si aggiunge un hook Permission ad un campo, è necessario modificare la griglia Behaviors in modo tale che
almeno uno dei comportamenti del campo sia impostato su USE_HOOK.
Un errore in questa operazione determina un errore di convalida.
- Validation
- Convalida il contenuto del campo. Questo hook viene
definito quando il valore viene modificato, per fornire all'utente il feedback immediato relativo
alla validità del contenuto del campo prima di eseguire il commit del record sul database.
- Value Changed
- Risponde alle modifiche nel valore di un campo. Utilizzare questo hook
per attivare gli aggiornamenti di altri campi (ad esempio, elenchi dipendenti). Dopo aver eseguito questo hook,
qualsiasi campo modificato dallo script viene convalidato richiamando l'hook Validation
(se presente) per il campo.
Gli hook vengono eseguiti in base alle regole specificate nella sezione Ordine
di esecuzione degli hook field e action.