GetFieldOriginalValue

Descrizione

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

Quando viene avviata un'azione, Rational ClearQuest memorizza nella cache i valori originali dei campi del record, nel caso in cui l'azione venga annullata. È 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 di notifica del record rappresenta l'ultima opportunità per ottenere il valore originale prima che un nuovo valore diventi effettivo.

Sintassi

VBScript

entity.GetFieldOriginalValue (field_name) 

Perl

$entity->GetFieldOriginalValue(field_name); 
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).
field_name
Una stringa 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