Index
关于可使用的字段的Type和Value
字段的JSON格式如下。type和value因字段类型的不同而不同。
获取、添加或更新数据时请指定就“字段代码”。
※“字段代码”可在字段的“设置”页面中查看。以下类型的字段请指定“字段名称”。
类别
状态
执行者
使用添加、更新API发送JSON数据时,只需发送“value”参数。“type”无需发送。
※下文中也会提及到,个别JavaScript API在添加或更新“表格”数据时需要指定“type”。
关于记录编号和记录ID
记录编号:系统自动分配给记录的、与其他记录不重复的编号。
但是,如设置了应用代码,则应用代码和编号组合起来作为记录编号。
例如:应用代码为“APPCODE”的应用,其记录编号为“APPCODE-1”。记录ID:系统自动分配给记录的、与其他记录不重复的编号,必须为数值。
处理API时,请使用记录ID。
字段格式
记录信息中的字段
字段类型 | type | value的范例 ※此处,【value的范例】的【字段代码】用< >括起开,实际使用时不需要。 |
---|---|---|
记录编号 ※3 | RECORD_NUMBER |
"<字段代码>": { "type": "RECORD_NUMBER", "value": "1" }以下为应用代码指定为【APPCODE】时的范例。 "<字段代码>": { "type": "RECORD_NUMBER", "value": "APPCODE-1" } |
记录ID ※3 | __ID__ |
"$id": { "type": "__ID__", "value": "1" } |
版本 ※3 | __REVISION__ |
"$revision": { "type": "__REVISION__", "value": "5" } |
创建人 ※4 | CREATOR |
"<字段代码>": { "type": "CREATOR", "value": { "code": "zhou", "name": "zhou shijie" } } 来宾用户的情况 "<字段代码>": { "type": "CREATOR", "value": { "code": "guest/zhou@cybozu.cn", "name": "zhou shijie" } } |
"<字段代码>": { "value": { "code": "zhou" } } | ||
创建时间 ※4 | CREATED_TIME |
"<字段代码>": { "type": "CREATED_TIME", "value": "2012-01-11T11:30:00Z" }・【YYYY-MM-DD】和【HH:MM:SS】之间的【T】为固定值。 ・【HH:MM:SS】之后的【Z】为固定值,表示UTC。 |
"<字段代码>": { "value": "2012-01-11T11:30:00Z" }・【YYYY-MM-DD】和【HH:MM:SS】之间的【T】为固定值。 ・【HH:MM:SS】之后的【Z】为固定值,表示UTC。 "<字段代码>": { "value": "2012-01-11T11:30:00+08:00" } ・需使用【±HH:MM】指定与UTC的时差。 ・不可指定未来的时间。 | ||
更新人 ※4 | MODIFIER |
"<字段代码>": { "type": "MODIFIER", "value": { "code": "zhou", "name": "zhou shijie" } } 来宾用户的情况 "<字段代码>": { "type": "MODIFIER", "value": { "code": "guest/zhou@cybozu.cn", "name": "zhou shijie" } } |
"<字段代码>": { "value": { "code": "zhou" } } | ||
更新时间 ※4 | UPDATED_TIME |
"<字段代码>": { "type": "UPDATED_TIME", "value": "2012-01-11T11:30:00Z" }・【YYYY-MM-DD】和【HH:MM:SS】之间的【T】为固定值。 ・【HH:MM:SS】之后的【Z】为固定值,表示UTC。 |
"<字段代码>": { "value": "2012-01-11T11:30:00Z" }・【YYYY-MM-DD】和【HH:MM:SS】之间的【T】为固定值。 ・【HH:MM:SS】之后的【Z】为固定值,表示UTC。 "<字段代码>": { "value": "2012-01-11T11:30:00+08:00" }・需使用【±HH:MM】指定与UTC的时差。 ・不可指定未来的时间。 |
自定义字段
字段类型 | type | value |
---|---|---|
单行文本框 | SINGLE_LINE_TEXT |
"<字段代码>": { "type": "SINGLE_LINE_TEXT", "value": "文本内容。" } |
"<字段代码>": { "value": "文本内容。" } | ||
多行文本框 | MULTI_LINE_TEXT |
"<字段代码>": { "type": "MULTI_LINE_TEXT", "value": "文本\n内容。" } |
"<字段代码>": { "value": "文本\n内容。" } | ||
文本编辑框 | RICH_TEXT |
"<字段代码>": { "type": "RICH_TEXT", "value": "<a href=\"https://www.cybozu.cn\">才望子</a>" } |
"<字段代码>": { "value": "<a href=\"https://www.cybozu.cn\">才望子</a>" } | ||
数值 | NUMBER |
"<字段代码>": { "type": "NUMBER", "value": "123" } |
"<字段代码>": { "value": "123" } | ||
计算 ※3 | CALC |
"<字段代码>": { "type": "CALC", "value": "123" }根据显示格式的设置, "value" 的值也不同。
※以下事件时,"value"的值为空。 |
| ||
复选框 ※1 | CHECK_BOX |
"<字段代码>": { "type": "CHECK_BOX", "value": [ "选项1", "选项2" ] } |
"<字段代码>": { "value": [ "选项1", "选项2" ] } | ||
单选框 ※1 | RADIO_BUTTON |
"<字段代码>": { "type": "RADIO_BUTTON", "value": "选项3" } |
"<字段代码>": { "value": "选项3" }・指定空字符时,将自动设置初始值。 | ||
下拉菜单 ※1 | DROP_DOWN |
"<字段代码>": { "type": "DROP_DOWN", "value": "选项3" } |
"<字段代码>": { "value": "选择3" } | ||
多选 ※1 | MULTI_SELECT |
"<字段代码>": { "type": "MULTI_SELECT", "value": [ "选项1", "选项2" ] } |
"<字段代码>": { "value": [ "选项1", "选项2" ] } | ||
附件 | FILE |
"<字段代码>": { "type": "FILE", "value": [ { "contentType": "text/plain", "fileKey":"201202061155587E339F9067544F1A92C743460E3D12B3297", "name": "17to20_VerupLog (1).txt", "size": "23175" }, { "contentType": "text/plain", "fileKey": "201202061155583C763E30196F419E83E91D2E4A03746C273", "name": "17to20_VerupLog.txt", "size": "23175" } ] } |
"<字段代码>": { "value": [ { "fileKey":"201202061155587E339F9067544F1A92C743460E3D12B3297", }, { "fileKey": "201202061155583C763E30196F419E83E91D2E4A03746C273", } ] }
| ||
链接 | LINK |
"<字段代码>": { "type": "LINK", "value": "https://www.cybozu.cn/" } |
"<字段代码>": { "value": "https://www.cybozu.cn/" } | ||
日期 ※2 | DATE |
"<字段代码>": { "type": "DATE", "value": "2012-01-11" } |
"<字段代码>": { "value": "2012-01-11" } | ||
时间 ※2 | TIME |
"<字段代码>": { "type": "TIME", "value": "11:30" } |
"<字段代码>": { "value": "11:30" } | ||
日期与时间 ※2 | DATETIME |
"<字段代码>": { "type": "DATETIME", "value": "2012-01-11T11:30:00Z" }・【YYYY-MM-DD】和【HH:MM:SS】之间的【T】为固定值。 ・【HH:MM:SS】之后的【Z】为固定值,表示UTC。 ・通过中国时间(CST)指定时,需按照ISO8601的格式指定如下。 2012-01-11T11:30:00+08:00 |
"<字段代码>": { "value": "2012-01-11T11:30:00Z" } ・【YYYY-MM-DD】和【HH:MM:SS】之间的【T】为固定值。 "<字段代码>": { "value": "2012-01-11T11:30:00+08:00" }・需使用【±HH:MM】指定与UTC的时差 | ||
选择用户 | USER_SELECT |
"<字段代码>": { "type": "USER_SELECT", "value": [ { "code": "zhou", "name": "zhou shijie" }, { "code": "chen", "name": "chen fei" } ] } 来宾用户的情况 "<字段代码>": { "type": "USER_SELECT", "value": [ { "code": "guest/zhou@cybozu.cn", "name": "zhou shijie" }, { "code": "guest/chen@cybozu.cn", "name": "chen fei" } ] } |
"<字段代码>": { "value": [ { "code": "zhou" }, { "code": "chen" } ] } | ||
类别 ※3 | CATEGORY |
"类别": { "type": "CATEGORY", "value": [ "category1", "category2" ] } |
| ||
状态 ※3 | STATUS |
"状态": { "type": "STATUS", "value": "未处理" } |
| ||
执行者 ※3 | STATUS_ASSIGNEE |
"执行者": { "type": "STATUS_ASSIGNEE", "value": [ { "code": "zhou", "name": "zhou shijie" } ] } |
| ||
Lookup ※3 | SINGLE_LINE_TEXT 或 NUMBER ※根据作为key的字段的类型不同而不同。 |
"<字段代码>": { "type": "SINGLE_LINE_TEXT", "value": "Code001" }作为key的项目为NUMBER 时 "<字段代码>": { "type": "NUMBER", "value": "10" } |
"<字段代码>": { "value": "Code001" } | ||
表格 | SUBTABLE |
"<字段代码>": { "type": "SUBTABLE", "value": [ { "id": "48290", "value": { "单行文本框_0": { "type": "SINGLE_LINE_TEXT", "value": "范例1" }, "数值_0": { "type": "NUMBER", "value": "1" }, "复选框_0": { "type": "CHECK_BOX", "value": [ "选项1" ] } } }, { "id": "48291", "value": { "单行文本框__0": { "type": "SINGLE_LINE_TEXT", "value": "范例2" }, "数值_0": { "type": "NUMBER", "value": "2" }, "复选框_0": { "type": "CHECK_BOX", "value": [ "选项2" ] } } } ] } |
"<字段代码>": { "value": [ { "id": "48291", "value": { "单行文本框__0": { "value": "范例0" }, "数值_0": { "value": "0" } } }, { "value": { "单行文本框__0": { "value": "范例1" }, "数值_0": { "value": "1" } } }, { "value": { "单行文本框_0": { "value": "范例2" }, "数值_0": { "value": "2" } } } ] }
| ||
| ||
选择组织字段 | ORGANIZATION_SELECT |
"<字段代码>": { "type": "ORGANIZATION_SELECT", "value": [ { "code": "beijing", "name": "开发部" }, { "code": "shanghai", "name": "人事部" } ] } |
"<字段代码>": { "value": [ { "code": "beijing" }, { "code": "shanghai" } ] } | ||
选择组字段 | GROUP_SELECT |
"<字段代码>": { "type": "GROUP_SELECT", "value": [ { "code": "project_manager", "name": "项目负责人" }, { "code": "team_leader", "name": "组长" } ] } |
"<字段代码>": { "value": [ { "code": "project_manager" }, { "code": "team_leader" } ] } | ||
关联记录列表 | REFERENCE_TABLE | 在以下 API 中使用。
|
组合 | GROUP | 在以下 API 中使用。
|
标签 | LABEL | 在以下 API 中使用。
|
空白栏 | SPACER | 在以下 API 中使用。
|
边框 | HR | 在以下 API 中使用。
|
※1 “value”中指定的值是:kintone应用的表单设置里,“项目与顺序”中设置的值。
另外,这些字段中的选项即使已被删除,也可通过API以及CSV来指定。※2 关于日期、时间、日期与时间、创建时间、更新时间字段的格式或时区的处理请参考日期的格式。
※3 以下字段只可获取值,不能添加和更新值。
记录编号
记录ID
版本
计算
类别
状态
执行者
通过Lookup输入值的字段
※4 以下字段可获取和添加值,不能更新值。
创建人
创建时间
更新人
更新时间
※5 取决于key字段的字段类型。
字段的值为空时
获取空字段的值时,字段的值如下所示:
字段类型 | value的值 |
---|---|
| "value": ""
"value": undefined |
| "value": "" |
| "value": null
"value": undefined |
| "value": ""
"value": null
"value": undefined |
|
"value": null
"value": "" |
| "value": [] |
字段的值设置为空时
字段的值设置为空时,字段的值如下所示:
字段类型 | value的值 |
---|---|
| "value": "" 或者 "value": null |
| "value": null |
| "value": [] |
| 无 |
回复(4)
你可以参考 https://cybozudev.kf5.com/hc/kb/article/205369/
filekey 是通过k/v1/file.json这个restapi返回获得的。
谢谢
请问,附件上传时的数据请求的格式那个“filekey”是怎么定义的?
谢谢你的确认,文章已经修改。
应该是通过中国时间(CST)指定时,需按照ISO8601的格式指定如下。
2012-01-11T11:30:00+08:00
>>通过JST指定时,需按照ISO8601的格式指定如下。
>> 2012-01-11T11:30:00+08:00
JST和+8时区对应不上。