【应用场景】

在单据上读取和显示多选辅助资料列表。

【案例演示】

采购订单，通过插件读取和显示多选辅助资料列表。

【实现步骤】

<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.Collections.Generic;
using System.ComponentModel;
namespace Jac.XkDemo.BOS.Business.PlugIn
{
    /// <summary>
    /// 【表单插件】多选辅助资料列表
    /// </summary>
    [Description("【表单插件】多选辅助资料列表"), HotUpdate]
    public class MulAssistantFieldFormPlugIn : AbstractDynamicFormPlugIn
    {
        /// <summary>
        /// 字段标识
        /// </summary>
        const string FieldKey = "F_Jac_MulAssistant";
        public override void BarItemClick(BarItemClickEventArgs e)
        {
            base.BarItemClick(e);
            var field = (MulAssistantField)this.View.BillBusinessInfo.GetField(FieldKey);
            var fieldAppearance = (MulAssistantFieldAppearance)this.View.LayoutInfo.GetAppearance(FieldKey);
            if (e.BarItemKey.EqualsIgnoreCase("test1"))
            {
                // 赋值
                /*
                 -- 查询辅助资料
SELECT  a.FID AS 辅助资料类型内码 ,
        c.FNAME AS 辅助资料类型名称 ,
        a.FENTRYID AS 辅助资料内码 ,
        a.FNUMBER AS 辅助资料编码 ,
        b.FDATAVALUE AS 辅助资料名称
FROM    T_BAS_ASSISTANTDATAENTRY a
        LEFT JOIN T_BAS_ASSISTANTDATAENTRY_L b ON a.FENTRYID = b.FENTRYID
                                                  AND b.FLOCALEID = 2052
        LEFT JOIN T_BAS_ASSISTANTDATA_L c ON a.FID = c.FID
                                             AND c.FLOCALEID = 2052
WHERE   c.FNAME = '国家';
                 */
                // 方式1：用内码赋值（1个或者多个，用逗号分隔）
                var ids = "46a524cf-5797-4e46-bd0a-7203fc426d9c,f98a3ac14f0b4397a332b2353f1fc66c"; // 中国，美国
                this.Model.SetValue(FieldKey, ids);
                // 方式2：用内码赋值（1个或者多个，用数组）
                //var ids2 = new object[] { "46a524cf-5797-4e46-bd0a-7203fc426d9c", "f98a3ac14f0b4397a332b2353f1fc66c", "5d03002c37f652" }; // 中国，美国，英国
                //this.Model.SetValue(FieldKey, ids2);
                // 方式3：用内码赋值（只能一个）
                //this.Model.SetItemValueByID(FieldKey, "46a524cf-5797-4e46-bd0a-7203fc426d9c", 0);
                // 方式4：用编码赋值（只能一个）
                //this.Model.SetItemValueByNumber(FieldKey, "China", 0);
                // 方式5：用数据包赋值（只能一个）
                //var loadParam = new QueryBuilderParemeter();
                //loadParam.FormId = "BOS_ASSISTANTDATA_SELECT";
                //loadParam.FilterClauseWihtKey = string.Format("FID='{0}' AND FNumber='{1}'",field.LookUpObjectID,"China");
                //var obj = BusinessDataServiceHelper.Load(Context, field.RefFormDynamicObjectType, loadParam);
                //this.Model.SetValue(FieldKey, obj[0]);
                return;
            }
            if (e.BarItemKey.EqualsIgnoreCase("test2"))
            {
                // 取值
                var objs = this.Model.GetValue(FieldKey) as DynamicObjectCollection;
                string msg;
                if (objs == null || objs.Count == 0)
                {
                    msg = "多选辅助资料列表字段的值：null";
                }
                else
                {
                    var valueList = new List<string>();
                    foreach (var obj in objs)
                    {
                        var assistantObj = (DynamicObject)obj[field.PropertyName];
                        var id = assistantObj["Id"];
                        var number = assistantObj["FNumber"];
                        var name = assistantObj["FDataValue"];
                        valueList.Add(string.Format("内码：{0}\r\n编码：{1}\r\n名称：{2}", id, number, name));
                    }
                    msg = string.Format("多选辅助资料列表字段的值：\r\n{0}", string.Join("\r\n", valueList));
                }
                this.View.ShowMessage(msg);
                return;
            }
            if (e.BarItemKey.EqualsIgnoreCase("test3"))
            {
                // 锁定
                this.View.GetControl(FieldKey).Enabled = false;
                return;
            }
            if (e.BarItemKey.EqualsIgnoreCase("test4"))
            {
                // 解锁
                this.View.GetControl(FieldKey).Enabled = true;
                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