Office Script使用range.find匹配单元格并返回行至Power Automate的方法咨询

针对你的需求（接收Power Automate参数、全表精确匹配、返回匹配行数组），以下是三种常用方法的对比及最优实现：

方法对比 #

• range.find循环（推荐）：利用Excel原生查找引擎，性能最优（尤其大数据量场景），原生支持completeMatch精确匹配，无需手动遍历所有单元格。
• getValues数组遍历：代码直观易懂，适合小数据量表格，但大数据量下性能不如原生find方法。
• range.filter：仅支持按指定列筛选，无法实现全表任意单元格的精确匹配，不适用你的需求场景。

修正后的最优代码 #

function main(workbook: ExcelScript.Workbook, siteNameToFilter: string): (string | number | boolean)[][] {
  const activeSheet = workbook.getActiveWorksheet();
  const usedRange = activeSheet.getUsedRange();
  if (!usedRange) {
    return []; // 表格无数据时返回空数组
  }

  const findOptions: ExcelScript.FindOptions = {
    completeMatch: true,
    matchCase: false,
    searchDirection: ExcelScript.SearchDirection.forward
  };

  let foundCell = usedRange.find(siteNameToFilter, findOptions);
  const matchedRows = new Set<number>(); // 用Set存储行号，避免同一行多次匹配重复返回
  const result: (string | number | boolean)[][] = [];

  while (foundCell) {
    const rowIndex = foundCell.getRowIndex();
    if (!matchedRows.has(rowIndex)) {
      matchedRows.add(rowIndex);
      // 获取当前匹配行的所有值并加入结果数组
      const rowValues = usedRange.getRow(rowIndex).getValues()[0];
      result.push(rowValues);
    }
    // 查找下一个匹配单元格
    foundCell = usedRange.findNext(foundCell);
  }

  return result; // 返回给Power Automate的匹配行二维数组
}

关键要点说明 #

1. 精确匹配保障：通过completeMatch: true配置，确保仅匹配单元格内容与目标值完全一致的情况，彻底避免部分匹配问题。
2. 重复行去重：使用Set存储已匹配的行号，防止同一行内多个单元格匹配时重复返回整行数据。
3. 异常场景处理：提前判断表格是否存在已用范围，避免无数据时出现运行报错。
4. Power Automate兼容：返回标准二维数组格式，可直接被Power Automate接收并用于后续流程。

内容的提问来源于stack exchange，提问作者user639410