Метод создает новую должность или обновляет существующую. Поддерживает массовый вызов. Принимает массив объектов формата «Должность» с параметрами для записи или обновления.
Обновление должности происходит, если должность с переданными параметрами «ID» или «Title» уже существует. Если такой должности нет, она будет создана.
Метод не может изменить идентификатор уже существующей должности.
Параметры запроса
Параметр | Тип | Описание | |
positions | массив объектов | объекты формата «Должность» | |
Результат
В результате возвращается массив строк идентификаторов должностей, которые были записаны.
Если не пройдена валидация, вернется ошибка с описанием.
Комментарии
- Чтобы записать категорию, сначала создайте «Должность». Затем в запросе укажите параметр «Category» и передайте «ID» должности в поле «Parent».
Если родительская должность изменится, у привязанных категорий автоматически обновятся параметры:
- «Title» — название должности. Название категории «categoryTitle» при этом останется прежним;
- «Clarification» — примечание;
- «WorkSchedule.Title» — название графика рабочего времени.
- Запись привязывается к родительской по полю «Parent»:
- чтобы создать запись в корне справочника, не заполняйте поле «Parent»;
- чтобы вложить запись в другую, в поле «Parent» укажите UUID родительской записи;
- должности, привязанные к другой родительской должности, считаются ее категориями;
- должности можно привязать к группе;
- группы можно привязывать только к другим группам для создания дерева папок.
Никакие другие варианты связывания записей невозможны. Также невозможно привязать запись саму к себе (параметры «ID» и «Parent» должны отличаться).