GetFieldsUpdatedThisAction

Descripción

Devuelve un objeto FieldInfo para cada campo que ha modificado la acción más reciente.

Este método informa sobre los campos que han cambiado durante la acción actual, es decir, todos los campos que han cambiado después del retorno de la llamada a BuildEntity o EditEntity. No se informa sobre los campos que se han cambiado, implícitamente, durante la inicialización de la acción (lo que incluye enganches FIELD_DEFAULT_VALUE que establecen los valores de campo iniciales predeterminados); tampoco se informa sobre los campos que han modificado los enganches durante la inicialización de la acción. Este método informa sobre los campos que han cambiado los enganches después de la fase de inicialización de la acción; consulte en la documentación de Rational ClearQuest Designer el tiempo y el orden de ejecución de los enganches.

Como ejemplo, si el usuario inicia una acción CHANGE_STATE, cambia el valor del campo de "estado" del registro, pero este método no informa sobre ello. De forma similar, si el enganche de inicialización de acción de la acción modifica un campo, no se informa sobre el cambio. Sin embargo, se informa sobre los cambios que se llevan a cabo durante un enganche de valor de campo cambiado o un enganche de validación, puesto que se producen una vez que la acción se ha inicializado completamente.

Sintaxis

VBScript

entity.GetFieldsUpdatedThisAction

Perl

$entity->GetFieldsUpdatedThisAction();
Identificador
Descripción
entity
Un objeto Entity que representa un registro de datos de usuario. En un enganche, si se omite esta parte de la sintaxis, se presupone el objeto Entity correspondiente al registro de datos actual (sólo VBScript).
Valor de retorno
Para Visual Basic, devuelve un valor Variant que contiene una matriz de objetos FieldInfo. Cada objeto FieldInfo corresponde a un campo del objeto Entity cuyos valores han cambiado desde el inicio de la acción más reciente. Si no se ha actualizado ningún campo, este método devuelve un Empty Variant.

Para Perl, devuelve una recopilación del objeto FieldInfos.

Ejemplos

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