Conformità per singola persona

Questo report costituisce la parte relativa alla formazione dell’esportazione della conformità per singola persona di un precedente provider: identità della directory più una riga per persona e per iscrizione alla formazione (stato e date dei moduli). La granularità è in formato lungo (persona × assegnazione), perché è ciò che GET /v1/assignments/{id}/enrollments restituisce già. La query non trasforma i moduli in colonne (pivot). La configurazione, le credenziali, la paginazione e i nuovi tentativi in caso di limite di frequenza sono gli stessi descritti nella guida alla connettività di Power BI / Excel. Aggiungere per prima la query condivisa Fn_FetchAll; questo report la richiama per nome.

​

Ambiti della chiave richiesti

​

Endpoint di origine

Questa query non chiama GET /v1/entities. La riga di iscrizione contiene già email e display_name, e l’elenco delle entità non include reparto né qualifica: scorrerlo quindi non popolerebbe colonne della directory che la riga di iscrizione non contenga già.

​

Granularità

Una riga per iscrizione (persona × assegnazione). Una persona a cui lo stesso corso viene assegnato tramite due assegnazioni genera due righe. Una persona senza iscrizioni non compare: /v1 non può produrre una riga di directory utilizzabile senza e-mail, e inventare righe con la sola persona mescolerebbe granularità diverse. Budget di richieste: una scansione paginata per ciascuna assegnazione, in sequenza, nel rispetto del limite di frequenza condiviso per chiave. Impostare sempre limit = "500".

​

Mappatura delle colonne

I nomi delle colonne legacy provengono dall’esportazione del precedente provider. I campi /v1 sono i nomi dell’API pubblica; la query assegna alcuni alias ad alcuni di essi per il report. Chiavi di join mantenute per un modello a stella: entity_id, assignment_id, course_id, user_assignment_id. La query mantiene inoltre course_slug, assignment_title, passed, attempts, assignment_lifecycle_status e assignment_created_at. enrollment_status indica l’avanzamento del Discente, non il ciclo di vita dell’assegnazione (active / paused / completed).

​

Differenze rispetto all’esportazione legacy

• Le accettazioni delle policy non sono disponibili. Questa piattaforma non dispone di un dominio policy: non esiste alcuna risorsa /policies, /policy_acceptances o /v1 equivalente. Non considerare tali colonne come una mappatura in sospeso. Sono fuori ambito.
• Gli elementi aggiuntivi della directory sono omessi, non impostati a null. Reparto, qualifica, responsabile e sede non sono presenti su /v1. La query non inventa colonne vuote per tali elementi.
• La data di scadenza è inclusa anche se l’esportazione legacy non la prevedeva, perché Enrollment.due_at è disponibile nell’API.
• Per il nome del corso si preferisce il titolo del catalogo. Course.title è il nome del modulo. Assignment.title viene utilizzato solo quando la riga del catalogo manca (eliminata o non pubblicata).
• Formato lungo, senza pivot. Una riga per iscrizione, non una riga per persona con una colonna per ciascun modulo.

​

Passaggi successivi