Dateiregeln und Validierungsfehler

  • Artikel

In diesem Artikel wird beschrieben, wie Ihre Uploaddatei formatiert werden muss, und geben Fehler an, die beim Einbinden von Daten in die Advanced Insights-App auftreten können.

Datei- und Feldregeln

Wenn eine Datenzeile oder Spalte einen ungültigen Wert für ein Attribut aufweist, schlägt der gesamte Upload fehl, bis die Quelldatei behoben ist (oder die Zuordnung ändert den Validierungstyp des Attributs auf eine Weise, die den Wert gültig macht).

Regeln für die Datei

Die Datendatei muss im .csv UTF-8-Format vorliegen und darf nicht leer sein.

Regeln für Quell- und Zielfeldheader

Alle Quell- und Zielfeldheader- oder Spaltennamen müssen:

  1. Enthalten nur alphanumerische ASCII-Zeichen (Buchstaben und Zahlen, z. B. Date1) oder Unterstriche (_). Spezielle nicht alphanumerische Zeichen wie @, #, %, & oder andere Zeichen werden nicht unterstützt.
  2. Enthält einen Wert.
  3. Seien Sie eindeutig.

Regeln für benutzerdefinierte Zielfeldheader

Alle benutzerdefinierten Zielfeldüberschriften oder Spaltennamen müssen:

  1. Es gibt keine führenden, mittleren oder nachfolgenden Leerzeichen.
  2. Enthält keine Systemfelder, die:
    • PeopleHistoricalId
    • StartDate
    • EndDate
    • Domäne
    • PopulationType
    • TimeZone
    • StandardTimeZone
    • WorkdayStart
    • WorkDayEnd
    • WeekendDays
    • InferredTeamSize
    • ObjectId
    • IsActive
    • Ab "Microsoft_"
    • MetricDate
    • PrimaryCollaborator_PersonId
    • SecondaryCollaborator_PersonId

Pflichtfelder müssen für jede Zeile einen Wert aufweisen.

Nachdem Sie Ihre Datei hochgeladen haben, können Sie jedem Viva Insights-Datenfeld nur eine Spaltenüberschrift zuordnen.

Regeln für Feldwerte

Feldwerte müssen im richtigen Datentyp bereitgestellt werden. Weitere Informationen finden Sie unter Attributverweis.

Regeln für Zeichen in Feldwerten

  • Die Zeichenlänge von Feldwerten in Zeilen darf 128 KB nicht überschreiten, was etwa 1024 x 128 Zeichen entspricht.
  • "Neue Zeile" (\n) Zeichen sind in Feldwerten nicht zulässig.

Hinweis

Sie können Doppelbytezeichen, z. B. japanische Zeichen, in den Feldwerten verwenden.

Regeln für Werte im Feld ManagerId

Jede PersonId muss über eine eindeutige ManagerId verfügen. Anders ausgedrückt: Es dürfen nicht mehrere Manager für eine Person vorhanden sein.

Es kann keine Schleifen geben, in denen Folgendes gilt:

  • Manager und Mitarbeiter melden sich gegenseitig.
  • Vorgesetzte melden sich an die Mitarbeiter zurück.

Angenommen, Dylan ist Kris' Manager. Die Organisationsdaten konnten folgendes nicht anzeigen:

  • Kris berichtet an Dylan und auch Dylan zurück an Kris.
  • Dylan berichtet an Kris.

Beide der folgenden Hierarchien würden Fehler in der Endbenutzererfahrung verursachen:

Screenshot: Schleife der Managerhierarchie zwischen drei Personen

Beispiel .csv Exportdatei

Hier sehen Sie einen Beispielausschnitt einer gültigen .csv Exportdatei:

PersonId,EffectiveDate,HireDate,ManagerId,LevelDesignation,Organization,Layer,Area Emp1@contoso.com,12/1/2020,1/3/2014,Mgr1@contoso.com,Junior IC,Sales,8,Southeast Emp2@contoso.com,11/1/2020,1/3/2014,Mgr1@contoso.com,Junior IC,Sales,8,Southeast Emp3@contoso.com,12/1/2020,1/3/2014,Mgr2@contoso.com,Manager,Sales,7,Northeast Emp4@contoso.com,10/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest Emp5@contoso.com,11/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest Emp6@contoso.com,12/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest

Validierungsfehler

Im Folgenden finden Sie Validierungsfehler, die beim Hochladen von Daten in die Advanced Insights-App auftreten können. In den meisten Fällen müssen Sie die Fehler korrigieren und die Datei erneut hochladen. Lesen Sie unseren Artikel Vorbereiten von Organisationsdaten , um zu erfahren, wie Sie Ihre Daten formatieren und für den Upload vorbereiten.

Kategorie Verwandte Regel Nachricht Gilt für
Datei- und Dateierweiterungen Die Datendatei muss im .csv UTF-8-Format vorliegen und darf nicht leer sein. Ihre Datei ist leer. Wählen Sie eine andere Datei aus, und laden Sie sie erneut hoch. .csv nur hochladen
Diese Datei hat eine ungültige Erweiterung von '{0}'. Wählen Sie eine .csv Datei aus, und laden Sie sie erneut hoch. .csv nur hochladen
Ungültiges .csv Format. Die Anzahl der Spalten in der Zeile stimmt nicht mit der Anzahl der Spalten im Header überein. Überprüfen Sie, ob fehlende oder falsch eingefügte Kommas vorhanden sind, und laden Sie sie erneut hoch. Alle
Nicht-UTF-8-Zeichen gefunden. Stellen Sie sicher, dass ihre .csv-Datei UTF-8-Codierung verwendet, und laden Sie sie erneut hoch. Alle
Spaltenüberschriften Alle Feldkopf- oder Spaltennamen müssen eindeutig sein. Zwei oder mehr Spaltenüberschriften in Ihrer Datei sind identisch. Fügen Sie eindeutige Header für jede Spalte ein. Alle
Alle Feldkopf- oder Spaltennamen müssen einen Wert enthalten. Header fehlt in Spalte(n) {J}. Fügen Sie den Headernamen in die ausgewählte Datei ein, und laden Sie sie erneut hoch. Alle
Alle Feldkopf- oder Spaltennamen müssen nur alphanumerische Zeichen (Buchstaben und Zahlen, z. B. Date1) oder die folgenden Symbole enthalten: ~ ! @ # $ % ^ & * + > : <> [] ?. Andere Zeichen werden nicht unterstützt. {Headername} enthält nicht unterstützte Sonderzeichen. Entfernen Sie die Sonderzeichen, und laden Sie sie erneut hoch.
Alle Feldheader- oder Spaltennamen müssen keine Systemfelder enthalten. {header name} ist ein Systemfeld. Benennen Sie {header name} um, damit kein Systemfeld verwendet wird, und laden Sie die Datei erneut hoch. Alle
Nachdem Sie Ihre Datei hochgeladen haben, können Sie jedem Viva Insights-Datenfeld nur eine Spaltenüberschrift zuordnen. Ihrer Datei sind mehr als eine Quellspalte zugeordnet, die einem Datenfeld zugeordnet ist. Stellen Sie sicher, dass jede Quellspalte einem eindeutigen Feld zugeordnet ist. Alle
Feldwerte Feldwerte müssen im richtigen Datentyp bereitgestellt werden. Weitere Informationen finden Sie unter Attributverweis. Ungültiger {header name}-Wert. {Headername} sollte eine E-Mail-Adresse sein, die dem Format employee@contoso.comfolgt. Alle
Ungültiger {header name}-Wert. {Headername} sollte eine Zeichenfolge sein. Alle
  • {Headername} enthält einen ungültigen Wert. Zeilen mit ungültigen Werten werden nicht hochgeladen. {Headername} sollte ein Datum sein, das dem Format MM/TT/JJJJ, MM/TT/JJJJ folgt, MM/TT/JJJJ gefolgt von weiterem Text (z. B. Zeit), MM-TT-JJJJ, MM-TT-JJJJ, JJJJ-MM-TT, Mittwoch, 14. März 2012, 14. März 2012, 14.03.2012 oder 14.03.2012.
  • ODER
  • {Headername} enthält einen ungültigen Wert. Zeilen mit ungültigen Werten werden nicht hochgeladen. {Headername} sollte ein Datum sein, das dem Format TT/MM/JJJJ, TT/MM/JJJJ gefolgt von weiterem Text (z. B. Uhrzeit), D/MM/JJJJ folgt, D/MM/JJ, TT-MM-JJJJ, TT-MM-JJJJ , JJJJ-TT-MM, Mittwoch, 14. März 2012, 14. März 2012, 14.03.2012 oder 14. März 12.
    		•  Alle
    Ungültiger {header name}-Wert. {Headername} sollte ein Double im Format 23.75 sein. Alle
    Ungültiger {header name}-Wert. {Headername} sollte eine ganze Zahl sein. Alle
    Pflichtfelder müssen für jede Zeile einen Wert aufweisen. Fehlende {header name}-Spalte oder {Headername}-Wert. {Headername} ist ein Pflichtfeld und benötigt für jede Zeile einen Wert. Fügen Sie den Wert {header name} hinzu, und laden Sie die Datei erneut hoch. Alle
    Fehlender ManagerId-Wert für das neue PersonId-Feld. ManagerId ist ein erforderliches Feld. Fügen Sie das entsprechende Feld ManagerId hinzu, und laden Sie es erneut hoch. Alle
    Jede PersonId muss über eine eindeutige ManagerId verfügen. Alle
    Es kann keine Schleifen geben, in denen Folgendes gilt:
    • Manager und Mitarbeiter melden sich gegenseitig.
    • Vorgesetzte melden sich an die Mitarbeiter zurück.
    		 Alle