---
title: .fapp 报表填报应用元数据
description: .fapp 报表填报应用文件阅读入口，指向类 Excel 表样、数据采集、数据期、提交、锁定和审批相关 DTS 说明
navTitle: .fapp
---
# .fapp 报表填报应用元数据

`.fapp` 是报表填报应用的元数据文件。这里的“表单”主要指用于采集数据的报表或 Excel 表样，不是常见的 Web 输入表单；一个 `.fapp` 往往包含多个填报工作表，类似一个 Excel 文件包含多个 Sheet。

报表填报应用围绕单元格、Sheet、固定行表、浮动表、取数公式、计算公式、校验公式、数据映射、数据期、填报单位、提交、锁定、审批和汇总组织在线填报过程。它适合把集团年报月报、财务预算、卫生直报、监管报送、明细采集等原本依赖 Excel 文件流转的业务，转成可在线设计、填报、校验、上报和汇总的数据采集应用。

当业务需要类 Excel 表样、周期填报、数据采集、明细录入、Excel 导入导出、复制粘贴、上报审批、数据锁定或上下级汇总时，应优先考虑报表填报应用。如果只是自由搭建一个门户、查询页、信息维护页或常规 Web 式业务表单，通常用 SuperPage（spg）；如果只是展示、打印、导出或归档固定版式数据结果，通常用报表（rpt）；如果主要是探索式分析和大屏展示，通常用仪表板（dash）。

fapp 文件遵守 SuccApp Super JSON 规范，数据集、表体、组件树、交互动作、页面设置、报表填报应用专用视图单元和资源引用等共同结构由页面基础类型承接；报表填报应用设置、填报工作表、视图单元和组件分支继续按对应 DTS 阅读。

## 视图拆分{#view-split}

报表填报应用支持多个视图单元。填报工作表用于类 Excel 数据录入、取数、计算和校验；其他视图单元用于浏览数据、查看数据期、查看单位状态、管理明细数据或执行提交、锁定、汇总等状态操作。

浏览页面和填报页面在设计期由一个页面对象管理，在编译期和查看期会拆分为浏览页面和填报页面。这样数据期列表、填报单位树、明细列表、上报状态和填报工作表可以拥有不同的数据范围、操作入口、计算和查询上下文，避免填报提交、状态浏览和数据查询互相干扰。

填报页面以 `body` 作为根组件，承载工作表和类 Excel 填报区域；浏览页面元数据中没有根组件，运行时会使用虚拟根组件。各视图单元在 DTS 中通过 `@boId` 标识属于 `browser` 浏览页面还是 `sheets` 填报页面。

## 示例文件{#examples}

- [固定行表.fapp](https://demo.succbi.com/v5/DEMO/fapp/form/row-table/固定行表.fapp) - 固定行表填报示例
- [reimburse.fapp](https://demo.succbi.com/v5/DEMO/fapp/form/valid/reimburse.fapp) - 报销表单校验示例
- [员工入职登记表.fapp](https://demo.succbi.com/v5/DEMO/app/ci.app/style/case/员工入职登记表.fapp) - 员工入职登记表示例

## DTS 入口{#types}

- 根结构和报表填报应用设置：[`types/meta/file-types/fapp.d.ts`](../../../../../dev-types/types/meta/file-types/fapp.d.ts)
- 页面基础结构：[`types/meta/visual-page/visualpage.d.ts`](../../../../../dev-types/types/meta/visual-page/visualpage.d.ts)
- 组件类型：[`types/meta/component/index.d.ts`](../../../../../dev-types/types/meta/component/index.d.ts)
- 数据集类型：[`types/meta/dataset/index.d.ts`](../../../../../dev-types/types/meta/dataset/index.d.ts)
- 动作节点：[`types/meta/actionComponent/index.d.ts`](../../../../../dev-types/types/meta/actionComponent/index.d.ts)
- 原始 BO 类型：[`types/api/succ.bo.d.ts`](../../../../../dev-types/types/api/succ.bo.d.ts)