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 जनरेट करने वाले टेंप्लेट के विज़ुअल डिज़ाइन में सुधार किया गया है.
  • Developer Portal में इस्तेमाल करने और वर्कफ़्लो को बेहतर बनाने से जुड़ी सुविधाएं. ये सुविधाएं, 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 कॉलम में मौजूद Settings पर क्लिक करें.
  5. सीएसएस और JS ऐसेट के v6 का इस्तेमाल करने के लिए, किसी भी कस्टम टेंप्लेट को अपडेट करें. साथ ही, authSchemes और apiSchema जैसे किसी भी नए ऑब्जेक्ट के नाम दिखाने के लिए बदलाव करें. SmartDocs टेंप्लेट अपडेट करने के बारे में जानकारी पाने के लिए, एपीआई के बारे में जानकारी देने के लिए SmartDocs का इस्तेमाल करना लेख पढ़ें.
  6. अपने मॉडल के बदले गए वर्शन को फिर से रेंडर करें और पब्लिश करें.
  7. नए दस्तावेज़ की पुष्टि करने के बाद, अपने प्रोडक्शन पोर्टल को 15.05.27 रिलीज़ पर अपडेट करें.

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

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

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

समस्या आईडी ब्यौरा
DEVSOL-487 कमाई करने की सुविधा में, तारीख के फ़ॉर्मैट को एडमिन कॉन्फ़िगर कर सकें
अब कमाई करने की सुविधा में, तारीख के फ़ॉर्मैट को कॉन्फ़िगर किया जा सकता है. इसके लिए, कमाई करने की सेटिंग में जाकर, यूरोप और अमेरिका के लिए तारीख के फ़ॉर्मैट चुनें.
DEVSOL-603 प्लान के टकराव वाले पेज का फ़ॉर्मैट सही नहीं है
किसी ऐसे प्लान को खरीदते समय जो मौजूदा प्लान से मेल खाता है, अब उपयोगकर्ता को दिखाया जाने वाला पेज बेहतर तरीके से फ़ॉर्मैट किया गया है.
DEVSOL-642 क्लाइंट लेवल के कॉन्फ़िगरेशन को सुरक्षा सेटिंग से टेंप्लेट सेटिंग में ले जाना
DEVSOL-709 SmartDocs: खाली वैल्यू के साथ अनुरोध भेजने के बाद, यूआरएल टेंप्लेट पैरामीटर में बदलाव नहीं किया जा सकता
इस समस्या को ठीक किया गया है. इस समस्या में, तरीके से जुड़े दस्तावेज़ में टेंप्लेट पैरामीटर मिटाने के बाद, SmartDocs से अनुरोध भेजने पर टेंप्लेट पैरामीटर में बदलाव नहीं किया जा सकता.
DEVSOL-1013 Dev Portal के उपयोगकर्ता के ईमेल पतों में बदलाव करने की सुविधा चालू करें
प्रोफ़ाइल में बदलाव करने वाले पेज पर, ईमेल पते का फ़ील्ड अब बंद नहीं होगा. साथ ही, डेवलपर अपने ईमेल पते बदल सकते हैं.
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 अब साइट इंस्टॉल करने के दौरान, मौसम के मॉडल के बजाय 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. अपडेट करें पर क्लिक करें.

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