GetDisplayName

Descrizione

Restituisce il nome di visualizzazione (una chiave univoca) associata all'oggetto Entity.

Per i tipi di record basati sullo stato, la chiave univoca è l'ID visibile del record, che ha il formato DBnnnnnn (ad esempio, PASNY00012332), dove DB è il nome del database ed nnnnnn è il numero del record.

Per i tipi di record stateless, la chiave unica è formata dai valori dei campi della chiave univoca definiti dall'amministratore. Se esiste un singolo campo della chiave univoca, il relativo valore sarà la chiave univoca. Se esistono più campi che costituiscono la chiave univoca, i relativi valori saranno concatenati in base all'ordine specificato dall'amministratore. Per i tipi di record basati sullo stato, il richiamo di questo metodo equivale al richiamo del valore del campo di sistema "id" utilizzando un Oggetto FieldInfo.

La chiave univoca non deve essere confusa con l'ID database, che non è visibile per l'utente. L'ID database viene richiamato dal metodo GetDbId.

Sintassi

VBScript

entity.GetDisplayName 

Perl

$entity->GetDisplayName(); 
Identificativo
Descrizione
entity
Un oggetto Entity che rappresenta un record di dati dell'utente. All'interno di un hook, se si omette questa parte della sintassi, viene utilizzato l'oggetto Entity corrispondente al record di dati corrente (solo VBScript).
Valore di ritorno
Una stringa contenente la chiave univoca del tipo di record.

Esempi

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