1 简介

1.1 功能介绍

①手动进行元素计算

②查询元素计算结果，包括手动计算结果和自动更新结果，元素自动更新的结果会自动存到元素仓库中，需要特别关注计算进程的，需要手动触发计算后才可在元素仓库中查询结果。

1.2 应用场景

税务元素实际上相当于一个取数模型，用户设置好取数规则后，可以通过计算引擎得到取数结果，存储下来的元素结果支持查看及其他模块的调用。

1.3 字段/按钮说明

按钮说明

1.4 元素计算原理

1.5 系统路径

【涉税数据管理】→【税务元素】→【元素仓库】

2 主要操作

2.1 查询元素结果

- 步骤1：进入元素仓库界面，找到目标数据，可通过过滤条件快速查找。

2.2 手动计算元素

- 步骤1：进入元素仓库界面，点击<元素计算>按钮，打开计算弹窗。

- 步骤2：选择元素计算范围。在弹窗内选择元素、计算时间、组织范围，再点击<计算>按钮即触发元素的计算。

- 步骤3： 界面显示“计算成功”的提示后，可返回元素仓库列表查看计算结果。

2.3 新增底层元素的取数数据源

2.3.1 前提条件

用户在配置底层元素选择数据源，相当于存储数据的实体单据。在产品的不断更新迭代下，税务云会持续预置使用频率较高的数据源，达到用户开箱即用的效果。

但是各企业的业务流程、单据存储方式、或数据需求千差万别，预置的数据源没有办法满足所有业务场景，因此当出现基于特殊数据源计算元素时的场景，用户需自行添加数据源，将除系统预置范围外的单据纳入到元素计算范围内，实现不同企业对元素计算的自定义业务诉求。（详情请参考“自定义数据源”说明）

2.3.2 操作步骤

- 步骤1：进入自定义数据源界面。系统路径：【基础设置】→【数据源配置】。

- 步骤2：左侧分类下选中【元素抽检】，并点击“新增”按钮。

- 步骤3：在新增界面内，输入业务名称（即新增数据源名称），并选择实体和子实体（即实体表单数据源），所有通过自定义新增的单据都会归类到“表类型=自定义”下。确定实体表单后，点击“生成“按钮，即可配置表单的适用字段。

当表单有关联子单据时，将会自动带出子实体共选择。

参数开关配置注意事项：组织字段和时间字段的开关需要放在主实体上，否则会导致元素计算时无法找到对应的组织或属期。

- 步骤4：保存自定义数据源后即可在元素配置界面选到相关数据源。

3 特别关注

由于元素配置工具的灵活性，元素根据计算周期、取数方式、时间偏移、上下层级的嵌套等等不同维度组合出多样化的计算场景，使得元素计算变得复杂，因此为了方便元素结果的存储，会对一些特殊场景做处理，接下来的内容将对这些特殊场景做具体阐述。

3.1 元素结果显示为“无数据”

基于正常情况，元素计算引擎根据配置好的规则进行取数，并且记录计算结果，但当以下集中场景出现时，会影响元素的正常计算，导致无法正常取数，因此在元素结果中会记录为“无数据”，以表示元素计算的异常。

① 未找到满足条件的数据，则在元素结果中显示为“无数据”。主要有以下两种情况：

其一，底层元素对应的数据源在当前计算属期下没有产生业务数据，因此元素没有办法取到数。举例：底层元素的计算周期为月度，取增值税申报表的应补退税额，现在计算2021年6月份的数据，但在增值税申报记录中，并没有生成2021年6月份的申报数据，则该元素无法取数，结果显示为“无数据”。

其二，底层元素对应的数据源在当前计算属期下产生了业务数据，但通过元素配置的过滤条件无法找到匹配的数据。举例：底层元素的计算周期为月度，取财产行为税申报表的印花税应纳税额，现在计算2021年6月份的数据，在财行税申报记录中，已经生成2021年6月份的申报数据，但当期未申报印花税，因此该元素也无法取到2021年6月份的印花税数据，结果显示为“无数据”。

② 属期不对，业务数据的属期止没有落在取数属期内。

根据元素计算的逻辑，计算周期+取数方式+时间偏移量确定元素最终的取数时间范围，在计算的第一步，会拿着取数时间范围和数据源的时间参数做匹配，过滤出部分数据。

举例：底层元素的计算周期=月度，取数方式=取最后一个月，时间偏移量=0，取企业所得税季报中的本期应补退税额，数据源的时间开关开启为“税款所属期止”字段，现在计算2021年3月的元素，若已生成申报表则可以正常计算出元素结果。但是，如果现在计算2021年1月或2021年2月的元素，则元素结果永远是“无数据”，因为数据源的时间参数开关是通过税款所属期止做匹配的，则对于季报来说只有计算时间是季度最后一个月的元素才能正确取到数，其余计算时间都无法匹配数据源时间。

③ 表达式的特殊处理。

复合元素的计算是基于元素的表达式，在计算的时候会将表达式中引用的元素全部拆解至底层元素，因此在表达式中会存在多种情况，简单归类，当拆解后的表达式出现以下两种情况时，则计算结果显示“无数据”。

其一，拆解后的表达式为除法，且除法运算中的分母为0或null。举例：复合元素C=A/B，当B=0 or null时，C=null。

其二，拆解后的表达式为加减法，但构成表达式的每一项元素结果都为null（注意：在加减运算中，只要其中一个元素有值，则继续运算，其余的null都当做0处理）。举例：复合元素C=A+B+E/F，若A=null，B=null，E=10，F=null，则C=null；若A=100，B=null，E=10，F=null，则C=100。

3.2 元素结果计算时间

元素在存储计算时间的时候，会存储自上而下顶点元素或者风险指标传递下来的计算时间，这样方便于后续元素的溯源查询，因此元素的计算时间并不完全代表业务意义上的元素属期。当一个元素未被其它计算周期的元素使用时，则计算时间的跨度等于元素的计算周期；但当引用元素的计算周期和元素本身不一致时，计算时间的跨度和元素本身计算周期不一致，而是和顶点元素或风险指标的计算周期一致。

举例：如下图，元素103的计算周期=半年度，但计算时间的跨度是月度，是因为该元素被一个计算周期=月度的顶点元素引用过。