🧝 🎞️ 🗂️ 1 सी वेब सेवाओं का उपयोग करके सी # में एक ग्राहक के साथ 1 सी का आदान-प्रदान करें 🤞🏼 🖐🏿 🎉

एक परियोजना के लिए, 1 सी वेब सेवाओं का उपयोग करना आवश्यक था, हमने एक गोदाम स्वचालन प्रणाली का निर्माण किया, और डेटा संग्रह टर्मिनलों को सीधे 1 सी से जोड़ा जाता है, ग्राहक स्वयं .NET पर विकसित होते हैं। परिणाम एक बहुत ही रोचक संरचना थी। वेब सेवा ऑपरेशन मोड में 1 सी सेटिंग्स के बारे में जानकारी प्राप्त करने के साथ-साथ ट्यूटोरियल प्रयोगशाला के काम के रूप में सी # में एक सरल कॉन्फ़िगरेशन और क्लाइंट लिखना, जो तब संस्थान में सफलतापूर्वक प्रस्तुत किया गया था।

प्रयोगशाला कार्य को थोड़ा जटिल नाम मिला:
1C पर विकसित स्रोत के एक उदाहरण में एंटरप्राइज़ 8.2 प्लेटफ़ॉर्म और C # में .NET 4.0 प्लेटफ़ॉर्म पर क्लाइंट का उपयोग करके वेब सेवा का उपयोग करने वाले क्लाइंट-सर्वर मल्टी-प्लेटफॉर्म समाधान के बीच सूचना विनिमय का संगठन

जो कोई भी, बिल्ली के नीचे, कृपया, रुचि रखता है।

काम का उद्देश्य

वेब सेवाओं के निर्माण की तकनीक में महारत हासिल करने के लिए, वेब सेवा के डब्ल्यूएसडीएल विवरण का गठन। वेब-सेवाओं के माध्यम से स्थानांतरित करने की संभावना के लिए XML स्कीमा में ऑब्जेक्ट्स को क्रमबद्ध करने के सिद्धांतों को सीखना।

हार्डवेयर और सॉफ्टवेयर

माइक्रोसॉफ्ट विंडोज 7 x64
प्लेटफार्म 1 सी: एंटरप्राइज 8.2
इंटरनेट सूचना सर्वर
विजुअल स्टूडियो 10 अल्टीमेट

सैद्धांतिक परिचय

अधिक से अधिक एक्सचेंज वेब सेवा प्रौद्योगिकी का उपयोग करते हुए पाए जाते हैं। यह सुविधाजनक है, क्योंकि होस्ट डेटाबेस के लिए यह वेब सेवा एक्सटेंशन और डेटा हैंडलर स्थापित करने के लिए पर्याप्त है, और क्लिंट समाधान के लिए, वेब सेवा से कनेक्ट करें। प्रौद्योगिकी बहु-मंच है और फिलहाल इसका उपयोग बहुत प्रासंगिक है।

WSDL विवरण का उपयोग कर वेब सेवाओं के उदाहरणों में शामिल हैं:

http://www.cbr.ru/scripts/Root.asp?Prtid=DWS केंद्रीय बैंक की वेब सेवा, दैनिक डेटा प्राप्त करने के लिए।
http://api.yandex.ru/speller/doc/dg/concepts/api-overview.xml Yandex वेब सेवा वर्तनी जाँचकर्ता।
https://www.flightstats.com/developers/bin/view/Web+Services/WSDL उड़ान, मौसम की जानकारी, आदि की निगरानी के लिए कई वेब-आधारित सांख्यिकी सेवाएँ हैं।

WSDL (वेब सेवा विवरण भाषा) वेब सेवाओं का वर्णन करने और उन तक पहुँचने के लिए एक XML- आधारित भाषा है। (विनिर्देश http://www.w3.org/TR/wsdl )।

एसओएपी (सिंपल ऑब्जेक्ट एक्सेस प्रोटोकॉल) एक वितरित कंप्यूटिंग वातावरण में एक संरचित मैसेजिंग प्रोटोकॉल है। एसओएपी का उपयोग एक्सएमएल प्रारूप और दूरस्थ प्रक्रिया कॉल (आरपीसी) में मनमाने संदेशों के आदान-प्रदान के लिए किया जाता है। (विनिर्देश http://www.w3.org/TR/soap/ )।

एक्सडीटीओ (एक्सएमएल डेटा ट्रांसफर ऑब्जेक्ट्स) - एक्सएमएल स्कीमा (विवरण के लिए, http://v8.1c.ru/overview/xdto.htm देखें) का उपयोग करके वर्णित डेटा के ऑब्जेक्ट मॉडलिंग के लिए एक तंत्र।

आदिम प्रकारों को क्रमबद्ध करने के लिए अधिकांश तरीके W3 द्वारा विकसित किए गए थे और उन्हें " http://www.w3.org/2001/XMLSchema " नामस्थान में वर्णित किया गया है।

काम का काम

कार्य 1: 1C स्थापित करें: एंटरप्राइज़ प्लेटफ़ॉर्म, IIS सर्वर घटक स्थापित करें, IIS सर्वर से 1C वेब एक्सटेंशन कनेक्ट करें।

1C: एंटरप्राइज़ प्लेटफ़ॉर्म स्थापित करते समय, आपको वेब एक्सटेंशन स्थापित करना होगा।

अंजीर। 1. 1C की स्थापना के समय चयनित घटक

मेनू में " कंट्रोल पैनल \ ऑल कंट्रोल पैनल एलिमेंट्स \ _ प्रोग्राम्स और फीचर्स " आपको IIS घटकों को निर्दिष्ट करने के लिए अतिरिक्त विंडोज घटकों को "विंडोज सुविधाओं को चालू या बंद करें " स्थापित करना होगा। डिफ़ॉल्ट रूप से चुने गए घटकों के अलावा, ISAPI तकनीक से संबंधित अधिक घटकों को जोड़ना आवश्यक है, यह इस तकनीक के लिए धन्यवाद है कि 1C वेब सर्वर एक्सटेंशन में IIS वेब सर्वर से संपर्क करने की क्षमता है, और प्रमाणीकरण का उपयोग करके वेब सेवा तक पहुंचने के लिए प्रमाणीकरण प्रकार "URL द्वारा" है। 1C डेटाबेस उपयोगकर्ता। स्थापना के बाद, यह अनुशंसा की जाती है कि आप ऑपरेटिंग सिस्टम को पुनरारंभ करें।

अंजीर। 2. IIS स्थापना के समय चयनित घटक

" कंट्रोल पैनल \ ऑल कंट्रोल पैनल एलिमेंट्स / एडमिनिस्ट्रेटिव टूल्स" मेनू में, " IIS प्रबंधक " कंसोल लॉन्च करें, जहां " एप्लिकेशन पूल " तत्व खोलें, संदर्भ मेनू में " DefaultAppPool " पूल खोलें, " उन्नत सेटिंग्स ... " का चयन करें जहां " 32-बिट अनुप्रयोगों की अनुमति है " "आपको" ट्रू "इंस्टॉल करने की आवश्यकता है। यह वेब-एक्सटेंशन 1C के संचालन के लिए आवश्यक है, क्योंकि यह एक 32-बिट अनुप्रयोग है। यह डिबगिंग के लिए सुविधाजनक है (जब विन्यासकर्ता से प्रकाशित होने के बाद, " DefaultAppPool " डिफ़ॉल्ट रूप से प्रतिस्थापित किया जाएगा), उत्पाद के लिए मैं एक प्रबंधित वातावरण के बिना प्रत्येक सेवा के लिए अलग पूल बनाने की सलाह देता हूं।

उसी IIS प्रबंधक कंसोल में, डिफ़ॉल्ट वेब साइट तत्व का चयन करें, प्रमाणीकरण कार्रवाई का चयन करें, जहां आपको विकल्प को सक्षम करने की आवश्यकता है: अनाम प्रमाणीकरण ।

अब IIS सर्वर पर 1C वेब सेवा प्रकाशित करना संभव है। लेकिन इस प्रकाशन को संभव बनाने के लिए, प्रशासक उपयोगकर्ता की ओर से 1C: एंटरप्राइज कॉन्फ़िगरेशन शुरू करना आवश्यक है।

कार्य 2: एक साधारण 1C विन्यास बनाना।
किसी भी कॉन्फ़िगरेशन को विकसित करना शुरू करने के लिए पहली बात यह है: आपको एक प्रशासक भूमिका बनाने की आवश्यकता है ( कॉन्फ़िगरेशन विकास पद्धति के अनुसार, इसे पूर्ण अधिकार कहा जाना चाहिए)

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

अंजीर। 3. निर्मित 1C विन्यास में डेटा संरचना

अतिरिक्त विवरण के बिना निर्देशिका " नामकरण ",। "डिफ़ॉल्ट रूप से" विवरण में आइटम के नाम और कोड के बारे में जानकारी शामिल है।

दस्तावेज़ " क्रेता का आदेश ", जिसमें सारणीबद्ध भाग " उत्पाद " शामिल होंगे, जिनमें से प्रत्येक पंक्ति में नामकरण पर जानकारी होगी (प्रकार का तत्व " DirectoryReference.Nomenclature ") और मात्रा (तत्व का प्रकार " संख्या " का तत्व "" 15 दशमलव स्थानों और स्थानों के साथ अहस्ताक्षरित) 3 के बाद)।

अगला, आप एंटरप्राइज़ मोड में 1C चला सकते हैं और हमारे द्वारा बनाए गए नामकरण और संबंधित संख्या द्वारा भरे गए कई दस्तावेज़ बना सकते हैं।

कार्य 3: 1 सी वेब सेवा का निर्माण और प्रकाशन।
" सामान्य " कॉन्फ़िगरेशन ग्रुपिंग में, शुरू में आइटम को स्थानांतरित करने के लिए " XDTO- पैकेज " प्रकार का एक नया तत्व बनाएं। इसे कहा जा सकता है, उदाहरण के लिए, " नोमेंक्लेचरएक्सडीटीओ ।" WSDL विनिर्देश के अनुसार नामस्थान URL, इस पैकेज के विनिर्देश के URL पते के रूप में निर्दिष्ट किया जाना चाहिए, उदाहरण के लिए
" Company.com/1C/Nomenclature ।" इस पैकेज में, आपको एक ऑब्जेक्ट प्रकार बनाने की आवश्यकता है, उदाहरण के लिए, " नामकरण ", जिसमें विवरण " कोड " और " नाम " हैं, इसी प्रकार के " स्ट्रिंग (http://www.w3.org/2001/XMLSchema) "।
अब आपको एक दूसरा XDTO पैकेज बनाने की आवश्यकता है जिसमें ग्राहक के आदेशों के बारे में जानकारी होगी, इसे " company.com/1C/ClientOrder " नामस्थान में " ClientOrderXDTO " कहा जा सकता है। सबसे पहले, आपको हमारे द्वारा बनाए गए नामकरण पैकेज का उपयोग करने में सक्षम होने के लिए आयात निर्देश " company.com/1C/Nomenclature " से कनेक्ट करने की आवश्यकता है। यह " ग्राहकों के आदेश " दस्तावेज़ के सारणीबद्ध भाग में निहित वस्तुओं के हस्तांतरण के लिए आवश्यक है।

अब हमें तालिका भाग की एक पंक्ति युक्त एक ऑब्जेक्ट प्रकार " ClientOrderRow " बनाने की आवश्यकता है। इस प्रकार में विवरण " नामकरण " और " गणना " का एक संयोजन शामिल होगा, नामकरण के लिए क्रमशः यह आवश्यक है कि वस्तु का प्रकार "नामकरण" (http://company.com/1C/Nomenclature), और मात्रा के लिए इंगित किया जाए, " डबल (http: //) www.w3.org/2001/XMLSchema) । "
ऑर्डर वाले ऑब्जेक्ट के प्रकार को " ClientOrder " कहा जा सकता है जिसमें ऑर्डर नंबर, निर्माण तिथि और ऑर्डर के सारणीबद्ध भाग से तत्वों की एक सरणी होनी चाहिए। टाइप स्ट्रिंग के " नंबर ", " डेट " टाइप " डेटटाइम " (http://www.w3.org/2001/XMLSchema) "और" प्रोडक्ट्स "टाइप" क्लाइंटऑर्डरर (http://company.com/1C/ClientOrder) ", यह इंगित करना आवश्यक है कि न्यूनतम संख्या " 0 " है, और अधिकतम संख्या " -1 " है, यह इंगित करता है कि यह ऑब्जेक्ट एक सरणी होगा।

लेकिन, चूंकि आदेशों की सूची को वापस करना आवश्यक है, इसलिए इस सरणी वाले ऑब्जेक्ट प्रकार का निर्माण करना आवश्यक है, इसलिए, हमें " ArrayOfClientOrders " नामक एक और तत्व बनाने की आवश्यकता है, जिसमें केवल एक विशेषता होगी जिसे " ClientOrder " (http: // company) कंपनी का " क्लाइंटऑर्डर " कहा जाता है। .com / 1C / ClientOrder) । "

चित्रा 4 XCTO संकुल की संरचना 1C में

इस पर, हस्तांतरित मूल्यों के विवरण का निर्माण पूरा माना जा सकता है। वेब सेवा और इसकी विधियों का वर्णन करना आवश्यक है।
"सामान्य" कॉन्फ़िगरेशन समूह में, आपको एक ऑब्जेक्ट बनाने की आवश्यकता है, वेब सेवा। इसे " सेवा " कहा जा सकता है। "अन्य" टैब में, उन नामों को निर्दिष्ट करें, जिनके लिए वेब सेवा संबंधित है, उदाहरण के लिए, " company.com/1C ", साथ ही नए बनाए गए पैकेजों वाले XDTO पैकेजों की सूची " company.com/1C/Nomenclature , Company.com/ 1C / ClientOrder । " "ऑपरेशन" टैब में, " GetClientOrders " विधि बनाएं, जो " ArrayOfClientOrders (http://company.com/1C/ClientOrder) " मान लौटाएगा , उसी समय खाली मान वापस करने की क्षमता सेट करें और "Method Name" नामक आवर्धक ग्लास के साथ क्षेत्र पर क्लिक करें। ", जिससे वेब सेवा मॉड्यूल में एक फ़ंक्शन बन रहा है जिसे इस वेब सेवा पद्धति तक पहुंचने के दौरान कहा जाएगा।

डेटाबेस से प्राप्त होने वाले फ़ंक्शन का सही ढंग से वर्णन करने और ग्राहक के आदेशों की एक सूची देने के लिए, आपको आंतरिक भाषा 1C को जानने की आवश्यकता है, क्योंकि इस फ़ंक्शन का कोड परिशिष्ट 1 में है। स्पष्टीकरण की आवश्यकता क्या है कि " XDTO Factory " किसी प्रकार का प्रबंधक है जो क्रमबद्धता का कार्य करता है। वस्तुओं, और इस क्रमबद्ध वस्तु को वापस करने की आवश्यकता है। उसी समय, डेटाबेस में निहित सभी आदेशों का चयन किया जाता है, सारणीबद्ध भाग की संख्या, तिथि और पंक्तियों का क्रमांकन होता है, जबकि नामकरण को अतिरिक्त क्रमांकन की आवश्यकता होती है, और पहले से ही पैक की गई वस्तु को सामान्य संरचना में डाला जाता है। पैक की गई वस्तुओं की एक सरणी को इकट्ठा किया जाता है, एक सरणी पैकेज में क्रमबद्ध किया जाता है। और क्लाइंट को तथाकथित फ़ंक्शन के परिणामस्वरूप भेजा जाता है।
किसी वेब सेवा को प्रकाशित करने के लिए, 1C के विन्यासकर्ता मेनू में, " वेब सर्वर पर व्यवस्थापन \ प्रकाशित करें ... " का चयन करें , और फिर वेब सेवा प्रकाशन का नाम निर्दिष्ट करें, उदाहरण के लिए, " कंपनी ", सेवा का नाम, उदाहरण के लिए, " सेवा " और पता " service.1cws "। और प्रकाशन के लिए पथ भी निर्दिष्ट करें, उदाहरण के लिए, " C: \ inetpub \ wwwroot \ Company \ "।

उसके बाद, WSDL वेब सेवा संरचना " लोकलहोस्ट / कंपनी / ws / service.1cws? Wsdl " पते पर उपलब्ध होगी ?

कार्य 4: C # प्लेटफ़ॉर्म .NET 4.0 पर क्लाइंट बनाना।
Visual Studio में, एक नया C # कंसोल एप्लिकेशन बनाएँ।

अगला, संदर्भ मेनू को " संदर्भ " परियोजना तत्व पर कॉल करें, और " सेवा संदर्भ जोड़ें ... " कार्रवाई करें, खुलने वाले मेनू में " उन्नत ... " बटन पर क्लिक करें, एक विंडो खुलती है जहां आपको " वेब संदर्भ जोड़ें ... " बटन पर क्लिक करने की आवश्यकता होती है।
एक मेनू खुलता है जहां आपको वेब सेवा के डब्लूएसडीएल विवरण के लिए एक लिंक डालने की आवश्यकता होती है।

अंजीर। 5. सी # में एक परियोजना के लिए एक वेब सेवा को जोड़ने

1C में बनाई गई वेब सेवा के लिए, यह लिंक " localhost / Company / ws / service.1cnes। Wsdl " की तरह दिखाई देगा, वेब सेवा का विवरण प्राप्त करने के बाद, आपको .NET नामस्थान का नाम निर्दिष्ट करना होगा, जिसमें से वेब तक पहुंच हो सकती है। सेवा, उदाहरण के लिए, " कंपनी सेवा ", फिर " संदर्भ जोड़ें ... " बटन पर क्लिक करें, दृश्य स्टूडियो स्वचालित रूप से इस विवरण के अनुसार कक्षाएं उत्पन्न करेगा। परियोजना में, उत्पन्न वर्ग के तरीकों को कॉल करने के लिए पर्याप्त होगा, जबकि क्रमांकन और कॉल .NET प्लेटफॉर्म द्वारा किया जाएगा।

अगला, आपको एक प्रोग्राम लिखने की ज़रूरत है जो वेब सेवा तक पहुंच प्राप्त करेगा और उपयोगकर्ता को प्राप्त डेटा प्रदर्शित करेगा। ऐसा करने के लिए, आपको सी # भाषा को जानने की जरूरत है, कार्यक्रम कोड परिशिष्ट 2 में प्रस्तुत किया गया है। इस कोड से यह स्पष्ट करना आवश्यक है कि सेवा तक पहुंचने के लिए " सेवा " ऑब्जेक्ट का निर्माण प्रबंधक के निर्माण से ज्यादा कुछ नहीं है। इस ओर, वेब सेवा विधियों को बुलाया जाएगा।
" _1CebServiceClientConsole " परियोजना का सामान्य नामस्थान है , इसे निर्माण के दौरान चुना गया है। डब्लूएसडीएल संरचना से प्राप्त वेब सेवा नाम स्थान पूरी तरह से प्रोजेक्ट नेमस्पेस में शामिल है, जो आपको दूरस्थ तरीकों को "अपने समान" कहने की अनुमति देता है।

इस तरह की वास्तुकला का निर्माण प्रोग्रामर के लिए पारदर्शी है, लेकिन इसके बाद के प्रसारण के लिए किन बिंदुओं और क्या को क्रमबद्ध किया जा रहा है, यह समझना आवश्यक है। यह क्लाइंट-सर्वर एप्लिकेशन आर्किटेक्चर वर्तमान में सबसे लोकप्रिय है।

लैब की रिपोर्ट

एक रिपोर्ट की आवश्यकता नहीं है, एक कार्य स्टैंड की आवश्यकता है, और इसके काम के प्रदर्शन की आवश्यकता है।

कार्य सुरक्षा प्रक्रिया

यह आवश्यक है कि काम को दिखाने के लिए, कनेक्शन क्रम और कॉन्फ़िगरेशन सुविधाओं के साथ-साथ वस्तुओं के क्रमांकन की विशेषताओं को भी समझा जाए। सफल सुरक्षा के लिए, सभी प्रश्नों का उत्तर दिया जाना चाहिए।

परीक्षण प्रश्न और कार्य

1C वेब एक्सटेंशन कितनी गहरी है?
1C डेटा क्रमांकन के लिए संकुल की संरचना को क्या संग्रहीत करता है?
वेब सेवा विवरण संरचना कैसे प्राप्त करें?
विज़ुअल स्टूडियो में विकसित की जा रही परियोजना के लिए एक वेब सेवा को कैसे कनेक्ट करें?
ग्राहक का कॉल प्रबंधक क्यों बनाएं और यह कैसा है?

परिशिष्ट 1: 1C भाषा में GetClientOrders फ़ंक्शन कोड

 GetClientOrders()  = XDTO.("http://company.com/1C/ClientOrder", "ArrayOfClientOrders");  = XDTO.("http://company.com/1C/ClientOrder", "ClientOrder");  = XDTO.("http://company.com/1C/ClientOrder", "ClientOrderRow");  = XDTO.("http://company.com/1C/Nomenclature", "Nomenclature");  =  ; . = " | ., | ., | . | | .  ";  = .();  = .();  .() = 0   Null; ;  = XDTO.();  .()   = XDTO.(); .Number = .; .Date = .;     ..  //       !  = XDTO.();  = XDTO.(); .Code = ..; .Name = ..; .Nomenclature = ; .Count = .; .Products.(); ; .ClientOrder.(); ;  ;

परिशिष्ट 2: सी # प्रोग्राम कोड एक वेब सेवा तक पहुँचने

 using System; using _1CWebServiceClientConsole.CompanyService; namespace _1CWebServiceClientConsole { class Program { static void Main(string[] args) { using (Service service = new Service()) { service.SoapVersion = System.Web.Services.Protocols.SoapProtocolVersion.Soap12; service.Credentials = new System.Net.NetworkCredential("LOGIN", "PASS"); var arrayOfClientOrders = service.GetClientOrders(); if (arrayOfClientOrders == null) Console.WriteLine(" "); foreach (var clientOrder in arrayOfClientOrders) { Console.WriteLine("  №" + clientOrder.Number + "  " + clientOrder.Date); Console.WriteLine("-----"); foreach (var clientOrderRow in clientOrder.Products) { Console.WriteLine(clientOrderRow.Nomenclature.Name + " " + clientOrderRow.Count); } Console.WriteLine("-----"); } } Console.ReadKey(); } } }

1 सी वेब सेवाओं का उपयोग करके सी # में एक ग्राहक के साथ 1 सी का आदान-प्रदान करें

काम का उद्देश्य

हार्डवेयर और सॉफ्टवेयर

सैद्धांतिक परिचय

काम का काम

More articles: