kintone API文件

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

information

本頁面使用機器翻譯而成。
機器翻譯免責聲明 (External link)

目錄

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

連結已複製

在記錄編輯畫面上變更欄位值時發生的事件。

事件類型 事件何時發生？
電腦 app.record.edit.change.欄位代碼
行動裝置 mobile.app.record.edit.change.欄位代碼

事件物件屬性

連結已複製

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

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

連結已複製

可指定為域代碼的欄位

連結已複製

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

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

*1

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

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

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

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

限制事項
  • 僅當指定的欄位代碼為存在的欄位代碼，且為欄位代碼中可指定的欄位時，才會執行事件處理程式。
    可指定為域代碼的欄位
    如果指定不存在的欄位代碼或不可在欄位代碼中指定的欄位，則不會發生任何反應。
  • 如果在事件名稱中指定 Lookup 欄位代碼，則不會引發該事件。
    如果要使用 Lookup 欄位的值變更事件，請在事件名稱中指定要用 Lookup 來複製值的欄位代碼。
  • 無法獲取附件欄位中的資訊。