ИПР

Карточки индивидуального плана развития (ИПР) и персональной индивидуальной стратегии (ПИС): создание, чтение, изменение и жизненный цикл статусов.

Методы

Метод HTTP Назначение
ipr.ipr.list GET Список карточек ИПР/ПИС с фильтрацией и пагинацией
ipr.ipr.get GET Карточка ИПР по ID
ipr.ipr.add POST Создать ИПР/ПИС
ipr.ipr.update POST Изменить карточку
ipr.ipr.delete POST Удалить карточку
ipr.ipr.complete POST Завершить план (сотрудник) / карточку (руководитель, HR, админ)
ipr.ipr.approve POST Согласовать план или результат
ipr.ipr.reject POST Отклонить план или результат
ipr.ipr.reopen POST Вернуть карточку в работу
ipr.ipr.status.list GET Справочник статусов карточки
ipr.ipr.type.list GET Справочник типов карточки (IPR | PIS)
ipr.ipr.draft.add POST Проверить данные как в ipr.ipr.add, сохранить черновик и получить ссылку на предзаполненную форму создания
ipr.ipr.draft.get GET Черновик программы по ID

Черновики программы

Черновик — это проверенный набор данных ipr.ipr.add, сохранённый без создания карточки. ipr.ipr.draft.add выполняет те же проверки (права, сотрудник и руководитель, шаблон, лимит активных программ, даты) и возвращает url штатной формы создания ИПР с параметром DRAFT_ID. Форма открывается предзаполненной, карточку создаёт пользователь. Сценарий рассчитан на HR-ассистента: ассистент собирает данные, человек утверждает их в знакомом интерфейсе. Черновики не имеют срока действия: у автора хранится не более 50 неиспользованных (самые старые вытесняются при создании нового), использованные остаются как ссылка на созданную карточку.

Жизненный цикл статусов

NEW → SOGL → WORK → SOGL_RES → FINISHED
XML_ID Смысл
NEW Черновик
SOGL План на согласовании у руководителя
WORK В работе
SOGL_RES Результат на согласовании у руководителя
FINISHED Завершена

Переходы:

  • ipr.ipr.approve: NEW/SOGL → WORK (согласование плана), SOGL_RES → FINISHED (согласование результата)
  • ipr.ipr.complete: сотрудник переводит WORK → SOGL_RES; руководитель/HR/админ — сразу WORK → FINISHED
  • ipr.ipr.reject: SOGL/SOGL_RES → WORK
  • ipr.ipr.reopen: SOGL_RES → WORK (руководитель/HR/админ); FINISHED → WORK (только HR/админ)

Влияние переходов на бизнес-процесс (БП) карточки повторяет интерфейс:

Переход БП карточки
Любой переход в FINISHED (approve из SOGL_RES, complete администратором/руководителем/HR, update(status=FINISHED)) Останавливается
approve: NEW / SOGL → WORK Продвигается собственным событием «Согласовать» (БП сам ставит WORK и startFact, шлёт уведомления); если события нет или нет прав на него, WORK пишется напрямую
complete сотрудником (WORK → SOGL_RES), reject, reopen, update на любой статус, кроме FINISHED Не затрагивается

Расхождения с БП: reject из SOGL возвращает в WORK, тогда как собственное «На доработку» БП ведёт в NEW; после reopen из FINISHED кнопки БП «Завершение» нет — завершать нужно через REST.

Фактические даты

startFact и finishFact записываются только методом ipr.ipr.update (администратор). ipr.ipr.approve при переходе в WORK лишь заполняет пустой startFact текущим временем.

Публичное значение status — это XML_ID свойства STATUS инфоблока ИПР в верхнем регистре (1:1 с портальным значением).

Карточка в статусе FINISHED не может быть изменена (ipr.ipr.update) или удалена (ipr.ipr.delete) никем, включая администратора.

См. также

Предыдущая
ipr.schema
Следующая
ipr.ipr.list