Organisationsdaten hochladen (erster Upload)

Ihre Organisationsdaten können in der Advanced Insights-App der Microsoft Viva Insights auf eine von zwei Arten angezeigt werden: über Microsoft Entra ID, die die Standardquelle ist, oder über eine .csv Datei, die Sie als Administrator hochladen.

In diesem Artikel wird die zweite Option behandelt: das Hochladen einer .csv-Datei.

Wichtig

Führen Sie die folgenden Schritte nur aus, wenn Sie organisationsbezogene Daten zum ersten Mal hochladen. Wenn dies nicht Ihr erster Upload ist, lesen Sie Hochladen von Organisationsdaten (nachfolgende Uploads), um zuvor hochgeladene Daten zu aktualisieren.

Für Kunden, die über unsere Legacy-App kommen:

Wenn Sie von der älteren Advanced Insights-App migrieren und zum ersten Mal Organisationsdaten in Viva Insights hochladen, empfehlen wir, die neue App nur für Datenuploads zu verwenden. Die Verwendung der neuen App verhindert Dateninkonsistenzen.

Workflow

Nachdem Sie die Quelldaten vorbereitet haben, führen Sie die folgenden Schritte aus:

  1. Sie laden die .csv-Datei hoch.
  2. Sie ordnen Felder zu.
  3. Die App ü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.)
  4. Die App 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, sind Sie mit dem Gesamttask zum Hochladen von Daten fertig.

File upload

Führen Sie die folgenden Schritte aus, um Ihre .csv-Datei hochzuladen:

  1. Öffnen Sie die Administratoroberfläche der Advanced Insights-App .

  2. Wechseln Sie auf der Seite Datenhub zur .csv upload Karte auf der rechten Seite des Bildschirms unter Datenquelle. Screenshot: .csv Kachel

  3. Klicken Sie auf Start.

  4. Unter Schritt 1 von 2: Vorbereiten und Hochladen:

    1. Geben Sie einen Uploadnamen ein.
    2. Wählen Sie unter Datei hochladen die .csv Datei aus, die Sie hochladen möchten.

    Stellen Sie sicher, dass die datei .csv wie folgt lautet:

    • UTF-8-codiert.

    • Wird beim Starten des Uploadvorgangs nicht in einem anderen Programm geöffnet.

    • Nicht größer als 1 GB.

      Screenshot: Option

Hinweis

Um die Struktur und Richtlinien für .csv Dateien anzuzeigen und häufige Probleme beim Hochladen zu vermeiden, können Sie eine Vorlage über den Link .csv Vorlage herunterladen herunterladen.

  1. Wählen Sie zum Hochladen Weiter aus. Um den Upload abzubrechen, wählen Sie Abbrechen aus.

Feldzuordnung

Nachdem Sie Ihre Datei hochgeladen haben, wird die Seite Schritt 2 von 2: Zuordnung angezeigt. Um Erkenntnisse aus Ihren Daten anzuzeigen, müssen Sie Felder (Spalten) aus Ihrer .csv-Datei Feldnamen zuordnen, die die App erkennt.

Es gibt zwei Arten von Feldern: Systemstandard und Benutzerdefiniert.

Systemstandard (erforderlich oder optional)

Systemstandardfelder können entweder erforderlich ( PersonId, ManagerId und Organisation) oder Optional Reserviert sein. Diese Felder stellen Attribute dar, die Viva Insights kennt und in bestimmten Berechnungen über das Gruppieren und Filtern hinaus verwendet.

Wichtig

Jedes erforderliche Feld muss in jeder Zeile einen gültigen Wert haben, der nicht NULL ist. Sie müssen alle erforderlichen Viva Insights Werte zuordnen, auch wenn die Spaltenüberschriften in Ihren .csv-Dateien nicht genau mit dem namen des Viva Insights Werts übereinstimmen.

Optionale Felder sind häufig vorkommende Systemfelder, die die App vorschlägt. Sie müssen keine optionalen Felder zuordnen, wenn Ihre organization keine Daten dafür enthält.

Informationen dazu, ob ein Feld erforderlich oder optional ist, finden Sie im Abschnitt Viva-Attribute rechts neben der Zuordnungsliste. Erforderliche Attribute weisen die Bezeichnung "Erforderlich" unterhalb des Feldnamens auf, während optionale Attribute die Bezeichnung "Reserviert optional" aufweisen.

Wenn Sie die Definition eines Felds benötigen, zeigen Sie auf das Informationssymbol (i).

Screenshot: Viva-Attribute und eine Felddefinition

Benutzerdefiniert

Benutzerdefinierte Felder sind optionale Attribute, die Sie erstellen können. Im folgenden Abschnitt wird die Zuordnung und Benennung eines benutzerdefinierten Attributs erläutert.

So ordnen Sie Felder zu

Führen Sie die folgenden Schritte aus, um Ihre .csv Daten Viva Insights Attributen zuzuordnen.

Wichtig

Alle .csv Kopfzeilenfelder, die unter Quellspaltenname angezeigt werden, müssen zugeordnet werden, bevor Sie mit dem nächsten Teil des Uploadvorgangs fortfahren können.

  1. Für jedes erforderliche Viva Insights Feld:

    1. Suchen Sie die entsprechende Spaltenüberschrift unter Quellspaltenname. Um später einen Überprüfungsfehler zu verhindern, stellen Sie sicher, dass diese Spalte der richtige Datentyp ist.
    2. Öffnen Sie unter Viva Insights Feldspalte zuordnen die Dropdownliste, und wählen Sie das attribut Viva Insights aus, das der Spaltenüberschrift entspricht, die Sie in Schritt 1a identifiziert haben.
  2. Wiederholen Sie die Schritte 1a und 1b für benutzerdefinierte und optionale Felder.

    Um ein benutzerdefiniertes Feld hinzuzufügen, fügen Sie es einfach als Spalte in Ihre Datendatei ein. Die App weist ihr automatisch einen Namen zu und ordnet sie zu. Für diese Version von Viva Insights wird allen benutzerdefinierten Attributen ein Standardname zugewiesen und kann nur als Zeichenfolgendatentypen klassifiziert werden.

    Wichtig

    Laden Sie TimeZone nicht als Spalte hoch. Sie erhalten eine Fehlermeldung.

  3. Nachdem Sie die Zuordnung Ihrer Attribute abgeschlossen haben, wählen Sie unten links auf dem Bildschirm die Schaltfläche Weiter aus.

Nachdem Sie Felder zugeordnet haben, überprüft und verarbeitet die App Ihre Daten, wie in den folgenden Abschnitten beschrieben. Wenn die Validierung und Verarbeitung erfolgreich ist, sind Sie mit Ihrem Teil im Uploadvorgang fertig.

Überprüfung

Nachdem Sie Attribute zugeordnet haben, beginnt die App mit der Überprüfung Ihrer Daten.

In den meisten Fällen sollte die Dateiüberprüfung schnell abgeschlossen werden. Wenn Ihre Organisationsdatendatei groß ist, kann die Überprüfung bis zu ein oder zwei Minuten dauern.

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 Ü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 die status "Verarbeitung" in der Tabelle "Datenverbindungen > Wird hochgeladen oder gelöscht" angezeigt.

Nach Abschluss der Verarbeitung ist sie entweder erfolgreich oder fehlgeschlagen. Je nach Ergebnis erhalten Sie entweder eine Erfolgsbenachrichtigung oder eine Fehlerbenachrichtigung in der oberen rechten Ecke des Bildschirms Datenverbindungen .

Die Verarbeitung ist erfolgreich.

Wenn die Verarbeitung erfolgreich ist, wird in der Tabelle Upload or delete history (Hochladen oder Löschen des Verlaufs) die status "Success" (Erfolg) angezeigt. An diesem Punkt 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. Screenshot: Überprüfungsergebnisse
  • Wählen Sie das Zuordnungssymbol aus, um die Zuordnungseinstellungen für den Workflow anzuzeigen. Screenshot: Zuordnungseinstellungen

Hinweis

Jeder Mandant kann jeweils nur einen Upload ausführen. Sie müssen den Workflow einer Datendatei abschließen, d. h., Sie führen sie entweder zu einer erfolgreichen Überprüfung und Verarbeitung oder verlassen sie, bevor Sie mit dem Workflow der nächsten Datendatei beginnen. Die status oder Phase des Uploadworkflows wird auf der Registerkarte Datenverbindungen angezeigt.

Fehler bei der Verarbeitung

Wenn bei der Verarbeitung ein Fehler auftritt, wird in der Tabelle Upload or delete in progress (Hochladen oder Löschen in Bearbeitung) ein fehler aufgetretener status angezeigt. Wenn Sie den Link im status klicken, gelangen Sie zu einer Erklärung des Fehlers.

Wählen Sie Bearbeiten aus, oder starten Sie den neuen Upload. Mit dieser Schaltfläche können Sie den Uploadvorgang erneut starten.

Hinweis

Verarbeitungsfehler sind im Allgemeinen auf Back-End-Fehler zurückzuführen. Wenn dauerhafte Verarbeitungsfehler auftreten und Sie die Daten in Ihrer hochgeladenen Datei korrigiert haben, melden Sie ein Supportticket bei uns an.

Fehler bei der Überprüfung

Wenn die Datenüberprüfung fehlschlägt, wird ein neuer Bildschirm mit dem Fehler "Überprüfung fehlgeschlagen" und einigen Informationen zum Fehler angezeigt. Sie können die Schaltfläche Upload abbrechen auswählen, wenn Sie den Uploadvorgang nicht fortsetzen möchten.

Bevor Sie Änderungen an der Quelldatei vornehmen und den Upload erneut versuchen, können Sie Probleme herunterladen auswählen. Diese Protokolldatei beschreibt die Probleme in Ihren Daten, die die Validierungsfehler möglicherweise verursacht haben. Verwenden Sie diese Informationen, um zu entscheiden, was als Nächstes zu tun ist– korrigieren Sie die Quelldaten, oder ändern Sie Ihre Zuordnungseinstellungen.

Richtlinien zum Korrigieren von Fehlern in Daten

Wenn eine Datenzeile oder Spalte einen ungültigen Wert für ein Attribut aufweist, schlägt der gesamte Upload fehl, bis Sie die Quelldatei korrigiert haben (oder die Attributzuordnung korrigieren).

Informationen zum Formatieren Ihrer Datei zur Vermeidung von Fehlern finden Sie unter Dateiregeln und Validierungsfehler.

Vorbereiten von Organisationsdaten