二开案例.计算任务.从零开发计算任务

【应用场景】一次性的，不需要周期性执行的，不需要界面交互的，高资源消耗型的后台任务。计算任务通过计算站点运行，能有效降低对应用站点的性能影响。

计算任务和执行计划都是运行在计算站点上，两者的主要区别在于，计算任务是即时启动任务，且仅执行一次；而执行计划是根据其定义的执行策略，周期性的执行。

【案例演示】实现一个计算任务，任务中实现写上机日志和发送邮件的功能，并在采购订单列表上启动该计算任务。

【实现步骤】

<1>编写计算任务服务类，代码如下。

using Kingdee.BOS.App.Core;

using Kingdee.BOS.Computing;

using Kingdee.BOS.Core.Log;

using Kingdee.BOS.Log;

using Kingdee.BOS.Util;

using System;

using System.Collections.Generic;

namespace Jac.XkDemo.BOS.App.PlugIn

{

    /// <summary>

    /// 【计算任务】从零开发计算任务

    /// </summary>

    public class SendMailComputeTaskService : IComputeTaskExecutor

    {

        /// <summary>

        /// 计算任务入口函数

        /// </summary>

        /// <param name="ctx"></param>

        public void Execute(ComputeContext ctx)

        {

            try

            {

                #region 计算任务主体逻辑

                // TODO

                // TODO

                // TODO

                #endregion

                #region 写个上机操作日志，证明我执行过啦

                var logs = new List<LogObject>();

                var log = new LogObject();

                log.pkValue = "0";

                log.Description = "我是一条来自计算任务的测试日志数据:)";

                log.OperateName = "执行计算任务";

                log.ObjectTypeId = "BOS_COMPUTETASK";

                log.SubSystemId = "BOS";

                log.Environment = OperatingEnvironment.BizOperate;

                logs.Add(log);

                new Kingdee.BOS.App.LogService.Log().BatchWriteLog(ctx.Task.BOSContext, logs);

                #endregion

                #region 执行完了，发个邮件通知下用户

                // 给当前用户发个邮件

                var userId = ctx.Task.BOSContext.UserId;

                var email = new SendMailService().GetEmailMessageInfoByUserId(ctx.Task.BOSContext, userId);

                if (email != null)

                {

                    email.To = new List<string>(new[] {"abc@qq.com"});

                    email.Subject = "计算任务测试邮件";

                    email.Body = "我是一封来自计算任务的测试邮件，计算任务已成功执行！";

                    MailUtils.Sendmail(email);

                }

                #endregion

            }

            catch (Exception ex)

            {

                var errMsg = string.Format("计算任务运行异常:{0}", ex.Message);

                Logger.Error("Jac", errMsg, ex);

            }

        }

    }

}

<2>编写列表插件，代码如下。

using Kingdee.BOS.App;

using Kingdee.BOS.Computing;

using Kingdee.BOS.Contracts.Computing;

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

using Kingdee.BOS.Core.List.PlugIn;

using Kingdee.BOS.Util;

using System;

using System.Collections.Generic;

using System.ComponentModel;

namespace Jac.XkDemo.BOS.Business.PlugIn

{

    /// <summary>

    /// 【列表插件】启动计算任务

    /// </