Creating a Lightweight Timer Job for a Site Collection:<\/p>\n
Defining Custom Work Items<\/p>\n
Timer jobs run in a specific Windows services for the SharePoint Server (please refer to: http:\/\/technet.microsoft.com\/en-us\/library\/cc678870.aspx<\/a> for more information). SharePoint provides some built-in timer job definitions for infrastructure, which provides developers a mechanism to customize jobs. These jobs allow developers to incorporate specific aspects of their business to the job definitions.<\/p>\n So what we can do?<\/span><\/span><\/span><\/p>\n There is a special timer job in SharePoint defined by the class SPWorkItemJobDefinition<\/strong>, which is inherited from SPPausableJobDefinition<\/strong> (please refer to: http:\/\/msdn.microsoft.com\/en-us\/library\/microsoft.sharepoint.administration.sppausablejobdefinition.aspx<\/a> for more information). This timer job works closely with SPWorkItem<\/strong>, which can add a work item to a site collection.<\/p>\n If we want to create a lightweight timer job, we should define a class inherited from SPWorkItemJobDefinition.<\/strong><\/p>\n <\/strong>How do we do this?<\/span><\/p>\n <\/span><\/strong>1. You must override two methods: WorkItemType<\/a>, ProcessWorkItems<\/a><\/p>\n This method returns a GUID that can identify this timer job. When you add a work item to a site collection, you should specify the work item type, so the timer service can process it with the specific timer job definition.<\/p>\n 2. This method is really convenient. You can define your custom business logic, send an alert email if the work item has been completed, or schedule a new delivery date.<\/p>\n Adding a work item to a site collection<\/span>:<\/p>\n 3. We can call the method SPSite.AddWorkItem<\/strong> to create a new work item for a site collection. See the following:<\/p>\n The method needs some parameters:<\/span><\/p>\n gWorkItemId:<\/em><\/strong> A GUID that identifies the work item.<\/p>\n schdDateTime:<\/em><\/strong> A System.DateTime<\/strong> object that represents the date and time at which the work item takes place.<\/p>\n gWorkItemType: <\/em><\/strong>A GUID that specifies the work item type, if you add a custom work item, this should be the return value of the method WorkItemType<\/strong>.<\/p>\n gWebId: <\/em><\/strong>A GUID that specifies the Web site that is associated with the work item.<\/p>\n gParentId:<\/em><\/strong> A GUID that identifies the parent of the work item.<\/p>\n nItemId: <\/em><\/strong>A 32-bit integer that identifies a list item that is associated with the work item.<\/p>\n fSetWebId:<\/em><\/strong> true to set the Web identifier; otherwise, false.<\/p>\n gItemGuid: <\/em><\/strong>A GUID that specifies a list item that is associated with the work item.<\/p>\n gBatchId: <\/em><\/strong>A GUID that specifies a context identifier for the job work item engine. The value can vary depending on the job type; for example, for alerts it might store a user ID but for workflow it would store a workflow ID.<\/p>\n nUserId: <\/em><\/strong>A 32-bit integer index that identifies an SPUser<\/strong> object that represents the user who is responsible for scheduling the work item.<\/p>\n rgbBinaryPayload: <\/em><\/strong>A byte array that specifies a binary payload.<\/p>\n strTextPayload: <\/em><\/strong>A string that specifies a text payload.<\/p>\n gProcessingId: <\/em><\/strong>A GUID that identifies the processing of the work item.<\/p>\n 4. The following code will show how to define a custom work item (custom site collection timer job) and how to add a work item to a site collection.<\/p>\n 5. After your timer job was added to a web application we often do this on feature activated), you can add your custom work item to a site collection like this:<\/p>\n How does it work?<\/strong><\/p>\n <\/strong>1. When a work item was added to a site collection, a record will be added to the scheduledworkitems<\/strong> table in the web application’s content database.<\/p>\n 2. When timer job is executed, the records in the table meeting the conditions will be loaded and then processed. Because of performance reasons, the timer job will not load any items greater than its BatchFetchLimit<\/strong> property.<\/p>\n 3. However, you must manually update \/ delete the work items that have been processed or else it will just process the items up to the BatchFetchLimit<\/strong> property again and again.<\/p>\n NOTE<\/span><\/strong>: I encountered an issue where the timer job only processed the first 100 items in the scheduledworkitems<\/strong> table because I did not delete the completed items. However, their DeliveryDate<\/strong> condition was updated to a very small value, so every time the timer job was executed, the items still met the conditions from last time and the other work items were never processed.<\/p>\n 4. If we just need a timer job to work on a site collection, customizing a timer job inherited from the SPWorkItemJobDefinition<\/strong> class is a better way. This kind of timer job can readily be added to a site collection as a work item and the identity of the site collection and Web ID is already stored on the scheduledworkitems<\/strong> table. Additionally, it can be fetched by the timer job directly. The normal timer job does not contain the identity of the site collection or Web ID, so we need to iterate all the sites in the web application, which the timer job is associated.<\/p>\n","protected":false},"excerpt":{"rendered":" Creating a Lightweight Timer Job for a Site Collection: Defining Custom Work Items Timer jobs run in a specific Windows services for the SharePoint Server (please refer to: http:\/\/technet.microsoft.com\/en-us\/library\/cc678870.aspx for more information). SharePoint provides some built-in timer job definitions for infrastructure, which provides developers a mechanism to customize jobs. These jobs allow developers to incorporate […]<\/p>\n","protected":false},"author":29,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[125],"tags":[405,406,407],"_links":{"self":[{"href":"https:\/\/www.boostsolutions.com\/blog\/wp-json\/wp\/v2\/posts\/4379"}],"collection":[{"href":"https:\/\/www.boostsolutions.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.boostsolutions.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.boostsolutions.com\/blog\/wp-json\/wp\/v2\/users\/29"}],"replies":[{"embeddable":true,"href":"https:\/\/www.boostsolutions.com\/blog\/wp-json\/wp\/v2\/comments?post=4379"}],"version-history":[{"count":18,"href":"https:\/\/www.boostsolutions.com\/blog\/wp-json\/wp\/v2\/posts\/4379\/revisions"}],"predecessor-version":[{"id":9212,"href":"https:\/\/www.boostsolutions.com\/blog\/wp-json\/wp\/v2\/posts\/4379\/revisions\/9212"}],"wp:attachment":[{"href":"https:\/\/www.boostsolutions.com\/blog\/wp-json\/wp\/v2\/media?parent=4379"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.boostsolutions.com\/blog\/wp-json\/wp\/v2\/categories?post=4379"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.boostsolutions.com\/blog\/wp-json\/wp\/v2\/tags?post=4379"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
public virtual Guid WorkItemType()<\/pre>\n
protected virtual bool ProcessWorkItem(\r\n\tSPContentDatabase contentDatabase,\r\n\tSPWorkItemCollection workItems,\r\n\tSPWorkItem workItem,\r\n\tSPJobState jobState\r\n)<\/pre>\n
public Guid AddWorkItem(\r\n\tGuid gWorkItemId,\r\n\tDateTime schdDateTime,\r\n\tGuid gWorkItemType,\r\n\tGuid gWebId,\r\n\tGuid gParentId,\r\n\tint nItemId,\r\n\tbool fSetWebId,\r\n\tGuid gItemGuid,\r\n\tGuid gBatchId,\r\n\tint nUserId,\r\n\tbyte[] rgbBinaryPayload,\r\n\tstring strTextPayload,\r\n\tGuid gProcessingId\r\n)<\/pre>\n
public class MyWorkItemJobDefinition : SPWorkItemJobDefinition\r\n{\r\n\tpublic MyWorkItemJobDefinition (string name, SPWebApplication webApplication)\r\n\t\t: base (name, webApplication)\r\n\t{\r\n }\r\n\r\n public override Guid WorkItemType()\r\n {\r\n\treturn new Guid(\"6F9619FF-8B86-D011-B42D-00C04FC964FF\");\r\n }\r\n\r\n public override bool ProcessWorkItem(\r\n\t SPContentDatabase contentDatabase,\r\n\t SPWorkItemCollection workItems,\r\n\t SPWorkItem workItem,\r\n\t SPJobState jobState)\r\n {\r\n\t If(workItem != null)\r\n {\r\n\t using(SPSite site = new SPSite(workItem.SiteId))\r\n\t {\r\n\t\t using(SPWeb web = site.OpenWeb(workItem.WebId)\r\n\t\t {\r\n\t\t\t SPUtility.SendEmail(web,\r\n false,\r\n false,\r\n \"test@gmail.com\",\r\n \"test email\",\r\n \"this is a custom work item test email!\");\r\n }\r\n }\r\n\r\n \/\/the email will send every day, and of course, you can delete this work item too.\r\n DateTime newDeliverDate = DateTime.UtcNow.AddDays(1);\r\n workItems.UpdateWorkItem( workitem.Id, newDeliverDate, null, \"send again\");\r\n }\r\n }\r\n}<\/pre>\nsite.AddWorkItem( Guid.NewGuid(),\r\n DateTime.UtcNow.AddDays(0.5),\r\n new Guid(\"6F9619FF-8B86-D011-B42D-00C04FC964FF\"); \/\/ your work item type\r\n SPConetxt.Current.Web.Id,\r\n SPContext.Current.ListId,\r\n SPContext.Current.ItemId,\r\n true,\r\n SPContext.Current.ListItem.UniqueId,\r\n SPContext.Current.ListItem.UniqueId,\r\n SPContext.Current.Web.CurrentUser.ID,\r\n null,\r\n \"Custom work item test\",\r\n Guid.Empty);<\/pre>\n