GetDisplayName

Description

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 possiede il formato SITEnnnnnn (ad esempio, 'PASNY00012332'), dove SITE è un'indicazione del sito di installazione e nnnnnn è il numero (bug) di difetto.

Per i tipi di record senza stato, 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, richiamare questo metodo equivale ad ottenere il valore del campo di sistema "id" utilizzando un Oggetto FieldInfo.

La chiave univoca non deve essere confusa con l'ID database, invisibile all'utente. L'ID database viene richiamato dal metodo GetDbId.

Sintassi

VBScript

entity.GetDisplayName 

Perl

$entity->GetDisplayName(); 
Identificativo
Description
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
Un valore String 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