GetEntity

Descripción

Devuelve el registro especificado.

Cuando se solicita un tipo de registro basado en estado, el parámetro display_name 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 de su 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(entity_def_name, display_name) 

Perl

$session->GetEntity(entity_def_name, display_name); 
Identificador
Descripción
session
El objeto Session que representa la sesión de acceso a la base de datos actual.
entity_def_name
Un valor String que identifica el nombre del tipo de registro al que pertenece el registro.
display_name
Un valor String que identifica el nombre de visualización del registro. El nombre de visualización debe ser el ID visible para entidades de solicitud, 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

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

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

Comentarios