System - Update job details

API Url

Used to update job details.

PUT
http://localhost:16010/ProMarkREST/rest/System/jobs/{jobNo}/details

Permissions: user

Path parameters

FieldTypeDescription
jobNoNumber

Job number.

Parameter

FieldTypeDescription
requestObject

Main object containing the request data.

  dataObject

Object containg data to be uploaded.

    recurrenceObject

The recurrence setup. Only for 'Recurrent' reports.

      dailyoptionalObject

Setup for daily executions.

        calendarDaysBoolean

Daily execution should be only in calendar days (true=Calendar days, false=Working days).

        everyNumber

Repeat every X days.

      hourlyoptionalObject

Setup for hourly executions.

        endNumber

End of activation interval used with Hourly schedule

        everyNumber

Repeat every X hours

        hoursListNumber

A list of hours when to Run the job (max 5). Only for 'type' = 2.

Size range: 5
        startNumber

Start of activation interval used with Hourly schedule

        typeNumber

Type of hourly setup 1 - Repeat X hours 2 - Fixed hours list

        weekDaysBoolean

Weekdays when report is to be executed, starting with Sunday.

Size range: 7
      monthlyoptionalObject

Setup for monthly executions.

        absoluteDayNumber

Day of month to run on. Only when 'onAbsoluteDay'=true.

Size range: 1-31
        everyNumber

Repeat every X months.

        onAbsoluteDayBoolean

true=Repeat on a specific day, false=Repeat on a relative day.

        relativeDayNumber

Relative day of month to run on (1=First, 2=Second, 3=Third, 4=Forth, 5=Last). Only when 'onAbsoluteDay'=false.

Size range: 1-5
        relativeWeekdayNumber

Relative weekday of month to run on (1=Sun, 2=Mon, 3=Tue, 4=Wed, 5=Thu, 6=Fri, 7=Sat). Used together with 'relativeDay'. Only when 'onAbsoluteDay'=false.

Size range: 1-7
      repeatUnitNumber

Repeat execution (1=Daily, 2=Weekly, 3=Monthly, 4=Yearly, 5=Hourly).

      startDate

First day of recurrence.

      timeNumber

Time of day when report needs to be executed, expressed in seconds from midnight.

      weeklyoptionalObject

Setup for weekly executions.

        everyNumber

Repeat every X weeks.

        weekDaysBoolean

Weekdays when report is to be executed, starting with Sunday.

Size range: 7
      yearlyoptionalObject

Setup for yearly executions.

        absoluteDayNumber

Day of month to run on. Used together with 'month'. Only when 'onAbsoluteDay'=true.

Size range: 1-31
        monthNumber

Month of year when to run the report (1=Jan, 2=Feb, 3=Mar ...). Only when 'onAbsoluteDay'=true.

Size range: 1-12
        onAbsoluteDayBoolean

true=Repeat on a specific month & day, false=Repeat on a relative month & day.

        relativeDayNumber

Relative day of month to run on (1=First, 2=Second, 3=Third, 4=Forth, 5=Last). Only when 'onAbsoluteDay'=false.

Size range: 1-5
        relativeWeekdayNumber

Relative weekday of month to run on (1=Sun, 2=Mon, 3=Tue, 4=Wed, 5=Thu, 6=Fri, 7=Sat). Used together with 'relativeDay'. Only when 'onAbsoluteDay'=false.

Size range: 1-7

Success example with a single shift:

HTTP/1.1 200 OK
{
"response": {
"erorCode": 0,
"errorMessage": ""
}
}

Error 4xx

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data (empty).

  errorCodeNumber

Error code.

  errorMessageString

Error description.

Error example:

HTTP/1.1 404 Not found
{
"response": {
"errorCode": 1,
"errorMessage": "Job not found."
}
}