Adalo 的 Test 會真的傳送訊息:將通知按鈕接上業務流程之前
用 Adalo 的 Ada 為應用程式串接通知 API 時,先說清楚測試接收端、範例變數與回傳結果。Custom Actions 的 Test 會執行真實請求;預覽成功後仍要檢查外部接收結果,再決定是否放入正式流程。
在內部申請應用程式加上「通知負責人」按鈕,看起來只是多一個操作。真正要交付的卻是完整流程:使用者提交什麼、訊息送到哪裡、收到什麼回應,以及失敗後介面如何說明。Adalo 的 Ada 能依自然語言修改應用程式,並透過 Custom Actions 串接外部 API;但官方文件明確說明,動作編輯器裡的 Test 會發出真實請求。
因此,第一次串接通知 API,應先準備僅供測試的接收端,再讓 Ada 串接介面。以下以提交申請後傳送通知為分析情境,依新 Ada 的官方文件設計驗證順序,並未實際執行應用程式或傳送訊息。
把接收端寫進需求,而不只寫「加個按鈕」
先將範圍縮小為一個完整動作:在測試應用程式中,使用者輸入一段虛構申請說明,點擊按鈕,將說明和測試紀錄編號傳送至指定測試接收端,再顯示成功或失敗。第一次嘗試不要同時加入簽核、付款與刪除紀錄。Ada 的建置指南建議從一項連貫的變更開始,這樣較容易判斷新功能是否改變了原有的導覽或資料行為。
替動作命名時,也要交代觸發條件與用途。例如「將目前的測試申請通知到測試頻道」,就比「處理申請」更容易核對。官方 Custom Actions 文件指出,Ada 會讀取動作描述,決定何時、如何呼叫它。描述不清楚,即使 API 已連通,之後仍可能接到錯誤的介面位置。
這裡的測試頻道只是情境選擇,並非所有服務都提供沙盒。接收服務若沒有隔離環境,先準備一個經允許、且不會打擾真實客戶的測試目的地;若做不到,就先保留介面草稿,不串接正式通知。
範例值也是真實操作的輸入
依接收服務的 API 文件填入方法、位址與所需變數,確認範例值是否全為虛構資料。尤其要核對目標頻道、電子郵件地址或紀錄編號,不要因為它們位於「範例」區域,就以為不會被使用。
Ada 文件說明,Test 會使用這些範例值執行請求,成功後保留回應樣本,協助將回傳欄位接到介面。它並不是只檢查格式的按鈕。測試前先寫下預期:哪個接收端應出現哪則訊息、應用程式應顯示什麼;測試後同時檢查外部與介面結果。API 回傳成功,但通知送錯地方,仍不算通過。
金鑰應放在專用的 Secrets 設定中,而不是提示詞、一般輸入欄位或範例訊息。官方說明這些金鑰會加密儲存在伺服器上,於呼叫時注入,不隨應用程式散布。這項機制不會替你決定哪些業務資料可以傳送給外部服務,傳送欄位仍需逐一篩選。
從按鈕走完整個流程
動作測試通過後,在預覽中從進入申請頁面開始走一遍,而不只是點一下新按鈕。接著以空白輸入、載入中與 API 失敗等情況,檢查提示是否容易理解。官方預覽指南要求檢查完整使用者流程及這些狀態;這不代表產生的介面已正確處理所有情況。
可以為通知流程列出三個驗收問題:成功提示是否對應接收端確實收到訊息;失敗時是否仍錯誤顯示已傳送;使用者重複點擊時,是否產生團隊無法接受的重複通知。如果重複傳送會帶來業務後果,需請 API 負責人確認防重複方案,不應假定 Ada 或接收服務已自動解決。
每次修改完成後,替版本取個容易辨認的名稱,例如「測試通知流程已核對」。Ada 文件說明,完成的變更可儲存為能命名及還原的版本。還原應用程式版本不應被當作撤回已傳送外部訊息的方法;通知離開應用程式後,需要接收端自己的機制來處理。
最後,將預覽驗收與上線驗收分開。正式環境可能使用不同目的地、金鑰及權限,切換後仍要使用獲准的測試內容,再核對一次完整流程。Adalo 官方也要求另外測試發布後的體驗。唯有介面回饋與外部動作能夠對應,這個按鈕才適合交給真正的業務使用者。
內容說明:本文基於公開資料整理,僅供工具選型參考。產品功能、價格及相關政策可能隨時調整,請以官方最新資訊為準。
原文出處:ada-help.adalo.com