開始與結束節點¶
每一條工作流程都有兩個固定節點:「開始」與「結束」。它們和中間的任務節點不同——中間節點設定的是「這一步做什麼」,而「開始」與「結束」設定的是整條流程的輸入與輸出長相:執行時會收到哪些欄位、跑完又回傳什麼樣的結構。
點畫布上的「開始」或「結束」節點,右側一樣會滑出設定面板。
開始前
這頁假設你已經會進入工作流程編輯器、點選節點開啟設定面板。若還不熟,先看 編輯器介面導覽。
「開始」節點:輸入結構¶
「開始」節點面板最上方是「輸入結構」——一張有「名稱」、「類型」、「必填」、「可空」欄位的表格,用來宣告這條流程執行時會收到哪些輸入欄位。
定義輸入結構有兩個好處:
- 後面的節點可以引用這些欄位:用 JSONPath(例如
$.question)就能在任何步驟取到輸入值。 - 執行時自動產生填寫表單:平台會依結構長出對應的填寫欄位,使用者直接在欄位裡填值,不必手寫 JSON;沒有定義時則改以 JSON 編輯器呈現。
操作步驟¶
-
在編輯器畫布點選「開始」節點,右側滑出面板,最上方就是「輸入結構」表格(下圖已定義一個欄位)。

-
按「輸入結構」表格的新增()按鈕,開啟「新增屬性」對話框。
-
在「新增屬性」填寫欄位定義後按「儲存」(欄位說明見下表)。

「新增屬性」欄位說明¶
「開始」的輸入結構與「結束」的輸出結構,都用同一個「新增屬性」對話框定義欄位:
| 欄位 | 必填 | 說明 |
|---|---|---|
| 類型 | 是 | 這個欄位的資料型別,從下拉選單選一種;共有七種可選,各代表的意義見下方「『類型』可選值」。 |
| 名稱 | 是 | 欄位代號,後續用 JSONPath 引用時就是用這個名字(例如名稱填 question,引用時寫 $.question)。 |
| 必填 | 否 | 開啟後,執行時一定要帶到這個欄位才能送出。預設關閉。 |
| 可空 | 否 | 開啟後,這個欄位允許填空值(null)。預設關閉。 |
| 進階設定 | 否 | 展開後可再設定下列選填項目。 |
| └ 標題 | 否 | 顯示在填寫表單上的欄位標題(比代號更易讀的名稱)。 |
| └ 描述 | 否 | 欄位的說明文字,提示填寫者這格要填什麼。 |
| └ 列舉 | 否 | 限定這個欄位只能從你列出的幾個值中選擇。 |
| └ 預設值 | 否 | 沒有填值時自動帶入的值。 |
「類型」可選值¶
「類型」下拉選單共有七種資料型別,決定這個欄位要裝什麼樣的資料。選哪一種,也會影響「進階設定」裡能再設定的限制(見下一節):
- 字串():一般純文字,例如姓名、問題、地址、一段說明。最常用的型別;不確定要選哪種時通常選這個。
- 數字():可以有小數的數值,例如金額
199.9、溫度25.5、比率。 - 整數():不帶小數的整數,例如數量
3、年齡40、頁數。 - 布林值():只有「是/否」兩種值(
true或false),適合用來表示開關或勾選,例如「是否同意條款」。 - 陣列():同一種項目可以有很多筆的清單,例如多個關鍵字、多筆訂單、一串檔案。
- 物件():由多個「欄位名稱 + 值」組成的成組資料,例如把姓名、電話、地址包成一筆「聯絡人」。物件裡還可以再往下定義子欄位。
- 檔案():讓使用者上傳檔案當輸入,例如要分析的 PDF、要抽取資料的合約文件。
不確定選哪個就先選「字串」
對多數文字型輸入(問題、描述、代號)來說,「字串」就夠用。需要計算或比大小才用「數字」/「整數」;要一次收多筆同類資料用「陣列」;要把幾個欄位綁成一組用「物件」;要收附件才用「檔案」。
「進階設定」裡還會依「類型」多出對應的限制欄位,例如「字串」會有「最小長度」、「最大長度」,數值型別則有數值範圍等。

實際效果¶
定義好輸入結構後,執行這條流程時,平台就會依結構自動長出填寫表單。例如定義了一個必填字串欄位 question,執行畫面就會出現一個必填的「Question」欄位,直接把問題打進去即可,不必手寫 JSON。

逐步定義輸入欄位、再實際執行的完整示範,另見 快速開始。
「結束」節點:輸出結構¶
「結束」節點面板提供「輸出結構」,用來定義這條流程最後要回傳什麼樣的結構。它和「開始」的輸入結構一樣是一張「名稱」、「類型」、「必填」、「可空」的屬性表格,一樣按新增()按鈕、用同一個「新增屬性」對話框(欄位說明見上表)逐一加入要回傳的欄位。

它決定每次執行結果中「輸出」的長相:
- 不定義輸出結構:回傳流程跑到最後的完整輸出,裡面可能殘留中間步驟累積的多餘欄位,結構較雜。
- 定義輸出結構:平台會依結構整理回傳值——只保留你宣告的欄位、丟掉其餘欄位,必要時補上預設值,得到乾淨、固定格式的輸出,方便外部系統接收。
輸出結構是整條流程層級的設定
雖然在「結束」節點面板裡編輯,「輸出結構」存的是整條工作流程的輸出結構,不是某個節點專屬的欄位。