Web API for Models

Models API is used to create models, delete models and edit model properties. Data is imported to models by importing data to the datatables used by the model.

Model Entity

The models API is based on the model entity, which has the following properties:

• Id (integer): model id.
• ProjectId (integer): Id of the project where the model is located. The datatable is moved to another project by changing this property.
• Name (string): Model name.
• Description (string): Model description.
• CreatedDate (datetime): Model creation date.
• CreatorId (integer): Model creator user id.
• LastModifiedDate (datetime): Model last modification date
• LastModifierId (integer): Model last modifier user id
• NCases (integer): number of cases in the model.
• NEvents (integer): number of events in the model.
• NEventTypes (integer): number of event types in the model.
• NCaseAttributes (integer): number of case attributes in the model.
• NEventAttributes (integer): number of event attributes in the model.
• NFilters (integer): number of filters in the model.
• NAnalyses (integer): number of analyses in the model.
• Configuration (JSON object): Model configuration JSON.

Only the following properties in model objects can be modified: Name, Description, ProjectId and Configuration.

All model statistics are calculated and stored to the model when the model is loaded into memory.

Methods

The models API has the following methods.

GET api/models GET

Gets the list of models (that are not deleted). Supported query parameter is projectId (integer, optional): project id to get models from (all existing models from all active projects are returned by default). Returns array of model objects that are accessible for the current user (can be empty if criteria specified by parameters is not matched).

GET api/models/{id}

Gets information of the model with given id. Returns the model object. If model doesn't exist, not found error is returned. If current user has no access to the model, unauthorized error is returned.

POST api/models

Creates a new empty model. Takes the model object in the body (whose read-only fields are ignored). Returns the created model object. If current user has no rights to create model, unauthorized error is returned.

PUT api/models/{id}

Updates information of the existing model with the given id. Supported query parameter is moveLinkedDatatables (boolean, true by default): flag whether to move linked data tables to the new project if model itself is moved, otherwise ignored. Takes the model object in the body (whose id should match the path parameter value and other read-only fields are ignored). If model doesn't exist, not found error is returned. If current user has no rights to modify the model, unauthorized error is returned.

DELETE api/models/{id}

Deletes the model with given id. Supported query parameter is deletePermanently (boolean, false by default): flag whether to delete the model permanently. If model doesn't exist, not found error is returned. If current user has no rights to delete the model, unauthorized error is returned.

GET api/models/export/{id}

Exports the model with given id to PACM format. Returns the model content as stream in PACM format (compressed). If model doesn't exist, not found error is returned. If current user has no access to the model, unauthorized error is returned.

POST /api/uielements/setproject/{projectid}

Support also models (will be used when multiple models are moved between projects). It also should support moveLinkedDatatables query parameter (see api/models/{id} PUT).

DELETE /qprpa/api/uielements

Support also models (will be used when multiple models are deleted). It also should support deletePermanently query parameter (see api/models/{id} DELETE).