跳转到主要内容
从 Excel 工作簿中获取值。 当 翻译模式 设置为 模板 时,此操作通常在 Excel 端口 的模板文件中使用。 不过,此操作也可以用于专用脚本场景,例如Script 端口

必需的参数

  • sheet: 工作簿中要从中检索值的工作表。

可选的参数

  • version:目标工作簿的 Excel 版本。 允许的值为AUTO9597-20032007。 默认为 AUTO
  • file:Excel 工作簿在磁盘上的完整路径,包括文件名。 必须指定filehandle参数。
  • handle:对excelOpen创建的Excel数据的可读句柄引用。 如果指定file参数,则不需要handle
  • map:*:一组一个或多个输入,其中映射参数的名称位于冒号之前(例如,map:foo),值是工作表中单元格的名称或范围。 例如,值为C1的属性map:foo在操作的指定输出项上创建foo属性,其值是在目标工作表的单元格 C1 中找到的值。 还可以指定一个单元格范围以检索该范围内所有单元格的值。 例如,C1:C10 检索单元格 C1 到 C10 的所有值。 可以使用通配符*来获取列长度的单元格值。 例如,C1:C*检索从 C1 到列末尾的所有值。

输出属性

  • *: 取决于工作表的内容和指定的查询。 如果存在列标题,则它们用于命名输出属性。 此外,如果在输入项上设置map:*参数,则输出项包含具有相同名称的属性。 有关其他上下文,请参阅示例

示例

有关其他信息和更多示例,请参阅 Excel 端口 文档的 Excel 到 XML 部分。

获取值并映射到新对象

此示例使用 excelGet 操作从指定工作表中的单元格和列中获取特定的范围值,并将它们映射到新项目。 稍后可以在模板中使用新项目来填充 XML 输出文件的特定 XML 元素,作为 Excel 端口模板模式的一部分。 有关 arc:call 中使用的 arc:map 关键字的详细信息,请参阅 arc:map

在 Script 端口中使用 excelGet

此示例使用 Script 端口 中的 excelGet 操作打开磁盘上现有的 Excel 工作簿并从特定单元格读取数据。 然后关闭 Excel 工作簿,脚本将该数据作为新的输出文件推送。