前言

本篇文章的目标是让实施能看懂数据源，并能开始尝试简单的配置修改。

若需要全面了解数据源的实现方式并进行开发，可查看相关文章。

相关文章链接：

预设数据源

http://tmpbbs.ztc.ztccloud.com.cn:6875/article/1282810

http://tmpbbs.ztc.ztccloud.com.cn:6875/article/1272356#head3

台账预设数据源

http://tmpbbs.ztc.ztccloud.com.cn:6875/article/1134631#head8

主数据

http://tmpbbs.ztc.ztccloud.com.cn:6875/article/1196213

字段引用数据源

单据字段

单据字段引用数据源，要在【基础数据-表单配置-表单字段】界面编辑对应字段，根据“字段类型”会展示不同的“数据源类型”可选项：

单选/多选弹出选择框：主数据、预设数据源
单选下拉选择框：预设数据源、系统编码
多页签：预设数据源
输入弹出框：预设数据源

台账字段

台账字段引用数据源，要在【基础数据-台账配置-字段配置】界面新增对应字段，根据“字段类型”会展示不同的“数据源类型”可选项：

单选弹出选择框：主数据、维度管理、预设数据源
单选下拉选择框：预设数据源、系统编码

1. 预设数据源

预设数据源是目前单据字段引用最多的数据源类型，也是由开发自行定义的数据源。因每个预设数据源的使用场景、调用接口、开发思路不同，所以实施需要自行鉴别其是否适用当前场景。

1.1. 如何查看

字段引用数据源如何查看

当单据字段、台账字段等配置界面，展示字段数据源类型为“预设数据源”时，可以根据数据源名称，在【配置平台-系统管理-预设数据源】界面进行搜索查找。

【预设数据源】界面中即可查看到具体数据源信息，点击“格式化”即可清晰的查看到所配置JSON。

预设数据源根据不同的接口请求类型，还分为requestUrl、lovKey、fastCode、ajax、other，以下表格是根据不同类型，用来辅助实施理解数据源内容：

requestUrl

内容	子内容	解释
requestUrl		接口地址
labelCode		数据源内容展示编码，对应所选数据返显在字段上的内容，一般为名称
rowKey		主键编码
fieldSet		用于定义id、code、name对应编码，无需关注
trans		接口赋值内容，仅支持同一区域（from为接口返回参数编码，to为赋值字段编码）
nextField		接口赋值内容，可赋值到其他区域（赋值字段编码前需要有区域编码）
config		选择弹窗的配置属性
config	field	弹窗字段列展示顺序、内容（"show"为false则不展示）
	query	弹窗查询字段展示顺序、内容
	autoQuery	是否允许回车查询，Y/N
	isShowFavorites	是否允许收藏，Y/N
	singleGrid	是否单选，Y/N
prev		前置条件字段，结合单据使用
static/params		默认前置条件
extendConfig		拓展配置
importCode		导入参数
ledgerConfig		用途为“台账”时才会有的配置，用于自定义台账，逻辑可查看相关文章《台账预设数据源》

lovKey

内容	解释
lovKey	接口地址（部分配置是sql写死的，无法修改）
labelCode、fieldSet、trans、prev等	参考requestUrl

fastCode（可以视为直接引用系统编码）

内容	解释
labelCode	数据源内容展示编码，对应所选数据返显在字段上的内容，一般为名称
fastCode	引用【系统编码-全局编码】的数据编码

ajax（已弃用）

ajax类型主要用于“输入弹出框”字段类型，只存在于历史版本配置。

内容	解释
ajax	接口地址
labelCode、prev等	参考requestUrl

以引用“附加区-供应商-核算主体-默认账户”预设数据源的附加区“供应商”字段为例：

{
	"labelCode": "vendorName",
	"fieldSet": {
		"id": "vendorId",
		"code": "vendorCode",
		"name": "name"
	},
	"prev": {
		"groupId": "boeHeader.groupId",
		"leId": "boeHeader.leId"
	},
	"nextField": {
		"vendorId": ["zfsBoePayments.vendorId", "boeHeader.vendorId"],
		"vendorName": "zfsBoePayments.vendorName",
		"subBank": "zfsBoePayments.bankBranchName",
		"unitedCode": "zfsBoePayments.bankUnitedCode",
		"pubPriCode": "zfsBoePayments.pubPriCode",
		"bankAccount": "zfsBoePayments.bankAccountNum",
		"bankAccountName": "zfsBoePayments.bankAccountName",
		"vendorAccountName": "zfsBoePayments.vendorAccountName",
		"vendorCodeName": "zfsBoePayments.vendorCodeName",
		"bankAccountId": "zfsBoePayments.bankAccountId"
	},
	"trans": [{
		"from": "vendorId",
		"to": "vendorId"
	}, {
		"from": "vendorCode",
		"to": "vendorCode"
	}, {
		"from": "name",
		"to": "vendorName"
	}, {
		"from": "subBank",
		"to": "subBank"
	}, {
		"from": "bankAccount",
		"to": "bankAccount"
	}, {
		"from": "bankAccountName",
		"to": "bankAccountName"
	}, {
		"from": "pubPriCode",
		"to": "pubPriCode"
	}, {
		"from": "unitedCode",
		"to": "unitedCode"
	}, {
		"from": "taxNumber",
		"to": "sellerNumber"
	}, {
		"from": "vendorAccountName",
		"to": "vendorAccountName"
	}, {
		"from": "vendorCodeName",
		"to": "vendorCodeName"
	}, {
		"from": "bankAccountId",
		"to": "bankAccountId"
	}],
	"lovKey": "",
	"rowKey": "id",
	"requestUrl": "base/vendors/findVendorsOneBankByLeId",
	"config": {
		"autoQuery": "Y",
		"field": [{
			"code": "name",
			"label": "供应商名称"
		}, {
			"code": "vendorCode",
			"label": "供应商编码"
		}, {
			"code": "vendorTypeName",
			"label": "类型"
		}],
		"query": [{
			"code": "name",
			"label": "供应商名称",
			"type": "text"
		}, {
			"code": "vendorCode",
			"label": "供应商编号",
			"type": "text"
		}],
		"singleGrid": "Y"
	},
	"static": {
		"vendorTypeStr": "002^005"
	}
}

根据数据源配置，可以从中内看出

1.字段查询接口为”base/vendors/findVendorsOneBankByLeId”（实际查的什么表需自行推断或开发确认），适用的字段为vendorId，展示名称的字段为vendorName，单选弹窗中展示“供应商名称”、“供应商编码”、“类型”列，查询区中展示“供应商名称”、“供应商编号”字段。

2.弹窗内默认只展示“vendorTypeStr”（客商类型）为002（供应商）、005（供应商/客户），且符合单据内“boeHeader.groupId”（头表区的集团id）和“"boeHeader.leId”（头表区的核算主体id）的数据。

（再根据配置经验与数据比对，最终可以判断出弹窗内展示的实际数据为：【基础数据-业务类型-客商数据】界面中，当前集团下“客商类型”为供应商或供应商/客户，“是否全局客商”为是或“是否全局客商”为否且“分配核算主体”包含单据“核算主体”的有效数据）

3.当选择弹窗数据后，会触发对同区域vendorId、vendorCode、vendorName、subBank、bankAccount、bankAccountName、pubPriCode、unitedCode、sellerNumber、vendorAccountName、vendorCodeName、bankAccountId字段的赋值；同时给boeHeader（头表区）的vendorId和zfsBoePayments（支付区）的vendorId、vendorName、bankBranchName、bankUnitedCode、pubPriCode、bankAccountNum、bankAccountName、vendorAccountName、vendorCodeName、bankAccountId字段赋值（即使单据上不存在此字段，也会赋值）

单据内字段引用数据源如何查看

当单据配置绑定字段后，单据字段的数据源与表单字段的数据源将会脱节，即使此时修改表单字段数据源内容，也不会影响已配置的单据。（“存储类型”属性除外）

查看单据字段引用的数据源，首先要点击字段查看【基本】界面：

1.字段编码：表示该字段的实际存储内容，通常会在trans参数中赋值id或code。

2.字段类型：只有名字中包含“选择框”或“多页签”的字段类型，才会用到数据源，字段类型也代表了点选时的效果。

3.数据源类型：表示该字段所引用的数据源类型，数据源类型无法随意变更。

4.数据源：展示字段所选择的数据源名称，可以根据类型+名称定位到数据源配置。

确定基本的数据源信息后，接下来要查看【高级】界面：

1.字段归类：展示字段值存储的位置，区别见链接：

http://tmpbbs.ztc.ztccloud.com.cn:6875/faq/1388204

2.扩展配置：当字段扩展配置内有内容时，优先看配置里面的内容，如果存在数据源的相关配置，以此配置为准。

当不存在相关扩展配置后，再查看【数据源】界面，默认是取绑定字段引用数据源的内容：

1.展示编码：预设数据源的labelCode参数，通常会在trans参数中赋值name。

2.前置字段：该字段的前置字段，会取单据字段值作为查询条件。

3.后置字段：预设数据源的nextField参数。

4.字段转换：预设数据源的trans参数。

5.LOV接口：通常是请求接口。

6.LOV配置：预设数据源的config参数。

其他字段待后续补充

1.2. 如何修改

实施可修改内容

当修改不涉及新的内容、赋值逻辑时，实施可以通过【预设数据源】界面微调JSON进行配置（修改后需要重新在模板内绑定才生效），也可以直接在【单据配置】的字段上修改数据源相关配置。

建议不要修改已有预设数据源，配置尝试可以在【预设数据源】界面进行新增。

需开发修改内容

当涉及到数据源展示内容扩大/减少、需要更多赋值内容时，得先咨询研发确认调用接口是否支持，如不支持即使配置也不会生效，需要更换接口或进行开发。

如：目前接口只能查出员工基本信息，实施希望弹窗内同时展示员工主岗、兼岗信息，并将所选部门负责人编码赋值到单据上，这种要求是无法直接修改配置实现的。

修改常见场景（持续更新）

常见场景1：

项目希望在单据上再新增一个引用现有预设数据源的字段，直接引用后会发现单据字段虽然能正常选择，但选择/保存后字段还是空的。

配置思路：

预设数据源与字段编码高度绑定，每个字段编码引用同一个预设数据源，都需要单独配置。

以财务组织的全量数据源为例，一定要修改内容将进行说明：

{
	"labelCode": "name",（修改为展示的字段编码，如spareS3Name）
	"requestUrl": "base/fulecc/page",
	"trans": [{
		"from": "id",
		"to": "id"（修改为存储的字段编码，如spareS3）
	}, {
		"from": "fuType",
		"to": "fuType"
	}, {
		"from": "fuTypeName",
		"to": "fuTypeName"
	}, {
		"from": "name",
		"to": "name"（修改为labelCode参数，如spareS3Name）
	}],
	"config": {
		"isShowFavorites": "N",
		"autoQuery": "Y",
		"singleGrid": "N",（通常只支持单选，Y）
		"query": [{
			"code": "code",
			"label": "编码",
			"type": "text"
		}, {
			"code": "name",
			"label": "名称",
			"type": "text"
		}],
		"field": [{
			"code": "id",
			"label": "ID",
			"show": false
		}, {
			"code": "code",
			"label": "编码"
		}, {
			"code": "name",
			"label": "名称"
		}, {
			"code": "fuType",
			"label": "类型",
			"show": false
		}, {
			"code": "fuTypeName",
			"label": "类型"
		}, {
			"code": "pShowName",
			"label": "上级名称"
		}]
	}
}

常见场景2：

项目希望将已经赋值给字段A的值改为赋值给备用字段spareS1。

配置思路：

已经明确可以赋值的内容，只需要修改trans参数即可，也可以直接修改单据字段转换配置。

from参数一般不变，to参数填写单据赋值字段编码。

常见场景3：

项目希望修改字段弹窗字段展示顺序、列名称、展示收藏按钮。

配置思路：

修改预设数据源的config参数即可，对于收藏、多选功能，还需检查接口是否支持。

1.3. 全量数据源

全量数据源是指，【预设数据源】界面中“用途”为全量的数据源，此类数据源是用来解决配置端在配置条件时，希望选择全量数据而不是填写id的场景。

全量数据源会预制到字段上，如果字段没有配置，也可以自行绑定上相应的数据源。

在【配置平台】引用字段进行条件配置时，有时会遇到“无法获取数据，请在字段配置中绑定数据源或全量数据源”的错误提示语，这就表示该字段引用了预设数据源，且没有配置对应的全量数据源。

1.4. 特殊场景

此处会梳理一些特殊的系统逻辑，预设数据源配置并不会对相关功能产生影响，包括：

1.单据初始化

单据在初次打开时，会调用”initBoePage”接口进行初始化的赋值，对于被初始化赋值的字段（也就是预制字段），已经定义好了字段编码的用途，这部分字段是不建议做很大调整的。

2.单据申请人

单据的申请人字段，修改后会刷新整个填单界面，重新触发初始化单据，申请人字段上配置的赋值逻辑并不会生效。

3.字段默认选项

单据字段数据源类型为预设数据源时，若配置默认值，会选择默认数据的code进行查询、赋值；若配置默认变量，会根据变量数据的id进行查询、赋值，如果预设数据源不支持id查询，则需要先进行接口支持。

4.关联微服务字段

单据的关联合同、关联申请字段，以前是通过预设数据源进行的实现，如果有个性化需求，可以直接在【高级】进行“关联合同配置”、“关联申请配置”来实现，无需修改预设数据源。

2. 主数据

2.1. 如何查看

字段引用数据源如何查看

单据字段、台账字段等配置界面，展示字段数据源类型为“主数据”时，可以根据数据源名称，在【公共数据】、【基础数据】界面进行查找，也可查看文档：

https://doc.weixin.qq.com/sheet/e3_AX8AvAa4AOkEQOrYwfOToqGigyo18?scode=AAcAMQcyAAoU1bdtnWAX8AvAa4AOk&tab=BB08J4

【数据模板】界面，可以查看可配置的预制主数据、自定义主数据的模板信息，点击模板可查看字段信息。

单据内字段引用数据源如何查看

因主数据数据源的引用方式是完全配置化的，这里只对单据内可配置内容进行简单描述，具体功能使用可查看配置手册或全量文档。

点击字段查看【基本】界面，可以看到“数据源类型”为主数据：

主数据的可配置功能，都在【数据源】界面：

1.数据查询区域：用于对主数据进行关联表查询，默认只查主表信息（如：员工主数据可配置联查银行、岗位明细信息）。

2.数据源范围：用于过滤查询范围，可以设置单据关联条件和默认过滤条件。

3.弹窗设置：用于控制选择弹窗展示、查询字段，查询区域的字段都可以设置展示。

4.关联赋值：用于赋值同区域、跨区域的单据字段。

2.2. 如何修改

主数据功能全部通过配置化实现，实施可以直接进行修改，若配置无法支持，则只能提需求进行优化。

2.3. 特殊场景

部分主数据会存在历史特殊逻辑，会影响到配置正常使用：

1.微服务间用编码交互的主数据

主数据默认在引用字段上存储id，但城市数据、币种管理、维度管理等主数据，微服务间是通过code传输，配置时需要将code赋值到其他字段上进行引用。

2.只使用明细信息的主数据

主数据默认是存储主表区数据的id，但科目体系、维度管理等主数据，重要数据其实在明细区，需要存储明细区数据id，所以配置引用数据源时，需要选择名称有“明细”的数据源。

3.预设数据源能否切换成主数据

有时会遇到引用预设数据源的字段不满足使用场景，希望切换成主数据的情况。

是否能够切换，得检查主数据配置能否满足原预设数据源实现效果，如果存在跨多表查询、特殊赋值等逻辑，则无法直接在字段上修改，建议通过“联动赋值”功能去进行适配。

“联动赋值”功能可参考文档：

http://tmpbbs.ztc.ztccloud.com.cn:6875/faq/1288556

注意：目前发现需要进行接口同步的单据，预制字段不能切换为主数据，否则会导致单据无法成功同步，待后续优化

3. 系统编码

3.1. 如何查看

字段引用数据源如何查看

单据字段、台账字段等配置界面，展示字段数据源类型为“系统编码”时，可以根据数据源名称，在【系统管理-系统编码-全局编码】界面进行查找。

【全局编码】界面，排除“全部”的顶层为编码分类，下一层为选项内容。

单据内字段引用数据源如何查看

引用系统编码的字段没有可修改项，点击字段查看【基本】界面，可以看到“数据源类型”为系统编码：

4. 维度管理

4.1. 如何查看

字段引用数据源如何查看

单据字段、台账字段等配置界面，展示字段数据源类型为“维度管理”时，可以根据数据源名称，在【基础数据-业务数据-维度管理】界面进行查找。

【维度管理】界面，只有“维度用途”包含字段配置的维度，才支持被单据、台账字段引用，且一般“维度类型”都为自定义。

自定义维度所展示数据的维护，点击操作列“成员管理”按钮。

单据内字段引用数据源如何查看

引用维度管理的字段也没有可修改项，点击字段查看【基本】界面，可以看到“数据源类型”为维度管理：

4.2. 特殊场景

【维度管理-成员管理】界面的“父级”、“核算主体”字段，在实际使用时并没有相关过滤逻辑，目前希望支持过滤可通过主数据实现，可参考文档：

http://tmpbbs.ztc.ztccloud.com.cn:6875/faq/1369177

实施数据源配置引导

实施数据源配置引导

关于作者

目录