【应用场景】动态表单界面元素定时自动刷新。

【案例演示】采购订单新增界面上，每30秒自动刷新日期字段为当前时间。

【实现步骤】

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

using Kingdee.BOS.Core.DynamicForm.PlugIn;

using Kingdee.BOS.Util;

using System;

using System.ComponentModel;

namespace Jac.XkDemo.BOS.Business.PlugIn

{

    /// <summary>

    /// 【表单插件】自动刷新之定时器事件

    /// </summary>

    [Description("【表单插件】自动刷新之定时器事件"), HotUpdate]

    public class AutoRefreshByTimerFormPlugIn : AbstractDynamicFormPlugIn

    {

        public override void OnTimerElapsed(EventArgs e)

        {

            base.OnTimerElapsed(e);

            this.View.Model.SetValue("F_Jac_Datetime", DateTime.Now);

        }

    }

}

<2>拷贝插件组件到应用站点的WebSite\Bin目录下，WebSite目录下的Web.config文件，修改参数【AppHearbeat】的值为30，重启IIS。

<3>BOSIDE扩展采购订单，新增一个长日期字段，注册表单插件，保存元数据，开发完毕。

【插件验证】

<1>登录业务站点，打开采购订单新增界面，此时长日期字段的数据开始每30秒刷新一次。

【注意事项】

<1>采用此方案的定时间隔有误差，误差主要来自于前端定时器计算误差，误差绝对值较小且可控，因此定时误差通常也不会很大。

<2>此方案实现定时功能，完全依赖于前端主动发起的心跳事件OnTimerElapsed事件来驱动，即使某次请求网络异常导致请求中断，也仅是影响当次请求，不会导致定时器中断彻底失效，因此，此方案实现的定时功能的可靠性比较高。

<3>因为前台的心跳事件OnTimerElapsed服务于整个系统，其触发动作具有全局性，不能单独为某个特性服务。因此其触发频率不能太快（官方推荐配置为300秒），快了会严重影响系统性能。如果您的定时任务需要执行间隔很快，那这个方案显然不合适。

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

【参考资料】

【二开案例.表单插件.自动刷新之自定义事件】https://vip.kingdee.com/article/163231754231289600

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

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