Editor ऐड-ऑन की जांच करना

पब्लिश करने से पहले, ऐड-ऑन की अच्छी तरह से जांच की जानी चाहिए, ताकि यह पक्का किया जा सके कि वे उम्मीद के मुताबिक काम कर रहे हैं. Apps Script की मदद से, Google Docs, Sheets, Forms या Slides की चुनिंदा फ़ाइलों पर, डेवलपमेंट के दौरान Editor ऐड-ऑन को टेस्ट किया जा सकता है. इसका इस्तेमाल इन कामों के लिए किया जा सकता है:

  • पुष्टि करें कि किसी शीट, दस्तावेज़, प्रज़ेंटेशन या फ़ॉर्म पर लागू होने पर, स्टैंडअलोन स्क्रिप्ट में लिखा गया ऐड-ऑन सही तरीके से काम करता है.
  • पुष्टि करें कि ऐड-ऑन इंस्टॉल करने का फ़्लो सही तरीके से काम कर रहा है. खास तौर पर, अनुमति देने की लाइफ़साइकल की अलग-अलग शुरुआती स्थितियों (इंस्टॉल किया गया, चालू किया गया या दोनों) के लिए.
  • पुष्टि करें कि किसी दस्तावेज़ और उसके कॉन्टेंट पर कार्रवाई करते समय, ऐड-ऑन आपकी उम्मीद के मुताबिक काम कर रहा हो.
  • ऐड-ऑन के मौजूदा और पिछले वर्शन की जांच करें और उनकी तुलना करें.

टेस्ट डिप्लॉयमेंट बनाना

टेस्ट डिप्लॉयमेंट, ऐड-ऑन और टेस्ट दस्तावेज़ का कॉम्बिनेशन होता है. स्क्रिप्ट का वर्शन तैयार होने के बाद, अगर आपको उसे ऐड-ऑन के तौर पर टेस्ट करना है, तो यह तरीका अपनाएं:

  1. अगर आपके पास पहले से कोई स्प्रेडशीट, दस्तावेज़, प्रज़ेंटेशन या फ़ॉर्म नहीं है, तो ऐड-ऑन को आज़माने के लिए एक बनाएं.
  2. वह स्क्रिप्ट प्रोजेक्ट खोलें जिसमें आपका ऐड-ऑन मौजूद है.
  3. डिप्लॉय करें > टेस्ट डिप्लॉयमेंट पर क्लिक करें.
  4. टाइप चुनें के बगल में, डिप्लॉयमेंट के टाइप चालू करें पर क्लिक करें. इसके बाद, Editor ऐड-ऑन चुनें.
  5. नया टेस्ट बनाएं या टेस्ट जोड़ें पर क्लिक करें.
  6. कोड का कोई वर्शन चुनें या नया कोड चुनें.
  7. कॉन्फ़िगरेशन सेक्शन में जाकर, टेस्ट के लिए अनुमति की शुरुआती स्थिति चुनें.
  8. टेस्ट दस्तावेज़ में जाकर, कोई दस्तावेज़ नहीं चुना गया पर क्लिक करें. Sheets, Docs, Slides या Forms की वह फ़ाइल चुनें जिसका इस्तेमाल करके आपको ऐड-ऑन की जांच करनी है. इसके बाद, शामिल करें पर क्लिक करें.
  9. टेस्ट सेव करें पर क्लिक करें.

सेव किए गए सभी टेस्ट डिप्लॉयमेंट, टेस्ट डिप्लॉयमेंट डायलॉग में दिखते हैं. इससे आपको बाद में, उसी टेस्ट डिप्लॉयमेंट को फिर से देखने का विकल्प मिलता है.

टेस्ट डिप्लॉयमेंट चलाना

अगर आपने एक या उससे ज़्यादा टेस्ट डिप्लॉयमेंट सेव किए हैं, तो यह तरीका अपनाकर उनमें से किसी एक को चलाया जा सकता है:

  1. वह स्क्रिप्ट प्रोजेक्ट खोलें जिसमें आपका ऐड-ऑन मौजूद है.
  2. डिप्लॉय करें > टेस्ट डिप्लॉयमेंट पर क्लिक करें.
  3. सेव किए गए टेस्ट में जाकर, सेव किए गए उस टेस्ट के बगल में मौजूद रेडियो बटन चुनें जिसे आपको डिप्लॉय करना है. इसके बाद, लागू करें पर क्लिक करें.

टेस्ट वाला दस्तावेज़, नए टैब में खुलता है. ऐड-ऑन, टेस्ट डिप्लॉयमेंट में बताई गई अनुमति की स्थिति में है. ऐड-ऑन के मेन्यू और यूज़र इंटरफ़ेस (यूआई) एलिमेंट के साथ इंटरैक्ट करके, यह पुष्टि की जा सकती है कि ऐड-ऑन ठीक से काम कर रहा है या नहीं.

अपने ऐड-ऑन पर ग्रैनुलर OAuth सुविधा को आज़माने के लिए, पक्का करें कि आपके प्रोजेक्ट में पहले से ही अनुमतियां न हों. मौजूदा अनुमतियों को अमान्य करने के लिए, ScriptApp.invalidateAuth का इस्तेमाल करें.

टेस्टिंग से जुड़ी जानकारी

इस तरीके से Editor ऐड-ऑन की टेस्टिंग करते समय, आपको इन बातों का ध्यान रखना होगा:

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