Camlex 3.2: इंजीनियरिंग CAML को उल्टा कर दें और लैंबडा एक्सप्रेशन का उपयोग करके शेयरपॉइंट में स्ट्रिंग क्वेरीज में स्थितियां जोड़ें

कुछ समय पहले, हमारे ओपन सोर्स Camlex.Net प्रोजेक्ट की अगली रिलीज़ जारी की गई थी। काफी दिलचस्प कार्यक्षमता 3.2 संस्करण में जोड़ा गया था, जिसके बारे में मैं इस लेख में बात करना चाहूंगा।

सबसे पहले, कैम्लेक्स क्या है और यह कैसे विकास में मदद करता है, इसके बारे में कुछ शब्द। यदि आप Sharepoint के साथ काम कर रहे हैं, तो आप सबसे अधिक संभावना CAML अनुरोध लिखने के लिए सामना करना पड़ा है। CAML (सहयोगी अनुप्रयोग मार्कअप भाषा) एक विशेष भाषा है जिसका उपयोग विभिन्न उद्देश्यों के लिए Sharepoint में किया जाता है। इसका एक उपयोग शीट और दस्तावेज़ पुस्तकालयों से डेटा लाने के लिए Sql जैसी क्वेरीज़ लिखना है। उदाहरण के लिए, सूची से सभी वस्तुओं का चयन करने के लिए, शीर्षक फ़ील्ड का मान "मीटिंग" है और विवरण "शेयर पॉइंट" है, आपको निम्न क्वेरी का उपयोग करने की आवश्यकता है:

<Where> <And> <Eq> <FieldRef Name="Title" /> <Value Type="Text">Meeting</Value> </Eq> <Eq> <FieldRef Name="Description" /> <Value Type="Text">Sharepoint</Value> </Eq> </And> </Where> 

यदि आपको अनुरोध में अधिक शर्तें जोड़ने की आवश्यकता है, तो आपको पूरे Xml पेड़ को फिर से बनाना होगा (CAML में, और और तत्व केवल 2 ऑपरेंड हो सकते हैं)। इसके अलावा, यदि आप स्ट्रिंग्स के साथ काम करते हैं, तो कंपाइलर आपकी मदद नहीं करता है, संकलन चरण पर त्रुटियों को पकड़ता है।

Camlex के साथ, आप इस क्वेरी को C # में लैम्बडा एक्सप्रेशन का उपयोग करके लिख सकते हैं:

 string query = Camlex.Query() .Where(x => (string)x["Title"] == "Meeting" && (string)x["Description"] == "Sharepoint").ToString(); 

इसके अलावा, कैम्लेक्स में एप्लिकेशन डेवलपर्स के लिए कई उपयोगी चीजें हैं। अधिक विवरण हमीर पर एक अन्य लेख में पाया जा सकता है, जो लगभग 2 साल पहले प्रकाशित हुआ था, जब हमने परियोजना का पहला संस्करण (हम और व्लादिमीर तमाशकोव ) जारी किया था: SharePoint में CAML अनुरोधों के निर्माण के लिए लंबोदा का उपयोग करना , साथ ही साथ मेरे ब्लॉग लेख पर Camlex.Net को टैग किया गया: http://sadomovalex.blogspot.fi/search/label/Camlex.NET ।

अब सीधे पोस्ट के विषय पर। लगभग छह महीने पहले, हमने परियोजना में काफी गैर-तुच्छ कार्यक्षमता जोड़ी: CAML रिवर्स इंजीनियरिंग। यह आपको स्ट्रिंग प्रश्नों को पार्स करने और उनके आधार पर एक अभिव्यक्ति ट्री बनाने की अनुमति देता है। रिवर्स इंजीनियरिंग का उपयोग करते हुए, हमने मुफ्त ऑनलाइन सेवा http://camlex-online.org शुरू की, जिसके साथ आप स्ट्रिंग CAML अनुरोधों को C # कोड में बदल सकते हैं। यानी कैंलेक्स ने दूसरे रास्ते से बाहर कर दिया। यदि विवरण दिलचस्प हैं, तो अभिव्यक्ति पेड़ से C # कोड पीढ़ी एक और ओपन-सोर्स प्रोजेक्ट ExpressionToCode का उपयोग करके किया गया था (हालांकि हमारे द्वारा थोड़ा सा)।

हाल ही में, हमें कई अनुरोध मिले: डेवलपर्स ने पूछा कि क्या मौजूदा सीएएमएल अनुरोधों में अतिरिक्त शर्तें जोड़ना संभव है? कार्य मुझे दिलचस्प लगा, यह देखते हुए कि हमारे पास पहले से ही रिवर्स इंजीनियरिंग है, जो काफी संभव है। संस्करण 3.2 में, इस कार्यक्षमता को जोड़ा गया था। अब आप साधारण स्ट्रिंग क्वेरीज़ के साथ काम करने वाले टूल के साथ कैम्लेक्स का उपयोग कर सकते हैं, उन्हें कैम्लेक्स के साथ विस्तारित करें और परिणाम को स्ट्रिंग के रूप में वापस दें।

एक उदाहरण देखते हैं। कल्पना करें कि हमारे पास निम्नलिखित प्रश्न हैं:

 <Where> <Eq> <FieldRef Name="Title" /> <Value Type="Text">Sharepoint</Value> </Eq> </Where> 

वह हमें "शेयर पॉइंट" शीर्षक के साथ आइटम लौटाएगा। मान लें कि हमें "कार्यालय" शीर्षक के साथ आइटम प्राप्त करने के लिए अनुरोध में एक और शर्त जोड़ने की आवश्यकता है। अब इसे इस तरह किया जा सकता है:

 string query = Camlex.Query().WhereAny(existingQuery, x => (string)x["Title"] == "Office").ToString(); 

यानी बस स्ट्रिंग अनुरोध और नई स्थिति को लंबोदर अभिव्यक्ति के रूप में पास करें। परिणाम इस प्रकार होगा:

 <Where> <Or> <Eq> <FieldRef Name="Title" /> <Value Type="Text">Sharepoint</Value> </Eq> <Eq> <FieldRef Name="Title" /> <Value Type="Text">Office</Value> </Eq> </Or> </Where> 

आप एक से अधिक जटिल स्ट्रिंग क्वेरी में कई शर्तें जोड़ सकते हैं। यहां उन तरीकों की एक सूची दी गई है जिनके द्वारा IQuery इंटरफ़ेस को बढ़ाया गया है:

 public interface IQuery { // ... IQuery WhereAll(string existingWhere, Expression<Func<SPListItem, bool>> expression); IQuery WhereAll(string existingWhere, IEnumerable<Expression<Func<SPListItem, bool>>> expressions); IQuery WhereAny(string existingWhere, Expression<Func<SPListItem, bool>> expression); IQuery WhereAny(string existingWhere, IEnumerable<Expression<Func<SPListItem, bool>>> expressions); IQuery OrderBy(string existingOrderBy, Expression<Func<SPListItem, object>> expr); IQuery OrderBy(string existingOrderBy, Expression<Func<SPListItem, object[]>> expr); IQuery OrderBy(string existingOrderBy, IEnumerable<Expression<Func<SPListItem, object>>> expressions); IQuery GroupBy(string existingGroupBy, Expression<Func<SPListItem, object>> expr); IQuery GroupBy(string existingGroupBy, Expression<Func<SPListItem, object[]>> expr); } 

यानी आप न केवल क्वेरी की स्थिति (कहां और कहां) का विस्तार कर सकते हैं, बल्कि ऑर्डरबी और ग्रुपबी भी कर सकते हैं। आप ViewFields का विस्तार भी कर सकते हैं, लेकिन ये विधियाँ भिन्न इंटरफ़ेस में हैं, क्योंकि क्वेरी बनाते समय समग्र कॉल श्रृंखला का हिस्सा नहीं होते हैं।

एक अधिक जटिल उदाहरण पर विचार करें। स्ट्रिंग क्वेरी में जोड़ें जो हमें एक ही बार में दो शर्तों से ऊपर मिली: उन तत्वों का भी चयन करें जिनमें प्रतिभागियों की संख्या 1 से अधिक है और स्थिति खाली नहीं है:

 string existingQuery = "<Where>" + " <And>" + " <Eq>" + " <FieldRef Name=\"Title\" />" + " <Value Type=\"Text\">Sharepoint</Value>" + " </Eq>" + " <Eq>" + " <FieldRef Name=\"Title\" />" + " <Value Type=\"Text\">Office</Value>" + " </Eq>" + " </And>" + "</Where>"; var query = Camlex.Query().WhereAny(existingQuery, x => (int)x["Participants"] > 1 && x["Status"] != null).ToString(); 

नतीजतन, हम प्राप्त करते हैं:

 <Where> <Or> <And> <Gt> <FieldRef Name="Participants" /> <Value Type="Integer">1</Value> </Gt> <IsNotNull> <FieldRef Name="Status" /> </IsNotNull> </And> <And> <Eq> <FieldRef Name="Title" /> <Value Type="Text">Sharepoint</Value> </Eq> <Eq> <FieldRef Name="Title" /> <Value Type="Text">Office</Value> </Eq> </And> </Or> </Where> 

यानी कैम्प्लेक्स खुद के लिए एक बल्कि जटिल CAML अनुरोध के गठन पर सभी काम लेता है।

अंत में, मैं कहना चाहूंगा कि कैम्लेक्स एक ऐसी परियोजना है जो समुदाय की जरूरतों से विकसित होती है। यदि आपके पास नई कार्यक्षमता जोड़ने के लिए विचार और सुझाव हैं, तो उन्हें चर्चा अनुभाग में प्रोजेक्ट वेबसाइट पर लिखें। हम सभी सवालों के जवाब देने की कोशिश करते हैं और जहां तक ​​संभव हो, नई कार्यक्षमता जोड़ते हैं।