スケジュール実行を曜日に合わせたいニーズ
自動化を実践していると平日だけ実行したいとか、決まった曜日にだけクラウドフローを動かしたいというニーズはあると思います。
曜日指定するだけならば、トリガーに設定すればよいですが……
土日だけ指定しても祝祭日や年末年始、お盆休みなどこれだけでは賄えないこともありますね。
もう少し細かく、たとえば1年に1回休日カレンダーを設定しておくだけで、指定したクラウドフローを実行してくれるような仕組みを作ってみようと思います。
この記事では
以下のようなことを実現したい人向けの記事です
・土日だけ、土日以外だけなどの条件でフローを動かしたい
・Excelで記載した特定の日付だけフローを動かしたい
・正月や祝祭日だけフローを動かしたい
それぞれの方法を紹介しています。ぜんぶ盛り込んでもよいですし、必要な方法だけを組み合わせても実用的かと思います。
基本な考え方
クラウドフローには、「スケジュール済みクラウドフロー」というトリガーがあります。いわゆる定期実行です。曜日は実行する時刻を設定できます。
今回は、このトリガーで毎日フローを実行させて、フローの中で今日が何曜日か、Excelで設定した日付条件にマッチするかなどを判定させたうえで動作させるような仕組みにします。
そこで、このように毎日実行させる設定にしました。
日本の日付を変数に設定
まずは、今日が何日なのか日本の日付を取得して「日付」と名前を付けた文字列の変数に格納します。
utcNow()関数では世界標準時刻が取得できます。必要なのは日付だけなので、このまま使ってもよいのですが、午前9時より前に取得すると日本の時刻とは9時間ずれているために前日日付になってしまいます。
そこで、以下の式をつかって日本の日付を取得してください。
convertFromUtc(utcNow(),'Tokyo Standard Time','yyyy-MM-dd')
余談ですが、日付のフォーマットや前日日付を取りたいというような場合については、こちらのブログで紹介しているので参考にしてください。
日曜日にだけ実行
変数「日付」が何曜日なのかは、dayOfWeek関数の値で判断することができます。
dayOfWeek(variables('日付'))
このように、文字列で日付を与えると以下のような整数が返ってきます。したがって、日曜日だけ動かしたければ0に等しい場合に実行させることで「はい」に設定した処理が動作します。
曜日 | INT |
---|---|
日 | 0 |
月 | 1 |
火 | 2 |
水 | 3 |
木 | 4 |
金 | 5 |
土 | 6 |
実行してみると、日曜と判定されたので「はい」に設定した処理Aと処理Bが実行されています。
ということは、土日に動作させたければ、こんな感じにすればよいですね。逆に、土日以外に動作させたければ、「はい」と「いいえ」の中身を入れ替えればOKです。
特定の日付を指定して動作させる
たとえば、会社の創立記念日などカレンダーにはない日付を指定するにはどうしましょう?
適当なSharePointサイトのドキュメントライブラリに以下のようなExcelファイルで休日テーブルを用意しました。
作製したテーブルを「用内に存在する行を一覧表示」アクションをつかって取ってきます。今日の日付は一覧とのマッチをテストするために、表内にあるのと同じ日付をいったん手入力しました。
テスト実行してみると、Excelで入力していた休日日付は数字として表示されています。今日の日付も数字にして比較してやればよさそうです。各行はvalueの中の配列に入っていることを確認しておきます。
Excelのなかの休日日付はこのままでは扱いづらいので、「選択」アクションを使って配列にしてやります。「開始」にはvalueの値を設定します。
@{outputs('表内に存在する行を一覧表示')?['body/value']}
「マップ」にはその中から「休日日付」の値が取れるように以下のように式を設定します。この時「選択」をマップモードに切り替えておくのを忘れずに。
int(item()?['休日日付'])
シリアル値で配列に含まれるか確認
次に、今日日付はもともと文字列の変数に入っていたので、「選択」で取得した配列に含まれるかを比較するために、こちらもシリアル化します。
日付を比較できるようシリアル値する
まずはテストで「作成」をつかって下記の式を実行してみます。
add(div(sub(ticks('2025-03-10'),ticks('1900-1-1')),864000000000),2)
日付のシリアル化については、こちらのブログを参考にさせていただきました。
配列の中に指定した値がふくまれるかどうかは、contains関数をつかって調べることができます。「選択」配列を第1引数、「今日日付のシリアル値」を第2引数に入れます。
contains(body('選択'),outputs('今日日付のシリアル値'))
テストの実行結果はご覧の通り。シリアル値が配列に含まれているので、contains関数の結果がTrueになりました。
あとは、日付の配列に含まれるかどうかを、先ほどの条件分岐にいれこめばOK、上出来です!
祝祭日を忘れてはいませんか?
さて、ここまででExcelに入力したオリジナルカレンダーに従ってクラウドフローを動作させることができました。もちろんカレンダーに祝日の情報を手入力してもよいのですが、「イベントのカレンダービューの取得(V3)」という便利なアクションがあります。
下図のように開始日付、終了日付にお正月日付をいれてテスト実行してみましょう。
結果はこのとおり。日本の休日カレンダーを参照して、開始時刻、終了時刻の間に存在する休日を配列としてかえしてくれます。
ということは、開始・終了に今日の日付をいれた結果の配列の要素数が1以上であれば、その日は休日であると判定することができそうです。
先ほどの「日本の休日」カレンダーで返された配列にいくつの要素があるかは、Length関数を使えばよいでしょう。条件式では1以上であれば「はい」に判定されるように設定しました。
length(outputs('イベントのカレンダー_ビューの取得_(V3)')?['body/value'])
まとめ
ここまでで、曜日判定、オリジナルカレンダー判定、日本の休日判定の3つの条件で動作させるかどうかを判定できるようになりました。
特に、カレンダーを使った方法はオールマイティーなので、これだけでも割と使えるのではないかと思います。
条件判定のあと、「はい」の中に実際に実行する部分を設定していますが、実行するユーザーがプレミアムライセンスを持っている場合には、クラウドフローをソリューションに入れて、実行部分を「子フロー」として別のフローに分割することもできます。
スケジュール起動と実動作を分けておくと、実行の成功、失敗をチャネルにまとめて通知するような仕組みも作りやすく、拡張性があるのでお勧めです。
この記事を書いている人
職場でPower BIを使ったり困っている人のサポートをしたりしてます。Qiitaの記事 や 個人的なブログ ではPower AutomateクラウドフローについてのTIPSのようなものを作ったりしているので、良かったら読んだり「いいね!」していただけると励みになります。