写入范围

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 Desktop 中，该选项可从“查看更多”范围类型旁边的按钮菜单。 要了解更多信息，请参阅使用模板。

  • “文件/文件夹”选取器选项：单击“文件/文件夹”选取器图标浏览 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 变量和字符串格式的值。

  • 如果您已修改电子表格并需要检索最新数据，请选择“更新范围”选项。

• 包含标头 - 此属性支持布尔值。 设置为 True 还可将数据表标头包含到工作簿中。

• 如何写入 - 指定如何将数据添加到指定范围。 可用选项包括：
  • “覆盖 ” - 覆盖以前存在的任何数据。
  • “附加 ” - 将数据写入找到的第一个空行。
  • 右侧附加 - 将数据写入找到的第一个空列。 有关更多信息，请参见下面的“ 附加 部分”。
  • 插入 - 插入行。
• “行位置” - 要插入行的活动所在的行索引位置。 可以使用“读取范围”或“遍历行”对范围行进行迭代，从而使用索引。 如果您选择“如何写入”–“插入”，则会显示此字段。 此字段支持Int32类型输入。
• “写入 内容” - 要写入工作簿的数据表中的数据。 此字段支持 DataTable 变量。 例如，您可以使用“ 读取范围 ”活动的输出变量。

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

附加

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

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

请求的已知限制

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

已知限制

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

示例

另请参阅：

• Excel Online 活动

• 创建工作簿
• 删除工作表
• 读取单元格