需求背景

业务代码在对下游单据进行处理时，常常需要找到源头的核心单据（例如订单），根据核心单据的数据状态等信息，决定业务逻辑。

核心单据和下游单据之间，经过了多次的单据转换（如A -> B -> C -> D ->…）。很不幸，在当前需要处理的下游单据上，并没有冗余字段记录源头核心单据的信息，无法通过本单上的字段值找到源单。

每次执行单据转换时，平台都会在后台自动记录单据之间的关联关系，并提供了相应的服务接口，查询各单之间的关系。上述需求，可以通过平台提供的服务接口实现。

说明：正因为平台会在后台自动记录单据之间的关联关系，在设计下游单据时，其实不需要考虑冗余太多字段，一层层携带、记录源头核心单据信息。

本章介绍如何使用平台提供的服务接口，搜索源单。

案例设计

假设源头核心单据是demo_botp1，当前处理的下游单据是demo_botp3：

demo_botp1 下推生成 demo_botp2；

demo_botp2 接着下推生成 demo_botp3；

当前正在审核demo_botp3，需要找到源头的demo_botp1；

相关知识点

BFTrackerServiceHelper：平台封装的单据关联关系追踪服务，可以搜索源单、搜索目标单、搜索分录行的关联追溯树；

示例代码

案例实现思路：

开发单据demo_botp3的审核操作插件，派生自AbstractOperationServicePlugIn；

重写beforeExecuteOperationTransaction方法，此方法在操作校验通过，开启事务保护前触发，可以在此事件中，检查、整理数据；

调用BFTrackerServiceHelper服务方法，传入本单主实体编码和单据内码，搜索本单的全部源单；从中获取需要查找的源单demo_botp1；

根据取到的源头demo_botp1单据内码，进行后续处理。

特别说明：

本示例使用的BFTrackerServiceHelper.findSourceBills只是整体搜索出所有源单，未区分各单直接的对应关系，这在批量处理时会有限制。如果需要准确区分各单对应关系，需要使用BFTrackerServiceHelper.loadLinkUpNodes获取行级追溯树，然后从其中寻找源单，详细过程，请参阅另外一个场景、示例。

示例代码：

package kd.bos.plugin.sample.bill.billconvert.bizcase;

import java.util.HashSet;

import java.util.Map;

import java.util.Set;

import kd.bos.entity.ExtendedDataEntity;

import kd.bos.entity.plugin.AbstractOperationServicePlugIn;

import kd.bos.entity.plugin.args.BeforeOperationArgs;

import kd.bos.servicehelper.botp.BFTrackerServiceHelper;

/**

 * 示例：在单据审核时，搜索源头单据

 * 

 * @author rd_johnnyding

 *

 */

public class FindSourceBillOpPlugin extends AbstractOperationServicePlugIn {

    /**

     * 开启事务保护前，触发本事件：对数据进行检查、整理

     */

    @Override

    public void beforeExecuteOperationTransaction(BeforeOperationArgs e) {

        if (e.getValidExtDataEntities().isEmpty()) {

            return;

        }

        // 获取当前单据（下游单据）的主实体编码、单据内码

        String targetEntityNumber = this.billEntityType.getName();

        Set<Object> billIds = new HashSet<>();

        for(ExtendedDataEntity dataEntity : e.getValidExtDataEntities()) {

            billIds.add(dataEntity.getBillPkId());

        }

        // 调用平台的服务，获取所有源单及其内码

        Map<String, HashSet<Long>> sourceBillIds = BFTrackerServiceHelper.findSourceBills(targetEntityNumber, billIds.toArray(new Long[0]));

        // 从所有源单中寻找需要的demo_botpbill1

        HashSet<Long> botpbill1_Ids = new HashSet<>();

        String botpbill1_EntityNumber = "demo_botp1";

        if (sourceBillIds.containsKey(botpbill1_EntityNumber)) {

            botpbill1_Ids = sourceBillIds.get(botpbill1_EntityNumber);

        }

        if (!botpbill1_Ids.isEmpty()) {

            // TODO 已经获取到了源头的demo_botpbill1单据内码，可以进行后续处理

        }

    }

}