GetEntity

Descripción

Devuelve el registro especificado.

Cuando se solicita un tipo de registro basado en estado, el parámetro nombre_visualización debe contener el ID visible del registro (por ejemplo, "DEF00013323"). Para tipos de registro sin estado, este parámetro debe contener el valor del campo de clave exclusiva del registro.

Para solicitar un registro utilizando su ID de base de datos en lugar del ID visible, utilice GetEntityByDbId.

Nota: Para optimizar el rendimiento, si desea recuperar algunos, pero no todos los valores de un registro, resulta más eficaz utilizar consultas que llamar a EditEntity. Puede compilar una consulta en el campo State a fin de evitar la obtención del registro completo.

Sintaxis

VBScript

session.GetEntity(nombre_def_entidad, nombre_visualización) 

Perl

$session->GetEntity(nombre_def_entidad, nombre_visualización); 
Identificador
Descripción
session
El objeto Session que representa la sesión de acceso a la base de datos actual.
nombre_def_entidad
Un valor String que identifica el nombre del tipo de registro al que pertenece el registro.
nombre_visualización
Un valor String que identifica el nombre de visualización del registro. El nombre de visualización debe ser el ID visible (123@SITE) para entidades de petición, o bien, los campos de clave exclusiva para una entidad aux.
Valor de retorno
Devuelve un objeto Entity correspondiente al registro solicitado.

Ejemplos

VBScript

set sessionObj = GetSession 
sessionObj.UserLogon "admin", "", "SAMPL", AD_PRIVATE_SESSION, ""
set record1 = sessionObj.GetEntity("defect", "DEF00013323") 

Perl

#Crear una sesión de Rational
ClearQuest

$sessionObj = $entity->GetSession();

$sessionObj->UserLogon("admin","","SAMPL","");

#Obtener el registro DEF00013323

$record1 = $sessionObj->GetEntity( "defect", "DEF00013323" ); 


Comentarios