kintone APIドキュメント

フィールド形式

目次

フィールドの情報

固定リンクがコピーされました

kintone JavaScript APIやkintone REST APIでアプリのレコード情報を操作する際は、フィールドの形式に合わせて、フィールドの値を取得または設定します。
フィールドを指定するには、次の2つの方法があります。

  • 方法1：フィールド名を指定する。
    次のフィールドでは、フィールド名を指定します。
    • カテゴリー
    • ステータス
    • 作業者
  • 方法2：フィールドコードを指定する。
    方法1に挙げたフィールド以外のフィールドでは、フィールドコードを指定します。
    フィールドコードは、アプリのフォームの設定画面で確認できます。
    フィールドコードの設定手順 (External link)

レコードIDとレコード番号

固定リンクがコピーされました

レコードIDは、レコードに自動的に割り当てられた、他のレコードと重複しない数値です。
APIで特定のレコードを指定する場合には、レコードIDを利用します。

レコード番号は、レコードに自動的に割り当てられた、ほかのレコードと重複しない番号です。
アプリコードを設定しているかどうかで、値の形式が異なります。

  • アプリコードを設定していない場合：レコードIDと同じです。
  • アプリコードを設定している場合：アプリコードとレコードIDの組み合わせです。
    たとえば、アプリコードを「APPCODE」に設定している場合、レコードIDが1のレコードでは、レコード番号は「APPCODE-1」です。

フォームを装飾するフィールド

固定リンクがコピーされました

次のフィールドは、フォームを装飾するフィールドです。
値の取得／登録／更新はできません。

  • ラベル
  • スペース
  • 罫線
  • グループ

フォームの設定情報を取得したり、変更する場合には、次のAPIを利用してください。

関連レコード一覧

固定リンクがコピーされました

関連レコード一覧フィールドに対する、値の取得／登録／更新はできません。

フォームの設定情報を操作するには、次のAPIを利用してください。

数値フィールド

固定リンクがコピーされました

kintone JavaScript APIにおいて数値フィールドで取得または書き換えが可能な値は次のとおりです。

  • 数値
    • 符号には「+」または「-」を使用できます。
    • 小数点記号には「.」を使用できます。
    • 指数表記を使用できます。指数の記号には「e」または「E」を使用できます。
  • 空文字

数字または記号は、半角文字のみ使用できます。

さらに、kintone.app.record.set()またはイベントオブジェクトを使ってフィールドの値を書き換える場合、数値フィールドに次の値を使用できます。

  • undefined null
    これらの値を指定すると、数値フィールドの値が空になります。
  • #INVALID!
    この値を指定すると、数値フィールドの値は書き換えられません。

以上に当てはまらない値は、不正な値として扱われます。

kintone.app.record.set()の詳細は、次のページを参照してください。
レコードに値をセットする

フィールドの形式

固定リンクがコピーされました

値を取得するとき

固定リンクがコピーされました

フィールドコードは、アプリのフィールドコードに置き換えてください。

レコード情報に関するフィールド
フィールドの種類 type valueの例 備考
レコード番号 RECORD_NUMBER アプリコードを設定していない場合
"フィールドコード": {
  "type": "RECORD_NUMBER",
  "value": "1"
}
アプリコードに「APPCODE」を指定したとき
"フィールドコード": {
  "type": "RECORD_NUMBER",
  "value": "APPCODE-1"
}
レコードID __ID__ 
"$id": {
  "type": "__ID__",
  "value": "1"
}
リビジョン __REVISION__ 
"$revision": {
  "type": "__REVISION__",
  "value": "5"
}
作成者 CREATOR 通常のユーザーの場合
"フィールドコード": {
  "type": "CREATOR",
  "value": {
    "code": "sato",
    "name": "Noboru Sato"
  }
}
ゲストユーザーの場合
"フィールドコード": {
  "type": "CREATOR",
  "value": {
    "code": "guest/sato@example.com",
    "name": "Noboru Sato"
  }
}
作成日時 CREATED_TIME 
"フィールドコード": {
  "type": "CREATED_TIME",
  "value": "2012-01-11T11:30:00Z"
}
 フォーマットやタイムゾーンの取り扱いは、次のページを参照してください。
日付のフォーマット
更新者 MODIFIER 通常のユーザーの場合
"フィールドコード": {
  "type": "MODIFIER",
  "value": {
    "code": "sato",
    "name": "Noboru Sato"
  }
}
ゲストユーザーの場合
"フィールドコード": {
  "type": "MODIFIER",
  "value": {
    "code": "guest/sato@example.com",
    "name": "Noboru Sato"
  }
}
更新日時 UPDATED_TIME 
"フィールドコード": {
  "type": "UPDATED_TIME",
  "value": "2012-01-11T11:30:00Z"
}
カスタムフィールド
フィールドの種類 type valueの例 備考
文字列（1行） SINGLE_LINE_TEXT 
"フィールドコード": {
  "type": "SINGLE_LINE_TEXT",
  "value": "テストです。"
}
文字列（複数行） MULTI_LINE_TEXT 
"フィールドコード": {
  "type": "MULTI_LINE_TEXT",
  "value": "テスト\nです。"
}
リッチエディター RICH_TEXT 
"フィールドコード": {
  "type": "RICH_TEXT",
  "value": "<a href=\"http://www.example.com\">サンプル</a>"
}
数値 NUMBER 
"フィールドコード": {
  "type": "NUMBER",
  "value": "123"
}
 kintone JavaScript APIにおける数値フィールドで使用できる値は、次を参照してください。
数値フィールド
計算 CALC 
"フィールドコード": {
  "type": "CALC",
  "value": "123"
}
 表示書式の設定によりvalueの形式は異なります。
  • 数値：「1234」
  • 数値（カンマ区切り）：「1234」
  • 日時：「2012-01-11T11:30:00Z」
  • 日付：「2012-01-11」
  • 時刻：「11:30」
  • 時間（時分）：「49:30」（画面表示上は「49時間30分」）
  • 時間（日時分）：「49:30」（画面表示上は「2日1時間30分」）
チェックボックス CHECK_BOX 
"フィールドコード": {
  "type": "CHECK_BOX",
  "value": [
    "選択肢1",
    "選択肢2"
   ]
}
ラジオボタン RADIO_BUTTON 
"フィールドコード": {
  "type": "RADIO_BUTTON",
  "value": "選択肢3"
}
複数選択 MULTI_SELECT 
"フィールドコード": {
  "type": "MULTI_SELECT",
  "value": [
    "選択肢1",
    "選択肢2"
  ]
}
ドロップダウン DROP_DOWN 
"フィールドコード": {
  "type": "DROP_DOWN",
  "value": "選択肢3"
}
ユーザー選択 USER_SELECT 通常のユーザーの場合
"フィールドコード": {
  "type": "USER_SELECT",
  "value": [
    {
      "code": "sato",
     "name": "Noboru Sato"
    },
   {
      "code": "kato",
     "name": "Misaki Kato"
    }
  ]
}
ゲストユーザーの場合
"フィールドコード": {
  "type": "USER_SELECT",
  "value": [
    {
      "code": "guest/sato@example.com",
      "name": "Noboru Sato"
    },
    {
      "code": "guest/kato@example.com",
      "name": "Misaki Kato"
    }
  ]
}
組織選択 ORGANIZATION_SELECT 
"フィールドコード": {
  "type": "ORGANIZATION_SELECT",
  "value": [
    {
      "code": "kaihatsu",
      "name": "開発部"
    },
    {
      "code": "jinji",
      "name": "人事部"
    }
  ]
}
グループ選択 GROUP_SELECT 
"フィールドコード": {
  "type": "GROUP_SELECT",
  "value": [
    {
      "code": "project_manager",
      "name": "プロジェクトマネージャー"
    },
    {
      "code": "team_leader",
      "name": "チームリーダー"
    }
  ]
}
日付 DATE 
"フィールドコード": {
  "type": "DATE",
  "value": "2012-01-11"
}
 フォーマットやタイムゾーンの取り扱いは、次のページを参照してください。
日付のフォーマット
時刻 TIME 
"フィールドコード": {
  "type": "TIME",
  "value": "11:30"
}
 フォーマットやタイムゾーンの取り扱いは、次のページを参照してください。
日付のフォーマット
日時 DATETIME 
"フィールドコード": {
  "type": "DATETIME",
  "value": "2012-01-11T11:30:00Z"
}
 フォーマットやタイムゾーンの取り扱いは、次のページを参照してください。
日付のフォーマット
リンク LINK 
"フィールドコード": {
  "type": "LINK",
  "value": "http://www.example.com/"
}
添付ファイル 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"
    }
  ]
}
 取得時のレスポンスに含まれるファイルキーは、ファイルダウンロードにのみ利用できます。
ルックアップ SINGLE_LINE_TEXT
NUMBER *1 		キー項目が、SINGLE_LINE_TEXTの場合
"フィールドコード": {
  "type": "SINGLE_LINE_TEXT",
  "value": "Code001"
}
キー項目が、NUMBERの場合
"フィールドコード": {
  "type": "NUMBER",
  "value": "10"
}
テーブル SUBTABLE 
"フィールドコード": {
  "type": "SUBTABLE",
  "value": [
    {
      "id": "48290",
      "value": {
        "文字列__1行__0": {
          "type": "SINGLE_LINE_TEXT",
          "value": "サンプル１"
        },
        "数値_0": {
          "type": "NUMBER",
          "value": "1"
        },
        "チェックボックス_0": {
          "type": "CHECK_BOX",
          "value": ["選択肢1"]
        }
      }
    },
    {
      "id": "48291",
      "value": {
        "文字列__1行__0": {
          "type": "SINGLE_LINE_TEXT",
          "value": "サンプル２"
        },
        "数値_0": {
          "type": "NUMBER",
          "value": "2"
        },
        "チェックボックス_0": {
          "type": "CHECK_BOX",
          "value": ["選択肢2"]
        }
      }
    }
  ]
}
関連レコード一覧 REFERENCE_TABLE
 値の取得はできません。
カテゴリー CATEGORY 
"カテゴリー": {
  "type": "CATEGORY",
  "value": [
    "category1",
    "category2"
  ]
}
ステータス STATUS 
"ステータス": {
  "type": "STATUS",
  "value": "未処理"
}
作業者 STATUS_ASSIGNEE 
"作業者": {
  "type": "STATUS_ASSIGNEE",
  "value": [
    {
      "code": "sato",
      "name": "Noboru Sato"
    }
  ]
}
ラベル LABEL 値の取得はできません。
スペース SPACER 値の取得はできません。
罫線 HR 値の取得はできません。
グループ GROUP 値の取得はできません。

*1 キー項目のフィールドタイプによって異なります。 ^

値を登録、または更新するとき

固定リンクがコピーされました

フィールドコードは、アプリのフィールドコードに置き換えてください。

レコード情報に関するフィールド
フィールドの種類 type valueの例 備考
レコード番号 RECORD_NUMBER なし 値の登録、または更新はできません。
レコードID __ID__ なし 値の登録、または更新はできません。
リビジョン __REVISION__ なし 値の登録、または更新はできません。
作成者 CREATOR 通常のユーザーの場合
"フィールドコード": {
  "value": {
    "code": "sato"
  }
}
ゲストユーザーの場合
"フィールドコード": {
  "value": {
    "code": "guest/sato@example.com"
  }
}
 値の更新はできません。
作成日時 CREATED_TIME 
"フィールドコード": {
  "value": "2012-01-11T11:30:00Z"
}
 未来の日付を指定することはできません。
値の更新はできません。
フォーマットやタイムゾーンの取り扱いは、次のページを参照してください。
日付のフォーマット
更新者 MODIFIER 通常のユーザーの場合
"フィールドコード": {
  "value": {
    "code": "sato"
  }
}
ゲストユーザーの場合
"フィールドコード": {
  "value": {
    "code": "guest/sato@example.com"
  }
}
 値の更新はできません。
更新日時 UPDATED_TIME 
"フィールドコード": {
  "value": "2012-01-11T11:30:00Z"
}
 値の更新はできません。
フォーマットやタイムゾーンの取り扱いは、次のページを参照してください。
日付のフォーマット
カスタムフィールド
フィールドの種類 type valueの例 備考
文字列（1行） SINGLE_LINE_TEXT 
"フィールドコード": {
  "value": "テストです。"
}
文字列（複数行） MULTI_LINE_TEXT 
"フィールドコード": {
  "value": "テスト\nです。"
}
リッチエディター RICH_TEXT 
"フィールドコード": {
  "value": "<a href=\"http://www.example.com\">サンプル</a>"
}
数値 NUMBER 
"フィールドコード": {
  "value": "123"
}
 kintone JavaScript APIにおける数値フィールドで使用できる値は、次を参照してください。
数値フィールド
計算 CALC 
"フィールドコード": {
  "value": "123"
}
 値の登録、または更新はできません。
チェックボックス *1 CHECK_BOX 
"フィールドコード": {
  "value": [
    "選択肢1",
    "選択肢2"
   ]
}
ラジオボタン *1 RADIO_BUTTON 
"フィールドコード": {
  "value": "選択肢3"
}
 空文字を指定した場合、初期値が設定されます。
複数選択 *1 MULTI_SELECT 
"フィールドコード": {
  "value": [
    "選択肢1",
    "選択肢2"
  ]
}
ドロップダウン *1 DROP_DOWN 
"フィールドコード": {
  "value": "選択肢3"
}
ユーザー選択 USER_SELECT 通常のユーザーの場合
"フィールドコード": {
  "value": [
   { "code": "sato" },
   { "code": "kato" }
  ]
}
ゲストユーザーの場合
"フィールドコード": {
  "value": [
    { "code": "guest/sato@example.com" },
    { "code": "guest/kato@example.com" }
  ]
}
組織選択 ORGANIZATION_SELECT 
"フィールドコード": {
  "value": [
    { "code": "kaihatsu" },
    { "code": "jinji" }
  ]
}
グループ選択 GROUP_SELECT 
"フィールドコード": {
  "value": [
    { "code": "project_manager" },
    { "code": "team_leader" }
  ]
}
日付 DATE 
"フィールドコード": {
  "value": "2012-01-11"
}
 フォーマットやタイムゾーンの取り扱いは、次のページを参照してください。
日付のフォーマット
時刻 TIME 
"フィールドコード": {
  "value": "11:30"
}
 フォーマットやタイムゾーンの取り扱いは、次のページを参照してください。
日付のフォーマット
日時 DATETIME 
"フィールドコード": {
  "value": "2012-01-11T11:30:00Z"
}
 フォーマットやタイムゾーンの取り扱いは、次のページを参照してください。
日付のフォーマット
リンク LINK 
"フィールドコード": {
  "value": "http://www.example.com/"
}
添付ファイル FILE 
"フィールドコード": {
  "value": [
    {
      "fileKey":"84a0e9be-c687-4ae6-82be-3b7edab82c21",
    },
    {
      "fileKey": "722258d8-55e7-41ed-8208-adf3bd034e50",
    }
  ]
}
ルックアップ SINGLE_LINE_TEXT
NUMBER *2 
"フィールドコード": {
  "value": "Code001"
}
 登録、または更新する場合には、関連付けるアプリのコピー元のフィールドを重複禁止にしてください。
テーブル SUBTABLE 
"フィールドコード": {
  "value": [
    {
      "id": "48290",
      "value": {
        "文字列__1行__0": {
          "type": "SINGLE_LINE_TEXT",
          "value": "サンプル１"
        },
        "数値_0": {
          "type": "NUMBER",
          "value": "1"
        },
        "チェックボックス_0": {
          "type": "CHECK_BOX",
          "value": ["選択肢1"]
        }
      }
    },
    {
      "id": "48291",
      "value": {
        "文字列__1行__0": {
          "type": "SINGLE_LINE_TEXT",
          "value": "サンプル２"
        },
        "数値_0": {
          "type": "NUMBER",
          "value": "2"
        },
        "チェックボックス_0": {
          "type": "CHECK_BOX",
          "value": ["選択肢2"]
        }
      }
    }
  ]
}
 1つのテーブルに大量の行を追加しないでください。
アプリの構成によっては、負荷がかかり、レコードの表示やREST APIを使った操作など、レコードの処理に影響します。
REST APIやJavaScript APIでテーブルを操作するときの注意事項は、次を参照してください。
テーブルを操作する際の注意事項
関連レコード一覧 REFERENCE_TABLE 値の登録または更新はできません。
カテゴリー CATEGORY 値の登録または更新はできません。
ステータス STATUS 値の登録または更新はできません。
作業者 STATUS_ASSIGNEE 値の登録または更新はできません。
ラベル LABEL 値の登録または更新はできません。
スペース SPACER 値の登録または更新はできません。
罫線 HR 値の登録または更新はできません。
グループ GROUP 値の登録または更新はできません。

*1 valueには、kintoneのアプリのフォーム設定で、「項目と順番」で設定した値を指定してください。
削除した選択肢の項目もAPIで指定できます。 ^

*2 キー項目のフィールドタイプによって異なります。 ^

テーブルを操作する際の注意事項
JavaScript APIによる登録や更新
  • テーブルへの追加、更新時には、既存のすべての行の値を指定してください。
  • 行の並びは、リクエストデータの並び順となります。
  • テーブルへの追加、更新時には、フィールドタイプの指定が必要です。
    詳細は、次のページを参照してください。
    フィールドの値を書き換える
REST APIによる登録や更新
  • テーブルへの追加、更新時には、既存のすべての行の値を指定してください。
  • 行のidを指定すると、指定された行の値を更新します。
  • 行の並びは、リクエストデータの並び順となります。
  • 行の並び替えのみを行う場合、行のidを並べ替えたリクエストデータを用意してください。
行を追加、削除するとき

テーブルの「value」パラメーターの値の配列に行オブジェクトを追加、削除することで、テーブルに行を追加・削除できます。

次のコードは、push()で行を追加する例です。

1

record['テーブル']['value'].push(row);

次のコードは、pop()で行を削除する例です。

1

record['テーブル']['value'].pop();

フィールドの値が空の場合

固定リンクがコピーされました

空のフィールドの値を取得した場合、フィールドのvalueは次のようになります。

フィールドタイプ valueの値
  • 文字列（1行）
  • 文字列（複数行）
  • 数値
  • 日時
  • リンク
  • ルックアップ
 
"value": ""
「レコード追加画面」または「レコード編集画面」でJavaScript APIを使用した場合
"value": undefined
  • リッチエディター
 
"value": ""
  • 日付
  • 時刻
 
"value": null
「レコード追加画面」または「レコード編集画面」でJavaScript APIを使用した場合
"value": undefined
  • ドロップダウン
 
"value": ""
REST APIを使用した場合
"value": null
「レコード追加画面」または「レコード編集画面」でJavaScript APIを使用した場合
"value": undefined
  • ラジオボタン
 REST APIを使用した場合
"value": null
JavaScript APIを使用した場合
"value": ""
  • チェックボックス
  • 複数選択
  • ユーザー選択
  • 組織選択
  • グループ選択
  • 添付ファイル
  • テーブル
  • カテゴリー
  • 作業者
 
"value": []

フィールドの値を空に設定する場合

固定リンクがコピーされました

フィールドに空の値を設定する場合、フィールドのvalueを次のように設定します。

フィールドタイプ valueの値
  • 文字列（1行）
  • 文字列（複数行）
  • リッチエディター
  • ドロップダウン
  • 日時
  • リンク
  • ルックアップ
 
"value": ""
または
"value": null
  • 数値
 次のいずれかの値を指定します。
"value": ""
"value": undefined
"value": null
  • 日付
  • 時刻
 
"value": null
  • チェックボックス
  • 複数選択
  • ユーザー選択
  • 組織選択
  • グループ選択
  • 添付ファイル
  • テーブル
 
"value": []
  • ラジオボタン
  • カテゴリー
  • 作業者
 なし