【应用场景】

在单据上读取和显示基础资料属性。

基础资料属性字段是虚拟字段，该字段本身不携带数据，其要显示的数据都来自其绑定的基础资料字段的数据包。

【案例演示】

采购订单，通过插件读取和显示基础资料属性。

【实现步骤】

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

using Kingdee.BOS.Core.DynamicForm.PlugIn;
using Kingdee.BOS.Core.DynamicForm.PlugIn.Args;
using Kingdee.BOS.Core.Metadata.FieldElement;
using Kingdee.BOS.Orm.DataEntity;
using Kingdee.BOS.Util;
using System.ComponentModel;
namespace Jac.XkDemo.BOS.Business.PlugIn
{
    /// <summary>
    /// 【表单插件】基础资料属性
    /// </summary>
    [Description("【表单插件】基础资料属性"), HotUpdate]
    public class BasePropertyFieldFormPlugIn : AbstractDynamicFormPlugIn
    {
        /// <summary>
        /// 字段标识
        /// </summary>
        const string FieldKey = "F_Jac_BaseProperty";
        public override void BarItemClick(BarItemClickEventArgs e)
        {
            base.BarItemClick(e);
            var field = (BasePropertyField)this.View.BillBusinessInfo.GetField(FieldKey);
            var fieldAppearance = (BasePropertyFieldAppearance)this.View.LayoutInfo.GetAppearance(FieldKey);
            if (e.BarItemKey.EqualsIgnoreCase("test1"))
            {
                // 赋值
                this.View.ShowMessage("基础资料属性字段是只读的，无法赋值，其数据来自于其关联的基础资料的某个字段的值。");
                return;
            }
            if (e.BarItemKey.EqualsIgnoreCase("test2"))
            {
                // 取值
                var value = this.Model.GetValue(field.ControlFieldKey) as DynamicObject;
                string msg;
                if (value == null)
                {
                    msg = "基础资料属性字段的值：null";
                }
                else
                {
                    object refValue;
                    var baseDataField = (BaseDataField)this.View.BillBusinessInfo.GetField(field.ControlFieldKey);
                    if (field.SourceField is MulAssistantField)
                    {
                        refValue = baseDataField.GetRefPropertyValue2(value, field.SrcDisplayFieldName);
                    }
                    else
                    {
                        refValue = baseDataField.GetRefPropertyValue(value, field.SrcDisplayFieldName, field.SrcBaseDataDisplayType);
                    }
                    msg = string.Format("基础资料属性字段的值：{0}", refValue);
                }
                this.View.ShowMessage(msg);
                return;
            }
            if (e.BarItemKey.EqualsIgnoreCase("test3"))
            {
                // 锁定
                this.View.ShowMessage("基础资料属性字段是只读的，会一直处于锁定状态，无需锁定。");
                return;
            }
            if (e.BarItemKey.EqualsIgnoreCase("test4"))
            {
                // 解锁
                this.View.ShowMessage("基础资料属性字段是只读的，会一直处于锁定状态，无法解锁。");
                return;
            }
            if (e.BarItemKey.EqualsIgnoreCase("test5"))
            {
                // 隐藏
                this.View.GetControl(FieldKey).Visible = false;
                return;
            }
            if (e.BarItemKey.EqualsIgnoreCase("test6"))
            {
                // 显示
                this.View.GetControl(FieldKey).Visible = true;
                return;
            }
        }
    }
}

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

<3>BOSIDE扩展采购订单，新增基础资料属性字段，基础资料字段绑定供应商，菜单集合新增菜单项，注册表单插件，保存元数据，开发完毕。

【功能验证】

<1>登录业务站点，打开采购订单新增界面，可通过菜单项，实现插件对基础资料属性字段的各种控制。

---------------------------------------------------------------------------------------------------------

【金蝶云星空BOS二次开发案例演示】https://vip.kingdee.com/article/94751030918525696