Power Automate 「タスクを一覧表示します(Planner)」アクション

2021年11月8日

「タスクを一覧表示します(Microsoft Teams)」は

プラン(中カテゴリのような区分)に所属するタスクの情報を

アレイ(配列)で取得するアクションです。

この記事では、その使い方を紹介します。

利用方法

フローにステップを追加する際に「Planner」コネクタを選択します。

「アクション」より「タスクを一覧表示します」を選択します。

「タスクを一覧表示します」ステップが追加されるのでパラメーターを設定します。

項目省略時の値説明
グループ ID省略不可タスクの情報を取得するグループを選択します。
プラン ID省略不可タスクの情報を取得するプランを選択します。

次に「Apply to each」を設置し以前の手順から出力の選択に

動的なコンテンツの「値」を指定します。

動的なコンテンツ

Apply to each」の中で動的なコンテンツとしてタスクの情報を取得可能です。

IDは他のアクションでタスク指定を行う場合に利用します。

項目種類説明
ID文字列タスクの一意識別子。
バケットID文字列バケットの一意識別子。
プランID文字列プランの一意識別子。
達成率整数タスクの進行状況。
・開始前 … 0
・処理中 … 50
・完了済み… 100
優先度整数タスクの優先度。
・緊急 … 0~1
・重要 … 2~4
・中  … 5~7
・低  … 8~10
参照数整数添付ファイルの数
作成者 ユーザー ID文字列作成者のOffice 365 ユーザー ID。
作成者 ユーザー 表示名文字列作成者の表示名。筆者の環境では空白でしたので
(環境によって異なる可能性があります)
Office 365 ユーザー」コネクタの
ユーザー プロフィールの取得」アクションで
表示名を取得しました。
タイトル文字列タスクの名称です。
開始日時文字列日時タスクの開始日時を取得します。
協定世界時のため日本の時刻への調整が必要です。
作成日時文字列日時タスクの開作成日時を取得します。
協定世界時のため日本の時刻への調整が必要です。
期限日時文字列日時タスクの期限日時を取得します。
協定世界時のため日本の時刻への調整が必要です。
完了日時文字列日時タスクの完了日時を取得します。
協定世界時のため日本の時刻への調整が必要です。
説明がありますブールメモに入力があるかを取得します。
・入力あり…True
・入力なし…False
ピンクブールピンクのラベルが設定されているかを取得します。
・設定…True
・未設定…空白(今後、変わる可能性あり)
ブール赤のラベルが設定されているかを取得します。
・設定…True
・未設定…空白(今後、変わる可能性あり)
ブール黄のラベルが設定されているかを取得します。
・設定…True
・未設定…空白(今後、変わる可能性あり)
ブール緑のラベルが設定されているかを取得します。
・設定…True
・未設定…空白(今後、変わる可能性あり)
ブール青のラベルが設定されているかを取得します。
・設定…True
・未設定…空白(今後、変わる可能性あり)
ブール紫のラベルが設定されているかを取得します。
・設定…True
・未設定…空白(今後、変わる可能性あり)
割り当てアレイ(配列)タスクの割り当てユーザの一覧が
アレイ(配列)として格納されています。

コントロールの「Apply to each」の中で
以下の動的なコンテンツを利用可能です。
・割当先のユーザID…担当者のOffice 365 ユーザー ID
・割当担当者のユーザID…割り当てた人のOffice 365 ユーザー ID
オーダーヒント

画像に alt 属性が指定されていません。ファイル名: image-43.png
画像に alt 属性が指定されていません。ファイル名: image-44.png

当サイトの情報を再編集した実務リファレンス

ネット検索では解決しづらい「日付の変換」や「複雑なデータ処理」など、当サイトで公開している技術情報を電子書籍として読みやすく再編集しました。

400以上のコネクタや関数の仕様を網羅的に解説しており、困ったときにすぐ引ける「辞書」として活用いただけます。

現場でのトラブルシューティングや、手元での確認用に最適です。Kindle Unlimited対象(読み放題)です。

[書籍リンク:Power Automate (Web版)完全版 基本から実用まで]

関連記事