/Methods/UpdateTask

<< Click to Display Table of Contents >>

Navigation:  API MasterSCADA 4D > Подключение к исполнительной системе по JSON > HTTP API MasterPLC > Работа со стандартным расписанием >

/Methods/UpdateTask

Изменяет существующее событие.

HTTP: POST /Methods/UpdateTask

Запрос

{
  "taskId": 100,
  "name": "Updated Task",
  "parentId": 0,
  "priority": 2,
  "rrule": "FREQ=HOURLY;INTERVAL=2",
  "exdate": ["20250812T080000"],
  "userSettings": { "execute": "weekends" },
  "enabled": true,
  "startDate": "20250820T080000",
  "endDate": "20250830T080000",
  "comment": "Update task",
  "action": {
    "type": "giveAnImpulse",
    "parameter": "Объекты.Насос.Пуск",
    "parameterId": 30818,
    "pulseDuration": 1000,
    "value": "true"
  },
  "color": "rgb(0,0,0)",
  "writeToArchive": false,
  "message": ""
}

Поля запроса

Поле

Тип

Обязательное

По умолчанию

Описание

taskId

integer

да

0

Id события в БД; не должен быть 0

rrule

string

да

""

Правило повторения; не должно быть пустым

остальные поля

нет

Совпадают с AddTask, кроме ключей расписания

Ответ

{
  "status": "success",
  "message": "Task updated successfully",
  "code": 0
}

Поля ответа

Поле

Тип

Условие

Описание

status

string

всегда

"success" или "error"

message

string

всегда

Текст результата или ошибки

code

integer

всегда

Результат метода

Поведение и ограничения

Пустой taskId"Task ID is required"; пустой rrule"RRule is empty" (обе — OpcUa_BadInvalidArgument).

Коды менеджера отображаются в сообщения: OpcUa_BadNotFound"Task id is not found"; OpcUa_BadInvalidArgument"Invalid parameter id"; OpcUa_BadInternalError"Database archive error"; OpcUa_BadTimeout"Timeout waiting for response from database".

Проверка существования параметра действия в этом методе отключена (в отличие от AddTask).