टीएसडी पर आवेदन और 1 सी के साथ संचार: एंटरप्राइज़ 8.3 HTTP-Service के माध्यम से। भाग 2 (एपीआई कार्यान्वयन 1C की ओर)

1. विनिमय विधि का विकल्प। एपीआई विवरण।

2. 1 सी के किनारे पर एपीआई का कार्यान्वयन।

3. TSD पर आवेदन और 1C के साथ संचार: HTTP-सेवा के माध्यम से एंटरप्राइज़ 8.3। भाग 3 (ब्रॉडकास्टसीवर। डेटा प्राप्त करना)

इंटरनेट पर एचटीटीपी सेवा कैसे बनाई जाए, इस पर बहुत सारे मैनुअल हैं। इसलिए, मैं तुरंत कार्यान्वयन का वर्णन करूंगा। हमारी सेवा में तीन URL पैटर्न हैं:

• निर्देशिकाएँ - / v1 / कैटलॉग / {निर्देशिका} / {क्रिया}
• दस्तावेज़ - / v1 / दस्तावेज़ / {दस्तावेज़} / {कार्रवाई}
• सेवाएं - / v1 / सेवाएं / {क्रिया}

लेख को न बढ़ाने के लिए, संदर्भ पुस्तक "नामकरण" के साथ उदाहरण पर विचार करें। 1C हमें HTTP के तरीकों के लिए अलग-अलग रास्तों की अनुमति नहीं देता है। इसलिए, URL पैटर्न (/ v1 / कैटलॉग / वेयर / {Action} होगा, जिसके लिए दो HTTP तरीके GET, POST परिभाषित हैं। अन्य पैटर्न में हम ZET, POST का भी उपयोग करेंगे।

• / v1 - हमें भविष्य में कई एपीआई विकल्पों का समर्थन करने की अनुमति देगा। हम URL टेम्पलेट v_V2_Directories और तदनुसार पथ / v2 के साथ शुरू करने में सक्षम होंगे
• / कैटलॉग / माल / - कैटलॉग सभी निर्देशिकाओं को एकीकृत करता है। यह रास्ते का स्थिर हिस्सा है। नामांकित निर्देशिका का अनुपालन करता है। 1C URL पैरामीटर में "वेयर" डाल देगा। यह ध्यान दिया जाना चाहिए कि हम खुद के तरीकों के साथ आते हैं। और फिर हम यह भी सोचते हैं कि 1 सी में उन्हें कैसे संसाधित किया जाए
• {क्रिया} - यहां हम वह पास करेंगे जो हम 1 सी से प्राप्त करना चाहते हैं। उदाहरण के लिए getByParam या getAll

रेट्रोफिट के दृष्टिकोण से, बेसुएल कुछ इस तरह दिखाई देगा "http://192.168.0.1/unf/hs/inntsd/v1/" जहां:

• 192.168.0.1 - सर्वर जहां HTTP सेवा प्रकाशित होती है
• / unf - 1C डेटाबेस नाम
• / hs - HTTP सेवाओं के लिए स्थिर हिस्सा
• / inntsd संपूर्ण सेवा के लिए रूट URL है। जैसा हम चाहते हैं वैसा ही बुलाओ

अनुरोध प्राप्त करने के लिए प्रक्रिया पर विचार करें।

  Get() //  .       Get   //Post  = (, "GET"); //middleware.      .  = ();     = ();  (, )   = (); //   {}  = (); //   {}  = (); //     URL.      .URL  =(); //      .     Firefox ,  Google Chrome   =  ; .("", ); .("", ); .("", ); .("", ); .("", );  ;   ()  = ..("Content-Type");  =  ; .("", ); //     "Content-Type","content-type", "Content-type"   =    = ..("content-type"); ;   =    = ..("ontent-type"); ;   =   .("", );  ; ;  ((), "multipart/form-data") > 0   = ();  ((), "application/json") > 0   = JSON();  .("", ); ;  ;  //      JSON    .     .  JSON(); JSON =  JSON;  = .(); JSON.();   = JSON(JSON,,"sampleDate",JSON.ISO); .("", );   =  ; .("", ); ; JSON.();  ;  

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

चलो getByParam अनुरोध पार्स करें । पूरा पता: / v1 / कैटलॉग / माल / getByParam? Prop = byCode और तुलना = इसी तरह और searchString = 239

पता करें कि हम किस निर्देशिका के साथ काम कर रहे हैं।

  ()  . = ""   = ();  . = ""   = ()   = (100, "    " + .); ;  ;  

अनुरोध विधि प्राप्त करें। और हम जांचते हैं कि सभी पैरामीटर विधि से जुड़े हैं। यहाँ यह ध्यान दिया जाना चाहिए कि मैं गहरी जाँच नहीं करता हूँ। चूंकि मैं 1C और Android दोनों के लिए लिख रहा हूं।

  ()  . = ""   = ..("prop");  = ..("comparison");  = ..("searchString");  ( = )  ( = )  ( = )   = (103, "     /      ");  ; ;  = (, , );  = (0, ""); .("payload", );  . = ""   = ();  = (0, ""); .("payload", );   = ("102", "     " + .); ;  ;  

अगर सब ठीक है। हम उत्तर के लिए डेटा तैयार करते हैं।

  (, , )  =  ;  = "  | .  , | .  , | .  , | .  , | ..   | | .   | |  . |  {}";  = "";  () = ("byCode")   = ".";  () = ("byArticle")   = ".";  () = ("byName")   = "."; ;  () = ("equally")   =  + " = &";  () = ("similarly")   =  + "  &"; ;  = (, "{}", ); . = ;  () = ("similarly")   = "%" +  + "%"; ; .("", );  = .().();  = .();  =  ;       .( ("code,article, name, fullName, unit", ., ., ., ., .)); ;  =  ; .("quantity", ); .("wares", );  ;  

और अंत में, हम एक साथ सब कुछ एकजुट करते हैं। हम इसे JSON में डालते हैं और प्रतिक्रिया भेजते हैं।

  = (0, ""); .("payload", );  ;  (, )   = (); HTTP =  HTTP(); HTTP.["Content-Type"] = "application/json; charset=utf-8"; //   json UTF-8 // ToDo CORS //HTTP.["Access-Control-Allow-Origin"] = ; //HTTP.["Access-Control-Allow-Credentials"] = "true"; HTTP.();  HTTP;   () JSON =  JSON(, .,,,,,,,);  =  JSON; . = ; .(JSON);  =  JSON; . = JSON.; . = JSON.ISO; JSON(, , );  = .();  ;  

और हम ग्राहक को यह सब देते हैं।

  = (200, )  ; 

भले ही हमें 1 सी से मिला हो। हम हमेशा सही उत्तर देने का प्रयास करते हैं।

  (, )  =  ;  =  (); .("code", ); .("description", ); .("result", ); .("payload",  );  ;  

वह सब है। अन्य सभी तरीकों को एक समान तरीके से लागू किया जाता है। प्रश्न पूछें। मुझे उत्तर देने में खुशी होगी।