ESB टूलकिट पर नमस्ते दुनिया

ईएसबी टूलकिट क्या है और यह क्या दिलचस्प है

ESB टूलकिट BizTalk सर्वर के लिए एक टूलकिट है, जो एकीकरण अनुप्रयोगों के विकास को सरल करता है।
इस तथ्य के बावजूद कि यह एक शक्तिशाली उपकरण है जो आपको गंभीर उत्पादों को बनाने की अनुमति देता है, पहली बात यह है कि बिज़कैट के लिए विकास विषय में प्रवेश करने के लिए एक कम "सीमा" है। कई कार्य जो ऑर्केस्ट्रेशन द्वारा हल करना मुश्किल है, उन्हें ईएसबी टूलकिट की मदद से आसानी से हल किया जाता है।
Microsoft ने उत्कृष्ट प्रलेखन बनाया है जो कई सामान्य कार्यों के उदाहरण प्रदान करता है। लेकिन मेरे उदाहरण से, मुझे एहसास हुआ कि जब इस उपकरण के साथ काम करने का एक सामान्य विचार प्रकट हुआ तो यह प्रलेखन उपयोगी हो गया। जाहिरा तौर पर, आलसी प्रोग्रामर के वातानुकूलित पलटा चालू हो जाता है - प्रलेखन को तब तक न पढ़ें जब तक कि आपके पास कम से कम कुछ काम न हो, या बहुत समय बर्बाद हो गया हो।
दरअसल, इस पोस्ट का मुख्य लक्ष्य एक साधारण एप्लिकेशन बनाना है ताकि आप ईएसबी टूलकिट को "टच" कर सकें। BizTalk से परिचित लोग संभवतः SendPort पर फ़िल्टर का उपयोग करके फ़ाइलों को एक फ़ोल्डर से दूसरे में स्थानांतरित करने का एक उदाहरण पढ़ते हैं। इस पोस्ट में, ESB टूलकिट में स्टेटिक रूटिंग का उपयोग करके उदाहरण दोहराया जाता है।

पूर्व शर्त

विकास के लिए, BizTalk Server 2010 और Visual Studio 2010 का उपयोग किया जाएगा।
विकास से पहले, आपको विज़ुअल स्टूडियो के लिए ईएसबी टूलकिट और इसके घटकों को स्थापित करना होगा। स्थापना Microsoft वेबसाइट पर वर्णित है, लिंक पोस्ट के अंत में है।

ट्रेनिंग

सबसे पहले, एक नया एप्लिकेशन तैयार करें, जिसे हम विकास में उपयोग करेंगे।


आवेदन EsbToolkitTest नाम दें।


सन्दर्भ में, आपको Microsoft.Practices.ESB एप्लिकेशन के लिए एक लिंक जोड़ना होगा।


बनाए गए एप्लिकेशन में, एक प्राप्तकर्ता पोर्ट बनाएं और इसमें रिसीव लोकेशन जोड़ें।




हम फ़ोल्डर से फ़ाइलों को इकट्ठा करने के लिए प्राप्त स्थान को कॉन्फ़िगर करते हैं। उदाहरण के लिए, C: \ ESB \ input।


हमें यह नहीं भूलना चाहिए कि BizTalk उपयोगकर्ता को इस फ़ोल्डर में अनुमतियों को पढ़ना और लिखना होगा। या प्रमाणीकरण टैब में किसी अन्य उपयोगकर्ता की ओर से पहुंच को कॉन्फ़िगर करें।

डायनेमिक SendPort बनाना भी आवश्यक है।



भेजें पोर्ट फ़िल्टर में निम्नलिखित पैरामीटर सेट करें:


ये पैरामीटर हमारे पोर्ट को यात्रा कार्यक्रम से एक संदेश प्राप्त करने की अनुमति देंगे। कृपया ध्यान दें कि ServiceName यहां वैकल्पिक है।
यही है, तैयारी समाप्त हो गई है, आप एक यात्रा कार्यक्रम बना सकते हैं।

यात्रा कार्यक्रम बनाएँ

रूट (यात्रा कार्यक्रम) ईएसबी टूलकिट का मुख्य घटक है। उनकी मदद से, हम यह निर्धारित करते हैं कि हमारे संदेश का क्या होगा। घटकों को स्थापित करने के बाद, आप कई प्रकार की परियोजनाओं में मार्ग बना सकते हैं। इस उदाहरण में, हम एक यात्रा कार्यक्रम में एक मार्ग बनाएंगे।
तो, Visual Studio में हम एक नया प्रोजेक्ट बनाते हैं। BizTalk प्रोजेक्ट्स टैब पर, BizTalk ESB यात्रा कार्यक्रम डिज़ाइनर प्रोजेक्ट हमें उपलब्ध होना चाहिए। आइए हमारे मार्ग का नाम TestItinerary रखें।


यदि आपके पास ऐसा कोई प्रोजेक्ट टेम्प्लेट नहीं है, तो आपको ईएसबी टूलकिट के साथ फ़ोल्डर से इसे स्थापित करने की आवश्यकता है। मेरा टेम्प्लेट फ़ोल्डर C: \ Program Files \ Microsoft BizTalk ESB टूलकिट 2.1 \ Tools \ Itinerary Designer में स्थित है। टेम्पलेट Microsoft.Practices.Services.Itinerary.DslPackage.vsix फ़ाइल चलाकर स्थापित किया गया है, जिसके बाद यह विज़ुअल स्टूडियो में दिखाई देता है।

बनाई गई परियोजना में, TestItinerary.ititnerary मार्ग पहले से ही जोड़ा जाना चाहिए। यात्रा कार्यक्रम डिजाइनर खोलने के लिए डबल-क्लिक करें। स्वाभाविक रूप से, वहाँ अब कोई घटक नहीं हैं, और यह हमें एक खाली ढाल के साथ प्रसन्न करता है।
बाईं ओर टूलबॉक्स में, हम उपलब्ध घटकों की एक सूची के साथ प्रस्तुत किए जाते हैं।


इस उदाहरण में, OnRamp, OffRamp, यात्रा कार्यक्रम, और निश्चित रूप से, कनेक्टर काम आएगा।
ऑन-रैंप हमारा डेटा स्रोत और सर्विस कंटेनर है।
यात्रा कार्यक्रम - यहां हमारा रूटिंग लॉजिक होगा।
ऑफ-रैंप हमारा ट्रांसमिशन कंपोनेंट है। इसे सेंड पोर्ट के लिए बाध्य होना होगा। ध्यान दें - बंदरगाह गतिशील होना चाहिए, क्योंकि वास्तविक पता मार्ग के भीतर हल किया गया है।

तो, हम एक ऑन-रैंप, दो यात्रा सेवा, एक ऑफ-रैंप को यात्रा कार्यक्रम डिजाइनर क्षेत्र में स्थानांतरित करते हैं और उन्हें कनेक्टर्स के साथ जोड़ते हैं जैसा कि चित्र में दिखाया गया है।


कनेक्टर के साथ दो घटकों को जोड़ने के लिए, आपको पहले टूलबॉक्स में कनेक्टर पर क्लिक करना होगा, फिर पहले घटक पर क्लिक करें, फिर दूसरे पर क्लिक करें। ग्राफिक संपादकों के सक्रिय उपयोगकर्ताओं में कभी-कभी अड़चन होती है, क्योंकि वे पहले घटक से दूसरे पर कनेक्टर को "खींचने" का प्रयास करते हैं। एक तिपहिया, लेकिन यह अप्रिय मिनटों की एक जोड़ी वितरित कर सकता है।

अब हमें प्रत्येक घटक और यात्रा कार्यक्रम को स्वयं कॉन्फ़िगर करने की आवश्यकता है। हम OnRamp1 घटक का चयन करते हैं और इसके लिए निम्नलिखित गुण लिखते हैं:


यानी हम निर्दिष्ट करते हैं कि कौन से अनुप्रयोग से डेटा प्राप्त करने के लिए पोर्ट प्राप्त करें, घटक का नाम बदलकर TestOnRamp करें और एक्सटेंडर निर्दिष्ट करें। क्यों हर बार ऑन-रैम्प के लिए एक्सटेंडर चुनें, अगर इसके लिए केवल एक "ऑन-रैंप ESB एक्सटेंडर" उपलब्ध है, तो यह स्पष्ट नहीं है। जाहिर है, कुछ स्थितियों में कुछ अन्य विकल्प हो सकते हैं, लेकिन मैं इस पर नहीं आया हूं।

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

ऑन-रैंप के बाद, ItineraryService1 पर जाएं। हम इसके लिए निम्नलिखित गुण निर्धारित करते हैं:


यानी इस सेवा के लिए हमारा ऑन-रैंप कंटेनर होगा, एक्सटेंडर मैसेजिंग एक्सटेंडर होगा। सेवा नाम में, Microsoft.Practices.ESB.Services.Rout निर्दिष्ट करें - यह सेवा रूटिंग के लिए ज़िम्मेदार होगी। और "रूटिंग" के लिए घटक का नाम बदलें।

गुणों को परिभाषित करने के अलावा, हमें रूटिंग सेवा में एक रिज़ॉल्वर जोड़ने की आवश्यकता है। हमारे मामले में, यह पते को हल करेगा। हमारे पास एक रिज़ॉल्वर स्टैटिक होगा - इसके गुणों को कठोरता से पंजीकृत किया जाएगा और इसे गतिशील रूप से नहीं बदला जाएगा।
इसलिए, हमारी रूटिंग सेवा पर राइट-क्लिक करें और Add-> Resolver का चयन करें


यदि आप संपूर्ण घटक का संदर्भ मेनू नहीं, बल्कि उसका विशिष्ट रिज़ॉल्वर कहते हैं, तो निम्न मेनू प्रकट होता है:


यहां हाइलाइट की गई वस्तु पिछले एक के समान है और उनके बीच कोई अंतर नहीं है।
आइए हमारे रिसॉल्वर को "staticResolver" नाम दें और इसके लिए निम्नलिखित गुण सेट करें:


मैं आपको याद दिलाता हूं कि BizTalk उपयोगकर्ता के पास परिवहन स्थान में निर्दिष्ट फ़ोल्डर में अनुमतियाँ होनी चाहिए। स्थैतिक रिज़ॉल्वर आपको कुछ विवरण में SendPort गुण सेट करने की अनुमति देता है, लेकिन उदाहरण के लिए, परिवहन प्रकार और गंतव्य पता हमारे लिए पर्याप्त है।
राउटिंग सेवा के सभी गुण हमने पहचान लिए हैं। ऑफ-रैंप घटक पर जाएं। ItineraryService2 घटक अब के लिए लंघन है।
ऑफ-रैंप घटक के लिए, निम्नलिखित गुण सेट करें:


यानी हमने अपने ऑफ-रैम्प को पहले से निर्मित सेंड पोर्ट से जोड़ दिया। ऑफ-रैंप, हमने एक अधिक सामंजस्यपूर्ण नाम भी दिया: "टेस्टऑफ़रैम्प"।
अब चलिए ItineraryService2 घटक पर चलते हैं। यह घटक एक ऑफ-रैंप सेवा की भूमिका निभाएगा। हम इसके लिए निम्नलिखित गुण निर्धारित करते हैं:


यानी हमने संकेत दिया कि यह TestOffRamp के लिए एक ऑफ-रैंप सेवा है, और इसका नाम बदल दिया है।
यह सब, हमारे द्वारा कॉन्फ़िगर किए गए सभी घटक हैं, और हमारे Itinirary Designer को इस तरह दिखना चाहिए:


यह यात्रा कार्यक्रम के गुणों को सेट करने के लिए बना हुआ है। ऐसा करने के लिए, घटकों से मुक्त जगह पर क्लिक करें और F4 दबाएं। निम्नलिखित गुण सेट करें:


आइए हम उन गुणों को अधिक विस्तार से जांचते हैं जिन्हें हमने बदला:
1. मॉडल एक्सपोर्टर - हमने निर्दिष्ट डेटाबेस यात्रा कार्यक्रम, अर्थात् हमारे मार्ग को एक्सएमएल को निर्यात नहीं किया जाएगा, लेकिन तुरंत डेटाबेस से, जहां से BizTalk इसे ले जाएगा।
2. एन्क्रिप्शन प्रमाणपत्र की आवश्यकता है - गलत, क्योंकि अब हमें उसकी आवश्यकता नहीं है
3. यात्रा कार्यक्रम - तैनात। यदि आप प्रकाशित मार्ग छोड़ते हैं, तो यह डेटाबेस में होगा, लेकिन उपलब्ध नहीं होगा। यानी BizTalk इसे कॉल नहीं कर सकता।
आपको नाम संपत्ति पर भी ध्यान देने की आवश्यकता है - यह हमारे मार्ग का नाम है जिसके द्वारा इसे खोजा जाना चाहिए। इसे क्लिपबोर्ड पर कॉपी करें - यह अब हमारे लिए उपयोगी होगा।
बनाए गए मार्ग को सहेजें, फिर घटकों से मुक्त स्थान पर राइट-क्लिक करें और "निर्यात मॉडल" आइटम चुनें। अब हमारे मार्ग को डेटाबेस में निर्यात कर दिया गया है और यह BizTalk से कॉल करने के लिए उपलब्ध है।

कॉन्फ़िगर पोर्ट प्राप्त करें

एक बार फिर, BizTalk Server व्यवस्थापन कंसोल पर जाएँ और हमारे द्वारा बनाए गए स्थान को खोलें। हमने पाइपलाइन नहीं बदली और यह PassThruReceive बना रहा। यह इसे बदलने और हमारे यात्रा कार्यक्रम के चयन को अनुकूलित करने का समय है।
पाइपलाइन ItinerarySelectReceivePassthrough का चयन करें और इसके गुणों को खोलें।
चरण 1 में: डिकोड - घटक: ESB यात्रा कार्यक्रम चयनकर्ता अनुभाग, आपको इटीनरी का चयन करने के लिए गुणों को निर्दिष्ट करना होगा।
ItineraryFactKey में, Resolver.Itinerary निर्दिष्ट करें, और ResolverConnectionString में - ITINERARY: \\ name = TestItinerary;


नाम पैरामीटर हमारे मार्ग का नाम सेट करता है। अब हमने स्थैतिक मार्ग चयन का उपयोग किया है, लेकिन आप व्यावसायिक नियमों के आधार पर, उदाहरण के लिए, गतिशील का भी उपयोग कर सकते हैं।

शुरू, खत्म और निष्कर्ष

BizTalk सर्वर व्यवस्थापन कंसोल में अनुप्रयोग लॉन्च करें।
फ़ोल्डर में C: \ ESB एक परीक्षण दस्तावेज़ बनाएँ। उदाहरण के लिए, यह:
<?xml version="1.0" encoding="utf-8"?>
Hello world


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

सबसे महत्वपूर्ण कड़ी

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