クラウド版製品マニュアル 楽々Webデータベース
ホーム > エクセル業務効率化支援ツール 楽々Webデータベース > マニュアルトップ > 添付資料. API > アプリのAPI: data/update

data/updateOption

アプリのデータを一件更新します。

APIを使用するには、WebAPIオプション が必要です。

POST
http://example.com/RakWDB/webapi/v1/data/update

リクエスト

ヘッダー

content-type
application/x-www-form-urlencoded
もしくは
multipart/form-data

パラメータ

appcode

アプリコードを設定します。

appkey

アプリの認証キーを設定します。

execuserid

APIを実行するユーザーを設定します。
アプリの認証キーに紐づくユーザーがアプリの管理者の場合に使用します。
アプリの認証キーに紐づくユーザーがアプリの管理者でない場合、このパラメータの値は使用しません。

lang

アプリを動作させる言語の言語区分を設定します。

param

更新するデータをJSON形式で指定します。

書式
{
  "プライマリキーの項目ID": {
    "value": ""
  },
  "項目ID": {
    "value": ""
  },
  …他の項目の設定…
}
プライマリーキーの項目ID

更新対象のプライマリーキー項目の項目IDを設定します。
更新対象を特定するため必ず設定してください。

value

プライマリーキーの値を設定します。

項目ID

値が存在する全ての項目の項目IDを設定します。
項目IDが未指定の項目は、値が削除されます。(null値になります。)

value

項目の値を設定します。更新対象ではない項目の値は、事前に「dataset/search」で取得して設定してください。

プライマリキー「1000」のデータを更新する。
{
  "rakwdb_app1234_main_primarykey": {
    "value": "1000"
  },
  "rakwdb_app1234_main_0": {
    "value": "A"
  },
  "rakwdb_app1234_main_1": {
    "value": "1"
  },
}
ファイル項目の項目ID

更新するファイルを設定します。ファイル項目の項目IDを設定した場合、param で設定した同じファイル項目の設定は無視します。

画像項目の項目ID

更新する画像ファイルを設定します。画像項目の項目IDを設定した場合、param で設定した同じ画像項目の設定は無視します。

レスポンス

ヘッダー

content-type
application/json;charset=UTF-8

レスポンス例

更新に成功した場合
{
  "rkwa_status": "OK",
  "rkwa_errorcount": 0,
  "rkwa_errmsg": null,
  "rakwdb_app1234_main_primarykey": {
    "type": "id",
    "value": "1000"
  },
  "rakwdb_app1234_main_0": {
    "type": "text",
    "value": "A"
  },
  "rakwdb_app1234_main_1": {
    "type": "number",
    "value": "1",
    "value_formatted": "1"
  },
  "pms_i_usr": {
    "type": "pms_i_usr",
    "value": {
      "id": "admin",
      "name": "admin"
    }
  },
  "pms_i_ymd": {
    "type": "pms_i_ymd",
    "value": "2021-06-28 17:00:00"
  },
  "pms_u_usr": {
    "type": "pms_u_usr",
    "value": {
      "id": "admin",
      "name": "admin"
    }
  },
  "pms_u_ymd": {
    "type": "pms_u_ymd",
    "value": "2021-06-25 18:00:00"
  }
}

注意事項

表項目が存在するアプリの、表項目のデータは更新できません。

フォームに表示している項目のうち、リクエストパラメータに指定がない項目は空データで更新します。ファイル、画像項目については、更新時は ファイルID を value に設定する必要があります。

データ保護を設定した項目

指定した値は無視し、更新しません。

自動採番項目

指定した値は無視し、更新しません。

ドロップダウン、チェックボックス、ラジオボタン、選択リスト項目

指定した値で更新します。選択肢に存在しない値も更新します。

文字列結合、計算項目

指定した値で更新します。文字列結合処理、計算処理はしません。