関連レコード一覧フィールドと仲良くなる #JavaScript

関連レコード一覧フィールドのデータがあるところ

関連レコード一覧フィールドに表示されているデータがどこにあるか知ってますか？
試しに関連レコード一覧フィールドを設定しているアプリに以下のサンプルコードを適用してみてください。

JaavaScript ファイルの適用方法については、kintone ヘルプ > JavaScriptやCSSでアプリをカスタマイズするを参考にしてください。

sample_1.js

(function() {
  'use strict';
  kintone.events.on('app.record.detail.show', function(event) {
    console.log(event);
    return event;
  });
})();

ブラウザの開発者ツールなどで中身にどんなデータが入っているか見てみる

普段使用しているブラウザに開発者ツールがあるか確認してみてください。
わたしは Google Chrome を使用していますので、Chrome の画面で説明していきます。

cybozu developer network にもデバッグ方法について紹介されていますので、参考にしてみるといいかと思います。
参考: cybozu developer network > 動かない？そんな時はデバッグをしてみよう！入門編

開発者ツールの Source タブを開きます。
kintone アプリに適用した sample_1.js を選択します。
ブレイクポイントを使って event オブジェクトの中身を確認します。

どうでしょうか？
このアプリに設置している関連レコード一覧フィールドは「案件詳細」ですが、取得した event オブジェクトの中にデータは見つかりましたか？

だから kintone REST API を使う必要がある

別のアプリのレコードを取得するためにはレコードの取得（GET）の API を実行すれば大丈夫です。
sample_1.js にレコードの取得 API を書き加えたかんたんなサンプルコードを書いてみます。

sample_2.js

(function() {
  'use strict';
  kintone.events.on('app.record.detail.show', function(event) {
    var param = {
      app: 12,
      id: 17
    };
    kintone.api(kintone.api.url('/k/v1/record.json', true), 'GET', param, function(resp) {
      console.log(resp);
    }, function(error) {
      console.log(error);
    });
  });
})();

開発者ツールで event オブジェクトの中身を確認したのと同じようにブレイクポイントを使って、resp の中に関連レコード一覧フィールドのデータが取得できているかどうか確認できます。

kintone REST API は便利ですが、使う上で気をつけておきたいことももちろんあります。
使用頻度が高かったり、使う人がたくさんいるアプリでは API の実行回数が増えたりしてしまいます。そのため、kintone 自体に負荷がかかる原因にもなる可能性があります。
たとえば、本記事で紹介したかんたんなサンプルコード sample_2.js だと、レコード詳細画面を開く度に kintone REST API が実行されてしまいます。
API の実行回数をむやみに増やさないためには以下の方法などが考えられます。

レコード詳細画面が表示されたときのイベントで

ボタンを設置して、ボタンが押されたときだけ REST API を実行する

kintone のアプリにボタンを設置する方法については、「はじめよう kintone API > 第3回レコード詳細にもボタンを設置しよう！」が参考になります。
少しずつ kintone カスタマイズのイメージが湧いてきたでしょうか？

でも kintone REST API は少しハードルが高い…

そんな kintone カスタマイズをはじめたばかりの方にはサイボウズが提供している以下のサイトや勉強会がおすすめです。

cybozu developer network のチュートリアル
ステップで学ぶ kintone カスタマイズ
- 「ステップで学ぶ kintone カスタマイズ」を受講した人向けに imoniCamp（いもキャン）もあるみたいです :D

今年も終わりに近づいてきました。
冬休みはサイボウズが提供しているコンテンツをうまく活用して kintone カスタマイズを学んでいきましょう！
わたしもより良いカスタマイズができるようにがんばります

関連レコード一覧フィールドと仲良くなる

関連レコード一覧フィールド、使ってますか？

関連レコード一覧フィールドのデータがあるところ

ブラウザの開発者ツールなどで中身にどんなデータが入っているか見てみる

関連レコード一覧フィールドのデータはどこに

だから kintone REST API を使う必要がある

でも kintone REST API は少しハードルが高い…