Dateiregeln und Validierungsfehler
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, kann der gesamte Upload fehlschlagen oder Warnungen ausgeben, je nachdem, ob gültige Zeilen hochladen und Zeilen mit ungültigen Daten ausschließen unter Erweiterte Konfiguration aktiviert oder deaktiviert ist.
Wenn Gültige Zeilen hochladen und Zeilen mit ungültigen Daten ausschließen unter Erweiterter Konfiguration deaktiviert ist, schlägt der gesamte Upload aufgrund von Validierungsfehlern fehl, bis die Quelldatei behoben ist (oder die Zuordnung ändert den Validierungstyp des Attributs auf eine Weise, die den Wert gültig macht).
Wenn Gültige Zeilen hochladen und Zeilen mit ungültigen Daten ausschließen unter Erweiterter Konfiguration aktiviert ist, werden nur Zeilen hochgeladen, die gültige Werte enthalten, und es werden Warnungen für die Zeilen angezeigt, die aufgrund von Fehlern nicht erfasst wurden. Diese Einstellung ist standardmäßig deaktiviert.
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:
- Enthalten nur alphanumerische ASCII-Zeichen (Buchstaben und Zahlen, z. B. Date1) oder Unterstriche (_). Spezielle nichtalphanumerische Zeichen wie @, #, %, & oder andere Zeichen werden nicht unterstützt.
- Enthält einen Wert.
- Seien Sie eindeutig.
Regeln für benutzerdefinierte Zielfeldheader
Alle benutzerdefinierten Zielfeldüberschriften oder Spaltennamen müssen:
- Es gibt keine führenden, mittleren oder nachfolgenden Leerzeichen.
- 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:
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
Protokoll für Mitarbeiter mit fehlenden Daten herunterladen
Auf der Seite Datenqualität erfahren Sie, ob in Ihrer Organisationsdatendatei gemessene Benutzer fehlen. Wenn dies der Fall ist, wird die Meldung "{number} gemessene Benutzer haben fehlende Organisationsdaten angezeigt. Laden Sie herunter, welche Benutzer über fehlende Organisationsdaten verfügen, und laden Sie ihre Daten hoch, um Erkenntnisse von höherer Qualität zu erhalten."
Das Downloadprotokoll zeigt gemessene Benutzer an, denen ein Datenfeld mit Ausnahme der Systemfelder Domäne und Zeitzone fehlt.
Validierungsfehler und -warnungen
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 | ||
| Die Datendatei für den API-basierten Import und den Azure-Blobimport muss .zip Dateiformat aufweisen und eine .csv Datei im UTF-8-Format und eine .json Zuordnungsdatei enthalten. Die Dateien dürfen nicht leer sein. | Es liegt ein Problem mit den Dateien in der .zip-Datei vor. Stellen Sie sicher, dass die .zip-Datei nur eine .json-Datei und eine .csv Datei enthält, und laden Sie sie erneut hoch. | API-basierter Import und Azure-Blobimport | |
| Die .csv-Datei in Ihrer .zip-Datei ist leer. Fügen Sie eine nicht leere .csv-Datei hinzu, und laden Sie die .zip-Datei erneut hoch. | API-basierter Import und Azure-Blobimport | ||
| Die .json-Datei in Ihrer .zip-Datei ist leer. Fügen Sie eine nicht leere .json-Datei hinzu, und laden Sie die .zip Datei erneut hoch. | API-basierter Import und Azure-Blobimport | ||
| Die .json-Datei ist ungültig. Verwenden Sie eine gültige .json datei, und laden Sie die .zip-Datei erneut hoch. | API-basierter Import und Azure-Blobimport | ||
| 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 | |
| Ihre .csv-Datei ist einem NULL- oder leeren Feld in Ihrer .json-Datei zugeordnet. Ordnen Sie es einem nicht leeren Feld zu, und laden Sie die .zip Datei erneut hoch. | API-basierter Import und Azure-Blobimport | ||
| 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 | |
| Die Headernamen in der .csv-Datei stimmen nicht mit den Feldern überein, die Sie in der .json-Datei zugeordnet haben. Stellen Sie sicher, dass die .json-Datei die gleichen Felder wie die .csv-Datei enthält, und laden Sie die .zip Datei erneut hoch. | API-basierter Import und Azure-Blobimport | ||
| Die Anzahl der Header in der .csv-Datei stimmt nicht mit den Feldern überein, die Sie in der .json-Datei zugeordnet haben. Stellen Sie sicher, dass die .json-Datei die gleichen Felder wie die .csv-Datei enthält, und laden Sie die .zip Datei erneut hoch. | API-basierter Import und Azure-Blobimport | ||
| Alle Quellspalten müssen einem unterstützten Datentyp zugeordnet werden. | Die Quellspalte ist keinem unterstützten Datentyp zugeordnet. Ordnen Sie einem unterstützten Datentyp zu, und laden Sie die Datei erneut hoch. | API-basierter Import und Azure-Blobimport | |
| Die .json-Datei gibt einen "DatasetType" an, der nicht erwartet wird. Geben Sie den richtigen Wert an, und laden Sie die .zip Datei erneut hoch. | API-basierter Import und Azure-Blobimport |
Im Folgenden finden Sie die Validierungsfehler und Warnungen im Zusammenhang mit Feldwerten. Wenn Gültige Zeilen hochladen und Zeilen mit ungültigen Daten ausschließen unter Erweiterte Konfiguration deaktiviert ist, führt dies zu Fehlern und zu Fehlern bei der Überprüfung. Wenn es aktiviert ist, werden nur Zeilen hochgeladen, die gültige Werte enthalten, und es werden Warnungen für die Zeilen angezeigt, die aufgrund von Fehlern nicht erfasst wurden. Diese Einstellung ist standardmäßig deaktiviert.
| Kategorie | Verwandte Regel | Nachricht | Fehler oder Warnung | Gilt für |
|---|---|---|---|---|
| Feldwerte | Die Datendatei muss im .csv UTF-8-Format vorliegen. | 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. | Fehler | Alle |
| Ungültiges .csv Format. Die Anzahl der Spalten in der Zeile stimmt nicht mit der Anzahl der Spalten im Header überein. Zeilen mit ungültigen Werten werden nicht hochgeladen. Überprüfen Sie, ob fehlende oder falsch eingefügte Kommas vorhanden sind, und laden Sie sie erneut hoch. | Warnung | Alle | ||
| Nicht-UTF-8-Zeichen gefunden. Stellen Sie sicher, dass ihre .csv-Datei UTF-8-Codierung verwendet, und laden Sie sie erneut hoch. | Fehler | Alle | ||
| Nicht-UTF-8-Zeichen gefunden. Zeilen mit ungültigen Werten werden nicht hochgeladen. Stellen Sie sicher, dass ihre .csv-Datei UTF-8-Codierung verwendet, und laden Sie sie erneut hoch. | Warnung | Alle | ||
| 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. |
Warnung | Alle | |
{Headername} enthält einen ungültigen Wert. Zeilen mit ungültigen Werten werden nicht hochgeladen. {Headername} sollte eine E-Mail-Adresse sein, die dem Format employee@contoso.comfolgt. |
Warnung | Alle | ||
| Ungültiger {header name}-Wert. {Headername} sollte eine Zeichenfolge sein. | Fehler | Alle | ||
| {Headername} enthält einen ungültigen Wert. Zeilen mit ungültigen Werten werden nicht hochgeladen. {Headername} sollte eine Zeichenfolge sein. | Warnung | Alle | ||
| Warnung | Alle | |||
| Ungültiger {header name}-Wert. {Headername} sollte ein Double im Format 23.75 sein. | Fehler | Alle | ||
| {Headername} enthält einen ungültigen Wert. Zeilen mit ungültigen Werten werden nicht hochgeladen. {Headername} sollte ein Double im Format 23.75 sein. | Warnung | Alle | ||
| Ungültiger {header name}-Wert. {Headername} sollte eine ganze Zahl sein. | Fehler | Alle | ||
| {Headername} enthält einen ungültigen Wert. Zeilen mit ungültigen Werten werden nicht hochgeladen. {Headername} sollte eine ganze Zahl sein. | Warnung | 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. | Fehler | 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. | Fehler | Alle | ||
| Jede PersonId muss über eine eindeutige ManagerId verfügen. | Alle | |||
Es kann keine Schleifen geben, in denen Folgendes gilt:
|
Fehler | Alle |