Aufrufen der Microsoft 365 API zum Übertragen von Organisationsdaten für den API-basierten Import (Schritt 2 von 3) (Vorschau)

Gilt für: Microsoft 365 globaler Administrator oder Administrator für organisatorische Datenquellen oder Administrator für das Personalinformationssystem

1. Vorbereiten und Exportieren Ihrer Daten in einer festgelegten Häufigkeit

Exportieren Sie Organisationsdaten für alle Mitarbeiter im Unternehmen, und fügen Sie alle Felder, die Sie importieren möchten, in eine .csv Vorlage oder eine automatisierte .csv Ausgabe in eine externe Quelle wie Workday Report as a Service (RaaS) ein. Informationen zum Strukturieren dieser Datendatei

Lassen Sie Ihre benutzerdefinierte App oder die Integration externer Quellen Organisationsdaten in der von Ihnen gewählten Häufigkeit (z. B. einmal im Monat oder einmal pro Woche) aus Ihrem Quellsystem exportieren.

2. Rufen Sie die API auf, um Ihre Daten zu importieren

Um Ihre Daten in Microsoft 365 zu importieren, können Sie eine von fünf Optionen auswählen:

1. Verwenden Sie unsere API, um eine benutzerdefinierte App zu erstellen, die Ihre Daten in der von Ihnen gewählten Häufigkeit exportiert und importiert. Anleitung.

2. Führen Sie unsere C#-Lösung auf Ihrer Konsole aus, die auf unserer API basiert. Anleitung.

3. Führen Sie unser PowerShell-Skript aus, das ebenfalls auf unserer API basiert. Anleitung.

4. Verwenden Sie eine Azure Data Factory-Vorlage, um Daten an den API-basierten Import zu senden. Anleitung.

5. Run our Node script to retrieve OAuth tokens. Verwenden Sie dann diese Token, um Daten direkt aus einer externen Quelle wie Workday an den API-basierten Import zu senden. Anleitung.

Wenn Sie mit Option 1, 2, 3 oder 4 arbeiten, stellen Sie sicher, dass Sie über die folgenden Informationen verfügen:

• App-ID (Client): Suchen Sie diese ID in den registrierten App-Informationen im Microsoft Entra Admin Center unter Anwendungs-ID (Client-ID).

• Geheimer Clientschlüssel: Dies ist eine geheime Zeichenfolge, die die Anwendung verwendet, um ihre Identität beim Anfordern eines Tokens nachzuweisen. Es wird auch als Anwendungskennwort bezeichnet. Dieser geheime Schlüssel wird nur zum ersten Mal angezeigt, wenn der geheime Clientschlüssel erstellt wird. Gehen Sie folgendermaßen vor, um einen neuen geheimen Clientschlüssel zu erstellen.

• Name des Zertifikats. Dieser Name wird in Ihrer registrierten Anwendung konfiguriert. Nachdem Sie das Zertifikat hochgeladen haben, wird der Zertifikatname unter Beschreibung im Azure-Portal angezeigt. Sie können den Zertifikatsnamen als Alternative zum geheimen Clientschlüssel verwenden.

• Microsoft Entra-Mandanten-ID. Diese ID finden Sie auf der Übersichtsseite der App unter Directory (Mandanten)-ID.

• Skalierungseinheit: Die Skalierungseinheit, die Ihnen für Ihren Mandanten zur Verfügung gestellt wird, z. B. "novaprdwus2-01".

• Die .csv Datei und der Pfad zur .csv Datei.

Wenn Sie mit Option 5 arbeiten, stellen Sie sicher, dass Sie über die folgenden Informationen verfügen:

• App-ID (Client): Suchen Sie diese ID in den registrierten App-Informationen im Microsoft 365 Admin Center unter Anwendungs-ID (Client-ID).

• Geheimer Clientschlüssel: Dies ist eine geheime Zeichenfolge, die die Anwendung verwendet, um ihre Identität beim Anfordern eines Tokens nachzuweisen. Es wird auch als Anwendungskennwort bezeichnet. Dieser geheime Schlüssel wird nur angezeigt, wenn Sie den geheimen Clientschlüssel erstellen. Erfahren Sie, wie Sie einen neuen geheimen Clientschlüssel erstellen.

• Microsoft Entra-Mandanten-ID. Diese ID finden Sie auf der Übersichtsseite der App unter Directory (Mandanten)-ID.

• Connector-ID: Dies ist die Zeichenfolge am Ende der URL, die angezeigt wird, wenn Sie Ihren API-basierten Connector im Microsoft 365 Admin Center auswählen, z. Bhttps://admin.cloud.microsoft/OrganizationalDataInM365/connection-details/[Connector ID here]. . .

• Skalierungseinheit: Die Skalierungseinheit, die Ihnen für Ihren Mandanten zur Verfügung gestellt wird, z. B. "novaprdwus2-01".

Pushen von Daten

App zum Aufrufen von Microsoft 365 API zum Pushen von Inhalten

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

Falls der Connector nicht festgelegt ist:

403: Forbidden

Wenn der Connector festgelegt ist, die vorherige Erfassung jedoch noch nicht abgeschlossen ist:

400: Bad request: Previous ingestion is not complete.

Option 1: Verwenden der Microsoft 365-API zum Erstellen einer benutzerdefinierten Import-/Export-App

Sie können die Microsoft 365-API verwenden, um eine benutzerdefinierte App zu erstellen, die automatisch Daten aus Ihrem Quellsystem exportiert und dann in das Microsoft 365 Admin Center importiert.

Ihre App kann jede Form annehmen, z. B. ein PowerShell-Skript, aber sie muss Ihre Quelldaten als .csv Datei mit der von Ihnen gewählten Häufigkeit exportieren und diese Datei in Microsoft 365-Apps und -Dienste importieren.

Option 2: Importieren von Daten über unsere C#-Lösung nach dem Exportieren von Daten über Ihre benutzerdefinierte App

Nachdem Sie die Quelldaten als .csv Datei mit der von Ihnen gewählten Häufigkeit exportiert haben, können Sie die C#-Lösung "DescriptiveDataUploadApp" auf der Konsole ausführen. Die C#-Lösung DescriptiveDataUploadApp bringt dann Ihre lokal gespeicherten Daten in Microsoft 365. Weitere Informationen finden Sie auf GitHub.

So führen Sie die Lösung aus:

1. Klonen Sie diese App auf Ihrem Computer, indem Sie den folgenden Befehl in der Befehlszeile ausführen:

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

2. Schließen Sie die folgenden Konsolenwerte ein.

   • AppID/ClientID
   • Absoluter Pfad zur .csv Datei. Formatieren Sie den Pfad wie folgt: C:\\Users\\JaneDoe\\OneDrive - Microsoft\\Desktop\\info.csv
   • Microsoft Entra-Mandanten-ID
   • Name des Zertifikats

Option 3: Ausführen der PowerShell-Lösung "DescriptiveDataUpload" nach dem Exportieren von Daten über Ihre benutzerdefinierte App

Ähnlich wie bei Option 2 können Sie, nachdem Sie Ihre Quelldaten als .csv Datei mit der von Ihnen gewählten Häufigkeit exportiert haben, die PowerShell-Lösung "DescriptiveDataUpload" auf der Konsole ausführen. Die PowerShell-Lösung "DescriptiveDataUpload" bringt Ihre lokal gespeicherten Daten dann in Microsoft 365. Weitere Informationen finden Sie auf GitHub.

1. Klonen Sie den Quellcode auf Ihrem Computer, indem Sie diesen Befehl in der Befehlszeile ausführen:

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

2. Öffnen Sie ein neues PowerShell-Fenster als Administrator.

3. Führen Sie im PowerShell-Fenster den folgenden Befehl aus:

   Install-Module -Name MSAL.PS

   Oder wechseln Sie zu diesem PowerShell-Kataloglink , um Anweisungen zur Installation zu erhalten.

4. Legen Sie Parameter fest.

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