Chiama l'API Microsoft 365 per trasferire i dati dell'organizzazione per l'importazione basata su API (passaggio 2 di 3) (anteprima)

Importante

Questa funzionalità è disponibile solo per i clienti dell'anteprima pubblica. Le funzionalità in anteprima potrebbero non essere complete e potrebbero subire modifiche prima di essere disponibili nella versione più ampia.

Si applica a: amministratore globale di Microsoft 365 o amministratore dell'origine dati dell'organizzazione o amministratore del sistema di informazione delle risorse umane

1. Preparare ed esportare i dati con una frequenza impostata

Esportare i dati organizzativi per tutti i dipendenti della società e aggiungere tutti i campi da importare in un modello di .csv o un output di .csv automatico in un'origine esterna, ad esempio Workday Report as a Service (RaaS). Informazioni su come strutturare questo file di dati.

Con la frequenza stabilita (ad esempio, una volta al mese o una volta alla settimana), fare in modo che l'app personalizzata o l'integrazione di un'origine esterna esporti i dati dell'organizzazione dal sistema di origine.

2. Chiama l'API per importare i tuoi dati

Per importare i dati in Microsoft 365, è possibile scegliere tra cinque opzioni:

  1. Usa la nostra API per creare un'app personalizzata che esporta e importa i tuoi dati con la frequenza che scegli. Procedura

  2. Eseguire la soluzione C# nella console, che si basa sull'API. Procedura

  3. Eseguire lo script di PowerShell, anch'esso basato sull'API. Procedura

  4. Usare un modello di Azure Data Factory per inviare dati all'importazione basata su API. Procedura

  5. Eseguire lo script Node per recuperare i token OAuth. Usa quindi questi token per inviare i dati direttamente da un'origine esterna, ad esempio Workday, all'importazione basata su API. Procedura

Nota

Le soluzioni C# e PowerShell importano dati solo in Microsoft 365 Organizational Data Service. I dati non vengono esportati dal sistema di origine.

Se si usa l'opzione 1, 2, 3 o 4, verificare di disporre di queste informazioni:

  • ID app (client). Trovare questo ID nelle informazioni dell'app registrata nell'interfaccia di amministrazione di Microsoft Entra in ID applicazione (client).

  • Segreto client: si tratta di una stringa segreta usata dall'applicazione per dimostrare la propria identità quando si richiede un token. Viene anche definita password dell'applicazione. Questo segreto viene visualizzato solo per la prima volta quando viene creato il segreto client. Per creare un nuovo segreto client, seguire questa procedura.

  • Nome del certificato. Questo nome è configurato nell'applicazione registrata. Dopo aver caricato il certificato, il nome del certificato viene visualizzato in Descrizione nel portale di Azure. È possibile usare il nome del certificato come alternativa al segreto client.

  • ID tenant di Microsoft Entra. Questo ID è disponibile nella pagina di panoramica dell'app in ID directory (tenant).

  • Unità di scala: l'unità di misura fornita per il tenant, ad esempio "novaprdwus2-01".

  • File .csv e percorso del file .csv.

In alternativa, se si utilizza l'opzione 5, verificare di disporre di queste informazioni:

  • ID app (client). Trovare questo ID nelle informazioni sulle app registrate nell'interfaccia di amministrazione di Microsoft 365 in ID applicazione (client).

  • Segreto client: si tratta di una stringa segreta usata dall'applicazione per dimostrare la propria identità quando si richiede un token. Viene anche definita password dell'applicazione. Questo segreto viene visualizzato solo quando si crea il segreto client. Informazioni su come creare un nuovo segreto client.

  • ID tenant di Microsoft Entra. Questo ID è disponibile nella pagina di panoramica dell'app in ID directory (tenant).

  • ID connettore: stringa alla fine dell'URL visualizzata quando si seleziona il connettore basato su API nell'interfaccia di amministrazione di Microsoft 365, ad esempiohttps://admin.cloud.microsoft/OrganizationalDataInM365/connection-details/[Connector ID here].

  • Unità di scala: l'unità di misura fornita per il tenant, ad esempio "novaprdwus2-01".

Eseguire il push dei dati

App per chiamare l'API Microsoft 365 per inviare contenuti

[POST] https://api.orginsights.viva.office.com/v1.0/tenants/{tenantid}/modis/connectors/HR/ingestions/fileIngestion

Nel caso in cui il connettore non sia impostato:

403: Forbidden

Se il connettore è impostato, ma l'inserimento precedente non è ancora stato completato:

400: Bad request: Previous ingestion is not complete.

Opzione 1: usare l'API di Microsoft 365 per creare un'app di importazione/esportazione personalizzata

È possibile usare l'API di Microsoft 365 per creare un'app personalizzata che esporta automaticamente i dati dal sistema di origine e quindi li importa nell'interfaccia di amministrazione di Microsoft 365.

L'app può assumere qualsiasi forma, ad esempio uno script di PowerShell, ma deve esportare i dati di origine come file di .csv alla frequenza scelta e importare tale file nelle app e nei servizi di Microsoft 365.

Opzione 2: importare i dati tramite la soluzione C# dopo averli esportati tramite l'app personalizzata

Dopo aver esportato i dati di origine come file di .csv alla frequenza scelta, è possibile eseguire la soluzione DescriptiveDataUploadApp C# nella console. La soluzione C# DescriptiveDataUploadApp inserisce quindi i dati archiviati localmente in Microsoft 365. Altre informazioni sono disponibili su GitHub.

Per eseguire la soluzione:

  1. Clona questa app nel computer eseguendo il comando seguente nella riga di comando:

    git clone https://github.com/microsoft/orgdata_apibasedimport.git.

  2. Includi i valori della console seguenti.

    • AppID/ID client
    • Percorso assoluto del file .csv. Formattare il percorso nel seguente modo: C:\\Users\\JaneDoe\\OneDrive - Microsoft\\Desktop\\info.csv
    • ID tenant di Microsoft Entra
    • Nome certificato

Opzione 3: Eseguire la soluzione PowerShell DescriptiveDataUpload dopo aver esportato i dati tramite l'app personalizzata

Analogamente all'opzione 2, dopo aver esportato i dati di origine come file di .csv alla frequenza selezionata, è possibile eseguire la soluzione DescriptiveDataUpload PowerShell nella console. La soluzione PowerShell DescriptiveDataUpload porta quindi i dati archiviati localmente in Microsoft 365. Altre informazioni sono disponibili su GitHub.

  1. Clonare il codice sorgente nel computer eseguendo questo comando nella riga di comando:

    git clone https://github.com/microsoft/orgdata_apibasedimport.git.

  2. Aprire una nuova finestra di PowerShell come amministratore.

  3. Nella finestra di PowerShell, esegui il comando seguente:

    Install-Module -Name MSAL.PS

    In alternativa, passare a questo collegamento alla Raccolta di PowerShell per istruzioni sull'installazione.

  4. Impostare i parametri.

    • ClientID
    • pathTocsvFile
    • TenantId
    • novaScaleUnit
    • ingressDataType: HR
    • ClientSecret o certificateName

Apportare modifiche alla connessione o ai dati

  • Last updated on