【应用场景】使用列表插件读写系统参数。

【案例演示】采购订单，列表界面，在列表插件中读写系统参数。

【实现步骤】

<1>编写列表插件，实现读写系统参数的功能，代码如下。

using Kingdee.BOS;

using Kingdee.BOS.Core.DynamicForm.PlugIn.Args;

using Kingdee.BOS.Core.List.PlugIn;

using Kingdee.BOS.ServiceHelper;

using Kingdee.BOS.Util;

using System.ComponentModel;

namespace Jac.XkDemo.BOS.Business.PlugIn

{

    /// <summary>

    /// 【列表插件】读写系统参数

    /// </summary>

    [Description("【列表插件】读写系统参数"), HotUpdate]

    public class ReadAndWriteSysParameterListPlugIn : AbstractListPlugIn

    {

        /// <summary>

        /// 列表主菜单点击事件

        /// </summary>

        /// <param name="e"></param>

        public override void BarItemClick(BarItemClickEventArgs e)

        {

            base.BarItemClick(e);

            if (e.BarItemKey.EqualsIgnoreCase("tbReadSysParameter"))

            {

                var auxMustInput = ReadSysParameter(this.Context, 0, "BOS_PlatformConfig", "FDisableWebApi");

                this.View.ShowMessage("系统参数【禁用WebApi】：" + auxMustInput);

                return;

            }

            if (e.BarItemKey.EqualsIgnoreCase("tbWriteSysParameter"))

            {

                var isOk = WriteSysParameter(this.Context, 0, "BOS_PlatformConfig", "FDisableWebApi", true);

                this.View.ShowMessage(isOk ? "系统参数保存成功" : "系统参数保存失败");

                return;

            }

        }

        /// <summary>

        /// 读取系统参数

        /// </summary>

        /// <param name="ctx">上下文</param>

        /// <param name="orgId">系统参数所属组织</param>

        /// <param name="parameterObjId">系统参数的业务对象标识</param>

        /// <param name="parameterName">系统参数的实体属性名</param>

        /// <returns></returns>

        public static object ReadSysParameter(Context ctx, long orgId, string parameterObjId, string parameterName)

        {

            // 读取系统参数数据包

            var parameterData = SystemParameterServiceHelper.Load(ctx, orgId, 0, parameterObjId);

            // 从系统参数数据包中获取某一个参数

            if (parameterData != null && parameterData.DynamicObjectType.Properties.ContainsKey(parameterName))

            {

                return parameterData[parameterName];

            }

            return null;

        }

        /// <summary>

        /// 保存系统参数

        /// </summary>

        /// <param name="ctx">上下文</param>

        /// <param name="orgId">系统参数所属组织</param>

        /// <param name="parameterObjId">系统参数的业务对象标识</param>

        /// <param name="parameterName">系统参数的实体属性名</param>

        /// <param name="parameterValue">系统参数的值</param>

        /// <returns></returns>

        public static bool WriteSysParameter(Context ctx, long orgId, string parameterObjId, string parameterName, object parameterValue)

        {

            // 获取系统参数的元数据

            var formMetadata = FormMetaDataCache.GetCachedFormMetaData(ctx, parameterObjId);

            // 读取系统参数包

            var parameterData = SystemParameterServiceHelper.Load(ctx, orgId, 0, parameterObjId);

            // 从系统参数包中获取某一个参数

            if (parameterData != null && parameterData.DynamicObjectType.Properties.Contains(parameterName))

            {

                parameterData[parameterName] = parameterValue;

                var result = SystemParameterServiceHelper.Save(ctx, formMetadata.BusinessInfo, parameterData, orgId, 0, true);

                return result.IsSuccess;

            }

            return false;

        }

    }

}

/*

-- 查询系统参数

SELECT * FROM T_BAS_SYSPARAMETER 

*/

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

<3>BOSIDE扩展采购订单，列表菜单添加两个菜单。

<4>采购订单注册列表插件，保存元数据，开发完毕。

现在可以登录业务站点，打开采购订单列表，检验一下插件效果啦。

读取系统参数：

保存系统参数：

【知识点】

<1>如何快速获取当前系统参数的业务对象标识？

<2>BOSIDE，打开步骤1找到的系统参数，即可获得某个系统参数字段的标识和实体属性名等。

<3>系统参数存储在哪个表？

SELECT * FROM T_BAS_SYSPARAMETER

<4>系统参数的隔离维度？

如上图所示，依据不同的系统参数使用场景，界面可见的隔离维度有2种，组织隔离和账簿隔离。代码层面还有一个用户自定义策略的隔离，不过这一层隔离很少使用。读取系统参数的接口定义如下：

/// <summary>

/// 加载系统参数对象

/// </summary>

/// <param name="ctx">上下文</param>

/// <param name="orgId">组织内码</param>

/// <param name="acctBookId">账簿内码</param>

/// <param name="parameterObjId">系统参数的业务对象标识</param>

/// <param name="acctpolicyID">用户自定义的隔离Id</param>

/// <param name="bIsRunTime">运行时加载才加入缓存，设计时直接从数据库中获取</param>

/// <returns>返回指定系统参数的完整数据包</returns>

DynamicObject Load(Context ctx, long orgId, long acctBookId, string parameterObjId, long acctpolicyID = 0, bool bIsRunTime = true);

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