字段映射

取值规则概述

可以大致分为两类：

1、通用规则：无特殊功能的普通属性基本都可以使用这类规则，例如单据联查、静态值、置空、DeepQL表达式；

2、预置规则：一些具有特殊功能的属性，我们为其提供了一些预置的取值逻辑，例如业务规则、引擎默认、借贷金额等。

每个字段支持使用的取值规则会受到字段编码和字段类型的影响。

例如我们认为journal_id字段是凭证模型的业务主键，会额外提供业务规则的类型，凭证行的journal_entry字段是与凭证头的关联字段，只能使用引擎默认规则，必须和凭证头的journal_id字段值相同。

因此，请勿随意修改预置凭证模型的属性，以免单据引擎在生成凭证时出现错误。

单据联查

等同于DeepModel中添加计算属性/链接的UI模式，请查看DeepModel对应文档：计算属性/链接 — 功能 | DeepFOS Docs

• 单据联查字段：选择需要取值的来源单据的字段，从来源单据模型的哪一层出发，取决于以下逻辑

  • 凭证头字段：从来源单据模型的主对象出发

  • 凭证行字段：在事件定义中配置的该分录行对应的【单据来源层级】，详见事件定义章节

• 计算类型：目前支持【查询】、【求和】、【计数】等常见计算

• 取负：若【单据联查字段】+【计算类型】得到的计算结果，是数值类型，支持对结果进行快速*-1的计算

【事件定义-单据来源层级】章节有详细案例，请至对应章节查看。

静态值

赋固定值，输入控件与该目标字段的类型有关，例如日期时间类型用日期时间选择框进行输入，枚举值类型用单选框进行选择。

部分类型还暂未支持静态值，可能会出现选择静态值取值规则后，未出现输入控件的情况，请暂时使用DeepQL表达式规则代替，后续迭代会逐步进行支持。

置空

默认的取值规则，表示该字段留空，无值。

DeepQL表达式

等同于DeepModel中添加计算属性/链接的QL模式，请查看DeepModel对应文档：计算属性/链接 — 功能 | DeepFOS Docs

适用于通过单据联查无法取得结果的情况，例如需要进行拼接、if条件判断等复杂计算情况，需要熟练掌握QL语言，请查看该语言的帮助文档：概述 — DeepQL查询语句 | DeepFOS Docs

例如下图中的简单示例，效果为：取来源单据主对象的code值，拼接随机uuid的后6位，用下划线拼接。

引擎默认

某些字段认为是凭证模型中具有功能的特殊字段，我们会通过对象层级+字段编码来识别这些字段，并为这些字段提供引擎默认的取值规则。

头.__source_key

此字段不是凭证模型中的字段，是单据引擎默认始终提供的字段，用于存储来源单据头表的业务主键，以关联来源单据和目标单据，是非常重要的关联字段，若有回写等需求都可以考虑使用此字段。

若后续提供凭证聚合功能，此字段可能是形似["key1", "key2"]的数组，请以您环境中当前版本的调试结果为准。

业务规则

目前仅为头.journal_id和行.line_id提供此规则。

可选择目标对象上配置的【数据新建保存前】的规则，若规则中使用到序列，单据引擎调试时不会占用实际序列，仅正式执行时占用序列。

如何配置对象上的业务规则，详见文档：业务规则与自增序列 — 功能 | DeepFOS Docs

本位币查询（暂未实现，是否需要实现待评估）

凭证头的实体的本位币，即头.entity.local_currency.code

借贷金额