透過基於 API 的匯入匯入 (後續匯入) (預覽)

本文討論兩種匯入方式：完整匯入與增量匯入。 這些匯入會刷新你在設定 Viva Insights 連線時提供的資料。

關於後續進口

當你匯入資料到 Viva Insights 時，你會執行完整刷新或增量刷新。 如果你想刪除欄位，可以用完整刷新來完成。

你在 首次匯入) (導入組織資料 時所建立的自訂匯出應用程式，加上我們在 GitHub 上建立的 DescriptiveDataUploadApp，都能協助我們接下來提到的刷新。 簡單回顧一下，當 DescriptiveDataUploadApp 執行時，它會從你從 GitHub 下載的壓縮資料夾拉取資料。 此壓縮資料夾包含以下檔案：

• data.csv，裡面包含你想匯入的欄位。
• metadata.json，它會將你的來源欄位映射到 Viva Insights 的欄位。 你也會用metadata.json告訴 Viva Insights 你的刷新是完整還是增量，正如我們在下一節會說明的。

如何標示完整或增量刷新

1. metadata.json，請前往第3行。
2. 將該物業更新 “IsBootstrap”: 為以下其中之一：
   • 若要完整刷新，請使用 “IsBootstrap” : “true”。
   • 若要進行增量刷新，請使用 “IsBootstrap” : “false”。

當 DescriptiveDataUploadApp 執行時，Viva Insights 會根據你在metadata.json中指定的內容，開始以完整或增量刷新的方式處理你的資料。

刷新類型

Full

當你進行全面刷新時，你是在替換 Viva Insights 中組織所有的資料——也就是說，你覆蓋了已經匯入的資料。 進行全面更新時，務必提供所有持照與無執照員工的資料， (包括有 Viva Insights 訂閱者與未) 者。 本文 稍後 會說明要提供哪些欄位。

你可以用完整刷新來刪除欄位，因為你省略的欄位不會顯示在資料中。 我們會在下一節討論刪除資料。

完整刷新後刪除欄位

要完整刷新刪除欄位，請匯出資料作為包含除你想刪除欄位 外 所有欄位的 .csv。 因為完整刷新會替換現有資料，最後你會看到除了匯入時遺漏的欄位以外的所有欄位。

增量

當你只想為已上傳到 Viva Insights 的組織資料新增一些資訊時，進行增量式刷新。 以下是你可以透過漸進式更新來做的事情：

• 新增員工
• 為現有員工新增屬性
• 新增屬性給新員工
• 編輯現有員工的屬性

以下是幾個你可以進行增量刷新的例子：

新增員工

假設你想在組織資料中新增五位新員工。 在匯入過程中，你會包含：

• 五列包含新員工資料。
• 所需屬性： PersonId、 ManagerId、 組織與 生效日期。
• 所有保留的選用欄位 (例如你已經匯入到 Viva Insights 的 HireDate) 。

匯入完成後，你唯一會注意到的變化是新增五列及其數值。

新增屬性

也許你想為所有現有員工新增一個之前沒有的可選保留屬性——比如 位置。 當你要匯入資料時，你只會在 .csv 檔案中包含 位置、 PersonID 和 EffectiveDate，以及每位員工的當前和過去值。 匯入完成後，你會看到之前相同的資料，只是每位員工多了一欄「 地點」。

data.csv 中應包含的欄位，用於完整與增量式更新

以下列出的刷新類型，請在您的 data.csv 檔案中包含以下欄位。 務必：

• 依照我們在 「準備組織資料」中的指引格式化這些欄位。
• 移除metadata.json檔案中未包含的欄位。
• 把 data.csv 和metadata.json檔案都放在你從 GitHub 下載的壓縮資料夾裡。 當你執行 DescriptiveDataUploadApp 時，你會提供壓縮的資料夾路徑。 Viva Insights 會從這個位置擷取你的資料。