檔案規則和驗證錯誤

發行項
08/07/2024

在本文中，我們會說明您上傳檔案的格式化方式，並提供您在將數據帶入進階深入解析應用程式時可能會遇到的錯誤。

檔案和欄位規則

當任何數據列或數據行具有任何屬性的無效值時，整個上傳都會失敗，直到來源檔案固定 (或對應變更屬性的驗證類型，讓值) 有效為止。

檔案的規則

數據文件必須是 .csv UTF-8 格式，而且不能是空的。

來源和目標欄位標頭的規則

所有來源與目標欄位標頭或資料列名稱都必須：

只包含 ASCII 英數位元 (字母和數位，例如 Date1) 或底線 (_) 。不支援特殊非英數位元，例如 @、#、% & 或其他字元。
包含值。
是唯一的。

自訂目標欄位標頭的規則

所有自訂目標欄位標頭或資料列名稱都必須：

沒有前置、中間或尾端空格。
不包含系統欄位，也就是：
- PeopleHistoricalId
- StartDate
- EndDate
- 網域
- PopulationType
- TimeZone
- StandardTimeZone
- WorkdayStart
- WorkDayEnd
- WeekendDays
- InferredTeamSize
- ObjectId
- IsActive
- 從「Microsoft_」開始
- MetricDate
- PrimaryCollaborator_PersonId
- SecondaryCollaborator_PersonId

必要的欄位必須有每個數據列的值。

上傳檔案之後，您只能將一個數據行標頭對應至每個 Viva Insights 數據欄位。

域值的規則

必須以正確的數據類型提供域值。請參閱屬性參考。

域值中字元的規則

數據列中域值的字元長度不能超過 128 KB，大約是 1024 x 128 個字元。
域值中不允許有「New line」 (\n) 字元。

注意事項

您可以在域值中使用雙位元組字元，例如日文字元。

ManagerId 欄位中值的規則

每個 PersonId 都必須有唯一的 ManagerId。換句話說，一個人不能有多個管理員。

不能有迴圈，其中：

經理和員工彼此報告。
經理向員工回報。

假設這個版本是 Kris 的經理。組織資料無法顯示：

Kris 向他報告，也向 Kris 回報給 Kris。
向 Kris 回報的函式。

下列兩個階層都會在用戶體驗中產生錯誤：

顯示三個人之間管理員階層循環的螢幕快照。

匯出檔案 .csv 範例

以下是有效 .csv 匯出檔案的範例代碼段：

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

驗證錯誤

以下是您將數據上傳至進階深入解析應用程式時可能會遇到的驗證錯誤。在大部分情況下，您必須更正錯誤，然後再次上傳檔案。檢閱我們的準備組織數據一文，以瞭解如何格式化數據並準備好上傳。

類別	相關規則	郵件	適用於
檔案和擴展名	數據文件必須是 .csv UTF-8 格式，而且不能是空的。	您的檔案是空的。選取另一個檔案，然後再次上傳。	僅 .csv 上傳
		此檔案的擴展名為『{0}' 無效。選取 .csv 檔案，然後再次上傳。	僅 .csv 上傳
		無效的 .csv 格式。數據列中的數據行數目不符合標頭中的數據行數目。請檢查是否有遺漏或錯置的逗號，然後再次上傳。	全部
		找到非UTF-8字元。請確定您的 .csv 檔案使用UTF-8編碼，然後再次上傳。	全部
數據行標頭	所有欄位標頭或數據行名稱都必須是唯一的。	檔案中有兩個或多個數據行標頭相同。包含每個數據行的唯一標頭。	全部
	所有欄位標頭或資料行名稱都必須包含值。	數據行 () {J} 中遺漏標頭。在您選取的檔案中包含標頭名稱，然後再次上傳。	全部
	所有欄位標頭或資料行名稱只需要包含英數位元 (字母和數位，例如 Date1) 或下列符號：~ ！ @ # $ % ^ & * + > ： <> [] ？。不支援其他字元	{標頭名稱} 包含不支援的特殊字元。拿掉特殊字元，然後再次上傳。
	所有欄位標頭或資料行名稱都不需要包含任何系統欄位。	{標頭名稱} 是系統字段。請重新命名 {header name}，使其不會使用系統字段，並再次上傳檔案。	全部
	上傳檔案之後，您只能將一個數據行標頭對應至每個 Viva Insights 數據欄位。	您的檔案有一個以上對應至數據欄位的源數據行。請確定每個源數據行都對應至唯一欄位。	全部
域值	必須以正確的數據類型提供域值。請參閱屬性參考。	無效的 {header name} 值。 {標頭名稱} 應該是窗體 `employee@contoso.com`之後的電子郵件位址。	全部
		無效的 {header name} 值。 {標頭名稱} 應該是字串。	全部
		{標頭名稱} 包含無效的值。不會上傳具有無效值的數據列。 {標頭名稱} 應該是 MM/DD/YYYY， MM/DD/YYYY 格式之後的日期， MM/DD/YYYY 後面接著更多文字 (，例如時間) 、MM-DD-YYYY、MM-DD-YY、YYYY-MM-DD、Wednesday、March 14、 2012 年 3 月 14 日、2012 年 3 月 14 日、2012 年 3 月 14 日或 3 月 12 日。 OR {標頭名稱} 包含無效的值。不會上傳具有無效值的數據列。 {標頭名稱} 應該是 DD/MM/YYYY、DD/MM/YYYY 後面的日期，後面接著更多文字 (例如時間) 、 D/MM/YYYY、D/MM/YY、DD-MM-YYYY、DD-MM-YY、YYYY-DD-MM、Wednesday、March 14、2012 年 3 月 14 日、2012 年 3 月 14 日、2012 年 3 月 14 日或 3 月 12 日。	全部
		無效的 {header name} 值。 {標頭名稱} 應為 23.75 格式之後的雙精度浮點數。	全部
		無效的 {header name} 值。 {標頭名稱} 應該是整數。	全部
	必要的欄位必須有每個數據列的值。	遺漏 {header name} 數據行或 {標頭名稱} 值。 {標頭名稱} 是必要的字段，每個數據列都需要一個值。新增 {header name} 值，然後再次上傳檔案。	全部
		遺漏新 PersonId 欄位的 ManagerId 值。 ManagerId 是必要欄位。新增對應的ManagerId字段，然後再次上傳。	全部
	每個 PersonId 都必須有唯一的 ManagerId。		全部
	不能有迴圈，其中：經理和員工彼此報告。經理向員工回報。		全部

共用方式為