@flatfile/plugin-export-workbook

中文文档
6.0.1发布于 2026/02/28ISCTypeScriptESM + CJS零依赖近 30 天下载 4.1万

用于将 Flatfile 中的数据导出到工作簿的插件 .

中文使用文档

这个 @flatfile/plugin-export-workbook 插件将 Flatfile 工作簿中的数据导出为可下载 .xlsx 文档.

事件类型 : listener.on('job:ready')

支持的文件类型 : .xlsx

嵌入Flatfile时,该插件应被部署在服务器侧听器中. 学多点

参数

jobName - 说吧 string - (可选)

插件会点出的工作名称 。 如果没有提供, workbook:downloadWorkbook 将被使用.

excludedSheets - 说吧 string[] - (可选)

导出时要排除的一系列工作表

excludeFields - 说吧 string[] - (可选)

要从导出中排除的一系列字段

excludeMessages - 说吧 boolean - (可选)

如果选中的话, 记录中的信息将被排除在导出的数据之外 .

recordFilter - 说吧 Flatfile.Filter - (可选)

允许过滤导出的记录到 valid 或者说 error。默认情况下,所有记录都将被导出

includeRecordIds - 说吧 boolean - (可选)

包括记录的ID

autoDownload - 说吧 boolean - (可选)

导出后自动下载文件

debug - 说吧 boolean - (可选)

这个 debug 参数允许您为开发目的切换或关闭帮助调试消息.

sheetOptions - 说吧 Record<string, ExportSheetOptions> - (可选)

工作表流图到 ExportSheetOptions 实例,提供工作表特定导出选项:

  • skipColumnHeaders - 说吧 boolean - (可选) - 允许省略列头
  • origin - 说吧 number | SheetAddress - (可选) - 允许抵消工作表的开始 。 参数为行号或对象 column 财务报告和审定财务报表 row。 。 。 .

用法 :

listener.use(
  exportWorkbookPlugin({
    sheetOptions: {
      SomeSheetSlug: {
        // Start the sheet at 5
        origin: 5,
        // Omit column headers
        skipColumnHeaders: true,
      },
      SomeOtherSheetSlug: {
        // Start the sheet at row 10 column 2
        origin: {row: 10, column: 2},
      },
    },
  })

columnNameTransformer - 说吧 ColumnNameTransformerCallback - (可选)

回调函数允许更改工作簿中列名的显示方式 。 该函数接受两个参数: columnName 财务报告和审定财务报表 sheetSlug 并返回新的列名.

使用量

在工作簿(不是工作表)上必须配置一个操作名为"download Workbook"的动作才能被触发.

workbook.config.json

  // ... inside Workbook configuration
  "actions": [
    {
      "operation": "downloadWorkbook",
      "mode": "foreground",
      "label": "Download Excel Workbook",
      "description": "Downloads Excel Workbook of Data",
      "primary": true
    }
  ]
  // ...

安装

npm i @flatfile/plugin-export-workbook

listener.js

import type { FlatfileListener } from "@flatfile/listener";

import { exportWorkbookPlugin } from "@flatfile/plugin-export-workbook";

export default function (listener: FlatfileListener) {
  listener.use(exportWorkbookPlugin());
}

版本与发布记录

@flatfile/plugin-export-workbook 共发布 45 个版本,首次发布于 2023/07/26;过去 12 个月发布了 1 个版本。

版本发布日期距今
6.0.1latest2026/02/288 个月前
6.0.02025/10/181.1 年前
5.2.32025/08/281.2 年前
5.2.22025/08/271.2 年前
5.2.12025/06/211.4 年前
5.2.02025/05/161.5 年前

其他发布通道:next → 0.0.10-rc.4。

关于 @flatfile/plugin-export-workbook 的常见问题

@flatfile/plugin-export-workbook 是什么?

用于将 Flatfile 中的数据导出到工作簿的插件 .

如何安装 @flatfile/plugin-export-workbook?

在项目目录运行 npm install @flatfile/plugin-export-workbook,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:xlsx(https://cdn.sheetjs.com/xlsx-0.20.2/xlsx-0.20.2.tgz)、@flatfile/api(^1.9.19)、@flatfile/listener(^1.1.0)、@flatfile/util-common(^1.8.0)、@flatfile/plugin-job-handler(^0.8.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@flatfile/plugin-export-workbook 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@flatfile/plugin-export-workbook 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@flatfile/plugin-export-workbook 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >= 18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@flatfile/plugin-export-workbook 可以商用吗?

@flatfile/plugin-export-workbook 使用 ISC 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@flatfile/plugin-export-workbook 的下载量有多少?

根据 npm 官方下载统计,@flatfile/plugin-export-workbook 在 2026/10/15 – 2026/11/13 这 30 天内被下载 40,965 次,日均约 1,366 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@flatfile/plugin-export-workbook 还在维护吗?

最新版本 6.0.1 发布于 2026/02/28(8 个月前);至今共发布 45 个版本,其中过去 12 个月发布了 1 个;首次发布于 2023/07/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。