方案配置¶

方案配置主要配置单据对接的条件，例如取什么状态的数据、是否需要过滤、是否将获取到的数据进行加工处理、将哪些数据写入目标单据...等

源平台¶

源平台配置为数据来源配置，配置相应的条件来获得想要的数据

基础资料的配置¶

基础资料主要配置源平台单据主键，和执行策略配置

主键配置

主键为当前单据数据字段中有唯一标识作用的字段，通常用于保证每条数据的唯一性，避免数据重复；每个单据系统会默认主键字段，正常情况下不需要进行修改。

如需修改点击“编辑”图标，从下拉选项中选择其它字段。

执行策略配置

执行策略为源平台执行时间设定，可可循环周期执行，请根据场景在保证满足需求的情况下，设定合理的执行时间。

时间设定根据周、月、日、时、分的顺序依次从最大单位向下设定。例如：

请参考以上设定示例，设置合适的时间。

请求参数的配置¶

请求参数为获取当前单据数据所支持的条件设置，每个单据所支持的请求参数是不一样的。

从右上角的模板选择中选择需要的条件

在每个参数的右侧点击编辑按钮，进行请求参数的值设置

格式化与设置值的函数功能类似，为可选配置，使用函数方法改变值的格式，也支持多次使用。这样设计使值的配置规则更新清晰

设置的配置¶

设置为满足各对接场景单独开发的一些功能设置，每个不同的平台或单据的设置内容是不一样的，每个功能设置可参考对应的描述来理解。

在源平台的设置更多是

1. 辅助查询更多关联数据
2. 数据量大时分进程处理

等信息，可在具体实施时了解使用。

事件处理的配置¶

事件处理为相应的事件前后执行更多处理，满足场景多样化需求。目前在源平台支持数据拉取成功后进行相应的数据过滤操作，和自定义脚本开发。

数据过滤在拉取数据成功后的事件处理中

内置事件处理器 - 符合条件保留数据

满足设定的条件保留数据

上图框中的设置项仅针对有判断明细条件时的处理

可以根据获取数据的字段来设定对应的过滤条件，来保留合适的数据。支持或者和并且条件多次使用。

例如：上图中的条件为备注的开头为“同步”的保留数据，其它数据丢充，这样可以做到可控同步，只需在备注的开头中写上“同步”，系统会自动进行同步。

内置事件处理器 - 符合条件舍弃数据

满足设定的条件舍弃数据

可以根据获取数据的字段来设定对应的过滤条件，来舍弃不需要的数据。支持或者和并且条件多次使用。

例如：上图中的条件为备注的开头为“不同步”的舍弃数据，其它数据保留，这样可以做到可控同步，只需在备注的开头中写上“不同步”，系统会自动进行丢弃，其它数据进行同步。

数据加工¶

目标平台¶

目标平台配置为数据写入目标配置，配置相应的写入参数和条件将数据写入目标平台的单据

基础资料的配置¶

基础资料主要配置目标平台单据执行策略

执行策略配置

执行策略为目标平台执行时间设定，可循环周期执行，请根据场景在保证满足需求的情况下，设定合理的执行时间。

时间设定根据周、月、日、时、分的顺序依次从最大单位向下设定。例如：

请参考以上设定示例，设置合适的时间。

写入参数的配置¶

系统会自动加载写入单据必传的字段，正常情况下只需设置每个参数的值即可，如果需要其它参数可从右上角的从模板选择中选择需要的传入参数。如模板中也不存在的参数，可以从右上角的添加参数设定自定义的参数。

在每个参数的右侧点击编辑按钮，进行写入参数的值设置

数据转换

• 如果需要将得到的值进行转换，可以在数据转换下拉选项选择对应的转换关系。
• 数据转换配置请参考 数据转换 文档进行设置。
• 下图示例是将源平台单据的店铺编号根据配置的数据转换旺店通店铺与金蝶组织转换成金蝶的组织，然后写入金蝶的单据。

格式化与设置值的函数功能类似，为可选配置，使用函数方法改变值的格式，也支持多次使用。这样设计使值的配置规则更新清晰

设置的配置¶

设置为满足各对接场景单独开发的一些功能设置，每个不同的平台或单据的设置内容是不一样的，每个功能设置可参考对应的描述来理解。

在目标平台的设置更多是

1. 写入失败的重试次数
2. 针对金蝶的是否自动提交审核
3. 每进程执行数量
4. 其它一些处理机制

等信息，可在具体实施时了解使用。

事件处理的配置¶

事件处理为相应的事件前后执行更多处理，满足场景多样化需求。目前在目标平台支持数据写入成功后、数据写入异常后等事件，然后选择内置处理器或自定义脚本开发进行后续处理。事件可以设置多个，系统将按顺序执行。

内置事件处理器 - 调用接口

主要用于在写入成功异常后，反馈信息给指定方。广泛用于写入成功后调用源平台告知已同步成功，或写入异常后调用其它OA、移动办公平台等平台通知相关人员。

调用接口的相关设置与源平台的请求参数配置相似，可参考源平台的请求参数相关配置进行设置。

方案调试¶

方案配置完成后，需进行调试，查看数据获取是否正确，数据写入是否成功，写入的数据是否正确，执行策略是否合理。

在方案详情页，展开方案详细信息，可以看到拉取来源，执行目标操作按钮。

先执行拉取来源来获取数据

  点击拉取来源后，系统会先执行源平台配置来获取数据。在下面的执行记录标签页，可以看到来源类型的执行记录，执行记录展示执行时间、状态和结果数据；结果中展示执行耗时、拉取的数据量等信息。

  如状态为失败，结果将显示失败原因，实施人员可据此排查原因。

  点击执行记录右侧的查看执行明细，可以查看当次执行记录的执行过程，包括解析后的请求参数、每次获取的数据量、数据加工过程...等信息。

  如我们获取到的数据不符合我们的要求，可以在明细中找到开始请求类型的执行内容，从中排查系统根据配置解析出的请求参数值是否符合要求。

再执行执行目标来写入目标

  点击执行目标后，系统开始执行目标平台配置，将源平台获取到的数据写入目标平台。在下面的执行记录标签页，可以看到目标类型的执行记录，执行记录展示执行时间、状态和结果数据；结果中展示执行耗时、同步的数据量等信息。

  如状态为失败，结果将显示失败原因，实施人员可据此排查原因。

方案启用/停用¶

方案调试完成后，确认数据正确获取和正确执行后，即可开启方案。方案开启后，系统将按照执行策略循环执行。

方案配置原则¶