इस पेज का अनुवाद Cloud Translation API से किया गया है.

कम्यूनिटी कनेक्टर में जोड़ी गई गड़बड़ियों और मैसेज को मैनेज करना

उपयोगकर्ताओं को अच्छा अनुभव देने के लिए, यह ज़रूरी है कि आपका कोड, गड़बड़ियों को सही तरीके से हैंडल करे. उपयोगकर्ताओं को गड़बड़ी के मैसेज दिखाए जाते हैं, ताकि गड़बड़ियों को ठीक करने के तरीके बताए जा सकें उस समस्या का समाधान करना.

इस दस्तावेज़ में कनेक्टर से जुड़ी गड़बड़ियों के बारे में जानकारी दी गई है. साथ ही, कनेक्टर की गड़बड़ियों को ठीक से मैनेज करने का तरीका भी बताया गया है.

जानकारी: JavaScript में अपवादों को मैनेज करने के बारे में ज़्यादा जानने के लिए, यह देखें ट्राई...कैच स्टेटमेंट करें.

गड़बड़ियां किस तरह की हैं

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

कनेक्टर की अंदरूनी गड़बड़ियां
कनेक्टर की बाहरी गड़बड़ियां
Looker Studio से जुड़ी गड़बड़ियां

कनेक्टर की आंतरिक और बाहरी गड़बड़ियों को कनेक्टर से हैंडल किया जाना चाहिए डेवलपर. ये गड़बड़ियां, डेवलपर के बनाए गए कोड की वजह से होती हैं.

कनेक्टर में कोई गड़बड़ी हुई

कनेक्टर में कोई गड़बड़ी होने पर, कनेक्टर में कोई गड़बड़ी होती है. उदाहरण के लिए, अगर getData() को लागू करने के दौरान, कनेक्टर एपीआई के रिस्पॉन्स को पार्स नहीं कर सकता. इन गड़बड़ियों का अनुमान लगाया जाना चाहिए और इन्हें उपयोगकर्ता को आसानी से समझ में आने लायक जानकारी के साथ मैनेज किया जाना चाहिए जहां लागू हो.

कनेक्टर की आंतरिक गड़बड़ियों को हैंडल करने के बारे में ज़्यादा जानकारी के लिए, देखें कनेक्टर की गड़बड़ियों को हैंडल करने के सबसे सही तरीके.

कनेक्टर की बाहरी गड़बड़ी

कनेक्टर की बाहरी गड़बड़ियां, कनेक्टर निष्पादन के बाद होती हैं. उदाहरण के लिए, जब किसी तीन फ़ील्ड के लिए getData() का अनुरोध, सिर्फ़ दो का डेटा दिखाता है. हालांकि, कनेक्टर ने एक्ज़ीक्यूशन पूरा किया, क्योंकि इसने Looker से मिला अनुरोध पूरा नहीं किया स्टूडियो. अच्छी तरह से जांच करने से इन गड़बड़ियों को रोका जा सकता है.

कनेक्टर की बाहरी गड़बड़ियां आम तौर पर गड़बड़ी के ब्यौरे की समीक्षा करके ठीक की जा सकती हैं (अगर उपलब्ध है) और समस्या का पता लगाने के लिए कोड को डीबग करते हैं. अगर आपको ज़्यादा जानकारी चाहिए, तो कनेक्टर को डीबग करने के लिए, अपना कोड डीबग करने का तरीका देखें.

Looker Studio में गड़बड़ी

Looker Studio में आने वाली गड़बड़ियां, ऐसी गड़बड़ियां होती हैं जो आपके कनेक्टर कोड से नहीं जुड़ी होती. उदाहरण के लिए, अगर कोई उपयोगकर्ता ऐसे डेटा सोर्स के साथ टाइम सीरीज़ चार्ट का इस्तेमाल करता है जिसमें तारीख/समय डाइमेंशन.

अगर गड़बड़ी सीधे तौर पर कनेक्टर से नहीं जुड़ी है, तो कोई कार्रवाई नहीं होगी का सुझाव दिया जाता है. उपयोगकर्ता यहां जाकर ज़्यादा मदद पा सकते हैं Looker Studio सहायता केंद्र पर जाएं.

गड़बड़ी के मैसेज दिखाए जा रहे हैं

एडमिन की स्थिति के आधार पर गड़बड़ी की जानकारी दिखाई जा रही है

जब कनेक्टर कोई गड़बड़ी दिखाता है, तो Looker Studio गड़बड़ी का मैसेज दिखाता है उपयोगकर्ता के एडमिन स्टेटस के हिसाब से.

अगर उपयोगकर्ता एडमिन है, तो उसे पूरी जानकारी दिखेगी. इसमें ये शामिल हैं गड़बड़ी का मैसेज, गड़बड़ी का टाइप, और स्टैक ट्रेस.
अगर उपयोगकर्ता, खाते का एडमिन नहीं है, तो उसे जानकारी सिर्फ़ तब दिखेगी, जब की गड़बड़ी का पता लगाना है. गड़बड़ी दिखाने के बारे में ज़्यादा जानने के लिए गैर-एडमिन उपयोगकर्ताओं को भेजे जाने वाले मैसेज, उपयोगकर्ता को असाइन की जा रही गड़बड़ियां देखें.

उपयोगकर्ता को होने वाली गड़बड़ियां थ्रो करना

डिफ़ॉल्ट रूप से, सिर्फ़ कनेक्टर एडमिन को गड़बड़ियों की जानकारी दिखती है. इससे इन समस्याओं को रोकने में मदद मिलती है स्टैक में मौजूद एपीआई पासकोड जैसी संवेदनशील जानकारी को अनजाने में ज़ाहिर करना ट्रेस करें. गैर-एडमिन उपयोगकर्ताओं को गड़बड़ी के मैसेज दिखाने के लिए, newUserError() का इस्तेमाल करें Looker Studio Apps Script सेवा.

उदाहरण:

try {
  // API request that can be malformed.
  getDataFromAPI();
} catch (e) {
  DataStudioApp.createCommunityConnector()
      .newUserError()
      .setDebugText('Error fetching data from API. Exception details: ' + e)
      .setText('There was an error communicating with the service. Try again later, or file an issue if this error persists.')
      .throwException();

}

इस उदाहरण में, setText() वह टेक्स्ट सेट करता है जो सभी लोगों को दिखाया जाएगा. जबकि setDebugText() टेक्स्ट को सेट करता है, जो सिर्फ़ खाते के एडमिन को दिखेगा.

कनेक्टर की गड़बड़ियों को हैंडल करने के सबसे सही तरीके

इस प्रोसेस के दौरान, ज़्यादा से ज़्यादा गड़बड़ियों को पहचानने और उन्हें ठीक करने की कोशिश करें लागू किया गया है. उदाहरण के लिए, कुछ सामान्य कार्रवाइयां जो हो सकती हैं इनमें ये वजहें शामिल हैं:

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

ठीक की जा सकने वाली गड़बड़ियों को ठीक करना

कनेक्टर को एक्ज़िक्यूशन के वे पॉइंट जो पूरे नहीं हो सकते, लेकिन जिन्हें रिकवर किया जा सकता है हैंडल किया गया. उदाहरण के लिए, अगर कोई एपीआई अनुरोध किसी गंभीर वजह से पूरा नहीं हो पाता है (जैसे कि सर्वर लोड शेडिंग). इसके बाद, कोई गड़बड़ी डालने से पहले फिर से कोशिश करनी चाहिए.

गड़बड़ियां पकड़ें और थ्रो करें

ठीक न की जा सकने वाली गड़बड़ियों का पता लगाकर उन्हें फिर से हटा देना चाहिए. फिर से थ्रो की गई गड़बड़ी से उपयोगकर्ताओं को यह समझने में मदद मिलेगी कि गड़बड़ी क्यों हुई. क्या समस्या को ठीक किया जा सकता है तो सुधारात्मक कार्रवाई की जानकारी दी जानी चाहिए.

उपयोगकर्ता को मिलने वाली गड़बड़ियां देखें.

स्टैकड्राइवर में गड़बड़ियां लॉग करें

डेटा को लॉग करने में हुई गड़बड़ियों और अन्य मैसेज के लिए, स्टैकड्राइवर का इस्तेमाल करें. इससे इन कामों में मदद मिलती है गड़बड़ियों को समझना, समस्याओं को डीबग करना, और हैंडल नहीं किए गए अपवादों का पता लगाना.

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

रोका गया: सुरक्षित गड़बड़ी के मैसेज के लिए, `DS_USER:` प्रीफ़िक्स का इस्तेमाल करें

गैर-एडमिन उपयोगकर्ताओं को गड़बड़ी के मैसेज उपलब्ध कराने के लिए, गड़बड़ी के मैसेज के साथ DS_USER: प्रीफ़िक्स. इस प्रीफ़िक्स का इस्तेमाल, सुरक्षित कॉन्टेंट की पहचान करने के लिए किया जाता है के मैसेज देख सकते हैं और असली गड़बड़ी के मैसेज में शामिल नहीं किए जाते.

नीचे दिए गए उदाहरणों में, ऐसा मामला शामिल है जहां गड़बड़ी का मैसेज दिखाया जाएगा एडमिन के अलावा अन्य उपयोगकर्ता जहां गड़बड़ी का मैसेज सिर्फ़ एडमिन को दिखेगा उपयोगकर्ता:

data-studio/errors.gs

GitHub पर देखें

// Admin and non-admin users will see the following error.
try {
  // Code that might fail.
} catch (e) {
  throw new Error('DS_USER:This will be shown to admin & non-admin.');
}

// Only admin users will see the following error.
try {
  // Code that might fail.
} catch (e) {
  throw new Error('This message will only be shown to admin users');
}

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है