BuildEntity

Descrizione

Crea un nuovo record del tipo specificato e inizia un'azione di inoltro.

Questo metodo crea un nuovo record e inizia un'azione di inoltro, perciò consente all'utente di modificare il contenuto del record. (Non è necessario richiamare EditEntity per rendere il record modificabile.) È possibile assegnare i valori ai campi del nuovo record utilizzando il metodo SetFieldValue dell'oggetto Entity restituito. Una volta terminato l'aggiornamento del record, utilizzare i metodi Validate e Commit dell'oggetto Entity per rispettivamente convalidare ed eseguire il commit delle modifiche apportate al record.

Il nome specificato nel parametro entitydef_name deve inoltre corrispondere a un tipo di record appropriato nello schema. Per ottenere un elenco di nomi validi per entitydef_name, utilizzare il metodo GetSubmitEntityDefNames.

Sintassi

VBScript

session.BuildEntity (entitydef_name) 

Perl

$session->BuildEntity(entitydef_name); 
Identificativo
Descrizione
session
L'oggetto Session che rappresenta la sessione di accesso al database corrente.
entitydef_name
Una stringa che contiene il nome dell'Oggetto EntityDef da utilizzare come maschera durante la creazione del record.
Valore di ritorno
Un nuovo Oggetto Entity creato utilizzando l'oggetto denominato EntityDef come maschera.

Esempi

VBScript

set sessionObj = GetSession 

' Create a new "defect" record 
set entityObj = sessionObj.BuildEntity("defect") 

Perl

$sessionobj = $entity->GetSession();

# Create a new "defect" record 



$entityobj = $sessionobj->BuildEntity("defect"); 

Feedback