控件事件
在詳情頁創建記錄或編輯記錄時,支持自定義控件事件。在控件上有交互事件發生時,如果錶單內的數據滿足條件,則可以根據配置執行不同動作,如提醒、調用集成API等。
詳情頁始是指點擊創建按鈕顯示的創建頁麵,或點擊已有記錄打開的記錄頁麵。在視圖下編輯或批量編輯時控件事件不可用;導入、工作流新增時事件不生效。
常用場景:
獲取外部數據。創建記錄時,輸入快遞單號,直接調用API獲取物流信息寫入到字段中。
數據驗證提醒。當APP掃碼入庫齣現異常時,直接播放提示音提醒用戶查看。
修改字段值。當客戶登記選擇為VIP1時,摺扣率修改為95摺,選擇為VIP2是,摺扣率修改為85摺,不選擇會員時摺扣率為100。
場景示例
當客戶的會員等級選擇為VIP1時,摺扣率自動選擇95摺,選擇為VIP2是,摺扣率自動選擇85摺,不是會員或清空時時摺扣率選擇無摺扣。
配置入口
在錶單設計區點擊字段,在右側點選"事件"按鈕,然後點擊"+事件開始配置"
1.選擇事件類型
選擇“值改變時”的類型,選擇瞭等級字段或清除瞭選擇,都屬於值被改變。
2.配置事件的條件和動作
配置條件1和相應動作:等級選擇瞭VIP1時,摺扣率選擇為95摺。
條件配置:
執行動作:
3.繼續添加其他場景的條件和相應動作
點擊事件類型右側的添加條件按鈕,新建一個條件動作組。
效果演示:
字段支持事件類型
目前支持的事件有“顯示/隱藏時”、“值改變時”、“獲取/失去焦點時”。不同的控件類型,支持的事件類型不同,下錶列齣瞭不同類型控件支持的事件類型:
控件交互類型 | 顯示時 | 隱藏時 | 獲取焦點時 | 失去焦點時 | 值改變時 | 值改變並失去焦點時 |
---|---|---|---|---|---|---|
輸入型 | ✅ | ✅ | ✅ | ✅ | 🚫 | ✅ |
動作型 | ✅ | ✅ | 🚫 | 🚫 | ✅ | 🚫 |
隻讀型 | ✅ | ✅ | 🚫 | 🚫 | 🚫 | 🚫 |
選項型 | ✅ | ✅ | 🚫 | 🚫 | ✅ | 🚫 |
關聯型 | ✅ | ✅ | 🚫 | 🚫 | ✅ | 🚫 |
輸入型:文本、數值(直接輸入)、金額、郵箱、電話、富文本、證件
動作型:數值(進度、計步器)、日期、時間、附件、檢查項、等級、定位、簽名
隻讀型:公式、自動編號、文本識彆、API查詢(按鈕)、條碼、大寫金額、嵌入、查詢記錄、他錶字段、匯總、自由連接、分段、標簽頁、備注
選項型:地區、單選、多選、成員、部門、組織角色、API查詢(下拉框)
關聯型:關聯記錄、子錶、級聯選擇
執行動作類型
目前在事件發生時支持的執行動作有以下幾種:
執行動作 | 說明 |
---|---|
顯示/隱藏 | 指定在事件發生時要顯示或隱藏的字段(與業務規則不同,僅在事件發生時生效) |
設置隻讀/可編輯 | 指定在事件發生時要設置隻讀或可編輯的字段(與業務規則不同,僅在事件發生時生效) |
設置字段值 | 在事件發生時更新某個字段的值為指定值 |
刷新字段值 | 在事件發生時,主動刷新公式、匯總、文本組閤等計算字段的值 |
調用已集成 API | 在事件發生時,調用指定的已集成 API,並可以將返迴的值映射寫迴到當前錶單記錄 |
顯示消息 | 在事件發生時顯示一個自定義的全局提示消息 |
播放聲音 | 在事件發生時播放指定的音效或聲音文件 |
事件執行條件
在字段控件事件發生時,用戶可以設置還需要同時滿足指定條件纔會執行動作。支持在同一個事件下設置多組不同的條件,當一組條件不滿足時,將繼續匹配其餘條件,直至匹配成功後則執行滿足該條件下的動作。目前支持設置的條件類型包括:
條件類型 | 說明 |
---|---|
按字段值 | 在事件發生時,如果當前錶單的字段值滿足設置的篩選條件,則執行動作 |
按查詢工作錶 | 在事件發生時,如果按指定的篩選條件滿足查詢工作錶後的期望結果,則執行動作 |
按自定義函數 | 在事件發生時,如果運行自定義編寫的 javascript 代碼(可引用當前錶單字段)返迴 true,則執行動作 |
和屬性、業務規則的優先級
- 所有控件事件的執行動作均按配置的順序從上往下執行。
- 在加載錶單時,會在加載完成後將所有可見字段的“顯示時”事件動作執行一遍,此時按錶單布局的順序依次執行每個字段的“顯示時”事件,事件中的執行動作從上往下順序執行。
- 字段配置中勾選的屬性(不是通過業務規則設置),比如 隱藏、隻讀,可以通過事件來修改屬性為顯示和可編輯。
- 業務規則中設置瞭“隱藏”、“顯示”動作的字段,執行業務規則時如顯示狀態發生變化,會觸發該字段的“隱藏時”、“顯示時”事件。
- 控件事件與業務規則的顯示、隱藏、隻讀、可編輯動作在同一個字段生效時,先把事件動作按先後順序執行完畢,再按 隱藏 > 顯示、顯示時 隻讀 > 必填 > 可編輯 與業務規則閤並進行處理。