Claris Connect をいろいろと触っていた中で扱った内容のうち、比較的需要のありそうな Google SpreadSheet からのデータの取得について、いくつかの注意点を押さえながら簡単にまとめます。

大まかな流れ

1. Claris Connect で webhook URL を作成
2. GAS で SpreadSheet のデータを JSON 形式にして UrlFetchApp.fetch で Claris Connect に渡す
3. 新規レコードを作成して受け取った JSON から適切に各種フィールドに割り当てる
4. 日付に関してはスクリプトに渡して GetAsDate で日付形式にして入れる

webhook URL の発行

好きなプロジェクトから新しく Flow を作成します。　今回は本の著者名とタイトル、読んだ日についてのリストを作成したい状況だとします。名前もそれっぽく適当に。

トリガーは webhooks 選択して、

既存のを使いまわしたいならそれを選択して、新規に作りたい場合は Create a new webhook を選択して名前を決めます。

発行される URL はおそらく https://[***].apps.connect.claris.com/api/webhook/v1/[webhook のなまえ]/catch の形式のはずです。この URL を GAS で使用します。

GAS に移る前にフローの序盤、新規レコード作成のところまで作っておきます。これはなんでかと言うと、一度「慣らし運転」的に webhook で JSON を渡すことで Claris Connect 側に各要素を認識させる必要があるからです。

今回は FileMaker Server 上のデータベースに著者名などを渡すことを目的として、 Claris FileMaker Server > Create record と進み、データベースを選択します（今回は一度接続したものを "for test" という名前にしました）。

対象となるレイアウトを選択すると、そのレイアウト上にあるフィールドが表示されます。
そのレイアウト上にあるフィールドが表示されるのですが、逆に言えば そのレイアウトの元になっているテーブルにあるフィールドでもレイアウト上に表示されていなければここには表示されません。

今回テーブルには 5 つのフィールドがありますが、レイアウト上に表示されていない id と created_at は Claris Connect の Create record では入力できません。（もちろんスクリプトにスクリプト引数として渡してフィールドを設定する方法は可能です）

さて、この状態で一度 save しておきます。次にスプレッドシートと GAS を用意します。

スプレッドシートと GAS でデータを Claris Connect に送信

適当なスプレッドシートを用意します。
今回は本の著者名、タイトル、読んだ日のリストにしてみました。

GAS は以下の通り、最終行の 3 つ情報を JSON 形式に整形して webhook URL に JSON を options としてくっつけて渡します。
今回のメインの内容は GAS の紹介ではないので、トリガ設定などは特にしていません。必要に応じて適宜使ってください。

function sendJSONtoCC(e){

  const mySheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('シート1');

  // 最終行、列の取得
  const lastRow = mySheet.getLastRow();
  const lastColumn = mySheet.getLastColumn();

  // 最終行を JSON にする
  const values = mySheet.getRange(lastRow, 1, 1, lastColumn).getValues();
  const sendJSON = {
    "author" : values[0][0],
    "tiitle" : values[0][1],
    "read_date" : values[0][2],
  };
  const options = {
    "method" : "POST",
    "contentType" : "application/json",
    "payload" : JSON.stringify(sendJSON)
  };

  // Claris Conect へ転送
  const url = 'https://[******].apps.connect.claris.com/api/webhook/v1/book_list/catch';
  const response = UrlFetchApp.fetch(url, options);
}

URL は先ほど発行した webhook のものを使ってください。

Claris Connect で JSON の要素を扱う

この状態で GAS を一度実行します。現状では Claris Connect 側ではフィールドの内容を設定していないので「空」のレコードになります。
ですが、これを一度通すことで、Claris Connect 側で webhook で送信している JSON の要素の解析をしてくれて、JSON の要素を Claris Connect 上で扱えるようになります。

1 つ目のステップである webhook トリガーで取得した JSON の body 中に author, title, read_date がありますね。値は先ほど実行した GAS で渡した内容が反映されていますが、もちろん実行ごとに送信した内容が入ります。サンプルとして参照しましょう。

Create record の内容を入れていくのですが、ここでは著者名を body.author, タイトルを body.title とだけしておきます。

これはなんでかと言うと、なんと body.read_date（今回の値は 2021/07/10）を date に入れると、日付フィールドの validation で怒られてしまうからです。

日付の処理

Claris Connect 上には日付に関して format するアクションが用意されています。
アクションの Utilities から Dates > format を選択すると、日付の変数をプルダウンから用意されている形式に変換してくれます。

ですが、これを噛ませてみても、Create record で日付型じゃないよと言われてしまいます。困ったちゃんです。Dates の format で返ってくるのが string となっているので、そのせいなのでしょうか？

兎にも角にもこのままでは進まないので、日付の入力に関してはスクリプト引数として渡してスクリプト側で入力することにする必要があります。

ということで、データベース側で簡単に日付を受け取ってフィールドに入れるスクリプトを用意します。
JSON でテキストを渡して、 GetAsDate で日付として扱うようにします。

Claris Connect 側では、対処のレイアウトと先ほど作ったスクリプトを選択します。
Script Parameter に "Only strings are supported" とありますが、ここに JSON 形式で渡したい値を設定します。ただし、この中での改行は許されていないため、今回は渡す値が 1 つだけなので比較的すっきりしていますが、複数ある場合はちょっと見づらいです。がんばりましょう。（あと今回でいうところの body.read_date を囲む "" を忘れがち（個人の感想））

動作確認

これで準備完了です。
Claris Connect のフローとしては webhook トリガ、著者名とタイトルを入れて新規レコードを作成、日付をスクリプトで入力、の 3 ステップになります。

先ほどのスプレッドシートに試しに 1 行追加してから GAS を動かしてみると……

良さそうですね！

また、Claris Connect の History からログが見られます。これまで見てきた日付の validation error もここから確認したものでした。

まとめ

Claris Connect を用いて Google SpreadSheet から GAS を使ってレコードを作成する流れについて解説しました。
今回重要なポイントとしては、日付に関しては JSON で渡された値をそのまま入れると validation error を出してくるところで、実は（案の定？）タイムスタンプに関しても同様の現象が起きます。
日付とタイムスタンプだけ別途スクリプトで渡すのは結構めんどくさいので改善してくれないかなという気持ちはありますが、一応今回紹介したスクリプト側でどうにかしてもらう方法で解決ができます。

先日 Claris Connect から実行するスクリプトでは他ファイルを参照できないという記事も書きましたが、いろいろな外部サービスのアクションが増えつつある Claris Connect ですが、もっとホームといいますか FileMaker そのものに対する使いやすさもちゃんと整備してくれると嬉しいなぁと思います。