Google पत्रक में कस्टम फ़ंक्शन जोड़ें: 5 चरण

2024 लेखक: John Day | [email protected]. अंतिम बार संशोधित: 2024-01-30 09:19

मुझे यकीन है कि आपके जीवन के किसी बिंदु पर आपको Microsoft Excel या Google पत्रक जैसे स्प्रेडशीट सॉफ़्टवेयर का उपयोग करना होगा।

वे उपयोग करने के लिए अपेक्षाकृत सरल और सीधे आगे हैं लेकिन बहुत शक्तिशाली और आसानी से विस्तार योग्य भी हैं।

आज, हम Google पत्रक और कोड और कस्टम फ़ंक्शन जोड़ने की इसकी क्षमता पर गौर करेंगे ताकि हम इसे बढ़ा सकें।

चरण 1: कार्य क्या हैं?

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

सभी स्प्रैडशीट सॉफ़्टवेयर ऐसे बहुत से कार्यों का समर्थन करते हैं जो उनमें पूर्व-निर्मित होते हैं लेकिन वे उन्हें विस्तारित करने और अपने स्वयं के लिखने की क्षमता का भी समर्थन करते हैं।

चरण 2: कस्टम फ़ंक्शन कैसे लिखें?

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

लिखना शुरू करने के लिए हम शीर्ष मेनू में टूल्स> स्क्रिप्ट संपादक पर जा सकते हैं और वह ऑनलाइन कोड संपादक लाएगा।

इसमें, पहली बार खुलने पर, हमारे पास एक फ़ाइल होगी, जिसे Code.gs कहा जाता है, साथ ही एक रिक्त प्रारंभिक फ़ंक्शन, जिसका नाम myFunction होगा।

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

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

इस फ़ंक्शन को निष्पादित करते समय, Google पत्रक शीघ्र ही सेल में एक लोडिंग संदेश प्रदर्शित करेगा, लेकिन फिर यह फ़ंक्शन से लौटाया गया मान प्रदर्शित करेगा।

चरण 3: कार्य सीमाएं और स्वत: पूर्ण

ये कार्य जो हम चाहते हैं वह कर सकते हैं लेकिन कुछ सीमाएँ हैं जिनका हमें पालन करने की आवश्यकता है जैसे:

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

प्रत्येक फ़ंक्शन हमारे उदाहरण के अनुसार एकल मान लौटा सकता है, लेकिन यह मानों की एक सरणी भी लौटा सकता है। इस सरणी को तब तक आसन्न कोशिकाओं में विस्तारित किया जाएगा जब तक कि वे खाली हों। यदि वे नहीं हैं तो त्रुटि दिखाई जाएगी।

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

ऐसा करने के लिए, हमें एक टिप्पणी के रूप में फ़ंक्शन के सामने एक JsDoc @customfunction टैग जोड़ने की आवश्यकता है, जहां इस टिप्पणी में हम एक संक्षिप्त विवरण लिख सकते हैं कि हमारा फ़ंक्शन क्या करता है।

अब टिप्पणी के साथ, जब हम फ़ंक्शन का नाम लिखना शुरू करते हैं, तो फ़ंक्शन विवरण के साथ-साथ स्वत: पूर्ण द्वारा फ़ंक्शन की पेशकश की जाएगी।

चरण 4: बाहरी सेवाओं को कॉल करना

इन कार्यों में जो महान शक्ति है, वह Google से अन्य टूल और सेवाओं जैसे अनुवाद, मानचित्र, बाहरी डेटाबेस से कनेक्ट करने, एक्सएमएल और अन्य के साथ काम करने की क्षमता से आती है। अब तक, मेरे लिए सबसे शक्तिशाली विशेषता किसी भी एपीआई या वेबपेज पर बाहरी HTTP अनुरोध करने और UrlFetch सेवा का उपयोग करके उससे डेटा प्राप्त करने की क्षमता है।

इसे प्रदर्शित करने के लिए, मैं एक फ़ंक्शन में पेस्ट करूँगा जो यूएस डॉलर को स्विस फ़्रैंक में बदल देगा लेकिन यह मुद्रा दर को नहीं मानेगा बल्कि इसके बजाय, इसे बाहरी एपीआई से पुनर्प्राप्त करेगा।

फ़ंक्शन अंतर्निहित कैश सेवा का भी उपयोग करता है जहां यह सभी गणनाओं के लिए एपीआई को कॉल नहीं करेगा, लेकिन यह पहली गणना के लिए इसे एक बार कॉल करेगा और फिर यह उस मान को कैश में संग्रहीत करेगा।

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

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

चरण 5: अगले चरण

यदि आपको यह दिलचस्प लगता है और आप और जानना चाहते हैं, तो मैं अतिरिक्त संसाधनों के लिए नीचे लिंक छोड़ दूंगा।

developers.google.com/apps-script/guides/s…

developers.google.com/apps-script

अगर आपको इंस्ट्रक्शनल पसंद आया है, तो मेरे YouTube चैनल को सब्सक्राइब करना सुनिश्चित करें यदि आपने पहले से नहीं किया है और मेरे कुछ अन्य इंस्ट्रक्शंस को देखें।

चीयर्स और पढ़ने के लिए धन्यवाद।