Field types

Record objects that you work with in JavaScript are JSON-formatted objects that contain record information such as field IDs and field values.

Each field in a kumaneko app has a field ID, that is unique within the App. These field IDs are necessary when creating, retrieving, and updating data via API. To check the field ID, hover over the field in the form settings, and open up the settings menu from the cog wheel that appears.

References:

Creating an Form

Type Sample (Replace "field_(n)_" with your field’s field ID)
text
"field_(n)_":{
	value: "This is kumaneko"
}
textarea
"field_(n)_":{
	value: "This is\nkumaneko"
}
number
"field_(n)_":{
	value: 100
}
date
"field_(n)_":{
	value: "2022-06-15"
}
datetime
"field_(n)_":{
	value: "2022-06-15T18:20:00Z"
}

The format is UTC (yyyy-mm-ddThh: mm: ssZ).

time
"field_(n)_":{
	value: "09:30"
}
radio
"field_(n)_":{
	value: "option5"
}
dropdown
"field_(n)_":{
	value: "option5"
}
checkbox
"field_(n)_":{
	value: [
		"option2",
		"option3"
	]
}
file
"field_(n)_":{
	value: [
		{
			filekey: "16553623222577001.pdf",
			filetype: "application/pdf",
			name: "report.pdf"
		},
		{
			filekey: ...,
			filetype: ...,
			name: ...
		}
	]
}

Assign the filekey generated by the file upload API to filekey.

References:

File operations

user
"field_(n)_":{
	value: ["1", "3"]
}

The value is the userID of the string.

department
"field_(n)_":{
	value: ["1", "3"]
}

The value is the departmentID of the string.

group
"field_(n)_":{
	value: ["1", "3"]
}

The value is the groupID of the string.

lookup
"field_(n)_":{
	search: "Key value",
	value: 1
}
search:
It is the value of the field specified in "Key Field" of the copy source record.
value:
It is the record ID of the copy source record.
address
"field_(n)_":{
	value: "4 Pennsylvania Plaza, New York, NY 10001"
}
color
"field_(n)_":{
	value: "#ea5532"
}
canvas
"field_(n)_":{
	value: "16791856469633001.fpdx"
}

This field is read-only.

table
"field_(n)_":{
	value: [
		{
			"field_(n1)_":{
				value: "This is the text field in the first row of the table"
			},
			"field_(n2)_":{
				value: "2022-06-20"
			}
		},
		{
			"field_(n1)_":{
				value: "This is the text field in the second row of the table"
			},
			"field_(n2)_":{
				value: "2022-06-25"
			}
		}
	]
}

When updating or adding data to a table, the API overwrites the table with the number of rows in the JSON data table.

At that time, the feed on the table data side is copied for the fields that are not in the table on the JSON data side.

id
"__id":{
	value: 1
}

The field ID of this field is fixed to "__id" and is read-only.

autonumber
"__autonumber":{
	value: "PD_A_001"
}

The field ID of this field is fixed to "__autonumber" and is read-only.

creator
"__creator":{
	value: ["1"]
}

The value is the userID of the string.

The field ID of this field is fixed to "__creator" and is read-only.

createdtime
"__createdtime":{
	value: "2022-09-01T15:07:00Z"
}

The format is UTC (yyyy-mm-ddThh: mm: ssZ).

The field ID of this field is fixed to "__createdtime" and is read-only.

modifier
"__modifier":{
	value: ["1"]
}

The value is the userID of the string.

The field ID of this field is fixed to "__modifier" and is read-only.

modifiedtime
"__modifiedtime":{
	value: "2022-09-01T15:07:00Z"
}

The format is UTC (yyyy-mm-ddThh: mm: ssZ).

The field ID of this field is fixed to "__modifiedtime" and is read-only.