Helper - Run tool.

API Url

Use it to execute tools

POST
http://localhost:16010/ProMarkREST/web/Helper/execution/{helper}

Permissions: user

Request headers

FieldTypeDescription
Accept-LanguageoptionalString

=en-GB Language use for localization.

X-ClientoptionalString

=Client type.

Allowed values:"Portal""Mobile""Admin"
X-RoleoptionalNumber

ProMark role (1: Employee, 2: User).

Allowed values:{12}
X-WebPart-IdoptionalNumber

Unique web-part identifier.

Parameter

FieldTypeDescription
  dataObject

Object containg data to be uploaded.

    toolsObject[]

A list of tools to be executed

      typeInteger

The type of the tool

Request example:

{
"request": {
"data":
{
"deleteAutoTransferredHolidays": {
"holidayType": "AUR2",
"holidayYear": 2023,
"update": true}
}
}
}

Success 200

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data.

    toolsObject[]

A list of tools execute

      executionInfoString

Information send back about the execution of the tool

      executionStatusInteger

Information send back about the status of the execution. 0 = Successful / 99 = Unsuccessful

      typeInteger

The type of the tool

  messageoptionalObject

Object containing response messages.

    codeNumber

Message code.

    textString

Message text.

    typeString

Type of message.

Allowed values:"warning""info"

Response example:

HTTP/1.1 200 OK
{
"response": {
"data": {
"executionInfo": "Finding/Removing auto transferred holiday transactions: 2024/05/24 13:55:50\n\nProcessing completed at 2024/05/24 13:55:50\nNothing changed",
"executionStatus": 0
}
}
}

Error 4xx

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data (empty).

  errorCodeNumber

Error code.

  errorMessageString

Error description.