QPR ProcessAnalyzer API: Difference between revisions

From QPR ProcessAnalyzer Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
QPR ProcessAnalzyer Web Service Application Programming Interface can be used to automate operations, and to create integration with other applications.
QPR ProcessAnalzyer Web Service API (Application Programming Interface) can be used to automate operations and to create integration with other applications.


== Functions ==
== Functions ==
The following functions are available in QPR ProcessAnalyzer Web Service API:
The following functions are available in QPR ProcessAnalyzer Web Service API:


=== [[QueryObjectProperties (API)|QueryObjectProperties]] ===
* [[QueryObjectProperties (API)|QueryObjectProperties]] returns all the listed properties queried for all the listed objects identified by [[Unique Identifier|unique identifiers]].
The [[QueryObjectProperties (API)|QueryObjectProperties]] function returns all the listed properties queried for all the listed objects identified by [[Unique Identifier|unique identifiers]].
* [[ValidateModel (API)|ValidateModel]] can be used to perform all the pending tasks stored in the work queue of the given model.


=== [[ValidateModel (API)|ValidateModel]] ===
== Object Types and Their Properties ==
The [[ValidateModel (API)|ValidateModel]] function can be used to perform all the pending tasks stored in the work queue of the given model.
* [[Common Supported Properties (API)|Common Properties for Object Types]]
 
* [[DataTable (API)|DataTable]]
== Object Types and Their Supported Properties ==
* [[Product (API)|Product]]
 
* [[Project (API)|Project]]
=== [[Common Supported Properties (API)|Common Supported Properties for Object Types]] ===
=== [[DataTable (API)|'DataTable' Object Type]] ===
=== [[Product (API)|'Product' Object Type]] ===
=== [[Project (API)|'Project' Object Type]] ===


== Identifying QPR ProcessAnalyzer Objects ==
== Identifying QPR ProcessAnalyzer Objects ==
[[Unique Identifier|Unique identifiers]] are used to identify any object in a QPR ProcessAnalyzer database.
QPR ProcessAnalyzer unique identifiers are used to uniquely identify any object in QPR ProcessAnalyzer. The format of a unique identifier is:


'''PA.<type>.<object>'''


== Example ==
In the format, '''<type>''' can be any of the following:
* 0: undefined (reserved, do not use)
* 1: project
* 2: data table
* 3: model
* 4: filter
* 5: bookmark


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


//create user
//create user
$.ajax({
$.ajax({
"method": "POST",
  "method": "POST",
"url": "http://localhost/qprpa/Mainservice.svc/webHttp/SetUser",
  "url": "http://localhost/qprpa/Mainservice.svc/webHttp/SetUser",
"dataType": "json", "contentType": "application/json; charset=utf-8",
  "dataType": "json", "contentType": "application/json; charset=utf-8",
                            "data": JSON.stringify({  
  "data": JSON.stringify({  
                            "sessionId":"547c1aa5-e85b-4642-bbb1-8cb656015002",
    "sessionId": "547c1aa5-e85b-4642-bbb1-8cb656015002",
                            "user":{"Name": "user", "FullName": "first last" },
    "user": {"Name": "user", "FullName": "first last" },
                            "parameters":[{"Key": "Password", "Value": "demo"}]
    "parameters": [{"Key": "Password", "Value": "demo"}]
                            })
  })
});
});


//add user to group, value 8:12:0 is user:group:member type
//add user to group, value 8:12:0 is user:group:member type
$.ajax({
$.ajax({
"method": "POST",
  "method": "POST",
"url": "http://localhost/qprpa/Mainservice.svc/webHttp/ModifyUserRelations",
  "url": "http://localhost/qprpa/Mainservice.svc/webHttp/ModifyUserRelations",
"dataType": "json", "contentType": "application/json; charset=utf-8",
  "dataType": "json", "contentType": "application/json; charset=utf-8",
                            "data": JSON.stringify({  
  "data": JSON.stringify({  
                            "sessionId":"749dcbdb-e57b-434b-a739-1f4ddc7ebc30",
    "sessionId": "749dcbdb-e57b-434b-a739-1f4ddc7ebc30",
                            "parameters":[{"Key": "AddGroups", "Value": "8:12:0"}]
    "parameters": [{"Key": "AddGroups", "Value": "8:12:0"}]
                            })
  })
});
});


//log off
//log off
$.ajax({
$.ajax({
"method": "POST",
  "method": "POST",
"url": "http://localhost/qprpa/Mainservice.svc/webHttp/LogOff",
  "url": "http://localhost/qprpa/Mainservice.svc/webHttp/LogOff",
"dataType": "json", "contentType": "application/json; charset=utf-8",
  "dataType": "json", "contentType": "application/json; charset=utf-8",
                            "data": JSON.stringify({  
  "data": JSON.stringify({  
                            "sessionId":"75aa3d08-5ad9-4b0b-8981-7daca98348cd"
    "sessionId":"75aa3d08-5ad9-4b0b-8981-7daca98348cd"
                            })
  })
});
});
</pre>
</pre>


== Power Shell Example of listing users ==
== Power Shell Example of listing users ==
Line 81: Line 85:
$paService | get-member | ? {$_.definition -match "GetAnalysis"}
$paService | get-member | ? {$_.definition -match "GetAnalysis"}
</pre>
</pre>
[[Category:Web Service API]]

Revision as of 15:44, 5 February 2018

QPR ProcessAnalzyer Web Service API (Application Programming Interface) can be used to automate operations and to create integration with other applications.

Functions

The following functions are available in QPR ProcessAnalyzer Web Service API:

Object Types and Their Properties

Identifying QPR ProcessAnalyzer Objects

QPR ProcessAnalyzer unique identifiers are used to uniquely identify any object in QPR ProcessAnalyzer. The format of a unique identifier is:

PA.<type>.<object>

In the format, <type> can be any of the following:

  • 0: undefined (reserved, do not use)
  • 1: project
  • 2: data table
  • 3: model
  • 4: filter
  • 5: bookmark

Example Usage

//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': ''
  })
});                       

//create user
$.ajax({
  "method": "POST",
  "url": "http://localhost/qprpa/Mainservice.svc/webHttp/SetUser",
  "dataType": "json", "contentType": "application/json; charset=utf-8",
  "data": JSON.stringify({ 
    "sessionId": "547c1aa5-e85b-4642-bbb1-8cb656015002",
    "user": {"Name": "user", "FullName": "first last" },
    "parameters": [{"Key": "Password", "Value": "demo"}]
  })
});

//add user to group, value 8:12:0 is user:group:member type
$.ajax({
  "method": "POST",
  "url": "http://localhost/qprpa/Mainservice.svc/webHttp/ModifyUserRelations",
  "dataType": "json", "contentType": "application/json; charset=utf-8",
  "data": JSON.stringify({ 
    "sessionId": "749dcbdb-e57b-434b-a739-1f4ddc7ebc30",
    "parameters": [{"Key": "AddGroups", "Value": "8:12:0"}]
  })
});

//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":"75aa3d08-5ad9-4b0b-8981-7daca98348cd"
  })
});

Power Shell Example of listing users

$paService=New-WebServiceProxy –Uri “http://localhost/qprpa/MainService.svc ”
$connection=$paService.Authenticate("username","password",@())
$token=$connection.GetValue(0).Value
$token
$param=@()
$users=$paService.GetUsers($token,$null,$param)
$users
$paService | get-member | ? {$_.definition -match "GetAnalysis"}