GetDisplayName

Descripción

Devuelve el nombre de visualización (una clave exclusiva) asociado a la entidad.

Para tipos de registros basados en estado, la clave exclusiva es el ID visible del registro y tiene el formato DBnnnnnn (por ejemplo, PASNY00012332), donde DB es el nombre de la base de datos y nnnnnn es el número de registro.

Para tipos de registro sin estado, la clave exclusiva consta de los valores de los campos de la clave exclusiva que define el administrador. Si sólo hay un campo de clave exclusiva, el valor es la clave exclusiva. Si la clave exclusiva está formada por varios campos, sus valores se concatenan en el orden que especifica el administrador. Para tipos de registro basados en estado, llamar a este método equivale a obtener el valor del campo del sistema "id" utilizando un Objeto FieldInfo.

No se debe confundir la clave exclusiva con el ID de base de datos, que no es visible al usuario. El ID de base de datos se recupera por medio del método GetDbId.

Sintaxis

VBScript

entity.GetDisplayName 

Perl

$entity->GetDisplayName(); 
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
Un valor String que contiene la clave exclusiva del tipo de registro.

Ejemplos

VBScript

' Get the record ID using 2 different techniques and compare the
' results
displayName = GetDisplayName 
idName = GetFieldValue("id").GetValue 
If idName <> displayName Then 
  ' Error, these id numbers should match 
End If 

Perl

# Get the record ID using 2 different techniques and compare the 
# results
$displayname = $entity->GetDisplayName();
$idname = $entity->GetFieldValue("id")->GetValue();
if ($idname ne $displayname)
 {
 # error, these id numbers should match
 } 

Feedback