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

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

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

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

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

नई सुविधाएं

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

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

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

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

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

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

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

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

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

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

  1. Pantheon पर, अपने dev या test environments में 15.05.27 रिलीज़ को अपडेट करें और उसकी जांच करें.
  2. इस्तेमाल किए जा रहे किसी भी मौजूदा एपीआई मॉडल को बदलने के लिए, नया मॉडल बनाएं.
    • अगर Swagger या WADL दस्तावेज़ इंपोर्ट किए जा रहे हैं, तो उन्हें फिर से नए रिविज़न में इंपोर्ट करें.
    • अगर आपने SmartDocs मॉड्यूल की मदद से अपना एपीआई मॉडल मैनेज किया है, तो उसे SmartDocs JSON के तौर पर एक्सपोर्ट करें. इसके बाद, फ़ाइल अटैचमेंट का इस्तेमाल करके, उसे अपने नए मॉडल में इंपोर्ट करें.
  3. अपने मॉडल के रिविज़न की सुरक्षा प्रॉपर्टी सेट करें. कॉन्टेंट > SmartDocs > मॉडल पेज पर, सुरक्षा सेटिंग चुनें.
  4. मॉडल की सेटिंग वाले पेज (कॉन्टेंट > SmartDocs) में, पहले से कॉन्फ़िगर की गई पुष्टि की सुविधा देखें. इसके लिए, ऑपरेशंस कॉलम में सेटिंग पर क्लिक करें.
  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 __toString() को कॉल करने से जुड़ी समस्या को ठीक करने के लिए, PHP SDK Edge लाइब्रेरी को अपडेट किया गया है
DeveloperRatePlan ऑब्जेक्ट पर __toString() को कॉल करने से जुड़ी समस्या को ठीक करने के लिए, PHP SDK Edge लाइब्रेरी को अपडेट किया गया है. इससे यह गड़बड़ी होती है: {quote} गड़बड़ी: /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php के लाइन 221 में, किसी गैर-ऑब्जेक्ट पर सदस्य फ़ंक्शन format() को कॉल किया गया {quote} यह एक गड़बड़ी है, जिसका असर सिर्फ़ उन कमाई करने वाले ग्राहकों पर पड़ता है जिनके कस्टम कोड में toString() मेथड को कॉल किया जाता है.
DEVSOL-1398 SmartDocs Petstore मॉडल, इंस्टॉल करने के दौरान उपयोगकर्ता से पूछे बिना इंपोर्ट किया गया
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 मेन्यू में, कॉन्टेंट > SmartDocs को चुनें.
  2. "Petstore का उदाहरण" मॉडल चुनें.
  3. अपडेट करने के विकल्प में जाकर, नोड रेंडर और पब्लिश करें को चुनें.
  4. सभी नोड चुनने के लिए, सभी चुनें / चुने हुए का निशान हटाएं चेकबॉक्स पर क्लिक करें.
  5. अपडेट करें पर क्लिक करें.

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