GetFieldsUpdatedThisEntireAction

Descripción

Devuelve un objeto FieldInfo para cada campo que ha modificado la acción completa, incluidos los cambios que se han llevado a cabo en todos los enganches de inicialización. El método GetFieldsUpdatedThisEntireAction (nuevo en la versión 2003.03.15) resuelve un problema con la lógica utilizada para determinar los campos que han cambiado durante una acción.

Este método informa sobre los campos que han cambiado durante la acción completa, incluidos todos los campos que han cambiado antes del retorno de la llamada a BuildEntity o EditEntity. 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); también 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.

Nota: Este método estuvo disponible en la versión 2003.06.13.

Sintaxis

VBScript

entity.GetFieldsUpdatedThisEntireAction 

Perl

$entity->GetFieldsUpdatedThisEntireAction(); 
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 VBScript, 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

DIM CQFieldInfo
DIM CQFieldInfos
DIM sessionObj
set sessionObj = GetSession
' Report any fields that changed during the recent action
CQFieldInfos = CQEntity.GetFieldsUpdatedThisEntireAction
' Get the list of field names returned by this function ...
For Each CQFieldInfo In CQFieldInfos
' Report the fields to the user
   sessionObj.OutputDebugString "Field " & CQFieldInfo.GetName & " changed."
Next

Perl

my(@ActualUpdatedFields);
my($CQFieldInfos);
my($CQEntity);
# Report any fields that changed during the recent action
$CQFieldInfos = $CQEntity->GetFieldsUpdatedThisEntireAction();
# Get the list of field names returned by this function ...
@ActualUpdatedFields = &GetFieldNames($CQFieldInfos);

Comentarios