Esporta i dati di Viva Insights con MGDC

Se si vuole usare e analizzare Viva Insights dati all'esterno dell'app Viva Insights, è possibile usare Microsoft Graph Data Connect (MGDC) per trasferire i dati back-end in Azure. Questo processo consente agli utenti di esportare qualsiasi sottoinsieme di metriche da Viva Insights, che può includere sia le metriche di sistema che le metriche personalizzate.

Passaggi dei prerequisiti

1. Specificare l'ID tenant per il team Viva Insights. L'ID tenant è disponibile nella portale di Azure. In Servizi di Azure selezionare Microsoft Entra ID e quindi trovare l'ID tenant nella pagina Panoramica.
2. L'amministratore globale dovrà assegnare i ruoli pertinenti per i passaggi seguenti, se non sono già assegnati.

Panoramica del processo

Attività	Ruolo	Risorse necessarie
1. Creare un'applicazione Azure Active Directory	Amministratore dell'applicazione o sviluppatore di applicazioni
2. Effettuare il provisioning dell'account di archiviazione	Amministratore dell'applicazione o sviluppatore di applicazioni
3. Effettuare il provisioning Key Vault e archiviare il segreto client	Amministratore dell'applicazione o sviluppatore di applicazioni	Segreto dell'app
4. Abilitare MGDC per il tenant	Amministratore di Microsoft Graph Data Connect o amministratore di applicazioni
5. Contrassegnare una query Viva Insights per l'esportazione	Analista di Insights
6. Registrare l'applicazione MGDC	Proprietario dell'applicazione Azure AD, con ruolo di analista di Insights	Account di archiviazione, applicazione Azure AD
7. Consenso all'applicazione/set di dati	Viva Insights Administrator o MGDC Administrator
8. Distribuire il modello di Resource Manager	Amministratore dell'applicazione o sviluppatore di applicazioni, con ruolo di analista di Insights	App MGDC, segreto dell'app, contenitore
9. Eseguire la pipeline	Amministratore dell'applicazione o sviluppatore di applicazioni	Data factory
10. Trovare l'output dell'estrazione	Amministratore dell'applicazione o sviluppatore di applicazioni	Nome del contenitore

Nota

Quando si esportano dati Viva Insights tramite MGDC, non verranno addebitati costi aggiuntivi a meno che non si superi il limite mensile di dati in uscita. Ogni mese è possibile esportare i dati per una popolazione analizzata fino a 20 volte il numero di licenze Viva Insights. Per ogni licenza, è possibile includere un dipendente in un massimo di 20 query. Ad esempio, in un tenant con 100 licenze:

• È possibile esportare 20 query, ognuna con dati di 100 dipendenti univoci.

• In alternativa, è possibile esportare 40 query, ognuna con dati di 50 dipendenti univoci.

• In alternativa, è possibile esportare 10 query con dati di 150 dipendenti univoci ciascuno e cinque query con 100 dipendenti univoci ciascuno.

Se il tenant supera il limite mensile, Microsoft può contattare l'utente per verificare le esigenze correnti. Questi limiti specifici descritti sono soggetti a modifiche.

Procedura

1. Creare un'applicazione Microsoft Entra

Si applica a: Application Administrator o Application Developer

Seguire i passaggi da 1 a 10 descritti qui per creare l'entità servizio app. Assicurarsi di archiviare il segreto dell'app da usare in un passaggio successivo di questo processo.

2. Effettuare il provisioning dell'account di archiviazione

Si applica a: Application Administrator o Application Developer

Seguire tutti i passaggi descritti qui per creare l'account di archiviazione. Per selezionare l'area, seguire questa procedura.

Dopo aver seguito i passaggi precedenti e aver configurato l'account di archiviazione:

1. Nell'account di archiviazione, in Proprietà selezionare il collegamento a destra dell'eliminazione temporanea del BLOB.

   

2. Deselezionare Abilita eliminazione temporanea per i BLOB e Abilita eliminazione temporanea per i contenitori e selezionare Salva.

3. Effettuare il provisioning dell'insieme di credenziali delle chiavi e archiviare il segreto client

Si applica a: Application Administrator o Application Developer

1. Aprire un browser e accedere al portale di Azure.

2. In Servizi di Azure selezionare Crea una risorsa.

3. Selezionare Crea nel tipo di risorsa Key Vault e usare i valori seguenti:

   • Abbonamento: Selezionare la sottoscrizione di Azure
   • Gruppo di risorse: mgdc-app-resource (o selezionare un gruppo di risorse esistente)
   • Nome dell'insieme di credenziali delle chiavi: mgdcdemokeyvault (oppure è possibile assegnare un nome e selezionarne uno personalizzato)
   • Regione: Selezionare l'area usando questi passaggi.
   • Piano tariffario: Standard
   • Giorni per conservare gli insiemi di credenziali eliminati: Default
   • Protezione dall'eliminazione: Default

   

4. Seleziona Rivedi + Crea.

5. Per completare i passaggi 6 e 7, assegnare a se stessi il ruolo Key Vault Secrets Officer o Key Vault Administrator usando queste istruzioni.

6. Nel menu della barra laterale dell'insieme di credenziali delle chiavi mgdcdemokeyvault selezionare Segreti nella sezione Oggetti . Selezionare +Genera/Importa e usare i valori seguenti:

   • Opzioni di caricamento: Manuale
   • Nome: mgdc-app-secret (oppure è possibile assegnare un nome e selezionarne uno personalizzato)
   • Valore del segreto: Incollare il segreto dell'app archiviato nel passaggio 1
   • Impostare la data di attivazione: Lasciare deselezionata
   • Impostare la data di scadenza: Lasciare deselezionata
   • Abilitato: Sì
   • Tag: 0 tag

7. Selezionare Crea.

4. Abilitare MGDC per il tenant

Si applica a: Amministratore di Microsoft Graph Data Connect o Amministratore applicazioni

1. Aprire un browser e accedere al portale di Amministrazione Microsoft 365.

2. In Impostazioni selezionare Impostazioni organizzazione. Potrebbe essere necessario selezionare Mostra tutto per visualizzare l'opzione Impostazioni .

3. In Servizi selezionare Connessione dati di Microsoft Graph.

   

4. Selezionare Attiva o disattiva Microsoft Graph Data Connect per l'intera organizzazione per abilitare Data Connect. Assicurarsi che sia selezionato Viva Insights.

   

5. Seleziona Salva.

Se MGDC è già stato abilitato, è necessario:

1. Seguire i passaggi da 1 a 3 precedenti.
2. Deselezionare Attiva o disattiva Microsoft Graph Data Connect affinché l'intera organizzazione disabiliti Data Connect.
3. Seleziona Salva.
4. Aggiornare la pagina.
5. Seguire i passaggi da 3 a 5 precedenti.

5. Contrassegnare una query Viva Insights per l'esportazione

Si applica a: Insights Analyst

Importante

Assicurarsi di avere il ruolo di analista di Insights corretto. Gli utenti precedenti della piattaforma Workplace Analytics legacy potrebbero avere il ruolo di "analista". Per completare questo processo, è necessario il ruolo "Insights Analyst". Usare questi passaggi per abilitare il ruolo Dianalista di Insights.

1. Aprire un browser e accedere all'app Web Viva Insights.

2. Per eseguire una nuova query, nella pagina Crea analisi selezionare Configura analisi in un modello di Power BI o in una query personalizzata. Se si hanno già risultati di query da esportare, è possibile ignorare questo passaggio.

3. Nel menu di spostamento a sinistra selezionare Risultati analisi.

4. Quando i risultati della query sono disponibili per una query nuova o esistente, selezionare l'icona di Azure da contrassegnare per l'uscita.

   

5. Selezionare Esporta in Azure.

6. Registrare l'applicazione MGDC

Si applica a: Microsoft Entra proprietario dell'applicazione, con ruolo di analista di Insights

Usare questi passaggi per registrare l'app con Data Connect.

Esistono tuttavia alcuni passaggi univoci specifici per questo processo per i carichi dinamici. Quando si compila la pagina delle informazioni di registrazione, assicurarsi di usare questi valori:

• Sottoscrizione (obbligatoria): selezionare una sottoscrizione nel tenant che verrà usata esclusivamente per filtrare le quattro sezioni successive correlate alla configurazione della destinazione dati.
• Gruppo di risorse (obbligatorio): mgdc-app-resource (o selezionare un gruppo di risorse esistente)
• Tipo di destinazione: selezionare Account di archiviazione di Azure
• Account di archiviazione (obbligatorio): selezionare l'account di archiviazione di Azure creato nel passaggio 2
• Uri dell'account di archiviazione (obbligatorio): selezionare l'URI nel formato: https://[nome account di archiviazione].dfs.core.windows.net/ (anziché ... blob.core.windows.net/)
• ID applicazione: selezionare l'entità servizio app nel passaggio 1
• Tipo di pubblicazione: singolo tenant

Inoltre, quando si specificano i set di dati su cui la registrazione dell'app deve eseguire una query, per un set di dati Viva Insights dinamico, il nome deve essere: VivaInsightsDataset_Report_v1_[Viva Insights nome query].

Nota

Per modificare le proprietà o i set di dati associati all'app, seguire questa procedura.

7. Consenso all'applicazione/set di dati

Si applica a: Viva Insights Administrator e MGDC Administrator (Il responsabile approvazione dell'app deve essere diverso dallo sviluppatore dell'app)

1. Aprire un browser e accedere al portale di Amministrazione Microsoft 365.

2. In Impostazioni selezionare Impostazioni organizzazione. Potrebbe essere necessario selezionare Mostra tutto per visualizzare l'opzione Impostazioni .

3. Selezionare la scheda Sicurezza & privacy .

4. Selezionare Applicazioni Microsoft Graph Data Connect.

   

5. Fare doppio clic per selezionare l'app nell'elenco, verificare i nomi del set di dati e delle colonne e quindi selezionare Approva.

   

8. Distribuire il modello di Resource Manager

Si applica a: Amministratore applicazioni o Sviluppatore di applicazioni, con ruolo di analista di Insights

Usare questi passaggi per generare un modello di avvio rapido per configurare la pipeline di dati. Usare questi passaggi per selezionare l'area.

9. Eseguire la pipeline

Si applica a: Application Administrator o Application Developer

1. Aprire una finestra del browser e accedere al portale di Azure.

2. Cercare "Data factory".

3. Selezionare mgdcdemodatafactory (a meno che non si abbia un nome personalizzato).

4. Selezionare Avvia studio.

5. Selezionare l'icona a matita a sinistra.

6. In Pipeline selezionare ExportO365DataEvents.

7. Selezionare Debug.

   

8. Se sono presenti errori nel set di dati, verranno specificati in basso a destra in Stato. Per modificare i nomi e i tipi di dati delle colonne del set di dati, selezionare la scheda [Nome set di dati] nella parte superiore. Selezionare le icone delle parentesi quadre a destra. Modificare "name" e "type" in base alle esigenze.

9. Al termine della pipeline, i dati devono essere visualizzati nell'account di archiviazione. Selezionare Contenitori, quindi set di dati come illustrato di seguito, dove il nome del contenitore è l'ID di esecuzione della pipeline.

   

   Nota

   Se l'esecuzione della pipeline non riesce, salvare l'ID esecuzione attività dallo studio della pipeline di Data Factory, come illustrato di seguito. Questo consentirà al team di eseguire il debug.

   

10. Trovare l'output dell'estrazione

Si applica a: Application Administrator o Application Developer

Se si desidera trovare i metadati, passare alla portale di Azure. Nell'account di archiviazione selezionare Contenitori e quindi set di dati. Seguire quindi il percorso della cartella seguente:

• File di output

  • /[ID esecuzione pipeline] / VivaInsights / [TenantID] / [.gzip file]
  • Il file con estensione gzip contiene l'output della metrica associato all'esecuzione della pipeline

  

  • L'output delle esportazioni con origini dati aggiuntive, ad esempio dati aziendali o di sondaggio, viene raggruppato in cartelle etichettate in base a ogni set di dati usato nella query. Ad esempio, le query con dati aziendali o di sondaggio avranno cartelle separate per i dati hr, MetricOutput e i set di dati aziendali o di sondaggio.

• Metadati

  • /[ID esecuzione pipeline] / VivaInsights / [TenantID] / metadata / JobMetadata / metadata.json
  • Metadata.json contiene i metadati associati all'esecuzione della pipeline

  

• Se si vuole aggiornare il percorso del file, passare a portale di Azure, quindi [Data factory]. Selezionare Avvia studio , quindi VivaInsightsSink e modificare il percorso del file.

  

Nota

Se si vuole eliminare una voce di registrazione dell'app, seguire questa procedura. (Si applica a Microsoft Entra proprietario dell'applicazione con ruolo di analista di Insights)