🗂️ 🗯️ 💦 ईडब्ल्यूएस के माध्यम से एमएस एक्सचेंज सर्वर पर मेल के साथ काम करें। भाग 1 🦒 🌎 🤱🏻

हेलो रीडर्स हबरहाब!

इन पदों की एक श्रृंखला के भाग के रूप में, मैं ईडब्ल्यूएस जैसी तकनीक के बारे में बात करना चाहता हूं और एमएस एक्सचेंज 2007 - 2010 के सर्वर पर संग्रहीत मेल के साथ काम करने के लिए इसका उपयोग कैसे करना है। मैं यह दिखाने की कोशिश करूंगा कि ईडब्ल्यूएस का उपयोग करना कितना सरल और सुविधाजनक है।

हम इस तकनीक से खुद को परिचित करने और पहले प्रोजेक्ट बनाने, और अधिक जटिल मेल जोड़तोड़ के साथ समाप्त होने से शुरुआत करेंगे।

यह पद एक परिचयात्मक पद है और सबसे अधिक संभावना है कि यह उन लोगों के लिए दिलचस्प नहीं होगा जो पहले से ही ईडब्ल्यूएस से परिचित हैं।

परिचय

एक्सचेंज वेब सर्विसेज ( ईडब्ल्यूएस ) एमएस द्वारा विकसित और एमएस एक्सचेंज बनाने वाले मेल और अन्य घटकों को प्रबंधित करने के लिए डिज़ाइन किया गया एक विशेष प्रोटोकॉल है। प्रोटोकॉल XML पर आधारित है। समर्थित संचालन और उदाहरणों का विवरण यहां पाया जा सकता है ।

EWS एक अपेक्षाकृत युवा तकनीक है जिसे एक्सचेंज 2007 में शुरू किया गया और इसने WebDAV प्रोटोकॉल को प्रतिस्थापित किया। एमएस ईडब्ल्यूएस के विकास और सुधार में बहुत प्रयास करता है। अब यह एक सरल और सहज एपीआई के साथ-साथ उत्कृष्ट प्रलेखन के साथ एक शक्तिशाली उपकरण है, जो आपको एमएस एक्सचेंज वस्तुओं के प्रबंधन की समस्याओं को हल करने की अनुमति देता है।

EWS आर्किटेक्चर को निम्न चित्र में दिखाया गया है:

जैसा कि आप देख सकते हैं, ईडब्ल्यूएस को क्लाइंट एक्सेस सर्वर (सीएएस) की भूमिका वाले सर्वरों पर होस्ट किया गया है। यह भूमिका उपयोगकर्ता से प्रसंस्करण अनुरोधों के लिए जिम्मेदार है, अर्थात्। आउटलुक, MFCMapi, ब्राउज़र + OWA, आदि जैसे सभी क्लाइंट, ये सभी CAS से जुड़े हैं। क्लाइंट एप्लिकेशन से अनुरोध IIS में गिरता है, जहां ईडब्ल्यूएस कार्यक्षमता को लागू करने वाला एप्लिकेशन स्थित है। यानी EWS IIS में "रहता है" और एक अलग प्रक्रिया में चलता है या w3wp.exe (ऐसी प्रक्रिया जिसमें IIS एप्लिकेशन पूल निष्पादित होते हैं) को चलाता है। EWS के अलावा, OWA, ECP और पॉवरशेल जैसे अन्य एप्लिकेशन वहां स्पिन कर सकते हैं।

EWS क्लाइंट रिक्वेस्ट और एक्सचेंज इंटर्नल के बीच एक लेयर का काम करता है। जब एक ईडब्ल्यूएस अनुरोध क्लाइंट एप्लिकेशन से आता है, तो इसे आंतरिक एक्सचेंज कॉल के लिए अनुमानित किया जाता है, जिसके बाद यह मेलबॉक्स सर्वर भूमिका में आता है, जहां ऑपरेशन खुद ही पहले से ही किए जाते हैं।

नोट: मेलबॉक्स की आंतरिक संरचना के बारे में थोड़ा मेरे पिछले लेख में पाया जा सकता है।

शारीरिक रूप से, EWS .NET असेंबली के एक सेट के अंदर स्थित है। और एक्सचेंज 2010 से शुरू होकर, न केवल ईडब्ल्यूएस कॉल, बल्कि ओडब्ल्यूए भी वहां मिलता है। यानी एमएस ने स्पष्ट रूप से महसूस किया कि समान कार्यक्षमता कोड की कई शाखाओं का विचार सफल नहीं था और केवल एक शाखा को छोड़ने का फैसला किया, जिसे समर्थन और विकास को सरल और तेज करना चाहिए।

हमें एक सामान्य विचार मिला, हम प्रोग्रामिंग पर आगे बढ़ सकते हैं।

डिज़ाइन

हमें आवश्यकता होगी:

एमएस एक्सचेंज सर्वर 2007 - 2010 परीक्षण के लिए
विजुअल स्टूडियो 2008 - 2010

सबसे पहले, खाली C # कंसोल प्रोजेक्ट बनाएं। इसके बाद, आपको उन वर्गों / विधियों / प्रकारों आदि के विवरण के साथ संदर्भ जोड़ने की आवश्यकता है, जिन्हें हमें ईडब्ल्यूएस के साथ काम करने की आवश्यकता है। ऐसा करने का सबसे आसान तरीका, यदि आपके पास एक्सचेंज है, तो वेब संदर्भ जोड़ना है। VS 2010 में, आपको एक प्रोजेक्ट का चयन करना होगा और Add Service Rederence का चयन करना होगा , फिर उन्नत , वेब संदर्भ जोड़ें और URL फ़ील्ड में अपने परीक्षण सर्वर के पते को https: // [सर्वर नाम] /EWS/Services.wsdl , अर्थात् में निर्दिष्ट करें यह इस तरह दिखना चाहिए:

अगला क्लिक करने के बाद, संदर्भ का डाउनलोड शुरू हो जाएगा, और अगर सब कुछ ठीक हो जाता है, तो आपको इस संदर्भ का नाम इंगित करने के लिए कहा जाएगा, और अंत में इसे परियोजना में जोड़ा जाएगा।

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

public static ExchangeServiceBinding GetBinding( String server, String domain, String user, String password) { var esb = new ExchangeServiceBinding(); //    esb.Credentials = new NetworkCredential(user, password, domain); //     EWS esb.Url = "https://" + server + "/EWS/Exchange.asmx"; esb.RequestServerVersionValue = new RequestServerVersion(); //   Exchange  //  Exchange 2007 SP1  2010  Exchange2007_SP1 //  Exchange 2007  SP   Exchange2007 esb.RequestServerVersionValue.Version = ExchangeVersionType.Exchange2007_SP1; return esb; }

नोट: यदि सर्वर स्व-हस्ताक्षरित प्रमाण पत्र का उपयोग करता है, तो यह काम नहीं करेगा क्योंकि इस तरह का प्रमाण पत्र सत्यापन पास नहीं करेगा। वर्कअराउंड के रूप में, आप किसी भी प्रमाणपत्र के लिए अतिरिक्त आवेदन कोड जोड़ सकते हैं:

 ServicePointManager.ServerCertificateValidationCallback = (obj, certificate, chain, errors) => true;

ExchangeServiceBinding होने के बाद, आप कुछ उपयोगी करने की कोशिश कर सकते हैं, उदाहरण के लिए, एक संदेश भेजें। MSDN आपको इसके लिए CreateItemType ऑब्जेक्ट का उपयोग करने के लिए कहता है। ऐसा करने के लिए, हम निम्नलिखित विधि लिखते हैं:

 public static void SendMessage( ExchangeServiceBinding esb, String to, String subject, String body) { //  CreateItem request //       // ,      ,    var createItemRequest = new CreateItemType { Items = new NonEmptyArrayOfAllItemsType(), MessageDispositionSpecified = true, MessageDisposition = MessageDispositionType.SendOnly }; //  item  Message //  recipients,      var message = new MessageType(); message.ToRecipients = new EmailAddressType[1]; message.ToRecipients[0] = new EmailAddressType(); message.ToRecipients[0].EmailAddress = to; //   message.Subject = subject; //     message.Body = new BodyType(); message.Body.BodyType1 = BodyTypeType.Text; message.Body.Value = body; //   request   Item' createItemRequest.Items.Items = new ItemType[1]; createItemRequest.Items.Items[0] = message; //   CreateItemResponseType createItemResponse = esb.CreateItem(createItemRequest); //   ArrayOfResponseMessagesType responseMessages = createItemResponse.ResponseMessages; //  ,   var responseMessage = responseMessages.Items; foreach (var rmt in responseMessage.Where(rmt => rmt.ResponseClass == ResponseClassType.Error)) { throw new Exception(rmt.MessageText); } }

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

इस कोड को कॉल करना इस तरह किया जा सकता है:

 static void Main() { ServicePointManager.ServerCertificateValidationCallback = (obj, certificate, chain, errors) => true; try { const String server = "myserver", domain = "mydomain", user = "myuser", password = "mypassword", mailTo = "myuser2@mydomain.local", subject = "read me", body = "ehlo, developers!"; var esb = GetBinding(server, domain, user, password); SendMessage(esb, mailTo, subject, body); Console.WriteLine("Done!"); } catch (Exception e) { if(e.Message != null) Console.WriteLine(e.Message); } }

यदि यह आपको लगता है कि कोड भयावह रूप से लंबे समय से चल रहा था (मेरे पास लगभग 5 सेकंड है), चिंता न करें, यह केवल तब होता है जब आप पहली बार कॉल करते हैं। लगभग हर समय, आरंभीकरण केवल एक बार किया जाता है। इसके अलावा, यदि यह सर्वर के लिए पहला ईडब्ल्यूएस कॉल था, तो सर्वर को अनुरोध को संसाधित करने के लिए खुद को इनिशियलाइज़ करने और w3wp का एक नया उदाहरण बनाने की आवश्यकता होती है, जिसमें कुछ समय भी लग सकता है।

निष्कर्ष

हम ईडब्ल्यूएस तकनीक से कुछ समय के लिए परिचित हो गए और पते पर एक पत्र भेजने का एक सरल उदाहरण लिखा।

जैसा कि आप देख सकते हैं, कोड बहुत संक्षिप्त और स्पष्ट है। MS प्रलेखन बहुत अच्छा है और लगभग हमेशा उदाहरणों के साथ। यदि आपने C ++ MAPI में प्रोग्राम किया है, तो आप सराहना करेंगे कि यह तरीका कितना आसान है।

यदि आपके पास एक ईमेल क्लाइंट लिखने या एक्सचेंज ऑब्जेक्ट्स पर दूरस्थ रूप से काम करने से संबंधित कोई अन्य कार्य है, तो मुझे आशा है कि आप ईडब्ल्यूएस का उपयोग करेंगे। क्योंकि IMHO यह विधि सबसे सरल और सबसे अधिक समझने योग्य है जिसके साथ मुझे काम करना था।

आपका ध्यान देने के लिए धन्यवाद।

जारी रखने के लिए ...

ईडब्ल्यूएस के माध्यम से एमएस एक्सचेंज सर्वर पर मेल के साथ काम करें। भाग 1

परिचय

डिज़ाइन

निष्कर्ष

More articles: