[Automation]自動化で祝日を判定する方法

[#1]

Jiraの自動化フローでは、祝日を考慮する機能が提供されておらず、月~金曜日の営業日のみルールを動作させたい、または営業日以外に動作させたい様な場合に、標準機能では祝日を除外する事ができません。

関連する機能リクエストとして以下が起票されております。

• AUTO-971 - When using BusinessDays, we should be able to define the non-working days and public holidays 

標準機能では実現することは出来ませんが、以下の様な外部で公開されているAPIを組み合わせて実装することで、祝日の判定が可能です。

• 祝日判定web API(https://s-proj.com/utils/holiday.html)

以下に、参考として上記APIを使用して祝日を判定する自動化フロー設定例を記載いたします。

自動化フロー設定例:

要件: 作業項目が作成された際にトリガーされ、現在時刻が日本時間土日、祝日の場合に翌営業日に対応する旨のコメントを追加する

• トリガー: 作業項目の作成時

• アクション: Webリクエストを送信

  • Web リクエスト URL

  • https://s-proj.com/utils/checkHoliday.php?kind=h&date={{now.convertToTimeZone("Asia/Tokyo").format("yyyyMMdd")}}

  • HTTPメソッド: GET

  • Web リクエスト本文: 空白

  • “この Web リクエストからの応答を受信するまで、後続のフロー アクションの実行を遅延します“: ON

  • “リクエストの応答が正常でなかった場合 (200 OK レスポンスでない場合) でも、フローの実行を続行します“: ON

• 条件: {{smart values}}の条件
  • 最初の値: {{webResponse.body}}

  • 条件: と等しい

  • 第2の値: holiday

  • (補足) 祝日判定web API(https://s-proj.com/utils/holiday.html)は、パラメータで渡された日付が土日、祝日の場合”holiday”を返し、それ以外の場合”else”を返します。

• アクション: 作業項目へのコメント

  • 営業日以外に作成された作業項目に対して自動で追加したいコメントの内容を記載

外部 API の仕様変更・廃止について
本記事では祝日判定web API(https://s-proj.com/utils/holiday.html)が提供する外部 API を使用していますが、これらは Atlassian が管理するサービスではございません。
提供元の都合により、API の仕様変更やサービスの廃止が予告なく行われる場合があります。その際は、本記事の設定手順が正常に動作しなくなる可能性がございますので、予めご了承ください。