kintoneでレコード全件について関連レコードの項目を集計して更新する機能を泥臭くカスタマイズする【最終回】

↓前回は、ベタ書き＆for文を使って1件ずつ、3件の更新をしてみました👀✨✨

今回は1件ずつではなく、一括更新できる kintone REST API Clientのメソッドを使って、全件更新するチャレンジ！してみたいと思います。

記号の見方
丸コピペされるのを防ぐために、罠を埋め込んでみました👀
デバッグしたり、参考ページを見て直してから使ってね！

🙄考えるところ
🛠️手を動かすところ
👻コードに罠が埋め込まれているよのマーク

🙄一括更新API？

前回まではupdateRecordメソッドを使ってましたが、
今回は一括更新用のupdateRecordsメソッド(※最後にsがついてる)を使って更新することを考えます。

🙄1件更新と、一括更新のリクエストパラメータの違い

1件ずつの更新と特に異なっているところは、
リクエストパラメータに全レコード分の更新情報を入れなきゃいけないところです。

例えば、レコード番号20のレコードを更新したい時のリクエストパラメータは
↓こんな感じでした。

{
  app: kintone.app.getId(),
  id: 20,
  record: {
    Aプラン小計: {
      value: 123,
    },
}

それが、一括更新となるとこんな感じになります。
record が records になって、更新したいレコードを配列に入れるような形になっています。

{
  app: kintone.app.getId(),
  records: [
    { id: 20, record: { Aプラン小計: { value: 123 } } },
    { id: 19, record: { Aプラン小計: { value: 234 } } },
    { id: 18, record: { Aプラン小計: { value: 456 } } },
  ],
}

となると、
前回ループの中で組み立てたパラメータは1件ずつの更新用。
一括更新となると作り変えないといけません。

🙄1件ずつ更新のアルゴリズム（前回までのアルゴリズム）

前回まではこんなアルゴリズムで更新していました。

下記をレコード番号20, 19, 18の分（3回ループ）
↓
レコード番号で絞り込んだ集計元のレコードを取得（getRecords）
↓
レコード番号ごとに合計費用を集計する
↓
レコード1件更新用リクエストパラメータを作成する
↓
1件更新する（putRecord）
↓
次のループへ

🙄一括更新のアルゴリズム（案）

今回は、まず一括更新用のリクエストパラメータをループで作成して
それからputRecordsで一括更新🙄
となりそうです。
じゃあこんな感じになるかな・・・・

レコード数分ループ（全部で20件なので20回ループかな）
↓
レコード番号で絞り込んだ集計元のレコードを取得（getRecords）
↓
レコード番号ごとに合計費用を集計する
↓
レコード一括更新用リクエストパラメータに更新する内容を追加する
↓
次のループへ
↓
ループ終了

↓
一括更新（putRecords）

🤔むー。気になるところはあるけど・・・・
とりあえず作ってみよっか。

🛠️一括更新のリクエストパラメータを作る準備

では、レコード数分ループしてみたいと思います。

レコード数分ループ（全部で20件なので20回ループかな）
↓
レコード番号で絞り込んだ集計元のレコードを取得（getRecords）
↓
レコード番号ごとに合計費用を集計する

event.records　で今一覧に表示されている分のレコードが取得できるので、
良いか悪いかは置いておいて、ひとまず、event.records のレコード数分ループすることにしましょう。

// 表示されているレコード
const records = event.records; // 今一覧に表示されているレコードたちを取得
for (const r of records) { // 20件分ループかな
  const query =
    '顧客管理レコード番号_関連レコード紐付け用="' +
    r["レコード番号"].value +
    '" and 提案プラン in ("Aプラン")';
  const outputFields = ["合計費用"];
  const params = {
    app: relatedAppId,
    query: query,
    fields: outputFields,
  };
  // 関連レコードの案件を取得する
  const res = await client.record.getRecords(params);
  // 合計金額集計
  const amount = res.records.reduce(
    (preV, p) => preV + parseFloat(p[outputFields[0]].value),
    0
  );

}

これで、一覧に表示される分のAプラン小計がamountに入るはず。
コレを使って、リクエストパラメータを作ろう👀

🛠️一括更新のリクエストパラメータを作って一括更新する

ループの前に最初にparamを準備しておいて、ループ中にrecord1件分ずつの更新用パラメータを入れていこう。

// ループの前にリクエストパラメータ定義
const param = {
  app: kintone.app.getId(),
  records: [],
};

↓ループ内でリクエストパラメータのrecordsに追加

// リクエストパラメータのrecordsに追加する
param.records.push({
  id: r["レコード番号"].value,
  record: { Aプラン小計: { value: amount } },
});

↓作成したparamで一括更新する

const res2 = await client.record.updateRecords(param);

これで、今表示されている一覧分のレコードが表示されるはず💪
※画面のリロードお忘れなく。（前回記事なども参考にしてくださいね）

🙄でも、遅い。ループ内で毎回getRecordsするのは無駄じゃない？

というわけでこれで更新できるのですが、
レコード20件分のループ内で毎回getRecordsを呼ぶのは無駄です。
毎回waitさせられるので処理が遅くなりますし、
まだまだ20件とかだから良いかもだけど、これがレコード500件分のループなんてことになれば激遅アプリになってしまいます。

というわけで、getRecordsをループで毎回するのではなくて、
ループが始まる前に関連レコードを全件呼び出してしまいましょう👀

紐づくレコード番号（顧客管理レコード番号_関連レコード紐付け用）と、合計費用の列だけあるような全レコードを呼び出しましょう。

🛠️👻ループの前に関連レコードで紐付いているアプリのレコードを全件呼び出す

紐付け用のレコード番号と、合計費用だけで良くて、プランAの案件で絞り込むので・・・・
プランAの案件情報をすべて取ってくるパラメータはこんな感じになるかな👀

罠を仕込んでいますが、気づけるかな👀💦💦
罠というか、私が躓いてしまったところですが。
↓こちらのドキュメントと見比べて直してみてね✨✨罠についての質問は受け付けません👀ｷﾘｯ

const query = '提案プラン in ("Aプラン")';
const outputFields = [
  "顧客管理レコード番号_関連レコード紐付け用",
  "合計費用",
];
const params = {
  app: relatedAppId,
  query: query,
  fields: outputFields,
};
// 関連レコード(案件レコード)を取得する（案件：projectなのでpRecordsとしてみた）
const pRecords = await client.record.getAllRecords(params);

ここで、pRecordsの中身がこんな感じだとOK。10件だとBプランの分も取ってきちゃってることと思います。

🙄🛠️👻とってきた案件のレコードをレコード番号毎に集計する

↓前回までの集計はこんな感じで計算していました。

// 合計金額集計
const amount = res.records.reduce(
  (preV, p) => preV + parseFloat(p[outputFields[0]].value),
  0
);

これはreduce()メソッドを使って合計値を計算するという技を使っております。
今回は、pRecordsというレコードの情報（オブジェクト配列）の値を合計したいので
MDNのオブジェクトの配列の値の合計値を出すを参考にコードを組み立てます。

↓MDNのサンプルコード

let initialValue = 0
let sum = [{x: 1}, {x: 2}, {x: 3}].reduce(function (previousValue, currentValue) {
    return previousValue + currentValue.x
}, initialValue)

console.log(sum) // logs 6

[{x: 1}, {x: 2}, {x: 3}]の部分をpRecordsに変更して・・・、
足したいのは合計費用フィールドの値(value)なので

let sum = pRecords.reduce(function (previousValue, currentValue) {
  return previousValue + currentValue["合計費用"].value;
}, initialValue)

しかし、これだと、紐付け用のレコード番号関係なく全部足されちゃうので、条件をつけましょう。
forループfor (const r of records) {～}内で見ているレコードrのレコード番号と、
pRecordsの顧客管理レコード番号_関連レコード紐付け用の値が同じ場合のみ足すようにします。
同じではない場合は前回値previousValueをreturnします。
これでプランAのレコード番号ごとの合計費用が計算できます。

というわけで↓を参考に、変数名を揃えたり、型に気をつけたりして合計値計算頑張ってみてください👀👻

let sum = pRecords.reduce(function (previousValue, currentValue) {
  if (currentValue["顧客管理レコード番号_関連レコード紐付け用"].value === r["レコード番号"].value) {
    return previousValue + currentValue["合計費用"].value;
  }
  return previousValue;
}, initialValue)

🛠️パラメータの完成

あとは、putRecords用のリクエストパラメータにレコード番号と合計費用の情報を追加したらOK。

param.records.push({
  id: r["レコード番号"].value,
  record: { Aプラン小計: { value: amount } },
});

最終的なparamの中身はこんな感じになるかと思います。

コレで上手く更新されることと・・・・思います👀！

🙄さいごに・・・

ちょっと思うところがあって、全コードをあえて載せないようにしたり、機能毎にバラバラに書いたり、
コピペじゃ動かない罠も仕込むという記事にしました。
というわけで、👻アイコンがついているところは試行錯誤して動くようにしてみてくださいね！

それと、下記の部分、「一覧に表示されているレコード」ですので、
全レコードについて集計をしたい場合は変更する必要があります。

event.recordsではない他の方法🙄泥臭く、考えてみてくださいね！

// 表示されているレコード
const records = event.records;
for (const r of records) {