GetDisplayName

Descripción

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

Para tipos de registro basados en estado, la clave exclusiva es el ID visible del registro y tiene el formato SITIOnnnnnn (por ejemplo, "PASNY00012332"), donde SITIO es una indicación del sitio de instalación y nnnnnn es el número de defecto (error).

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 es invisible 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

' Obtener el ID de registro utilizando 2 técnicas diferentes y comparar
' los resultados
displayName = GetDisplayName 
idName = GetFieldValue("id").GetValue 
If idName <> displayName Then 
  ' Error, los números de ID deben coincidir 
End If 

Perl

# Obtener el ID de registro utilizando 2 técnicas diferentes y comparar
# los resultados



$displayname = $entity->GetDisplayName();

$idname = $entity->GetFieldValue("id")->GetValue();



if ($idname ne $displayname)

 {

 # error, los números de ID deben coincidir

 } 


Comentarios