匹配函数 Workbook（预览版）

使用 Excel MATCH 函数查找某个值在某个范围内的相对位置的 Workbook 活动。

UiPath.Excel.Activities.MatchFunction

描述

使用 Excel 的MATCH函数查找某个值在某个范围内的相对位置。该活动的跨平台等效于匹配函数窗口活动。

备注：

此活动不支持.xls文件。

项目兼容性

Windows | 跨平台

属性

常见

• DisplayName - The name displayed for the activity in the Designer panel.

输入

• 文件- 资源工作簿的完整路径。要切换到本地路径，请选择加号图标，然后选择使用本地文件。当前字段更改为文件（本地路径） ，您可以在其中提供 workbook 的完整路径。
• “工作表名称” - workbook 中工作表的名称。
• 范围- 要在其中搜索的范围。此字段为必填项。
• 查找值- 要搜索的值。此字段为必填项。
• 匹配类型- 选择查找值与范围的匹配方式。默认值为1 (最大值小于或等于要匹配的值) 。您可以从以下选项中进行选择：
  • 1 (最大值小于或等于要匹配的值) - 查找小于或等于查找值的最大值。范围必须按升序排序。
  • 0（第一个值完全等于要匹配的值） - 查找第一个与查找值相同的值。范围可以采用任何顺序。
  • -1 (最小值大于或等于要匹配的值) - 查找大于或等于查找值的最小值。范围必须按降序排序。

选项

• 密码- workbook 的密码（如有必要）。

输出

• 位置- 范围内匹配项的位置（从 1 开始），存储为Int32变量。如果活动未找到匹配项，则值为-1 。

使用 workbook

• “工作簿” - 要使用的现有工作簿，而非文件路径。

注意

• 位置是相对于范围，与工作表无关。例如，无论范围在工作表上的起始位置，匹配该范围的第三个单元格时都会返回3 。
• 范围必须引用工作表名称中的工作表。不支持包含工作表名称的范围（例如Sheet2!A2:A100 ），这会导致错误。
• 整列或整行的范围（例如A:A ）仅限于工作表的已使用范围。
• 如果范围为空或查找值为null ，则活动将失败并显示错误。