写入范围

UiPath.MicrosoftOffice365.Activities.Excel.WriteRangeConnections

描述

将数据表变量写入指定的 Excel 工作簿单元格范围。

作用域

此活动需要以下作用域：

• 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 变量和字符串格式的值。
  • 如果您已修改电子表格并需要检索最新数据，请选择“更新范围”选项。
• Include headers - This property supports Boolean values. Set to True to also include the DataTable headers into the workbook.
• 如何写入- 指定如何将数据添加到指定范围。可用选项包括：
  • “覆盖” - 覆盖以前存在的任何数据。
  • “附加” - 将数据写入找到的第一个空行。
  • “附加到右侧” - 将数据写入找到的第一个空列。有关更多信息，请参阅下面的附加部分。
  • 插入 - 插入行。
• 行位置- 要插入行的活动所在的行索引位置。可以使用“读取范围”或“遍历行”对范围行进行迭代，从而使用索引。如果选择“如何写入”–“插入”，则会显示此字段。此字段支持Int32类型的输入。
• 写入内容- 要写入 workbook 的数据表中的数据。此字段支持DataTable变量。例如，您可以使用“读取范围”活动的输出变量。

备注：

“工作表/范围名称” 属性中的某些特殊字符组合可能会导致活动引发错误。例如， Sheet%Test是有效输入，但Sheet%44不是有效输入（ %44会转换为D ）。

附加

附加数据当前不支持命名范围。

范围类型	附加（到底部）	附加到右侧
普通范围（A1 表示法）	将范围写入目标范围中找到的第一个空行。 它会创建必要数量的行，并用输入范围填充范围。 如果范围中没有空行，则通过插入必要数量的行并添加输入范围，将范围附加到底部。	将范围写入目标范围中找到的第一个空列。 它会创建必要数量的列，并用输入范围填充范围。 如果范围中没有空列，则通过插入必要数量的列并添加输入范围，将范围附加到右侧。
指定范围	将范围写入目标范围中找到的第一个空行。 它会创建必要数量的行，并用输入范围填充范围。 如果范围中没有空行，则通过插入必要数量的行并添加输入范围，将范围附加到底部。	将范围写入目标范围中找到的第一个空行。 它会创建必要数量的行，并用输入范围填充范围。 如果范围中没有空行，则通过插入必要数量的行并添加输入范围，将范围附加到底部。
工作表	将范围写入目标工作表中找到的第一个空行。 它会创建必要数量的行，并用输入范围填充范围。 如果范围中没有空行，则通过插入必要数量的行并添加输入范围，将范围附加到底部。	将范围写入目标工作表中找到的第一个空列。 它会创建必要数量的列，并用输入范围填充范围。 如果范围中没有空列，则通过插入必要数量的列并添加输入范围，将范围附加到右侧。

请求的已知限制

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

已知限制

如果将“写入行” / “写入范围”与“附加”选项一起使用，并且目标范围是开头包含空表格（没有其他数据）的工作表，则会发生错误。活动尝试在表格开头的工作表中插入行，但图形 API 会返回错误。

示例

另请参阅：

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