GetFieldOriginalValue

Description

Restituisce un oggetto FieldInfo contenente il valore che verrà ripristinato nel campo specificato, se l'azione viene annullata.

Quando si avvia un'azione, Rational ClearQuest individua i valori originali dei campi del record nel caso in cui venga eliminata l'azione. È possibile utilizzare questo metodo per restituire il valore originale di un campo modificato in precedenza. È possibile ottenere il valore originale di un campo solo quando il record è modificabile. L'hook Notification del record rappresenta l'ultima opportunità per ottenere il valore originale prima che un nuovo valore diventi effettivo.

Nota: la chiamata di questo metodo da un hook Action Access Control restituisce il valore originale del campo di record a prescindere dal fatto che l'azione corrente sia o meno un'azione change state.

Sintassi

VBScript

entity.GetFieldOriginalValue (field_name) 

Perl

$entity->GetFieldOriginalValue(field_name); 
Identificativo
Description
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).
field_name
Un valore String contenente un nome del campo valido di questo oggetto Entity.
Valore di ritorno
Un oggetto FieldInfo contenente il valore originale per il campo specificato.

Esempio

VBScript

' Iterate through the fields and report which ones have changed.
fieldNameList = GetFieldNames
For Each fieldName in fieldNameList
   originalValue = GetFieldOriginalValue(fieldName).GetValue
   currentValue = GetFieldValue(fieldName).GetValue
   If currentValue <> originalValue Then
      ' Report a change in the field value
      OutputDebugString "The value in field " & fieldName & " has changed."

   End If 
Next 
Perl 
my($FieldNamesRef) = $entity->GetFieldNames();

   foreach $FN (@$FieldNamesRef) {

      # Get the field's original value...

      $FieldInfo = $entity->GetFieldOriginalValue($FN);

      #...

   } 


Feedback