Web API for Models - Revision history

Ollvihe: /* Model Entity */

2024-10-16T10:50:46Z

Model Entity

← Older revision		Revision as of 10:50, 16 October 2024
Line 18:		Line 18:
	* NCaseAttributes (integer): Number of case attributes in the model.		* NCaseAttributes (integer): Number of case attributes in the model.
	* NEventAttributes (integer): Number of event 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.		* NAnalyses (integer): Number of analyses in the model.
	* Configuration (JSON object): Model configuration JSON.		* Configuration (JSON object): Model configuration JSON.

Ollvihe: /* Methods */

2022-04-29T09:13:23Z

Methods

← Older revision		Revision as of 09:13, 29 April 2022
Line 47:		Line 47:
	PUT api/models/{id}		PUT api/models/{id}
	</pre>		</pre>
	Updates properties of an existing model with the given id~~. Supports optional query parameter ''moveLinkedDatatables'' (boolean, true by default), which indicates whether to move linked data tables to the new project if model itself is moved~~. The method takes the model entity in the body (model id in the entity should match the model id given in url). If model doesn't exist, not found error is returned. If current user has no rights to modify the model, unauthorized error is returned.		Updates properties of an existing model with the given id. The method takes the model entity in the body (model id in the entity should match the model id given in url). If model doesn't exist, not found error is returned. If current user has no rights to modify the model, unauthorized error is returned.

	<pre>		<pre>

Ollvihe: /* Methods */

2020-11-01T16:43:34Z

Methods

← Older revision		Revision as of 16:43, 1 November 2020
Line 47:		Line 47:
	PUT api/models/{id}		PUT api/models/{id}
	</pre>		</pre>
	Updates properties of an existing model with the given id. Supports optional query parameter ''moveLinkedDatatables'' (boolean, true by default), which ~~is a flag~~ whether to move linked data tables to the new project if model itself is moved. The method takes the model entity in the body (model id in the entity should match the model id given in url). If model doesn't exist, not found error is returned. If current user has no rights to modify the model, unauthorized error is returned.		Updates properties of an existing model with the given id. Supports optional query parameter ''moveLinkedDatatables'' (boolean, true by default), which indicates whether to move linked data tables to the new project if model itself is moved. The method takes the model entity in the body (model id in the entity should match the model id given in url). If model doesn't exist, not found error is returned. If current user has no rights to modify the model, unauthorized error is returned.

	<pre>		<pre>
	DELETE api/models/{id}		DELETE api/models/{id}
	</pre>		</pre>
	Deletes a model with given id. Supports optional query parameter ''deletePermanently'' (boolean, false by default), which ~~is a flag~~ whether to delete the model permanently. If the model doesn't exist, not found error is returned. If current user has no rights to delete the model, unauthorized error is returned.		Deletes a model with given id. Supports optional query parameter ''deletePermanently'' (boolean, false by default), which indicates whether to delete the model permanently. If the model doesn't exist, not found error is returned. If current user has no rights to delete the model, unauthorized error is returned.

	<pre>		<pre>

Ollvihe: /* Methods */

2020-11-01T16:34:17Z

Methods

← Older revision		Revision as of 16:34, 1 November 2020
Line 37:		Line 37:
	GET api/models/{id}		GET api/models/{id}
	</pre>		</pre>
	Gets model entity by the model id. If model doesn't exist, not found error is returned. If current user has no access to the model, unauthorized error is returned.		Gets a model entity by the model id. If model doesn't exist, not found error is returned. If current user has no access to the model, unauthorized error is returned.

	<pre>		<pre>
Line 47:		Line 47:
	PUT api/models/{id}		PUT api/models/{id}
	</pre>		</pre>
	Updates properties of an existing model with the given id. Supports query parameter ''moveLinkedDatatables'' (boolean, true by default), which is a flag whether to move linked data tables to the new project if model itself is moved. The method takes the model entity in the body (model id in the entity should match the model id given in url). If model doesn't exist, not found error is returned. If current user has no rights to modify the model, unauthorized error is returned.		Updates properties of an existing model with the given id. Supports optional query parameter ''moveLinkedDatatables'' (boolean, true by default), which is a flag whether to move linked data tables to the new project if model itself is moved. The method takes the model entity in the body (model id in the entity should match the model id given in url). If model doesn't exist, not found error is returned. If current user has no rights to modify the model, unauthorized error is returned.

	<pre>		<pre>
	DELETE api/models/{id}		DELETE api/models/{id}
	</pre>		</pre>
	Deletes a model with given id. Supports query parameter ''deletePermanently'' (boolean, false by default), which is a 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.		Deletes a model with given id. Supports optional query parameter ''deletePermanently'' (boolean, false by default), which is a flag whether to delete the model permanently. If the model doesn't exist, not found error is returned. If current user has no rights to delete the model, unauthorized error is returned.

	<pre>		<pre>

Ollvihe at 16:31, 1 November 2020

2020-11-01T16:31:58Z

← Older revision		Revision as of 16:31, 1 November 2020
Line 1:		Line 1:
	Models API is used to create models, delete models and edit model properties. Data import is not done using the models API, but data is imported directly to the datatables used by the model.		Models API is used to create models, delete models and edit model properties. Data import is not done using the models API, but data is imported directly to the datatables used by the model.

	Note ~~also~~ that the [[Web API for Workspace Elements\|Workspace Elements API]] supports models.		Note that the [[Web API for Workspace Elements\|Workspace Elements API]] supports also models.

	==Model Entity==		==Model Entity==

Ollvihe at 16:23, 1 November 2020

2020-11-01T16:23:16Z

← Older revision		Revision as of 16:23, 1 November 2020
Line 1:		Line 1:
	Models API is used to create models, delete models and edit model properties. Data import is not done using the models API, but data is imported directly to the datatables used by the model.		Models API is used to create models, delete models and edit model properties. Data import is not done using the models API, but data is imported directly to the datatables used by the model.

			Note also that the [[Web API for Workspace Elements\|Workspace Elements API]] supports models.

	==Model Entity==		==Model Entity==

Ollvihe: /* Methods */

2020-11-01T16:22:40Z

Methods

@@ Line 56: / Line 56: @@
 </pre>
 Exports the model with given id as PACM format. Returns the model content as a stream in the PACM format. If model doesn't exist, not found error is returned. If current user has no access to the model, unauthorized error is returned.
 [[Category: QPR ProcessAnalyzer]]

Ollvihe at 16:18, 1 November 2020

2020-11-01T16:18:08Z

← Older revision		Revision as of 16:18, 1 November 2020
Line 35:		Line 35:
	GET api/models/{id}		GET api/models/{id}
	</pre>		</pre>
	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.		Gets model entity by the model id. If model doesn't exist, not found error is returned. If current user has no access to the model, unauthorized error is returned.

	<pre>		<pre>
	POST api/models		POST api/models
	</pre>		</pre>
	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.		Creates a new empty model. Takes the model entity in the body (read-only properties are ignored). Returns the created model entity. If current user has no rights to create model, unauthorized error is returned.

	<pre>		<pre>
	PUT api/models/{id}		PUT api/models/{id}
	</pre>		</pre>
	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.		Updates properties of an existing model with the given id. Supports query parameter ''moveLinkedDatatables'' (boolean, true by default), which is a flag whether to move linked data tables to the new project if model itself is moved. The method takes the model entity in the body (model id in the entity should match the model id given in url). If model doesn't exist, not found error is returned. If current user has no rights to modify the model, unauthorized error is returned.

	<pre>		<pre>
	DELETE api/models/{id}		DELETE api/models/{id}
	</pre>		</pre>
	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.		Deletes a model with given id. Supports query parameter ''deletePermanently'' (boolean, false by default), which is a 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.

	<pre>		<pre>
	GET api/models/export/{id}		GET api/models/export/{id}
	</pre>		</pre>
	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.		Exports the model with given id as PACM format. Returns the model content as a stream in the PACM format. If model doesn't exist, not found error is returned. If current user has no access to the model, unauthorized error is returned.

	<pre>		<pre>
	POST /api/uielements/setproject/{projectid}		POST /api/uielements/setproject/{projectid}
	</pre>		</pre>
	~~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~~).		Supports also models, and the ''moveLinkedDatatables'' query parameter (see PUT api/models/{id}).

	<pre>		<pre>
	DELETE /qprpa/api/uielements		DELETE /qprpa/api/uielements
	</pre>		</pre>
	Support also models ~~(will be used when multiple models are deleted). It also should support~~ ''deletePermanently'' query parameter (see api/models/{id} ~~DELETE~~).		Support also models, and the ''deletePermanently'' query parameter (see DELETE api/models/{id}).

	[[Category: QPR ProcessAnalyzer]]		[[Category: QPR ProcessAnalyzer]]

Ollvihe at 16:12, 1 November 2020

2020-11-01T16:12:16Z

← Older revision		Revision as of 16:12, 1 November 2020
Line 1:		Line 1:
	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.		Models API is used to create models, delete models and edit model properties. Data import is not done using the models API, but data is imported directly to the datatables used by the model.

	==Model Entity==		==Model Entity==
	The models API is based on the ~~'''model'''~~ entity, which has the following properties:		The models API is based on the Model entity, which has the following properties:
	* Id (integer): model id.		* 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.		* ProjectId (integer): Id of the project where the model is located. The model is moved to another project by changing this property.
	* Name (string): Model name.		* Name (string): Model name.
	* Description (string): Model description.		* Description (string): Model description.
	* CreatedDate (datetime): Model creation date.		* CreatedDate (datetime): Model creation date.
	* CreatorId (integer): Model creator user id.		* CreatorId (integer): Model creator user id.
	* LastModifiedDate (datetime): Model last modification date		* LastModifiedDate (datetime): Model last modification date.
	* LastModifierId (integer): Model last modifier user id		* LastModifierId (integer): Model last modifier user id.
	* NCases (integer): ~~number~~ of cases in the model.		* NCases (integer): Number of cases in the model.
	* NEvents (integer): ~~number~~ of events in the model.		* NEvents (integer): Number of events in the model.
	* NEventTypes (integer): ~~number~~ of event types in the model.		* NEventTypes (integer): Number of event types in the model.
	* NCaseAttributes (integer): ~~number~~ of case attributes in the model.		* NCaseAttributes (integer): Number of case attributes in the model.
	* NEventAttributes (integer): ~~number~~ of event attributes in the model.		* NEventAttributes (integer): Number of event attributes in the model.
	* NFilters (integer): ~~number~~ of filters in the model.		* NFilters (integer): Number of filters in the model.
	* NAnalyses (integer): ~~number~~ of analyses in the model.		* NAnalyses (integer): Number of analyses in the model.
	* Configuration (JSON object): Model configuration JSON.		* Configuration (JSON object): Model configuration JSON.

	~~Only the~~ following properties in model objects can be modified: Name, Description, ProjectId and Configuration.		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.		All object counts properties are calculated and stored to the model when the model is loaded into memory.

	==Methods==		==Methods==
Line 30:		Line 30:
	GET api/models GET		GET api/models GET
	</pre>		</pre>
	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).		Gets a list of all not deleted models in the system (if no parameter is provided). Supports optional query parameter ''projectId'' which is project id where to get models from.

	<pre>		<pre>
Line 66:		Line 66:
	</pre>		</pre>
	Support also models (will be used when multiple models are deleted). It also should support ''deletePermanently'' query parameter (see api/models/{id} DELETE).		Support also models (will be used when multiple models are deleted). It also should support ''deletePermanently'' query parameter (see api/models/{id} DELETE).

			[[Category: QPR ProcessAnalyzer]]

Ollvihe: Created page with "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..."

2020-10-30T23:40:19Z

Created page with "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..."

New page

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.

<pre>
GET api/models GET
</pre>
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).

<pre>
GET api/models/{id}
</pre>
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.

<pre>
POST api/models
</pre>
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.

<pre>
PUT api/models/{id}
</pre>
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.

<pre>
DELETE api/models/{id}
</pre>
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.

<pre>
GET api/models/export/{id}
</pre>
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.

<pre>
POST /api/uielements/setproject/{projectid}
</pre>
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).

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