Skip to main content
Этот отчёт представляет собой часть экспорта данных о соответствии требованиям по каждому сотруднику от предыдущего поставщика, относящуюся к обучению: идентификационные данные из каталога плюс одна строка на каждого сотрудника для каждого зачисления на обучение (статус модуля и даты). Детализация строится в длинном формате — сотрудник × назначение, — поскольку именно такие данные GET /v1/assignments/{id}/enrollments уже возвращает. Запрос не преобразует модули в столбцы.
Подтверждения ознакомления с политиками в этот отчёт не входят. В Living Security нет API для принятия политик, поэтому соответствующие устаревшие столбцы находятся вне области применения и не ожидают сопоставления. См. Отличия от устаревшего экспорта.
Настройка, учётные данные, постраничная выгрузка и повтор запросов при превышении лимита частоты такие же, как в руководстве по подключению Power BI / Excel. Сначала добавьте общий запрос Fn_FetchAll; этот отчёт вызывает его по имени.

Необходимые области действия ключа

Исходные конечные точки

Этот запрос не вызывает GET /v1/entities. Строка зачисления уже содержит email и display_name, а в списке сущностей нет подразделения и должности, поэтому его обход не заполнит столбцы каталога, которых нет в строке зачисления.

Гранулярность

Одна строка на зачисление (сотрудник × назначение). Если сотруднику назначен один и тот же курс через два назначения, получается две строки. Сотрудник без зачислений в отчёт не попадает: /v1 не может сформировать пригодную строку каталога без адреса электронной почты, а добавление строк только с данными сотрудника привело бы к смешению уровней детализации. Бюджет запросов: один постраничный проход на каждое назначение, последовательно, в рамках общего лимита частоты на ключ. Всегда задавайте limit = "500".

Сопоставление столбцов

Названия устаревших столбцов взяты из экспорта вашего предыдущего поставщика. Поля /v1 — это имена из публичного API; запрос переименовывает некоторые из них для отчёта. Ключи соединения, сохранённые для модели «звезда»: entity_id, assignment_id, course_id, user_assignment_id. Запрос также сохраняет course_slug, assignment_title, passed, attempts, assignment_lifecycle_status и assignment_created_at. enrollment_status — это прогресс обучающегося, а не жизненный цикл назначения (active / paused / completed).

Отличия от устаревшего экспорта

  • Данные о принятии политик недоступны. В этой платформе нет домена политик — нет ни /policies, ни /policy_acceptances, ни эквивалентного ресурса /v1. Не рассматривайте эти столбцы как ожидающие сопоставления. Они находятся вне области применения.
  • Дополнительные данные каталога опущены, а не заполняются значением null. Подразделение, должность, руководитель и местоположение отсутствуют в /v1. Запрос не создаёт для них пустые столбцы.
  • Срок выполнения включён, даже если его не было в устаревшем экспорте, поскольку Enrollment.due_at есть в API.
  • Название курса берётся преимущественно из каталога. Course.title — это название модуля. Assignment.title используется только при отсутствии строки каталога (удалённой или неопубликованной).
  • Длинный формат, без сводной таблицы. Одна строка на зачисление, а не одна строка на сотрудника со столбцом для каждого модуля.

Следующие шаги

Настройка Power BI и Excel

Учётные данные, постраничная выгрузка и загрузка этих запросов в Power BI или Excel.

Журнал фишинговых писем

Фишинговые взаимодействия на уровне событий за последние 12 месяцев.

Наиболее уязвимые пользователи

Сводка по каждому сотруднику за 12 месяцев: переходы по ссылкам, ввод учётных данных и сообщения о письмах.

Ключи API

Предоставьте training:read и course:read ключу, который обновляет этот отчёт.