GetFieldsUpdatedThisGroup

Descrizione

Restituisce un Oggetto FieldInfo per ogni campo modificato dalla chiamata più recente a BeginNewFieldUpdateGroup.

Utilizzare questo metodo per contrassegnare la fine di un gruppo di chiamate a SetFieldValue (È necessario aver richiamato precedentemente BeginNewFieldUpdateGroup per contrassegnare l'inizio di un gruppo.) Questa tecnica è utile per i sistemi basati sul Web per cui potrebbe essere necessario eseguire la traccia di tutte le modifiche effettuate ai campi in un modulo. Ad esempio, se l'utente si sposta in un'altra pagina Web, è possibile richiamare questo metodo per salvare lo stato corrente del modulo e ripristinarlo nel momento in cui l'utente si sposta di nuovo su tale pagina.

Sintassi

VBScript

entity.GetFieldsUpdatedThisGroup 

Perl

$entity->GetFieldsUpdatedThisGroup(); 
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 i cui valori vengono modificati nel momento in cui si verifica la chiamata più recente a BeginNewFieldUpdateGroup. 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

BeginNewFieldUpdateGroup 
SetFieldValue "field1", "1" 
SetFieldValue "field2", "submitted" 
SetFieldValue "field3", "done" 
updatedFields = GetFieldsUpdatedThisGroup 

' Iterate over all the fields that changed 
For Each field In updatedFields 
   ' ... 
Next 

Perl

$entity->BeginNewFieldUpdateGroup()

$entity->SetFieldValue("field1", "1" );

$entity->SetFieldValue("field2", "submitted");

$entity->SetFieldValue("field3", "done");

$updatedFields = $entity->GetFieldsUpdatedThisGroup ();

$count = $updatedFields->Count();

# Iterate over all the fields that changed 

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

   {
   $field = $updatedFields->Item($x);

   # do other tasks...

 } 

Feedback