BuildEntity

Description

Creates a new record of the specified type and begins a submit action.

This method creates a new record and initiates a submit action, thus enabling you to begin editing the record's contents. (You do not need to call EditEntity to make the record editable.) You can assign values to the new record's fields using the SetFieldValue method of the returned Entity object. When you are done updating the record, use the Validate and Commit methods of the Entity object to validate and commit any changes you made to the record, respectively.

The name you specify in the entitydef_name parameter must also correspond to an appropriate record type in the schema. To obtain a list of legal names for entitydef_name, use the GetSubmitEntityDefNames method.

Syntaxe

VBScript

session.BuildEntity (entitydef_name) 

Perl

$session->BuildEntity(entitydef_name); 
Identificateur
Description
session
Objet Session représentant la session en cours d'accès à la base de données.
entitydef_name
A String containing the name of the EntityDef Object to use as a template when creating the record.
Valeur renvoyée
A new Entity Object that was built using the named EntityDef object as a template.

Exemples

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"); 

Commentaires en retour