【应用场景】

文档、物料的“相关变更”页签需要显示关联变更单“备注”字段。

【注意事项】

(1)扩展相关变更动态表单添加映射“备注”的字段时，新添加字段的长度需要和变更单“备注”字段长度一致，避免赋值报错。

(2)二开类继承原本的类，因此注册二开插件并启用后需要取消标准插件的启用（可见实现步骤<4>）。

(3)虽然相关变更动态表单绑定的基础资料是“PDM全局对象”，但因为实际加载时使用“PDM基础对象”，因此无法使用基础资料属性带出“备注”字段。

【实现步骤】

<1>编写表单插件，代码如下。 

依赖组件：

using Kingdee.BOS.Orm.DataEntity;
using Kingdee.K3.PLM.CFG.Common.BusinessEntity.Manager;
using System;
using System.ComponentModel;

实现代码：

[Description("变更二开插件")]
    public class RelatedChangeSD: RelatedChangePlugin
    {

        public override void AfterBindData(EventArgs e)
        {
            //将变更单“备注”字段映射到相关变更页签
            var entity = (DynamicObjectCollection)this.Model.DataObject["Entity"];
            if (entity != null && entity.Count > 0)
            {
                int index = -1;
                foreach (var ecn in entity)
                {
                    index++;
                    long ecnId = Convert.ToInt64(ecn["Base_Id"]);
                    DynamicObject ecnObj = (DynamicObject)ecn["Base"];
                    if (ecnObj == null) continue;
                    var categoryId = Convert.ToInt64(ecnObj["CategoryID_Id"]);
                    if (categoryId != 1070200000000000000L) continue;//只处理变更单
                    var ecnDomainObj = DomainObjectManager.InstanceByObjectId(PLMContext, ecnId).Get(PLMContext, ecnId);
                    this.Model.SetValue("FECNText", Convert.ToString(ecnDomainObj["Remark"]), index);//相关变更中扩展的映射备注字段长度需要和变更单中的一致
                }
                this.View.UpdateView("FEntity");
            }
            base.AfterBindData(e);
        }


    }

<2>拷贝插件组件到应用站点的WebSite\Bin目录下，重启IIS。

<3>BOSIDE扩展“相关变更:PLM_RELATEDCHANGE”，添加对应映射文本字段“变更单备注”【长度和原字段要一致】。

<4>注册二开表单插件、取消原本的标准插件，保存元数据，开发完毕。

【功能验证】

<1>登录业务站点，打开文档的相关变更页签，效果如下：

【参考资料】

【汇总】星空PLM二开指南（持续更新）https://vip.kingdee.com/article/329914697153905408?productLineId=1&isKnowledge=2

【合辑】金蝶云.星空 PLM知识合辑（持续更新） https://vip.kingdee.com/article/329662872047302912?productLineId=1&isKnowledge=2

金蝶云星空PLM表结构(V8.0) https://vip.kingdee.com/article/350294658524016128?productLineId=1

二次开发扩展程序开发之插件模式 https://vip.kingdee.com/article/83591896433330944?productLineId=1

PLM云 -- 基于BOS平台的二次开发扩展https://vip.kingdee.com/article/10875?productLineId=1

PLM云 -- 基于配置系统的二次开发扩展（对象属性扩展）https://vip.kingdee.com/article/10887?productLineId=1

PLM云 -- 基于标准业务系统的二次开发扩展 https://vip.kingdee.com/article/10901?productLineId=1

金蝶云星空BOS二次开发指南https://vip.kingdee.com/article/94751030918525696?productLineId=1&isKnowledge=2

金蝶云星空数据字典V7.6 https://open.kingdee.com/K3Cloud/WenKu/DocumentView.aspx?docId=102613