第4回レコードの値を取得してみよう(詳細画面編) – cybozu developer network

はじめて kintone をカスタマイズする人が kintone API の基礎知識を学べるよう、チュートリアルの内容を充実させてリニューアルしました。
リニューアル後のチュートリアルは次のページを参照してください。
はじめよう kintone API

（著者：落合雄一）

はじめに

今回からは登録済みレコードを取得して利用してみる事にしましょう！ｶﾞﾝﾊﾞ!!o(･ω･´o)(o｀･ω･)o!!ｶﾞﾝﾊﾞ
ということで、まずは詳細画面(PC用)での使い方からはじめたいと思います。

レコード番号を取得してみよう

まずは簡単に、レコード番号を取得する事からはじめましょう。レコード番号とは、アプリごとに1からの連番で自動的に振り分けられるユニークなIDです。レコード番号は、これからもちょくちょく出てくるので覚えておいてくださいね(^^♪

利用する関数は kintone.app.record.getId()です。
以下は、メニュー右側の空白部分に置いたボタンを押すとアラートを出す簡単なサンプルです。

簡単にできましたね！今回も順調な滑り出しです。＼(*^▽^*)ノ

レコードの値を取得してみよう

次に、レコードの値を取得してみましょう(^^♪

利用する関数は、kintone.app.record.get()です。スマートフォン用には、kintone.mobile.app.record.get()を利用する事になりますので気を付けてください。この関数の戻り値は、値の取得に成功した場合JSON形式、失敗した場合NULLとなります。JSONについてはWeb上に多くの情報がありますので、説明を省きます。

フィールドコードは、アプリの設定を変更＞フォームの編集から取得したいフィールドの設定で確認/変更できます。

ここまで分かればあまり難しい事はないですね(^^)

それでは、実際に利用してみましょう(^^♪

以下は、メニュー右側の空白部分に置いたボタンを押すと、前回利用した「スペースフィールド」に更新日時フィールドから取得した値を表示するサンプルです。

取得したレコードの値は、以下のように、ドット表記法やブラケット表記法で利用できます。

どちらの書き方が良いかは、それぞれに好みやスタイルがある事でしょう。この辺りについては、実際の処理の内容によって適した書き方が出来るようにしておけば、よりkintone JavaScript APIを使いこなせるようになれそうです(^^)

フィールド型とフォーマット

上記のコードで更新日時の取得と表示が出来たと思います。あらためて結果を見てみましょう。

何か気が付きませんか？赤で囲んだ２つの日時の書式が違っていますね(^^;;

フィールド形式と日時のフォーマットを確認してください。このように、Webページ上にHTMLで表示されている書式とAPIから取得した値で書式/フォーマットが異なる場合があります。実際に自分好みのJavaScriptを書いていくときには注意してください。(￣Λ￣)ゞ

kintone.app.record.get()における注意点

実際に皆さんが詳細画面でレコードを取得する処理を書くときには、いちいちボタンを置いてそれをトリガに…なんてまどろっこしい事はあまりしないと思います。ページの表示時に取得する方が実用的ですね(^^♪

しかーし！！ここで重要な注意点があります！！レコードの値を取得するに以下の注意事項が記載されています。

注意事項

kintone.events.on のイベントハンドラ内で kintone.app.record.get および kintone.mobile.app.record.get を実行することはできません。上記のイベントハンドラ内ではレコードデータの取得は引数のeventオブジェクトを、レコードデータの更新はeventオブジェクトのreturnを使用してください。

つまり、下記のようなことはできないということです(>_<)

これはめっちゃ重要なので、忘れないようにしてください！！
ハマって何時間も頭を抱える人がいるみたいなので・・・(￢_￢)

eventオブジェクト

先ほどの注意事項で「・・・・eventオブジェクト( ・◇・)?」と思った方、全然難しくありませんよ(^^)
いつも書いている「event」のことです。

eventオブジェクトについてきちんと理解するため、レコード表示イベントをもう一度確認してみましょう(^^♪
ここにeventオブジェクトのプロパティについての記載がありますね。

eventオブジェクトのプロパティ

プロパティ名	型	説明
appId	数値	アプリID
record	オブジェクト	レコード詳細画面が表示された時のデータを保持したレコードオブジェクト※ ※レコードオブジェクトとは、フィールドコードとフィールドの値などのレコードの情報を含むオブジェクトです。フィールドの値は、フィールドの形式によって異なります。詳細はフィールド形式をご確認ください。
recordId	数値	レコードID
type	文字列	イベントタイプ