QPR MEA Integration

QPR ProcessAnalyzer is able to establish a connection to a QPR MEA (QPR Suite) instance, and call Web Service operations.

MEA Web Service documentation: https://kb.qpr.com/qpr2025-1/qpr_web_service.html

MEA Connection String

To connect to QPR MEA, a MEA connection string needs to be created and stored as a secret.

The MEA connection string is a json object with following properties:

• url: URL to the webHttp endpoint of the QPR MEA Web Service to be connected to.
• logOnName: Log on name of the user who will access the QPR MEA Web Service.
• password: User's password in QPR MEA.

Example connection string:

{ "url": "https://<hostname>/QPR/Portal/QPR.Isapi.dll/wsforward/MainService.svc/webHttp", "logOnName": "MyUser", "password": "MyPassword" }

Operations

CreateObject

Performs CreateObject function call (https://kb.qpr.com/qpr2025-1/createobject2.html), and returns the MEA ID of the created object.

Parameters:

• namespaceId (String): MEA ID of the namespace into which the object is to be created.
• objectTypeName (String): Defines the type of the new object.
• name (String): Defines name for the new object.
• parentIds (String or String*): MEA ID of parent object. If array is given, every array element specifies one ID.
• attributes (Dictionary): Key/value pairs of <attribute>/<attribute value> to be set for the created object.
• options (String): Optional options for the query. See https://kb.qpr.com/qpr2025-1/parameters_and_options.html?anchor=options

Example: Connects to the configured QPR MEA and creates a new top-level comment-action.

ProjectByName("TestProject")
  .CreateMeaConnection(#{"ConnectionStringKey": "MeaConnection"})
  .CreateObject("PO", "Comment", "Test comment", "", #{"description": "Test comment description"});

DeleteObject

Performs DeleteObject function call (https://kb.qpr.com/qpr2025-1/deleteobject2.html) and returns _empty.

Parameters:

• objectIds (String or String*): One or more MEA IDs of objects to be deleted. If array is given, every array element specifies one ID of object to be deleted.
• options (String): Optional options for the query. See https://kb.qpr.com/qpr2025-1/parameters_and_options.html?anchor=options.

ProjectByName("TestProject")
  .CreateMeaConnection(#{"ConnectionStringKey": "MeaConnection"})
  .DeleteObject("PO.0.985518423");

Connects to the configured QPR MEA and deletes object with ID PO.0.985518423.

GetAttribute

Performs GetAttributeAsString function call (https://kb.qpr.com/qpr2025-1/getattributeasstring.html), and returns the value of given object's attribute as a string.

Parameters:

• objectId (String): MEA ID of an object from which the attribute is fetched.
• attribute (String): Name of the attribute that is queried. See [supported attributes](https://kb.qpr.com/qpr2025-1/supported_parameters.html).
• options (String): Optional options for the query. See (https://kb.qpr.com/qpr2025-1/parameters_and_options.html?anchor=options.

Example: Connects to the configured QPR MEA and returns the name of object identified by MEA object ID: PG.785401983.683494101.

ProjectByName("TestProject")
  .CreateMeaConnection(#{"ConnectionStringKey": "MeaConnection"})
  .GetAttribute(
    "[PG.785401983.683494101]",
    "name"
  );

QueryObjects

Performs QueryObjects function call (https://kb.qpr.com/qpr2025-1/queryobjects.html), and returns the result of the query as a hierarchical dictionary object (#48320#) following the hierarchy of ResultSet-object returned by QPR MEA.

Parameters:

• query (String): The actual query. For more information, see the [query syntax documentation](https://kb.qpr.com/qpr2025-1/query_syntax.html)
• attributes (String): Comma-separated list of attributes that are included in the results.

     2. See [supported attributes](https://kb.qpr.com/qpr2025-1/supported_parameters.html).

• criteria (String): Criteria used to filter the results by.

     2. See https://kb.qpr.com/qpr2025-1/parameters_and_options.html?anchor=globalparameters.

• sortBy (String): Comma-separated list of attributes to sort the results by.
• options (String): Optional options for the query. See https://kb.qpr.com/qpr2025-1/parameters_and_options.html?anchor=options.

Example: Connects to the configured QPR MEA and returns name and typename of all the subprocesses in model identified by MEA object id PG.1374444994 whose name contains text "Account". Results are ordered by name and only at most three results are returned.

ProjectByName("TestProject")
  .CreateMeaConnection(#{"ConnectionStringKey": "MeaConnection"})
  .QueryObjects(
    "[PG.1374444994].Subprocess",
    "name, typename",
    `Find("Account", Name)`,
    "name",
    "MaxCount=3"
  );

SetAttribute

Performs SetAttribute (https://kb.qpr.com/qpr2025-1/setattribute.html) function call to set an attribute value.

Parameters:

• objectIds (String or String*): MEA ID of an object from which the attribute is fetched. If array is given, every array element specifies one ID.
• attribute (String): Name of the attribute that is queried. See [supported attributes](https://kb.qpr.com/qpr2025-1/supported_parameters.html). Attribute must be writeable.
• value (String): Value to be set for given object's attribute.
• options: Optional options for the query. See https://kb.qpr.com/qpr2025-1/parameters_and_options.html?anchor=options.

Example: Connects to the configured QPR MEA and changes the name of the user identified by MEA object ID: UM.0.123 to "ChangedUser".

ProjectByName("TestProject")
  .CreateMeaConnection(#{"ConnectionStringKey": "MeaConnection"})
  .SetAttribute(
    "[UM.0.123]",
    "name",
    "ChangedUser"
  );