写入行

UiPath.MicrosoftOffice365.Activities.Excel.WriteRowConnections

描述

使用数组行或数据行在所选 Excel 文件中写入行。您可以使用“数据行”下的“单个字段”选项将单个字段映射到目标列。

作用域

此活动需要以下作用域：

• Sites.ReadWrite.All

项目兼容性

Windows | 跨平台

配置

• “Microsoft Outlook 365”- 要在活动中使用的 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。

• 范围 - 要写入的范围。您可以使用完整的 A1 表示法编写自定义范围。 此字段已预先填充从所选 workbook 或 workbook 示例中检索到的信息。此属性支持 String 变量和字符串格式的值。

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

• 如何写入- 指定如何将数据添加到指定范围。可用选项包括：

  • “覆盖” - 覆盖以前存在的任何数据。在确切位置写入行。如果选择了包含多个单元格的范围，则在第一行上写入。
    • 行位置 - 活动将覆盖行的行索引位置。可以使用“读取范围”或“遍历行”对范围行进行迭代，从而使用索引。从 0 开始。
  • “附加” - 指示如何将数据添加到指定的范围。将数据写入找到的第一个空行，并通过下移单元格插入新行。
  备注：

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

  • “插入”- 插入行并向新插入的行写入内容。
  备注：

  如果将“含标头”设置为 True，则将范围中的第一行视为标头，而行位置 0 为下一行。

• 写入内容- 将写入 workbook 的数据表中的数据。可用选项包括：

  • “数据行” - 使用数据行作为输入数据。
  • 数组行- 使用数组行作为输入数据。
  • “单个字段” - 将数据映射到单个目标字段。使用各个字段，您可以直接在指定的列中写入内容。系统不会清除未指定的列，并且这些列会保留旧数据。

• “要写入的数据行” - 要写入 workbook 的数据行或数组行中的数据。

• “含标题” - 如果选中，则通过读取范围标题生成列标题。此属性支持“布尔值”。默认选项为“关闭” 。如果选择“写入内容 - 单个字段”选项，则会显示此字段。

• “管理目标各列” - 为当前对象选择其他字段。如果选择“写入内容 - 单个字段”选项，则会显示此字段。

备注：

当在以下位置使用时，此活动支持批处理 API 调用：遍历电子邮件、遍历工作簿中的每一行、遍历文件或文件夹。

已知限制

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

示例

另请参阅：

• Excel Online 活动
• 写入列
• 写入单元格
• 添加工作表