---
order: 2
navTitle: 填报单位
---
# 填报单位

**填报单位**是报表填报应用中需要填报数据的组织机构、部门或个人。比如集团的企业年报，填报单位是整个集团及其下级分子公司的组织架构；再比如员工填写KPI计划，填报单位就是每个员工个体。**填报单位**是**周期填报应用**的数据粒度之一，**信息管理应用**无需设置。基本设置如下：

![填报单位](./images/2024-05-09-10-00-00.png)

- **填报单位**：选择存储填报单位信息的数据模型，可直接在此处引入外部模型，报表填报应用会按该模型中的数据展示填报单位。
- **填报单位层次**：选择填报单位模型中设置的层次，以模型的默认层次为主，也支持选择该模型中设置的其他层次作为填报单位树的展现形式。不同类型的层次作为填报单位的默认行为不同，分为下述四种情况：
  - **父子层次**：比如集团分子公司，默认情况下父单位和子单位都需要填报本单位的数据。
  - **分段层次**：默认体验与父子层次一致。
  - **多字段层次**：只有叶子单位需要填报数据，比如卫统直报，需要填报数据的单位是各医疗机构，但为了上级卫健委能更加方便的查看数据，往往会将医疗机构按照所属的卫健委分类，让填报单位按照**卫健委-医疗机构**的层次来展示数据，这种情况下上级往往都是不填报数据的。
  - **多字段+父子层次**：是多字段层次的一种补充情况，只有属于父子层次那部分的单位能够填报数据，例如部分医疗机构是存在分支机构的，那么最后得到的层次会是**卫健委-总医疗机构-分支医疗机构**，只有医疗机构那部分单位能够实际填报数据。

::: tip

1. 设置填报单位后，所有在报表填报应用中生成的模型都会自动添加**填报单位**字段，并自动给字段设置关联表，关联表即是此处选择的填报单位模型。
2. 如果是从报表填报应用外部引入的模型，则需要自行给模型对应的主键字段添加关联表，使用的关联表必须与填报单位中设置的模型一致，这样报表填报应用才能自动识别外部模型的**填报单位**字段。

:::

## 限制填报单位范围{#org-range}

某些业务场景中，不希望填报单位使用模型的全量数据，比如集团公司在全国都有分子公司，但该报表填报应用只需要湖北省的分子公司填报，此时可通过表达式来进一步缩小填报单位的范围。

![填报单位范围](./images/2024-05-09-10-01-01.png)

- **设置填报单位范围**：开关设置，勾选后可设置**填报单位范围**。
- **填报单位范围**：在填报单位模型的基础上设置过滤条件，只有满足条件的单位才需要填报数据，比如限制湖北省的分子公司需要填报，则可设置表达式为`行政区划.省='420000'`，过滤条件中只能引用填报单位模型中存在的字段，为空时所有单位可填。
- **浏览单位过滤条件**：浏览单位数据时会作用的过滤条件，比如管理员在查看单位列表时希望只看那些已填报并通过校验的数据，则可设置条件为`提交状态 = 1 AND 校验状态 = 1`。还可通过**参数**来动态修改可浏览的单位数据，具体可参考[自定义过滤菜单](./interface.md#filter-menu)。

::: tip

**填报单位范围**与**浏览单位过滤条件**两者有本质区别，主要体现在以下几点：

1. **填报单位范围**决定的是哪些单位需要填报，更多是对基层单位填报表单时有影响，而**浏览单位过滤条件**不限制单位的填报，只限制查看时能看到哪些单位数据，主要是影响监管用户能查看的单位范围。
2. **填报单位范围**只支持写**固定条件**，即确定后不会发生动态变化的条件，比如行政区划限制湖北省后，不会根据用户的身份或界面操作发生变化。
3. **浏览单位过滤条件**多是使用**动态条件**，会受到用户在界面上的操作影响，比如用户要切换查看不同状态下的数据，可以通过类似`xx状态 = 参数1`的条件达到目的，切换状态时可通过修改参数值来影响最终的过滤结果。

:::

## 填报明细数据{#detail-data}

**明细数据**是在**填报单位**下能自由增删的业务数据，比如填报单位的固定资产信息，每个单位下的固定资产都不一样，需要填报用户自行在各单位下去添加每个固定资产的信息，类似的情况下都需要启用**明细数据**。

![明细数据](./images/2024-03-06-13-34-01.png)

- **填报明细数据**：允许单位填报明细数据的开关设置，勾选后出现其他设置选项。
- **明细数据主键**：明细数据的主键字段，用于标识唯一的一条明细数据。以上述固定资产填报为例，需要设置固定资产ID为明细数据主键，设置的字段在提交数据时不允许为空。
- **数据浏览模式**：在查看数据时，明细数据列表以何种形式展示，分为**前后两级页面**和**左右分栏**两种形式。
  - **前后两级页面**：点击填报单位后，下钻到单位对应的明细数据列表，是单独的一个页面。
  - **左右分栏**：点击填报单位后，在右侧弹出该单位下对应的明细数据列表，填报单位列表与明细数据列表以左右分栏的形式展示在页面中。
- **明细数据整体上报**：所有明细数据总是以单位为整体来上报，当所有明细数据都通过校验时才允许单位上报数据。
- **允许提交空数据**：部分单位可能没有明细数据能够上报，此时允许这样的单位直接上报空数据代表该单位已上报数据。