Oracle Eloqua
Oracle Eloqua 連接器可讓您對 Oracle Eloqua 資料執行讀取、插入、更新和刪除作業。
支援版本
這個連接器支援的最低版本為 Oracle Eloqua 10-24C (標準版)。
事前準備
使用 Oracle Eloqua 連接器前，請先完成下列工作：
- 在 Google Cloud 專案中：
- 確認已設定網路連線。如要瞭解網路模式，請參閱「網路連線」。
- 將 roles/connectors.admin IAM 角色授予設定連線器的使用者。
- 將下列 IAM 角色授予要用於連接器的服務帳戶：
roles/secretmanager.viewerroles/secretmanager.secretAccessor
服務帳戶是特殊的 Google 帳戶類型，主要用於代表需要驗證且必須取得授權才能存取 Google API 資料的非人類使用者。如果您沒有服務帳戶，請建立服務帳戶。詳情請參閱「建立服務帳戶」。
- 啟用下列服務：
secretmanager.googleapis.com(Secret Manager API)connectors.googleapis.com(Connectors API)
如要瞭解如何啟用服務，請參閱「啟用服務」。
如果專案先前未啟用這些服務或權限，系統會在設定連結器時提示您啟用。
設定連接器
連線專屬於資料來源。也就是說，如果您有多個資料來源，則必須為每個資料來源建立個別的連線。如要建立連線，請按照下列步驟操作：
- 在 Cloud 控制台中，前往「Integration Connectors」>「Connections」頁面，然後選取或建立 Google Cloud 專案。
- 按一下「+ 建立新連線」，開啟「建立連線」頁面。
- 在「位置」部分中，選擇連線位置。
- 區域：從下拉式清單中選取位置。
如需所有支援的地區清單，請參閱「位置」一文。
- 點選「下一步」。
- 區域：從下拉式清單中選取位置。
- 在「連線詳細資料」部分，完成下列步驟：
- 連接器：從可用連接器的下拉式清單中選取「Oracle Eloqua」。
- 連接器版本：從可用版本的下拉式清單中選取連接器版本。
- 在「連線名稱」欄位中，輸入連線執行個體的名稱。
連線名稱必須符合下列條件：
- 連線名稱可使用英文字母、數字或連字號。
- 字母必須為小寫。
- 連線名稱開頭須為英文字母，結尾則須為英文字母或數字。
- 連結名稱不得超過 49 個字元。
- 視需要輸入連線執行個體的「Description」(說明)。
- 或者，可啟用 Cloud Logging，然後選取記錄層級。記錄層級預設為
Error。 - 服務帳戶：選取具備必要角色的服務帳戶。
- 視需要設定「連線節點設定」：
- 節點數量下限：輸入連線節點數量下限。
- 節點數量上限：輸入連線節點數量上限。
節點是用來處理交易的連線單位 (或備用資源)。連線處理的交易量越多，就需要越多節點；反之，處理的交易量越少，需要的節點就越少。如要瞭解節點對連接器定價的影響，請參閱「 連線節點定價」。如未輸入任何值，系統預設會將節點下限設為 2 (提高可用性)，節點上限則設為 50。
- 公司：指定公司的專屬 ID。這個欄位用於向 Eloqua 伺服器進行驗證。
- 大量輪詢間隔：指定大量 API 要求的時間間隔。預設值為 200 毫秒。
- 大量查詢逾時：指定等待大量查詢回應的時間 (以分鐘為單位)。預設值為 25 分鐘。
- 資料保留時間長度：指定在伺服器上儲存大量資料的時間長度 (以小時為單位)。您可以指定 1 小時到 2 週的值。預設值為 24 小時。
-
顯示資料欄名稱：使用 Oracle Eloqua Bulk API 時，請指定資料欄的顯示名稱。您可以指定空字串、
internal或statement。 - 地圖資料卡區分大小寫比對：指定是否要在資料卡對應中使用區分大小寫比對。
- 對應資料資訊卡關係：輸入自訂物件表格與實體表格之間的關係，並以半形逗號分隔。
- 重試次數：指定因 HTTP 500 狀態碼 (內部伺服器錯誤) 而失敗的 Bulk API 要求，最多可重試的次數。
- 重試間隔：指定嘗試重試大量 API 要求的時間間隔，這些要求因 HTTP 500 狀態碼 (內部伺服器錯誤) 而失敗。
- 使用 Bulk API：指定是否使用 Bulk API 擷取資料。
- (選用) 按一下「+ 新增標籤」，以鍵/值組合的形式為連線新增標籤。
- 點選「下一步」。
- 在「目的地」部分，輸入要連線的遠端主機 (後端系統) 詳細資料。
- 目的地類型：選取目的地類型。
- 如要指定目的地主機名稱或 IP 位址，請選取「主機地址」，然後在「主機 1」欄位中輸入地址。
- 如要建立私人連線，請選取「Endpoint attachment」(端點連結)，然後從「Endpoint Attachment」(端點連結) 清單中選擇所需連結。
如要建立與後端系統的公開連線，並加強安全性，建議為連線設定靜態輸出 IP 位址，然後設定防火牆規則，只允許特定靜態 IP 位址。
如要輸入其他目的地，請按一下「+新增目的地」。
- 點選「下一步」。
- 目的地類型：選取目的地類型。
-
在「Authentication」(驗證) 部分中，輸入驗證詳細資料。
- 選取「驗證類型」並輸入相關詳細資料。
Oracle Eloqua 連線支援下列驗證類型：
- 使用者密碼
- OAuth 2.0 授權碼/li>
- 點選「下一步」。
如要瞭解如何設定這些驗證類型，請參閱「設定驗證」。
- 選取「驗證類型」並輸入相關詳細資料。
- 檢查：檢查連線和驗證詳細資料。
- 點選「建立」。
設定驗證機制
根據要使用的驗證方式輸入詳細資料。
-
使用者密碼
- 使用者名稱：用於驗證連線的使用者名稱。
- 密碼：Secret Manager 密鑰，內含與使用者名稱相關聯的密碼。
- 密鑰版本：上述所選密鑰的密鑰版本。
-
OAuth 2.0 授權碼
- 用戶端 ID：連接器為您建立的應用程式提供的用戶端 ID。
- 範圍：以半形逗號分隔的所需範圍清單。
- 用戶端密鑰：Secret Manager 密鑰，內含您建立的已連結應用程式用戶端密鑰。
- 密鑰版本：上述所選密鑰的密鑰版本。
- 授權網址：在 Oracle Eloqua 執行個體中建立用戶端時產生的授權網址。
連線設定範例
本節列出建立連線時設定的各個欄位範例值。
使用者名稱和密碼連線類型
| 欄位名稱 | 詳細資料 |
|---|---|
| 位置 | europe-west1 |
| 連接器 | Oracle Eloqua |
| 連接器版本 | 1 |
| 連線名稱 | oracle-eloqua-googlecloud |
| 服務帳戶 | SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com |
| 節點數量下限 | 2 |
| 節點數量上限 | 50 |
| 公司 | AltostratLtd |
| 使用者名稱 | 使用者名稱 |
| 密碼 | 密碼 |
| Secret 版本 | 1 |
OAuth 2.0 連線類型
| 欄位名稱 | 詳細資料 |
|---|---|
| 位置 | europe-west1 |
| 連接器 | Oracle Eloqua |
| 連接器版本 | 1 |
| 連線名稱 | oracle-eloqua-googlecloud-oauth |
| 說明 | oracle-eloqua-googlecloud-oauth |
| 服務帳戶 | SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com |
| 節點數量下限 | 2 |
| 節點數量上限 | 50 |
| 公司 | AltostratLtd |
| 用戶端 ID | CLIENT_ID |
| 範圍 | 已充飽電 |
| 用戶端密鑰 | CLIENT_SECRET |
| Secret 版本 | 4 |
系統限制
Oracle Eloqua 連接器每秒最多可處理 12 筆交易，每個節點也是如此，超過此限制的交易都會受到節流。根據預設，Integration Connectors 會為連線分配 2 個節點 (以提高可用性)。
如要瞭解 Integration Connectors 適用的限制，請參閱「限制」一文。
在整合服務中使用 Oracle Eloqua 連線
建立連線後，Apigee Integration 和 Application Integration 都會提供該連線。您可以在整合中透過「連接器」工作使用連線。
- 如要瞭解如何在 Apigee Integration 中建立及使用「連線器」工作，請參閱「連線器工作」。
- 如要瞭解如何在 Application Integration 中建立及使用「連線器」工作，請參閱「連線器工作」。
實體作業範例
本節說明如何使用這個連接器執行部分實體作業。
範例 - 列出所有 AccountGroup
- 在「
Configure connector task」對話方塊中，按一下Entities。 - 從
Entity清單中選取AccountGroup。 - 選取「
List」作業，然後按一下「完成」。
您也可以對下列實體執行 List 作業：
事件、使用者和廣告活動
範例 - 取得 AccountGroup
- 在「
Configure connector task」對話方塊中，按一下Entities。 - 從
Entity清單中選取AccountGroup。 - 選取「
Get」作業，然後按一下「完成」。 - 將實體 ID 設為 AccountGroup 的實體。如要設定實體 ID，請在「資料對應」的「資料對應器」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入
1，並選擇 EntityId 做為本機變數。
您也可以對下列實體執行 Get 作業：電子郵件和使用者。
範例 - 刪除 AccountGroup
- 在「
Configure connector task」對話方塊中，按一下Entities。 - 從
Entity清單中選取AccountGroup。 - 選取「
Delete」作業，然後按一下「完成」。 - 將實體 ID 設為 AccountGroup 的實體。如要設定實體 ID，請在「資料對應」的「資料對應器」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入
8，並選擇 EntityId 做為本機變數。
您也可以對電子郵件實體執行刪除作業。
範例 - 建立廣告活動
- 在「
Configure connector task」對話方塊中，按一下Entities。 - 從
Entity清單中選取Campaign。 - 選取「
Create」作業，然後按一下「完成」。 - 在「Task」(工作) 的「Data mapper」(資料對應器) 部分，按一下
OpenDataMapping編輯器，然後在field:中輸入類似下列的值：{ "Name": "AltostratCampaign1.11", "BudgetedCost": 100000 }執行這個範例後，Connector 工作的
connectorOutputPayload輸出變數會傳回類似下列內容的回應：{ "ID": 9 }
範例 - 建立活動
- 在「
Configure connector task」對話方塊中，按一下Entities。 - 從
Entity清單中選取「活動」。 - 選取「
Create」作業，然後按一下「完成」。 - 在「Task」(工作) 的「Data mapper」(資料對應器) 部分，按一下
OpenDataMapping編輯器，然後在field:中輸入類似下列的值：{ "Name": "Marketing Experience GCP2.2", "Description": "Modern Marketing Experience brings together Modern Marketers from around the globe", "EmailAddressFieldId": "-2" }執行這個範例後，Connector 工作的
connectorOutputPayload輸出變數會傳回類似下列內容的回應：{ "Id": "16" }
範例 - 更新廣告活動
- 在「
Configure connector task」對話方塊中，按一下Entities。 - 從
Entity清單中選取Campaign。 - 選取「
Update」作業，然後按一下「完成」。 - 將實體 ID 設為廣告活動的實體。如要設定 EntityID，請在「Tasks」(工作) 的「Data mapper」(資料對應工具) 區段中，按一下「EntityID」，然後在指定欄位中輸入
5。 - 在「Task」(工作) 的「Data mapper」(資料對應器) 部分，按一下
OpenDataMapping編輯器，然後在field:中輸入類似下列的值：{ "Name": "AltostratCamp9", "BudgetedCost": 100 }
執行這個範例後，Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：
{
"ID": 5
}
範例 - 更新電子郵件
- 在「
Configure connector task」對話方塊中，按一下Entities。 - 從
Entity清單中選取Email。 - 選取「
Update」作業，然後按一下「完成」。 - 將實體 ID 設為電子郵件的實體。如要設定 EntityID，請在「Tasks」(工作) 的「Data mapper」(資料對應工具) 區段中，按一下「EntityID」，然後在指定欄位中輸入
59。 - 在「Task」(工作) 的「Data mapper」(資料對應器) 部分，按一下
OpenDataMapping編輯器，然後在field:中輸入類似下列的值：{ "Name": "My Googlecloud email updated", "EmailGroupId": 1, "HtmlContent_Type": "RawHtmlContent", "IsPlainTextEditable": false, "IsTracked": false, "PlainText": "\r\n", "BouncebackEmail": "AltostratLtd@s119222.m.en25.com", "ReplyToEmail": "newclient@en25.com", "ReplyToName": "AltostratLtd", "SenderEmail": "newclient@en25.com", "SenderName": "AltostratLtd", "SenderPlainTextOnly": null, "Subject": "New subject line", "Description": null, "FolderId": 42, "EmailHeaderId": 1, "EmailFooterId": 1, "Permissions": "Retrieve,SetSecurity,Delete,Update,Activate", "AccessedAt": null, "CurrentStatus": "Draft", "Depth": "complete" }
執行這個範例後，Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：
{
"ID": 59
}