Microsoft Exchange 連接器

您可以使用 Microsoft Exchange 連接器，在 Exchange Web 服務 (EWS) 和 Microsoft Graph 結構定義中，對資料表執行插入、刪除、更新和讀取作業。

支援的版本

這個連接器支援 Exchange Online。

事前準備

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

  • 在 Google Cloud 專案中：
    • 確認已設定網路連線。如要瞭解網路模式，請參閱「網路連線」。
    • 將 roles/connectors.admin IAM 角色授予設定連接器的使用者。
    • 將下列 IAM 角色授予要用於連接器的服務帳戶：
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      服務帳戶是特殊的 Google 帳戶類型，主要用於代表需要驗證且必須取得授權才能存取 Google API 資料的非人類使用者。如果您沒有服務帳戶，請務必建立服務帳戶。詳情請參閱「建立服務帳戶」。

    • 啟用下列服務：
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (連接器 API)

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

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

設定連接器

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

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

    前往「連線」頁面

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

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

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

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

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

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

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

    8. Azure 用戶群：存取資料的 Microsoft Online 用戶群。如果您未指定租用戶，系統會使用預設租用戶。
    9. 結構定義：選取 EWS 或 MSGraph 結構定義。預設結構定義為 EWS。
    10. 您也可以選取「Disable Server Side Filtering」，停用伺服器端篩選功能。
    11. 點按「下一步」。
  5. 在「Destinations」部分，選取「Destination type」為「Host address」，然後指定連接器連線的 Exchange 伺服器位址，例如 https://outlook.office365.com/EWS/Exchange.asmx。
  6. 點按「下一步」。
  7. 在「Authentication」部分中，輸入驗證詳細資料。 如要瞭解如何設定這些驗證類型，請參閱「設定驗證」。

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

設定驗證機制

根據使用者名稱和密碼驗證輸入詳細資料

  • 使用者名稱：連接器的使用者名稱。
  • 密碼：Secret Manager 密鑰，內含與連接器相關聯的密碼。

根據 OAuth 2.0 - 授權碼驗證輸入詳細資料

  • 用戶端 ID：用於要求存取權憑證的用戶端 ID。
  • 範圍：以半形逗號分隔的所需範圍清單。
  • 用戶端密鑰：用於要求存取權存證的用戶端密鑰。
  • 授權網址：您在建立 OAuth 用戶端時產生的授權網址。 請使用下列格式輸入網址：https://login.microsoftonline.com/TENANT_IDENTIFIER;/oauth2/v2.0/authorize?prompt=consent。 例如 https://login.microsoftonline.com/9bxxxxxxxxx8112/oauth2/v2.0/authorize?prompt=consent。

建立連線後的額外步驟

如果您選用 OAuth 2.0 - Authorization code 進行驗證，則必須在建立連線後執行下列額外步驟：

  1. 在「Connections」(連線) 頁面中，找出新建立的連線。

    請注意，新連接器的狀態會是「需要授權」。

  2. 按一下「需要授權」。

    這會顯示「Edit authorization」窗格。

  3. 將「Redirect URI」值複製到外部應用程式。
  4. 驗證授權詳細資料。
  5. 按一下「Authorize」。

    如果授權成功，連線頁面中的連線狀態會設為「Active」。

重新授權授權碼

如果您使用 Authorization code 驗證類型，且在 Azure Synapse 應用程式中進行任何設定變更，則必須重新授權 Azure Synapse 連線。如要重新授權連線，請按照下列步驟操作：

  1. 在「Connections」(連線) 頁面中，按一下所需連線。

    系統會開啟連線詳細資料頁面。

  2. 按一下「編輯」即可編輯連結詳細資料。
  3. 在「驗證」部分確認「OAuth 2.0 - 授權碼」詳細資料。

    視需要進行必要的變更。

  4. 按一下 [儲存]。系統會將您導向連線詳細資料頁面。
  5. 在「驗證」部分中，按一下「編輯授權」。畫面上會顯示「Authorize」窗格。
  6. 按一下「Authorize」。

    如果授權成功，「連線」頁面中的連線狀態就會設為「啟用」。

系統限制

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

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

在整合中使用 Microsoft Exchange 連線

建立連線後，即可在 Apigee 整合和應用程式整合中使用。您可以透過連接器工作，在整合中使用連線。

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

動作

Microsoft Exchange 連接器提供 MoveItem 和 SendItem 等動作。如要瞭解如何設定動作，請參閱「動作範例」。

行動號召範例

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

範例 - MoveItem

  1. 在 Configure connector task 對話方塊中，按一下 Actions。
  2. 選取 MoveItem 動作，然後按一下「Done」。
  3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：
     {
  "ItemId":"The unique ItemId of the item to be sent"
  "ItemChangekey":"The unique ItemChangeKey of the item to be sent"
  "FolderDisplayName":"The display name of the new folder"
  }

實體操作範例

範例：列出所有 SentItems

這個範例會列出 SentItems 實體中的所有記錄。

  1. 在 Configure connector task 對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取「SentItems」。
  3. 選取 LIST 作業，然後按一下「Done」。

範例：從 Sentitems 實體取得特定記錄

這個範例會從 SentItems 實體取得 ID 為「568ea947-e03d-ef11-8409-7c1e5217e912」的記錄。

  1. 在 Configure connector task 對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 SentItems。
  3. 選取 GET 作業，然後按一下「Done」。
  4. 在「連接器」任務的「Task Input」部分，點選「entityId」，然後在「Default Value」欄位中輸入 568ea947-e03d-ef11-8409-7c1e5217e912。

    其中 Id 是 SentItems 實體的主鍵值。

  5. 按一下 [完成]。

向 Google Cloud 社群尋求協助

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

後續步驟