QPR ProcessAnalyzer API: Difference between revisions

From QPR ProcessAnalyzer Wiki
Jump to navigation Jump to search
No edit summary
Line 25: Line 25:
* [[Web_API_for_Models|models]]
* [[Web_API_for_Models|models]]
* [[Web_API_for_User_Management|user management]]
* [[Web_API_for_User_Management|user management]]
== WCF API ==
All WCF API operations only accept HTTP POST method (HTTP GET is not allowed). WCF API can be used with ''wsHttp'' (SOAP) and ''webHttp'' endpoints.
The following methods are available in the WCF API:
* [[QPR ProcessAnalyzer API: Authenticate|Authenticate]]: Tries to authenticate given user with given password and authentication parameters.
* [[QPR ProcessAnalyzer API: GetStream|GetStream]] can be used to query contents of a stream bound to the given session identified by given stream id.
* [[QPR ProcessAnalyzer API: LogOff|LogOff]]: Logs off the user session.
* [[QPR ProcessAnalyzer API: RunScript|RunScript]] can be used to execute given script using given parameters.


== WCF API Usage Examples ==
== WCF API Usage Examples ==

Revision as of 00:05, 9 February 2021

QPR ProcessAnalyzer API's can be used to automate operations in process mining or create integration with other applications. QPR ProcessAnalyzer has REST-based Web API.

Web API

The API is a JSON based API using the REST design principle. All operations require a prior login which is done with the Token operation with username and password (the access token is returned as a response for a successful login). All operations (except the Token) need to have a HTTP request header Authorization with value Bearer <access token> in place to identify the session.

Url for calling the API has the following form (replace the DNS name with a correct one):

https://customer.onqpr.com/qprpa/api/<operationName>

Following operations are available:

  • token: Login user using username and password, and get a session token as a response.
  • signout: Logs out a session.
  • expression/query: Runs query written using the expression language and returns results as a response.
  • cancel: Cancels currently running operation.
  • filters: Get all filters in system or filters in a model.
  • serverinfo: Gets the default UI language in whether SSO has been configured.
  • importfile: Import data into models and datatables from .csv, .xes and .pacm files.
  • usersettings: Save user specific settings to the server.
  • operations/terminate: Terminates selected operations (i.e. end tasks).

In addition, there are Web API operations for

WCF API Usage Examples

JavaScript Examples

//login                 
$.ajax({
  "method": "POST",
  "url": "http://localhost/qprpa/Mainservice.svc/webHttp/Authenticate",
  "dataType": "json", "contentType": "application/json; charset=utf-8",
  "data": JSON.stringify({
    'logOnName': '<username>',
    'password': '<password>',
    'parameters': ''
  })
});                       
//log off
$.ajax({
  "method": "POST",
  "url": "http://localhost/qprpa/Mainservice.svc/webHttp/LogOff",
  "dataType": "json", "contentType": "application/json; charset=utf-8",
  "data": JSON.stringify({ 
    "sessionId": sessionId
  })
});

PowerShell Example: Move Data from QPR ProcessAnalyzer to Database using PowerShell