共用方式為

解決與無效或非預期值相關的檔案上傳警告

  • 發行項

當您將員工屬性數據上傳至 Microsoft Viva Glint 時，您會收到下列其中一則警告訊息。 從文章頂端的清單中選取您遇到的警告，並遵循適當的解決方案來修正問題。

RECORD_STAGING_FAILURE

警告訊息：

RECORD_STAGING_FAILURE：找到 <先前已刪除的 x> 個與行號 <y> 相對應的現有記錄。

如果使用者從 Microsoft Entra ID 中刪除，且 Viva Glint 中的對應記錄標示為 已刪除，就會發生此問題。 [ 忽略先前刪除的員工標識符] 設定會管理 Viva Glint 如何處理已刪除的用戶記錄。

解決方法

若要修正此問題，請使用下列其中一種方法：

  • 如果您使用 [人員] 頁面上的 [匯入] 上傳數據，請確認上傳。 如此一來，將會略過在 entra ID 和 Viva Glint Microsoft 中標示為已刪除的記錄。 所有其他沒有其他錯誤或警告的數據都會匯入 Viva Glint。

    注意：如果您使用 Viva Glint Secure File Transfer Protocol （SFTP） 上傳數據，則會自動略過標示為已刪除的記錄。

  • 拿掉已刪除的記錄，然後再次上傳檔案。 執行下列步驟:

    1. 如有必要，請與您的 Microsoft 365 或 Entra ID 系統管理員合作，確認從 Microsoft Entra ID 中刪除的使用者。

    2. 開啟員工屬性數據檔。 根據檔案類型使用適當的方法：

      • 如果數據檔具有 .xls 或 .xlsx 擴展名，請在 Microsoft Excel 中開啟它。
      • 如果數據檔具有.csv擴展名，請使用 [文字匯入精靈]，藉由保留原始格式的數據，將數據匯入 Excel。

    3. 拿掉警告訊息中列出的數據列。

      注意：標頭數據列未包含在數據列計數中。 例如，如果警告指出第 20 行，請移至第 21 列。

    4. 儲存盤案，然後將它再次上傳至 Viva Glint。

INVALID_EMPLOYEE_DATA：不支援的字元

警告訊息：

INVALID_EMPLOYEE_DATA：略過行號 <x> ，因為數據 <行 y> 包含不支援的字元。

發生此問題的原因是您上傳的檔案包含舊的漢字字元。 Viva Glint 僅支援新式漢字字元。

解決方法

若要修正問題，請依照下列步驟執行：

  1. 開啟員工屬性數據檔。 根據檔案類型使用適當的方法：

    • 如果數據檔具有 .xls 或 .xlsx 擴展名，請在 Microsoft Excel 中開啟它。
    • 如果數據檔具有.csv擴展名，請使用 [文字匯入精靈]，藉由保留原始格式的數據，將數據匯入 Excel。

  2. 找出警告訊息中列出的數據列。

    注意：標頭數據列未包含在數據列計數中。 例如，如果警告指出第 20 行，請移至第 21 列。

  3. 檢閱警告訊息中列出的數據行值。

  4. 以現代漢字字元取代所有舊的漢字字元。 或者，刪除舊的漢字字元。

  5. 儲存盤案，然後將它再次上傳至 Viva Glint。

MISSING_REQUIRED_VALUE

警告訊息：

MISSING_REQUIRED_VALUE：第 x> 行<遺漏 [員工名字]、[員工姓氏] 和 [用戶標識符<>的電子郵件位址] 的必要值。

如果檔案中的員工記錄遺漏下列一或多個必要欄位的值，就會發生此問題：

  • 名字
  • 姓氏
  • 電子郵件地址
  • 員工識別碼
  • 狀態

解決方法

若要修正問題，請依照下列步驟執行：

  1. 檢閱員工屬性數據檔，以識別必要字段遺漏值的數據列。

  2. 使用有效值完成受影響的欄位。

    注意：對於只提供名字的員工，請使用 連字元 （-） 或句號 （.） 填入 [姓氏 ] 字段。

  3. 儲存盤案，然後將它再次上傳至 Viva Glint。

INVALID_EMAIL

警告訊息：

INVALID_EMAIL：有 <沒有有效工作電子郵件的員工數目> ，這可能與員工標識符傳送為電子郵件值的員工相關。

解決方法

若要修正此問題，請確認電子郵件位址的格式有效，包括登入 （@） 和網域。 如果您已使用員工標識碼刻意填入 Email 屬性，請考慮將 @<組織的網域> 附加至 [員工標識符] 值，以滿足此驗證。

FIELD_TOO_BIG_FATAL

警告訊息：

FIELD_TOO_BIG_FATAL：必要欄位 <[屬性名稱> ] 不能超過 64 個字元。

解決方法

若要修正此問題，請檢查可能不小心串在一起的欄位。 檢閱檔案，並確認所有必要的屬性具有小於 64 個字元的值。

注意：針對 [ 狀態] 字段，限制為 32 個字元。

CHAR_LIMIT_EXCEED_NON_MANDATORY

警告訊息：

CHAR_LIMIT_EXCEED_NON_MANDATORY：非必要字段 <[屬性名稱> ] 超過 64 個字元。 因此，值已截斷為64個字元，也就是報告中顯示的值。 （受影響的員工人數： <數位>）

解決方法

若要修正此問題，請檢查可能不小心串在一起的欄位。 檢閱檔案，並確認這些屬性的值少於64個字元。 視需要縮短任何截斷的值，然後將檔案上傳至 Viva Glint。

SUSPICIOUS_VALUE

警告訊息：

SUSPICIOUS_VALUE：員工標識符<>的員工<屬性名稱>值包含可疑字元。 檢查可能已損毀的特殊/非預期字元，並重新載入您的檔案以更正。

解決方法

若要修正此問題，請檢查檔案中是否有下列字元，並視需要將其移除：

  • 不常見的字元，例如 ？ 或_
  • 可能損毀的特殊語言字元

然後，再次將檔案上傳至 Viva Glint。

INVALID_STATUS

警告訊息：

INVALID_STATUS：狀態值 'LEAVE' 無效。 此值在所有上限中都必須正好是 「ACTIVE」 或 「INACTIVE」。。

解決方法

若要修正此問題，請確定 Status 屬性的值只包含 ACTIVE 或 INACTIVE（全部大寫）。

UNEXPECTED_ATTRIBUTE

警告訊息：

UNEXPECTED_ATTRIBUTE：下列屬性/屬性 '<Attribute Name>' 位於 檔案中，但未在Viva Glint 中設定。

此問題發生於下列其中一種情況：

  • 上傳的檔案中有新的屬性，但不包含在 Viva Glint 中設定的屬性中。
  • 有一個現有屬性，其標籤在上傳檔案的標頭數據列中已變更。 例如， Department 已變更為 Division。
  • Status 屬性未正確儲存在 Viva Glint 中，並列在警告訊息中。

解決方法

若要修正此問題，請使用下列其中一種方法，視原因而定：

  • 如果上傳的檔案中有新的屬性， 請將 屬性 新增至 Viva Glint。

  • 如果上傳的檔案中有已重新命名的現有屬性， 請在 Viva Glint 中重新命名屬性 。

  • 如果 [狀態] 屬性列在警告訊息中，請遵循 Viva Glint 中的下列步驟：

    1. 將屬性重新命名為暫存值，並儲存變更。
    2. 將名稱還原為正確的值。

更新屬性之後，請再次將檔案上傳至 Viva Glint。

INVALID_LOCALE

警告訊息：

INVALID_LOCALE：行 <x> 地區設定值 <地區> 設定不是有效的地區設定字串。

如果您上傳的檔案包含無效的語言代碼值，就會發生此問題。

解決方法

若要修正問題，請依照下列步驟執行：

  1. 開啟員工屬性數據檔。 根據檔案類型使用適當的方法：

    • 如果數據檔具有 .xls 或 .xlsx 擴展名，請在 Microsoft Excel 中開啟它。
    • 如果數據檔具有.csv擴展名，請使用 [文字匯入精靈]，藉由保留原始格式的數據，將數據匯入 Excel。

  2. 找出警告訊息中列出的數據列。

    注意：標頭數據列未包含在數據列計數中。 例如，如果警告指出第 20 行，請移至第 21 列。

  3. 將無效 的地區 設定值取代為有效的值。 如需有效的語言代碼值清單，請下載 Viva Glint Employee 屬性範本、選取 [語言代碼] 工作表，然後檢查 [語言代碼] 資料行中的值。

  4. 儲存盤案，然後將它再次上傳至 Viva Glint。

INVALID_USER_TIMEZONE

警告訊息：

INVALID_USER_TIMEZONE：用戶<>時區值<時區>行 x 不是有效的國際時區字串。

如果您上傳的檔案包含無效的時區值，就會發生此問題。

解決方法

若要修正問題，請依照下列步驟執行：

  1. 開啟員工屬性數據檔。 根據檔案類型使用適當的方法：

    • 如果數據檔具有 .xls 或 .xlsx 擴展名，請在 Microsoft Excel 中開啟它。
    • 如果數據檔具有.csv擴展名，請使用 [文字匯入精靈]，藉由保留原始格式的數據，將數據匯入 Excel。

  2. 找出警告訊息中列出的數據列。

    注意：標頭數據列未包含在數據列計數中。 例如，如果警告指出第 20 行，請移至第 21 列。

  3. 將無效 的使用者時區 值取代為有效的值。 如需有效時區值的清單，請下載 Viva Glint Employee 屬性範本、選取 [時區] 工作表，然後檢查 [標準時區] 資料行中的值。

  4. 儲存盤案，然後將它再次上傳至 Viva Glint。

INVALID_PERSONAL_EMAIL

警告訊息：

INVALID_PERSONAL_EMAIL：第 x> 行<個人電子郵件值 '<email address>' 的格式不像有效的電子郵件位址。

之所以發生此問題，是因為您嘗試上傳的檔案包含個人電子郵件地址屬性的無效值。

解決方法

若要修正問題，請依照下列步驟執行：

  1. 開啟員工屬性數據檔。 根據檔案類型使用適當的方法：

    • 如果數據檔具有 .xls 或 .xlsx 擴展名，請在 Microsoft Excel 中開啟它。
    • 如果數據檔具有.csv擴展名，請使用 [文字匯入精靈]，藉由保留原始格式的數據，將數據匯入 Excel。

  2. 找出警告訊息中列出的數據列。

    注意：標頭數據列未包含在數據列計數中。 例如，如果警告指出第 20 行，請移至第 21 列。

  3. 將無效 的個人電子郵件 值取代為有效的值。 有效的電子郵件地址會使用下列語法：

    <username>@<email domain>

    例如： john@outlook.com 。

  4. 儲存盤案，然後將它再次上傳至 Viva Glint。

    注意：您可以確認目前的上傳，並在未來的上傳中新增更正的位址。 不過，在更正之前，格式無效的個人電子郵件位址仍會與 Viva Glint 中受影響的使用者相關聯。