Importieren von Organisationsdaten mit Dem Azure-Blobimport

Ihre Organisationsdaten können in der Viva Insights-Web-App auf eine von fünf 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; über einen API-basierten Import; durch Workday; oder über einen Azure-Blobimport, den Sie, Ihr Quellsystemadministrator und Ihre Azure-Mitwirkender eingerichtet haben.

In diesem Artikel wird die fünfte Option behandelt: Azure-Blobimport.

Mit einem Azure-Blobimport erstellt Ihr Azure-Mitwirkender einen Blobcontainer auf dem Azure-Portal, und Ihr Quellsystemadministrator konfiguriert einen regelmäßigen Export einer .csv-Datei an den Speicherort des Blobcontainers. Anschließend können Sie Viva Insights so einrichten, dass organization Daten automatisch aus der .csv-Datei an diesem Speicherort abgerufen werden.

Workflow

1. Einstellung:

   1. Der Azure-Mitwirkender erstellt einen sicheren Blobcontainer auf dem Azure-Portal. Der Blobspeicherort sollte für vertrauliche Unternehmensdaten sicher sein und im Azure-Abonnement des Kunden eingerichtet werden.

   2. Wenn die Azure-Mitwirkender die Dienstprinzipalautorisierung bevorzugt, autorisiert der Azure-Mitwirkender den Dienstprinzipal und stellt die Blob-URL für den Insights-Administrator und den Quellsystemadministrator bereit, indem er sie auf sichere Weise freigibt. Wenn die Azure-Mitwirkender die Dienstprinzipalautorisierung nicht bevorzugt, wird eine SAS-URL generiert und dem Insights-Administrator und dem Quellsystemadministrator bereitgestellt.

   3. Der Quellsystemadministrator bereitet die Daten in einer .csv-Datei und .json Zuordnungsdatei vor und konfiguriert einen regelmäßigen Export der .csv-Datei aus dem HR-Quellsystem in den Blobcontainer.

   4. Der Insights-Administrator gibt die URL in die Viva Insights-App ein, um den Import aus dem Azure-Blobspeicherort zu aktivieren. Der Insights-Administrator lädt auch die vom Quellsystemadministrator bereitgestellte .json-Zuordnungsdatei hoch.

2. Validierung: Viva Insights überprüft die 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 die 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

1. Erstellen eines sicheren Blobcontainers

Gilt für: Azure Mitwirkender

1. Öffnen Sie einen Browser, und melden Sie sich beim Azure-Portal Ihrer organization an.

2. Wählen Sie unter Azure-Dienstedie Option Speicherkonten aus.

3. Wählen Sie oben links unter Speicherkonten die Option Erstellen aus, um ein neues Speicherkonto zu erstellen.

4. Verwenden Sie unter Projektdetails die Standardeinstellungen.

5. Geben Sie unter Instanzdetails einen Speicherkontonamen ein, und wählen Sie Ihre Region aus. Für Leistung und Redundanz können Sie die Standardeinstellungen verwenden, es sei denn, Sie müssen Änderungen vornehmen.

6. Wählen Sie unten Weiter: Erweitert aus.

7. Wählen Sie auf der Seite Erweitert die Option "Sichere Übertragung für REST-API-Vorgänge erforderlich", "Zugriff auf Speicherkontoschlüssel aktivieren" und "Hierarchischen Namespace aktivieren" aus. Wählen Sie für "Tls-Mindestversion" mindestens Version 1.2 aus.

8. Für alle anderen erweiterten Einstellungen können Sie die Standardeinstellungen verwenden, es sei denn, Sie müssen Änderungen vornehmen.

9. Wählen Sie unten Weiter: Netzwerk aus.

10. Wählen Sie unter Netzwerkkonnektivitätdie Option Öffentlichen Zugriff aus allen Netzwerken aktivieren oder Aus ausgewählten virtuellen Netzwerken und IP-Adressen aktiviert aus. Wenn Sie die zweite Option auswählen, wählen Sie unter Firewall die Option Client-IP-Adresse hinzufügen aus, und geben Sie die IP-Adresse für die Zulassungsliste an, die vom Insights-Administrator freigegeben wurde.

11. Wählen Sie unter Netzwerkrouting Ihre Routingpräferenz aus.

12. Wählen Sie unten Weiter: Datenschutz aus.

13. Auf der Seite Datenschutz können Sie die Standardeinstellungen verwenden, es sei denn, Sie müssen Änderungen vornehmen.

14. Wählen Sie unten Weiter: Verschlüsselung aus.

15. Auf der Seite Verschlüsselung können Sie die Standardeinstellungen verwenden, es sei denn, Sie müssen Änderungen vornehmen.

16. Wählen Sie unten Weiter: Tags aus.

17. Optional: Fügen Sie dem Konto Tags hinzu.

18. Wählen Sie unten Weiter: Überprüfen aus.

19. Überprüfen Sie Ihre Auswahl. Wählen Sie dann unten links Erstellen aus.

20. Auf der nächsten Seite wird eine Meldung mit der Meldung "Bereitstellung wird ausgeführt" angezeigt. Nach Abschluss der Bereitstellung werden Ihr Speicherkonto und die zugehörigen Einstellungen angezeigt.

21. Wählen Sie links unter Datenspeicher die Option Container aus.

22. Um einen neuen Container zu erstellen, wählen Sie oben Container aus. Geben Sie dann auf der rechten Seite einen Namen für den Container ein, z. B. "hrupload". Wählen Sie unten Erstellen aus.

2. Autorisieren des Blobcontainers

Gilt für: Mitwirkender an Azure Mitwirkender- und Storage-Blobdaten

Als Nächstes müssen Sie eine Blob-SAS-URL für die Autorisierung oder eine Blob-URL erstellen, wenn Sie die Dienstprinzipalautorisierung verwenden. Die Dienstprinzipalautorisierung ist der empfohlene und sicherere Ansatz. Das Blob-SAS-Token verfügt über keine integrierten Überwachungsfunktionen. Führen Sie die unten angegebenen Schritte für die von Ihnen ausgewählte Methode aus.

Für die Dienstprinzipalautorisierung:

1. Wählen Sie im linken Bereich Access Control aus.

2. Wählen Sie oben Rollenzuweisungen aus. Wählen Sie Hinzufügen und dann Rollenzuweisung hinzufügen aus.

3. Suchen Sie in der Liste der Rollen nach Storage-Blobdatenleser, und wählen Sie diese Option aus.

4. Wählen Sie neben Mitglieder die Option Mitglieder auswählen aus. Geben Sie im Suchfeld auf der rechten Seite Workplace Analytics ein, und wählen Sie es aus.

5. Wählen Sie unten links Überprüfen + zuweisen aus.

6. Wählen Sie im linken Bereich unter Datenspeicher die Option Container aus.

7. Wählen Sie den Speichercontainer aus, den Sie in den obigen Schritten erstellt haben.

8. Wählen Sie im linken Bereich unter Einstellungen die Option Eigenschaften aus.

9. Kopieren Sie die URL, und geben Sie sie sicher mit dem Insights-Administrator und dem Quellsystemadministrator weiter.

Für die SAS-URL-Autorisierung:

1. Wenn der von Ihnen erstellte neue Speichercontainer angezeigt wird, wählen Sie ihn aus. Wählen Sie dann links unter Einstellungendie Option Zugriffsrichtlinie aus.

2. Wählen Sie unter Gespeicherte Zugriffsrichtlinien die Option Richtlinie hinzufügen aus. Geben Sie einen eindeutigen Bezeichner an, z. B. "BlobStore". Wählen Sie Lese - und Listenberechtigungen aus. Wählen Sie eine Startzeit für einige Minuten in der Vergangenheit und eine Endzeit in einem Jahr aus.

3. Wählen Sie links unter Einstellungen die Option Freigegebene Zugriffstoken aus.

4. Sie können die Standardoption unter Signaturschlüssel verwenden. Wählen Sie unter Gespeicherte Zugriffsrichtlinie die oben erstellte Richtlinie aus. Dadurch werden das Ablauffenster und die Berechtigungsliste automatisch aufgefüllt.

5. Für Zulässige IP-Adressen und Zulässige Protokolle können Sie die Standardeinstellungen verwenden.

6. Wählen Sie SAS-Token und URL generieren aus.

7. Kopieren Sie die Blob-SAS-URL, und geben Sie sie sicher für den Insights-Administrator weiter.

8. Informieren Sie den Quellsystemadministrator, wer die Daten in diesem Container auffüllt. Sie benötigen Zugriff auf Mitwirkender an Storage-Blobdaten.

3. Einrichten von Viva Insights zum Importieren von Daten aus dem Blobspeicherort

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. Wählen Sie im Abschnitt Datenquelle unter Azure-Blobimport die Option Start aus.

   2. Über Datenverbindungen:

      1. Wählen Sie neben Aktuelle Quelle die Option Datenquellen verwalten aus.
      2. Ein Azure-Blobimportfenster wird angezeigt. Klicken Sie auf Start.

2. Geben Sie unter Verbindungsname einen eindeutigen Namen für den Import ein.

3. Wählen Sie unter Autorisierungstypdie Option Dienstprinzipalautorisierung oder SAS-URL-Autorisierung aus. Ihre Auswahl hängt von der Autorisierungsmethode ab, die von Ihrem Azure Mitwirkender oben in Schritt 2 verwendet wird.

4. Senden Sie Ihre Azure Mitwirkender Ihre IP-Adresse für die Zulassungsliste.

5. Geben Sie die Blob-SAS-URL oder die Blob-URL für den Import ein, der Ihnen vom Azure-Mitwirkender in Schritt 2 bereitgestellt wird.

6. Laden Sie die vom Quellsystemadministrator bereitgestellte .json-Zuordnungsdatei hoch.

7. Wählen Sie Aktiviert und dann Speichern aus.

8. Wenn eine Fehlermeldung angezeigt wird, überprüfen Sie, ob Sie alle oben beschriebenen Schritte ausgeführt haben, und stellen Sie sicher, dass die eingegebene Blob-SAS-URL oder Blob-URL korrekt ist. Wählen Sie Wiederholen aus.

4. Vorbereiten von Organisationsdaten .csv Datei und .json Zuordnungsdatei und Senden an den Blobspeicher

Gilt für: Quellsystemadministrator

Aufgabe 1: Vorbereiten der Daten

Bevor Sie mit dem Exportieren und Importieren Ihrer Daten beginnen, stellen Sie sicher, dass Sie Ihre Datei gemäß den Schritten 1 bis 4 unter Vorbereiten einer Organisationsdatendateiupload vorbereiten. Sie können dieses Dokument auch verwenden, um informationen zu erforderlichen und reservierten optionalen Attributen zu erhalten.

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. Erfahren Sie mehr über Dateiregeln und Validierungsfehler.

Aufgabe 2: Exportieren von Daten aus dem Quellsystem

In der häufigkeit, die Sie entscheiden (einmal pro Monat, einmal pro Woche usw.) programmgesteuert Organisationsdaten aus Ihrem Quellsystem als .csv-Datei zu exportieren. Weitere Informationen finden Sie in diesem Beispiel .csv Vorlage. Formatieren Sie die Datei gemäß unseren Richtlinien.

Um die Datei manuell in den Blobspeicherort hochzuladen, der vom Azure-Mitwirkender in Schritt 1 erstellt wurde, senden Sie die .csv-Datei an die Azure Mitwirkender- oder Storage Blob Data-Mitwirkender (sofern Ihnen diese Rollen nicht bereits zugewiesen sind), und bitten Sie sie, die folgenden Schritte auszuführen:

1. Öffnen Sie einen Browser, und geben Sie die vom Azure-Mitwirkender bereitgestellte Blob-SAS-URL ein.

2. Wählen Sie oben Hochladen aus. Laden Sie dann auf der rechten Seite die .csv Datei hoch, die Sie mithilfe der obigen Anweisungen erstellt haben.

Vorbereiten .json Zuordnungsdatei und Senden an den Insights-Administrator

Geben Sie den Typ der Aktualisierung an, den Sie ausführen, und wie Viva Insights Ihre Felder zuordnen sollen:

• “DatasetType”: “HR” (Zeile 2). Lassen Sie dies unverändert.

• “IsBootstrap”: (Zeile 3). Verwenden Sie "true", um eine vollständige Aktualisierung anzugeben, und "false", um eine inkrementelle Aktualisierung anzugeben.

• "Zuordnung": Wenn Sie andere Namen als die von Viva Insights verwenden, ändern Sie jeden Spaltenheadernamen so, dass er dem entspricht, den Sie in Ihrem Quellsystem verwenden.

Zuordnungsbeispiel

Das folgende Beispiel stellt ein Feld dar, das Sie in der Beispieldatei .json finden:

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

• "PersonId": { entspricht dem Quellspaltennamen.

• “name” : “PersonId”entspricht dem feldnamen Viva Insights.

• "type": "EmailType" entspricht dem Datentyp des Felds.

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

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

Wenn Sie Ihre Daten hochladen, wird Das Feld Mitarbeiter in Viva Insights zu PersonId.

Senden Sie dann die .json-Zuordnungsdatei an den Insights-Administrator, um sie in Insights hochzuladen, während Sie die Verbindung für den Azure-Blobimport einrichten.

5. Validierung

Gilt für: Insights-Administrator

Nachdem der Quellsystemadministrator die Daten exportiert und Sie den Import eingerichtet haben, beginnt die App mit der Überprüfung. In den meisten Fällen sollte die Dateiüberprüfung schnell abgeschlossen werden.

Nach Abschluss dieser Phase ist die Überprüfung entweder erfolgreich oder fehlgeschlagen. Abhängig vom Ergebnis erhalten Sie entweder eine erfolgreiche status oder einen Fehler status in der Tabelle "Importverlauf" in Datenverbindungen mit Organisationsdaten>.

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 Überprüfung 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 Importverlaufstabelle der 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, finden Sie in der Tabelle Importverlauf den status "Verarbeitungsfehler". Damit die Verarbeitung erfolgreich ist, muss der Quellsystemadministrator 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 Quellsystemadministrator 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 Quellsystemadministrator, damit er weiß, was vor dem erneuten Senden der Daten korrigiert werden muss.

Der Quellsystemadministrator kann den folgenden Abschnitt hilfreich finden, um Datenfehler in seiner Exportdatei zu beheben.

Informationen zu Fehlern in Daten

Gilt für: Quellsystemadministrator

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, mit denen Fehler behoben werden können.

Erfahren Sie mehr über Validierungsfehler und -warnungen.

Angehaltener Zustand

Wenn in der Tabelle "Importverlauf" die status "Angehalten" angezeigt wird oder Wenn Sie Datenquellen verwalten auswählen, bedeutet dies, dass Ihre Autorisierungsanmeldeinformationen abgelaufen sind oder der Zugriff widerrufen wurde. Sie müssen Ihre Anmeldeinformationen aktualisieren und die Datenquelle erneut verbinden.

Verwalten der Datenquelle und Vornehmen von Änderungen

Gilt für: Insights-Administrator

Nachdem Sie Ihren Datenimport eingerichtet haben, führen Sie die folgenden Schritte aus, um Änderungen vorzunehmen, z. B. das Festlegen einer neuen Blobspeicher-URL oder das Deaktivieren automatisierter Importe.

1. Wählen Sie auf der Seite Organisationsdaten unter Datenverbindungen die Option Datenquellen verwalten aus.
2. Wählen Sie unter Azure-Blobimportdie Option Verwalten aus.

Auf der nächsten Seite können Sie den Verbindungsnamen, die Blob-SAS-URL oder die Blob-URL bearbeiten. Wenn Sie die SAS-URL oder den URI aktualisieren, wird der neue Speicherort für zukünftige Datenaktualisierungen verwendet.

Sie können automatisierte Importe auch aktivieren oder deaktivieren. Wenn Sie fertig sind, wählen Sie Speichern aus.

Wenden Sie sich an ihren Quellsystemadministrator, um die Organisationsdaten mithilfe der vorhandenen Blob-SAS-URL oder Blob-URL zu ersetzen oder zu bearbeiten. Wenn Sie Daten in Viva Insights importieren, führen Sie entweder eine vollständige oder eine inkrementelle Aktualisierung durch. Wenn Sie Felder löschen möchten, können Sie dazu eine vollständige Aktualisierung verwenden.

Angeben einer vollständigen oder inkrementellen Aktualisierung

1. Wechseln Sie in der .json-Zuordnungsdatei zu Zeile 3.
2. Aktualisieren Sie die “IsBootstrap”: -Eigenschaft auf eine der folgenden Eigenschaften:
   1. Verwenden Sie “IsBootstrap” : “true”für eine vollständige Aktualisierung .
   2. Verwenden Sie  “IsBootstrap” : “false”für eine inkrementelle Aktualisierung .

Wenn der Import ausgeführt wird, beginnt Viva Insights, Ihre Daten entweder als vollständige oder inkrementelle Aktualisierung zu verarbeiten, je nachdem, was Sie in der .json-Zuordnungsdatei angegeben haben.

Aktualisierungstypen

Full

Wenn Sie eine vollständige Aktualisierung durchführen, ersetzen Sie alle Daten Ihrer organization in Viva Insights, d. h., Sie überschreiben, was Sie bereits importiert haben. Wenn Sie eine vollständige Aktualisierung durchführen, stellen Sie sicher, dass Sie Daten für alle lizenzierten und nicht lizenzierten Mitarbeiter bereitstellen (d. h. diejenigen, die über ein Viva Insights-Abonnement verfügen, und für diejenigen, die dies nicht getan haben). Wir beschreiben weiter unten in diesem Artikel, welche Felder bereitgestellt werden sollen.

Sie können eine vollständige Aktualisierung verwenden, um Felder zu löschen, da Felder, die Sie weglassen, nicht in Ihren Daten angezeigt werden. Im nächsten Abschnitt wird das Löschen von Daten behandelt.

Löschen von Feldern mit vollständigen Aktualisierungen

Um Felder mit einer vollständigen Aktualisierung zu löschen, exportieren Sie Ihre Daten als .csv, die alle Felder mit Ausnahme der Felder enthält, die Sie löschen möchten. Da eine vollständige Aktualisierung vorhandene Daten ersetzt, erhalten Sie am Ende jedes Feld mit Ausnahme der Felder, die Sie beim Import ausgelassen haben.

Inkrementell

Führen Sie eine inkrementelle Aktualisierung durch, wenn Sie nur einige neue Informationen zu Organisationsdaten hinzufügen möchten, die Sie bereits in Viva Insights hochgeladen haben. So können Sie eine inkrementelle Aktualisierung ausführen:

• Hinzufügen neuer Mitarbeiter
• Hinzufügen neuer Attribute für vorhandene Mitarbeiter
• Hinzufügen neuer Attribute für neue Mitarbeiter
• Bearbeiten der Attribute vorhandener Mitarbeiter

Im Folgenden finden Sie einige Beispiele dafür, wann Sie eine inkrementelle Aktualisierung durchführen können:

Beispiel: Hinzufügen neuer Mitarbeiter

Angenommen, Sie möchten Fünf neue Mitarbeiter zu Ihren Organisationsdaten hinzufügen. Während des Imports würden Sie Folgendes einschließen:

• Fünf Zeilen, die neue Mitarbeiterdaten enthalten.
• Erforderliche Attribute: PersonId, ManagerId, Organization und EffectiveDate.
• Alle reservierten optionalen Felder (z. B. HireDate), die Sie bereits in Viva Insights importiert haben.

Nachdem der Import abgeschlossen ist, ist die einzige Änderung, die Sie bemerken würden, fünf neue Zeilen und deren Werte.

Beispiel: Hinzufügen eines neuen Attributs

Vielleicht möchten Sie für alle vorhandenen Mitarbeiter ein optionales reserviertes Attribut hinzufügen, das noch nicht in Ihren Daten enthalten war – sagen wir standort. Wenn Sie Ihre Daten importieren, würden Sie nur location,PersonId und EffectiveDate mit aktuellen und historischen Werten für jeden Mitarbeiter in Ihre .csv-Datei einschließen. Nach Abschluss des Imports finden Sie die gleichen Daten wie zuvor, mit Ausnahme einer neuen Spalte für jeden Mitarbeiter, Standort.

Felder, die in die .csv Datei für vollständige und inkrementelle Aktualisierungen eingeschlossen werden sollen

Fügen Sie für die unten aufgeführten Aktualisierungstypen die Felder in der folgenden Tabelle in Ihre .csv-Datei ein. Formatieren Sie diese Felder gemäß unseren Richtlinien unter Vorbereiten von Organisationsdaten.

Verwandte Themen

Vorbereiten von Organisationsdaten