sabyPosition.Update

sabyPosition.Update

Команда «sabyPosition.Update» создает новую должность или обновляет существующую. Поддерживает массовый вызов. Принимает массив объектов формата «Должность» с параметрами для записи или обновления.

Обновление должности происходит, если должность с переданными параметрами «ID» или «Title» уже существует. Если такой должности нет, она будет создана.

Метод не может изменить идентификатор уже существующей должности. Для смены идентификатора используйте sabyPosition.ChangeId.

Параметры запроса

Параметр
* — обязательный

Тип

Описание

positions

массив объектов

объекты формата «Должность»

Результат

В результате возвращается массив строк идентификаторов должностей, которые были записаны.

Если не пройдена валидация, вернется ошибка с описанием.

Комментарии

  1. Чтобы записать категорию, сначала создайте «Должность». Затем в запросе укажите параметр «Category» и передайте «ID» должности в поле «Parent».

    Если родительская должность изменится, у привязанных категорий автоматически обновятся параметры:

    • «Title» — название должности. Название категории «categoryTitle» при этом останется прежним;
    • «Clarification» — примечание;
    • «WorkSchedule.Title» — название графика рабочего времени.
  2. Запись привязывается к родительской по полю «Parent»:
    • чтобы создать запись в корне справочника, не заполняйте поле «Parent»;
    • чтобы вложить запись в другую, в поле «Parent» укажите UUID родительской записи;
    • должности, привязанные к другой родительской должности, считаются ее категориями;
    • должности можно привязать к группе;
    • группы можно привязывать только к другим группам для создания дерева папок.

    Никакие другие варианты связывания записей невозможны. Также невозможно привязать запись саму к себе (параметры «ID» и «Parent» должны отличаться).

Примеры запроса

Создание должности

Создание категории

Пример ответа

Ответ на запрос «Создание должности»

Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.