Dynamics 365

您可以透過 Dynamics 365 連接器，從應用程式連線至 Dynamics 365 的即時資料。您可以存取 Dynamics 365 資料，方法類似於存取資料庫，並對資料執行讀取、寫入和更新作業。

事前準備

使用 Dynamics 365 連接器前，請先完成下列工作：

  • 在 Google Cloud 專案中：
    • 確認已設定網路連線。如要瞭解網路模式，請參閱「網路連線」。
    • 啟用下列服務：
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (連接器 API)

      如要瞭解如何啟用服務，請參閱「啟用服務」。

    如果先前未為專案啟用這些服務或權限，系統會在設定連接器時提示您啟用。

設定連接器

連線是特定資料來源的連線，也就是說，如果您有多個資料來源，則必須為每個資料來源建立個別的連線。如要建立連線，請按照下列步驟操作：

  1. 在 Cloud 控制台中，前往「Integration Connectors」>「Connections」頁面，然後選取或建立 Google Cloud 專案。

    前往「連線」頁面

  2. 按一下「+ 建立新連線」，開啟「建立連線」頁面。
  3. 在「位置」部分，選擇連線的位置。
    1. 區域：從下拉式清單中選取位置。

      支援的連接器地區包括：

      如需所有支援地區的清單，請參閱「位置」一節。

    2. 點按「Next」。
  4. 在「連線詳細資料」部分中，完成下列操作：
    1. 連接器：從可用連接器的下拉式清單中選取「Dynamics 365」。
    2. 連接器版本：從可用版本的下拉式清單中選取連接器版本。
    3. 在「Connection Name」欄位中，輸入連線例項的名稱。

      連線名稱必須符合下列條件：

      • 連線名稱可以包含英文字母、數字或連字號。
      • 字母必須為小寫。
      • 連線名稱的開頭必須是英文字母，結尾則須為英文字母或數字。
      • 連結名稱不得超過 49 個半形字元。
    4. 視需要輸入連線例項的「Description」(說明)。
    5. 您可以選擇啟用 Cloud Logging，然後選取記錄層級。根據預設，記錄層級會設為 Error。
    6. 服務帳戶：選取具備必要角色的服務帳戶。
    7. 視需要設定連線節點設定：

      • 節點數量下限：輸入連線節點數量下限。
      • 節點數量上限：輸入連線節點數量上限。

      節點是用來處理交易的連線單位 (或備用資源)。處理的交易量越多，就需要越多節點；反之，處理的交易量越少，就需要越少節點。如要瞭解節點對連接器定價的影響，請參閱「 連線節點的定價」。如果您未輸入任何值，系統預設會將最小節點設為 2 (以提高可用性)，並將最大節點設為 50。

    8. Azure 用戶群：用於存取資料的 Microsoft Online 用戶群。如未指定，系統會使用您的預設租用戶。
    9. 機構網址：貴機構的 Dynamics 365 網址。例如 https://abc123.cloudax.dynamics.com/。
    10. ADFS 伺服器：用於驗證的 ADFS 伺服器。僅用於 FinOpsOnPremise 版本。
    11. API 版本：預設值為 9.0。您可以指定這個值，以便在 API 發布後存取新版本。只有在「Edition」設為「CustomerService」、「FieldService」、「Marketing」、「ProjectOperations」或「Sales」時，才會套用這個屬性。
    12. 跨公司：是否要為所有公司或僅為使用者的預設公司擷取資料。
    13. 版本：所使用的 Dynamics 365 版本。
    14. 包含格式化值：指出是否應公開含有格式化值的資料欄。
    15. 包含導覽屬性：指出是否應在資料欄清單中加入導覽屬性。
    16. 使用動態預存程序：指出是否應公開動態預存程序。
    17. 詳細程度：連線的詳細程度，介於 1 到 5 之間。詳細程度越高，系統就會記錄所有通訊詳細資料 (要求、回應和 SSL 憑證)。
    18. 您可以按一下「+ 新增標籤」，以鍵/值組合的形式為連線新增標籤。
    19. 點按「Next」。
  5. 在「Authentication」部分中，輸入驗證詳細資料。
    1. 選取「驗證類型」並輸入相關詳細資料。

      Dynamics 365 連線支援下列驗證類型：

      • OAuth 2.0 驗證碼授權

      2. 如要瞭解如何設定這些驗證類型，請參閱「設定驗證」。

    2. 點按「Next」。
  6. 查看：查看連線和驗證詳細資料。
  7. 按一下 [建立]。

設定驗證機制

根據要使用的驗證方法輸入詳細資料。

  • OAuth 2.0 授權碼授權
    • 存取權杖：用於驗證使用驗證碼流程連線的請求的存取權杖。
    • 用戶端 ID：用於要求存取權憑證的用戶端 ID。
    • 用戶端密鑰：用於要求存取權存證的用戶端密鑰。

Dynamics 365 設定

完成下列步驟，設定 Dynamics 365。

新增使用者

  1. 登入 Azure 入口網站。
  2. 建立新使用者並指派系統管理員角色。

建立應用程式

  1. 在 Azure 入口網站中，依序前往「Azure Active Directory」 >「Application Registrations」。
  2. 按一下「新增註冊」。
  3. 輸入應用程式名稱。
  4. 指定「單一」做為租用戶設定。
  5. 將重新導向網址設為 http://localhost:33333 或其他通訊埠，並將 CallbackURL 設為您定義的回覆網址。
  6. 按一下「註冊」。
  7. 前往「憑證與 Secret」，定義應用程式驗證類型。
  8. 為應用程式選取新的用戶端密鑰，並指定其時間長度。儲存用戶端密鑰後，Microsoft Office 365 會顯示金鑰值。
  9. 複製用來做為用戶端密鑰的值。

機構網址、版本、範圍和授權網址

以下是機構網址、版本、範圍和授權網址的值：
  • 機構網址是指執行個體網址。
  • 您可以選取下列任一版本：行銷、銷售或客戶服務。
  • 範圍：[org url]/.default
  • 授權網址：https://login.microsoftonline.com/TENANT_ID/oauth2/v2.0/authorize?prompt=consent

設定連線授權的重新導向網址

  1. 在 Azure 入口網站中，從「應用程式註冊」選取應用程式。
  2. 在「基本」Essentials中新增重新導向網址。
  3. 新增平台，選取「網站」，然後貼上重新導向網址。

Dynamics 365 Customer Service 版本連線類型

欄位名稱 詳細資料
位置 us-central1
連接器 Dynamics365
連接器版本 1
連線名稱 google-cloud-dynamic365-rest-customerservice
服務帳戶 SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Azure 用戶群 AZURE_TENANT
機構網址 https://orgurl.com
版本 客戶服務
納入導覽資源 是
詳細程度 5
節點數量下限 2
節點數量上限 2
用戶端 ID CLIENT_ID
範圍 [機構網址]/.default
用戶端密碼 SECRET
Secret 版本 5
授權網址 https://login.microsoftonline.com/TENANT_ID/oauth2/v2.0/authorize?prompt=consent

Dynamics 365 Sales 版本連線類型

欄位名稱 詳細資料
位置 us-central1
連接器 Dynamics365
連接器版本 1
連線名稱 googlecloud-dynamic365-rest-sales
服務帳戶 SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Azure 用戶群 AZURE_TENANT
機構網址 https://orgurl.com
版本 銷售
納入導覽資源 是
詳細程度 5
節點數量下限 2
節點數量上限 2
用戶端 ID CLIENT_ID
範圍 [機構網址]/.default
用戶端密碼 SECRET
Secret 版本 5
授權網址 https://login.microsoftonline.com/TENANT_ID/oauth2/v2.0/authorize?prompt=consent

Dynamics 365 Marketing 版本連線類型

欄位名稱 詳細資料
位置 us-central1
連接器 Dynamics365
連接器版本 1
連線名稱 google-dynamic365-rest-marketing
服務帳戶 SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Azure 用戶群 AZURE_TENANT
機構網址 https://orgurl.com
版本 行銷
納入導覽資源 是
詳細程度 5
節點數量下限 2
節點數量上限 2
用戶端 ID CLIENT_ID
範圍 [機構網址]/.default
用戶端密碼 SECRET
Secret 版本 5
授權網址 https://login.microsoftonline.com/TENANT_ID/oauth2/v2.0/authorize?prompt=consent

實體、作業和動作

所有整合連接器都為已連結應用程式的物件提供一層抽象層。您只能透過這個抽象層存取應用程式的物件。抽象概念會以實體、作業和動作的形式提供給您。

  • 實體： 實體可視為已連結應用程式或服務中的物件或屬性集合。實體的定義與連接器至連接器的定義不同。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。

    不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。

  • 作業： 作業是指您可對實體執行的活動。您可以對實體執行下列任一操作：

    從可用清單中選取實體後，系統會產生可用於該實體的作業清單。如需作業的詳細說明，請參閱連接器工作中的實體作業。不過，如果連接器不支援任何實體作業，則 Operations 清單中不會列出這些不支援的作業。

  • 動作： 動作是透過連接器介面提供給整合項目的一流函式。動作可讓您變更實體或多個實體，而這些變更會因連接器而異。通常，動作會包含一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，在這種情況下，Actions 清單會為空白。

系統限制

Dynamics 365 連接器可在每個節點中每秒處理 1 筆交易，並節流超出此限制的任何交易。根據預設，Integration Connectors 會為連線分配 2 個節點 (可提高可用性)。

如要瞭解 Integration Connectors 適用的限制，請參閱「限制」一節。

實體操作範例

本節說明如何在這個連接器中執行部分實體作業。

範例：列出所有產品

這個範例會列出 Products 實體中的所有產品。

  1. 在 Configure connector task 對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Products。
  3. 選取 List 作業，然後按一下「Done」。
  4. 您也可以在 Connector 工作中的「Task Input」部分，指定篩選子句來篩選結果集。請一律在單引號 (') 內指定篩選器子句值。

範例：取得待開發客戶

這個範例會從 Leads 實體取得指定 ID 的待開發客戶。

  1. 在 Configure connector task 對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Leads。
  3. 選取 Get 作業，然後按一下「Done」。
  4. 在「連接器」工作中的「工作輸入」部分，按一下「EntityId」，然後在「預設值」欄位中輸入 c5233ad8-a1a4-ee11-a568-000d3ac9f67f。

    其中 c5233ad8-a1a4-ee11-a568-000d3ac9f67f 是 Leads 實體中的專屬記錄 ID。

範例：建立待開發客戶

本範例會在 Leads 實體中建立待開發客戶。

  1. 在 Configure connector task 對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Leads。
  3. 選取 Create 運算，然後按一下「Done」。
  4. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：
    {
"fullname": "nameadded1703832358758",   
"subject": "test subject",   
"firstname": "firstname1703832358766",   
"lastname": "lastname1703832358767"
}

    如果整合成功，連接器工作 connectorOutputPayload 欄位的值會類似以下內容：

    [{
"leadid": "220166e8-15a6-ee11-a569-002248d5dd6b"
}]

範例：更新訂單

這個範例會更新 SalesOrder 實體中的記錄。

  1. 在 Configure connector task 對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 SalesOrder。
  3. 選取 Update 運算，然後按一下「Done」。
  4. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：
    {
"name": "Nameupdated1704863189087"
 }
  5. 按一下「entityId」，然後在「Default Value」欄位中輸入 580775a4-17aa-ee11-a568-000d3ac9f67f。

    如果整合成功，連接器工作 connectorOutputPayload 欄位的值會類似以下：

    [{
"salesorderid": "580775a4-17aa-ee11-a568-000d3ac9f67f"
}]

範例：刪除聯絡人

這個範例會刪除 Contacts 實體中具有指定 ID 的聯絡人。

  1. 在 Configure connector task 對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Contacts。
  3. 選取 Delete 運算，然後按一下「Done」。
  4. 在「連接器」任務的「Task Input」部分，點選「entityId」，然後在「Default Value」欄位中輸入 524f543b-3ea5-ee11-a568-000d3ac9f67f。

在整合中使用 Dynamics 365 連線

建立連線後，即可在 Apigee Integration 和 Application Integration 中使用。您可以透過「連接器」工作，在整合中使用連線。

  • 如要瞭解如何在 Apigee Integration 中建立及使用連接器工作，請參閱「連接器工作」。
  • 如要瞭解如何在 Application Integration 中建立及使用連接器工作，請參閱「連接器工作」。

向 Google Cloud 社群尋求協助

如有任何問題，歡迎在 雲端論壇中發問，並與 Google Cloud 社群成員討論這個連接器。

後續步驟