呼叫 Microsoft 365 API 以傳輸組織資料以進行 API 型匯入 (步驟 2/3) (預覽)

重要事項

此功能僅適用于公開預覽客戶。 預覽版中的功能可能不完整，且在更廣泛的版本中提供之前可能會變更。

適用於：Microsoft 365 全域系統管理員或組織資料來源系統管理員或人力資源資訊系統系統管理員

1. 依設定的頻率準備和匯出資料

匯出公司中所有員工的組織資料，並將您想要匯入的所有欄位新增至 .csv 範本或外部來源的自動化 .csv 輸出，例如 Workday Report as a Service (RaaS) 。 了解如何建構此資料檔案。

依照您決定 (的頻率，例如每月一次或每週一次) ，讓您的自訂應用程式或外部來源整合從來源系統匯出組織資料。

2. 呼叫 API 以匯入您的資料

若要將資料匯入 Microsoft 365，您可以從五個選項中選擇其中一個：

  1. 使用我們的 API 建立自訂應用程序，以您選擇的頻率匯出和匯入您的資料。 Learn how.

  2. 在您的主機上執行我們的 C# 解決方案，該解決方案是根據我們的 API 來運作。 Learn how.

  3. 執行同樣以我們的 API 為基礎的 PowerShell 指令碼。 Learn how.

  4. 使用 Azure Data Factory 範本將資料傳送至 API 型匯入。 Learn how.

  5. 執行我們的 Node 指令碼來擷取 OAuth 權杖。 然後，使用這些權杖直接從 Workday 等外部來源傳送資料至 API 型匯入。 Learn how.

注意事項

我們的 C# 和 PowerShell 解決方案只會將資料匯入至 Microsoft 365 組織資料服務。 它們不會從來源系統匯出資料。

如果您使用選項 1、2、3 或 4，請確定您具備下列資訊：

  • 應用程式 (用戶端) 識別碼。 在 [應用程式 (用戶端) 識別碼] 底下的Microsoft Entra 系統管理中心中，已註冊的應用程式資訊中尋找此識別碼。

  • 用戶端密碼：這是應用程式在要求權杖時用來證明其身分識別的秘密字串。 它也稱為應用程式密碼。 只有在建立用戶端密碼時，才會第一次顯示此密碼。 若要建立新的用戶端密碼， 請遵循下列步驟。

  • 憑證名稱。 此名稱已在已註冊的應用程式中設定。 上傳憑證之後，憑證名稱會顯示在 Azure 入口網站的 [描述] 下。 您可以使用憑證名稱做為用戶端密碼的替代選項。

  • Microsoft Entra 租用戶識別碼。 您可以在應用程式概觀頁面的 [目錄 (租用戶) 識別碼] 底下找到此識別碼。

  • 縮放單位：提供給您的租用戶縮放單位，例如 “novaprdwus2-01”。

  • .csv 檔案和 .csv 檔案的路徑。

或者，如果您使用 選項 5，請確定您具備下列資訊：

  • 應用程式 (用戶端) 識別碼。 在 [應用程式 (用戶端) 識別碼] 底下的Microsoft 365 系統管理中心中，可在已註冊的應用程式資訊中找到此識別碼。

  • 用戶端密碼：這是應用程式在要求權杖時用來證明其身分識別的秘密字串。 它也稱為應用程式密碼。 此密碼只有在您建立用戶端密碼時才會顯示。 了解如何建立新的用戶端密碼。

  • Microsoft Entra 租用戶識別碼。 您可以在應用程式概觀頁面的 [目錄 (租用戶) 識別碼] 底下找到此識別碼。

  • 連接器識別碼：這是當您在 Microsoft 365 系統管理中心選取 API 型連接器時出現的 URL 結尾的字串，https://admin.cloud.microsoft/OrganizationalDataInM365/connection-details/[Connector ID here]例如 。

  • 縮放單位：提供給您的租用戶縮放單位，例如 “novaprdwus2-01”。

推送資料

要呼叫 Microsoft 365 API 推播內容的應用程式

[POST] https://api.orginsights.viva.office.com/v1.0/tenants/{tenantid}/modis/connectors/HR/ingestions/fileIngestion

如果未設定連接器：

403: Forbidden

如果已設定連接器，但先前的擷取尚未完成：

400: Bad request: Previous ingestion is not complete.

選項 1：使用 Microsoft 365 API 建置自訂匯入/匯出應用程式

您可以使用 Microsoft 365 API 建立自訂應用程式，該應用程式會自動從來源系統匯出資料，然後將它匯入至 Microsoft 365 系統管理中心。

您的應用程式可以採用任何形式，例如 PowerShell 指令碼，但它必須以您挑選的頻率將來源資料匯出為 .csv 檔案，然後將該檔案匯入 Microsoft 365 應用程式和服務。

選項 2： 透過自訂應用程式匯出資料之後，透過我們的 C# 解決方案匯入資料

以您選擇的頻率將來源資料匯出為 .csv 檔案之後，您可以在主控台上執行 DescriptiveDataUploadApp C# 解決方案。 然後，DescriptiveDataUploadApp C# 解決方案會將本機儲存的資料帶入 Microsoft 365。 在 GitHub 上深入了解。

執行解決方案：

  1. 在命令列上執行下列命令，將此應用程式複製到您的電腦：

    git clone https://github.com/microsoft/orgdata_apibasedimport.git.

  2. 包含下列主機值。

    • AppID/ClientID
    • .csv 檔案的絕對路徑。 將路徑格式如下： C:\\Users\\JaneDoe\\OneDrive - Microsoft\\Desktop\\info.csv
    • Microsoft Entra 租用戶識別碼
    • 憑證名稱

選項 3：透過自訂應用程式匯出資料之後，執行 DescriptiveDataUpload PowerShell 解決方案

與選項 2 類似，在依照您選擇的頻率將來源資料匯出為 .csv 檔案之後，您可以在主控台上執行 DescriptiveDataUpload PowerShell 解決方案。 然後，DescriptiveDataUpload PowerShell 解決方案會將本機儲存的資料帶入 Microsoft 365。 在 GitHub 上深入了解。

  1. 在命令列上執行下列命令，將原始程式碼複製到您的電腦：

    git clone https://github.com/microsoft/orgdata_apibasedimport.git.

  2. 以系統管理員身分開啟新的 PowerShell 視窗。

  3. 在 PowerShell 視窗中執行下列命令：

    Install-Module -Name MSAL.PS

    或者，請前往此 PowerShell 資源庫連結 ，取得安裝指示。

  4. 設定參數。

    • ClientID
    • pathTocsvFile
    • TenantId
    • novaScaleUnit
    • ingressDataType: HR
    • ClientSecret 或 certificateName

變更連線或資料

  • 上次更新時間：