上傳組織資料 (第一次上傳)

您的組織資料可以透過兩種方式之一出現在Microsoft Viva Insights的進階深入解析應用程式中:透過 Azure Active Directory-這是預設來源,或透過您作為系統管理員上傳的.csv檔案。

本文討論第二個選項,即透過.csv檔案上傳資料。 如準備 組織資料中所述準備資料之後,您必須完成下列步驟。

重要事項

只有當這是您第一次上傳組織資料時,才使用下列步驟。 如果這不是您的第一次上傳,請參閱 上傳組織資料 (後續上傳) 以更新先前上傳的資料。

對於來自繼承應用程式的客戶:

如果您是第一次從舊版進階深入解析應用程式移轉,並將組織資料上傳至Viva Insights,建議您只使用新的應用程式進行資料上傳。 使用新的應用程式可防止資料不一致。

工作流程

準備來源資料之後,上傳程式會遵循下列步驟,如下列各節所述:

  1. 您上傳.csv檔案。
  2. 您會對應欄位。
  3. 應用程式會驗證您的資料。 (如果驗證不成功,您可以從驗證 失敗中所述的幾個選項中選擇。)
  4. 應用程式會處理您的資料。 (如果處理不成功,您可以從 處理失敗中所述的幾個選項中選擇。)

在資料成功驗證和處理之後,整體資料上傳工作就會完成。

File upload

若要上傳.csv檔案,請遵循下列步驟:

  1. 在 [ 組織資料] 頁面中,選 取 [.csv上傳]顯示組織資料頁面中樞的螢幕擷取畫面。

  2. 輸入 上傳名稱

  3. [上傳檔案]底下,選取您要上傳的.csv檔案。

    請確定.csv檔案為:

    • UTF-8 編碼
    • 當您開始上傳程式時,請不要在不同的程式中開啟
    • 不大於 1 GB

    顯示 [準備和上傳資料] 選項的螢幕擷取畫面。

注意事項

若要查看.csv檔案的結構和指導方針,並避免上傳期間的常見問題,您可以透過下載.csv 範本 連結下載範本。

  1. 若要上傳,請選取 [ 下一步]。 若要取消上傳,請選取 [取消]

欄位對應

上傳檔案之後,您會看到欄位對應頁面。 若要檢視資料的深入解析,您必須將欄位 (資料行) 從您的.csv檔對應至應用程式辨識的功能變數名稱。

欄位有兩種類型: 系統預設值自訂

系統預設 (必要或選擇性)

系統預設欄位可以是 必要的,也就是 PersonIdManagerIdOrganization選擇性欄位。 這些欄位代表Viva Insights知道的屬性,並在分組和篩選以外的特定計算中使用。

重要事項

每個必要欄位在每個資料列中都必須有有效的非 Null 值。 您必須對應所有必要的Viva Insights值,即使.csv檔案中的資料行標頭與Viva Insights值名稱不完全相符。

選擇性欄位通常是應用程式建議使用的系統欄位。 如果您的組織沒有其資料,則不需要對應選擇性欄位。

若要瞭解欄位是必要還是選擇性,請參閱對應清單右側的 Viva 屬性 一節。 必要屬性具有「必要」標籤,而選擇性屬性具有「選擇性」標籤。

顯示 Viva 屬性以及對應和未對應欄位的螢幕擷取畫面。

自訂

自訂欄位是您可以建立的選擇性屬性。 下一節的步驟 2a 說明對應和命名自訂屬性。

對應欄位

請遵循下列步驟,將.csv資料對應至Viva Insights屬性。

重要事項

所有出現在 [來源資料行 名稱] 底下的.csv標頭欄位,都必須先對應,才能繼續進行上傳程式的下一個部分。

  1. 針對每個必要的Viva Insights欄位:

    1. 在 [來源資料行名稱] 底下尋找對應 的資料行標頭。 若要避免稍後發生驗證錯誤,請確定此資料行是正確的資料類型。
    2. 在 [對應至Viva Insights欄位] 資料行下,開啟下拉式清單,然後選取與您在步驟 a 中識別的資料行標頭對應的Viva Insights屬性。

    顯示對應 Viva 屬性的螢幕擷取畫面。

    提示

    將滑鼠停留在屬性名稱上方,以讀取其描述。 顯示將滑鼠停留在屬性上方的螢幕擷取畫面。

  2. 針對自訂和選擇性欄位重複步驟 1a 和 1b。

    • 若要新增自訂欄位,只要將它包含為資料檔案中的資料行即可。 應用程式會自動為其指派名稱並進行對應。 針對此版本的Viva Insights,所有自訂屬性都會被指派預設名稱,而且只能分類為字串資料類型。

      重要事項

      請勿將 TimeZone 上傳為數據行。 您會收到錯誤。

  3. 完成屬性的對應之後,選取畫面左下方的 [ 下一步 ] 按鈕。

對應欄位之後,應用程式會驗證和處理您的資料,如下列各節所述。 如果驗證和處理成功,您對上傳程式的輸入就會完成。

驗證

對應屬性之後,應用程式就會開始驗證您的資料。

顯示驗證進行中的螢幕擷取畫面。

在大部分情況下,檔案驗證應該會快速完成。 如果您的組織資料檔案很大,驗證最多可能需要一到兩分鐘的時間。

完成此階段之後,驗證會成功或失敗。 視結果而定,您會在 [ 資料聯 機] 畫面右上角收到成功通知或失敗通知。

如需接下來會發生什麼事的相關資訊,請移至適當的區段:

驗證成功

驗證失敗

驗證成功

驗證成功之後,Viva Insights開始處理新的資料。 處理可能需要幾小時到一天左右的時間。 在處理期間,您會在資料 聯 > 機上傳或刪除進行中資料 表上看到「處理」狀態。

處理完成之後,它會成功或失敗。 視結果而定,您會在 [ 資料聯 機] 畫面右上角收到成功通知或失敗通知。

處理成功

處理成功時,您會在 上傳或刪除歷程記錄 資料表中看到「成功」狀態。 此時,上傳程式已完成。

顯示成功處理的螢幕擷取畫面。

在您收到「成功」狀態之後,您可以:

  • 選取檢視 (眼) 圖示,以查看驗證結果的摘要。 顯示驗證結果的螢幕擷取畫面。
  • 選取對應圖示以查看工作流程的對應設定。 顯示對應設定的螢幕擷取畫面。

注意事項

每個租使用者一次只能有一個進行中的上傳。 您必須完成一個資料檔案的工作流程,這表示在開始下一個資料檔案的工作流程之前,先引導它進行成功的驗證和處理,或放棄它。 上傳工作流程的狀態或階段會顯示在 [ 資料連線] 索引 標籤上。

處理失敗

如果處理失敗,您會在 上傳或刪除進行中 資料表中看到失敗狀態。 選取狀態中的連結可讓您瞭解失敗的說明。

顯示處理失敗的螢幕擷取畫面。

取 [編輯] 或 [開始新的上傳]。 此按鈕可讓您再次開始上傳程式。

注意事項

處理失敗通常是因為後端錯誤。 如果您看到持續性處理失敗,且您已更正上傳檔案中的資料,請向我們記錄支援票證。

驗證失敗

如果資料驗證失敗,您會看到新的畫面,其中包含「驗證失敗」錯誤,以及有關失敗的一些資訊。 如果您不想繼續上傳程式,可以選取 [ 取消上傳 ] 按鈕。

在原始程式檔中進行變更並再次嘗試上傳之前,您可以選取 [ 下載問題]。 此記錄檔描述資料中可能造成驗證錯誤的問題。 使用此資訊來決定下一步要執行的動作:修正來源資料或變更您的對應設定。

修正資料錯誤的指導方針

本節包含修正上傳原始程式檔中造成驗證錯誤之資料的說明。

當任何資料列或資料行具有任何屬性的無效值時,整個上傳都會失敗,直到您修正原始程式檔 (或修正屬性對應) 為止。

欄位標頭的規則

所有欄位標頭或資料行名稱都必須:

  • 開頭是字母 (不是數位) 。
  • 只包含字母和數位 (英數位元,例如 Date1) 。
  • 沒有前置或尾端空格或特殊字元 (非英數位元,例如 @#%&) 。
域值的規則

資料列中的域值必須符合下列格式化規則:

  • EffectiveDateHireDate 域值必須是 MM/DD/YYYY 格式。
  • 必要的 PersonIdManagerId 域值必須是有效的電子郵件地址 (例如, gc@contoso.com) 。
  • Layer域值只需要包含數位。
  • HourlyRate域值只需要包含數位,應用程式會假設其以美金為單位來進行計算和資料分析。

注意事項

應用程式目前不會針對 HourlyRate 資料執行貨幣轉換。 所有計算和資料分析都假設資料是以美金為單位。

域值中字元的規則

下欄欄位規則適用于域值中的字元:

  • 域值中允許雙位元組字元,例如日文字元。
  • 資料列中域值的最大字元長度是 128 KB,大約是 1024 x 128 個字元。
  • 域值中不允許有 「New line」 (\n) 字元。

準備組織資料