邮件通知定制

Moss自帶的發郵件通知(提酲我)功能往往達不到客戶想要的效果，下面我將介紹一下怎麼樣自定義這個通知(提酲我)的郵件內容。

1.      先了解通知(提酲我)的基本知識

a.       通知(提酲我)是由WSS的定時執行程式(Windows SharePoint Services Timer)來定時發郵件提醒的,在這之前請確保這個服務已經啟用，如果啟用了可以在工作管理員下的處理程序中看到有一個OWSTIMER.EXE的進程

b.      所發送通知(提酲我)的主旨與內容格式默認是在12"TEMPLATE"XML"alerttemplates.xml文件中定義的(註：此文件是不可以修改的)

c.       alerttemplates.xml中定義了各種類型的郵件模板，包括

ü   SPAlertTemplateType.GenericList：如沒有使用以下模板，則用此模板

ü   SPAlertTemplateType.DocumentLibrary：有关对文档库所做更改的通知

ü   SPAlertTemplateType.Survey：有关对调查所做更改的通知

ü   SPAlertTemplateType.Links：有关对链接所做更改的通知

ü   SPAlertTemplateType.Announcements：有关对声明所做更改的通知

ü   SPAlertTemplateType.Contacts：有关对联系人所做更改的通知

ü   SPAlertTemplateType.Events：有关对事件所做更改的通知

ü   SPAlertTemplateType.Tasks：有关对任务所做更改的通知

ü   SPAlertTemplateType.DiscussionBoard：有关对讨论板所做更改的通知

ü   SPAlertTemplateType.PictureLibrary：有关对图片库所做更改的通知

ü   SPAlertTemplateType.XMLForm：有关对 XML 表单所做更改的通知

ü   SPAlertTemplateType.DataConnectionLibrary：有关对数据连接库所做更改的通知

ü   SPAlertTemplateType.AssignedtoNotification：有关分配到任务列表和问题列表的通知

d.   通知的格式定義了郵件的內容，通知發送郵件的條件等，且其內容是由CAML組成
<AlertTemplate Type="List" Name="SPAlertTemplateType.GenericList">

 <Format>

    <Digest>

      <Subject>

      </Subject>

      <Header>

      </Header>

      <HeaderFieldsHeader>

      </HeaderFieldsHeader>

      <HeaderFields>

      </HeaderFields>

      <HeaderFieldsFooter>

      </HeaderFieldsFooter>

      <RowHeader>

      </RowHeader>

      <RowFields>

      </RowFields>

      <RowFooter>

      </RowFooter>

      <Footer>

      </Footer>

    </Digest>

    <Immediate>

      <Subject>

      </Subject>

      <Header>

      </Header>

      <Fields>

      </Fields>

      <Footer>

      </Footer>

    </Immediate>

 </Format>

 <Properties>

    <ImmediateNotificationExcludedFields>

    </ImmediateNotificationExcludedFields>

    <DigestNotificationExcludedFields>

    </DigestNotificationExcludedFields>

    <NotificationHandlerAssembly>

      Handler assembly strong name

    </NotificationHandlerAssembly>

    <NotificationHandlerClassName>

      Fully qualified class name

    </NotificationHandlerClassName>

    <NotificationHandlerProperties>

      Other option properties you want to pass

    </NotificationHandlerProperties>

    <UpdateHandlerAssembly>

      Assembly

    </UpdateHandlerAssembly>

    <UpdateHandlerClassName>

      Class name

    </UpdateHandlerClassName>

    <UpdateHandlerProperties>

      Other properties

    </UpdateHandlerProperties>

 </Properties>

 <Filters>

    <FilterDefinition>

      <FriendlyName></FriendlyName>

      <ShortName></ShortName>

      <Query>

        <Neq>

          <FieldRef name="EventDate/New"/>

          <FieldRef name="EventDate/Old"/>

        </Neq>

      </Query>

    </FilterDefinition>

 </Filters>

</AlertTemplate>

e.       如果要自定義某種類型的通知(如自定義文檔庫的通知),請先拷由一份alerttemplates.xml文件將其命名為其它的名稱(如CustomAlerttemplates.xml),再在CustomAlerttemplates.xml文件中修改其通知格式,修改完成後執行stsadm -o updatealerttemplates -filename "C:"Program Files"Common Files"Microsoft Shared"Web Server Extensions"12"TEMPLATE"XML"customalerttemplates.xml" -url your_sharepoint_site url與 stsadm -o setproperty -pn job-immediate-alerts -pv "every 1 minutes"
再IISRESET與重新啟用Windows SharePoint Services Timer服務即可

2.      使用DONET開發自義的通知

1.      創建一個類庫(如：CustomAlertTemplate)

2.      給這個類庫加上強命名空間

3.      引用Microsoft.SharePoint與Microsoft.SharePoint.Utilities;

4.      創建一個類(名稱如DocAlertTemplate)

5.      將這個類繼承自接口IAlertNotifyHandler

6.      實現IAlertNotifyHandler的OnNotification方法

7.      在OnNotification方法中調用SPUtility.SendEmail來發送郵件

8.      編輯這個類庫，將dll文件拖到GAC中去

9.      拷由一分alerttemplates.xml文件，重命名為CustomAlerttemplates.xml

10. 在CustomAlerttemplates.xml文件中找到SPAlertTemplateType.DocumentLibrary模板，在這個模板下的Properties節點中加入
<NotificationHandlerAssembly>CustomAlertTemplate, Version=1.0.0.0, Culture=neutral, PublicKeyToken=xxx</NotificationHandlerAssembly>   <NotificationHandlerClassName>CustomAlertTemplate.DocAlertTemplate</NotificationHandlerClassName>

<NotificationHandlerProperties></NotificationHandlerProperties>

11. 當然CustomAlerttemplates.xml文件中除了SPAlertTemplateType.DocumentLibrary模板以外的其它模板你也可以刪除也可以不刪除,而SPAlertTemplateType.DocumentLibrary模板的內容也可以為空,不過最後不要為空，如果為空的話，你在OnNotification方法中就取不到默認的內容了

12. 執行stsadm -o updatealerttemplates -filename "C:"Program Files"Common Files"Microsoft Shared"Web Server Extensions"12"TEMPLATE"XML"customalerttemplates.xml" -url your_sharepoint_site url 與 stsadm -o setproperty -pn job-immediate-alerts -pv "every 1 minutes"
再IISRESET與重新啟用Windows SharePoint Services Timer服務即可

3.      在開發過程中要註意的事項

a.       調試文件請附附加處理程序OWSTIMER.EXE而不是w3wp.exe

b.      如果不是第一次部署，而是部署後再更新了DLL文件，再將DLL文件拖到GAC目錄中去，那麼每次都要執行IISRESET與重起Windows SharePoint Services Timer服務才行

c.       如果是更新DLL文件再調試，這個時候應該跟蹤不到，必須讓服務執行一次後才能跟蹤到(如你定義的是A文件庫的通知，那麼更新後，必須先由A發送一次後，再執行a步驟即可以調試)