Freigeben über

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

Wichtig

Dieses Feature ist nur für Kunden in der öffentlichen Vorschau verfügbar. Features in der Vorschauversion sind möglicherweise nicht vollständig und können Änderungen durchlaufen, bevor sie in der breiteren Version verfügbar werden.

Gilt für: Globaler Microsoft 365-Administrator oder Organisationsdatenquellenadministrator oder HRIS-Quellsystemadministrator

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

Importieren Sie Organisationsdaten für alle Mitarbeiter im Unternehmen, und fügen Sie alle Felder hinzu, die Sie in eine .csv-Vorlage importieren möchten. Erfahren Sie, wie Sie diese Datendatei strukturieren.

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

2. Aufrufen der API zum Importieren Ihrer Daten

Um Ihre Daten in Microsoft 365 zu importieren, können Sie aus drei Optionen auswählen:

  • 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.

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

  • Führen Sie unser PowerShell-Skript aus, das ebenfalls auf unserer API basiert. [Links zu Option 3 unten.]

Hinweis

Unsere C#- und PowerShell-Lösungen importieren nur Daten in Organisationsdaten in Microsoft 365. Sie exportieren keine Daten aus Ihrem Quellsystem.

Bevor Sie mit einer der folgenden Optionen arbeiten, stellen Sie sicher, dass Sie über diese 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. Dieses Geheimnis wird nur zum ersten Mal angezeigt, wenn der geheime Clientschlüssel erstellt wird. Führen Sie die folgenden Schritte aus, um einen neuen geheimen Clientschlüssel zu erstellen.

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

  • Microsoft Entra Mandanten-ID. Sie finden diese ID auf der Übersichtsseite der App unter Verzeichnis-ID (Mandant-ID).

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

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

Pushen von Daten

1P/3P-Umfrage-App zum Aufrufen der Microsoft 365-API zum Pushen von Inhalten

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

[Text]-Dateiinhalt als multipart/form-data

Typ: Zip-Archiv

Zu archivierende Inhalte:

Metadata.json

Data.csv

[Anforderungstext]

Body: 

{ 

   "$content-type": "multipart/form-data", 

   "$multipart":  

    [ 

        { 

            "headers":  

                { 

                    "Content-Disposition": "form-data; name=\"file\"; filename=info" 

                   }, 

            "body": @{body('Get_blob_content_(V2)')} 

         } 

    ] 

}

[Antworttext]

200:  
{ 

  "FriendlyName": "Data ingress", 

  "Id": "<ingestion Id>", 

  "ConnectorId": "<connector Id>", 

  "Submitter": "System", 

  "StartDate": "2023-05-08T19:07:07.4994043Z", 

  "Status": "NotStarted", 

  "ErrorDetail": null, 

  "EndDate": null, 

  "Type": "FileIngestion" 

}

Falls der Connector nicht festgelegt ist:

403: Forbidden

Wenn der Connector festgelegt ist, die vorherige Erfassung aber 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 die Microsoft 365 Admin Center importiert.

Ihre App kann eine beliebige Form annehmen, z. B. ein PowerShell-Skript, aber sie muss Ihre Quelldaten in der von Ihnen ausgewählten Häufigkeit als .csv Datei 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 Ihre Quelldaten in der von Ihnen ausgewählten Häufigkeit als .csv Datei exportiert haben, können Sie die C#-Lösung DescriptiveDataUploadApp in 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. Fügen 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 die PowerShell-Lösung DescriptiveDataUpload ausführen, nachdem Sie Ihre Quelldaten in der von Ihnen ausgewählten Häufigkeit als .csv Datei exportiert haben. Die PowerShell-Lösung DescriptiveDataUpload bringt Dann Ihre lokal gespeicherten Daten 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 in Ihrem 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. Parameter festlegen.

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

Vornehmen von Änderungen an der Verbindung oder den Daten

  • Last updated on