檔案規則和驗證錯誤
在本文中，我們會說明您上傳檔案的格式化方式，並提供您在將數據帶入進階深入解析應用程式時可能會遇到的錯誤。
檔案和欄位規則
當任何數據列或數據行對於任何屬性都有無效的值時，整個上傳可能會失敗或產生警告，視 [進階設定] 下的[上傳有效數據列] 和 [排除具有無效數據的數據列] 開啟或關閉而定。
如果關閉 [進階組態] 下具有無效數據的上傳有效數據列和排除數據列，則整個上傳會因為驗證錯誤而失敗，直到來源檔案修正 (或對應變更屬性的驗證類型，讓值) 有效為止。
如果在 [進階設定] 下開啟 [上傳有效數據列] 並排除具有無效數據的數據列，則只會上傳包含有效值的數據列，並顯示因錯誤而未擷取之數據列的警告。 根據預設，此設定為關閉狀態。
檔案的規則
數據文件必須是 .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
下載遺漏數據之員工的記錄
[ 資料品質 ] 頁面可讓您知道組織數據檔中是否有遺漏測量的使用者。 如果是，您會看到訊息：「{number} 測量的用戶遺失組織數據。 下載哪些用戶遺失組織數據，並上傳其數據以取得更高品質的深入解析。」
下載記錄會顯示除了網域和 TimeZone 系統欄位 之外 ，遺漏任何數據欄位的測量使用者。
驗證錯誤和警告
以下是您將數據上傳至進階深入解析應用程式時可能會遇到的驗證錯誤。 在大部分情況下，您必須更正錯誤，然後再次上傳檔案。 檢閱我們的 準備組織數據 一文，以瞭解如何格式化數據並準備好上傳。
| 類別 | 相關規則 | 郵件 | 適用於 |
|---|---|---|---|
| 檔案和擴展名 | 數據文件必須是 .csv UTF-8 格式，而且不能是空的。 | 您的檔案是空的。 選取另一個檔案，然後再次上傳。 | 僅 .csv 上傳 |
| 此檔案的擴展名為 『{0}' 無效。 選取 .csv 檔案，然後再次上傳。 | 僅 .csv 上傳 | ||
| API 型匯入和 Azure Blob 匯入的數據文件必須是 .zip 檔格式，並包含一個 UTF-8 格式的 .csv 檔案，以及一個.json對應檔案。 檔案不能是空的。 | .zip 檔案中的檔案有問題。 請確定 .zip 檔案只包含一個.json檔案和一個 .csv 檔案，然後再上傳一次。 | 以 API 為基礎的匯入和 Azure Blob 匯入 | |
| .zip 檔案中的 .csv 檔案是空的。 新增非空白 .csv 檔案，然後再次上傳 .zip 檔案。 | 以 API 為基礎的匯入和 Azure Blob 匯入 | ||
| .zip 檔案中的.json檔案是空的。 新增非空白.json檔案，然後再次上傳 .zip 檔案。 | 以 API 為基礎的匯入和 Azure Blob 匯入 | ||
| .json檔案無效。 使用有效的.json檔案，然後再次上傳 .zip 檔案。 | 以 API 為基礎的匯入和 Azure Blob 匯入 | ||
| 數據行標頭 | 所有欄位標頭或數據行名稱都必須是唯一的。 | 檔案中有兩個或多個數據行標頭相同。 包含每個數據行的唯一標頭。 | 全部 |
| 所有欄位標頭或資料行名稱都必須包含值。 | 數據行 () {J} 中遺漏標頭。 在您選取的檔案中包含標頭名稱，然後再次上傳。 | 全部 | |
| 您的 .csv 檔案會對應至.json檔案中的 null 或空白字段。 將它對應至非空白欄位，然後再次上傳 .zip 檔案。 | 以 API 為基礎的匯入和 Azure Blob 匯入 | ||
| 所有欄位標頭或資料行名稱只需要包含英數位元 (字母和數位，例如 Date1) 或下列符號：~ ！ @ # $ % ^ & * + > ： <> [] ？。 不支援其他字元 | {標頭名稱} 包含不支援的特殊字元。 拿掉特殊字元，然後再次上傳。 | ||
| 所有欄位標頭或資料行名稱都不需要包含任何系統欄位。 | {標頭名稱} 是系統字段。 請重新命名 {header name}，使其不會使用系統字段，並再次上傳檔案。 | 全部 | |
| 上傳檔案之後，您只能將一個數據行標頭對應至每個 Viva Insights 數據欄位。 | 您的檔案有一個以上對應至數據欄位的源數據行。 請確定每個源數據行都對應至唯一欄位。 | 全部 | |
| .csv 檔案中的標頭名稱與您在.json檔案中對應的欄位不符。 請確定.json檔案包含與 .csv 檔案相同的字段，然後再次上傳 .zip 檔案。 | 以 API 為基礎的匯入和 Azure Blob 匯入 | ||
| .csv 檔案中的標頭數目與您在.json檔案中對應的字段不符。 請確定.json檔案包含與 .csv 檔案相同的字段，然後再次上傳 .zip 檔案。 | 以 API 為基礎的匯入和 Azure Blob 匯入 | ||
| 所有源數據行都必須對應至支持的數據類型 | 源數據行未對應至支持的數據類型。 對應至支持的數據類型，然後再次上傳檔案。 | 以 API 為基礎的匯入和 Azure Blob 匯入 | |
| .json檔會指定非預期的 「DatasetType」。 指定正確的值，然後再次上傳 .zip 檔案。 | 以 API 為基礎的匯入和 Azure Blob 匯入 |
以下是與域值相關的驗證錯誤和警告。 如果關閉 [進階設定] 底下具有無效數據的上傳有效數據列和排除數據列，則會產生錯誤並使驗證失敗。 如果已開啟，則只會上傳包含有效值的數據列，而且會顯示因為錯誤而未內嵌之數據列的警告。 根據預設，此設定為關閉狀態。
| 類別 | 相關規則 | 郵件 | 錯誤或警告 | 適用於 |
|---|---|---|---|---|
| 域值 | 數據文件必須是 .csv UTF-8 格式。 | 無效的 .csv 格式。 數據列中的數據行數目不符合標頭中的數據行數目。 請檢查是否有遺漏或錯置的逗號，然後再次上傳。 | 錯誤 | 全部 |
| 無效的 .csv 格式。 數據列中的數據行數目不符合標頭中的數據行數目。 不會上傳具有無效值的數據列。 請檢查是否有遺漏或錯置的逗號，然後再次上傳。 | 警告 | 全部 | ||
| 找到非UTF-8字元。 請確定您的 .csv 檔案使用UTF-8編碼，然後再次上傳。 | 錯誤 | 全部 | ||
| 找到非UTF-8字元。 不會上傳具有無效值的數據列。 請確定您的 .csv 檔案使用UTF-8編碼，然後再次上傳。 | 警告 | 全部 | ||
| 必須以正確的數據類型提供域值。 請參閱 屬性參考。 | 無效的 {header name} 值。 {標頭名稱} 應該是窗體 employee@contoso.com之後的電子郵件位址。 |
警告 | 全部 | |
{標頭名稱} 包含無效的值。 不會上傳具有無效值的數據列。 {標頭名稱} 應該是窗體 employee@contoso.com之後的電子郵件位址。 |
警告 | 全部 | ||
| 無效的 {header name} 值。 {標頭名稱} 應該是字串。 | 錯誤 | 全部 | ||
| {標頭名稱} 包含無效的值。 不會上傳具有無效值的數據列。 {標頭名稱} 應該是字串。 | 警告 | 全部 | ||
| 警告 | 全部 | |||
| 無效的 {header name} 值。 {標頭名稱} 應為 23.75 格式之後的雙精度浮點數。 | 錯誤 | 全部 | ||
| {標頭名稱} 包含無效的值。 不會上傳具有無效值的數據列。 {標頭名稱} 應為 23.75 格式之後的雙精度浮點數。 | 警告 | 全部 | ||
| 無效的 {header name} 值。 {標頭名稱} 應該是整數。 | 錯誤 | 全部 | ||
| {標頭名稱} 包含無效的值。 不會上傳具有無效值的數據列。 {標頭名稱} 應該是整數。 | 警告 | 全部 | ||
| 必要的欄位必須有每個數據列的值。 | 遺漏 {header name} 數據行或 {標頭名稱} 值。 {標頭名稱} 是必要的字段，每個數據列都需要一個值。 新增 {header name} 值，然後再次上傳檔案。 | 錯誤 | 全部 | |
| 遺漏新 PersonId 欄位的 ManagerId 值。 ManagerId 是必要欄位。 新增對應的ManagerId字段，然後再次上傳。 | 錯誤 | 全部 | ||
| 每個 PersonId 都必須有唯一的 ManagerId。 | 全部 | |||
不能有 迴圈， 其中：
|
錯誤 | 全部 |