金蝶BOS开发指南_BOTP
2.10 启用规则
BOTP转换规则定义完成后，必须“启用”后才能正常使用；启用成功后规则的状态会变更为”有效”:
要修改前，必须要“禁用”，禁用成功后规则的状态会变更为”无效”:
11 / 59
金蝶BOS开发指南_BOTP
2.11 执行单据转换
各个业务系统在单据对应的序时薄提供了各种单据转换入口, 如“单据转换”、“推式生成”、“拉式生成等”，如图：
通常会弹出规则选择界面， 点击”确定”后即可开始执行单据转换操作；
2.12 查看转换结果
如果单据转换规则定义了显示方式为“显示编辑界面”或“显示列表界面”，则转换完成后自动打开相应界面供用户查看，用户可根据需要编辑或保存/提交目标结果单：
12 / 59
金蝶BOS开发指南_BOTP
3 BOTP规则定义详解
3.1 规则列表界面
从菜单项”系统平台->单据转换->规则配置”可以进入规则列表界面
规则列表界面是左树右表结构, 左侧是各种单据分类树状列表, 右侧是当前分类下所有已定义转换规则列表:
界面上方有增/删/改查按钮, 还有启用、禁用、导入、导出、全部导出、多种单据生成凭证、规则比较等功能按钮，这些功能按钮具体使用请参考后续章节;
点击新增或选中某条规则点击修改将进入规则编辑界面;
13 / 59
金蝶BOS开发指南_BOTP
3.2 规则编辑界面
编码：手工输入，规则编码必须唯一，不能为空。 名称：手工输入，规则名称不能为空。
状态：启用为有效，禁用为无效。启用的规则可进行单据转换，禁用的规则不允许进行单据转换。 保存选项：可以选择保存方式，
“不报存” 表示不在服务端暂存；
“暂存单据”表示在单据转换完成后自动保存目标单；
“提交单据”表示单据转换完成后直接自动提交目标单， 目前暂时不开发使用。 显示选项：可以选择转换后显示方式，
“不显示目标单”表示转换完成后目标单不显示；
“显示编辑界面”表示在单据转换完成后自动打开目标单的编辑界面； “显示列表界面” 表示在单据转换完成后自动打开目标单的列表界面。 多次生成控制：可以选择当源单多次生成目标单时的控制方式
“允许多次生成并提示”表示如果已经生成过目标单时,允许转换，并提示用户；
14 / 59
金蝶BOS开发指南_BOTP
“允许多次生成但不提示” 表示如果已经生成过目标单时,允许转换，且不会提示用户；； “不允许多次生成” 表示如果已经生成过目标单时,禁止转换，并提示用户；。 附件转换设置：可以设置单据附件的转换方式
“单据头附件参与转换”表示源单的单据头上携带的附件会被转换到目标单； “单据体附件参与转换”表示源单的单据体上携带的附件会被转换到目标单；
编辑界面排序方式：设置目标单编辑界面排序字段， 只在显示选项设置为”显示编辑界面”时有效。
3.3 单据头属性设置
单据头属性部分列出了目标实体单据头的各项属性，可以对各个属性分别设置转换映射关系:
点击单据头属性对应的设置按钮可以进入设置界面:
界面分两个部分，既可以从源单实体及分录上选择相应的属性来作为转换源，也可以直接从值列表中选择固定值:
15 / 59