金蝶BOS开发指南_BOTP
点击【
】，增加一行条件。点击【
】，删除一行条件。点击【
】，清空过滤条件。注意：如果有多行
过滤条件，行之间要用逻辑符将这些条件连起来。
数据过滤主要是影响实际执行单据转换过程时的源单据对象集合, 不满足过滤条件的源单据对象/分录将被过滤掉, 只有满足条件的对象/分录才参与单据转换;
如果单据头不满足数据过滤条件, 那么整张单据都不参与单据转换;
如果单据分录不满足数据过滤条件, 那么该分录对象不参与数据转换; 注意其它满足条件的分录对象还是可以正常参与单据转换的;
转换过程中如果目标实体上的字段映射了被过滤掉分录上的属性, 则该字段可能被转换为字段数据类型的默认值, 如Null或 空字符串等;
3.13 规则复制
很多时候单据转换规则是大致相同的，为了减少重复录入的工作量，BOTP提供转换规则复制功能， 在单据查看状态可以点击“复制”按钮，以实现对当前规则的复制；
复制完成后规则的名称及编码自动加上”Copy”以示区别，对复制规则的修改不影响原转换规则；
26 / 59
金蝶BOS开发指南_BOTP
3.14 规则导入导出
BOTP提供对任意规则导入和导出的功能，可以将BOTP转换规则导出为文件，也可以从BOTP文件中导入规则； 3.14.1 规则导出
选中一条或多条转换规则后，点击界面上方的”导出”按钮, 将弹出导出选项界面:
可以选择是合并导出还是逐个导出：如果是合并导出的话，选择的所有文件会合并导出到一个XML文件；如果选择逐个导出的话，则可以选择是导出为一个JAR文件还是同一目录下的多个XML文件； 3.14.2 规则导入
点击界面上方的”导入”按钮, 将弹出导入界面， 在界面上选择后缀名为XML文件再点击打开即可完成导入:
如果待导入的转换规则与已有规则名称编码重复，则会出现提示框确认:
27 / 59
金蝶BOS开发指南_BOTP
3.15 规则比较
BOTP提供对任意两个规则进行比较的功能，通过规则比较可以快速的定位两个规则间的差异，方便修改和维护； 规则比较要求必须是相同类型的单据转换规则之间才可以进行比较；
首先选择一条待比较的单据转换规则，然后点击界面上访的”规则比较”按钮:
在弹出的选择框中选中待比较的转换规则文件，点击“打开”可进入规则比较界面，系统会分页签将两个规则间不同的地方展示出来以便查看:
28 / 59
金蝶BOS开发指南_BOTP
3.16 扩展属性设置
BOTP依赖目标单据实体上的一些扩展属性，引擎会根据实体上属性的扩展属性来执行相应的逻辑判断；例如该属性是否参与转换规则定义，或者是否应该参与反写等； 3.16.1 isForMapping
该扩展属性指定实体属性是否作为目标单据参与BOTP映射, 默认值为False ; 当该属性被设置为True(真)，则该属性会出现在BOTP规则定义界面中；
3.16.2 isForMatching
该扩展属性指定实体属性是否作为目标单据参与BOTP核销, 默认值为False ; 如果设置为True,则该属性会出现在BOTP规则定义的核销反写页签; 只有isForMapping为true的属性,才可以将该属性设置为true;
3.16.3 isForGrouping
该扩展属性指定实体属性是否作为目标单据参与BOTP分组合并, 默认值为False ;
如果设置为True,则该属性会出现在BOTP规则定义的分组合并页签; 只有isForMapping为true的属性,才可以将该属性设置为true;
29 / 59
金蝶BOS开发指南_BOTP
3.16.4 isForWrittenBack
该扩展属性指定实体属性是否作为目标单据参与BOTP反写, 默认值为False ; 如果设置为True, 则该属性会出现在BOTP反写规则界面;
3.16.5 isBotpMustInput
该扩展属性指定实体属性是否为BOTP规则必录项, 默认值为False ;
如果设置为True, 则在录入BOTP规则时, 要求该属性必须要录入相应的映射规则,否则规则无法启用;
3.16.6 isDelRelationsWithoutEntries
该扩展属性指定是否在删除所有BOTP分录后, 同时删除单据间的BOTP关系, 默认值为False ;
如果设置为True, 而实体为目标单据且保存/提交目标单据时会检查, 当与某张源单相关联的所有BOTP分录都已经删除时, 则同步删除目标单与该源单之间的BOTP关联关系; 否则不删除, 仍然保留单据间的关联关系;
30 / 59