遍历列表项目

UiPath.MicrosoftOffice365.Activities.SharePoint.ForEachListItem

描述

使用 Microsoft Graph 获取列表项目 API 对指定 SharePoint 列表中的每个列表项目执行一个或一系列活动。

注意： 此活动不支持暂留。

项目兼容性

Windows - Legacy | Windows

配置

属性

常见

• “显示名称”- 活动的显示名称。此属性支持 String 变量和字符串格式的值。

输入

• “筛选器 ” - 可选的 OData 筛选器。

  备注：

  强烈建议在筛选表达式中仅使用索引列。 该活动提供 Prefer: HonorNonIndexedQueriesWarningMayFailRandomly 标头以允许在筛选器中使用非索引字段，但请注意，此类查询可能会在大型列表上失败。

  应在筛选器表达式中使用字段名称，而不应在字段显示名称中使用。

• “列表”- 要对其执行操作的 Sharepoint 列表。此字段仅支持 Office365SharepointList 变量。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。该字段仅支持“布尔值”。

输出

• “索引” - 从零开始的索引，用于指定要迭代当前集合的哪个元素。 此字段仅支持整数和 Int32 变量。

筛选示例

下表为查询 IMAP 邮件消息时可能有用的筛选器示例：

查询	筛选器表达式
“优先级”字段值为“正常”的所有列表项目	"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 的用户记录的所有列表项目（有关用户的详细信息存储在“用户信息列表”隐藏列表中）	"fields/IssueloggedbyLookupId eq 6"
值为“[e-mail]”的所有列表项目 用于电子邮件字段（这是“用户信息列表”隐藏列表的示例）	"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)"