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 に設定する必要があります。

データ保護を設定した項目: 指定した値は無視し、更新しません。
自動採番項目: 指定した値は無視し、更新しません。
ドロップダウン、チェックボックス、ラジオボタン、選択リスト項目: 指定した値で更新します。選択肢に存在しない値も更新します。
文字列結合、計算項目: 指定した値で更新します。文字列結合処理、計算処理はしません。