操作服务插件—金蝶云星空金蝶云星空生态与平台开发支持部Content0102插件注册调试常用事件介绍单据转换插件03搭建开发环境选择对应的安装版本和环境进行本地开发环境的搭建，用于二开效果展示以及代码调试插件开发—创建工程新增服务插件工程新增操作服务插件插件开发—启用插件插件编写完毕，类库编译通过后进入BOS设计器，打开操作列表，配置操作服务插件。启动开发环境，调试启动开发环境，业务站点运行在IISExpress上，附加进程为：iisexpress.exeContent0102插件注册调试常用事件介绍单据转换插件03案例一：采购订单提交失败-未录入供货方地址采购订单提交时，检验是否已录供货方地址，未录则提交失败数据加载说明：OnPreparePropertys事件：加载指定字段到实体中，因为我们加载的时候只取到部分重要的数据包，可能一部分数据没加载进去业务说明：把字段单据编号和供货方地址加载到实体中OnAddValidators事件说明：1.OnAddValidators事件：操作执行前去校验，可以自定义数据校验器2.自定义校验器派生:AbstractValidator重写Validate方法3.ValidateContext：检验上下文业务描述：校验单据供货方地址，必须录入，否则不允许提交；案例二：采购订单保存后，检验采购订单保存时，检验单据体中的交货日期是否小于单采购日期有则弹出提示，保存失败BeforeExecuteOperationTransaction事件说明：BeforeExecuteOperationTransaction事件：通常将一些与数据更新无关的前期数据准备，放在本事件中进行，以减少事务占用时间。操作执行前，事务开始前事件1.此事件在操作校验之后、操作实现代码之前执行2.此事件在操作事务之前，即此事件中的数据库处理，不受操作的事务保护3.通常此事件，也可以用来进行数据校验业务描述：采购订单保存，数据检验，不通过弹出提示，同时保存失败案例三：采购订单审核后更新采购价目表采购订单审核之后根据单据体中物料的含税单价去更新采购价目表中对应的物料的价格采购价目表数据修改采购价目表原采购价目表新EndOperationTransaction事件说明：EndOperationTransaction事件：操作执行后（事务内）事件，在操作处理完毕，未提交事务前触发。此事件在事务内，对数据库进行的更新，受事务保护。此事件适合于在操作执行完毕，单据数据已经更改，需要基于更改后的数据，进行其他关联数据的处理。业务描述：采购订单审核后，更新采购价目表案例四：采购订单审核后生成收料通知单AfterExecuteOperationTransaction事件说明：操作执行后，事务结束后1.此事件在操作执行后，操作的内部逻辑已经执行完毕；2.此事件在操作事务提交之后；3.此事件中的数据库处理，不受操作的事务保护4.通常此事件，也可以做同步数据，但是此同步数据的成功与否，不需影响操作业务描述：采购订单审核后，自动生成下游单据收料通知单扩展-收料部门必录采购订单审核成功，但并不能生成收料通知单收料部门设置为必录后，代码中未设置收料部门的值，所以不能生成收料通知单，但是采购订单还是审核成功案例五：采购订单反审核删除收料通知单采购订单反审核删除下游单据收料通知单，如果收料通知单已审核，则采购订单反审核失败去掉标准产品下游单据关联检验本案例反审核要删除下游单据，所以先暂时停用标准的反审核订单已有下游单据关联，不允许反审核！的操作事件收料通知单已审核状态采购订单反审核失败当收料通知单已审核的时候，采购订单反审核失败收料通知单为创建状态反审核采购订单采购订单下推生成的收料通知单被删除BeginOperationTransaction事件说明：操作执行前，事务开始后事件1.此事件在操作校验之后2.此事件在操作事务开始之后3.此事件在操作执行代码之前4.此事件中的数据库处理，受操作的事务保护5.通常此事件，可以用来做数据准备，在操作之前，提前写数据到库业务描述：采购订单反审核，删除下游的收料通知单，如下游的收料通知单已审核，删除失败，则采购订单不能反审核OnPrepareOperationServiceOption事件操作初始化时，确认操作执行参数Content0102常用事件介绍单据转换插件03插件注册调试单据转换主要事件OnQueryBuilderParemeter：解析字段映射关系，并构建查询参数。这里可以加入你想要的字段OnAfterCreateLink：创建关联关系后事件OnFieldMapping：下推/选单时，根据字段映射,向目标字段填充值OnAfterFieldMapping：下推/选单，自动填充目标字段值完毕后，这里可以对填充值进行修复，处理AfterConvert：最后触发：单据转换后事件单据转换插件注册打开单据转换在插件策略中注册插件单据转换规则扩展扩展原有的转换规则，进行注册插件后启用插件案例：采购订单下推收料通知单，带出多选基础资料增加多选基础资料字段扩展采购订单和收料通知单，新增多选基础资料字段并设置基础资料类型为部门单据转换后事件业务描述：完成单据转换后，把采购订单的多选基础资料带到目标单收料通知单上Thanksterimakasih感謝谢谢ありがとうขอบคุณ
