選項 4：使用 Azure Data Factory 範本將資料傳送至 API 型匯入

請遵循下列步驟，使用 Azure Data Factory 範本將資料傳送至 API 型匯入。

1. 建立新的 Azure Data Factory

  1. https://adf.azure.com/en/datafactories登入 。

  2. 建立新的 Data Factory 或使用現有的 Data Factory。 填寫欄位， 然後選取 建立。

    顯示如何建立新 Data Factory 或使用現有 Data Factory 的螢幕擷取畫面。

2. 建立新的管線和活動

  1. 建立新的管線並輸入管線的名稱。

    顯示如何建立新管線的螢幕擷取畫面。

  2. 在 [活動] 底下，新增 [複製資料]。

    顯示如何新增複製資料的螢幕擷取畫面。

3. 複製資料活動設定：一般

選取您的 複製資料 活動，然後選取 一般 以使用下列指引完成每個欄位。

顯示如何複製資料活動設定的螢幕擷取畫面。

  • 名稱：輸入活動的名稱。
  • 描述：輸入活動的描述。
  • 活動狀態：選取 [已啟用]。 或者，選取 [ 已停用] 以從管線執行和驗證中排除活動。
  • 逾時：這是活動可以執行的最大時間量。 預設值為 12 小時，最小值為 10 分鐘，允許的時間上限為 7 天。 格式為 D.HH：MM：SS。
  • 重試：最大重試次數。 這可以保留為 0。
  • 重試間隔 (秒) ：重試次數上限。 如果重試嘗試設定為 0，則可以保留為 30。
  • 安全輸出：選取時，活動的輸出不會在記錄中擷取。 您可以將此選項保持清除。
  • 安全輸入：選取時，記錄中不會擷取活動的輸入。 您可以將此選項保持清除。

4. 複製資料活動設定： 來源

  1. 選取 來源。

  2. 選取現有的來源資料集，或選取 [+新增 ] 以建立新的來源資料集。 例如，在 [新增資料集] 底下選取 [Azure Blob 儲存體]，然後選取資料的格式類型。

    顯示如何建立新來源資料集的螢幕擷取畫面。

  3. 設定 .csv 檔案的屬性。 輸入 [名稱 ]，然後在 [連結的服務] 下選取現有位置，或選取 [+新增]。

    顯示如何設定 csv 檔案屬性的螢幕擷取畫面。

  4. 如果您選取 [+新增]，請使用下列指導方針輸入新連結服務的詳細資料。

    顯示如何新增新連結服務的詳細資料的螢幕擷取畫面。

  5. 在 [來源資料集] 旁邊，選取 [開啟]。

    顯示如何開啟來源資料集的螢幕擷取畫面。

  6. 選取 [第一列] 做為標題。

    顯示如何選取第一列做為標題的螢幕擷取畫面。

5. 複製資料活動設定：接收器

  1. 選取 [接收]。

  2. 選取 [+新增 ] 以設定新的 REST 資源以連線至 API。 搜尋 [休息]，然後選取 [繼續]。

    顯示如何設定新的 REST 資源以連線到 API 的螢幕擷取畫面。

  3. 為服務命名。 在 [連結的服務] 底下，選取 [+新增]。

    顯示如何命名服務及新增連結服務的螢幕擷取畫面。

  4. 搜尋 “Rest” 並選取它。

    顯示如何搜尋 Rest 資料集的螢幕擷取畫面。

  5. 使用下列指引輸入欄位。

    顯示如何輸入資料集欄位的螢幕擷取畫面。

  • 名稱：輸入新連結服務的名稱。
  • 描述：輸入新連結服務的描述。
  • 透過整合執行階段連線： 輸入慣用方法。
  • 基底 URL：使用下列 URL，並將 {tenantid} 取代為您的租用戶識別碼： https://api.orginsights.viva.office.com/v1.0/tenants/{tenantid}/modis/connectors/HR/ingestions/fileIngestion
  • 驗證類型：將您的驗證類型選取為 [服務主體]，然後選取 [密碼] 或 [憑證]。 服務主體範例：

    • 內嵌：選取它。

    • 服務主體識別碼：輸入針對 API 連接器授權的應用程式識別碼。

    • 服務主體金鑰：輸入金鑰。

      顯示如何輸入服務主體金鑰的螢幕擷取畫面。

    • 租用戶：輸入租用戶識別碼。

    • Microsoft Entra ID 資源：https://api.orginsights.viva.office.com

    • Azure 雲端類型：選取您的 Azure 雲端類型。

    • 伺服器憑證驗證：選取 [已啟用]。

  1. 使用下列指引輸入 [接收器] 設定。

    顯示如何進入 [接收器] 設定的螢幕擷取畫面。

  • 接收資料集：選取現有或新建立的資料集。
  • 要求方法：選取 [發佈]。
  • 要求逾時：預設值為 5 分鐘。
  • 預設值為要求間隔 (毫秒) ：10。
  • 寫入批次大小：批次大小應高於檔案中的最大行數。
  • HTTP 壓縮類型：預設值為無。 或者，您可以使用 GZip。
  • 其他標頭：選取 [+新增]。
    • 方框 1：x-nova-scaleunit
    • 值：您可以瀏覽至 [Microsoft 365 組織資料服務] 頁面上的 [資料連線] 頁面， ([首頁>設定>移轉] 並匯入>Microsoft 365 組織資料服務>資料連線) 來擷取值。 接著選取 [新增匯入>] 選取連線類型 >啟動 API 型設定> 設定API 型連線頁面。

6. 複製資料活動設定：對應

  1. 選取 [對應]。

  2. 對於啟動程序上傳，請務必在對應 (目的地名稱) 中包含 PersonId、 ManagerId 和 Organization 。 對於增量上傳，請驗證目的地名稱以及 PersonId 與先前上傳中的名稱一致。 您無法使用新資料欄位執行累加式上傳，而且所有上傳均需要 PersonId 。

    顯示如何輸入 [對應] 活動設定的螢幕擷取畫面。

7. 複製資料活動設定：設定和使用者屬性

設定或使用者屬性不需要進行其他自訂。 如有需要，您可以視情況編輯這些設定。

8. 複製資料活動：觸發設定 (自動化)

若要將觸發程序新增至自動化設定，請選取 [新增觸發程序]。 建議的自動化是每週一次。 您也可以自訂頻率。

顯示如何設定觸發程序的螢幕擷取畫面。

變更連線或資料

  • 上次更新時間：