Condividi tramite

Opzione 4: usare il modello Azure Data Factory per inviare dati all'importazione basata su API

Seguire la procedura seguente per usare un modello di Azure Data Factory per inviare dati all'importazione basata su API.

1. Creare nuove Azure Data Factory

  1. Accedere a https://adf.azure.com/en/datafactories.

  2. Creare una nuova data factory o usare una data factory esistente. Completare i campi, quindi selezionare Crea.

    Screenshot che mostra come creare una nuova data factory o usarne una esistente.

2. Creare una nuova pipeline e una nuova attività

  1. Creare una nuova pipeline e immettere un nome per la pipeline.

    Screenshot che mostra come creare una nuova pipeline.

  2. In Attività aggiungere Copia dati.

    Screenshot che mostra come aggiungere i dati di copia.

3. Impostazioni dell'attività di copia dei dati: Generale

Selezionare l'attività Copia dati , quindi selezionare Generale per completare ogni campo usando le indicazioni riportate di seguito.

Screenshot che mostra come copiare le impostazioni dell'attività dati.

  • Nome: immettere un nome per l'attività.
  • Descrizione: immettere una descrizione per l'attività.
  • Stato attività: selezionare Attivato. In alternativa, selezionare Disattivato per escludere l'attività dall'esecuzione e dalla convalida della pipeline.
  • Timeout: si tratta della quantità massima di tempo in cui un'attività può essere eseguita. Il valore predefinito è 12 ore, il minimo è 10 minuti e la quantità massima di tempo consentita è di sette giorni. Il formato è in D.HH:MM:SS.
  • Riprova: numero massimo di tentativi. Questo può essere lasciato come 0.
  • Intervallo di tentativi (sec): numero massimo di tentativi di ripetizione. Questo valore può essere lasciato 30 se il tentativo di ripetizione dei tentativi è impostato su 0.
  • Output sicuro: se selezionato, l'output dell'attività non viene acquisito nella registrazione. È possibile lasciare questo cancellato.
  • Input sicuro: se selezionato, l'input dell'attività non viene acquisito nella registrazione. È possibile lasciare questo cancellato.

4. Impostazioni dell'attività di copia dei dati: origine

  1. Selezionare Origine.

  2. Selezionare un set di dati di origine esistente o selezionare +Nuovo per creare un nuovo set di dati di origine. Ad esempio, in Nuovo set di dati selezionare Archiviazione BLOB di Azure e quindi selezionare il tipo di formato dei dati.

    Screenshot che mostra come creare un nuovo set di dati di origine.

  3. Impostare le proprietà per il file .csv. Immettere un nome e in Servizio collegato selezionare un percorso esistente o selezionare +Nuovo.

    Screenshot che mostra come impostare le proprietà per il file CSV.

  4. Se è stato selezionato +Nuovo, immettere i dettagli per il nuovo servizio collegato usando le indicazioni seguenti.

    Screenshot che mostra come aggiungere i dettagli per il nuovo servizio collegato.

  5. Accanto a Set di dati di origine selezionare Apri.

    Screenshot che mostra come aprire il set di dati di origine.

  6. Selezionare Prima riga come intestazione.

    Screenshot che mostra come selezionare la prima riga come intestazione.

5. Impostazioni dell'attività di copia dei dati: Sink

  1. Selezionare Sink.

  2. Selezionare +Nuovo per configurare una nuova risorsa rest per connettersi all'API. Cercare "Rest" e selezionare Continua.

    Screenshot che mostra come configurare una nuova risorsa rest per la connessione all'API.

  3. Assegnare al servizio il nome . In Servizio collegato selezionare +Nuovo.

    Screenshot che mostra come assegnare un nome al servizio e aggiungere un nuovo servizio collegato.

  4. Cercare "Rest" e selezionarlo.

    Screenshot che mostra come cercare il set di dati Rest.

  5. Immettere i campi usando le indicazioni riportate di seguito.

    Screenshot che mostra come immettere i campi per il set di dati.

  • Nome: immettere un nome per il nuovo servizio collegato.
  • Descrizione: immettere una descrizione per il nuovo servizio collegato.
  • Connettersi tramite il runtime di integrazione: immettere il metodo preferito.
  • URL di base: usare l'URL seguente e sostituire {tenantid} con l'ID tenant: https://api.orginsights.viva.office.com/v1.0/tenants/{tenantid}/modis/connectors/HR/ingestions/fileIngestion
  • Tipo di autenticazione: selezionare il tipo di autenticazione come entità servizio, quindi selezionare Segreto o Certificato. Esempio di entità servizio:

    • Inline: selezionarlo.

    • ID entità servizio: immettere l'ID app autorizzato per il connettore API.

    • Chiave dell'entità servizio: immettere la chiave.

      Screenshot che mostra come immettere la chiave dell'entità servizio.

    • Tenant: immettere l'ID tenant.

    • Microsoft Entra ID risorsa:https://api.orginsights.viva.office.com

    • Azure tipo di cloud: selezionare il tipo di cloud Azure.

    • Convalida del certificato del server: selezionare Abilitato.

  1. Immettere le impostazioni sink usando le indicazioni riportate di seguito.

    Screenshot che mostra come immettere le impostazioni sink.

  • Set di dati sink: selezionare il set di dati esistente o appena creato.
  • Metodo di richiesta: selezionare POST.
  • Timeout della richiesta: cinque minuti è l'impostazione predefinita.
  • Intervallo richiesta (ms):10 è l'impostazione predefinita.
  • Dimensioni batch di scrittura: le dimensioni del batch devono essere superiori al numero massimo di righe nel file.
  • Tipo di compressione HTTP: nessuna è l'impostazione predefinita. In alternativa, è possibile usare GZip.
  • Intestazioni aggiuntive: selezionare +Nuovo.
    • Riquadro 1: x-nova-scaleunit
    • Valore: è possibile recuperare il valore passando alla pagina Connessioni dati nella pagina Dati dell'organizzazione in Microsoft 365 (Migrazioneconfigurazione>home>e importazione>dei dati dell'organizzazione in Connessioni dati di Microsoft 365>). Selezionare quindi Nuova importazione> Selezionare il tipo di > connessione Avvia configurazione> basata su APIPagina Configura connessione basata su API.

6. Impostazioni dell'attività di copia dei dati: mapping

  1. Selezionare Mapping.

  2. Per il caricamento del bootstrap, assicurarsi di includere PersonId, ManagerId e Organization nel mapping (nome di destinazione). Per il caricamento incrementale, verificare che i nomi di destinazione siano coerenti con quelli del caricamento precedente, insieme a PersonId. Non è possibile eseguire caricamenti incrementali con nuove colonne e PersonId è obbligatorio in tutti i caricamenti.

    Screenshot che mostra come immettere le impostazioni dell'attività per Mapping.

7. Impostazioni dell'attività di copia dei dati: impostazioni e proprietà utente

Non sono necessarie altre personalizzazioni per Impostazioni o Proprietà utente. Se necessario, è possibile modificare queste impostazioni caso per caso.

8. Attività di copia dei dati: Attivare l'installazione (automazione)

Per aggiungere un trigger all'installazione di automazione, selezionare Aggiungi trigger. L'automazione consigliata è settimanale. È anche possibile personalizzare la frequenza.

Screenshot che mostra come configurare il trigger.

Apportare modifiche alla connessione o ai dati

  • Last updated on