Set Record Value

Set Record Value - kintone.app.record.set()

Places values inside fields of the record that is currently being edited.

Function

Desktop

kintone.app.record.set(record)

Mobile

kintone.mobile.app.record.set(record)

Parameters

PARAMETER VALUE REQUIRED DESCRIPTION
record JSON Yes Specify the record data as JSON. (The format is the same as the response for kintone.app.record.get)

Response

None

Sample

1
2
3
var record = kintone.app.record.get();
record.record.single_text_field.value = 'new content!';
kintone.app.record.set(record);

Available Pages (Desktop)

  • Record Create
  • Record Edit

Available Pages (Mobile)

  • Record Create
  • Record Edit

Notes

  • kintone.app.record.set and kintone.mobile.app.record.set cannot be called in the kintone.events.on handler. If you need to retrieve record data in the event handler, utilize the event object, as that has the record data inside.
  • The following operations can be performed:
    • Replacing a field value
    • Make a field editable or disabled
    • Set a field error
    • Automatically run a lookup field
    • Automatically clear a lookup field
  • The following field cannot be set with kintone.app.record.set and kintone.mobile.app.record.set:
    • Attachment
  • Setting the value of the Number field with an invalid value will result in an error.
  • If the value of the Number field is set to #INVALID!, the value will not change.
  • After using this API for the Number field, any whitespaces included in the value may be sanitized. In this case, Kintone events will not be triggered.