Sharepoint 2010 / खोज अलर्ट का अनुकूलन

मैं IAlertNotifyHandler का उपयोग करके Sharepoint 2010 में खोज अलर्ट को अनुकूलित करने के अपने सफल अनुभव के बारे में बात करना चाहता हूं।

पहले, कार्य तुच्छ लग रहा था। ऐसा लगता है जैसे सब कुछ सरल है। MSDN प्रलेखन में प्रक्रिया का वर्णन करने वाला एक लेख है, अन्य संसाधनों पर उदाहरण हैं। लेकिन, जैसा कि यह पता चला है, सभी प्रकार के अलर्ट का अनुकूलन खोज को छोड़कर हर जगह वर्णित है। चूंकि मुझे पूरे इंटरनेट पर एक समाधान नहीं मिला, इसलिए मैं अपना खुद का पेश कर रहा हूं (शायद सबसे इष्टतम नहीं है, लेकिन काम कर रहा है)।

शर्त

एक SQL डेटाबेस है, जिसके माध्यम से शेयरपॉइंट को बिजनेस कनेक्टिविटी सर्विसेज (BCS) और एंटरप्राइज सर्च का उपयोग करके लागू किया जाता है। उपयोगकर्ता शेयरपॉइंट पर खोज परिणामों का आउटपुट उपयुक्त XSLT परिवर्तनों का उपयोग करके अनुकूलित किया गया है। इस प्रकार, उपयोगकर्ता, जब खोज करता है, तो इस रूप में लगभग परिणाम प्राप्त होता है (आधार काम कर रहा है - इसके बाद नाम और सभी को पार किया जाता है)।



शेयरपॉइंट का उपयोग करते हुए, उपयोगकर्ता प्रत्येक खोज क्वेरी के लिए अलर्ट असाइन कर सकते हैं जो डेटाबेस में परिवर्तन किए जाने पर ट्रिगर होते हैं। ट्रिगर होने पर, उपयोगकर्ता को निम्न के समान एक ईमेल प्राप्त होता है।



यही है, मानक अलर्ट XSLT परिवर्तनों को ध्यान में नहीं रखता है और उपयोगकर्ता को अपठनीय जानकारी देता है। इसलिए, कार्य ईमेल पाठ को पढ़ने योग्य रूप में परिवर्तित करते समय बनता है, जब खोज करते समय अधिमानतः एक ही होता है।

मानक चेतावनी अनुकूलन समाधान

सबसे पहले, मैं संक्षेप में एक मानक समाधान का वर्णन करूंगा जो खोज अलर्ट के लिए उपयुक्त नहीं है , लेकिन इसके कुछ हिस्सों (पैराग्राफ 2, 5-11) को फिर मेरे संस्करण को लॉन्च करने की आवश्यकता होगी।

1. क्लास क्लास 1 के साथ एक एलर्टहैंडलर डीएल बनाएं जो IAlertNotifyHandler इंटरफ़ेस को लागू करता है, ऑनऑनोटिफिकेशन पद्धति में हम वर्तमान अलर्ट टेक्स्ट प्राप्त कर सकते हैं और उसके अनुसार इसे संशोधित कर सकते हैं।

2. GAC में dll डालें

3. अलर्टटेम्पलेट्स.एक्सएलएम फाइल की एक प्रतिलिपि बनाएँ जो कि स्थित है: C: \ Program Files \ Common Files \ Microsoft Shared \ Web Server एक्सटेंशन \ 14 \ TEMPLATE \ XML। इस मामले में, हमेशा फ़ाइल की प्रतिलिपि को संशोधित करें और मूल नहीं (यह महत्वपूर्ण है, ताकि बाद में आप मानक हैंडलर पर वापस लौट सकें और गड़बड़ न करें)।

4. नई फ़ाइल का नाम दें (copy अलर्टटैम्स.एक्सएमएल) CustomAlertTemplates और इसे सहेजें। फाइल को निम्नानुसार संशोधित करें। प्रॉपर्टी को ब्लॉक करें और इस ब्लॉक में निम्नलिखित पंक्तियाँ जोड़ें:

< NotificationHandlerAssembly > AlertHandler, Version=1.0.0.0, Culture=neutral, PublicKeyToken=d59ecf2a3bd66904 </ NotificationHandlerAssembly >
< NotificationHandlerClassName > AlertHandler.Class1 </ NotificationHandlerClassName >
< NotificationHandlerProperties ></ NotificationHandlerProperties >

* This source code was highlighted with Source Code Highlighter .

अब पूरा ब्लॉक कुछ इस तरह दिखेगा:

< Properties >
< ImmediateNotificationExcludedFields > ID;Author;Editor;Modified_x0020_By;Created_x0020_By;_UIVersionString;ContentType;TaskGroup;IsCurrent;Attachments;NumComments; </ ImmediateNotificationExcludedFields >
< DigestNotificationExcludedFields > ID;Author;Editor;Modified_x0020_By;Created_x0020_By;_UIVersionString;ContentType;TaskGroup;IsCurrent;Attachments;NumComments; </ DigestNotificationExcludedFields >
< NotificationHandlerAssembly > AlertHandler, Version=1.0.0.0, Culture=neutral, PublicKeyToken=d59ecf2a3bd66904 </ NotificationHandlerAssembly >
< NotificationHandlerClassName > AlertHandler.Class1 </ NotificationHandlerClassName >
< NotificationHandlerProperties ></ NotificationHandlerProperties >
</ Properties >

* This source code was highlighted with Source Code Highlighter .

नोट: PublicKeyToken को C: \ windows \ असेंबली में ढूंढकर dll प्रॉपर्टीज में देखा जा सकता है।

5. C: \ Program Files \ Common Files \ Microsoft Shared \ web सर्वर एक्सटेंशन \ 14 \ BIN से कमांड चलाएँ: stsadm -o updatealerttemplates -filename "C: \ Program Files \ Common Files \ Microsoft सर्वर \ Web सर्वर एक्सटेंशन \ 14 \" TEMPLATE \ XML \ customalerttemplates.xml "-url 6. कमांड चलाएँ: stsadm -o setproperty -pn job-तत्काल-अलर्ट -pv" हर 1 मिनट में "यह केवल परीक्षण के लिए है। परीक्षण के बाद वापस लौटें।

7. सत्यापित करें कि SharePoint आउटगोइंग ईमेल भेजने के लिए कॉन्फ़िगर किया गया है।

8. सुनिश्चित करें कि यदि आप किसी दस्तावेज़ लायब्रेरी पर परीक्षण कर रहे हैं, तो उदाहरण के लिए दस्तावेज़ लाइब्रेरी चालू है।

9. कमांड चलाएँ: iisreset

10. कमांड चलाएँ: services.msc

11. Windows SharePoint सेवाएँ टाइमर को पुनरारंभ करें।

मानक समाधान समस्या

सब कुछ बहुत अच्छा है, सब कुछ काम करता है, लेकिन खोज अलर्ट के मामले के लिए नहीं। OnNotification विधि (SPAlertHandlerParams ahp) में खोज अलर्ट के लिए, वास्तव में अनुकूलन के लिए आवश्यक ahp.eventData और ahp.body फ़ील्ड के मान नहीं आते हैं।

Social.technet.microsoft.com फ़ोरम पर मेरे प्रश्नों के जवाब में , मुझे निम्नलिखित जानकारी प्राप्त हुई।

सबसे पहले, आप निम्नलिखित के रूप में IAlertNotifyHandler का उपयोग करके SharePoint अलर्ट को कस्टम कर सकते हैं:
blogs.msdn.com/b/sharepointdeveloperdocs/archive/2007/12/14/how-to-customizing-alert-emails-using-ialertnotificationhandler.aspx
दूसरा, आपको संशोधित करने के लिए कोई खोज चेतावनी ईमेल टेम्पलेट नहीं है।
सभी अलर्ट टेम्पलेट: msdn.microsoft.com/en-us/library/bb802738.aspx

यही है, यह पता चला है कि कोई समाधान नहीं है? .. लेकिन जब से मुझे लड़ाई के बिना छोड़ने के लिए उपयोग नहीं किया गया था, मैंने इंटरनेट से बिट जानकारी द्वारा थोड़ा सा इकट्ठा करना जारी रखा। और यह वही है जो यह आया था।

मेरा विकल्प

1. मंचों को पढ़ने से पता चला कि खोज अलर्ट को संसाधित करने के लिए, सबसे पहले, आपको एक नए प्रकार के AlertTemplate - "OSS.Search" को जोड़ना होगा। CustomAlertTemplates फ़ाइल में जोड़ें।

< AlertTemplate Type ="Custom" Name ="OSS.Search" AlwaysNotify ="True" DefaultTitle ="Search" >
< EventTypes IsVisible ="True" >
< EventType Mask ="0x1" Selected ="true" > $Resources:Microsoft.Office.Server.Search,SearchResults_ATEventDiscovered; </ EventType >
< EventType Mask ="0x2" > $Resources:Microsoft.Office.Server.Search,SearchResults_ATEventModified; </ EventType >
< EventType Mask ="0x3" > $Resources:Microsoft.Office.Server.Search,SearchResults_ATEventAll; </ EventType >
</ EventTypes >
< Frequency IsVisible ="true" ShowImmediate ="false" ShowDaily ="true" ShowWeekly ="true" ShowTime ="false" DefaultFrequency ="Daily" />
< Filters IsVisible ="false" />
< Properties >
< NotificationHandlerAssembly > mySearchAlert, Version=1.0.0.0, Culture=neutral, PublicKeyToken=aa1e89f3cc0ef56b </ NotificationHandlerAssembly >
< NotificationHandlerClassName > mySearchAlert.MySearchAlertHandler </ NotificationHandlerClassName >
< NotificationHandlerProperties ></ NotificationHandlerProperties >
< UpdateHandlerAssembly > mySearchAlert, Version=1.0.0.0, Culture=neutral, PublicKeyToken=aa1e89f3cc0ef56b </ UpdateHandlerAssembly >
< UpdateHandlerClassName > mySearchAlert.MySearchUpdateAlertHandler </ UpdateHandlerClassName >
< UpdateHandlerProperties ></ UpdateHandlerProperties >
</ Properties >
</ AlertTemplate >

* This source code was highlighted with Source Code Highlighter .

यह ध्यान रखना महत्वपूर्ण है कि मानक हैंडलर पर वापस लौटने के लिए, पहले सहेजी गई मानक फ़ाइल पर्याप्त नहीं है, इसलिए मानक अलर्टटैम्पलेट। Xml को फ़ाइल में कॉपी करें, उदाहरण के लिए, अलर्टटेम्पलेट_forRestore.xml में और निम्न अनुभाग जोड़ें

< AlertTemplate Type ="Custom" Name ="OSS.Search" AlwaysNotify ="True" DefaultTitle ="Search" >
< EventTypes IsVisible ="True" >
< EventType Mask ="0x1" Selected ="true" > $Resources:Microsoft.Office.Server.Search,SearchResults_ATEventDiscovered; </ EventType >
< EventType Mask ="0x2" > $Resources:Microsoft.Office.Server.Search,SearchResults_ATEventModified; </ EventType >
< EventType Mask ="0x3" > $Resources:Microsoft.Office.Server.Search,SearchResults_ATEventAll; </ EventType >
</ EventTypes >
< Frequency IsVisible ="true" ShowImmediate ="false" ShowDaily ="true" ShowWeekly ="true" ShowTime ="false" DefaultFrequency ="Daily" />
< Filters IsVisible ="false" />
< Properties >
< NotificationHandlerAssembly > Microsoft.Office.Server.Search, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c </ NotificationHandlerAssembly >
< NotificationHandlerClassName > Microsoft.Office.Server.Search.Query.SearchAlertHandler </ NotificationHandlerClassName >
< NotificationHandlerProperties ></ NotificationHandlerProperties >
< UpdateHandlerAssembly > Microsoft.Office.Server.Search, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c </ UpdateHandlerAssembly >
< UpdateHandlerClassName > Microsoft.Office.Server.Search.Query.SearchAlertHandler </ UpdateHandlerClassName >
< UpdateHandlerProperties ></ UpdateHandlerProperties >
</ Properties >
</ AlertTemplate >

* This source code was highlighted with Source Code Highlighter .

हम सावधानी से स्टोर करते हैं अलर्टटेम्पलेट्स_फोर्सस्टोर.एक्सएमएल फाइल - मानक हैंडलर को रोलबैक इसके बिना असंभव है।

2. मेरे दिमाग को इधर-उधर करने के बाद, मैंने सोचा कि, जब मानक समाधान का उपयोग किया जाता है, तो सूचना का कुछ हिस्सा अभी भी हमारे पास आता है, तो आप इसे शुरू कर सकते हैं। और मैंने पाया कि शायद सबसे सुरुचिपूर्ण नहीं है, लेकिन एक काम कर समाधान।

• संसाधित किए जा रहे अलर्ट के बारे में जानकारी का उपयोग करते हुए, मैं प्रोग्रामेटिक रूप से नया अस्थायी खोज अलर्ट SearchAlert alert2 = new SearchAlert (s1, q1) बनाता हूं;
• मैं संसाधित अलर्ट के खोज स्ट्रिंग का उपयोग करके शेयरपॉइंट सर्वर पर एक खोज क्वेरी बनाता हूं - Search.Query.Query क्वेरी = alert2.CreateSearchQuery
  परावर्तन का उपयोग करते हुए मैंने हमारी क्वेरी क्वेरी की आंतरिक AlertInfo संपत्ति सेट की, LastUpdateTime को हमारे द्वारा आवश्यक मान पर सेट (अंतिम चेतावनी से केवल परिवर्तित रिकॉर्ड प्राप्त करने के लिए) और क्वेरी परिणाम प्राप्त करें
• मुझे FullTextSqlQuery का उपयोग करते हुए SQL डेटाबेस से अतिरिक्त जानकारी मिलती है
• मेरे द्वारा बनाए गए अलर्ट 2 को हटा दें
• मैं क्वेरी में प्राप्त SQL डेटाबेस फ़ील्ड और Saherepoint 2010 फ़ील्ड के आधार पर अपना मुख्य HTML शरीर पाठ उत्पन्न कर रहा हूं।

मैं सभी कोड पूरी तरह से नहीं दूंगा (यह लंबा है) - केवल मुख्य बिंदु।

public class MySearchAlertHandler : IAlertNotifyHandler
//
public bool OnNotification(SPAlertHandlerParams alertHandler)
{
...
return CustomAlertNotification(alertHandler);
...
}


public bool CustomAlertNotification(SPAlertHandlerParams alertHandlerParams)
{
string myBody = "" ;
SPSite site = null ;
int searchAlertNotificationQuota = 200;
TimeSpan span;
SPAlert a = alertHandlerParams.a;


site = new SPSite(alertHandlerParams.siteUrl+ alertHandlerParams.webUrl;);


// alertTime span

DateTime alertTime = a.AlertTime;
if (a.AlertFrequency == SPAlertFrequency.Weekly)
{
span = TimeSpan .FromDays(7.0);
}
else
{
span = TimeSpan .FromDays(1.0);
}

if ((alertTime + span) <= DateTime .Now)
{
return true ;
}

using (SPWeb web = site.OpenWeb())
{


// ( ) queryText

string queryText = Utils.GetValueFromXML(a.Properties[ "p_query" ], "QueryText" );

SPSite s1 = new SPSite (alertHandlerParams.siteUrl+alertHandlerParams.webUrl );
Query q1 = new KeywordQuery(s1);
q1.QueryText = queryText;

// alert2,

SearchAlert alert2 = new SearchAlert(s1,q1);
alert2.ChangeType = AlertChangeType.DiscoveredOrModified;
alert2.InnerAlert.AlertFrequency = alertHandlerParams.a.AlertFrequency ;
alert2.InnerAlert.Title = "Temp#1" ;
alert2.InnerAlert.EventType = alertHandlerParams.a.EventType;
alert2.InnerAlert.User = s1.OpenWeb().CurrentUser ;
alert2.InnerAlert.AlertType = alertHandlerParams.a.AlertType;
alert2.Update();


// query alert2 queryText

using (Microsoft.Office.Server.Search.Query.Query query = alert2.CreateSearchQuery ())
{
ResultTableCollection tables;

query.QueryText = queryText;
query.RowLimit = searchAlertNotificationQuota;
query.TrimDuplicates = false ;

// , , , .
, Reflection internal AlertInfo query, LastUpdateTime

AlertInfo ai = new AlertInfo();
ai.ChangeType = alert2.ChangeType;
ai.LastUpdateTime = alertTime - span;

Type t1 = query.GetType();
if (t1.GetProperty( "AlertInfo" , System.Reflection.BindingFlags.Public | System.Reflection.BindingFlags.NonPublic |
System.Reflection.BindingFlags.Instance) == null )
throw new ArgumentOutOfRangeException( "propName" , string .Format( "Property {0} was not found in Type {1}" ,
"AlertInfo" , query.GetType().FullName));
t1.InvokeMember( "AlertInfo" , System.Reflection.BindingFlags.Public | System.Reflection.BindingFlags.NonPublic | System.Reflection.BindingFlags.SetProperty |
System.Reflection.BindingFlags.Instance, null , query, new object [] { ai });


// query

ResultTable result = null ;
try
{
tables = query.Execute();
}
catch
{
alert2.Delete();
return false ;
}

result = tables[ResultType.RelevantResults];

// result - alert2 -


alert2.Delete();

// DataTable . - WorkId, Rank, Title, Author, Size, Path, Description, Write, SiteName, CollapsingStatus, HitHighlightedSummary, HitHighlightedProperties, ContentClass, IsDocument, PictureThumbnailURL

// DiscoveredTime

System.Data.DataTable myTable = new System.Data.DataTable();
myTable.Load(result2, System.Data.LoadOption.OverwriteChanges);

foreach (System.Data.DataRow myrow in myTable.Rows)
{
if ( Convert .ToDateTime(myrow[ "DiscoveredTime" ]) > alertTime - span)
{
//
}
else
{
//
}
}

// , SQL, FullTextSqlQuery

FullTextSqlQuery fts = new FullTextSqlQuery(site2);
fts.QueryText = "SELECT WorkId, Rank, Title, Author, Size, Path, Description, Write, SiteName, CollapsingStatus, HitHighlightedSummary, HitHighlightedProperties, ContentClass, IsDocument, PictureThumbnailURL, PopularSocialTags, PictureWidth, PictureHeight, DatePictureTaken, ServerRedirectedURL, ErgebnisKenntnis, LetzterKontakt, Kandidatenmail FROM SCOPE() WHERE Path='" + myrow[ "Path" ].ToString() + "'" ;
fts.ResultTypes = ResultType.RelevantResults;
fts.RowLimit = 300;
ResultTableCollection rtc = fts.Execute();

* This source code was highlighted with Source Code Highlighter .

जहाँ ErgebnisKenntnis, LetzterKontakt, Kandidatenmail SQL डेटाबेस के क्षेत्र हैं (केवल उदाहरण के लिए दिखाए गए हैं)। उनके माध्यम से खोज करने में सक्षम होने के लिए, यह महत्वपूर्ण है कि ये फ़ील्ड Sharepoint 2010 सर्वर की मेटाडेटा संपत्ति में पंजीकृत हैं।

अब हम SQL डेटाबेस, शेयरपॉइंट के किसी भी क्षेत्र का उपयोग करके myBody संदेश का HTML निकाय बना सकते हैं, और अंत में हम इसे उपयोगकर्ता को भेजना नहीं भूलते।

SPUtility.SendEmail(web, false , false , string .Format( "{0}" , alertHandlerParams.headers[ "To" ]),
string .Format( "{0}" , alertHandlerParams.headers[ "Subject" ]), myBody);

* This source code was highlighted with Source Code Highlighter .

अब, मानक समाधान के पैराग्राफ 2, 5-11 को पूरा करने के बाद, उपयोगकर्ताओं को खोज अलर्ट प्राप्त होगा, उदाहरण के लिए, इस रूप में।



सब कुछ, समस्या हल हो गई है। मुझे इंटरनेट पर अन्य तरीके नहीं मिले, इसलिए मुझे खुशी होगी अगर मेरा समाधान किसी की मदद करता है।