繰り返し (各リスト アイテム)

UiPath.MicrosoftOffice365.Activities.SharePoint.ForEachListItem

説明

Microsoft Graph の Get list item API を使用して、指定した SharePoint リスト内の各リスト アイテムに対して 1 つまたは一連のアクティビティを実行します。

メモ: このアクティビティでは永続性はサポートされていません。

プロジェクトの対応 OS

Windows - レガシ |Windows

構成

プロパティ

共通

• 表示名 - アクティビティの表示名です。 このプロパティは、String 型変数と文字列形式の値をサポートします。

入力

• フィルター - 任意の OData フィルターです。

  注:

  フィルター式には、インデックス付きの列のみを使用することを強くお勧めします。このアクティビティで提供される Prefer: HonorNonIndexedQueriesWarningMayFailRandomly ヘッダーにより、インデックス付きでないフィールドをフィルターで使用できます。ただし、大きなリストに対してこのようなクエリを実行すると失敗する可能性があることが警告されます。

  フィールド名は、フィールドの表示名ではなく、フィルター式で使用する必要があります。

• リスト - 操作を実行する SharePoint リストです。このフィールドでは Office365SharepointList 型の変数のみがサポートされています。

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。 このフィールドでは、Boolean 値がサポートされています。

出力

• インデックス - 使用中のコレクションで繰り返し処理される要素を指定するゼロベースのインデックスです。 このフィールドでは整数および Int32 型の変数のみがサポートされています。

フィルター処理の例

次の表は、SharePoint リスト アイテムに対するクエリを実行するときに役立つ可能性があるフィルターの例です。

クエリ	フィルター式
フィールドの優先度の値が「標準」のすべてのリスト アイテム	"fields/Priority eq 'Normal'"
フィールドのステータスの値が「完了」のすべてのリスト アイテム	"fields/Status eq 'Completed'"
2021 年 5 月 26 日に報告された、すべてのリスト アイテム	"fields/DateReported eq '2021-05-26'"
まだ完了していない、優先度高のすべてのリスト アイテム	"(fields/Priority eq 'High') and (fields/Status ne 'Completed')"
フィールドのタイトルに「work」が含まれ、内部フィールドの値が True のすべてのリスト アイテム	"substringof('work',fields/Title) and (fields/Internal eq 1)"
ID 6 のユーザーによって記録されたすべてのリスト アイテム (ユーザーの詳細は、非表示のリスト「User Information List」に保存されます)	"fields/IssueloggedbyLookupId eq 6"
[メール] フィールドの値が「[e-mail]」であるすべてのリスト アイテム (これは、非表示のリスト「User Information List」の一例です)	"fields/EMail eq '[e-mail]'"
6 月に報告され、ID 6 のユーザーに割り当てられた、すべての完了済みリスト アイテム	"(fields/Status eq 'Completed') and (fields/DateReported ge '2021-06-01' and fields/DateReported le '2021-06-30') and (fields/AssignedtoLookupId eq 11)"