フィールド形式

JavaScriptで操作するレコードオブジェクトは、フィールドIDとフィールドの値などのレコードの情報を含むJSON形式のオブジェクトです。

kumanekoアプリの各フィールドには、アプリ内で一意のフィールドIDがあります。 これらのフィールドIDは、APIを介してデータを作成、取得、および更新するときに必要です。

フィールドIDを確認するには、フォーム設定のフィールドにカーソルを合わせ、表示される歯車から設定メニューを開きます。

関連ページ:

フォームの作成

フィールド形式 例 ("field_(n)_"の部分はそれぞれのフィールドIDに置き換えて下さい)
text
  1. "field_(n)_":{
  2. value: "This is kumaneko"
  3. }
textarea
  1. "field_(n)_":{
  2. value: "This is\nkumaneko"
  3. }
number
  1. "field_(n)_":{
  2. value: 100
  3. }
date
  1. "field_(n)_":{
  2. value: "2022-06-15"
  3. }
datetime
  1. "field_(n)_":{
  2. value: "2022-06-15T18:20:00Z"
  3. }

フォーマットはUTC(yyyy-mm-ddThh:mm:ssZ)形式になります。

time
  1. "field_(n)_":{
  2. value: "09:30"
  3. }
radio
  1. "field_(n)_":{
  2. value: "option5"
  3. }
dropdown
  1. "field_(n)_":{
  2. value: "option5"
  3. }
checkbox
  1. "field_(n)_":{
  2. value: [
  3. "option2",
  4. "option3"
  5. ]
  6. }
file
  1. "field_(n)_":{
  2. value: [
  3. {
  4. filekey: "16553623222577001.pdf",
  5. filetype: "application/pdf",
  6. name: "report.pdf"
  7. },
  8. {
  9. filekey: ...,
  10. filetype: ...,
  11. name: ...
  12. }
  13. ]
  14. }

filekeyにはファイルアップロードAPIによって生成されたfilekeyをセットします。

関連ページ:

ファイル操作

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

値は文字列のuserIDです。

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

値は文字列のdepartmentIDです。

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

値は文字列のgroupIDです。

lookup
  1. "field_(n)_":{
  2. search: "Key value",
  3. value: 1
  4. }
search:
コピー元レコードの「参照元フィールド」に指定したフィールドの値になります。
value:
コピー元レコードのレコードIDになります。
postalcode
  1. "field_(n)_":{
  2. value: "1050011"
  3. }
address
  1. "field_(n)_":{
  2. value: "東京都港区芝公園"
  3. }
color
  1. "field_(n)_":{
  2. value: "#ea5532"
  3. }
canvas
  1. "field_(n)_":{
  2. value: "16791856469633001.fpdx"
  3. }

このフィールドは読み取り専用です。

table
  1. "field_(n)_":{
  2. value: [
  3. {
  4. "field_(n1)_":{
  5. value: "This is the text field in the first row of the table"
  6. },
  7. "field_(n2)_":{
  8. value: "2022-06-20"
  9. }
  10. },
  11. {
  12. "field_(n1)_":{
  13. value: "This is the text field in the second row of the table"
  14. },
  15. "field_(n2)_":{
  16. value: "2022-06-25"
  17. }
  18. }
  19. ]
  20. }

テーブルを更新したり、データを追加したりする場合、APIはJSONデータのテーブルの行数で上書きします。

その際に、JSONデータ側のテーブルにないフィールドはテーブルデータ側のフィールドがコピーされます。

id
  1. "__id":{
  2. value: 1
  3. }

このフィールドのフィールドIDは「__id」固定で、読み取り専用です。

autonumber
  1. "__autonumber":{
  2. value: "PD_A_001"
  3. }

このフィールドのフィールドIDは「__autonumber」固定で、読み取り専用です。

creator
  1. "__creator":{
  2. value: ["1"]
  3. }

値は文字列のuserIDです。

このフィールドのフィールドIDは「__creator」固定で、読み取り専用です。

createdtime
  1. "__createdtime":{
  2. value: "2022-09-01T15:07:00Z"
  3. }

フォーマットはUTC(yyyy-mm-ddThh:mm:ssZ)形式になります。

このフィールドのフィールドIDは「__createdtime」固定で、読み取り専用です。

modifier
  1. "__modifier":{
  2. value: ["1"]
  3. }

値は文字列のuserIDです。

このフィールドのフィールドIDは「__modifier」固定で、読み取り専用です。

modifiedtime
  1. "__modifiedtime":{
  2. value: "2022-09-01T15:07:00Z"
  3. }

フォーマットはUTC(yyyy-mm-ddThh:mm:ssZ)形式になります。

このフィールドのフィールドIDは「__modifiedtime」固定で、読み取り専用です。