遍历工作簿中的每一行

UiPath.MicrosoftOffice365.Activities.Excel.ForEachRowConnections

描述

遍历工作表中指定范围内的行。

在“遍历 Workbook 中的行”中添加要重复的活动，并在配置这些活动时从“查看更多”按钮菜单中选择“使用变量” > “当前行” ，以指明要对迭代中的每一行重复操作。有关详细信息，请参阅使用“遍历”活动遍历项目。

作用域

此活动需要以下作用域：

• 文件。读取

或

• Files.ReadWrite

或

• 文件读取全部

或

• Files.ReadWrite.All

或

• 站点。只读。全部

或

• Sites.ReadWrite.All

备注：

此活动使用分页来处理大量项目并缓解性能问题。此活动不支持暂留。

项目兼容性

Windows | 跨平台

配置

• Microsoft OneDrive 和 SharePoint 连接 - 要在活动中使用的 Microsoft 365 帐户的连接。
• “workbook” - 要使用的 Excel workbook。用于指定要检索的文件夹的方法： “文件夹选取器” 、 “输入 ID” 、 “输入 URL” 。

  • “workbook 示例” - 要使用的 workbook 模板。单击“使用 workbook 模板”后，该字段可见。浏览 OneDrive 文件夹，然后选择一个 Workbook。在桌面版 Studio 中，该选项可从“范围类型”旁边的“查看更多”按钮菜单选择。要了解更多信息，请参阅使用模板。

  • “文件/文件夹选取器”选项：单击图标浏览 OneDrive 或 SharePoint 文件/文件夹并选择电子表格。此选项接受IResource形式的输入。

    • 使用“查看更多”按钮菜单以使用变量；如果您修改了文件夹并需要检索最新数据，请选择“重新加载文件夹数据”选项。

  • “输入 ID”选项：

    • “workbook ID” - 相关 workbook 的 ID。此字段支持String类型的输入。
    • “SharePoint 站点地址” - 包含文件或文件夹的 SharePoint 站点的 URL。此字段支持String类型输入。在浏览器中打开您的 SharePoint 站点并复制其 URL，例如https://yourcompany.sharepoint.com/sites/ProductOfficial 。
    • “SharePoint 文档库” - 指定 SharePoint 站点中包含文件或文件夹的文档库。此字段支持String类型的输入。在 SharePoint 站点中打开“文档”选项卡并复制 URL，例如https://yourcompany.sharepoint.com/sites/ProductOfficial/Shared%20Documents/Forms/AllItems.aspx 。

  • 输入 URL 选项：

    • “workbook URL” - 相关 workbook 的 URL。此字段支持String类型的输入。通过在浏览器中打开文件来检索 URL。
• 范围 - 迭代行所在的范围。此字段已预先填充从所选电子表格或电子表格示例中检索到的信息。此属性支持 String 变量和字符串格式的值。
  • 如果您已修改电子表格并需要检索最新数据，请选择“更新范围”选项。
  • 如果您已修改 workbook 并需要检索最新数据，请选择“更新表格”选项。
• 有标头- 指定范围中的第一行是否代表标头行。默认情况下，选择“True” 。

其他选项

输入

• If row is empty - Indicates the behavior to follow when an empty row is iterated. The available options are Skip, Process, and Stop.

输出

• 已处理的工作表总数- 活动处理的工作表总数。

正文

存储自动化中使用的其他活动的活动主体。

请求的已知限制

使用范围时，请注意请求/响应限制。限制为 4 MB，例如，平均 10,000 个单元格（每个包含 20 个字符）用于读取请求，4,000 个单元格（每个单元格包含 20 个字符）用于写入请求。有关详细信息，请参阅Excel 规范和限制。

备注：

当在遍历循环中使用时，以下活动支持批处理 API 调用：

• 添加列表项目
• 发送电子邮件
• 写入行
• 创建活动

示例

另请参阅：

• Excel Online 活动
• 创建工作簿
• 添加工作表
• 读取单元格