重要事項
Viva Insights 網頁應用程式已不再支援新增與編輯組織資料上傳。 若要上傳您的組織 (人力資源) 資料，請使用Microsoft 365 系統管理中心。 資料刪除與全部替換功能仍可在 Viva Insights 網頁應用程式中使用。 深入了解。
您的組織資料可以透過兩種方式出現在 Viva Insights 網頁應用程式中：透過預設來源Microsoft Entra ID，或是您作為管理員上傳的 .csv 檔案。
這篇文章談到了第二個選項：上傳 .csv 檔案。
重要事項
只有在你第一次上傳組織資料時，才使用以下步驟。 如果這不是你第一次上傳，請參考 「上傳組織資料 (後續上傳) 以更新先前上傳的資料。
工作流程
在準備完原始資料後，你會依照以下步驟操作：
- 你上傳 .csv 檔案。
- 你繪製欄位。
- 應用程式會驗證你的資料。 (如果驗證失敗，你可以從「 驗證失敗」中描述的幾個選項中選擇 )
- 應用程式會處理你的資料。 (如果處理失敗，你可以從「 處理失敗」中描述的幾個選項中選擇 )
當資料成功驗證並處理後，整體資料上傳任務就完成了。
File upload
要上傳您的 .csv 檔案，請依照以下步驟操作：
開啟 Viva Insights 網頁應用程式 管理體驗。
在資料集線頁面，請前往畫面右側資料來源下方的 .csv 上傳卡。
選取 [開始]。
在 步驟 1 中：準備並上傳：
- 輸入 上傳名稱。
- 在 上傳檔案中，選擇你想上傳的 .csv 檔案。
確保 .csv 檔案是：
UTF-8 編碼。
開始上傳流程時，不會在其他程式中開啟。
不要超過 1 GB。
注意事項
若要查看 .csv 檔案的結構與指引，並避免上傳過程中常見問題，您可以透過 「下載 .csv 範本 」連結下載範本。
- 要上傳，請選擇 「下一頁」。 若要取消上傳，請選擇 取消。
場域映射
上傳檔案後，你會看到「 步驟2/2：地圖繪製 」頁面。 要從你的資料中查看洞察，你需要將 .csv 檔案) 欄位 (對應到應用程式能辨識的欄位名稱。
有兩種欄位： 系統預設 和 自訂。
系統預設 (必須或可選)
系統預設欄位可以是 必填 （如 PersonId、 ManagerId、 Organization 或保留）選 用。 這些欄位代表 Viva Insights 已知並在特定計算中使用的屬性，超越了分組與篩選。
重要事項
每個必填欄位必須在每一列都有有效且非空值。 你需要對應所有必要的 Viva Insights 值，即使 .csv 檔案中的欄位標頭和 Viva Insights 的值名稱不完全一致。
可選欄位是應用程式建議使用的系統常見欄位。 如果你的組織沒有相關資料，你不需要映射可選欄位。
欲知欄位是必需還是可選，請參閱映射列表右側的 Viva 屬性 區塊。 必要屬性欄位名稱下方有「Required」標籤，而可選屬性則有「保留可選」標籤。
如果你需要欄位的定義，請將滑鼠移到資訊 (i) 圖示上。
自訂
自訂欄位是你可以建立的可選屬性。 以下章節說明映射與自訂屬性命名。
映射域
請依照以下步驟將您的 .csv 資料映射到 Viva Insights 的屬性。
重要事項
所有 .csv 標頭欄位（位於 來源欄位名稱下）都必須先對應，才能進入上傳流程的下一階段。
對於每個必填的 Viva Insights 欄位：
- 在 來源欄位名稱下找到對應的欄位標頭。 為避免日後驗證錯誤，請確認此欄位為正確的資料型態。
- 在 「Map to Viva Insights 」欄位 欄中，打開下拉選單，選擇與第 1a 步驟中所識別欄位標頭對應的 Viva Insights 屬性。
重複步驟 1a 和 1b，針對自訂和可選欄位。
要新增自訂欄位，只要把它當作資料檔的欄位來包含即可。 應用程式會自動為它命名並映射。 在這個版本的 Viva Insights，所有自訂屬性都會被賦予預設名稱，且只能被歸類為 字串 資料型別。
重要事項
不要把 TimeZone 當作欄位上傳。 你會收到錯誤訊息。
完成屬性映射後，選擇畫面左下角的 「下一個 」按鈕。
在你映射欄位後，應用程式會依照以下章節的說明驗證並處理你的資料。 如果驗證和處理成功，你在上傳過程中的部分就完成了。
驗證
當你映射好屬性後，應用程式會開始驗證你的資料。
在大多數情況下，檔案驗證應該會很快完成。 如果您的組織資料檔案很大，驗證可能需要一到兩分鐘。
此階段結束後，驗證要麼成功，要麼失敗。 根據結果，你會在 資料連線 畫面右上角收到成功通知或失敗通知。
關於接下來發生的事，請前往相關章節：
驗證成功
驗證成功後，Viva Insights 會開始處理您的新資料。 處理過程可能需要幾小時到一兩天不等。 處理過程中，你會在 「資料連接 > 上傳或刪除進行中 」表格上看到「處理中」狀態。
處理完成後，要麼成功，要麼失敗。 根據結果，你會在 資料連線 畫面右上角收到成功通知或失敗通知。
處理成功
當處理成功時，你會在 上傳或刪除歷史 表中看到「成功」狀態。 此時，上傳程序已完成。
以下是組織資料上傳後，通常需要多久才能反映在以下經驗中：
成功狀態顯示於 資料連線 > 匯入歷史： 數小時內
資料品質分頁、彈性查詢與 Power BI 範本： 一到兩天
Teams 應用程式中的領導者/經理報告： 下週更新
當您獲得「成功」狀態後，您可以：
- 選擇「視 (眼) 圖示，即可查看驗證結果摘要。
- 選擇映射圖示以查看工作流程的映射設定。
注意事項
每個租戶一次只能有一份上傳進行中。 你需要完成一個資料檔案的工作流程，這表示你要麼引導它成功驗證與處理，要麼放棄它，然後再開始下一個資料檔案的工作流程。 上傳工作流程的狀態或階段會顯示在 資料連接 標籤上。
處理失敗
如果處理失敗，你會在「 上傳或刪除進行 中」表格中看到失敗狀態。 在狀態中選擇連結會帶你進入失敗說明。
選擇 編輯或開始新上傳。 這個按鈕可以讓你重新開始上傳流程。
注意事項
處理失敗通常是因為後端錯誤。 如果你看到持續處理失敗，且已修正上傳檔案中的資料，請向我們提出支援單。
驗證失敗
如果資料驗證失敗，你會看到一個新畫面，顯示「驗證失敗」錯誤，並顯示失敗資訊。 如果你不想繼續上傳流程，可以選擇 取消上傳 按鈕。
在你修改原始檔案並嘗試再次上傳之前，可以選擇 下載問題。 這個日誌檔案描述了可能導致驗證錯誤的資料問題。 利用這些資訊決定下一步該怎麼做：修正來源資料或更改你的映射設定。
資料錯誤修正指引
當任何資料列或欄位的屬性值無效時，整個上傳都會失敗，除非你修正來源檔案 (或屬性映射) 。
想了解如何格式化檔案以防止錯誤，請參考 檔案規則與驗證錯誤。