商業地圖

Businessmap 是最靈活的軟件平台，可實現以結果為導向的企業敏捷性。無與倫比的功能將多個工具整合為一個工具，實現經濟實惠的大規模部署、所有項目/投資組合的可見性以及目標一致性，從而更快地交付高質量的工作。 Businessmap 連接器可用於反映看板卡內外部工具（例如問題追蹤器、電子郵件、時間追蹤工具等）的變更。

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	商業地圖支持
URL	https://businessmap.io/customer-support
Email	support@businessmap.io

連接器中繼資料
Publisher	商業地圖
網站	https://businessmap.io
隱私策略	https://businessmap.io/privacy-policy
類別	商業管理;商業智慧

Businessmap 是最靈活的軟件平台，可實現以結果為導向的企業敏捷性。它幫助管理人員獲得所有項目的可見性，將計劃與執行聯繫起來，並指導交付工作流程的持續優化。 Businessmap 在構建時考慮到了規模，可以輕鬆地從單一交付團隊擴展到戰略投資組合。無與倫比的功能將多個工具整合為一個工具，實現經濟實惠的大規模部署、所有項目/投資組合的可見性以及目標一致性，從而更快地交付高質量的工作。 Businessmap 是領先的看板平台，用於高效項目管理和交付。

這是 Power Automate 的 Businessmap 連接器。它通過我們最新的 API v2 直接處理來自 Businessmap 的數據。 Businessmap 連接器可用來反映看板卡片內外部工具的變更，或從 Businessmap 讀取資料並在協力廠商連接器中使用它。請造訪我們知識庫中的整合區段，以取得有關如何使用連接器的一些真實範例。

先決條件

要使用此連接器，您需要一個 Businessmap 帳戶和具有訪問 API 權限的用戶。 Sign-Up 這裡並創建和帳戶來嘗試它。

如何取得認證

您可以在個人資料的“API”菜單中找到您的 API 密鑰。

開始使用連接器

連接器有一個一般觸發程式，可處理所有事件。當您想要從 Businessmap 接收事件時，將此觸發器設定為流程中的第一步。您的下一個操作應該是“條件”檢查，您將在其中添加“事件”過濾器，並且僅當事件類型與您感興趣的事件類型匹配時才繼續。在這裡，您可以找到一個列表，其中包含將觸發觸發器的所有事件和可能的值。下一步通常是“通過 ID 獲取卡”，它將從卡中獲取所有詳細信息，您將能夠在接下來的流程中使用和操作這些數據。

已知問題與限制

應用某些限制以確保產品和我們的 API 盡可能平穩高效地運行。確切的 API 限制取決於您的服務計劃。您可以在此處閱讀有關此內容的更多資訊

常見錯誤和補救措施

如果您遇到 429 錯誤，則表示您已達到 API 限制。錯誤詳細資料會告訴您必須等待多長時間才能傳送下一個要求。所有其他錯誤都有消息來解釋錯誤的確切原因。

FAQ

我們有一個廣泛的知識庫部分，如果您有任何問題找不到答案，請聯繫我們，我們將很樂意為您提供幫助。

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
API 金鑰	securestring	此 API 的 API 金鑰	對
Subdomain	字串	指定您的 Businessmap 帳戶的子網域	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

上傳附件	將附件上傳至卡片。
下載附件	從卡片下載附件。檔案內容會以 base64 編碼字串的形式傳回。
丟棄或還原卡片	捨棄卡片或還原先前捨棄的卡片。
依 ID 取得卡片（已棄用） [已棄用]	此動作已被取代。請改用 Get Card by ID。 ~~（已棄用）按 ID 獲取卡~~
刪除卡片（已棄用） [已棄用]	（已棄用）刪除卡片。
區塊卡	封鎖一張卡片。
取得 {Object} 名稱	根據物件的 ID 取得物件的名稱。當您想根據其 ID 獲取看板、工作流程、列等的名稱時使用的幫助函數
取得卡片附件	取得包含指定卡片所有附件的清單。
取得展示板（已淘汰） [已淘汰]	此動作已被取代。請改用 Get Boards 。 ~~（已棄用）從帳戶中獲取所有板。~~
取得工作流程（已淘汰） [已淘汰]	此動作已被取代。請改用取得工作流程。 ~~（已棄用）從指定的面板取得所有工作流程。~~
取得所有卡片	從選定的棋盤中獲取所有牌。回應最多包含 200 張卡片。對於超過 200 張卡片，請使用分頁。
取得所有卡片（已棄用） [已棄用]	此動作已被取代。請改用「取得所有卡片」。 ~~（已棄用）從給定的棋盤中獲取所有牌。~~
取得板欄（已淘汰） [已淘汰]	此動作已被取代。請改用 [取得資料行]。 ~~（已棄用）取得指定面板的所有資料行。~~
取得車道（已棄用） [已棄用]	此動作已被取代。請改用 Get Lanes 。 ~~（已棄用）取得指定面板的所有通道。~~
取得類型（已棄用） [已棄用]	此動作已被取代。請改用 Get Types 。 ~~（已棄用）取得帳戶內的所有類型。~~
取消連結卡片	移除兩張卡片之間的連結。
封存卡（已棄用） [已棄用]	此動作已被取代。請改用「存檔」或「取消存檔卡」。 ~~（已棄用）將卡片移至存檔。卡片不得被封鎖，且必須位於 [完成] 欄或 [封存] 欄中。~~
封存或取消封存卡片	將卡片新增至存檔，或從存檔中擷取卡片。
封鎖或取消封鎖卡片（已棄用） [已棄用]	（已棄用）封鎖、取消封鎖或編輯卡片的封鎖原因。
建立卡片	在您選擇的白板中創建一張牌。要設置自定義字段，貼紙和標籤與“更新卡”結合使用。
建立卡片（已淘汰） [已淘汰]	此動作已被取代。請改用「建立卡片」。 ~~（已棄用）在您選擇的白板中創建一張牌。~~
建立子任務	建立卡片或方案的新子任務。
建立子任務（已棄用） [已棄用]	此動作已被取代。請改用建立子任務。 ~~（已棄用）建立卡片或方案的新子任務。~~
新增註解	將註解新增至卡片或方案。
新增註解（已棄用） [已棄用]	此動作已被取代。請改用新增註解。 ~~（已棄用）將註解新增至卡片或方案。~~
更新卡	更新卡片的屬性（標題、描述、優先順序等）。如果逾時或 API 限制達到錯誤，請嘗試將自訂欄位、貼圖和標籤的設定分解為不同的動作。
更新卡（已棄用） [已棄用]	此動作已被取代。請改用更新卡。 ~~（已棄用）更新卡片的屬性（標題、說明、優先順序等）~~
移動卡片	將卡片移至新的欄、通道、工作流程或白板。
移動卡（已棄用）[已棄用]	此動作已被取代。請改用移動卡。 ~~（已棄用）將卡片（如果可能的話，任務或計劃）移至欄。~~
解鎖卡	解除封鎖卡片。
記錄時間	將時間記錄到卡片上。
記錄時間（秒數）（已淘汰） [已淘汰]	此動作已被取代。請改用記錄時間。 ~~（已棄用）將時間記錄到卡片上。時間以秒為單位記錄。~~
設定或取消設定標籤	將標籤新增至卡片，或從卡片中移除指派的標籤
設定或取消設定貼紙	將貼紙新增至卡片或從卡片中移除指派的貼紙
設定自訂欄位值	設定自訂欄位的值。
通過自定義 ID 獲取卡	通過自定義卡 ID 查找卡。如果找到多張卡片，則只會返回第一張卡片。使用「Board」參數按板過濾搜尋。
通過身份證獲取卡	通過其內部 ID 獲取卡詳細信息。
連結卡	將卡片連結至現有的卡片。

上傳附件

作業識別碼：: UploadAttachment

將附件上傳至卡片。

參數

名稱	機碼	必要	類型	Description
卡片 ID	card_id	True	integer	輸入卡片 ID
檔案名稱	file_name	True	string	輸入檔案名稱
Content	content	True	binary	提供檔案內容（base64）

傳回

身體: uploadAttachmentResponse

下載附件

作業識別碼：: DownloadAttachment

從卡片下載附件。檔案內容會以 base64 編碼字串的形式傳回。

參數

名稱	機碼	必要	類型	Description
卡片 ID	card_id	True	integer	輸入卡片 ID
檔案名稱	attachment_id	True	integer	選取 [附件] 或從 [取得卡片附件] 輸入 [附件 ID]

傳回

身體: downloadAttachmentResponse

丟棄或還原卡片

作業識別碼：: DiscardCard

捨棄卡片或還原先前捨棄的卡片。

參數

名稱	機碼	必要	類型	Description
卡片 ID	card_id	True	integer	輸入卡片 ID
行動	is_discarded	True	integer	選取動作

依 ID 取得卡片（已棄用） [已棄用]

作業識別碼：: GetCard

此動作已被取代。請改用 Get Card by ID。

~~（已棄用）按 ID 獲取卡~~

參數

名稱	機碼	必要	類型	Description
董事會 ID	boardid	True	string	從下拉式清單中選取板
卡片 ID	taskid	True	string	卡片 ID
獲取歷史記錄	history		string	如果您想取得卡片歷史記錄，請設定為「是」
獲取評論	comments		string	如果您想要獲得卡片評論，請設定為「是」
文字格式	textformat		string	針對卡片描述傳回的文字格式

傳回

名稱	路徑	類型	Description
任務ID	taskid	string	任務ID
boardid	boardid	string	boardid
title	title	string	title
描述	description	string	描述
型別	type	string	型別
受託人	assignee	string	受託人
子任務	subtasks	string	子任務
子任務完成	subtaskscomplete	string	子任務完成
color	color	string	color
priority	priority	string	priority
size	size	string	size
截止日期	deadline	string	截止日期
截止日期原始格式	deadlineoriginalformat	string	截止日期原始格式
extlink	extlink	string	extlink
tags	tags	string	tags
交貨時間	leadtime	integer	交貨時間
䠡	blocked	string	䠡
blocked原因	blockedreason	string	blocked原因
直欄名稱	columnname	string	直欄名稱
車道名稱	lanename	string	車道名稱
子任務詳細資料	subtaskdetails	array of	子任務詳細資料
columnid	columnid	string	columnid
萊尼德	laneid	string	萊尼德
位置	position	string	位置
工作流程	workflow	integer	工作流程
workflow_id	workflow_id	integer	workflow_id
url	attachments.FXPR1VE0LIC9.url	string	url
客戶名稱	attachments.FXPR1VE0LIC9.clientName	string	客戶名稱
uniqueName （唯一名稱）	attachments.FXPR1VE0LIC9.uniqueName	string	uniqueName （唯一名稱）
檔案大小	attachments.FXPR1VE0LIC9.fileSize	float	檔案大小
檔案類型	attachments.FXPR1VE0LIC9.fileType	string	檔案類型
狀態	attachments.FXPR1VE0LIC9.status	string	狀態
url	attachments.0XC7C1PRR9ZK.url	string	url
客戶名稱	attachments.0XC7C1PRR9ZK.clientName	string	客戶名稱
uniqueName （唯一名稱）	attachments.0XC7C1PRR9ZK.uniqueName	string	uniqueName （唯一名稱）
檔案大小	attachments.0XC7C1PRR9ZK.fileSize	float	檔案大小
檔案類型	attachments.0XC7C1PRR9ZK.fileType	string	檔案類型
狀態	attachments.0XC7C1PRR9ZK.status	string	狀態
資料行路徑	columnpath	string	資料行路徑
記者	reporter	string	記者
自訂欄位	customfields	array of object	自訂欄位
欄位識別碼	customfields.fieldid	integer	欄位識別碼
名稱	customfields.name	string	名稱
型別	customfields.type	string	型別
value	customfields.value	string	value
命令的	customfields.mandatory	boolean	命令的
不可變	customfields.immutable	boolean	不可變
更新日期	updatedat	string	更新日期
記錄時間	loggedtime	integer	記錄時間
歷史細節	historydetails	array of object	歷史細節
事件類型	historydetails.eventtype	string	事件類型
歷史事件	historydetails.historyevent	string	歷史事件
任務ID	historydetails.taskid	string	任務ID
details	historydetails.details	string	details
作者	historydetails.author	string	作者
入境日期	historydetails.entrydate	string	入境日期
歷史ID	historydetails.historyid	string	歷史ID
註解	comments	array of	註解

刪除卡片（已棄用） [已棄用]

作業識別碼：: DeleteCard

（已棄用）刪除卡片。

參數

名稱	機碼	必要	類型	Description
董事會 ID	boardid	True	string	從下拉式清單中選取板
卡片 ID	taskid	True	string	卡片 ID

區塊卡

作業識別碼：: BlockCard

封鎖一張卡片。

參數

名稱	機碼	必要	類型	Description
委員會	board_id	True	integer	必須從下拉式選單中選擇棋盤
卡片 ID	card_id	True	integer	輸入卡片 ID
封鎖原因	reason_id	True	string	選取封鎖原因
評論	comment		string	將註解新增至封鎖原因

取得 {Object} 名稱

作業識別碼：: GetObjectName

根據物件的 ID 取得物件的名稱。當您想根據其 ID 獲取看板、工作流程、列等的名稱時使用的幫助函數

參數

名稱	機碼	必要	類型	Description
委員會	board_id	True	integer	必須從下拉式選單中選擇棋盤
項目	item	True	string	選取物件類型
ID	id	True	integer	輸入物件 ID

傳回

身體: getObjectNameResponse

取得卡片附件

作業識別碼：: GetCardAttachments

取得包含指定卡片所有附件的清單。

參數

名稱	機碼	必要	類型	Description
卡片 ID	card_id	True	integer	輸入卡片 ID

傳回

身體: getCardAttachmentsResponse

取得展示板（已淘汰） [已淘汰]

作業識別碼：: GetBoards

此動作已被取代。請改用 Get Boards 。

~~（已棄用）從帳戶中獲取所有板。~~

傳回

名稱	路徑	類型	Description
資料	data	array of object	資料
board_id	data.board_id	integer	board_id
workspace_id	data.workspace_id	integer	workspace_id
is_archived	data.is_archived	integer	is_archived
名稱	data.name	string	名稱

取得工作流程（已淘汰） [已淘汰]

作業識別碼：: GetWorkflows

此動作已被取代。請改用取得工作流程。

~~（已棄用）從指定的面板取得所有工作流程。~~

參數

名稱	機碼	必要	類型	Description
董事會 ID	board_id	True	string	委員會

傳回

名稱	路徑	類型	Description
資料	data	array of object	資料
型別	data.type	integer	型別
位置	data.position	integer	位置
is_enabled	data.is_enabled	integer	is_enabled
is_collapsible	data.is_collapsible	integer	is_collapsible
名稱	data.name	string	名稱
workflow_id	data.workflow_id	integer	workflow_id

取得所有卡片

作業識別碼：: GetAllCards_V2

從選定的棋盤中獲取所有牌。回應最多包含 200 張卡片。對於超過 200 張卡片，請使用分頁。

參數

名稱	機碼	必要	類型	Description
委員會	board_ids	True	integer	必須從下拉式選單中選擇棋盤
自訂卡片 ID	custom_ids		array	輸入自訂 ID
頁面	page		integer	頁碼
State	state		string	您想要取得的卡片的狀態值。根據預設，它是作用中狀態。

傳回

身體: getAllCardsResponse

取得所有卡片（已棄用） [已棄用]

作業識別碼：: GetAllCards

此動作已被取代。請改用「取得所有卡片」。

~~（已棄用）從給定的棋盤中獲取所有牌。~~

參數

名稱	機碼	必要	類型	Description
董事會 ID	boardid	True	string	從下拉式清單中選取板

取得板欄（已淘汰） [已淘汰]

作業識別碼：: GetColumns

此動作已被取代。請改用 [取得資料行]。

~~（已棄用）取得指定面板的所有資料行。~~

參數

名稱	機碼	必要	類型	Description
董事會 ID	board_id	True	string	要取得列的板。

傳回

名稱	路徑	類型	Description
資料	data	array of object	資料
column_id	data.column_id	integer	column_id
工作流程	data.workflow	integer	工作流程
section	data.section	integer	section
parent_column_id	data.parent_column_id	integer	parent_column_id
位置	data.position	integer	位置
名稱	data.name	string	名稱
描述	data.description	string	描述
color	data.color	string	color
limit	data.limit	integer	limit
cards_per_row	data.cards_per_row	integer	cards_per_row
flow_type	data.flow_type	integer	flow_type

取得車道（已棄用） [已棄用]

作業識別碼：: GetLanes

此動作已被取代。請改用 Get Lanes 。

~~（已棄用）取得指定面板的所有通道。~~

參數

名稱	機碼	必要	類型	Description
董事會 ID	board_id	True	string	獲得車道的板。

傳回

名稱	路徑	類型	Description
資料	data	array of object	資料
lane_id	data.lane_id	integer	lane_id
工作流程	data.workflow	integer	工作流程
parent_lane_id	data.parent_lane_id	integer	parent_lane_id
位置	data.position	integer	位置
名稱	data.name	string	名稱
描述	data.description	string	描述
color	data.color	string	color

取得類型（已棄用） [已棄用]

作業識別碼：: GetTypes

此動作已被取代。請改用 Get Types 。

~~（已棄用）取得帳戶內的所有類型。~~

傳回

名稱	路徑	類型	Description
資料	data	array of object	資料
type_id	data.type_id	integer	type_id
icon_type	data.icon_type	integer	icon_type
icon_id	data.icon_id	integer	icon_id
名稱	data.name	string	名稱
描述	data.description	string	描述
color	data.color	string	color
card_color_sync	data.card_color_sync	integer	card_color_sync
all_properties_are_locked	data.all_properties_are_locked	integer	all_properties_are_locked
availability	data.availability	integer	availability
is_enabled	data.is_enabled	integer	is_enabled

取消連結卡片

作業識別碼：: UnlinkCard

移除兩張卡片之間的連結。

參數

名稱	機碼	必要	類型	Description
取消連結卡片 ID	card_id	True	integer	輸入卡片 ID
連結為	link_type	True	string	選取連結類型
前往卡片 ID	linked_card_id	True	integer	輸入連結的卡片 ID

封存卡（已棄用） [已棄用]

作業識別碼：: ArchiveCard

此動作已被取代。請改用「存檔」或「取消存檔卡」。

~~（已棄用）將卡片移至存檔。卡片不得被封鎖，且必須位於 [完成] 欄或 [封存] 欄中。~~

參數

名稱	機碼	必要	類型	Description
卡片 ID	cardid	True	string	卡片 ID
版本	version		string	版本

封存或取消封存卡片

作業識別碼：: ArchiveCard_V2

將卡片新增至存檔，或從存檔中擷取卡片。

參數

名稱	機碼	必要	類型	Description
卡片 ID	card_id	True	integer	輸入卡片 ID
行動	is_archived	True	integer	選取動作

封鎖或取消封鎖卡片（已棄用） [已棄用]

作業識別碼：: BlockUnblockCard

（已棄用）封鎖、取消封鎖或編輯卡片的封鎖原因。

參數

名稱	機碼	必要	類型	Description
董事會 ID	boardid	True	string	從下拉式清單中選取板
卡片 ID	taskid	True	string	卡片 ID
事件類型	event	True	string
封鎖原因	blockreason		string	封鎖原因

建立卡片

作業識別碼：: CreateCard_V2

在您選擇的白板中創建一張牌。要設置自定義字段，貼紙和標籤與“更新卡”結合使用。

參數

名稱	機碼	必要	類型	Description
委員會	board_id	True	integer	必須從下拉式選單中選擇棋盤
Workflow	workflow_id	True	integer	必須從下拉式清單中選取工作流程
Template	template_id		integer	選取範本
資料行	column_id	True		選取 [欄] 或 [輸入欄名稱或 ID] 作為自訂值
巷	lane_id	True		選取車道或輸入車道名稱或 ID 作為自訂值
Title	title	True	string	卡片標題
Description	description		string	卡片說明
自訂 ID	custom_id		string	自訂卡片 ID
所有者	owner_user_id		integer	選擇卡持卡人
記者用戶	reporter_user_id		integer	從 Businessmap 用戶中選擇記者
記者郵箱	reporter_email		string	輸入報告者電子郵件地址，僅在上面未選取任何使用者時
類型	type_id		integer	選擇卡片類型
卡片尺寸	size		double	卡片尺寸
Priority	priority		integer	選取優先順序
顏色	color		string	顏色（十六進制，例如 #000000）
Deadline	deadline		string	截止日期（格式：YYYY-MM-DD）
計劃開始日期	planned_start_date		string	計劃開始日期（格式：YYYY-MM-DD）（僅限倡議）
計畫結束日期	planned_end_date		string	計劃結束日期（格式：YYYY-MM-DD）（僅限計劃）
實際開始時間	actual_start_time		string	實際開始時間（格式：YYYY-MM-DDTHH：mm：ssZ）（只限計劃）
實際結束時間	actual_end_time		string	實際結束時間（格式：YYYY-MM-DDTHH：mm：ssZ）（僅限倡議）

傳回

身體: getCardResponse

建立卡片（已淘汰） [已淘汰]

作業識別碼：: CreateCard

此動作已被取代。請改用「建立卡片」。

~~（已棄用）在您選擇的白板中創建一張牌。~~

參數

名稱	機碼	必要	類型	Description
內容類型	Content-Type		string	一律使用：application/json
內容類型	Accept		string	一律使用：application/json
董事會 ID	boardid	True	string	選擇板
Title	title		string	title
Description	description		string	卡片詳細資料
Priority	priority		string	可能的值：低、平均、高、嚴重
受讓人	assignee		string	受讓人的使用者名稱
顏色	color		string	像這樣的十六進制顏色代碼 #F37325
大小	size		string	size
Tags	tags		string	多個標籤應用空格分隔
自訂欄位	cfields		string	自訂欄位及其值的 JSON 格式清單{“field1”：“value1”，“field2”：“value2”}
Deadline	deadline		string	此格式的截止日期 YYYY-MM-DD
外部連結	extlink		string	外部連結
類型	type		string	您要設定的類型名稱
卡片模板	template		string	您要套用的卡片範本名稱
欄位名稱	column		string	確切資料行名稱
巷	lane		string	車道名稱
Position	position		string	卡在欄中的位置
超出理由	exceedingreason		string	超出原因

建立子任務

作業識別碼：: CreateSubtask_V2

建立卡片或方案的新子任務。

參數

名稱	機碼	必要	類型	Description
委員會	board_id	True	integer	必須從下拉式選單中選擇棋盤
卡片 ID	card_id	True	integer	輸入卡片 ID
Description	description	True	string	子任務描述
所有者	owner_user_id		string	選取使用者
子任務狀態	is_finished		integer	選取子任務狀態

建立子任務（已棄用） [已棄用]

作業識別碼：: CreateSubtask

此動作已被取代。請改用建立子任務。

~~（已棄用）建立卡片或方案的新子任務。~~

參數

名稱	機碼	必要	類型	Description
內容類型	Content-Type	True	string	一律使用：application/json
內容類型	Accept	True	string	一律使用：application/json
家長卡 ID	taskparent		integer	家長卡的身份證件
Title	title		string	title
受讓人	assignee		string	受讓人的使用者名稱

新增註解

作業識別碼：: AddComment_V2

將註解新增至卡片或方案。

參數

名稱	機碼	必要	類型	Description
卡片 ID	card_id	True	integer	輸入卡片 ID
評論	text	True	string	評論

新增註解（已棄用） [已棄用]

作業識別碼：: AddComment

此動作已被取代。請改用新增註解。

~~（已棄用）將註解新增至卡片或方案。~~

參數

名稱	機碼	必要	類型	Description
內容類型	Content-Type	True	string	一律使用：application/json
內容類型	Accept	True	string	一律使用：application/json
卡片 ID	taskid		string	卡片 ID
評論	comment		string	留言

更新卡

作業識別碼：: UpdateCard_V2

更新卡片的屬性（標題、描述、優先順序等）。如果逾時或 API 限制達到錯誤，請嘗試將自訂欄位、貼圖和標籤的設定分解為不同的動作。

參數

名稱	機碼	必要	類型	Description
卡片 ID	card_id	True	integer	輸入卡片 ID
委員會	board_id	True	integer	必須從下拉式選單中選擇棋盤
Workflow	workflow_id		integer	必須從下拉式清單中選取工作流程
Template	template_id		integer	選取範本
資料行	column_id			選取 [欄] 或 [輸入欄名稱或 ID] 作為自訂值
巷	lane_id			選取車道或輸入車道名稱或 ID 作為自訂值
Title	title		string	卡片標題
Description	description		string	卡片說明
自訂 ID	custom_id		string	自訂 ID
所有者	owner_user_id		integer	選擇卡持卡人
類型	type_id		integer	選擇卡片類型
卡片尺寸	size		double	卡片尺寸
Priority	priority		integer	選取優先順序
顏色	color		string	顏色（十六進制，例如 #000000）
Deadline	deadline		string	截止日期（格式：YYYY-MM-DD）
計劃開始日期	planned_start_date		string	計劃開始日期（格式：YYYY-MM-DD）（僅限倡議）
計畫結束日期	planned_end_date		string	計劃結束日期（格式：YYYY-MM-DD）（僅限計劃）
實際開始時間	actual_start_time		string	實際開始時間（格式：YYYY-MM-DDTHH：mm：ssZ）（只限計劃）
實際結束時間	actual_end_time		string	實際結束時間（格式：YYYY-MM-DDTHH：mm：ssZ）（僅限倡議）
貼紙	stickers		string	選擇貼紙或將它們添加為以逗號分隔的文本
Tags	tags		string	選取標籤或將其新增為以逗號分隔的文字
名稱	field_id		integer	選取自訂欄位
價值觀	value		string	自訂欄位值

傳回

身體: getCardResponse

更新卡（已棄用） [已棄用]

作業識別碼：: UpdateCard

此動作已被取代。請改用更新卡。

~~（已棄用）更新卡片的屬性（標題、說明、優先順序等）~~

參數

名稱	機碼	必要	類型	Description
內容類型	Content-Type	True	string	一律設定為：application/json
接受	Accept	True	string	一律設定為：application/json
董事會 ID	boardid		integer	從下拉式清單中選取板
卡片 ID	taskid		integer	卡片 ID
Title	title		string	title
Description	description		string	卡片詳細資料
Priority	priority		string
受讓人	assignee		string	受讓人的使用者名稱
顏色	color		string	像這樣的十六進制顏色代碼 #F37325
大小	size		integer	size
Tags	tags		string	多個標籤應用空格分隔
自訂欄位	cfields		string	自訂欄位及其值的 JSON 格式清單{“field1”：“value1”，“field2”：“value2”}
Deadline	deadline		string	此格式的截止日期 YYYY-MM-DD
外部連結	extlink		string	外部連結
類型	type		string	您要設定的類型名稱

移動卡片

作業識別碼：: MoveCard_V2

將卡片移至新的欄、通道、工作流程或白板。

參數

名稱	機碼	必要	類型	Description
卡片 ID	card_id	True	integer	輸入卡片 ID
委員會	board_id	True	integer	必須從下拉式選單中選擇棋盤
Workflow	workflow_id	True	integer	必須從下拉式清單中選取工作流程
資料行	column_id	True		選取 [欄] 或 [輸入欄名稱或 ID] 作為自訂值
巷	lane_id	True		選取車道或輸入車道名稱或 ID 作為自訂值

移動卡（已棄用）[已棄用]

作業識別碼：: MoveCard

此動作已被取代。請改用移動卡。

~~（已棄用）將卡片（如果可能的話，任務或計劃）移至欄。~~

參數

名稱	機碼	必要	類型	Description
內容類型	Content-Type	True	string	一律使用：application/json
內容類型	Accept	True	string	一律使用：application/json
卡片 ID	taskid		string	卡片 ID
董事會 ID	boardid	True	string	董事會 ID
資料行	column		string	欄位名稱
巷	lane		string	車道名稱
Position	position		string	卡在欄中的位置
超出理由	exceedingreason		string	超出原因

解鎖卡

作業識別碼：: UnblockCard

解除封鎖卡片。

參數

名稱	機碼	必要	類型	Description
卡片 ID	card_id	True	integer	輸入卡片 ID

記錄時間

作業識別碼：: LogTime_V2

將時間記錄到卡片上。

參數

名稱	機碼	必要	類型	Description
卡片 ID	card_id	True	string	內部卡 ID
時間單位	time_unit	True	string	時間單位
持續時間	time	True	integer	持續時間
評論	comment		string	評論

記錄時間（秒數）（已淘汰） [已淘汰]

作業識別碼：: LogTime

此動作已被取代。請改用記錄時間。

~~（已棄用）將時間記錄到卡片上。時間以秒為單位記錄。~~

參數

名稱	機碼	必要	類型	Description
內容類型	Content-Type	True	string	一律使用：application/json
內容類型	Accept	True	string	一律使用：application/json
卡片 ID	card_id		string	內部卡 ID
Time	time		string	時間（以秒為單位）
評論	comment		string	評論

設定或取消設定標籤

作業識別碼：: SetTags

將標籤新增至卡片，或從卡片中移除指派的標籤

參數

名稱	機碼	必要	類型	Description
卡片 ID	card_id	True	integer	輸入卡片 ID
委員會	board_id	True	integer	必須從下拉式選單中選擇棋盤
行動	action	True	string	選擇設定或取消設定標籤
Tags	tags	True	string	從下拉式清單中選取單一標籤，或輸入以逗號分隔的多個標籤
如果標籤遺失	missing_tags		integer	選取缺少標籤時所需的行為

設定或取消設定貼紙

作業識別碼：: SetStickers

將貼紙新增至卡片或從卡片中移除指派的貼紙

參數

名稱	機碼	必要	類型	Description
卡片 ID	card_id	True	integer	輸入卡片 ID
委員會	board_id	True	integer	必須從下拉式選單中選擇棋盤
行動	action	True	string	選擇設定或取消設定貼紙
貼紙	stickers	True	string	從下拉式選單中選擇單個貼紙或輸入多個以逗號分隔的貼紙
如果貼紙遺失	missing_stickers		integer	選擇缺少貼紙時所需的行為

設定自訂欄位值

作業識別碼：: SetCustomField

設定自訂欄位的值。

參數

名稱	機碼	必要	類型	Description
卡片 ID	card_id	True	integer	輸入卡片 ID
董事會 ID	board_id	True	integer	必須從下拉式選單中選擇棋盤
欄位名稱	field_id	True	integer	選取自訂欄位
價值觀	values	True	string	從下拉式清單中選取，或輸入以逗號分隔的自訂值

通過自定義 ID 獲取卡

作業識別碼：: GetCardByCustomId

通過自定義卡 ID 查找卡。如果找到多張卡片，則只會返回第一張卡片。使用「Board」參數按板過濾搜尋。

參數

名稱	機碼	必要	類型	Description
自訂卡片 ID	custom_ids	True	string	輸入自訂 ID
委員會	board_ids		integer	必須從下拉式選單中選擇棋盤

傳回

身體: getCardResponse

通過身份證獲取卡

作業識別碼：: GetCard_V2

通過其內部 ID 獲取卡詳細信息。

參數

名稱	機碼	必要	類型	Description
卡片 ID	card_id	True	integer	輸入卡片 ID

傳回

身體: getCardResponse

連結卡

作業識別碼：: LinkCard

將卡片連結至現有的卡片。

參數

名稱	機碼	必要	類型	Description
卡片 ID	card_id	True	integer	輸入卡片 ID
將連結為	link_type	True	string	選取連結類型
前往卡片 ID	linked_card_id	True	integer	要連結至目前卡片的卡片 ID

觸發程序

一般觸發器

觸發板上任何動作。使用「控制/條件」或「控制/切換」來管理不同觸發器的流程。以下是支援的事件類型的部分清單：「卡片已建立」、「卡片已移動」、「卡片詳細資料已變更」、「卡片已刪除」、「卡片已封鎖」\n\n 觸發器之後的下一步應該是「依 ID 取得卡片」，以便您可以取得所有卡片詳細資料 \n\n在雙向整合中使用作者 ID 的控制/條件來防止迴圈

一般觸發器

作業識別碼：: CardHook

參數

名稱	機碼	必要	類型	Description
董事會 ID	board_id	True	string	選擇板

傳回

名稱	路徑	類型	Description
公司	company	string	公司
事件	event	string	事件
user_id	user_id	integer	user_id
board_id	board_id	integer	board_id
card_id	card_id	integer	card_id

定義

downloadAttachment回應

名稱	路徑	類型	Description
檔案名稱	data.file_name	string	附件檔名
Content	data.content	binary	附件內容（base64）

getAllCards回應

名稱	路徑	類型	Description
所有頁面	data.pagination.all_pages	integer	總頁數
當前頁面	data.pagination.current_page	integer	當前頁面
每頁結果	data.pagination.results_per_page	integer	每頁結果數
資料	data.data	array of object
卡片 ID	data.data.card_id	integer	內部卡 ID
自訂卡片 ID	data.data.custom_id	string	自訂卡片 ID
板 ID	data.data.board_id	integer	卡片的板 ID
工作流程識別碼	data.data.workflow_id	integer	卡片的工作流程識別碼
卡片標題	data.data.title	string	卡片標題
擁有者使用者 ID	data.data.owner_user_id		卡片的所有者 ID
類型識別碼	data.data.type_id		卡片類型 ID
顏色	data.data.color	string	卡片的顏色
章節	data.data.section	integer	卡片的區段 ID
資料行識別碼	data.data.column_id	integer	卡片的資料行識別碼
車道 ID	data.data.lane_id	integer	卡片的通道 ID

getCardAttachments回應

名稱	路徑	類型	Description
資料	data	array of object	資料
識別碼	data.id	integer	卡片附件 ID
檔案名稱	data.file_name	string	卡片附件檔名
連結	data.link	string	卡片附件連結

getCard回應

名稱	路徑	類型	Description
卡片 ID	data.card_id	integer	內部卡 ID
自訂卡片 ID	data.custom_id	string	自訂卡片 ID
板 ID	data.board_id	integer	卡片的板 ID
工作流程識別碼	data.workflow_id	integer	卡片的工作流程識別碼
卡片標題	data.title	string	卡片標題
擁有者使用者 ID	data.owner_user_id		卡片的所有者 ID
類型識別碼	data.type_id		卡片類型 ID
顏色	data.color	string	卡片的顏色
章節	data.section	integer	卡片的區段 ID
資料行識別碼	data.column_id	integer	卡片的資料行識別碼
車道 ID	data.lane_id	integer	卡片的通道 ID
Position	data.position	integer	卡片的位置
卡片說明	data.description	string	卡片說明
卡片尺寸	data.size		卡片大小
Priority	data.priority	integer	卡片的優先級 ID
Deadline	data.deadline	string	卡的截止日期
類型	data.reporter.type	string	值類型。可以是內部的，也可以是外部的
記者	data.reporter.value		卡片記者
創建於	data.created_at	string	建立卡片的時間戳記
上次修改時間	data.last_modified	string	卡上次修改的時間戳
已封鎖	data.is_blocked	integer	布林值，卡片是否被封鎖
自訂欄位	data.custom_fields	array of object	指派給卡片的自訂欄位陣列
欄位識別碼	data.custom_fields.field_id	integer	自訂欄位ID
欄位名稱	data.custom_fields.name	string	自訂欄位的名稱
欄位值	data.custom_fields.value		自訂欄位的值
欄位顯示值	data.custom_fields.display_value		自訂欄位的顯示值
values	data.custom_fields.values	array of object
值 ID	data.custom_fields.values.value_id	integer	自訂欄位值 ID
欄位值	data.custom_fields.values.value		自訂欄位的值

getObjectName回應

名稱	路徑	類型	Description
名稱	data.name	string	名稱

uploadAttachment回應

名稱	路徑	類型	Description
資料	data	array of object	資料
卡片 ID	data.card_id	integer	內部卡 ID
檔案名稱	data.file_name	string	要上傳的檔案名稱

共用方式為