Claris ConnectにおいてYYYY-MM-DD形式で前月の日付を取得する

こんにちは、エミックの松尾です。前回の記事では、Claris Connectで毎月1日にフローを自動実行してkintoneのアプリにレコードを追加する方法について解説しました。今回の記事では、Claris Connectにおいてスケジュールユーティリティと日付ユーティリティを組み合わせてYYYY-MM-DD形式で前月の日付を取得する方法について記しています。

Claris Connectでフローを作成する方法について

今回は、前回の記事で作成した、毎月1日にkintoneのアプリにレコードを追加するフローを編集するところから始めます。Claris Connectでフローを作成する方法や定期的にkintone REST APIを実行するスケジュールを設定する方法の詳細については前回の記事を参照してください。

Claris Connectにログインして既存のフローを編集する

Claris Connectですでに作成したフローの一覧を確認するには、FileMaker IDでClaris Connectにログインしてから、編集しようとしているフローが含まれるプロジェクトをクリックします。

プロジェクト画面内にある編集対象のフロー名（前回の例では「kintone」）をクリックすると、フローの編集画面に移動します。

日付ユーティリティで前月を取得する

前回の記事では、「交通費（2020年2月）」という値ではなく、単に「交通費」という固定の文字列がkintoneのレコードに追加されるようにしていました。

Claris Connectにおいて、前月をYYYY年M月（例：「2020年2月」）という形式で取得するには、日付ユーティリティとテキストユーティリティを組み合わせて使用する必要があるようです（2020年3月現在）。今回の記事ではまずYYYY-MM-DDという形式の文字列（例：「2020-02-29」）を取得することを目標とします。

日付ユーティリティに用意されているアクションを追加するには、フローの1番目のステップにあるトリガ右側の［+］が表示されている領域に移動してから［Action］をクリックします。

次に［Dates utility］をクリックします。

［Add date］が選ばれている状況のまま、［Continue >］をクリックします。

［Date］欄の右にある［+］マークを含むボタンをクリックします。

［1. Schedules］をクリックします。

［lastRunAt］をクリックします。

白い吹き出し以外の場所をどこかクリックしてから、［Hours］欄に「-15」と入力します。スケジュールユーティリティで取得できる最終実行日時（lastRunAt）は協定世界時で9時間前であり、毎月1日に処理を実行する前提であれば「-15」と入力することで毎月1日の24時間前、すなわち前月の末日を取得できます。

後でスムーズに設定を進められるように［Review and Test］をクリックします。

［Test Action］をクリックします。

テスト結果が表示されます。escキーを押すもしくは［×］をクリックして、テスト結果が表示されている領域を閉じます。

［Edit Configuration］をクリックします。

［Save］をクリックして設定を保存します。

日付をYYYY-MM-DD形式の文字列として取得する

日付をYYYY-MM-DD形式の文字列として取得するためのアクションを追加します。［Add date］アクションの右にある［+］が表示されている領域に移動して［Action］をクリックします。

次に［Dates utility］をクリックします。

［Format date］をクリックしてチェックした後、［Continue >］をクリックします。

［Date］欄の右にある［+］マークを含むボタンをクリックします。

［2. Dates utility］をクリックします。

［date］をクリックします。

白い吹き出し以外の場所をどこかクリックしてから、［Format］欄で［YYYY-MM-DD (2017-01-22)］を選びます。

［Review and Test］をクリックした後、［Test Action］をクリックするとテスト結果が表示されます。

escキーを押すもしくは［×］をクリックして、テスト結果が表示されている領域を閉じます。そして、［Edit Configuration］をクリックしてから、［Save］をクリックします。

HTTPリクエストを送信するアクションの設定を調整する

すでに設定済みである、HTTPリクエストを送信するアクションの設定を調整するために［HTTP POST request］をクリックします。

［Data］欄の値を調整し、「交通費」の後ろをクリックして「（）」を入力した後、入力した「（」と「）」の間をクリックしてカーソルを移動します。そして、［Data］欄の右にある［+］マークを含むボタンをクリックします。

［3. Dates utility］をクリックします。

［date］をクリックします。

白い吹き出し以外の場所をどこかクリックしてから、［Save］をクリックして設定を保存します。これで準備は完了です。

スケジュールユーティリティの実行日時を調整して動作確認

スケジュールユーティリティの実行日時設定を調整して動作確認を行います。テストしやすい日時に変更して、［Save］をクリックします。

スケジュールユーティリティで設定した時刻が過ぎたら［History］をクリックしてフローの実行履歴を確認します。［Status］が「Success」と表示されていれば、設定したフローが正常に実行されたことが分かります。

さらに、kintoneでレコードが作成されているか確認しましょう。動作確認を行った日が2020年3月24日の場合には、「交通費（2020-03-23）」というように値が保存されているはずです。

実際にフローを毎月1日午前10時に実行させたい場合には、動作確認をした後に、スケジュールユーティリティで実行日時の調整を忘れないように行ってください。

まとめ

Claris Connectにおいてスケジュールユーティリティと日付ユーティリティを組み合わせてYYYY-MM-DD形式で前月の日付を取得する方法について解説しました。Claris Connectの日付ユーティリティを利用すると、決まった形式で日付の文字列を取得したり、日時に関わる計算を行ったりすることができます。さらに、テキストユーティリティを使うことで文字列を置き換えることもできるのですが、文字列の置換処理については別の機会に解説したいと思います。