Importieren von Organisationsdaten mithilfe des API-basierten Imports (erster Import) (Vorschau)

Ihre Organisationsdaten können in der Viva Insights-Web-App auf eine von drei Arten angezeigt werden: über Microsoft Entra ID, bei der es sich um die Standardquelle handelt; über einzelne .csv Dateien, die Sie als Insights-Administrator direkt in Viva Insights hochladen; oder über einen API-basierten Datenimport, den Sie, Ihr Quellsystemadministrator und Ihr Microsoft 365-IT-Administratorsetup durchführen.

In diesem Artikel wird die dritte Option behandelt, das Importieren von Daten.

Mit einem Import übertragen Sie Daten aus Ihrem Quellsystem über eine ZIP-Datei in die Viva Insights HR-Dateneingangs-API. Sie können eine der folgenden Aktionen ausführen:

• Erstellen Sie eine benutzerdefinierte App, um Daten aus dem Quellsystem in eine ZIP-Datei zu exportieren. Importieren Sie dann mit derselben App diese Daten mithilfe der unten angegebenen API-Informationen.
• Erstellen Sie eine benutzerdefinierte App, um Daten aus dem Quellsystem in eine ZIP-Datei zu exportieren. Führen Sie dann eine C#-Konsolen-App aus, die wir erstellt haben, um Daten in Viva Insights zu importieren.
• Erstellen Sie eine benutzerdefinierte App, um Daten aus dem Quellsystem in eine ZIP-Datei zu exportieren. Führen Sie dann ein PowerShell-Skript aus, das wir erstellt haben, um Daten in Viva Insights zu importieren.
• Verwenden Sie unsere Azure Data Factory-Vorlage (ADF), um Daten an unseren API-basierten Import zu senden.

Bevor Sie Ihre App ausführen und mit der Übertragung von Daten an Viva Insights beginnen können, müssen Sie jedoch einige Aufgaben zwischen Ihrem Microsoft 365-Administrator und dem Insights-Administrator (Insights-Administrator) koordinieren. Eine Übersicht über die erforderlichen Schritte finden Sie unter Workflow .

Workflow

1. Einstellung:

   1. Der Datenquellenadministrator generiert ein Sicherheitszertifikat und stellt es dem Microsoft 365-Administrator zur Verfügung.
   2. Mithilfe des Sicherheitszertifikats registriert der Microsoft 365-Administrator eine neue App in Azure.
   3. Mithilfe von IDs aus der App-Registrierung richtet der Insights-Administrator den Import ein.
   4. Der Datenquellenadministrator bereitet seine Daten vor und hat folgende Aktionen:
      1. Exportiert es aus dem Quellsystem mithilfe einer benutzerdefinierten App, die auf unserer API basiert, und importiert dann die Daten mit derselben App in Viva Insights.
      2. Exportiert es aus dem Quellsystem mithilfe einer benutzerdefinierten App, die auf unserer API basiert, und importiert dann die Daten mithilfe unserer C#-Lösung oder des PowerShell-Skripts in Viva Insights.

   

2. Validierung: Viva Insights überprüft Ihre Daten. (Wenn die Überprüfung nicht erfolgreich ist, können Sie aus einigen Optionen wählen, die unter Überprüfungsfehler beschrieben werden.)

3. Verarbeitung: Viva Insights verarbeitet Ihre Daten. (Wenn die Verarbeitung nicht erfolgreich ist, können Sie aus einigen Optionen wählen, die unter Verarbeitungsfehler beschrieben werden.)

Nachdem die Daten erfolgreich überprüft und verarbeitet wurden, ist der gesamte Datenimporttask abgeschlossen.

Setup

Generieren des Sicherheitszertifikats

Gilt für: Datenquellenadministrator

Um Daten aus Ihrer Quelldatei in Viva Insights zu erhalten, muss der Microsoft 365-Administrator eine App in Azure erstellen und registrieren. Als Datenquellenadministrator müssen Sie dem Microsoft 365-Administrator helfen, seine App zu registrieren, indem Sie ihm ein Sicherheitszertifikat zuweisen.

Gehen Sie wie folgt vor:

1. Erstellen Sie ein Zertifikat, indem Sie die Anweisungen in diesem Artikel befolgen: Erstellen eines selbstsignierten öffentlichen Zertifikats zum Authentifizieren Ihrer Anwendung
2. Senden Sie das generierte Zertifikat an den Microsoft 365-Administrator.

Das ist es jetzt schon. Wenn Sie bei den nächsten Schritten einen Vorsprung erhalten möchten, führen Sie die Schritte unter Exportieren Ihrer Daten mit einer festgelegten Häufigkeit aus.

Registrieren einer neuen App in Azure

Gilt für: Microsoft 365-Administrator

1. Wählen Sie in der linken Leiste des Microsoft Admin Centers die Option Alle Admin Center aus. Diese Option wird als letzte Option in der Liste angezeigt.

   

2. Wählen Sie Microsoft Entra ID aus.

3. Erstellen Sie eine neue App-Registrierung:

   1. Wählen Sie auf der oberen Symbolleiste App-Registrierung hinzufügen >aus.

      

   2. Auf dem resultierenden Bildschirm:

      1. Geben Sie Ihrer App einen Namen.
      2. Lassen Sie unter Unterstützte Kontotypen die erste Option,Nur Konten in diesem Organisationsverzeichnis (nur Ihr organization] – Einzelner Mandant) ausgewählt.
      3. Wählen Sie unten auf dem Bildschirm die Schaltfläche Registrieren aus.

      

   3. Wenn Sie zum Bildschirm Übersicht zurückkehren, kopieren Sie die Anwendungs-ID (Client-ID) und die Verzeichnis-ID (Mandant).

      

      Wichtig

      Halten Sie diese IDs bereit. Sie müssen sie später bereitstellen.

4. Hinzufügen eines Zertifikats:

   1. Wählen Sie Zertifikat oder Geheimnis hinzufügen aus.

      

   2. Wählen Sie Zertifikat hochladen aus.

      

   3. Laden Sie das Zertifikat hoch, das Ihnen der Datenquellenadministrator erteilt hat, und fügen Sie eine Beschreibung hinzu. Klicken Sie auf die Schaltfläche Hinzufügen.

      

5. Api-Berechtigungen entfernen:

   1. Wählen Sie auf der linken Schiene API-Berechtigungen aus.

   2. Wählen Sie für jeden aufgeführten API-/Berechtigungsnamen die Auslassungspunkte (...) rechts neben der API aus, z. B. Microsoft Graph.

   3. Wählen Sie Berechtigung entfernen aus.

      

   4. Bestätigen Sie die Entfernung.

   Wenn Sie Berechtigungen für diese Elemente entfernen, stellen Sie sicher, dass die App nur über Berechtigungen verfügt, die sie benötigt.

6. Geben Sie die IDs frei, die Sie sich in Schritt 3c notiert haben:

   1. Weisen Sie dem Insights-Administrator die App-ID zu.
   2. Weisen Sie dem Datenquellenadministrator die App-ID und die Mandanten-ID zu.

Einrichten des Imports in Viva Insights

Gilt für: Insights-Administrator

1. Starten Sie den Import an einer von zwei Stellen: auf der Seite Datenhub oder auf der Seite Organisationsdaten unter Datenverbindungen.

   1. Vom Datenhub:

      1. Suchen Sie im Abschnitt Datenquelle nach der API-basierten Importoption . Klicken Sie auf die Schaltfläche Start.

   2. Über Datenverbindungen:

      1. Wählen Sie neben Aktuelle Quelle die Schaltfläche Datenquellen aus.

      2. Ein Fenster Wechseln zu: API-basierter Import wird angezeigt. Klicken Sie auf Start.

2. Auf der Seite API-basierter Organisationsdatenimport :

   1. Geben Sie Ihrer Verbindung einen Namen.

   2. Geben Sie die App-ID ein, die Ihnen Ihr Microsoft 365-Administrator erteilt hat.

   3. Speichern.

3. Wählen Sie die Verbindung aus, die Sie in Schritt 3a als neue Datenquelle benannt haben.

4. Wenden Sie sich an den Datenquellenadministrator, und bitten Sie, Organisationsdaten an Viva Insights zu senden.

Vorbereiten, Exportieren und Importieren von Organisationsdaten

Tipps zum Vorbereiten Ihrer Daten

• Fügen Sie für neue Daten vollständige Verlaufsdaten für alle Mitarbeiter ein.
• Importieren Sie Organisationsdaten für alle Mitarbeiter im Unternehmen, einschließlich lizenzierter und nicht lizenzierter Mitarbeiter.
• Im Beispiel .csv Vorlage finden Sie Datenstruktur und Richtlinien, um häufige Probleme wie zu viele oder zu wenige eindeutige Werte, redundante Felder, ungültige Datenformate und vieles mehr zu vermeiden.

Exportieren Ihrer Daten mit einer festgelegten Häufigkeit

In der Häufigkeit, die Sie entscheiden (einmal pro Monat, einmal pro Woche usw.), dass Ihre benutzerdefinierte App Organisationsdaten aus Ihrem Quellsystem als ZIP-Ordner exportiert und in Ihren Dateien speichert. Dieser ZIP-Ordner basiert auf dem ordner hier. Ihr ZIP-Ordner muss eine data.csv-Datei und eine metadata.json-Datei enthalten.

Hier finden Sie einige weitere Details zu diesen Dateien und was sie enthalten müssen:

data.csv

Fügen Sie in dieser Datei alle Felder hinzu, die Sie importieren möchten. Stellen Sie sicher, dass Sie sie gemäß unseren Richtlinien unter Vorbereiten von Organisationsdaten formatieren.

metadata.json

Geben Sie die Art der Aktualisierung an, die Sie ausführen, und wie Viva Insights Ihre Felder zuordnen soll:

• "DatasetType": "HR" (Zeile 2). Lassen Sie dies unverändert.
• "IsBootstrap": (Zeile 3). Verwenden Sie "true" , um eine vollständige Aktualisierung "false" und eine inkrementelle Aktualisierung anzugeben.
• "ColumnMap":. Wenn Sie andere Namen als die von Viva Insights verwendeten verwenden, ändern Sie jeden Spaltenkopfnamen so, dass er dem entspricht, den Sie in Ihrem Quellsystem verwenden.

Zuordnungsbeispiel

Das folgende Beispiel stellt ein Feld in der metadata.json-Datei dar:

"PersonId": {
    "name": "PersonId",
    "type": "EmailType"

• "PersonId": { entspricht dem Quellspaltennamen.
• “name” : “PersonId”, entspricht dem Viva Insights-Feldnamen.
• "type": "EmailType" entspricht dem Datentyp des Felds.

Angenommen, ihr Quellsystem verwendet Employee anstelle von PersonIdfür diesen Feldheader. Um sicherzustellen, dass Ihre Felder ordnungsgemäß zugeordnet sind, bearbeiten Sie die erste Zeile unten, sodass sie wie folgt aussieht:

      "Employee": {
        "name": "PersonId",
        "type": "EmailType"

Wenn Sie Ihre Daten hochladen, wird PersonId Ihr Employee Feld in Viva Insights.

Importieren Ihrer Daten

Um Ihre Daten in Viva Insights zu importieren, können Sie aus vier 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. Weitere Informationen.
• Führen Sie unsere C#-Lösung auf Ihrer Konsole aus, die auf unserer API basiert. Weitere Informationen.
• Führen Sie unser PowerShell-Skript aus, das ebenfalls auf unserer API basiert. Weitere Informationen.
• Verwenden Sie unsere Azure Data Factory-Vorlage (ADF), um Daten an unseren API-basierten Import zu senden. Weitere Informationen.

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 auf der Azure-Portal 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. Informationen zum Erstellen eines neuen geheimen Clientschlüssels finden Sie unter Erstellen einer Microsoft Entra App und eines Dienstprinzipals im Portal.
• 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.
• Die ZIP-Datei und der Pfad zur ZIP-Datei. Ändern Sie die Dateinamen nicht data.csv und metadata.json.
• Microsoft Entra Mandanten-ID. Diese ID finden Sie auch auf der Übersichtsseite der App unter Verzeichnis-ID (Mandanten-ID).
• Skalierungseinheit: Die Skalierungseinheit, die Ihnen für Ihren Mandanten bereitgestellt wird, novaprdwus2-01z. B. .

Informationen zur Viva Insights HR-Dateneingangs-API

Zeigen Sie die folgenden Befehle an:

[Anforderungsheader]

Diese beiden Anforderungsheader sind für alle unten aufgeführten APIs erforderlich.

x-nova-scaleunit: <ScaleUnit obtained from Insights setup connection page>

Authentication: Bearer <Oauth token from AAD>

Abrufen des Connectors/Pings, um zu überprüfen, ob der Connector für einen Mandanten festgelegt ist

[GET] https://api.orginsights.viva.office.com/v1.0/scopes/<tenantId>/ingress/connectors/HR

[ResponseBody]

Wenn der Connector festgelegt ist und der Aufruferanwendung (ID) die Autorisierung gewährt wird:

200:  

{ 
       “ConnectorId”: “Connector-id-guid” 

}

Wenn der Insights-Administrator den Connector oder entfernt hat, wurde der Connector noch nicht vom Insights-Administrator festgelegt:

403: Forbidden.

Pushen von Daten

1P/3P-Umfrage-App zum Aufrufen der Viva Insights-API zum Pushen von Inhalten

[POST] https://api.orginsights.viva.office.com/v1.0/scopes/<tenantId>/ingress/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.

status

API zum Abfragen status für die Erfassung, da die Erfassung von Daten zeitintensiver Vorgang ist.

[GET] https://api.orginsights.viva.office.com/v1.0/scopes/<tenantId>/ingress/connectors/Hr/ingestions/fileIngestion/{ingestionId:guid}

[Antwort]

200: 
{ 

            "FriendlyName": "Data ingress", 

            "Id": "<ingestion Id>", 

            "ConnectorId": "<connector Id>", 

            "Submitter": "System", 

            "StartDate": "2023-05-08T19:05:44.2171692Z", 

            		  "Status": "NotStarted/ExtractionComplete/ValidationFailed 

/Completed/", 

            "ErrorDetail": null, 

            "EndDate": "2023-05-08T20:09:18.7301504Z", 

            "Type": "FileIngestion" 

}, 

Fehlerstream herunterladen, wenn die Überprüfung fehlschlägt (Problem in Daten)

[GET] https://api.orginsights.viva.office.com/v1.0/scopes/<tenantId>//Hr/ingestions/{ingestionId}/errors

[Antwort]

200: File stream with errors, if any.

Option 1: Verwenden der Viva Insights HR-Dateneingangs-API zum Erstellen einer benutzerdefinierten Import/Export-App

Sie können die Viva Insights HR-Dateneingangs-API verwenden, um eine benutzerdefinierte App zu erstellen, die automatisch Daten aus Ihrem Quellsystem exportiert und dann in Viva Insights 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 ZIP-Ordner exportieren, den Ordner in Ihren Dateien speichern und diesen Ordner in Viva Insights 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 ZIP-Ordner exportiert und in Ihren Dateien gespeichert 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 Viva Insights. 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/vivainsights_ingressupload.git.

2. Fügen Sie die folgenden Konsolenwerte ein. Beschreibungen finden Sie unter Vorbereiten, Exportieren und Importieren von Organisationsdaten.

   • AppID/ClientID
   • Absoluter Pfad zur gezippten Datei. Formatieren Sie den Pfad wie folgt: C:\\Users\\JaneDoe\\OneDrive - Microsoft\\Desktop\\info.zip
   • 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 ZIP-Ordner exportiert und in Ihren Dateien gespeichert haben. Die PowerShell-Lösung DescriptiveDataUpload bringt Dann Ihre lokal gespeicherten Daten in Viva Insights. 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/vivainsights_ingressupload.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. Beschreibungen finden Sie unter Vorbereiten, Exportieren und Importieren von Organisationsdaten .

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

Option 4: Verwenden Sie unsere Azure Data Factory-Vorlage (ADF), um Daten an unseren API-basierten Import zu senden.

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.

   

2. Erstellen einer neuen Pipeline und Aktivität

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

   

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

   

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.

• 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 die Wiederholungsversuche auf 0 festgelegt sind.
• 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.

   

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.

   

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

   

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

   

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

   

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 Viva Insights-Import-API zu konfigurieren. Suchen Sie nach "Rest", und wählen Sie Weiter aus.

   

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

   

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

   

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

   

• 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 TENANT_ID> durch Ihre Mandanten-ID: https://api.orginsights.viva.office.com/v1.0/scopes/<TENANT_ID>/ingress/connectors/HR/ingestions/fileIngestion
• Authentifizierungstyp: Wählen Sie Ihren Authentifizierungstyp als Dienstprinzipal oder Zertifikat aus. Dienstprinzipalbeispiel:
  • Inline: Wählen Sie es aus.
  • Dienstprinzipal-ID: Geben Sie die ID ein.
  • Dienstprinzipalschlüssel: Geben Sie den Schlüssel ein.
  • 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.

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

   

• 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: Der Wert kann aus Workplace Analytics abgerufen werden, indem Sie zur Registerkarte ">Organisationsdaten" navigieren:> Wählen Sie Datenquellen> verwalten aus. Wählen Sie API-basierter Import 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.

   

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.

Überprüfung

Nachdem der Datenquellenadministrator Daten gesendet hat, beginnt die App mit der Überprüfung.

Nach Abschluss dieser Phase ist die Überprüfung entweder erfolgreich oder fehlgeschlagen. Je nach Ergebnis erhalten Sie entweder eine Erfolgsbenachrichtigung oder eine Fehlerbenachrichtigung in der oberen rechten Ecke des Bildschirms Datenverbindungen .

Informationen dazu, was als Nächstes geschieht, finden Sie im entsprechenden Abschnitt:

Überprüfung erfolgreich

Fehler bei der Überprüfung

Überprüfung erfolgreich

Nach erfolgreicher Validierung beginnt Viva Insights mit der Verarbeitung Ihrer neuen Daten. Die Verarbeitung kann zwischen einigen Stunden und einem Tag dauern. Während der Verarbeitung wird in der Tabelle Importverlauf ein status "Verarbeitung" angezeigt.

Nach Abschluss der Verarbeitung ist sie entweder erfolgreich oder fehlgeschlagen. Je nach Ergebnis finden Sie in der Importverlaufstabelle entweder die status "Erfolg" oder "Fehler".

Die Verarbeitung ist erfolgreich.

Wenn Sie die status "Success" in der Tabelle Importverlauf finden, ist der Uploadvorgang abgeschlossen.

Nachdem Sie die status "Success" erhalten haben, können Sie:

• Wählen Sie das Ansichtssymbol (Auge) aus, um eine Zusammenfassung der Validierungsergebnisse anzuzeigen.
• Wählen Sie das Zuordnungssymbol aus, um die Zuordnungseinstellungen für den Workflow anzuzeigen.

Fehler bei der Verarbeitung

Wenn bei der Verarbeitung ein Fehler auftritt, wird in der Tabelle Importverlauf die status "Verarbeitung fehlgeschlagen" angezeigt. Damit die Verarbeitung erfolgreich ist, muss der Datenquellenadministrator Fehler korrigieren und die Daten erneut an Viva Insights pushen.

Fehler bei der Überprüfung

Wenn die Datenüberprüfung fehlschlägt, wird in der Tabelle Importverlauf die status "Überprüfung fehlgeschlagen" angezeigt. Damit die Überprüfung erfolgreich ist, muss der Datenquellenadministrator Fehler korrigieren und die Daten erneut an Viva Insights pushen. Wählen Sie unter Aktionen das Downloadsymbol aus, um ein Fehlerprotokoll herunterzuladen. Senden Sie dieses Protokoll an den Datenquellenadministrator, damit er weiß, was vor dem erneuten Senden der Daten korrigiert werden muss.

Der Datenquellenadministrator kann den folgenden Abschnitt hilfreich finden, um Datenfehler in der Exportdatei zu beheben.

Informationen zu Fehlern in Daten

Gilt für: Datenquellenadministrator

Wenn eine Datenzeile oder -spalte einen ungültigen Wert für ein Attribut aufweist, schlägt der gesamte Import fehl, bis der Datenquellenadministrator die Quelldaten korrigiert.

Weitere Informationen finden Sie unter Vorbereiten von Organisationsdaten für bestimmte Formatierungsregeln, die bei der Behebung von Fehlern helfen können.

Erfahren Sie mehr über Validierungsfehler und -warnungen.

Verwandte Themen

Vorbereiten von Organisationsdaten

Importieren von Organisationsdaten (anschließender Import)