程式碼¶

程式碼 (Code) 任務讓你直接在工作流程 (Workflow) 的執行環境中跑一段 Python 程式碼。和 Lambda 任務（呼叫外部 AWS 函式）不同，這個任務會在平台內部即時執行你貼上的程式碼，適合做小型資料轉換、計算衍生欄位或寫一段內建任務不好表達的處理邏輯。

這頁能幫你做什麼¶

• 用一段 Python 程式碼即時處理、轉換上一步傳來的資料。
• 計算總計、整理欄位、做條件判斷等小型邏輯，不必另外部署到 AWS。
• 在正式抽成 Lambda 或自訂工具之前，快速試做原型。

開始前¶

操作步驟¶

1. 在工作流程編輯器中新增一個程式碼任務（如何新增請見 任務使用指南）。

   

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

3. 在「名稱」欄位為這個步驟取一個好辨識的名字。

4. 在「執行環境」選擇要用「安全模式」還是「進階模式」（預設未選，見下方說明）。

   

   上圖是下拉點開之後的樣子。以非管理員帳號登入時清單裡只有「安全模式」一張選項卡，看起來像沒東西可選，這是正常的（見下方權限說明），不是你點錯地方。

5. 選定執行環境後，下方才會出現「程式碼」與「資料」欄位。在「程式碼」編輯器裡撰寫你的 handler 函式——欄位不是空的，平台已經預帶一份骨架（含一行提醒函式必須叫 handler 的註解，以及一個接收 data、回傳結果的空函式），照著改最快；不會寫 Python 也可以用「產生」（）按鈕請系統代寫（見下方用「產生」讓系統幫你寫程式碼）。

   

6. 視需要在「資料」欄位指定要傳進 handler 的輸入（可用 JSONPath 從上一步取值，路徑寫法見 JSONPath 語法）。

7. 設定「下一個狀態」。
8. 可用表單上方的「測試任務」按鈕（）試跑，確認輸出符合預期。

完整欄位說明¶

設定分頁¶

用「產生」讓系統幫你寫程式碼¶

「程式碼」欄位旁有一顆「產生」按鈕（）。它是給不會寫 Python 的人用的：用中文描述你要做什麼，系統就產生對應的 handler 函式。

1. 點「產生」，會跳出一個對話框，裡面有三個欄位：

   欄位	必填	說明
   描述	是	用白話寫你要這段程式碼做什麼，例如「把每筆訂單的單價乘數量加總，回傳小計與品項數」。寫得越具體，產出越接近你要的。
   輸入結構	否	這段程式碼會收到的資料長什麼樣（JSON 結構）。填了它，產生出來的程式碼才知道欄位名稱。
   輸入範例	否	一筆實際的輸入資料範例，作用同上，用真實資料比描述結構更好懂。

2. 按對話框的送出鈕，按鈕會變成「產生中...」；完成後產生的程式碼會直接覆蓋「程式碼」欄位裡原本的內容。

執行環境選項¶

「執行環境」下拉選單預設未選任何模式，有兩個選項可選：

執行設定（摺疊區塊）¶

展開「設定」分頁底部的「執行設定」可看到下列共用欄位，完整說明見 任務通用設定。

輸入與輸出、錯誤處理¶

切到「輸入與輸出」、「錯誤處理」分頁可調整資料流與重試／捕捉規則，皆為各任務共用設定，完整說明見 任務通用設定。

實際範例¶

把訂單明細加總，計算小計與品項數量。

• 執行環境：安全模式
• 資料：$.order
• 程式碼：

def handler(data):
    items = data.get("items", [])
    subtotal = sum(i["price"] * i["quantity"] for i in items)
    return {
        "order_id": data["order_id"],
        "subtotal": subtotal,
        "item_count": sum(i["quantity"] for i in items),
    }

當這步收到：

{
  "order": {
    "order_id": "ord-123",
    "items": [
      {"price": 49.99, "quantity": 2},
      {"price": 19.99, "quantity": 1}
    ]
  }
}

handler 會回傳 order_id、subtotal（119.97）與 item_count（3），交給下一步使用。

下一步¶

• 只想注入常數或在傳遞時補欄位 → Pass 任務。
• 邏輯較重、需外部套件或集中部署 → Lambda 任務。
• 回到 任務使用指南 了解共用設定。