在新增記錄畫面中變更欄位值時發生的事件
在新增記錄畫面或重複利用畫面上變更欄位值時發生的事件。
| 事件類型 | 事件觸發時機 | |
|---|---|---|
| 電腦 | app.record.create.change.欄位代碼
|
|
| 行動裝置 | mobile.app.record.create.change.欄位代碼
|
|
事件物件屬性
| 屬性名稱 | 類型 | 說明 |
|---|---|---|
| type | 字串 | 事件類型 傳回以下值:
|
| appId | 數值 | 應用ID |
| record | 物件 | 變更欄位值後記錄中的資料 詳情請參閱以下頁面。 欄位格式 |
| changes | 物件 | 修改後的欄位和子表中的行資料 |
| changes.field | 物件 | 值已變更的欄位的數據 |
| changes.row | 物件 | 表中值已變更的行資料 |
可以用事件物件執行的操作
可指定為域代碼的欄位
可以在欄位代碼中指定的欄位如下:
警告
Lookup欄位的支援,是開發評估中的功能。
若要使用,請從更新選項的「研議中的新功能」中,啟用「在Lookup欄位中觸發『變更欄位值時的事件』的功能」。
設定方法請參閱kintone說明的
啟用/停用新功能的步驟
。
*1
該事件發生在以下時間之一:
- 當控件失去焦點時
- 用 Lookup 複製值時
- 在電腦版的情況下,當套用自動計算結果時
*2 當控件失去焦點或在用 Lookup 複製值時,將發生該事件。 ^
*3 當您按鍵以添加或刪除表中的行時,將發生該事件。 ^
*4
該事件發生在以下時間之一。但僅在變更Lookup欄位中輸入的搜尋用關鍵字時,或Lookup所選參照來源的記錄已變更時才會發生。
- 在Lookup欄位按下【取得】並確定要參照的記錄時(包含符合的記錄僅有1筆而自動取得的情況,以及從多個候選中透過對話方塊選擇的情況)
- 清除Lookup欄位時
- Lookup欄位失去焦點時
變更Lookup欄位值時的事件,會比變更複製目標欄位值時的事件更早發生。
^限制事項
- 僅當指定的欄位代碼為存在的欄位代碼,且為欄位代碼中可指定的欄位時,才會執行事件處理程式。
可指定為域代碼的欄位
如果指定不存在的欄位代碼或不可在欄位代碼中指定的欄位,則不會發生任何反應。 - 若未啟用「研議中的新功能」,即使在事件名稱中指定 Lookup 欄位代碼,也不會觸發該事件。
在此情況下,如果要使用 Lookup 欄位的值變更事件,請在事件名稱中指定要用 Lookup 來複製值的欄位代碼。 - 無法取得附件欄位中的資訊。
