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, 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:
- 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.
- 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
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 | ||
| 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:
|
Alle |