跳至主要内容

控件事件

在詳情頁創建記錄或編輯記錄時,支持自定義控件事件。在控件上有交互事件發生時,如果錶單內的數據滿足條件,則可以根據配置執行不同動作,如提醒、調用集成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. 控件事件與業務規則的顯示、隱藏、隻讀、可編輯動作在同一個字段生效時,先把事件動作按先後順序執行完畢,再按 隱藏 > 顯示、顯示時 隻讀 > 必填 > 可編輯 與業務規則閤並進行處理。