GetFieldsUpdatedThisAction

Descrizione

Restituisce un oggetto FieldInfo per ogni campo modificato dall'azione più recente.

Questo metodo restituisce i campi modificati durante l'azione corrente, ovvero, tutti i campi modificati dopo la la chiamata di BuildEntity o EditEntity. Non 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); non 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.

Ad esempio, se l'utente avvia un'azione CHANGE_STATE, il valore nel campo "stato" del record viene modificato ma non restituito da questo metodo. In modo simile, se l'hook di inizializzazione azione dell'azione modifica un campo, tale modifica non viene restituita. Tuttavia, le modifiche avvenute durante l'esecuzione di un hook valore campo modificato o un hook di convalida vengono restituite poiché si sono verificate dopo l'inizializzazione completa dell'azione.

Sintassi

VBScript

entity.GetFieldsUpdatedThisAction

Perl

$entity->GetFieldsUpdatedThisAction();
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 Visual Basic, viene restituito un valore Variant contenente un array dell'Oggetto 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 relativa all'Oggetto FieldInfos.

Esempi

VBScript

set sessionObj = GetSession

' Report any fields that changed during the recent action
fieldList = GetFieldsUpdatedThisAction
For Each field in fieldList
      ' Report the fields to the user
      sessionObj.OutputDebugString "Field " & field.GetName & "
         changed."
Next

Perl

$sessionobj = $entity->GetSession();

# Report any fields that changed during the recent action

$fieldlist = $entity->GetFieldsUpdatedThisAction();

# Find out how many duplicates there

# are so the for loop can iterate them

$updatedfields = $fieldlist->Count();

for ($x = 0; $x < $updatedfields ; $x++)

{

 # Report the fields to the user

 $sessionobj->OutputDebugString("Field ".$fieldlist->Item($x)->GetName."
       changed." )

}

Feedback