使用 SharePoint 列表

关于

本节介绍如何处理、筛选和遍历 SharePoint 列表。

如何使用大型 SharePoint 列表

场景：您有一个包含超过 5,000 个项目的 SharePoint 列表，并且想要使用“遍历列表项目”和 “获取列表项目” 活动。

由于基础 Microsoft Graph API 的限制，如果在如此规模的列表上将这些活动与可选的 OData 筛选器一起使用，则活动将失败，并显示以下错误：

"error": {
    "code": "notSupported",
    "message": "The request is unprocessable because it uses too many resources",
    "innerError": {
        "code": "tooManyResources",
        "date": "2023-05-01T04:27:00",
        "request-id": "93c12b1f-6bc5-4466-ae9f-2bfd2ca0ef6a",
        "client-request-id": "02996ac5-b700-8a1e-3c6d-7e6f0624fabe"
    }
 }

解决方案

在 SharePoint 列表上为您计划在可选 OData 筛选器中使用的列添加列索引。 有关如何添加索引的信息，请参阅 Microsoft文档。

例如，您有一个包含三列的 SharePoint 列表：标题、名字和 姓氏。 您希望使用“遍历列表项目”活动筛选所有等于“Smith”的“姓氏”值。

1. 对 SharePoint 中的“姓氏”列创建索引。 这使 Microsoft Graph API 可以进行高性能查询并避免返回错误。
2. 将 UiPath 活动中的 OData 筛选器设置为 "fields/LastName eq 'Smith'" ，以执行所述功能。 这样，即使列表的大小超过 5,000 个项目，也不会发生错误。

限制

即使使用索引，如果要返回的结果数量超过 5,000，图形 API 也不会成功返回。

• 场景 1：使用 OData 筛选器时返回的值少于 5,000。 解决方法：如上所述，添加索引。
• 场景 2：使用 OData 筛选器时返回超过 5,000 个值。 解决方法：删除 OData 筛选器，以允许返回 5,000 个以上的值，然后在 Studio 中进行筛选（例如，使用“筛选数据表”活动）。

注意： 此 API 限制会影响传统列表活动和 SharePoint 列表活动。

如何使用人员查找字段

从版本 2.4.2 开始，您可以通过引用值的一部分来管理人员查找字段。 在“人员/组类型”字段中，您还可以将人员的电子邮件添加为字符串输入。

请注意，人员是包含多个字段的复杂类型。 如果收到字符串输入，则假定它包含人员的电子邮件地址，并且不包含其他子字段或 ID。