【kintone連携②】レコードを登録する – Unifinity Creative Lounge

kintoneと連携したモバイルアプリをUnifinityで作成する方法について、ご紹介いたします。

今回は、kintoneのREST APIを利用して、kintoneにレコードを登録する方法をご紹介します。
前回の記事で紹介したユーザー認証は必要となりますので、適宜ご確認ください。

解説で使用しているkintoneのアプリ・Unifinityのサンプルプロジェクトを以下よりダウンロードすることができます。ぜひご活用ください。
【kintone】レコード登録アプリ
【Unifinity】kintoneレコード登録アプリ

kintoneに、レコードを登録するモバイルアプリを作成します。

今回は、下記の項目を入力するアプリを用意し、日時・文字列・数値・ラジオボタン・チェックボックス・ドロップダウンをモバイルアプリから登録します。

他によく使われる添付ファイル・ルックアップ・テーブル・ユーザー選択は別の記事にてご紹介します。

連携するためには、kintoneのサブドメイン名・アプリID・各フィールドのフィールドコードが必要となります。
・サブドメイン名・アプリIDは、アプリ接続時のURLの以下の部分から確認できます。

・各フィールドのフィールドコードは、アプリの設定画面から確認できます。

kintoneのフィールド毎に、画面作成・処理作成を説明していきます。
（今回はDBに入力データを保存していませんが、保存することも可能です）

※　基本的なUnifinityの操作は、こちらのチュートリアル動画をご覧ください。

前回の記事で紹介したユーザー認証をアプリ内にご準備ください。

また、kintoneの設定で確認したサブドメイン名を、プロパティのグローバル変数に設定します。

①　日時を入力するテキストボックスを配置します。
また、テキストボックスについては、オブジェクトの動作設定タブの中にある入力内容を「日付・時刻」に設定してください。

②　入力された情報を、kintoneに送信するためのボタンを設置します。

画面作成は、一旦、これで完了です（2.の処理作成後、更新する箇所があります）。

画面で作成したボタンを押下した際の動作を作成します。
それぞれの項目ごとに、一つ一つの処理を解説していきます。

①　サブドメイン名の呼び出し

#2	「変数/グローバル変数取得」を使って、グローバル変数に設定したkintoneのサブドメインを読み込みます。

②　ユーザー認証情報の呼び出し

#4	「データベース/取得」を使い、DBに記憶された「ユーザー認証情報（X-Cybozu-Authorization:●●●）」を読み込みます。（0. 準備で記載したユーザー認証をアプリ内にご準備いただき、そちらのDBを指定してください）

③　kintoneに送信するためのフォーマットへ、データを整形

kintoneにデータを登録するにあたっては、kintone側が定めるフォーマット（今回はこちら）にデータを整形することが必要です。
以下のようなフォーマットへの整形が必要となり、その方法を以下でご紹介します。

#6	「コントロール/内容取得」を使って、画面に入力された内容を選択します。
#7	「文字列関数/フォーマット」を使って、kintoneに日時を登録するためのフォーマット”YYYY-MM-DDThh:mm:ss+09:00”に、#6の内容を変換します。これが"フィールド値"となります。 kintoneに登録するためのフォーマットの一覧はこちらをご覧ください。
#8	「ディクショナリー/作成」を使用して、整形していきます。 "value": "(フィールド値)"というフォーマットを作成するために、キーにvalueを入力し、値に#7の内容を選択してください。
#9	次に、"(フィールドコード)": {#8}というフォーマットを作成します。 kintoneの設定で確認した”フィールドコード"をキーに入力し、値に#8の内容を選択してください。
#10	最後に、{"app": "(アプリのID)","record": {#9}}というフォーマットを作成します。キーにappを入力し、値にアプリIDの内容を入力し、その後、要素追加を押下いただき、キーにrecord、値に#9を入力してください。
#11	最後に、整形した要素をJSONフォーマットに加工します。「ディクショナリー/JSON書出」を使い、#10の内容を選択してください。

④　kintoneへのデータ送信

kintoneにデータを登録するにあたっては、kintone側が定めるURI（今回はこちら）にデータを送信することが必要です。

#13	「文字列関数/連結」を使い、kintoneで決められているRESTAPIのURI（https://(サブドメイン名).cybozu.com/k/v1/record.json）を生成します。今回は、サブドメイン名を呼び出した#2の内容と「/k/v1/record.json」とを連結しています。
#14	「ネットワーク/HTTPリクエスト」を使い、kintoneにデータを送信します。以下のように、各項目を設定してください。

あとは画面と処理を紐づけていただいて完了です。

ここまでが、kintoneにレコードを登録する上での基本的な作成方法となります。

その他のフィールドを更新する場合の処理については以下となります。
（添付ファイル・ルックアップ・テーブル・ユーザー選択は別の記事にてご紹介します。）

文字列（一行）と数値の登録は、ほぼ同様のため、まとめて記載しております。

①　文字列・数値を入力するテキストボックスを配置します。
また、文字列についてはオブジェクトの動作設定タブの中にある入力内容を「全て」に、数値についてはオブジェクトの動作設定タブの中にある入力内容を「数値」＆「ポップアップ入力」にチェックをいれて設定してください。

②　入力された情報を、kintoneに送信するためのボタンを設置します。

画面作成は、一旦、これで完了です（2.の処理作成後、更新する箇所があります）。