Opzione 4: usare il modello di 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 un nuovo Azure Data Factory

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

  2. Creare una nuova data factory o usare una data factory esistente. Compilare i campi e quindi selezionare Crea.

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

2. Creare una nuova pipeline e attività

  1. Create una nuova tubazione e immettete un nome per la tubazione.

    Screenshot che mostra come creare una nuova pipeline.

  2. In Attività aggiungere Copia dati.

    Screenshot che mostra come aggiungere dati di copia.

3. Copia le impostazioni dell'attività 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à dei dati.

  • Nome: immettere un nome per l'attività.
  • Descrizione: immettere una descrizione per l'attività.
  • Stato attività: seleziona Attivato. In alternativa, selezionare Disattivato per escludere l'attività dall'esecuzione e dalla convalida della pipeline.
  • Timeout: questa è la quantità massima di tempo di esecuzione di un'attività. Il valore predefinito è 12 ore, il minimo è 10 minuti e la quantità massima di tempo consentita è sette giorni. Il formato è in D.HH:MM:SS.
  • Riprova: il numero massimo di tentativi. Può essere lasciato come 0.
  • Intervallo tra tentativi (sec): numero massimo di tentativi. Può essere lasciato a 30 se il tentativo è impostato su 0.
  • Output protetto: quando questa opzione è selezionata, l'output dell'attività non viene acquisito durante la registrazione. Puoi lasciare questa opzione deselezionata.
  • Input sicuro: quando questa opzione è selezionata, l'input dell'attività non viene acquisito nella registrazione. Puoi lasciare questa opzione deselezionata.

4. Copia le impostazioni dell'attività dati: Origine

  1. Selezionare l'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, 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 una posizione esistente o selezionare +Nuovo.

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

  4. Se è stato selezionato +New, immettere i dettagli per il nuovo servizio collegato usando le indicazioni riportate di seguito.

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

  5. Accanto al 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. Copia le impostazioni dell'attività dei dati: Sink

  1. Seleziona lavandino.

  2. Seleziona +Nuovo per configurare una nuova risorsa REST per la connessione all'API. Cerca "Riposo" e seleziona Continua.

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

  3. Assegna un nome al servizio. In Servizio collegato selezionare +Nuovo.

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

  4. Cerca "Resto" e selezionalo.

    Screenshot che mostra come cercare il set di dati Rest.

  5. Immettere i campi seguendo le istruzioni 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.
  • Connettiti 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:

    • Incorporato: selezionarlo.

    • ID entità servizio: immettere l'ID app autorizzata 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.

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

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

    • Convalida del certificato server: selezionare Abilitato.

  1. Immettere le impostazioni del sink usando le indicazioni seguenti.

    Screenshot che mostra come accedere alle impostazioni del sink.

  • Set di dati sink: selezionare il set di dati esistente o appena creato.
  • Metodo di richiesta: selezionare POST.
  • Timeout richiesta: cinque minuti è il valore predefinito.
  • Intervallo di richiesta (ms): 10 è il valore predefinito.
  • Dimensione del batch di scrittura: la dimensione del batch deve essere superiore al numero massimo di righe nel file.
  • Tipo di compressione HTTP: Nessuno è l'impostazione predefinita. Oppure puoi usare GZip.
  • Intestazioni aggiuntive: Selezionare +Nuovo.
    • Riquadro 1: x-nova-scaleunit
    • Valore: è possibile recuperare il valore passando alla pagina Connessioni dati nella pagina del servizio dati aziendali di Microsoft 365 (migrazionedi configurazione>principale>e importazioni> di connessionidatidel servizio> dati aziendali di Microsoft 365). Quindi, selezionare Nuova importazione> Selezionare il tipo di > connessione Avvia la configurazione> basata su APIConfigurare la pagina di connessione basata su API.

6. Copia le impostazioni dell'attività dati: mapping

  1. Selezionare Mapping.

  2. Per il caricamento del bootstrap, assicurati di includere PersonId, ManagerId e Organization nella mappatura (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 delle attività per il mapping.

7. Copia le impostazioni dell'attività dati: impostazioni e proprietà utente

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

8. Attività di copia dati: impostazione trigger (automazione)

Per aggiungere un trigger alla configurazione dell'automazione, seleziona Aggiungi trigger. L'automazione consigliata è settimanale. È anche possibile personalizzare la frequenza.

Screenshot che mostra come impostare il trigger.

Apportare modifiche alla connessione o ai dati

  • Last updated on