跳轉到

傳遞資料

傳遞 (Pass) 任務是工作流程 (Workflow) 裡最單純的一種步驟:它不呼叫任何外部服務、也不做運算,只負責把你指定的資料原封不動往下傳,或在資料流中注入一組固定值。常用來在分支之間搬資料、補上預設值,或在開發時當作佔位步驟。

這頁能幫你做什麼

  • 把上一步的資料直接傳給下一步,不做任何外部呼叫。
  • 在工作流程中注入固定的設定值或預設值。
  • 在尚未接上真正邏輯前,先放一個佔位步驟把流程串起來測試。

開始前

這個任務沒有外部前置需求,不需要建立任何資源即可使用。

操作步驟

  1. 在工作流程編輯器中新增一個傳遞任務(如何新增請見 Action 使用指南)。

    傳遞資料任務設定面板

  2. 點選節點,右側開啟設定表單,停在「設定」分頁。

  3. 在「名稱」欄位為這個步驟取一個好辨識的名字。
  4. 在「參數」填入要往下傳的 JSON 內容(可填固定值,也可用 JSONPath 從上一步取值,路徑寫法見 JSONPath 語法)。
  5. 設定「下一個狀態」。
  6. 可用表單上方的測試按鈕()試跑,確認輸出符合預期。

完整欄位說明

設定分頁

欄位 必填 預設 說明
名稱 這個步驟在工作流程中的識別名稱,須在同一工作流程內唯一。詳見 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 類型。