GetFieldsUpdatedThisEntireAction

Descrizione

Restituisce un oggetto FieldInfo per ogni campo modificato dall'intera azione, incluse le modifiche effettuate in tutti gli hook di inizializzazione. Il metodo GetFieldsUpdatedThisEntireAction (nuovo nella versione 2003.03.15) risolve un problema con la logica utilizzata per determinare i campi modificati durante un'azione.

Questo metodo restituisce i campi modificati durante l'intera azione, inclusi tutti i campi modificati prima della chiamata di BuildEntity o EditEntity. Vengono restituiti i campi implicitamente modificati durante l'inizializzazione dell'azione (che include valori del campo predefiniti iniziali dell'impostazione di hook FIELD_DEFAULT_VALUE); vengono restituiti anche i campi modificati dagli hook durante l'inizializzazione dell'azione. Questo metodo restituisce i campi modificati dagli hook dopo la fase di inizializzazione dell'azione; consultare la documentazione di Rational ClearQuest Designer per la tempistica e l'ordine di esecuzione degli hook.

Nota: questo metodo è disponibile nella versione 2003.06.13.

Sintassi

VBScript

entity.GetFieldsUpdatedThisEntireAction 

Perl

$entity->GetFieldsUpdatedThisEntireAction(); 
Identificativo
Descrizione
entity
Un oggetto Entity che rappresenta un record di dati dell'utente. All'interno di un hook, se si omette questa parte della sintassi, viene utilizzato l'oggetto Entity corrispondente al record di dati corrente (solo VBScript).
Valore di ritorno
Per VBScript, viene restituito un valore Variant contenente un array di oggetti FieldInfo. Ogni oggetto FieldInfo corrisponde ad un campo dell'oggetto Entity i cui valori sono stati modificati nel momento in cui è stata avviata l'azione più recente. Se i campi non sono stati aggiornati, questo metodo restituisce un valore Variant vuoto. Per Perl, viene restituita una raccolta di oggetti FieldInfos.

Esempi

VBScript

DIM CQFieldInfo
DIM CQFieldInfos
DIM sessionObj
set sessionObj = GetSession
' Report any fields that changed during the recent action
CQFieldInfos = CQEntity.GetFieldsUpdatedThisEntireAction
' Get the list of field names returned by this function ...
For Each CQFieldInfo In CQFieldInfos
' Report the fields to the user
   sessionObj.OutputDebugString "Field " & CQFieldInfo.GetName & " changed."
Next

Perl

my(@ActualUpdatedFields);
my($CQFieldInfos);
my($CQEntity);
# Report any fields that changed during the recent action
$CQFieldInfos = $CQEntity->GetFieldsUpdatedThisEntireAction();
# Get the list of field names returned by this function ...
@ActualUpdatedFields = &GetFieldNames($CQFieldInfos);

Feedback