15.05.27.00 - Apigee डेवलपर सेवाएं पोर्टल के रिलीज़ नोट

आपको Apigee Edge का दस्तावेज़ दिख रहा है.
Apigee X के दस्तावेज़ पर जाएं.
जानकारी

हमने मंगलवार, 2 जून, 2015 को Apigee Developer Services Portal का नया क्लाउड वर्शन रिलीज़ किया था.

अगर आपका कोई सवाल है, तो Apigee Edge की सहायता टीम से संपर्क करें.

Apigee Edge के सभी रिलीज़ नोट की सूची के लिए, Apigee के रिलीज़ नोट देखें.

नई सुविधाएं

SmartDocs की सामान्य उपलब्धता

SmartDocs, बीटा वर्शन से सामान्य उपलब्धता में आ रहा है. अपडेट और नई सुविधाओं में ये शामिल हैं:

  • Swagger 2.0 के लिए सहायता. इसमें फ़ाइल या यूआरएल से इंपोर्ट करने की सुविधा भी शामिल है. साथ ही, इसमें कस्टम नाम वाले सुरक्षा ऑब्जेक्ट के लिए सहायता भी शामिल है.
  • SmartDocs जनरेट करने वाले टेंप्लेट के विज़ुअल डिज़ाइन में सुधार किया गया है.
  • Drupal में Content > SmartDocs मेन्यू में जाकर, डेवलपर पोर्टल में इस्तेमाल करने और काम करने की क्षमता को बेहतर बनाया गया है.
  • पुष्टि करने के लिए इस्तेमाल किए जाने वाले "कस्टम टोकन" को अब "एपीआई पासकोड" कहा जाता है.
  • बदलाव के लेवल पर तय किए गए, पुष्टि करने से जुड़े "सुरक्षा" ऑब्जेक्ट.
  • टेम्प्लेट लेवल पर क्लाइंट की पुष्टि करने की सुविधा को कॉन्फ़िगर करना. नए वर्शन में, पहले से कॉन्फ़िगर किए गए SmartDocs के क्लाइंट क्रेडेंशियल अब रीसेट नहीं होते.

सुविधाओं के बारे में ज़्यादा जानकारी के लिए, यह ब्लॉग पोस्ट देखें.

SmartDocs के दस्तावेज़ के लिए, एपीआई के बारे में जानकारी देने के लिए SmartDocs का इस्तेमाल करना लेख पढ़ें.

SmartDocs को अपग्रेड करने की प्रोसेस

अगर आपने बीटा वर्शन के दौरान SmartDocs का इस्तेमाल किया है, तो सामान्य तौर पर उपलब्ध वर्शन में नई सुविधाओं और क्षमताओं का इस्तेमाल करने के लिए, आपको डेवलपर पोर्टल में SmartDocs को अपग्रेड करना होगा.

आपके डेवलपर पोर्टल में पहले से पब्लिश किए गए SmartDocs पेज काम करते रहेंगे. हालांकि, मौजूदा या नए पेजों में कोई भी बदलाव करने या उन्हें पब्लिश करने से पहले, आपको अपडेट करने की प्रोसेस पूरी करनी होगी.

ध्यान रखें कि डेवलपर पोर्टल में SmartDocs को रेंडर और पब्लिश किया जा सकता है. हालांकि, SmartDocs को Apigee के Edge API Management Services में मौजूद एपीआई मॉडल से जनरेट किया जाता है. Edge में एपीआई मॉडल में किए गए सभी बदलाव, आपके सभी Pantheon एनवायरमेंट में एक जैसे होंगे. यह ठीक उसी तरह काम करता है जैसे डेवलपर, Pantheon एनवायरमेंट में काम करते हैं.

SmartDocs के बीटा वर्शन से सामान्य उपलब्धता वाले वर्शन पर अपग्रेड करने के लिए

  1. Pantheon पर अपने dev या test एनवायरमेंट में, 15.05.27 रिलीज़ को अपडेट करें और उसकी जांच करें.
  2. जिस एपीआई मॉडल का इस्तेमाल किया जा रहा है उसे बदलने के लिए, एक नया मॉडल बनाएं.
    • अगर आपने Swagger या WADL दस्तावेज़ इंपोर्ट किए हैं, तो उन्हें नए वर्शन में फिर से इंपोर्ट करें.
    • अगर SmartDocs मॉड्यूल के ज़रिए एपीआई मॉडल को मैनेज किया जा रहा है, तो उसे SmartDocs JSON के तौर पर एक्सपोर्ट करें. इसके बाद, फ़ाइल अटैच करके उसे अपने नए मॉडल में इंपोर्ट करें.
  3. अपने मॉडल के वर्शन की सुरक्षा प्रॉपर्टी सेट करें. कॉन्टेंट > SmartDocs > मॉडल पेज पर, सुरक्षा सेटिंग चुनें.
  4. मॉडल सेटिंग पेज (कॉन्टेंट > SmartDocs) में जाकर, पहले से कॉन्फ़िगर किए गए किसी भी पुष्टि करने के तरीके की जांच करें. इसके लिए, Operations कॉलम में मौजूद सेटिंग पर क्लिक करें.
  5. सीएसएस और JS ऐसेट के v6 का इस्तेमाल करने के लिए, किसी भी कस्टम टेंप्लेट को अपडेट करें. साथ ही, authSchemes और apiSchema जैसे किसी भी नए ऑब्जेक्ट के नाम को दिखाने के लिए बदलाव करें. SmartDocs टेंप्लेट अपडेट करने के बारे में जानकारी पाने के लिए, एपीआई के बारे में जानकारी देने के लिए SmartDocs का इस्तेमाल करना लेख पढ़ें.
  6. अपने मॉडल के बदले गए वर्शन को फिर से रेंडर करें और पब्लिश करें.
  7. नए दस्तावेज़ की पुष्टि करने के बाद, अपने प्रोडक्शन पोर्टल को 15.05.27 रिलीज़ पर अपडेट करें.

अगर आप Edge Enterprise के ग्राहक हैं और आपको अपग्रेड करने की प्रोसेस के बारे में कोई सवाल पूछना है या कोई समस्या है, तो कृपया marsh@apigee.com और cnovak@apigee.com पर ईमेल भेजें. इसके अलावा, सबसे अच्छा जवाब पाने के लिए कृपया Apigee Community का इस्तेमाल करें.

गड़बड़ियां ठीक की गईं

इस रिलीज़ में इन बग को ठीक किया गया है.

समस्या आईडी ब्यौरा
DEVSOL-487 कमाई करने की सुविधा में, दिन का फ़ॉर्मैट एडमिन के हिसाब से कॉन्फ़िगर किया जाना चाहिए
अब कमाई करने की सुविधा में, तारीख के फ़ॉर्मैट को कॉन्फ़िगर किया जा सकता है. इसके लिए, कमाई करने की सेटिंग में जाकर, यूरोप और अमेरिका के तारीख के फ़ॉर्मैट चुनें.
DEVSOL-603 टकराव वाले प्लान का पेज सही फ़ॉर्मैट में नहीं है
जब कोई ऐसा प्लान खरीदा जाता है जो किसी मौजूदा प्लान से मेल खाता है, तो अब उपयोगकर्ता को दिखने वाला पेज सही फ़ॉर्मैट में होता है.
DEVSOL-642 क्लाइंट लेवल के कॉन्फ़िगरेशन को सुरक्षा सेटिंग से टेंप्लेट सेटिंग में ले जाना
DEVSOL-709 SmartDocs: खाली वैल्यू के साथ अनुरोध भेजने के बाद, यूआरएल टेंप्लेट पैरामीटर में बदलाव नहीं किया जा सकता
इस समस्या को ठीक किया गया है. इस समस्या में, तरीके के दस्तावेज़ में टेंप्लेट पैरामीटर मिटाने के बाद, SmartDocs से अनुरोध भेजने पर टेंप्लेट पैरामीटर में बदलाव नहीं किया जा सकता.
DEVSOL-1013 डेवलपर पोर्टल के उपयोगकर्ता के ईमेल पतों में बदलाव करने की सुविधा चालू करें
प्रोफ़ाइल में बदलाव करने वाले पेज पर, ईमेल पते का फ़ील्ड अब बंद नहीं किया जाएगा. साथ ही, डेवलपर अपने ईमेल पते बदल सकते हैं.
DEVSOL-1273 मॉड्यूल की सूची में"DevConnect Mint" दो बार दिखता है
मॉड्यूल में, "Dev Connect Mint" दो बार दिखाया गया था. अब यह समस्या ठीक कर दी गई है.
DEVSOL-1313 Swagger और WADL, दोनों के लिए JSON/YAML फ़ाइल या यूआरएल इंपोर्ट करने की सुविधा
अब WADL फ़ाइलों को यूआरएल के ज़रिए इंपोर्ट किया जा सकता है. साथ ही, Swagger फ़ाइलों को अपलोड किया जा सकता है.
DEVSOL-1339 SmartDocs के एडमिन मेन्यू की जगह बदल गई है
SmartDocs अब कॉन्टेंट मेन्यू में मौजूद है. साथ ही, SmartDocs की सेटिंग, एडमिन मेन्यू में मौजूद हैं.
DEVSOL-1340 GA पर जाते समय बीटा वर्शन हटाएं
SmartDocs अब कॉन्टेंट मेन्यू में मौजूद है. साथ ही, smartdocs की सेटिंग, एडमिन मेन्यू में मौजूद हैं.
DEVSOL-1390 PHP SDK Edge लाइब्रेरी को अपडेट कर दिया गया है, ताकि __toString() को कॉल करने की समस्या को ठीक किया जा सके
PHP SDK Edge लाइब्रेरी को अपडेट कर दिया गया है, ताकि DeveloperRatePlan ऑब्जेक्ट पर __toString() को कॉल करने की समस्या को ठीक किया जा सके. इससे यह गड़बड़ी होती है: {quote} Fatal error: Call to a member function format() on a non-object in /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php on line 221 {quote} यह एक बग है. यह सिर्फ़ उन Monetization ग्राहकों पर असर डालता है जो toString() तरीके को कॉल करने वाले कस्टम कोड का इस्तेमाल करते हैं.
DEVSOL-1398 SmartDocs Petstore Model को इंस्टॉल करने के दौरान, उपयोगकर्ता से पूछे बिना इंपोर्ट किया गया
SmartDocs अब साइट इंस्टॉल करने के दौरान, weather model के बजाय petstore swagger उदाहरण (http://petstore.swagger.io/v2/swagger.json) को इंपोर्ट करता है, ताकि SmartDocs का इस्तेमाल करने का ज़्यादा जानकारी वाला उदाहरण मिल सके.
DEVSOL-1407 कई डेवलपर होने पर क्रॉन फ़ेल हो जाता है
Drupal क्रॉन चलाते समय, कई डेवलपर की वजह से टाइमआउट की समस्या हुई. जब किसी संगठन में 200 से ज़्यादा उपयोगकर्ता होते हैं, तो अब बैच प्रोसेस का इस्तेमाल किया जाता है.
DEVSOL-1470 "एपीआई" मेन्यू लिंक और उससे जुड़ा व्यू बनाएं
Dev Portal SmartDocs अब डिफ़ॉल्ट रूप से, "एपीआई" नाम के मुख्य मेन्यू में SmartDocs रेंडर किए गए दस्तावेज़ के लिंक के साथ आता है. यह लिंक, पब्लिश किए गए तरीकों वाले किसी भी मॉडल से लिंक होता है.

आम तौर पर होने वाली समस्याएं

इस रिलीज़ में ये समस्याएं मौजूद हैं:

समस्या आईडी ब्यौरा
DEVSOL-1558
नए इंस्टॉलेशन पर, Petstore के उदाहरण वाले SmartDocs के तरीके के पेज सही तरीके से रेंडर नहीं होते
SmartDocs में Petstore के उदाहरण वाले तरीके के पेज, नए इंस्टॉलेशन पर ठीक से रेंडर नहीं होते. इस समस्या को ठीक करने के लिए:
  1. Drupal मेन्यू में जाकर, Content > SmartDocs को चुनें.
  2. "Petstore Example" मॉडल चुनें.
  3. अपडेट करने के विकल्प में जाकर, नोड रेंडर और पब्लिश करें को चुनें.
  4. सभी नोड चुनने के लिए, सभी चुनें / चुने हुए का निशान हटाएं चेकबॉक्स पर क्लिक करें.
  5. अपडेट करें पर क्लिक करें.

अब नोड ठीक से रेंडर होने चाहिए.