控件事件

在詳情頁創建記錄或編輯記錄時，支持自定義控件事件。在控件上有交互事件發生時，如果錶單內的數據滿足條件，則可以根據配置執行不同動作，如提醒、調用集成API等。

詳情頁始是指點擊創建按鈕顯示的創建頁麵，或點擊已有記錄打開的記錄頁麵。在視圖下編輯或批量編輯時控件事件不可用；導入、工作流新增時事件不生效。

常用場景：

• 獲取外部數據。創建記錄時，輸入快遞單號，直接調用API獲取物流信息寫入到字段中。

• 數據驗證提醒。當APP掃碼入庫齣現異常時，直接播放提示音提醒用戶查看。

• 修改字段值。當客戶登記選擇為VIP1時，摺扣率修改為95摺，選擇為VIP2是，摺扣率修改為85摺,不選擇會員時摺扣率為100。

場景示例

當客戶的會員等級選擇為VIP1時，摺扣率自動選擇95摺，選擇為VIP2是，摺扣率自動選擇85摺,不是會員或清空時時摺扣率選擇無摺扣。

配置入口

在錶單設計區點擊字段，在右側點選"事件"按鈕,然後點擊"+事件開始配置"

1.選擇事件類型

選擇“值改變時”的類型，選擇瞭等級字段或清除瞭選擇，都屬於值被改變。

2.配置事件的條件和動作

配置條件1和相應動作：等級選擇瞭VIP1時，摺扣率選擇為95摺。

條件配置：

執行動作：

3.繼續添加其他場景的條件和相應動作

點擊事件類型右側的添加條件按鈕，新建一個條件動作組。

效果演示：

字段支持事件類型

目前支持的事件有“顯示/隱藏時”、“值改變時”、“獲取/失去焦點時”。不同的控件類型，支持的事件類型不同，下錶列齣瞭不同類型控件支持的事件類型：

控件交互類型	顯示時	隱藏時	獲取焦點時	失去焦點時	值改變時	值改變並失去焦點時
輸入型	✅	✅	✅	✅	🚫	✅
動作型	✅	✅	🚫	🚫	✅	🚫
隻讀型	✅	✅	🚫	🚫	🚫	🚫
選項型	✅	✅	🚫	🚫	✅	🚫
關聯型	✅	✅	🚫	🚫	✅	🚫

輸入型：文本、數值（直接輸入）、金額、郵箱、電話、富文本、證件

動作型：數值（進度、計步器）、日期、時間、附件、檢查項、等級、定位、簽名

隻讀型：公式、自動編號、文本識彆、API查詢（按鈕）、條碼、大寫金額、嵌入、查詢記錄、他錶字段、匯總、自由連接、分段、標簽頁、備注

選項型：地區、單選、多選、成員、部門、組織角色、API查詢（下拉框）

關聯型：關聯記錄、子錶、級聯選擇

執行動作類型

目前在事件發生時支持的執行動作有以下幾種：

執行動作	說明
顯示/隱藏	指定在事件發生時要顯示或隱藏的字段（與業務規則不同，僅在事件發生時生效）
設置隻讀/可編輯	指定在事件發生時要設置隻讀或可編輯的字段（與業務規則不同，僅在事件發生時生效）
設置字段值	在事件發生時更新某個字段的值為指定值
刷新字段值	在事件發生時，主動刷新公式、匯總、文本組閤等計算字段的值
調用已集成 API	在事件發生時，調用指定的已集成 API，並可以將返迴的值映射寫迴到當前錶單記錄
顯示消息	在事件發生時顯示一個自定義的全局提示消息
播放聲音	在事件發生時播放指定的音效或聲音文件

事件執行條件

在字段控件事件發生時，用戶可以設置還需要同時滿足指定條件纔會執行動作。支持在同一個事件下設置多組不同的條件，當一組條件不滿足時，將繼續匹配其餘條件，直至匹配成功後則執行滿足該條件下的動作。目前支持設置的條件類型包括：

條件類型	說明
按字段值	在事件發生時，如果當前錶單的字段值滿足設置的篩選條件，則執行動作
按查詢工作錶	在事件發生時，如果按指定的篩選條件滿足查詢工作錶後的期望結果，則執行動作
按自定義函數	在事件發生時，如果運行自定義編寫的 javascript 代碼（可引用當前錶單字段）返迴 true，則執行動作

和屬性、業務規則的優先級

1. 所有控件事件的執行動作均按配置的順序從上往下執行。
2. 在加載錶單時，會在加載完成後將所有可見字段的“顯示時”事件動作執行一遍，此時按錶單布局的順序依次執行每個字段的“顯示時”事件，事件中的執行動作從上往下順序執行。
3. 字段配置中勾選的屬性（不是通過業務規則設置），比如 隱藏、隻讀，可以通過事件來修改屬性為顯示和可編輯。
4. 業務規則中設置瞭“隱藏”、“顯示”動作的字段，執行業務規則時如顯示狀態發生變化，會觸發該字段的“隱藏時”、“顯示時”事件。
5. 控件事件與業務規則的顯示、隱藏、隻讀、可編輯動作在同一個字段生效時，先把事件動作按先後順序執行完畢，再按 隱藏 > 顯示、顯示時 隻讀 > 必填 > 可編輯 與業務規則閤並進行處理。