15.05.27.00 - ملاحظات إصدار بوابة خدمات مطوّري برامج Apigee

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
المعلومات

أطلقنا يوم الثلاثاء 2 حزيران (يونيو) 2015 إصدارًا جديدًا على السحابة الإلكترونية من بوابة خدمات مطوّري Apigee.

إذا كان لديك أسئلة، يُرجى الانتقال إلى خدمة دعم عملاء Apigee.

للحصول على قائمة بجميع ملاحظات إصدار Apigee Edge، يُرجى الاطّلاع على ملاحظات إصدار Apigee.

الميزات الجديدة

مدى التوفّر للجمهور العام في Smart Docs

ستتم ترقية "مستندات Google الذكية" من الإصدار التجريبي إلى مدى التوفّر للجمهور العام. تشمل التحديثات والميزات الجديدة ما يلي:

  • دعم Swagger 2.0، بما في ذلك الاستيراد حسب الملف أو عنوان URL، بما في ذلك إتاحة كائنات الأمان ذات الأسماء المخصّصة.
  • تحسينات على التصميم المرئي في النماذج التي تنشئ "مستندات ذكية"
  • تحسينات على سهولة الاستخدام وسير العمل في "بوابة مطوّري البرامج"، المتاحة من خلال المحتوى > قائمة "المستندات الذكية" في Drupal.
  • ما يُعرف باسم مصادقة "الرمز المميز المخصص" يسمى الآن "مفتاح واجهة برمجة التطبيقات".
  • كائنات "الأمان" التي تم تحديدها على مستوى المراجعة.
  • ضبط مصادقة العميل على مستوى النموذج لم تعُد النُسخ الجديدة تُعيد ضبط أي بيانات اعتماد لبرنامج Smart Docs تم ضبطها مسبقًا.

للحصول على مزيد من أوصاف الميزات، يُرجى الاطّلاع على مشاركة المدونة هذه.

للاطّلاع على مستندات Smartالمستندات، يُرجى الاطّلاع على استخدام Smart Docs لتوثيق واجهات برمجة التطبيقات.

عملية ترقية "المستندات الذكية"

إذا كنت تستخدم "مستندات ذكية" خلال الفترة التجريبية، تتطلب الميزات والإمكانات الجديدة في الإصدار المتوفر للجمهور العام ترقية "المستندات الذكية" في بوابة مطوّري البرامج.

سيستمر عمل أي صفحات في "مستندات Google الذكية" تم نشرها من قبل في بوابة المطوّرين، ولكن عليك اتّباع عملية التحديث قبل تعديل أو نشر أي تغييرات على الصفحات الحالية أو الجديدة.

جدير بالذكر أنّه على الرغم من إمكانية عرض المستندات الذكية ونشرها داخل بوابة مطوّري البرامج، يتم إنشاء المستندات الذكية من نموذج واجهة برمجة التطبيقات المتوفّر في خدمات إدارة واجهة برمجة تطبيقات Edge من Apigee. وتكون أي تغييرات تجريها على نموذج واجهة برمجة التطبيقات في Edge هي نفسها في جميع بيئات Pantheon (كما هو الحال مع المطوّرين في بيئات Pantheon).

للترقية من الإصدار التجريبي من "مستندات ذكية" إلى مرحلة التوفّر للجمهور العام

  1. يمكنك تحديث الإصدار 15.05.27 واختباره في بيئات dev أو dev على Pantheon.
  2. يمكنك إنشاء نموذج جديد لاستبدال أي نموذج حالي من واجهات برمجة التطبيقات التي تستخدمها.
    • إذا كنت تستورد مستندات التباهي أو WADL، يمكنك استيرادها مرة أخرى إلى نسخة جديدة.
    • إذا كنت تستخدم نموذج واجهة برمجة التطبيقات من خلال وحدة Smart Docs، يمكنك تصديره بتنسيق SmartDocuments JSON واستيراده إلى نموذجك الجديد باستخدام مرفق الملف.
  3. عيِّن خصائص الأمان لمراجعة النموذج. في صفحة المحتوى > المستندات الذكية > النموذج، اختَر إعدادات الأمان.
  4. تحقق من أي مصادقة تم إعدادها مسبقًا في صفحة إعدادات النموذج (المحتوى > مستندات ذكية) بالنقر على الإعدادات في عمود "العمليات".
  5. عدِّل أي نماذج مخصّصة لاستخدام الإصدار 6 من مواد عرض CSS وJS، وأدخِل التغييرات اللازمة لتعكس أي أسماء عناصر جديدة، مثل authSchemes وapiSchema. وللحصول على معلومات عن تعديل نماذج "مستندات ذكية"، يُرجى الاطّلاع على استخدام تطبيق "مستندات ذكية" لتوثيق واجهات برمجة التطبيقات.
  6. إعادة عرض نسخة النموذج ونشرها.
  7. بعد التحقق من صحة المستندات الجديدة، عليك تعديل بوابة الإنتاج إلى الإصدار 15.05.27.

إذا كنت أحد عملاء Edge Enterprise ولديك أسئلة أو استفسارات بشأن عملية الترقية، يُرجى إرسال رسالة إلكترونية إلى marsh@apigee.com وcnovak@apigee.com. وبخلاف ذلك، يُرجى استخدام منتدى Apigee للحصول على أفضل رد.

الأخطاء التي تم إصلاحها

تم إصلاح الأخطاء التالية في هذا الإصدار.

معرّف المشكلة الوصف
DEVSOL-487 يجب أن يضبط المشرفون تنسيق اليوم في تحقيق الربح على المستخدمين
يمكن الآن ضبط تنسيق التاريخ في "تحقيق الربح" ضمن إعدادات تحقيق الربح لتنسيقات التواريخ الأوروبية والولايات المتحدة.
DEVSOL-603 تنسيق صفحة "الخطة المتنازع عليها" غير صحيح
عند شراء خطة تتداخل مع خطة حالية، يتم الآن تنسيق الصفحة المعروضة بشكل مناسب للمستخدم.
DEVSOL-642 نقل الإعدادات على مستوى العميل من إعدادات الأمان إلى إعدادات النماذج
DEVSOL-709 Smart Docs: معلَمة نموذج عنوان URL غير قابلة للتعديل بعد إرسال الطلب بقيمة فارغة
يتم حل المشكلة التي تؤدي إلى عرض معلَمات النموذج غير قابلة للتعديل بعد إرسال الطلب من Smart Docs بعد حذف مَعلمة النموذج في مستندات الطريقة.
DEVSOL-1013 إتاحة تعديل عناوين البريد الإلكتروني لمستخدم بوابة مطوّري البرامج
لن يتم إيقاف حقل عنوان البريد الإلكتروني في صفحة تعديل الملف الشخصي بعد الآن ويمكن للمطوّرين تغيير عناوين بريدهم الإلكتروني.
DEVSOL-1273 ظهرت عبارة "DevConnect Mint" مرتين في قائمة "الوحدات".
ضمن "الوحدات"، تم عرض Dev Connect Mint مرتين. نودّ إعلامك بأنّه تمّ الآن إصلاح هذه المشكلة.
DEVSOL-1313 إتاحة ملف JSON/YAML أو استيراد عنوان URL لكل من Swagger وWADL
يمكن الآن استيراد ملفات WADL من خلال عنوان URL، ويمكن تحميل ملفات Swagger.
DEVSOL-1339 تغيير مواقع قائمة مشرف Smartdocs
يمكنك الآن العثور على تطبيق Smartdocs ضمن قائمة المحتوى، ويمكن العثور على إعدادات هذه المستندات ضمن قائمة مدير الإعدادات.
DEVSOL-1340 إزالة الإصدار التجريبي عند الانتقال إلى "إحصاءات Google"
يمكن الآن الاطّلاع على Smartالمستندات ضمن قائمة المحتوى. ويمكن العثور على إعدادات Smartdocs ضمن قائمة مسؤول الإعدادات.
DEVSOL-1390 تم تحديث مكتبة PHP SDK Edge() لإصلاح مشكلة استدعاء __toString()
تم تحديث مكتبة PHP SDK Edge لإصلاح مشكلة استدعاء __toSDK Edge() على كائن __toString-SDK Edge() الذي ينشئ هذا الخطأ: {quoteAMPe}Fتم إنشاء فئة/ملف كائن/ملف رئيسي على تنسيق الخطأ التالي: {quoteAMPquote} الأمامية لـ _{quote>خط اتصال /% استدعاء:
DEVSOL-1398 تم استيراد نموذج متجر الويب للمتجر عند تثبيت التطبيق بدون طلب التثبيت
يستورد تطبيق Smart Docs الآن نموذج البحث عن التباهي في متجر petstore أثناء تثبيت الموقع الإلكتروني (http://petstore.swagger.io/v2/swagger.json) بدلاً من نموذج الطقس للحصول على مثال أكثر شمولاً لاستخدام المستندات الذكية.
DEVSOL-1407 تعذُّر Cron عند وجود العديد من المطوّرين
عند تشغيل Drupal cron، تسبّب عدد كبير من المطوّرين في مشكلة انتهاء المهلة. عندما يكون لدى مؤسسة أكثر من 200 مستخدم، يتم الآن استخدام عملية مجمَّعة.
DEVSOL-1470 إنشاء رابط قائمة "واجهات برمجة التطبيقات" والعرض المقابل له
يتوفّر الآن تلقائيًا تطبيق Smart Docs في بوابة مطوّري البرامج برابط يؤدي إلى المستندات Smartالمستندات المعروضة في القائمة الرئيسية التي تحمل اسم "واجهات برمجة التطبيقات" والتي ترتبط بأي نماذج ذات طرق منشورة.

المشاكل المعروفة

يحتوي هذا الإصدار على المشاكل المعروفة التالية:

معرّف المشكلة الوصف
DEVSOL-1558
أمثلة على صفحات طريقة Smart Docs بشكل صحيح عند إجراء عملية تثبيت جديدة
لا يتم عرض أمثلة صفحات طريقة Petstore في Smart Docs بشكلٍ صحيح عند إجراء عملية تثبيت جديدة. لحلّ هذه المشكلة، يُرجى اتباع الخطوات التالية:
  1. اختَر المحتوى > المستندات الذكية في قائمة Drupal.
  2. حدد النموذج "Petstore Example".
  3. اختَر عرض العُقد ونشرها ضمن خيارات التعديل.
  4. انقر على مربّع الاختيار اختيار / إلغاء اختيار الكل لاختيار جميع العُقد.
  5. انقر على تعديل.

من المفترض أن يتم عرض العُقد بشكلٍ صحيح الآن.