Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

FieldWriteOptions structure- Android

The FieldWriteOptions class provides functions that set the options for updating or creating fields in a record on a ServiceNow instance.

NameTypeDescription
queryItemsMap<String, String>Collection of request query items that represent the write options.

Parent Topic:Mobile SDK - Android

FieldWriteOptions - FieldWriteOptions(vararg options: FieldWriteOptions.Options)

Sets the options for writing or creating fields in a record on your ServiceNow instance.

NameTypeDescription
vararg optionsFieldWriteOptions.OptionsOptions to set when creating or writing to fields.Valid values: - TREAT\_INPUT\_VALUES\_AS\_DISPLAY\_VALUES: Specified field values should be saved as the display values. If this value isn't set to `true`, the passed values are assumed to be the actual field values. - SUPPRESS\_AUTO\_SYS\_FIELD: Suppress auto-generation of system fields.

The following code example shows how to call this function.

// Update assigned_to field using actual value (syd_id of user)
val response = runCatching {
    getNowTableService()?.updateRecord("sys_id_of_record", "sn_customerservice_case", mapOf("assigned_to" to "<sys_id_of_user>"))?.execute()
}

// Update assigned_to field using display value
val fieldWriteOptions = FieldWriteOptions(FieldWriteOptions.Options.TREAT_INPUT_VALUES_AS_DISPLAY_VALUES)
val response = runCatching {
    getNowTableService()?.updateRecord("sys_id_of_user", "sn_customerservice_case", mapOf("assigned_to" to "John Doe"))?.execute()
}