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 金鑰和權杖

  1. 建立 Trello Power-Up，產生 API 金鑰。
  2. 建立 Power up 後，請前往 管理頁面存取 Power up 資訊。
  3. 前往「API 金鑰」分頁，然後選取產生新 API 金鑰的選項。
  4. 按一下 [憑證]。
  5. 按一下「Allow」。
  6. 複製權杖。

如要進一步瞭解 Trello API，請參閱 API 簡介。

設定連接器

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

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

    前往「Connections」(連線) 頁面

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

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

    2. 點按「下一步」。
  4. 在「連線詳細資料」部分，完成下列步驟：
    1. 連接器：從可用連接器的下拉式清單中選取「Trello」。
    2. 連接器版本：從可用版本的下拉式清單中選取連接器版本。
    3. 在「連線名稱」欄位中，輸入連線執行個體的名稱。

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

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

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

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

    8. 看板 ID：Trello 看板 ID。
    9. 包含機構看板：IncludeOrganizationBoards 會判斷登入的使用者是否擁有機構或企業。並想從機構和個人看板擷取資料。
    10. Member Id：Trello MemberId。
    11. 機構 ID：Trello 機構 ID。
    12. (選用) 在「進階設定」部分，選取「使用 Proxy」核取方塊，為連線設定 Proxy 伺服器，並設定下列值：
      • Proxy Auth Scheme：選取與 Proxy 伺服器進行驗證的驗證類型。系統支援下列驗證類型：
        • 基本：基本 HTTP 驗證。
        • 摘要：摘要 HTTP 驗證。
      • Proxy 使用者：用於向 Proxy 伺服器驗證的使用者名稱。
      • Proxy Password：使用者的密碼 Secret Manager 密鑰。
      • Proxy SSL Type：連線至 Proxy 伺服器時要使用的 SSL 類型。系統支援下列驗證類型：
        • 自動：預設設定。如果網址是 HTTPS 網址，則會使用「Tunnel」(通道) 選項。如果網址是 HTTP 網址，系統會使用「永不」選項。
        • 「Always」(一律)：連線一律啟用 SSL。
        • 「永不」：連線未啟用 SSL。
        • 通道：連線是透過通道 Proxy 建立。Proxy 伺服器會開啟與遠端主機的連線，流量會透過 Proxy 來回傳送。
      • 在「Proxy 伺服器」部分中，輸入 Proxy 伺服器的詳細資料。
        1. 按一下「+ 新增目的地」。
        2. 選取「目的地類型」。
          • 主機位址：指定目的地的 IP 位址或主機名稱。

            如要與後端系統建立私人連線，請按照下列步驟操作：

    13. 選用：按一下「+ 新增標籤」，以鍵/值組合的形式為連線新增標籤。
    14. 點按「下一步」。
  5. 在「Authentication」部分，輸入下列詳細資料：
    1. API 金鑰：Trello API 金鑰，用於透過 Trello 自己的授權路徑進行驗證。
    2. 權杖：用於透過 Trello 自己的授權路徑進行驗證的 Trello 權杖金鑰。
  6. 點按「下一步」。
  7. 檢查：檢查連線和驗證詳細資料。
  8. 點選「建立」。

連線設定範例

本節列出建立 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 動作，請參閱動作範例。

動作範例

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

範例 - 上傳附件

這個範例會上傳附件。

  1. 在「Configure connector task」對話方塊中，按一下 Actions。
  2. 選取 UploadAttachment 動作，然後按一下「完成」。
  3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
    {
"CardId": "6597cb14a9f10710fa2c4532",
"FileName": "Test111",
"Content": "This is test content"
}

    4. 如果動作成功，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"
}]

範例 - 下載附件

這個範例會下載附件。

  1. 在「Configure connector task」對話方塊中，按一下 Actions。
  2. 選取 DownloadAttachment 動作，然後按一下「完成」。
  3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
    {
"CardId": "6597cb14a9f10710fa2c4532",
"AttachmentId": "65cf58fbc68bd1c37057968b"
}

    4. 如果動作成功，DownloadAttachment 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

     [{
"Success": "True",
"FileName": "testFile.txt",
"Content": "This is test content"
}]

實體作業範例

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

範例 - 列出所有記錄

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

  1. 在「Configure connector task」對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Checklists。
  3. 選取「List」作業，然後按一下「完成」。
  4. (選用) 在「連結器」工作的「工作輸入」部分，您可以指定篩選子句，篩選結果集。 請一律在單引號 (') 內指定篩選子句值。
    5. 。

範例 - 取得記錄

這個範例會從 BoardPlugins 實體取得具有指定 ID 的記錄。

  1. 在「Configure connector task」對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 BoardPlugins。
  3. 選取「Get」作業，然後按一下「完成」。
  4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 55a5d917446f517774210011。

    其中 55a5d917446f517774210011 是 BoardPlugins 實體中的專屬記錄 ID。

範例 - 刪除卡片

這個範例會從 Cards 實體中刪除具有指定 ID 的檔案。

  1. 在「Configure connector task」對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Cards。
  3. 選取「Delete」作業，然後按一下「完成」。
  4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 65b14f4e19abc0a1face4937。

範例 - 建立資訊卡

這個範例會在 Cards 實體中建立卡片。

  1. 在「Configure connector task」對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Cards。
  3. 選取「Create」作業，然後按一下「完成」。
  4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
    {
  "Name": "Testcard123",
  "Description": "test description",
  "ListID": "6597ca5df2b58ad47e6b1031"
  }

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

    {
  "CardId": "65b14f4e19abc0a1face4937"
  }

範例 - 更新卡片

這個範例會更新 Cards 實體中的卡片。

  1. 在「Configure connector task」對話方塊中，按一下 Entities。
  2. 從 Entity 清單中選取 Cards。
  3. 選取「Update」作業，然後按一下「完成」。
  4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：
    {
  "Description": "test description_Updated"
  }

    5. 如果整合成功，連接器工作的 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 中建立及使用「連線器」工作，請參閱「連線器工作」。

向 Google Cloud 社群尋求協助

如要發布問題及討論這個連接器，請前往 Cloud 論壇的 Google Cloud 社群。

後續步驟