SharePoint「複数の項目の取得」で条件に合う項目を絞り込む

準備：本番ではなく練習用のSharePointリストを使います。標準タイトル列（Title）と、作成時の名前を半角英字Statusにした「1行テキスト」列を用意します。この例では選択肢列やユーザー列を使いません。下の表の件名と状態を5件登録します。IDは自動採番なので、表の21〜25は説明用です。自分の実際のIDを使ってください。

インスタントクラウドフローに「手動でフローをトリガーする」を置き、SharePointの「複数の項目の取得」を追加してGetOpenItemsに名前を変更します。サイトのアドレスと練習用リストを選択します。「項目の取得」はID指定で1件を読む別アクションです。

詳細パラメーターのフィルター クエリ欄へ Status eq '未完了' を文字として入力します。Statusは列、eqは等しい、'未完了'は比較する文字列です。式欄に equals(...) を入れる書き方とは異なります。列名は引用符で囲まず、文字の値は半角のシングルクォートで囲みます。

並べ替え（Order By）＝ID asc、上から順に取得（Top Count）＝10、アクション設定のページネーション＝オフにします。IDの小さい順に条件一致の最大10件を受け取る練習です。リスト全件を取得する設定ではありません。

データ操作「作成」を追加してRetrievedItemsに変更し、入力の式欄へ body('GetOpenItems')?['value'] を指定します。さらに「作成」を追加してRetrievedCountに変更し、式 length(body('GetOpenItems')?['value']) を指定します。配列全体と件数を見たいのでApply to eachは不要です。

手動実行し、GetOpenItemsが成功したことを確認してから、実行履歴のRetrievedItemsとRetrievedCountを開きます。表のデータなら取得されるのは備品確認・見積確認・棚卸準備の3件、件数は3です。元のリスト5件は変更されません。ID21・23・25は表と同じIDだった場合の期待値です。

0件の練習：フィルターだけを Status eq '該当なしテスト' に変更します。その文字を持つ行がなければ、取得成功時のvalueは []、RetrievedCountは0です。エラーで停止した場合とは区別します。確認後は Status eq '未完了' に戻します。

上限の練習：この5件だけのリストでTop Countを2にすると、未完了3件のうちIDが小さい2件だけが返り、件数は2です。取得件数は条件一致する総件数とは限りません。確認後は10に戻します。全件処理が必要な場合は、関連する期限切れ通知の記事のページネーション確認手順へ進みます。

既存リストへ応用する前に、列の内部名と種類を確認してください。画面の表示名が「状態」でも、そのままStatusや状態をクエリに書けるとは限りません。本例は作成時からStatusという英字名を使う前提です。列が存在しないエラーなら、まず練習用Status列で成功するか切り分け、既存列の定義をリスト管理者と確認します。表示名の変更だけで内部名を直そうとしないでください。