1 सी के साथ त्वरित एकीकरण: एंटरप्राइज

इस लेख में मैं 1 सी कॉन्फ़िगरेशन के साथ तीसरे पक्ष के अनुप्रयोगों को एकीकृत करने का तरीका, मेरी राय में, सबसे सरल के बारे में बात करूंगा। लेख मुख्य रूप से .Net कोर , पीएचपी और पायथन पर लिखने वाले डेवलपर्स के लिए रुचि का होगा।

1 सी के साथ एकीकृत करने के कई तरीके हैं, 1 सी से एक उत्कृष्ट लेख भी इसके लिए समर्पित है। विशेष रूप से, आप इससे सीखेंगे कि 1C वेब सेवाओं के तंत्र का समर्थन करता है, जिसका अर्थ है कि हम अपनी स्वयं की सेवा को 1C की ओर लागू कर सकते हैं, और परिणामस्वरूप, क्लाइंट अनुप्रयोग पक्ष पर हमारी स्वयं की ORM लाइब्रेरी। इन पुस्तकालयों में से एक पर बाद में चर्चा की जाएगी।

सामान्य शब्दों में तकनीक का विवरण

1C की तरफ

यह सब इस तथ्य से शुरू होता है कि "ब्रोम" एक्सटेंशन को 1 सी कॉन्फ़िगरेशन में जोड़ा जाता है, जिससे एक नई वेब सेवा जुड़ती है। एक्सटेंशन स्वतंत्र रूप से उपलब्ध है और लाइसेंस प्राप्त है (MIT)। एक्सटेंशन स्वयं एक विशिष्ट डेटा मॉडल से बंधा नहीं है, और इसलिए संगतता मोड 8.3.10 या उच्चतर के समर्थन के साथ किसी भी कॉन्फ़िगरेशन पर स्थापित किया जा सकता है।

एक बार एक्सटेंशन स्थापित हो जाने के बाद, आपको उन उपयोगकर्ताओं के अधिकारों को कॉन्फ़िगर करना होगा जिनके पास वेब सेवा विधियों तक पहुंच होगी, साथ ही वेब सर्वर पर कॉन्फ़िगरेशन को प्रकाशित करना होगा, ताकि जोड़ा गया सेवा http (s) प्रोटोकॉल के माध्यम से सुलभ हो। 1C की ओर, अधिक कुछ भी आवश्यक नहीं है।

क्लाइंट की तरफ

क्लाइंट की ओर, ब्रोम पैकेज जुड़ा हुआ है, उदाहरण के लिए, .Net कोर के लिए यह कमांड के साथ किया जा सकता है:

Install-Package Brom -Version 1.0.1-beta08 

या अजगर के लिए:

 pip install brome 

पैकेज को स्थापित करने के बाद, यह एक क्लाइंट ऑब्जेक्ट बनाने के लिए पर्याप्त है जिसके माध्यम से दूरस्थ 1C कॉन्फ़िगरेशन के साथ बातचीत की जाएगी। इसके बाद मैं C # में कोड दूंगा, लेकिन PHP और Python में यह समान है। और इसलिए, आप एक कमांड के साथ एक क्लाइंट बना सकते हैं:

 dynamic  = new (@"  = http://mydomain.com/publication_name;  = 1c_user_name;  = 1c_user_pass "); 

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

प्रक्रियाओं और कार्यों की कॉल 1 सी

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

 string  = .(2547, " = fr_FR"); 

दूसरा पैरामीटर स्थानीयकरण (फ्रेंच) को दर्शाता एक प्रारूप स्ट्रिंग है। पैरामीटर एक प्राकृतिक रूप में स्थानांतरित किए जाते हैं और किसी भी अतिरिक्त रूपांतरण या पैकेजिंग की आवश्यकता नहीं होती है।

और यह वह है जो डायरेक्टर मैनेजर मॉड्यूल के फाइंड कोड कोड के लिए कॉल की तरह दिखेगा:

 var  = ...(840); 

यहां हमने मॉड्यूल प्रबंधक निर्देशिका "मुद्राओं" के माध्यम से फ़ंक्शन को बुलाया। कॉल का परिणाम "DirectoryReference" प्रकार का एक ऑब्जेक्ट होगा। अब ऑब्जेक्ट के परिणामस्वरूप लिंक को दूसरे फ़ंक्शन के पैरामीटर के रूप में पारित किया जा सकता है:

 var  = ..(, DateTime.Today); 

इस बार हम सामान्य मॉड्यूल "कार्य मुद्राओं के साथ" में बदल गए और इसकी विधि "पाठ्यक्रम पाठ्यक्रम प्राप्त करें"।

पुस्तकालय जटिल डेटा प्रकारों के साथ काम करने का समर्थन करता है, इसलिए इनपुट या रिटर्न लेने वाले तरीकों को कॉल करना संभव है: लिंक, एरे, स्ट्रक्चर, वैल्यू टेबल्स, वैल्यू ट्री, सिस्टम एनुमरेशन्स, आदि ... 1C के साथ काम करने को आसान बनाने के लिए क्लाइंट लाइब्रेरी में कुछ कक्षाएं विशेष रूप से कार्यान्वित की जाती हैं।

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

लिंक्स के साथ काम करें

ऑब्जेक्ट के संदर्भ न केवल पॉइंटर को 1 सी ऑब्जेक्ट में स्थानांतरित करने की अनुमति देते हैं, बल्कि ऑब्जेक्ट के डेटा को स्वयं प्राप्त करने के लिए भी। क्लाइंट साइड पर लिंक के साथ काम करना 1 सी में सरल है। उदाहरण के लिए:

 var  = ...("00-000018", new Date(2017, 1, 1)); var  = .; var  = .; var  = ..; foreach (var  in .) { Console.WriteLine((., .)); } 

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

सर्वर तक पहुँचने के बिना ऑब्जेक्ट का लिंक क्लाइंट साइड पर भी प्राप्त किया जा सकता है। ऐसा करने के लिए, बस वस्तु के विशिष्ट पहचानकर्ता को जानें:

 var  = ...(new Guid("5a32b6ab-4661-11e9-912a-38d547755ef7")); 

आप पूर्वनिर्धारित संग्रह वस्तुओं के लिंक भी प्राप्त कर सकते हैं:

 var  = ...18_118; 

वस्तुओं का संपादन

ऑब्जेक्ट का लिंक होने पर, हम ऑब्जेक्ट के डेटा को एडिट कर सकते हैं। ऐसा करने के लिए, बस एक वस्तु संदर्भ बनाएं:

 var  = .(); . = DateTime.Today; . = "00-000055"; ..(); var  = ..() . = ...("000000104"); . = 3; .(.); 

इस उदाहरण में, हमने दस्तावेज़ के लिंक के माध्यम से दस्तावेज़ का संदर्भ बनाया, कुछ क्षेत्रों में भरा, सारणीबद्ध अनुभाग "उत्पाद" में एक पंक्ति जोड़ी और दस्तावेज़ को पोस्टिंग मोड में दर्ज किया।

यदि आपको एक नई वस्तु बनाने की आवश्यकता है, तो यह भी संभव है:

 //     var  = ...(); . = " "; .(); //     var  = ...(); . = .; . = " "; . = "T-00012321"; //    .(); //      var  = .; 

यहां हमने "नामकरण" निर्देशिका में एक नया समूह बनाया, फिर एक निर्देशिका तत्व बनाया और इसे बनाए गए समूह में रखा।

नमूने के गठन

किसी भी सभ्य ORM की तरह, ब्रोमीन क्लाइंट आपको विभिन्न 1C ऑब्जेक्ट संग्रह से नमूने बनाने की अनुमति देता है। एक चयन वस्तुओं के संग्रह का संदर्भ है जो चयन स्थितियों के एक सेट को संतुष्ट करता है। चयन बनाने के लिए, बस "चयनकर्ता" ऑब्जेक्ट बनाएं:

 var  = ...(""); var  = ...(); . (", , , ."). ("", false). ("", , .). (""). ("", .); foreach (var  in ) { Console.WriteLine(": {0}; : {1}, : {2}; : {3}", ., ., ., .. ); } //         var  = .(); 

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

क्वेरी का निष्पादन

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

 var  = .(@"  .  , .  , .    .    . = & "); .("", "-0001"); var  = .(); foreach (var  in ) { Console.WriteLine((., .)); } 

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

1 सी तरफ, सभी अनुरोध क्वेरी बिल्डर के माध्यम से निष्पादित किए जाते हैं, इसलिए आप न केवल एक पाठ के रूप में तैयार अनुरोध को निर्दिष्ट कर सकते हैं, बल्कि बिल्डर के लिए मार्कअप युक्त एक अनुरोध टेम्पलेट भी दे सकते हैं:

 var = .(@"   5 .  , .  , .   { .*}  ..( {(&)}, { ().*, ().*} )   { .} {  .*, .*} "); //         .("..", ""); //      .("", 100, .); //       .("."); .("", .); var  = .(.); 

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

रन विधि वैकल्पिक पैरामीटर "परिणामों के क्रॉल के प्रकार" को स्वीकार करती है। यदि आप क्रॉल प्रकार "समूह द्वारा" या "एक पदानुक्रम के साथ समूहीकरण" निर्दिष्ट करते हैं, तो मानों की तालिका के बजाय, विधि मानों के एक पेड़ को वापस कर देगी।

इसके अलावा, रन विधि के बजाय, आप रन पैकेज विधि को कॉल कर सकते हैं (एक बार में कई अनुरोधों को निष्पादित करने के लिए)। इस मामले में, ट्रेवर्सल के प्रकार के आधार पर, सारणी की एक सरणी या पेड़ों की एक सरणी वापस आ जाएगी।

कोड स्निपेट निष्पादन

कुछ विदेशी मामलों में, आपको सीधे 1 सी तरफ कोड के एक विशिष्ट टुकड़े को निष्पादित करने की आवश्यकता हो सकती है। ऐसा करने के लिए, ब्रोम क्लाइंट "रन" विधि प्रदान करता है। विधि निष्पादन योग्य कोड और एक वैकल्पिक पैरामीटर वाले इनपुट पाठ को लेती है, जो "पैरामीटर" चर में कोड में उपलब्ध होगा:

 var  = .(@"  = 0;        =  + ; ; ", new double[] { 45, 67, 12.56, 11.9 }); 

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

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

तकनीक के नुकसान के फायदे

वर्णित कार्यप्रणाली के लाभों में निश्चित रूप से शामिल होना चाहिए:

• क्रॉस-प्लेटफ़ॉर्म । सभी इंटरैक्शन SOAP और HTTP प्रोटोकॉल पर आधारित हैं, और उनका कार्यान्वयन सभी लोकप्रिय विकास प्लेटफार्मों पर है;
• कोड की सादगी । क्लाइंट एप्लिकेशन साइड पर कोड 1C साइड पर कोड के समान है;
• बिल्ट-इन क्रमांकन तंत्र । हमें 1 सी के साथ आदान-प्रदान करने के लिए डेटा पैक और अनपैक करने की आवश्यकता नहीं है;
• लिंक के साथ काम करने के लिए समर्थन । हमारे पास लिंक के माध्यम से 1 सी वस्तुओं तक आसान पहुंच है;
• 1C- विशिष्ट डेटा प्रकारों के लिए समर्थन । हम 1C तालिकाओं, पेड़ों, संरचनाओं और अन्य जटिल संरचनाओं के साथ विनिमय कर सकते हैं;
• एप्लिकेशन संदर्भ तक पहुंच । हमारे पास न केवल डेटाबेस डेटा तक पहुंच है, बल्कि 1 सी तरफ परिभाषित तरीकों को कॉल करने की क्षमता भी है, और सत्र राज्य तक भी पहुंच है।

इस तकनीक के नुकसान भी उपलब्ध हैं:

• कम डेटा दर । चूंकि SOAP प्रोटोकॉल XML क्रमांकन पर आधारित है, इसलिए बड़ी मात्रा में डेटा के हस्तांतरण के लिए अतिरिक्त ट्रैफ़िक के आदान-प्रदान के साथ-साथ डेटा को पैकिंग और अनपैक करने के लिए समय की आवश्यकता होती है। COM कनेक्शन के माध्यम से संचार इस संदर्भ में बेहतर लगता है;
• सभी प्लेटफार्मों पर एक सुविधाजनक क्लाइंट उपलब्ध नहीं है । यदि आप .Net कोर, पीएचपी या पायथन प्रोग्रामर नहीं हैं, तो आपको एसओएपी तंत्र का उपयोग करके ब्रोमीन क्लाइंट को स्वयं लागू करना होगा, जो आमतौर पर बोल रहा है, समय लेने वाली है;
• क्वेरी भाषा 1C की सीमाएँ । चूंकि डेटाबेस के साथ सभी कार्य 1 सी क्वेरी तंत्र के माध्यम से होते हैं, इसलिए कुछ सीमाएं हैं। उदाहरण के लिए, आप डेटा के क्लासिक पेजिनेशन को लागू नहीं कर सकते, क्योंकि क्वेरी भाषा 1C में पेजिंग के लिए कोई तंत्र नहीं हैं।

OData के साथ तुलना

1C के पूर्वोक्त लेख से, आप पता लगा सकते हैं कि 1C में: मानकीकृत OData प्रोटोकॉल का उपयोग करके डेटा तक एंटरप्राइज पहुंच को लागू किया गया है। इस कारण से, उसका उल्लेख न करना मूर्खता होगी।
यहाँ एक संक्षिप्त तुलना चार्ट दिया गया है:

यह देखा जा सकता है कि इन तरीकों के अपने फायदे और नुकसान हैं और, सामान्य स्थिति में, विनिमेय नहीं हैं।

निष्कर्ष

मुझे उम्मीद है कि यह समीक्षा लेख आपको भविष्य में जल्दी और आसानी से पोर्टल, व्यक्तिगत खातों और सेवाओं को बनाने में मदद करेगा जो 1 सी: एंटरप्राइज के आधार पर लेखा प्रणालियों के साथ घनिष्ठ रूप से एकीकृत हैं। आप आधिकारिक दस्तावेज में ब्रोमीन घटकों के बारे में विस्तृत जानकारी पा सकते हैं, यहां मुख्य विशेषताओं का संक्षिप्त विवरण है।