Freigeben über

Option 4: Verwenden der Azure Data Factory-Vorlage zum Senden von Daten an unseren API-basierten Import

Führen Sie die folgenden Schritte aus, um eine Azure Data Factory Vorlage zum Senden von Daten an den API-basierten Import zu verwenden.

1. Erstellen eines neuen Azure Data Factory

  1. Melden Sie sich bei an https://adf.azure.com/en/datafactories.

  2. Erstellen Sie eine neue Data Factory, oder verwenden Sie eine vorhandene Data Factory. Füllen Sie die Felder aus, und wählen Sie dann Erstellen aus.

    Screenshot: Erstellen einer neuen Data Factory oder Verwendung einer vorhandenen Data Factory

2. Erstellen einer neuen Pipeline und Aktivität

  1. Erstellen Sie eine neue Pipeline, und geben Sie einen Namen für die Pipeline ein.

    Screenshot: Erstellen einer neuen Pipeline

  2. Fügen Sie unter Aktivitäten die Option Daten kopieren hinzu.

    Screenshot: Hinzufügen von Kopierdaten

3. Einstellungen für Die Datenaktivität kopieren: Allgemein

Wählen Sie Ihre Aktivität Daten kopieren und dann Allgemein aus, um die einzelnen Felder anhand der folgenden Anleitung abzuschließen.

Screenshot: Kopieren von Datenaktivitätseinstellungen

  • Name: Geben Sie einen Namen für Ihre Aktivität ein.
  • Beschreibung: Geben Sie eine Beschreibung für Ihre Aktivität ein.
  • Aktivitätsstatus: Wählen Sie Aktiviert aus. Oder wählen Sie Deaktiviert aus, um die Aktivität von der Pipelineausführung und -überprüfung auszuschließen.
  • Timeout: Dies ist die maximale Zeit, die eine Aktivität ausführen kann. Der Standardwert ist 12 Stunden, der Mindestwert beträgt 10 Minuten, und die maximal zulässige Zeit beträgt sieben Tage. Das Format befindet sich in D.HH:MM:SS.
  • Wiederholung: Die maximale Anzahl von Wiederholungsversuchen. Dies kann als 0 (0) belassen werden.
  • Wiederholungsintervall (Sek.): Die maximale Anzahl von Wiederholungsversuchen. Dies kann als 30 belassen werden, wenn der Wiederholungsversuch auf 0 festgelegt ist.
  • Sichere Ausgabe: Wenn diese Option ausgewählt ist, wird die Ausgabe der Aktivität nicht in der Protokollierung erfasst. Sie können dies deaktiviert lassen.
  • Sichere Eingabe: Wenn diese Option ausgewählt ist, wird die Eingabe aus der Aktivität nicht in der Protokollierung erfasst. Sie können dies deaktiviert lassen.

4. Einstellungen für Die Datenaktivität kopieren: Quelle

  1. Wählen Sie Quelle aus.

  2. Wählen Sie ein vorhandenes Quelldataset oder +Neu aus, um ein neues Quelldataset zu erstellen. Wählen Sie beispielsweise unter Neues DatasetAzure Blob Storage und dann den Formattyp Ihrer Daten aus.

    Screenshot: Erstellen eines neuen Quelldatasets

  3. Legen Sie die Eigenschaften für die .csv-Datei fest. Geben Sie einen Namen ein, und wählen Sie unter Verknüpfter Dienst einen vorhandenen Standort aus, oder wählen Sie +Neu aus.

    Screenshot: Festlegen der Eigenschaften für die CSV-Datei

  4. Wenn Sie +Neu ausgewählt haben, geben Sie die Details für den neuen verknüpften Dienst mithilfe der folgenden Anleitung ein.

    Screenshot: Hinzufügen von Details für den neuen verknüpften Dienst

  5. Wählen Sie neben Quelldataset die Option Öffnen aus.

    Screenshot: Öffnen des Quelldatasets

  6. Wählen Sie Erste Zeile als Kopfzeile aus.

    Screenshot: Auswählen der ersten Zeile als Kopfzeile

5. Einstellungen für Die Datenaktivität kopieren: Senke

  1. Wählen Sie Senke aus.

  2. Wählen Sie +Neu aus, um eine neue Restressource für die Verbindung mit der API zu konfigurieren. Suchen Sie nach "Rest", und wählen Sie Weiter aus.

    Screenshot: Konfigurieren einer neuen Restressource zum Herstellen einer Verbindung mit der API

  3. Benennen Sie den Dienst. Wählen Sie unter Verknüpfter Dienstdie Option +Neu aus.

    Screenshot: Benennen des Diensts und Hinzufügen eines neuen verknüpften Diensts

  4. Suchen Sie nach "Rest", und wählen Sie es aus.

    Screenshot: Suchen nach dem Rest-Dataset

  5. Geben Sie die Felder mithilfe der folgenden Anleitung ein.

    Screenshot: Eingeben der Felder für das Dataset

  • Name: Geben Sie einen Namen für Ihren neuen verknüpften Dienst ein.
  • Beschreibung: Geben Sie eine Beschreibung für Ihren neuen verknüpften Dienst ein.
  • Herstellen einer Verbindung über Integration Runtime: Geben Sie die bevorzugte Methode ein.
  • Basis-URL: Verwenden Sie die folgende URL, und ersetzen Sie {tenantid} durch Ihre Mandanten-ID: https://api.orginsights.viva.office.com/v1.0/tenants/{tenantid}/modis/connectors/HR/ingestions/fileIngestion
  • Authentifizierungstyp: Wählen Sie Ihren Authentifizierungstyp als Dienstprinzipal und dann Geheimnis oder Zertifikat aus. Dienstprinzipalbeispiel:

    • Inline: Wählen Sie es aus.

    • Dienstprinzipal-ID: Geben Sie die für den API-Connector autorisierte App-ID ein.

    • Dienstprinzipalschlüssel: Geben Sie den Schlüssel ein.

      Screenshot: Eingeben des Dienstprinzipalschlüssels

    • Mandant: Geben Sie die Mandanten-ID ein.

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

    • Azure Cloudtyp: Wählen Sie Ihren Azure Cloudtyp aus.

    • Serverzertifikatüberprüfung: Wählen Sie Aktiviert aus.

  1. Geben Sie die Senkeneinstellungen mithilfe der folgenden Anleitung ein.

    Screenshot: Eingeben der Senkeneinstellungen

  • Senkendataset: Wählen Sie das vorhandene oder neu erstellte Dataset aus.
  • Anforderungsmethode: Wählen Sie POST aus.
  • Anforderungstimeout: Fünf Minuten ist die Standardeinstellung.
  • Anforderungsintervall (ms):10 ist die Standardeinstellung.
  • Schreibbatchgröße: Die Batchgröße sollte höher sein als die maximale Anzahl von Zeilen in Ihrer Datei.
  • HTTP-Komprimierungstyp: Keine ist die Standardeinstellung. Alternativ können Sie GZip verwenden.
  • Zusätzliche Header: Wählen Sie +Neu aus.
    • Box 1: x-nova-scaleunit
    • Wert: Sie können den Wert abrufen, indem Sie zur Seite Datenverbindungen auf der Seite Organisationsdaten in Microsoft 365 navigieren (Home>Setup>Migration and imports>Organizational Data in Microsoft 365>Data Connections). Wählen Sie dann Neuer Import> Verbindungstyp >auswählen API-basiertes Setup>einrichten API-basierte Verbindungsseite auswählen aus.

6. Einstellungen für Die Datenaktivität kopieren: Zuordnung

  1. Wählen Sie Zuordnung aus.

  2. Stellen Sie für den Bootstrap-Upload sicher, dass Sie PersonId, ManagerId und Organization in die Zuordnung (Zielname) einschließen. Vergewissern Sie sich für den inkrementellen Upload, dass die Zielnamen mit denen im vorherigen Upload konsistent sind, zusammen mit der PersonId. Sie können keine inkrementellen Uploads mit neuen Spalten durchführen, und Die PersonId ist in allen Uploads erforderlich.

    Screenshot, der zeigt, wie Aktivitätseinstellungen für die Zuordnung eingegeben werden.

7. Datenaktivitätseinstellungen kopieren: Einstellungen und Benutzereigenschaften

Für Einstellungen oder Benutzereigenschaften sind keine weiteren Anpassungen erforderlich. Sie können diese Einstellungen bei Bedarf von Fall zu Fall bearbeiten.

8. Aktivität zum Kopieren von Daten: Auslösen des Setups (Automatisierung)

Um der Automatisierungseinrichtung einen Trigger hinzuzufügen, wählen Sie Trigger hinzufügen aus. Die empfohlene Automatisierung erfolgt wöchentlich. Sie können auch die Häufigkeit anpassen.

Screenshot: Einrichten des Triggers

Vornehmen von Änderungen an der Verbindung oder den Daten

  • Last updated on