Claris FileMaker Pro 19でレコードIDを指定してkintoneのレコードデータを取得する

こんにちは、エミックの松尾です。来週2020年7月18日（土）にオンラインでkintone Café 岐阜 Vol.6が開催される予定になっています。今年の2月に行われたkintone Café 岐阜 Vol.5以来、約5ヶ月ぶりの開催でとても楽しみです。さて、今回の記事では、Claris FileMaker Pro 19でレコードIDを指定してkintoneのレコードデータを1件取得する方法について記しています。

kintone REST APIを使うにはスタンダードコースが必要

kintoneには2つのコースが用意されており、スタンダードコースとライトコースの2種類から選べます。

kintoneには“kintone REST API”と呼ばれるデータ連携用のAPIが用意されていますが、APIはスタンダードコースのみで利用可能です。これから紹介する方法ではkintone REST APIを使っているので、kintoneのスタンダードコースを利用している前提での説明となります。

kintoneでアプリを追加する

今回のサンプルは、2020年7月現在におけるkintoneアプリストアの目安箱アプリを利用する前提でのサンプルになっています。

目安箱アプリは、kintoneアプリストアの画面左上にある［アプリストア検索］欄に「目安箱」と入力して虫眼鏡アイコンのボタンをクリックするとすぐに見つかります。

見つかった「目安箱」をクリックし、今回は［サンプルデータを含める］にチェックしたまま［このアプリを追加］をクリックします。

確認画面で［追加］をクリックすると、アプリが追加されます。

アプリには2件のサンプルデータがすでに入力されているはずです。

（2020年7月11日追記：「アプル」を「アプリ」に変更・修正しました。）

kintoneでAPIトークンを生成する

次に、kintone REST APIの認証に使用するAPIトークンをkintoneで生成します。APIトークンはkintoneアプリの設定画面で生成できます。

目安箱アプリの設定画面において［設定］タブにある［APIトークン］をクリックした後に［生成する］ボタンを押すという手順になりますが、手順の詳細についてはkintone ヘルプをご参照ください。

今回は、生成されたAPIトークンに対して「レコード閲覧」のみ許可するようにします。

設定を保存した後、アプリを更新することを忘れないようにしてください。

Claris FileMaker Proでデータ取得用のスクリプトを作成

kintone側の設定が完了したら、Claris FileMaker Proを使って作業を進めます。今回は前回の記事で作成したカスタム App（目安箱.fmp12）をClaris FileMaker Pro 19がインストールされているコンピューターにコピーしてある前提で解説を進めていきます。

カスタム Appにデータ取得用のスクリプトを追加するために、目安箱.fmp12をClaris FileMaker Pro 19で開いた後、［スクリプト］メニューの［スクリプトワークスペース...］を選びます。

スクリプトワークスペースウインドウ内の左上にある［+］をクリックして、スクリプトを追加します。

後から判別しやすいように、スクリプトの名前を「新規スクリプト」から「レコードデータを取得」に変更します。

［URL から挿入］スクリプトステップでHTTPリクエストを送信

スクリプトの名前を入力した後、Enterキー（Windows）またはreturnキー（macOS）を押すと、スクリプトステップを入力できる状態になります。今回はHTTPリクエストを送信する［URL から挿入］スクリプトステップを使用するので、「URL」と入力します。

［URL から挿入］スクリプトステップが候補の一覧で選択されている状態でEnterキーまたはreturnキーを押すと、当該スクリプトステップが追加されます。

続けて［URL から挿入］スクリプトステップの歯車アイコンをクリックして、オプションの［ターゲット］をチェックします。

［ターゲット］をチェックした後、［ターゲットの指定］ダイアログボックスが表示されます。今回は、［変数］をチェックして、変数の欄に「$response」と入力します。

［OK］を押してダイアログボックスを閉じた後、［URL を指定］の右にある［指定...］をクリックして、kintoneで単一のレコード取得に使うURIを入力します（例：「"https://example.cybozu.com/k/v1/record.json?app=52&id=1"」）。アプリのIDは52ではなく目安箱アプリのアプリIDに、「example」の代わりに実際に使用しているkintoneのサブドメイン名に置き換えてください。

今回は、kintoneの目安箱アプリにおいてレコードIDが1であるレコードのデータを取得するように指定しています。

続けて［SSL 証明書の検証］にチェックをつけます。

［cURL オプションの指定］の右にある［指定...］をクリックして、次の文字列をコピーした後、［計算式の指定］ダイアログボックス内にペーストします。

"--header \"X-Cybozu-API-Token: YOUR_TOKEN\""

「YOUR_TOKEN」という文字列は設定画面で生成したAPIトークンに置き換えてください。

スクリプト実行時にダイアログボックスが複数回表示されないように、今回は［ダイアログあり］オプションの「オン」をクリックして「オフ」に変更しておきます。

1行目にある［URL から挿入］スクリプトステップを選択している状態で、Enterキーまたはreturnキーを押すと、次のスクリプトステップを入力できます。「カスタム」や「ダイアログ」と入力すると、［カスタムダイアログを表示］スクリプトステップが候補として表示されます。

［カスタムダイアログを表示］スクリプトステップが選択されている状態でEnterキーまたはreturnキーを押すと、当該スクリプトステップが追加されます。

［カスタムダイアログを表示］スクリプトステップの歯車アイコンをクリックした後、次の文字列をコピーしてから［メッセージ］にペーストします。

JSONGetElement ( $response; "record.タイトル.value")

［OK］をクリックします。そして、［スクリプト］メニューの［スクリプトの保存］を選ぶと作成したスクリプトを保存できます。

［スクリプト］メニューの［スクリプトの実行］を選び、kintoneの目安箱アプリに登録されているタイトルデータが表示されれば成功です。

まとめ

Claris FileMaker Pro 19でレコードIDを指定してkintoneのレコードデータを1件取得する方法について解説しました。kintoneのスタンダードコースで利用できるkintone REST APIを使えば、Claris FileMaker Proで作成したカスタム Appからkintoneのデータを取得することができます。次回は、kintoneのデータを取得する際にセキュアアクセスのクライアント証明書を利用する方法について解説したいと思います。