MOSS中的计时器作业

这方面的文章园子里有几篇了，不过大家基本上都是参考了http://www.andrewconnell.com/blog/articles/CreatingCustomSharePointTimerJobs.aspx这篇文章，在此我也推荐大家仔细看下本文及文中涉及到的相关文章。工作中也遇到了类似的需求，在此也做个总结。

1.MOSS中已经提供了定时器的功能，我们要开发自己的定时器需要继承自SPJobDefinition类，在重写的Execute方法写自己的业务逻辑。我的需求是找出列表中符合条件的item，并做mail通知，代码如下：

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SharePoint.Administration;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Utilities;
namespace CaryTimer
{
    public class ListRemindEvent : SPJobDefinition
    {
        public ListRemindEvent() : base() { }

        public ListRemindEvent(string _timername, SPWebApplication _wp)
            : base(_timername, _wp, null, SPJobLockType.ContentDatabase)
        {
            this.Title = "TestTimer";
        }

        public override void Execute(Guid targetInstanceId)
        {    
                SPWebApplication webApp = this.Parent as SPWebApplication;
                SPContentDatabase contentDB = webApp.ContentDatabases[targetInstanceId];
                SPWeb web = contentDB.Sites[0].AllWebs[0];
                string sendTo = "";
                string mailTitle = "";
                string mailBody = "";
			 //实现自己业务逻辑，找出复合条件的并发mail做相关通知。
                SPUtility.SendEmail(web, false, false, sendTo, mailTitle, mailBody);                  
        }
     }
}

2.该类完成后我们使用Feature来部署该功能，我们写一个自己的安装类，如下：

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Administration;

namespace CaryTimer
{
    public class ListRemindEventInstaller : SPFeatureReceiver
    {
        const string caryTimerName = "Testtimer";
        public override void FeatureInstalled(SPFeatureReceiverProperties properties)
        { }
        public override void FeatureUninstalling(SPFeatureReceiverProperties properties)
        { }
        public override void FeatureActivated(SPFeatureReceiverProperties properties)
        {
           SPSite site = properties.Feature.Parent as SPSite;
            foreach (SPJobDefinition job in site.WebApplication.JobDefinitions)
            {
	      //判断是否已存在
                if (job.Name == caryTimerName)
                {
                    job.Delete();
                }
            }
            ListRemindEvent timer = new ListRemindEvent(caryTimerName, site.WebApplication);
	    /下边是设置定时器的执行计划部分。
              SPMinuteSchedule schedule = new SPMinuteSchedule();
            schedule.BeginSecond = 0;
            schedule.EndSecond = 59;
            schedule.Interval = 1;
            timer.Schedule = schedule;
            timer.Update();
        }

        public override void FeatureDeactivating(SPFeatureReceiverProperties properties)
        {
            SPSite site = properties.Feature.Parent as SPSite;
            foreach (SPJobDefinition job in site.WebApplication.JobDefinitions)
            {
                if (job.Name == caryTimerName)
                {
                    job.Delete();
                }
            }
        }
    }
}

3.需要在"c:\program files\common files\microsoft shared\web server extensions\12\Template\features"文件夹下建立CaryTimer文件夹，在该文件夹下建一个Feature.xml，代码如下：

<Feature 
  Id="6283ADA0-B882-47fe-8507-D8CC763DC320" 
  Title="CaryTimer" 
  Description=" CaryTimer  des" 
  Scope="Site" 
  Hidden="FALSE"   
  ReceiverAssembly="HelloWorld, Version=1.0.0.0, Culture=neutral, PublicKeyToken=b38a04419cc857d9"
  ReceiverClass="HelloWorld.ListRemindEventInstaller"
  xmlns="http://schemas.microsoft.com/sharepoint/"> 
</Feature>

4.然后我们使用一个批处理来安装Feature，批处理代码如下：

@SET TEMPLATEDIR="c:\program files\common files\microsoft shared\web server extensions\12\Template"

@SET STSADM="c:\program files\common files\microsoft shared\web server extensions\12\bin\stsadm"

@SET GACUTIL="d:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\Bin\gacutil.exe"

Echo Installing HelloWorld.dll in GAC

%GACUTIL% -if bin\debug\HelloWorld.dll

Echo Copying files to TEMPLATE directory

xcopy /e /y TEMPLATE\* %TEMPLATEDIR%

Echo Installing feature

%STSADM% -o installfeature -filename HelloWorld\feature.xml -force

IISRESET

REM cscript c:\windows\system32\iisapp.vbs /a "SharePointDefaultAppPool" /r

5.项目完成后，我们要添加强命名密钥。部署成功后就可以在网站集功能中看见该Feature，激活该Feature后，在管理中心—操作—计时器作业定义中可以看见该定时器的相关信息，并且可以禁用和启用该定时器，在管理中心—操作—计时器作业状态中可以该定时器最后一次运行的情况。

6.如果我们要调试该定时器我们需要附加OwsTimer.exe进程，每次更改后需走以下步骤：
6.1.使用批处理从新部署Feature
6.2.先Deactivate feature, 然后activate feature.
6.3.命令行：net stop SPTimerV3
6.4.命令行：net start SPTimerV3
6.5.Visual Studio: Attach to process: OWSTIMER.EXE

7.如果你在ListRemindEvent类中需要读取外部文件的配置，直接读web.config是读不到的，我们需要在c:/program files/common files/microsoft shared/…/12/bin目录里新建一个文件OwsTimer.exe.config，并做相关配置如下：

<configuration>
  <appSettings>
   <add key="key" value="value" />
  </appSettings>
</configuration>
然后用ConfigurationManager.AppSettings.Get("key"); 来取得这个值。