如何通过插件携带第二个单据体到下游单据

背景说明：
K/3 Cloud 不支持在下推时，同时携带两个单据体的数据；
因此，需要在转换规则上，配置好携带主单据体；
而辅助单据体的数据，需要在插件中自行携带；

案例说明：
本案例，设计了两张单据A和B，都有两个单据体，主单据体为FEntity，第二单据体为FEntity2；
主单据体的字段，已经配置的单据转换规则 - 字段映射关系；
而第二单据体，需要通过插件携带；
第二单据体仅有一个文本字段F_JD_Text；

特别说明：
本案例不适用于同一张源单同时下推为多张目标单的情况：
这样情况是分单了，而第二单据体，无法对应拆分；

示例代码：
//*********************************************
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ComponentModel;

using Kingdee.BOS;
using Kingdee.BOS.Util;
using Kingdee.BOS.Core;
using Kingdee.BOS.Core.Metadata;
using Kingdee.BOS.Core.Metadata.ConvertElement;
using Kingdee.BOS.Core.Metadata.ConvertElement.PlugIn;
using Kingdee.BOS.Core.Metadata.ConvertElement.PlugIn.Args;
using Kingdee.BOS.Core.Metadata.EntityElement;
using Kingdee.BOS.Core.Metadata.FormElement;
using Kingdee.BOS.Core.SqlBuilder;
using Kingdee.BOS.Orm.DataEntity;
using Kingdee.BOS.Contracts;
using Kingdee.BOS.App;

namespace JDSample.ServicePlugIn.BillConvert
{
    /// <summary>
    /// 携带其他单据体
    /// </summary>
    [Description("携带其他单据体")]
    public class S151105TakeOtherEntryConvPlug : AbstractConvertPlugIn
    {
        /// <summary>
        /// 主单据体的字段携带完毕，与源单的关联关系创建好之后，触发此事件
        /// </summary>
        /// <param name="e"></param>
        public override void OnAfterCreateLink(CreateLinkEventArgs e)
        {
            // 预先获取一些必要的元数据，后续代码要用到：
            // 源单第二单据体
            Entity srcSecondEntity = e.SourceBusinessInfo.GetEntity("FEntity2");

            // 目标单第一单据体
            Entity mainEntity = e.TargetBusinessInfo.GetEntity("FEntity");

            // 目标单第二单据体
            Entity secondEntity = e.TargetBusinessInfo.GetEntity("FEntity2");

            // 目标单关联子单据体
            Entity linkEntity = null;
            Form form = e.TargetBusinessInfo.GetForm();
            if (form.LinkSet != null 
                && form.LinkSet.LinkEntitys != null
                && form.LinkSet.LinkEntitys.Count != 0)
            {
                linkEntity = e.TargetBusinessInfo.GetEntity(
                    form.LinkSet.LinkEntitys[0].Key);
            }

            if (linkEntity == null)
            {
                return;
            }

            // 获取生成的全部下游单据
            ExtendedDataEntity[] billDataEntitys = e.TargetExtendedDataEntities.FindByEntityKey("FBillHead");

            // 对下游单据，逐张单据进行处理
            foreach (var item in billDataEntitys)
            {
                DynamicObject dataObject = item.DataEntity;
                
                // 定义一个集合，用于收集本单对应的源单内码
                HashSet<long> srcBillIds = new HashSet<long>();
                
                // 开始到主单据体中，读取关联的源单内码
                DynamicObjectCollection mainEntryRows = 
                    mainEntity.DynamicProperty.GetValue(dataObject) as DynamicObjectCollection;
                foreach (var mainEntityRow in mainEntryRows)
                {
                    DynamicObjectCollection linkRows = 
                        linkEntity.DynamicProperty.GetValue(mainEntityRow) as DynamicObjectCollection;
                    foreach (var linkRow in linkRows)
                    {
                        long srcBillId = Convert.ToInt64(linkRow["SBillId"]);
                        if (srcBillId != 0
                            && srcBillIds.Contains(srcBillId) == false)
                        {
                            srcBillIds.Add(srcBillId);
                        }
                    }
                }
                if (srcBillIds.Count == 0)
                {
                    continue;
                }
                // 开始加载源单第二单据体上的字段
                
                // 确定需要加载的源单字段（仅加载需要携带的字段）
                List<SelectorItemInfo> selector = new List<SelectorItemInfo>();
                selector.Add(new SelectorItemInfo("F_JD_Text"));
                // TODO: 继续添加其他需要携带的字段，示例代码略
                // 设置过滤条件
                string filter = string.Format(" {0} IN ({1}) ",
                    e.SourceBusinessInfo.GetForm().PkFieldName,
                    string.Join(",", srcBillIds));
                OQLFilter filterObj = OQLFilter.CreateHeadEntityFilter(filter);
                
                // 读取源单
                IViewService viewService = ServiceHelper.GetService<IViewService>();
                var srcBillObjs = viewService.Load(this.Context,
                    e.SourceBusinessInfo.GetForm().Id,
                    selector,
                    filterObj);

                // 开始把源单单据体数据，填写到目标单上
                DynamicObjectCollection secondEntryRows = 
                    secondEntity.DynamicProperty.GetValue(dataObject) as DynamicObjectCollection;
                secondEntryRows.Clear();    // 删除空行

                foreach (var srcBillObj in srcBillObjs)
                {
                    DynamicObjectCollection srcEntryRows = 
                        srcSecondEntity.DynamicProperty.GetValue(srcBillObj) as DynamicObjectCollection;

                    foreach (var srcEntryRow in srcEntryRows)
                    {
                        // 目标单添加新行，并接受源单字段值
                        DynamicObject newRow = new DynamicObject(secondEntity.DynamicObjectType);
                        secondEntryRows.Add(newRow);
                        // 填写字段值
                        newRow["F_JD_Text"] = srcEntryRow["F_JD_Text"];
                        // TODO: 逐个填写其他字段值，示例代码略
                    }
                }
            }
        }
    }
}