Trello
透過 Trello 連接器,您可以對 Trello 資料集執行插入、刪除、更新和讀取作業。
事前準備
使用 Trello 連接器前,請先完成下列工作:
- 在 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
(Connectors API)
如要瞭解如何啟用服務,請參閱「啟用服務」。
如果專案先前未啟用這些服務或權限,系統會在設定連結器時提示您啟用。
Trello 設定
建立自訂 Power-Up
如要瞭解如何建立 Power-Up,請參閱「建立自訂 Power-Up」一文。
產生 API 金鑰和權杖
- 建立 Trello Power-Up,產生 API 金鑰。
- 建立 Power up 後,請前往 管理頁面存取 Power up 資訊。
- 前往「API 金鑰」分頁,然後選取產生新 API 金鑰的選項。
- 按一下 [憑證]。
- 按一下「Allow」。
- 複製權杖。
如要進一步瞭解 Trello API,請參閱 API 簡介。
設定連接器
連線專屬於資料來源。也就是說,如果您有多個資料來源,則必須為每個資料來源建立個別的連線。如要建立連線,請按照下列步驟操作:
- 在 Cloud 控制台中,前往「Integration Connectors」>「Connections」頁面,然後選取或建立 Google Cloud 專案。
- 按一下「+ 建立新連線」,開啟「建立連線」頁面。
- 在「位置」部分中,選擇連線位置。
- 區域:從下拉式清單中選取位置。
如需所有支援的地區清單,請參閱「位置」一文。
- 點按「下一步」。
- 區域:從下拉式清單中選取位置。
- 在「連線詳細資料」部分,完成下列步驟:
- 連接器:從可用連接器的下拉式清單中選取「Trello」。
- 連接器版本:從可用版本的下拉式清單中選取連接器版本。
- 在「連線名稱」欄位中,輸入連線執行個體的名稱。
連線名稱必須符合下列條件:
- 連線名稱可使用英文字母、數字或連字號。
- 字母必須為小寫。
- 連線名稱開頭須為英文字母,結尾則須為英文字母或數字。
- 連結名稱不得超過 49 個字元。
- 視需要輸入連線執行個體的「Description」(說明)。
- 或者,可啟用 Cloud Logging,然後選取記錄層級。記錄層級預設為
Error
。 - 服務帳戶:選取具備必要角色的服務帳戶。
- 視需要設定「連線節點設定」:
- 節點數量下限:輸入連線節點數量下限。
- 節點數量上限:輸入連線節點數量上限。
節點是用來處理交易的連線單位 (或備用資源)。連線處理的交易量越多,就需要越多節點;反之,處理的交易量越少,需要的節點就越少。如要瞭解節點對連接器定價的影響,請參閱「 連線節點定價」。如未輸入任何值,系統預設會將節點下限設為 2 (提高可用性),節點上限則設為 50。
- 看板 ID:Trello 看板 ID。
- 包含機構看板:IncludeOrganizationBoards 會判斷登入的使用者是否擁有機構或企業。並想從機構和個人看板擷取資料。
- Member Id:Trello MemberId。
- 機構 ID:Trello 機構 ID。
- (選用) 在「進階設定」部分,選取「使用 Proxy」核取方塊,為連線設定 Proxy 伺服器,並設定下列值:
-
Proxy 驗證機制:選取與 Proxy 伺服器進行驗證的驗證類型。系統支援下列驗證類型:
- 基本:基本 HTTP 驗證。
- 摘要:摘要 HTTP 驗證。
- Proxy 使用者:用於向 Proxy 伺服器驗證的使用者名稱。
- Proxy Password:使用者的密碼 Secret Manager 密鑰。
-
Proxy SSL Type:連線至 Proxy 伺服器時要使用的 SSL 類型。系統支援下列驗證類型:
- 自動:預設設定。如果網址是 HTTPS 網址,則會使用「通道」選項。如果網址是 HTTP 網址,系統會使用「永不」選項。
- 一律:連線一律啟用 SSL。
- 從未:連線未啟用 SSL。
- 通道:連線是透過通道 Proxy 建立。Proxy 伺服器會開啟與遠端主機的連線,流量則會透過 Proxy 來回傳輸。
- 在「Proxy 伺服器」部分中,輸入 Proxy 伺服器的詳細資料。
- 選用:按一下「+ 新增標籤」,以鍵/值組合的形式為連線新增標籤。
- 點按「下一步」。
-
在「Authentication」部分中,輸入下列詳細資料:
- API 金鑰:Trello API 金鑰,用於透過 Trello 自己的授權路徑進行驗證。
- 權杖:用於透過 Trello 自己的授權路徑進行驗證的 Trello 權杖金鑰。
- 點按「下一步」。
- 檢查:檢查連線和驗證詳細資料。
- 點選「建立」。
連線設定範例
本節列出建立 Trello 連線時設定的各個欄位範例值。
Trello 伺服器連線類型
<欄位名稱 | 詳細資料 |
---|---|
位置 | Us-central1 |
連接器 | Trello |
連接器版本 | 1 |
連線名稱 | trello-google-cloud-new |
啟用 Cloud Logging | 否 |
服務帳戶 | SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com |
節點數量下限 | 2 |
節點數量上限 | 50 |
Proxy | 否 |
應用程式金鑰 | APP_KEY |
權杖 | TOKEN |
密鑰版本 | 1 |
實體、作業和動作
所有整合連接器都會為所連應用程式的物件提供抽象層。您只能透過這個抽象化程序存取應用程式的物件。抽象化會以實體、作業和動作的形式呈現。
- 實體: 實體可以視為已連結應用程式或服務中的物件,或是屬性集合。實體的定義因連接器而異。舉例來說,在資料庫連接器中,資料表是實體;在檔案伺服器連接器中,資料夾是實體;在訊息系統連接器中,佇列是實體。
不過,連接器可能不支援或沒有任何實體,在這種情況下,
Entities
清單會是空白。 - 作業: 作業是指您可以在實體上執行的活動。您可以對實體執行下列任一操作:
從可用清單中選取實體,系統會產生該實體可用的作業清單。如需作業的詳細說明,請參閱 Connectors 工作的實體作業。 不過,如果連接器不支援任何實體作業,系統就不會在
Operations
清單中列出這些不支援的作業。 - 動作: 動作是透過連接器介面提供給整合的第一類函式。動作可讓您變更一或多個實體,且因連接器而異。一般來說,動作會有一些輸入參數和輸出參數。不過,連接器可能不支援任何動作,此時
Actions
清單會是空白。
系統限制
Stripe 連接器每秒可處理 1 筆交易,每個節點也是如此,且會節流任何超出此限制的交易。根據預設,Integration Connectors 會為連線分配 2 個節點 (以提高可用性)。
如要瞭解 Integration Connectors 適用的限制,請參閱「限制」一文。
動作
本節列出連接器支援的操作。如要瞭解如何設定動作,請參閱「動作範例」。
UploadAttachment 動作
這項操作可讓你上傳附件。
UploadAttachment 動作的輸入參數
參數名稱 | 資料類型 | 必填 | 說明 |
---|---|---|---|
CardId | 字串 | 是 | 要新增附件的卡片 ID。 |
名稱 | 字串 | 否 | 要上傳的檔案名稱。最多可輸入 256 個半形字元。 |
MimeType | 字串 | 否 | 附件的 mimeType。最多可輸入 256 個半形字元。 |
SetCover | 字串 | 否 | 決定是否要將新附件設為資訊卡的封面。預設值為 false 。 |
AttachmentPath | 字串 | 否 | 本機附件路徑。 |
FileName | 字串 | 是 | 要用於 AttachmentPath 或 Content 輸入的檔案名稱 (包括副檔名)。FileName 是 AttachmentPath 輸入內容的選用項目,但必須提供 Content 輸入內容。 |
網址 | 字串 | 否 | 要附加的網址,開頭必須為 http:// 或 https:// 。 |
內容 | 字串 | 否 | AttachmentPath 的替代方案。要從中讀取附件位元組的 InputStream。 |
HasBytes | 布林值 | 否 | 指定要上傳的內容是否為二進位 (Base64 編碼字串) 格式。預設值為 false 。 |
如要瞭解如何設定 UploadAttachment
動作,請參閱動作範例。
DownloadAttachment 動作
這項操作可下載附件。
DownloadAttachment 動作的輸入參數
參數名稱 | 資料類型 | 必填 | 說明 |
---|---|---|---|
CardId | 字串 | 是 | 要下載附件的卡片 ID。 |
AttachmentId | 字串 | 是 | 要下載的附件 ID。 |
HasBytes | 布林值 | 否 | 指定要下載的內容是否為二進位 (Base64 編碼字串) 格式。預設值為 false 。 |
如要瞭解如何設定 DownloadAttachment
動作,請參閱動作範例。
動作範例
本節說明如何在這個連接器中執行部分動作。
範例 - 上傳附件
這個範例會上傳附件。
- 在「
Configure connector task
」對話方塊中,按一下Actions
。 - 選取
UploadAttachment
動作,然後按一下「完成」。 - 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中,按一下
connectorInputPayload
,然後在Default Value
欄位中輸入類似下列的值:{ "CardId": "6597cb14a9f10710fa2c4532", "FileName": "Test111", "Content": "This is test content" }
如果動作成功,UploadAttachment
工作的 connectorOutputPayload
回應參數會包含類似下列內容的值:
[{ "Success": "true", "Bytes": "27", "Date": "2024-02-16T12:45:47.714Z", "AttachmentId": "65cf58fbc68bd1c37057968b", "IdMember": "6597ca4e233f48b42ffd3db7", "Position": "81920", "Url": "https://trello.com/1/cards/5681cb14a9f10247fa2c4532/attachments/65cf58fbc68bd1c36587968b/download/Test111" }]
範例 - 下載附件
這個範例會下載附件。
- 在「
Configure connector task
」對話方塊中,按一下Actions
。 - 選取
DownloadAttachment
動作,然後按一下「完成」。 - 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中,按一下
connectorInputPayload
,然後在Default Value
欄位中輸入類似下列的值:{ "CardId": "6597cb14a9f10710fa2c4532", "AttachmentId": "65cf58fbc68bd1c37057968b" }
如果動作成功,DownloadAttachment
工作項目的 connectorOutputPayload
回應參數會包含類似下列內容的值:
[{ "Success": "True", "FileName": "testFile.txt", "Content": "This is test content" }]
實體作業範例
本節說明如何使用這個連接器執行部分實體作業。
範例 - 列出所有記錄
這個範例會列出 Checklists
實體中的所有記錄。
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取Checklists
。 - 選取「
List
」作業,然後按一下「完成」。 - (選用) 在「連結器」工作的「工作輸入」部分,您可以指定篩選子句,篩選結果集。請一律在單引號 (') 內指定篩選子句值。 。
範例 - 取得記錄
這個範例會從 BoardPlugins
實體取得具有指定 ID 的記錄。
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取BoardPlugins
。 - 選取「
Get
」作業,然後按一下「完成」。 - 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中,按一下「entityId」,然後在「Default Value」(預設值) 欄位中輸入
55a5d917446f517774210011
。其中
55a5d917446f517774210011
是BoardPlugins
實體中的專屬記錄 ID。
範例 - 刪除卡片
這個範例會從 Cards
實體中刪除具有指定 ID 的檔案。
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取Cards
。 - 選取「
Delete
」作業,然後按一下「完成」。 - 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中,按一下「entityId」,然後在「Default Value」(預設值) 欄位中輸入
65b14f4e19abc0a1face4937
。
範例 - 建立資訊卡
這個範例會在 Cards
實體中建立卡片。
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取Cards
。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中,按一下
connectorInputPayload
,然後在Default Value
欄位中輸入類似下列的值:{ "Name": "Testcard123", "Description": "test description", "ListID": "6597ca5df2b58ad47e6b1031" }
如果整合成功,連接器工作的
connectorOutputPayload
欄位會顯示類似下列的值:{ "CardId": "65b14f4e19abc0a1face4937" }
範例 - 更新卡片
這個範例會更新 Cards
實體中的卡片。
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取Cards
。 - 選取「
Update
」作業,然後按一下「完成」。 - 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中,按一下
connectorInputPayload
,然後在Default Value
欄位中輸入類似下列的值:{ "Description": "test description_Updated" }
如果整合成功,連接器工作的 connectorOutputPayload
欄位會包含類似下列的值:
{ "CardId": "65b14f4e19abc0a1face4937" }
使用 Terraform 建立連線
您可以使用 Terraform 資源建立新連線。
如要瞭解如何套用或移除 Terraform 設定,請參閱「基本 Terraform 指令」。
如要查看用於建立連線的 Terraform 範本範例,請參閱範本範例。
使用 Terraform 建立這項連線時,您必須在 Terraform 設定檔中設定下列變數:
參數名稱 | 資料類型 | 必填 | 說明 |
---|---|---|---|
board_id | STRING | 否 | Trello BoardId。 |
include_organization_boards | BOOLEAN | 否 | IncludeOrganizationBoards 會判斷登入的使用者是否擁有自己的機構或企業。並想從機構和個人看板擷取資料。 |
member_id | STRING | 否 | Trello MemberId。 |
organization_id | STRING | 否 | Trello OrganizationId。 |
proxy_enabled | BOOLEAN | 否 | 選取這個核取方塊,即可為連線設定 Proxy 伺服器。 |
proxy_auth_scheme | ENUM | 否 | 用於向 ProxyServer Proxy 驗證的驗證類型。支援的值包括:BASIC、DIGEST、NONE |
proxy_user | STRING | 否 | 用於向 ProxyServer Proxy 驗證的使用者名稱。 |
proxy_password | SECRET | 否 | 用於向 ProxyServer 代理程式驗證的密碼。 |
proxy_ssltype | ENUM | 否 | 連線至 ProxyServer Proxy 時要使用的 SSL 類型,支援的值包括:AUTO、ALWAYS、NEVER、TUNNEL |
在整合服務中使用 Trello 連線
建立連線後,Apigee Integration 和 Application Integration 都會提供該連線。您可以在整合中透過「連接器」工作使用連線。
- 如要瞭解如何在 Apigee Integration 中建立及使用「連線器」工作,請參閱「連線器工作」。
- 如要瞭解如何在 Application Integration 中建立及使用「連線器」工作,請參閱「連線器工作」。