xpfCreateModel

 
SYNTAX:
 
xpfCreateModel (repositoryId : GENERIC;                 modelName    : STRING;                 schemaId     : GENERIC;                 options      : INTEGER)                 modelId      : GENERIC;
 
Argument:

 
The xpfCreateModel function creates a new model in the specified repository in the EDMdatabase^, and returns the modelID in the argument <modelId>. A model is a logical container for entity instances defined by one Express schema. This schema will be the underlying schema of the new model and this particular schema must exist as a dictionary model in the EDMdatabase^ before this function can be successfully performed. Only data models can be created by this function. Any number of models of the same Express schema can exist in an EDMdatabase^.
The new model will be closed after creation, hence one of the functions xpxOpenModel or xpxOpenModelBN must be performed on the model before any access to it is permitted.
A numeric modelID that uniquely identifies the created model in the EDMdatabase^ is returned. This modelID should be used in subsequent EDMinterface^ operations to identify the actual model. The model name qualified with the related repository name will also uniquely identify a model in an EDMdatabase^.
The executing EDMuser will be the owner of the new model and the current EDMgroup account of the executing EDMuser will be the owner group of the model. The owner and owner group of a model is relevant for access rights to the model in subsequent xpxOpenModel and xpxOpenModelBN operations. The model protection will be set according to the default model protection of the executing EDMuser.
The repository that will hold the new model must be open before this function can be successfully performed.
This function is equivalent to the EDMinterface^ function edmiCreateModel.
See also xpxCreateModel.