傳遞資料¶
傳遞 (Pass) 任務是工作流程 (Workflow) 裡最單純的一種步驟:它不呼叫任何外部服務、也不做運算,只負責把你指定的資料原封不動往下傳,或在資料流中注入一組固定值。常用來在分支之間搬資料、補上預設值,或在開發時當作佔位步驟。
這頁能幫你做什麼¶
- 把上一步的資料直接傳給下一步,不做任何外部呼叫。
- 在工作流程中注入固定的設定值或預設值。
- 在尚未接上真正邏輯前,先放一個佔位步驟把流程串起來測試。
開始前¶
這個任務沒有外部前置需求,不需要建立任何資源即可使用。
操作步驟¶
-
在工作流程編輯器中新增一個傳遞任務(如何新增請見 Action 使用指南)。

-
點選節點,右側開啟設定表單,停在「設定」分頁。
- 在「名稱」欄位為這個步驟取一個好辨識的名字。
- 在「參數」填入要往下傳的 JSON 內容(可填固定值,也可用 JSONPath 從上一步取值,路徑寫法見 JSONPath 語法)。
- 設定「下一個狀態」。
- 可用表單上方的測試按鈕()試跑,確認輸出符合預期。
完整欄位說明¶
設定分頁¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 名稱 | 是 | 無 | 這個步驟在工作流程中的識別名稱,須在同一工作流程內唯一。詳見 Action 通用設定。 |
| 參數 | 是 | 空物件 {} | 要往下傳的資料,以 JSON 物件表示。支援兩種用法:直接傳遞(把指定內容原樣往下送),或在傳遞前用 JSONPath 從上一步輸出取值、重組成新的資料格式。 |
| 下一個狀態 | 是 | 無 | 這步完成後要前往的下一個步驟。詳見 Action 通用設定。 |
| 附註 | 否 | 空白 | 給這個步驟的備註說明,不影響執行。 |
執行設定(摺疊區塊)¶
展開「設定」分頁底部的「執行設定」可看到下列共用欄位,完整說明見 Action 通用設定。
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 上傳輸出至外部記憶體 | 否 | 關閉 | 開啟後這步的輸出改存到外部記憶體,適合輸出資料量很大時使用。 |
| 在任務開始階段開啟即時輸出串流 | 否 | 關閉 | 開啟後,任務開始時把任務定義以串流方式即時送到執行頁面顯示。 |
| 在任務結束階段開啟即時輸出串流 | 否 | 關閉 | 開啟後,任務結束時把結果以串流方式即時送到執行頁面顯示。 |
| 錯誤時中止 | 否 | 開啟 | 開啟(預設)代表這步出錯時整個工作流程中止;關閉後改用下方「預設輸出」繼續往下走。 |
| 預設輸出 | 否 | 無 | 只在關閉「錯誤時中止」時出現,指定出錯時要改用的替代輸出值。 |
輸入與輸出、錯誤處理¶
切到「輸入與輸出」、「錯誤處理」分頁可調整資料流與重試/捕捉規則,皆為各 Action 共用設定,完整說明見 Action 通用設定。
用 InputPath/OutputPath 控制傳遞範圍
若只想讓資料的某一部分流經這步,可在「輸入與輸出」分頁用 InputPath、OutputPath 篩選,搭配參數一起使用。
實際範例¶
注入一組固定的狀態值:
- 參數 (Parameters):
{
"status": "ok"
}
這步會把上面的內容當成輸出往下傳。也可以混入動態值,例如保留使用者 ID 並補上一個固定標記:
{
"user_id": "$.user.id",
"action": "proceed",
"metadata": {
"step": "payment_verified"
}
}
整個物件會成為這步的輸出,交給下一個步驟使用。
下一步¶
- 需要修改資料結構或寫一段 Python 處理資料(字串替換、攤平、繁簡轉換)→ 程式碼任務。
- 回到 Action 使用指南 了解共用設定與其他 Action 類型。