👩🏼‍🌾 ⏸️ 📙 Google शीट और डॉक्स के लिए यूनिवर्सल 1 सी एक्सटेंशन

यह लेख उन लोगों के लिए है जो जी सूट और 1 सी का उपयोग करते हैं।

PIK Digital एक IT कंपनी है जो बिल्डिंग टेक्नोलॉजी बनाती है। पिछले साल, हमने पीआईके ग्रुप ऑफ कंपनीज को जी सूट में स्थानांतरित कर दिया। Google शीट्स और डॉक्स के साथ पूरी तरह से काम करने के लिए, हमारे सिस्टम को परिष्कृत करना आवश्यक था।

इनमें से एक सुधार Google शीट और Google डॉक्स के प्रारूप में 1C से Google ड्राइव पर रिपोर्ट और फ़ॉर्म अपलोड करने के लिए एक एक्सटेंशन है। लेख में हम एक तैयार समाधान और इसके कार्यान्वयन पर उपयोगी जानकारी साझा करेंगे। विस्तार मुफ्त है। लो और उपयोग करो।

डाउनलोड एक्सटेंशन
GitHub पर कोड देखें

कार्य के विस्तार के लिए, आपको आवश्यकता होगी:

Google खाता पंजीकृत करें
Google क्लाउड प्लेटफ़ॉर्म पर एक प्रोजेक्ट बनाएं
OAuth क्लाइंट बनाएं
Google डिस्क API तक पहुंच को कॉन्फ़िगर करें
एक्सटेंशन 1C स्थापित करें
1C में Google API से कनेक्शन कॉन्फ़िगर करें

अगला, हम प्रत्येक चरण को अलग से मानते हैं और कोड उदाहरण देते हैं।

Google खाता पंजीकरण

काम करने के लिए, आपको एक Google खाते की आवश्यकता है। इसके बिना, एक्सटेंशन जी सूट सेवाओं के साथ बातचीत करने में सक्षम नहीं होगा। पहले से ही एक मौजूदा खाता है - इसका उपयोग करें।

जीसीपी में एक परियोजना का निर्माण

Google ड्राइव API तक पहुंच को सक्रिय करने के लिए, आपको Google क्लाउड प्लेटफ़ॉर्म (GCP) में एक प्रोजेक्ट बनाना होगा। मुफ्त में GCP के साथ काम करने के दो विकल्प हैं:

$ 300 के बजट के साथ 12 महीने की परीक्षण अवधि।
हमेशा फ्री - अधिकांश जीसीपी संसाधनों तक पहुंच।

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

हम प्रोजेक्ट को लिंक कंसोल.क्लाउड.ओक डॉट कॉम पर पंजीकृत करते हैं, "प्रोजेक्ट का चयन करें" पर क्लिक करें, फिर - "प्रोजेक्ट बनाएं।" प्रोजेक्ट बनाने के बाद, फिर से "प्रोजेक्ट चुनें" बटन दबाकर इसे चुनें।

OAuth क्लाइंट बनाना

OAUth 2.0 प्रोटोकॉल का उपयोग करके जी सूट से कनेक्ट करने के लिए क्रेडेंशियल बनाएं। जीसीपी में, मेनू आइटम "एपीआई और सर्विसेज" पर जाएं - "क्रेडेंशियल्स" - "क्रिएट क्रेडेंशियल्स" - "ओयूएएचटी कुंजी आइडेंटिफ़ायर"।

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

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

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

Google डिस्क API लाइब्रेरी कनेक्ट करना

एपीआई कार्यक्षमता तक पहुंच प्राप्त करने के लिए, मेनू आइटम "एपीआई लाइब्रेरी" पर जाएं, वांछित पुस्तकालय ढूंढें और इसे कनेक्ट करें।

चूंकि हम जी सूट प्रारूपों के साथ काम करना चाहते हैं, इसलिए हमें Google डिस्क एपीआई पुस्तकालय को परियोजना से जोड़ना होगा। इसके अलावा, हमें Google शीट API लाइब्रेरी, Google डॉक्स API की आवश्यकता होगी। इसे उसी तरीके से ढूंढें और कनेक्ट करें।

उपयोगकर्ता मोड में एक्सटेंशन इंस्टॉल करें

अब आप एपीआई के लिए अनुरोध तैयार कर सकते हैं। स्मरण करें: हमारा कार्य मानक प्रपत्र की 1C रिपोर्ट से डेटा को Google पत्रक या Google डॉक्स पर अपलोड करना है।

एक्सटेंशन 1C डाउनलोड करें।

1 सी में, स्वतंत्र रूप से कॉन्फ़िगरेशन एक्सटेंशन स्थापित करना संभव है। यदि यह आपका पहली बार सामना कर रहा है, तो यह करने के लिए हमारे लघु वीडियो देखें ।

हमारा विस्तार संस्करण 8.3.10 से शुरू होने वाले प्लेटफ़ॉर्म के साथ काम करता है, बीपी कॉन्फ़िगरेशन (3.0.65 और उच्चतर से शुरू), ईआरपी (2.4.6 और उच्चतर से शुरू) और यूटी (11.4.6 और उच्चतर से शुरू)।

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

यदि स्थापना सफल रही, तो आप रिपोर्ट और प्रिंट फ़ॉर्म में "सेव टू गूगल ड्राइव" बटन देखेंगे।

1C में Google API से कनेक्ट करने के लिए पैरामीटर सेट करना

यह Google API से कनेक्ट करने के लिए सेटिंग्स को कॉन्फ़िगर करने के लिए बना हुआ है, और आप काम कर सकते हैं। फिर से, मेनू में "सभी कार्य" आइटम का चयन करें और "प्रसंस्करण" अनुभाग में हम "Google एपीआई कनेक्शन सेटिंग्स" आइटम की तलाश करते हैं।

हम GCP में प्रोजेक्ट बनाते समय प्राप्त मानों के साथ Clientid, Clientsecret और "Port" फ़ील्ड भरते हैं। डिफ़ॉल्ट रूप से, फ़ाइल और फ़ोल्डर का नाम प्रतिस्थापित किया जाता है जहां कनेक्शन के लिए उपयोग की जाने वाली अस्थायी कुंजियों को सहेजा जाएगा। सुरक्षा उद्देश्यों के लिए, उपयोगकर्ता की कुंजियों (ताज़ा और पहुंच टोकन) के बारे में डेटा वर्तमान उपयोगकर्ता की अस्थायी फ़ाइलों निर्देशिका, फ़ोल्डर <फ़ोल्डर नाम> और फ़ाइल <फ़ाइल नाम> में संग्रहीत किया जाता है। यदि एक ही Google प्रोजेक्ट अलग-अलग कॉन्फ़िगरेशन में बनाया गया है, तो फ़ाइल नाम को उन सभी में समान बनाया जा सकता है, इसलिए एक ही जानकारी के साथ कई फ़ाइलों को बनाने के लिए नहीं। सहेजते समय, कनेक्शन सेटिंग्स सामान्य सेटिंग्स रिपॉजिटरी में सहेजी जाती हैं।

बचत रिपोर्ट

अब आप Google शीट में Google शीट और Google डॉक्स के प्रारूप में रिपोर्ट सहेज सकते हैं।

रिपोर्ट को सहेजने के पहले प्रयास में, आपको प्रत्येक कॉन्फ़िगरेशन में एक-बार उपयोगकर्ता प्राधिकरण प्रक्रिया से गुजरना होगा ताकि डेटा को बचाने के लिए सेवा को एक्सेस अधिकार प्राप्त हो।

दिखाई देने वाली विंडो में, अपना जीमेल ईमेल पता और पासवर्ड दर्ज करें। आगे
खुलने वाली विंडो में, "अनुमति दें" पर क्लिक करें। तो आप अपने Google ड्राइव में जानकारी सहेजने के लिए एप्लिकेशन देते हैं।

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

मुद्दे का तकनीकी पक्ष

अब देखते हैं कि यह 1 सी प्लेटफॉर्म के अंदर कैसे काम करता है।
कनेक्ट करने के लिए, Google सेवा के लिए निम्न क्वेरी लाइन उत्पन्न होती है:

="https://accounts.google.com/o/oauth2/auth"+"?" + "response_type=code" + "&client_id=" + _ + "&redirect_uri=http://localhost" + "&access_type=offline" + "&scope=https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.apps.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.appdata https://www.googleapis.com/auth/drive.metadata;

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

इस क्वेरी स्ट्रिंग को Google सेवा में हमारे क्लाइंट एप्लिकेशन के एक-बार कनेक्शन के लिए आवश्यक है। आप ब्राउज़र में क्वेरी स्ट्रिंग दर्ज कर सकते हैं, जवाब में, सेवा कुछ इस तरह से URL लौटाएगी:

 http://localhost/?code=<>&scope=https://www.googleapis.com/auth/admin.directory.user%20https://www.googleapis.com/auth/admin.directory.orgunit

आप 1C फॉर्म डिजाइनर में HTML डेटा के लिए एक फ़ील्ड जोड़ सकते हैं और इसके माध्यम से एक अनुरोध निष्पादित कर सकते हैं। हमें इस URL से सेवा के लिए मूल्य <CODE> - एक्सेस कोड प्राप्त करने की आवश्यकता है।

यह HTTP अनुरोध करके दो टोकन प्राप्त करने के लिए बना हुआ है। परिणामस्वरूप, अनुरोध JSON प्रारूप में पहुंच और ताज़ा मूल्यों के साथ एक स्ट्रिंग लौटाएगा। ताज़ा टोकन समय के साथ प्रासंगिकता नहीं खोता है, और एक्सेस टोकन 60 मिनट तक रहता है और फिर इसे अपडेट करने की आवश्यकता होती है। इन टोकन को प्राप्त करने के लिए, हमें बस प्राप्त किए गए <CODE>, साथ ही क्लाइंट की पहचानकर्ता और रहस्य की आवश्यकता है जिसे हमने पहले बचाया था।

कोड कुछ इस तरह हो सकता है:

  = "accounts.google.com";  = "/o/oauth2/token";  = ("client_id=%1&client_secret=%2&grant_type=authorization_code&code=%3&redirect_uri=http://localhost", _, _, );  =  HTTP(,443,,,,, OpenSSL);  =  ; .("Content-Type","application/x-www-form-urlencoded”) HTTP =  HTTP(,); HTTP.();  = .HTTP("POST", HTTP);   . = 200  .(("   : %1", .())); ; ;  = .();  =  JSON(); .();  = XDTO.JSON(); .();  = .access_token;  = .refresh_token;  = .expires_in;

वैरिएबल एक्सपायर_इन में एक्सेस टोकन का जीवनकाल होता है।
टोकन को अद्यतन करने के लिए निम्नलिखित अनुरोध है:

  = "accounts.google.com";  = "/o/oauth2/token";  = Google.refresh_token; _ = Google.client_id; _ = Google.client_secret;  = "grant_type=refresh_token" + "&client_id=" + _ + "&client_secret=" + _ + "&refresh_token=" + ;

Google डिस्क पर एक स्प्रेडशीट दस्तावेज़ सहेजना

अब देखते हैं कि Google डिस्क पर स्प्रेडशीट दस्तावेज़ को कैसे सहेजा जाए और फिर उसे Google शीट में परिवर्तित करें।

 //  HTTP   = "file_for_drive"; // HTTP      = Google()[]; .("Content-Type", "multipart/related; boundary=" + ); //----- //  //----- //  =  ; .("Content-Type: application/json; charset=UTF-8"); //  // json    ,     = GSs(, , id_);  = GoogleAPI_._(, ); //----- //   //----- //----- //  //----- // .(); .("Content-Type: " + ); .("uploadType: media"); //   = (); .(, ()[]);  = GoogleAPI_._(,  ()); //----- //   //----- //----- //    .  =  ; .(); .();  = GoogleAPI_.HTTP(, ); //----- HTTP =  HTTP("/upload/drive/v2/files" + "?uploadType=multipart&convert=true",); HTTP.();  =.HTTP("POST", HTTP);   . = 200   = " HTTP  " + .() + ",   " + .; GoogleAPI_.GS(, ".  ");  ""; ; HTTP = ; HTTP = ;  ();  (" ",.,,,()); ; HTTP = .(); JSON = GoogleAPI_GSheets.JSON(HTTP); //     google drive  GoogleAPI_GSheets.JSON(JSON, "alternateLink");

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

Google डिस्क नॉलेज बेस फ़ाइलों को सम्मिलित करने के बारे में हमारे लेख में इसके बारे में अधिक जानें।

यह इसी तरह काम करता है। हमें उम्मीद है कि अब आप 1C से डाउनलोड किए गए डेटा को परिवर्तित करने में समय बर्बाद नहीं करेंगे।

हमारे विस्तार के लेखक PIK Digital Brazhnikova Maria mbrazh के प्रमुख डेवलपर हैं

Google शीट और डॉक्स के लिए यूनिवर्सल 1 सी एक्सटेंशन - ले और उपयोग करें