ユーザーに割り当てられた新規タスク(トリガー)

このピースでできること

  • 選択したプランで、接続ユーザーに割り当てられている新しいタスクを検知します。判定はタスク作成日時を基準にするため、古いタスクへの後からの割り当てすべてを検知するものではありません。

Microsoft 365 Plannerの接続方法

1. 接続を作成

  • 接続から「接続を作成」をクリックします。

2. 接続設定

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

3. Microsoft 365 Plannerへのアクセス許可を与える

  • 管理者アカウントを選んでログインします。
  • アプリに許可を行います。

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

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

⚠️ Microsoft系アプリで管理者の同意が必要な場合

企業のMicrosoftセキュリティポリシーにより、外部アプリへのアクセス許可がブロックされている場合、接続時に以下のようなメッセージが表示されることがあります。
「workrunには、組織内のリソースへのアクセス許可が必要です。このアクセス許可を付与できるのは管理者のみです。」
この場合、貴社の情シス部門にMicrosoft Entra IDでの管理者同意(Admin Consent)の付与を依頼してください。
【標準のworkrun接続を利用している場合に、情シス担当者へ共有する情報】
  • アプリ表示名:workrun
  • クライアントID:f099e7f6-b923-41ce-9362-ee72073805f4
自社Azureアプリを利用している場合は、自社で登録したアプリの表示名とクライアントIDを共有してください。
管理者同意の具体的な手順は、以下のMicrosoft公式ドキュメントをご参照ください。
管理者同意の付与後、再度Microsoft 365 Plannerへのアクセス許可を行ってください。

ピースの設定項目

1. プラン(必須)

  • 監視対象のプランを選択します。

取得できる情報

選択したプランで、接続ユーザーに割り当てられている新しいタスクの情報を取得できます。
  • / / / :タスクID・タイトル・プランID・バケットID。
  • / / / :作成・開始・期限・完了日時。未設定の日時はnullの場合があります。
  • / :進捗率・優先度。
  • :割り当て先。ユーザーIDをキーとするオブジェクトです。
  • / など:API応答に含まれる作成者・カテゴリー情報。説明文やチェックリストの明細を別APIで追加取得する処理はありません。

取得条件と注意点

  • 選択したプランのタスクを取得し、タスクの が保存した境界より新しいものを返します。有効化時に基準時刻を保存します。
  • 一覧APIの先頭ページのみを処理し、次ページは追加取得しません。大量のタスクがある場合は全件取得を保証しません。
  • テストは取得したタスクの最大5件です。通常の基準時刻による絞り込みとは異なります。
  • 接続ユーザーIDが のキーにあるタスクだけが対象です。任意の他ユーザーを設定して監視する方式ではありません。
  • 比較する日時は割り当て日時ではなくタスク作成日時です。以前から存在するタスクが後から割り当てられても、作成日時が保存した境界より古い場合は検知しません。

利用例

・ を使い、自分に割り当てられた新しいタスクを通知できます。

出力例(抜粋)

キーと階層を示す架空例です。実際の項目・値は受信内容や接続先により異なります。