Skip to main content
Este relatório corresponde à parte de treinamento da exportação de conformidade por pessoa de um provedor anterior: identidade do diretório mais uma linha por pessoa por matrícula em treinamento (status e datas do módulo). A granularidade é em formato longo — pessoa × atribuição — porque é isso que GET /v1/assignments/{id}/enrollments já retorna. A consulta não transforma os módulos em colunas (pivot).
As confirmações de leitura de políticas não fazem parte deste relatório. A Living Security não possui API de aceite de políticas; portanto, essas colunas legadas estão fora do escopo e não representam um mapeamento pendente. Consulte Divergências em relação à exportação legada.
A configuração, as credenciais, a paginação e a nova tentativa em caso de limite de taxa são as mesmas do guia de conectividade com Power BI / Excel. Adicione primeiro a consulta Fn_FetchAll compartilhada; este relatório a chama pelo nome.

Escopos de chave necessários

Endpoints de origem

Esta consulta não chama GET /v1/entities. A linha de matrícula já traz email e display_name, e a lista de entidades não possui departamento nem cargo — portanto, percorrê-la não preencheria colunas de diretório que a linha de matrícula já não tenha.

Granularidade

Uma linha por matrícula (pessoa × atribuição). Uma pessoa atribuída ao mesmo curso por meio de duas atribuições gera duas linhas. Uma pessoa sem matrículas não aparece — /v1 não consegue gerar uma linha de diretório utilizável sem email, e inventar linhas apenas com a pessoa misturaria granularidades. Orçamento de requisições: uma varredura paginada por atribuição, de forma sequencial, dentro do limite de taxa compartilhado por chave. Defina sempre limit = "500".

Mapeamento de colunas

Os nomes das colunas legadas são da exportação do seu provedor anterior. Os campos de /v1 são os nomes da API pública; a consulta atribui aliases a alguns deles para o relatório. Chaves de junção mantidas para um modelo em estrela: entity_id, assignment_id, course_id, user_assignment_id. A consulta também mantém course_slug, assignment_title, passed, attempts, assignment_lifecycle_status e assignment_created_at. enrollment_status é o progresso do aprendiz, não o ciclo de vida da atribuição (active / paused / completed).

Divergências em relação à exportação legada

  • Os aceites de políticas não estão disponíveis. Esta plataforma não possui domínio de políticas — não há /policies, /policy_acceptances nem recurso /v1 equivalente. Não trate essas colunas como um mapeamento pendente. Elas estão fora do escopo.
  • Os dados adicionais do diretório são omitidos, não preenchidos com nulo. Departamento, cargo, gestor e localização não constam em /v1. A consulta não inventa colunas vazias para eles.
  • A data de vencimento é incluída mesmo que a exportação legada não a tivesse, porque Enrollment.due_at está disponível na API.
  • O nome do curso dá preferência ao título do catálogo. Course.title é o nome do módulo. Assignment.title é usado somente quando a linha do catálogo está ausente (excluída ou não publicada).
  • Formato longo, sem pivot. Uma linha por matrícula, não uma linha por pessoa com uma coluna por módulo.

Próximas etapas

Configuração do Power BI e do Excel

Credenciais, paginação e carregamento destas consultas no Power BI ou no Excel.

Log de phishing por email

Interações de phishing em nível de evento dos últimos 12 meses.

Usuários mais suscetíveis

Consolidação por pessoa de cliques, credenciais e relatos em 12 meses.

Chaves de API

Conceda training:read e course:read à chave que atualiza este relatório.