在新增記錄畫面中變更欄位值時發生的事件

在新增記錄畫面或重複利用畫面上變更欄位值時發生的事件。

目錄

事件類型 事件觸發時機
電腦 app.record.create.change.欄位代碼
  • 在新增記錄畫面或重複利用畫面上,變更欄位代碼 中指定的值時
  • 執行應用操作並變更目標應用的新增記錄畫面上欄位代碼 中指定的值時
  • 您可以使用以下 API 建立一個欄位代碼當中指定的欄位的值被重寫時
    給記錄設定值
    可以用事件物件執行的操作
行動裝置 mobile.app.record.create.change.欄位代碼
  • 在新增記錄畫面或重複利用畫面上,變更欄位代碼 中指定的值時
  • 執行應用操作並變更目標應用的新增記錄畫面上欄位代碼 中指定的值時
  • 您可以使用以下 API 建立一個欄位代碼當中指定的欄位的值被重寫時
    給記錄設定值
    可以用事件物件執行的操作

事件物件屬性

屬性名稱 類型 說明
type 字串 事件類型
傳回以下值:
  • 電腦:app.record.create.change.欄位代碼
  • 行動裝置:mobile.app.record.create.change.欄位代碼
appId 數值 應用ID
record 物件 變更欄位值後記錄中的資料
詳情請參閱以下頁面。
欄位格式
changes 物件 修改後的欄位和子表中的行資料
changes.field 物件 值已變更的欄位的數據
changes.row 物件 表中值已變更的行資料

可以用事件物件執行的操作

可指定為域代碼的欄位

可以在欄位代碼中指定的欄位如下:

  • 選項按鈕
  • 下拉式選單
  • 核取方塊
  • 複選
  • 選擇使用者
  • 選擇組織
  • 選擇群組
  • 日期
  • 時間
  • 日期與時間
  • 單行文字方塊 *1
  • 數值 *2
  • 表格 *3
  • Lookup *4
caution
警告

Lookup欄位的支援,是開發評估中的功能。

若要使用,請從更新選項的「研議中的新功能」中,啟用「在Lookup欄位中觸發『變更欄位值時的事件』的功能」。
設定方法請參閱kintone說明的 啟用/停用新功能的步驟 (External link)

*1

該事件發生在以下時間之一:

  • 當控件失去焦點時
  • 用 Lookup 複製值時
  • 在電腦版的情況下,當套用自動計算結果時
^

*2 當控件失去焦點或在用 Lookup 複製值時,將發生該事件。 ^

*3 當您按鍵以添加或刪除表中的行時,將發生該事件。 ^

*4

該事件發生在以下時間之一。但僅在變更Lookup欄位中輸入的搜尋用關鍵字時,或Lookup所選參照來源的記錄已變更時才會發生。

  • 在Lookup欄位按下【取得】並確定要參照的記錄時(包含符合的記錄僅有1筆而自動取得的情況,以及從多個候選中透過對話方塊選擇的情況)
  • 清除Lookup欄位時
  • Lookup欄位失去焦點時

變更Lookup欄位值時的事件,會比變更複製目標欄位值時的事件更早發生。

^

限制事項

  • 僅當指定的欄位代碼為存在的欄位代碼,且為欄位代碼中可指定的欄位時,才會執行事件處理程式。
    可指定為域代碼的欄位
    如果指定不存在的欄位代碼或不可在欄位代碼中指定的欄位,則不會發生任何反應。
  • 若未啟用「研議中的新功能」,即使在事件名稱中指定 Lookup 欄位代碼,也不會觸發該事件。
    在此情況下,如果要使用 Lookup 欄位的值變更事件,請在事件名稱中指定要用 Lookup 來複製值的欄位代碼。
  • 無法取得附件欄位中的資訊。