レコードの更新（PUT）

サブテーブルの更新をJavascriptで実装している際に気が付きましたが、
サブテーブルの更新部分の記載に誤りがあるように思います。

（誤）

"(テーブルのフィールドコード)": { 
    "value": { 
        "0":{ 
            "value": { 
                "(フィールドコード)": { 
                    "value": (フィールド値) 
                } 
            } 
        } 
    } 
 }

（正）

"(テーブルのフィールドコード)": { 
    "value": [ 
        { 
            "value": {
                "id": "0" 
                "(フィールドコード)": (フィールド値)
            } 
        } 
    ] 
 }

テーブルのフィールドコードのvalueに対応するものはオブジェクトではなく配列かと思います。

Hiroyuki Nakamuraさん

cybozu.com developer network事務局です。
リクエストボディのサブテーブルの記載内容を修正致しました。
ご指摘いただきありがとうございました。

テーブルのデータ更新で質問です。

「•リクエストのJSONデータに記述しないテーブル内のフィールド値は削除されます。」

とありますが、複数あるテーブル行のうち、１行だけ書き換えたて、ほかのテーブル行は残したい場合、

他のテーブル行は「テーブル行の『id』」だけを記入しておけば、現在のkintoneでは消えないようなのですが、

これは将来のバージョンアップも含めて消えることはないのでしょうか？

よろしくお願いいたします。

吉村啓治郎さん

ご質問いただきありがとうございます。
cybozu developer network運営事務局です。

複数あるテーブル行のうち1行だけ書き換えたい場合は、
吉村さんのおっしゃる通りテーブルのidを指定することで実現できます。

APIにつきましては、APIを利用して開発されたアプリなどに影響を与えないよう、
原則として機能の追加のみを行います。

ただし、次のような場合は API の仕様を変更することがありますので、その点はご了承ください。

・データ破壊やセキュリティ障害などの原因を除去するなど運用上、仕様の変更が必要な場合
・cybozu及び その各サービスの改修により派生的に変更が必要な場合

なお、API の仕様変更を伴うアップデートがある場合、それが適用される定期アップデートの 4 週間前までに、
変更の詳細を以下のサイトで公開致します。
サイトのお知らせ（http://developers.cybozu.com/ja/category/news/）

▼参考リンク
https://cybozudev.zendesk.com/hc/ja/articles/201793494

いつもお世話になっております。

レコードの一括更新の章に

「必須項目が設定されている場合には、その値をリクエストに含めてください。」

と記載がございますが、こちらは誤りではないでしょうか。

PUTの時は更新する項目のみを指定する認識でおります。

細かい点で恐縮でございますが、ご確認よろしくお願いいたします。

みなとん様

ご指摘をありがとうございます。

当方の環境でも確認し、該当の記述を削除いたしました。

POSTの記述と混同した可能性があり、大変申し訳ございませんでした。

今後ともどうぞよろしくお願いいたします。

お世話になっております。

以下ご確認いただけるでしょうか。

PUTのupdateKeyは日付は使えないのでしょうか。マニュアルには指定する値にObjectとありますが、下記のエラーが出ます。

{
"code": "GAIA_IN06",
"id": "1505999166-127152590",
"message": "レコードの更新に失敗しました。「updateKey」に指定したフィールド（code: DeliverDate)が不正です。「updateKey」には、文字列（1行）フィールドか数値フィールドのみ指定できます。また、フィールドの設定で、値の重複を禁止する必要があります。"
}

よろしくお願いします。

hana 様

ご連絡をありがとうございます。cybozu Development teamでございます。

仕様を確認したところ、2016年5月版より、updateKeyに指定できるフィールドは重複を禁止が設定された文字列(1行)と数値のみとなっており、日付フィールドについては遅くともそのタイミングから対象外となっております。

ドキュメントに記載がなかったため、リクエストパラメーター欄の説明欄に追記させていただきました。記載がなかった点について、申し訳ございませんでした。

どうぞよろしくお願いいたします。

お世話になっております。Javascript始めたてです。

上記の「レコードの更新（1件）」XMLHttpRequest

のコードを利用して処理をしているのですが、

code:"CB_VA01"
errors:Object
id:"vENH5GSOKnZozs2DsrK8"
message:"入力内容が正しくありません。

のエラーが出て正しく動作しません。

恐らくbody部分の必須項目の記入が抜けているのかもしれませんが、原因がわかりません。

実際のコードになります。

var body = {
　"app": 85,　(更新先アプリID)
　"id": 30,　　(更新先レコードID)
　"record": {
　　"last_lead_contents": {　(更新先フィールド)
　　　"value": "ABC"
　　}
　},
　// CSRF TOKEN: kintone上からAPI(POST, PUT, DELETE)を実行する場合に設定する必要あり
　"__REQUEST_TOKEN__": kintone.getRequestToken()
};

更新先フィールドはすべて記述すべきなのでしょうか。

すみません。自己解決しました。ご迷惑をお掛けしました。

いつもお世話になっております。

外部システムと連携する際に、上記の「リクエストボディの構造（重複禁止のフィールドコードと値を指定する）」を参考にし、
レコードの更新をするJSONを書いているのですが、試してもkintoneのレコードの更新がされず、レコードの新規追加がされてしまいます。
＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
【実装しているJSON】

{
　"app": (アプリのID),
　"updateKey": {
　　"field": "(重複禁止のフィールドコード)",
　　"value": "(値)"
　},
　"record": {
　　"(フィールドコード)": {
　　"value": {{外部システムトークン}}
　　}
　}
}
＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
kintone側では、updateKeyに指定するフィールドコードは、数値型で値の重複を禁止にし、
紐づける外部システムと同じ値を入れ混んでおります。

なぜ、更新ではなく新規追加になってしまうのか原因がわかりません。
更新する際は上記の設定以外に何か必要となるのでしょうか。

ご教授頂けますと幸いです。
何卒、よろしくお願い致します。

佐々木 様

ご質問ありがとうございます。
cybozu Development teamでございます。

JSONは特に問題がなさそうですね。
updateKeyのvalueに指定した値は、kintoneに存在しているものでしょうか？
存在しないvalueを指定すると新規登録されます。

"updateKey": {
　　"field": "(重複禁止のフィールドコード)",
　　"value": "(値)"

ご確認お願いします。

ご回答いただき、有難うございます。

JSONは問題ないとのこと、安心しました。

ご教授頂いた通り、updateKeyのvalueはkintoneに入れているのですが、

やはり新規レコードが追加されてしまいます。

もう一度よく設定を見直したてみたいと思います。

ありがとうございます。

いつもお世話になっております。

updateKeyに関しまして、重複禁止のフィールドコードを設けているのですが、

値を指定しないで、変数のような形でそれぞれの値によって対象のレコードの情報を更新したく思っております。

そのようなことは可能なのでしょうか。

初歩的な質問で申し訳ございません。

何卒よろしくお願い致します。

佐々木 様

お世話になっております。cybozu developer network事務局でございます。

updateKeyのvalueに変数を使いたいということでしたら、下記のような形で記載が可能です。

var keyValue = "CODE123";
var body = {
    "app": kintone.app.getId(),
    "records": [
        {
            "updateKey": {
                "field": "string_code",
                "value": keyValue
        },
            "record": {
                "文字列__1行": {
                    "value": "ABC"
                }
            }
        }
    ]
};

恐れ入りますが、こちらは記事のフィードバック欄です。
APIの使い方等の技術的なご質問につきましては、コミュニティをご活用いただけますと幸いです。

お世話になっております。

PUTリクエストで更新したいものだけをrecordにいれリクエストを投げて更新されたことを確認したのですが、

ラジオボタンがデフォルト値で上書きされるようでした。

こちらラジオボタンは変更点がないことからrecordに含めず実行したのですが、リクエストパラメータに入れなくても空だと判断されデフォルト値で上書きされるのでしょうか？

注意事項やラジオボタン詳細を調べても分からずで教えて頂けると助かりますmm

あだち 様

cybozu developer network運営事務局です。

基本的には、指定していないフィールドに対してはPUTリクエストでは書き換えません。

しかしながら、ラジオボタンでは下記の手順により指定していなくてもデフォルト値とされるケースはあります。

1. 既存のアプリに対し、設定からラジオボタンのフォームを追加する
2. 既存のレコードにおいてはこのとき、1で追加したラジオボタンには値が入っていない状態となる
3. PUTリクエストや画面上から既存のレコードを書き換える
4. 3によってラジオボタンに自動的に値が入る

ラジオボタンは選択項目の内どれかが選ばれる仕様のためこのようになっております。
他にも同様に、計算フィールドなど、保存する状況によっては指定していないフィールドが一部書き換えられることがあります。

回答ありがとうございます。

再度質問で申し訳ないです。
サブテーブル内のラジオボタンのみデフォルト値で上書きされるような動きをこちらで確認しております。

【質問】サブテーブルの一部だけ書き換える際にラジオボタンのパラメータは送っていないのですが、サブテーブル仕様で全部更新される動きをし、送っていないので空判定でデフォルト値になるみたいな動きをしますでしょうか？

サブテーブル特有の何かなのか知りたいです。

よろしくお願いいたしますmm

あだち 様

cybozu developer network運営事務局です。

> 【質問】サブテーブルの一部だけ書き換える際にラジオボタンのパラメータは送っていないのですが、サブテーブル仕様で全部更新される動きをし、送っていないので空判定でデフォルト値になるみたいな動きをしますでしょうか？

パラメータの指定の内容によっては起こり得うるかと思います。

テーブルに対しレコード更新APIを使う際、各行のidを指定しなければ新しいデータと見做しますので、その際にデフォルト値が反映されてしまったものだと考えられます。

レコード更新におけるテーブル操作のテクニックで説明があるように、テーブルに対しレコード更新APIを利用する際には、各行のidを指定することで、任意の部分のみ変更することは可能ですので、一度お試しください。

なるほど、idを指定していなかったせいでdeleteinsertしているという状態ということですね。
現状理解できました。ありがとうございます。

お世話になっております。

一覧画面で、2件目までの更新例を展示して頂き、ありがとうございます。

n件がある複数件の一括更新は、for の回すloop言語で、更新可能でしょうか。

ou 様

お世話になっております。cybozu developer network 運営でございます。

はい、一括更新の上限である100件以上を一括更新をしたい場合は、リクエストをわけて繰り返していただくイメージです。

REST APIの制限事項についてはこちらを御覧ください。
https://developer.cybozu.io/hc/ja/articles/201941754#step12

また、恐れ入りますが、こちらのコメント欄は記事内容のフィードバック目的となっているため、
試してみてわからない場合などの技術的なご質問があればcybozu developer コミュニティをご活用ください。

よろしくお願い致します。