タスクが完了しました(トリガー)
このピースでできることMicrosoft To Doの接続方法1. 接続を作成2. 接続設定3. Microsoft To Doへのアクセス許可を与える4. 「保存」を押して接続名が設定されていることを確認する。⚠️ Microsoft系アプリで管理者の同意が必要な場合ピースの設定項目1. タスクリスト(必須)動作のポイント取得できる情報
このピースでできること
- 指定したリスト内のタスク更新通知をWebhookで受信し、タスクの状態が完了()だった場合にワークフローを起動する仕組みです。通知の受信と購読の継続にはMicrosoft Graph側のWebhook設定が必要です。
Microsoft To Doの接続方法
1. 接続を作成
- 接続から「接続を作成」をクリックします。

2. 接続設定
- 接続名を設定して、「接続する」をクリックします。

3. Microsoft To Doへのアクセス許可を与える
- 管理者アカウントを選んでログインします。

4. 「保存」を押して接続名が設定されていることを確認する。
- 「保存」を押して接続名が設定されていることを確認します。


⚠️ Microsoft系アプリで管理者の同意が必要な場合
企業のMicrosoftセキュリティポリシーにより、外部アプリへのアクセス許可がブロックされている場合、接続時に以下のようなメッセージが表示されることがあります。
「workrunには、組織内のリソースへのアクセス許可が必要です。このアクセス許可を付与できるのは管理者のみです。」
この場合、貴社の情シス部門にMicrosoft Entra IDでの管理者同意(Admin Consent)の付与を依頼してください。
【標準のworkrun接続を利用している場合に、情シス担当者へ共有する情報】
- アプリ表示名:workrun
- クライアントID:f099e7f6-b923-41ce-9362-ee72073805f4
自社Azureアプリを利用している場合は、自社で登録したアプリの表示名とクライアントIDを共有してください。
管理者同意の具体的な手順は、以下のMicrosoft公式ドキュメントをご参照ください。
管理者同意の付与後、再度Microsoft To Doへのアクセス許可を行ってください。
ピースの設定項目
1. タスクリスト(必須)
- 監視対象のリストを選びます。
動作のポイント
- Webhook購読の作成時に、実装は有効期限を約2日後に設定します。購読を延長する処理自体は実装されていますが、現行のコードでは定期更新ジョブが登録される設定を確認できません。期限後も自動的に通知を受け続けられるとは保証できません。
- Webhookの clientState で通知の正当性を検証します。
取得できる情報
Microsoft Graphの通知を受け、対象タスクリストにあるタスクの最新情報をAPIから取得します。 が のタスクだけを1件ずつ後続ステップに渡します。
主なキー:(タスクID)、(件名)、(状態)、(重要度)、(期限)、(完了日時)。含まれるキーはMicrosoft Graphの応答によって異なります。
通知にタスクIDがない場合、検証用が一致しない場合、タスクを取得できない場合、または状態が完了以外の場合は出力しません。
注意:Webhookの購読は約2日後に期限を迎える設定です。購読延長関数はありますが定期更新ジョブの設定が確認できないため、長期継続を保証しません。実際の更新可否は接続環境で確認が必要です。