> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conformidade por pessoa

> Recrie a exportação de conformidade de treinamento por pessoa de um provedor anterior a partir de assignments, enrollments e courses da /v1.

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 para cada inscrição em treinamento (status e datas dos módulos).

A granularidade é em formato longo (pessoa × atribuição), pois é isso que
`GET /v1/assignments/{id}/enrollments` já retorna. A consulta não
transforma os módulos em colunas.

<Note>
  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 do formato anterior estão fora do escopo, e não
  são um mapeamento pendente. Consulte [Divergências em relação à exportação anterior](#diverg%C3%AAncias-em-rela%C3%A7%C3%A3o-%C3%A0-exporta%C3%A7%C3%A3o-anterior).
</Note>

A configuração, as credenciais, a paginação e as novas tentativas em caso de limite de taxa são as mesmas do
[guia de conectividade do Power BI / Excel](/pt-BR/developers/v1/powerbi). Adicione primeiro a consulta compartilhada
`Fn_FetchAll`; este relatório a chama pelo nome.

## Escopos de chave necessários

| Escopo | Utilizado para |
| - | - |
| `training:read` | `GET /v1/assignments` e `GET /v1/assignments/{id}/enrollments` |
| `course:read` | `GET /v1/courses` (títulos do catálogo) |

## Endpoints de origem

| Endpoint | Função |
| - | - |
| `GET /v1/assignments` | Lista de atribuições: `assignment_id`, título, `course_id`, status do ciclo de vida, `created_at`. A consulta não filtra por status; portanto, atribuições ativas, pausadas e concluídas aparecem (conformidade histórica). |
| `GET /v1/assignments/{id}/enrollments` | Progresso por participante. Uma varredura paginada por atribuição. Esta é a granularidade dos fatos e o único recurso `/v1` neste relatório que traz o e-mail como chave de junção para relatórios. |
| `GET /v1/courses` | Resolve `course_id` → título do curso (o nome do módulo de treinamento). `Assignment.title` é um rótulo de campanha, não o nome do módulo. |

Esta consulta **não** chama `GET /v1/entities`. A linha de inscrição
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 inscrição ainda não tenha.

### Granularidade

Uma linha por inscrição (pessoa × atribuição). Uma pessoa que recebe o mesmo
curso por meio de duas atribuições gera duas linhas. Uma pessoa sem
inscrições não aparece: `/v1` não consegue gerar uma linha de diretório utilizável
sem e-mail, e inventar linhas apenas com a pessoa misturaria granularidades.

Orçamento de requisições: uma varredura paginada por atribuição, em sequência, respeitando o
limite de taxa compartilhado por chave. Defina sempre `limit = "500"`.

## Mapeamento de colunas

Os nomes das colunas do formato anterior são os 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.

| Coluna anterior | Campo ou derivação de `/v1` | Coluna do relatório |
| - | - | - |
| Email | `Enrollment.email` | `email` |
| Full name | `Enrollment.display_name` | `full_name` |
| Department | Não está em `/v1` | Omitida, não preenchida com nulo |
| Other directory (title, manager, location, …) | Não está em `/v1`; as entidades trazem apenas e-mail e nome de exibição. | Omitida |
| Training module / course name | `Course.title`, com `Assignment.title` como alternativa | `course_name` |
| Assignment / module status | `Enrollment.status` — `not_started` \| `in_progress` \| `completed` \| `overdue` \| `withdrawn` | `enrollment_status` |
| Assigned date | `Enrollment.assigned_at` | `assigned_at` |
| Completed date | `Enrollment.completed_at` | `completed_at` |
| Due date | `Enrollment.due_at` (a exportação anterior pode não ter esta coluna; ela foi incluída porque a API a fornece) | `due_at` |
| Policy acceptance / acknowledgement | Sem domínio de políticas | Omitida |
| Policy name, accepted date | Sem domínio de políticas | Omitida |

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 participante, não o ciclo de vida da atribuição
(`active` / `paused` / `completed`).

## Divergências em relação à exportação anterior

* **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 extras de diretório são omitidos, não preenchidos com nulo.** Departamento, cargo,
  gestor e localização não estão em `/v1`. A consulta não cria colunas
  vazias para eles.
* **A data de vencimento é incluída** mesmo que a exportação anterior não a tivesse,
  porque `Enrollment.due_at` está disponível na API.
* **O nome do curso prioriza o título do catálogo.** `Course.title` é o nome do
  módulo. `Assignment.title` é usado apenas quando a linha do catálogo está ausente
  (excluída ou não publicada).
* **Formato longo, sem transformação em colunas.** Uma linha por inscrição, e não uma linha por
  pessoa com uma coluna por módulo.

## Próximas etapas

<CardGroup cols={2}>
  <Card title="Configuração do Power BI e do Excel" href="/pt-BR/developers/v1/powerbi">
    Credenciais, paginação e carregamento dessas consultas no Power BI ou no Excel.
  </Card>

  <Card title="Log de phishing por e-mail" href="/pt-BR/developers/v1/reports/email-phishing-log">
    Interações de phishing em nível de evento dos últimos 12 meses.
  </Card>

  <Card title="Usuários mais suscetíveis" href="/pt-BR/developers/v1/reports/most-susceptible-users">
    Consolidação por pessoa de cliques, credenciais e relatos nos últimos 12 meses.
  </Card>

  <Card title="Chaves de API" href="/pt-BR/developers/developer-hub/api-keys">
    Conceda `training:read` e `course:read` à chave que atualiza este relatório.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.