建構情境

編輯器

畫布在中央，新增面板與檢視器在四周。方塊可以用滑鼠拖動，整個視圖也可以平移與 縮放。

新增方塊

從新增面板加入，面板依類別整理：控制、組合（請求與連線）、清單、迴圈、時間、 數學、演算法、資料格式、編碼、介面、公用程式。

繫結到某個請求的動作（HTTP 請求、SOAP 請求，以及所有連線動作）會要求您 指定它所驅動的專案請求。

情境 ↔ 請求的關聯

在動作中指定一個請求會建立一條強關聯：動作是以識別碼引用該請求，而不是 引用一份複本。由此推導出幾件事：

• 該請求仍然是共用的 — 修改它（URL、標頭、內文）會改變所有使用它的情境 下一次執行的內容；
• 這條關聯不會因為請求在樹狀結構中被改名或搬移而失效：它既不依賴名稱，也不 依賴路徑；
• 從請求那一側看，smartbar 上有一個 **「被哪些情境使用」**按鈕 — 它會列出呼叫這個請求的情境，並讓您直接跳過去。 在修改一個共用請求之前，這正是該有的習慣動作；
• 一個缺失的請求（已被刪除，或在開啟專案時就不存在）會讓情境的驗證失敗： 執行按鈕會保持停用，出問題的方塊也會被標示出來 — 絕不會有默默壞掉的情境。

若要在不動到已儲存版本的前提下重跑同一個請求，請不要修改它，而是使用 覆寫請求一節介紹的各種覆寫手段（快速設定、動作上的覆寫值、連結）。

設定方塊

每個方塊都有自己的欄位，可以直接在方塊上填，也可以在檢視器裡填。這些欄位接受 具型別的值 — 字串、數字、布林、日期、Handlebars 運算式、變數、自訂清單、 密鑰…… — 請參閱 變數與環境。

在支援的欄位中，Ctrl+Space 會觸發變數與 helper 的自動完成。

接線

請從一個輸出連接埠拉到一個輸入連接埠。

有兩條規則要知道：

1. 一個輸入連接埠只接受一條連結 — 只有 in 連接埠例外，它要幾條都可以， 並因此扮演屏障的角色。
2. **純訊號的輸出不能餵給純值的輸入。**其餘組合都允許：帶有值的輸出同時也能 當作觸發器。

細節請參閱連接埠與連結。

連結選擇器

一條連結可以帶一個選擇器：套用在傳遞中的值之上的路徑。

data.items[0].id
body['user-id']
status

有了它，就不必在每個呼叫與它的消費端之間插一個轉換方塊。選擇器可以在建立連結時 設定，也可以之後再設定；清空它就等於移除它。

覆寫請求

繫結到某個請求的動作可以在不動到該請求本身的情況下修改它。共有四層，順序如下：

1. 已儲存的請求本身；
2. 在動作上指定的快速設定 （quick config） — 這正是把某個請求已儲存的變體直接在情境中重複使用 的方式，不必重新輸入一遍；
3. 在動作上填入的覆寫值；
4. 經由連結送到覆寫連接埠上的值。

這正是用三組資料重跑同一個呼叫的乾淨做法。

在每個事件上重跑

方塊的右鍵選單提供**「每收到一個事件就重跑」**。啟用之後，這個選項會把所有已接線 的輸入變成不阻塞的「或」閘：方塊會在任何連接埠收到值時就重新觸發，而不必等所有 輸入都到齊。

處理串流時（每一則 MQTT 訊息、每一個 SSE 事件）少不了它，而它也是解開完成迴圈 死結的關鍵。

參數與輸出

• Input / Param 方塊宣告情境的參數。它們可以在啟動時提供、在命令列上提供 （--param name=value），或在互動模式下於執行期詢問。
• Output / Return 方塊會對呼叫方公開一個結果 — 當這個情境被另一個情境透過 執行情境動作呼叫時特別有用。

整理

Restorm 能自動排列整張圖（版面配置）；之後方塊仍然可以手動搬動。Ctrl+Z 復原，Ctrl+Shift+Z 取消復原。

驗證

只要還有驗證錯誤，執行按鈕就會保持停用：無效的連結、缺失的請求、必填欄位 空白。出問題的方塊都會被標示出來。