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

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

أصدرنا يوم الثلاثاء الموافق 8 أيلول (سبتمبر) 2015 نسخة ربع سنوية من بوابة خدمات مطوّري البرامج في Apigee Edge الخاصة بـ Private Cloud.

اسم المنتج السابق "Apigee Edge On- مخصَّصs Developer Services المدخل" أو "OPDK" أصبح الآن "بوابة خدمات مطوِّري Apigee Edge الخاصة بالسحابة الإلكترونية الخاصة".

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

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

متطلبات Apigee Edge للبوابة

إذا كنت تربط هذا الإصدار من البوابة بتثبيت برنامج Edge for Private Cloud، يجب ربطه بالإصدار 4.15.07.00 أو إصدار أحدث لضمان توفُّر جميع ميزات Smart Docs. لمزيد من المعلومات، يمكنك الاطّلاع على 4.15.07.00 - Apigee Edge للحصول على ملاحظات إصدار Private Cloud.

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

مدى التوفّر للجمهور العام في 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-584 عدم تذكُّر مَعلمة المسار عند الاستخدام الأوّل
لا يتم دائمًا تذكّر مَعلمة المسار عند إجراء الاستدعاءات.
DEVSOL-603 تنسيق صفحة "الخطة المتنازع عليها" غير صحيح
عند شراء خطة تتداخل مع خطة حالية، يتم الآن تنسيق الصفحة المعروضة بشكل مناسب للمستخدم.
DEVSOL-709 Smart Docs: معلَمة نموذج عنوان URL غير قابلة للتعديل بعد إرسال الطلب بقيمة فارغة
يتم حل المشكلة التي تؤدي إلى عرض معلَمات النموذج غير قابلة للتعديل بعد إرسال الطلب من Smart Docs بعد حذف مَعلمة النموذج في مستندات الطريقة.
DEVSOL-723 عرض رسائل سهلة الاستخدام عند تعذُّر استيراد "مستندات Google الذكية"
DEVSOL-1013 إتاحة تعديل عناوين البريد الإلكتروني لمستخدم بوابة مطوّري البرامج
لن يتم إيقاف حقل عنوان البريد الإلكتروني في صفحة تعديل الملف الشخصي بعد الآن ويمكن للمطوّرين تغيير عناوين بريدهم الإلكتروني.
DEVSOL-1244 عدم تفعيل وحدة مؤشر البيئة لإصدارات OPDK
DEVSOL-1273 ظهرت عبارة "DevConnect Mint" مرتين في قائمة "الوحدات".
ضمن "الوحدات"، تم عرض Dev Connect Mint مرتين. نودّ إعلامك بأنّه تمّ الآن إصلاح هذه المشكلة.
DEVSOL-1313 إتاحة ملف JSON/YAML أو استيراد عنوان URL لكل من Swagger وWADL
يمكن الآن استيراد ملفات WADL من خلال عنوان URL، ويمكن تحميل ملفات Swagger.
DEVSOL-1339 تغيير مواقع قائمة مشرف Smartdocs
يمكنك الآن العثور على تطبيق Smartdocs ضمن قائمة المحتوى، ويمكن العثور على إعدادات هذه المستندات ضمن قائمة مدير الإعدادات.
DEVSOL-1340 إزالة الإصدار التجريبي عند الانتقال إلى "إحصاءات Google"
DEVSOL-1390

تم تحديث مكتبة PHP SDK Edge لإصلاح مشكلة استدعاء __toString()
تم تحديث مكتبة PHP SDK Edge لإصلاح مشكلة استدعاء __toString() على العنصر DeveloperRatePlan الذي أدّى إلى ظهور هذا الخطأ:

خطأ فادح: استدعاء دالة التنسيق (format()) في عنصر غير كائن في /Applications/MAMP/htdocs/ordnance/docroot/preferences/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php في السطر 221

هذا خطأ لا يؤثّر إلا في عملاء تحقيق الربح المادي من خلال استخدام رمز مخصّص يستدعي طريقة toString().

DEVSOL-1398 تم استيراد نموذج متجر الويب لمستندات Google عند تثبيت التطبيق بدون طلب التثبيت
يستورد تطبيق Smart Docs الآن المثال الذي يوفّره متجر petstore أثناء تثبيت الموقع الإلكتروني (http://petstore.swagger.io/v2/swagger.json) بدلاً من نموذج الطقس للحصول على مثال أكثر شمولية حول استخدام مستندات ذكية.
DEVSOL-1407 خطأ كرون عند وجود العديد من المطوّرين
عند تشغيل Drupal cron، قد يتسبب عدد كبير من المطوّرين في مشكلة انتهاء المهلة. عندما تضم مؤسسة ما أكثر من 200 مستخدم، يتم الآن استخدام عملية مجمَّعة.
DEVSOL-1410 أخطاء الاتصال غير واضحة عند تثبيت بوابة مطوّري البرامج
تمت إضافة رسائل أفضل عن الأخطاء إلى أداة التثبيت عندما لا يعمل اتصال إدارة Edge لتقليل مشاكل تحديد المشاكل وحلّها.
DEVSOL-1422 إزالة نموذج إعداد SMTP من ملف Apigee الشخصي
لم تعُد عملية التثبيت تطلب منك تحديد ما إذا كنت تريد إعداد SMTP، بل يمكنك إجراء ذلك بعد اكتمال التثبيت باتّباع ممارسة Drupal العادية التي تنص على تفعيل وحدة SMTP وإعدادها بشكل صحيح.
DEVSOL-1427

إضافة عناصر إلى وحدة تطبيقات مطوّري البرامج في Devconnect للسماح بتغيير البيانات الإحصائية
توفّر وحدة devconnect_developer_apps الآن ثلاثة عناصر جديدة هي:

# hook_devconnect_developer_apps_analytics_chart_data_alter()

# hook_devconnect_developer_app_analytics_datapoints_params_alter()

# hook_devconnect_developer_app_analytics_datapoints_alter()

تسمح هذه الوحدات للوحدات المخصّصة بتغيير الرسم البياني لإحصاءات تطبيقات المطوّرين.

DEVSOL-1464 خطأ فادح عند حفظ إعدادات المصادقة لنموذج
عندما يتم حذف نظام أمان، يظهر الآن مربّع اختيار لتحديد ما إذا كان يجب أيضًا حذف نظام مصادقة النموذج المرتبط.
DEVSOL-1470 إنشاء رابط قائمة "واجهات برمجة التطبيقات" والعرض المقابل له
يتوفّر الآن تلقائيًا تطبيق Smart Docs في بوابة مطوّري البرامج برابط يؤدي إلى المستندات Smartالمستندات المعروضة في القائمة الرئيسية التي تحمل اسم "واجهات برمجة التطبيقات" والتي ترتبط بأي نماذج ذات طرق منشورة.
DEVSOL-1486 يمكن إجراء المصادقة على طلبات "مستندات Google" الذكية باستخدام مفتاح محدَّد مسبقًا
يتم تفعيل المصادقة باستخدام مفاتيح واجهة برمجة التطبيقات التي تم توفيرها مسبقًا والتي يوفّرها المستخدم.
DEVSOL-1499 لم يتم تحليل رمز HTML في أوصاف مَعلمات Smart Docs
يتم الآن تحليل رمز HTML في أوصاف مَعلمات Smart Docs.
DEVSOL-1507 تعذُّر إضافة معلَمات متعددة إلى واجهة برمجة تطبيقات باستخدام "طريقة الإضافة"
يمكنك الآن إضافة معلَمات متعددة إلى واجهة برمجة تطبيقات Smart Docs عند تعديل الطريقة.
DEVSOL-1509 لا تظهر طريقة لتعديل الحقل "عيّنة" لواجهة برمجة تطبيقات Smart Docs
يمكنك الآن ضبط "نوع MIME للنص الأساسي" و"مستندات النص الأساسي" و"نموذج النص الأساسي" عند تعديل إحدى صفحات المستندات الذكية.
DEVSOL-1534 لا تتم تعبئة نوع المحتوى في مخرجات Smartالمستندات
تتم الآن تعبئة نوع المحتوى في صفحة طريقة Smart Docs.
DEVSOL-1554 مقارنة التاريخ غير صالحة في ميزة "تحقيق الربح"
في علامة تبويب "الخطة التي تم شراؤها" في بوابات المطوّرين التي تم تفعيل ميزة تحقيق الربح فيها، لم يظهر أبدًا زر "إلغاء" لخطة لها تاريخ بدء مستقبلي.
DEVSOL-1556 يتم شحن الإصدار القديم من وحدات Drupal
تم تحديث وحدة Media_youtube والميزات إلى أحدث إصدار.
DEVSOL-1558 مثال على الصفحات التي لا يتم عرضها ضمن طريقة Smart Docs في متجر PetStore
عند إجراء عمليات تثبيت جديدة، يتم الآن عرض مثال طرق Smart Docs PetStore بشكل صحيح.
DEVSOL-1562 إنشاء ملف شخصي لكل نموذج في "مستندات ذكية"
عند إنشاء نموذج جديد، يتم إنشاء طريقة عرض جديدة لذلك النموذج تلقائيًا.
DEVSOL-1565 عملية تعديل طريقة "مستندات ذكية" تؤدي إلى حدوث خطأ فادح
تم إصلاح مشكلة تؤدي أحيانًا إلى ظهور خطأ أثناء تعديل طريقة "مستندات ذكية".
DEVSOL-1567 يتم عرض"إضافة نموذج" في قائمة المشرف العلوي
تم إصلاح المشكلة المتمثلة في عرض عنصر في القائمة "إضافة نموذج" في قائمة المشرف العليا.
DEVSOL-1576 تعرض طريقة عرض مستندات واجهة برمجة التطبيقات اسم النموذج، وليس الاسم المعروض
كانت صفحة مستندات واجهة برمجة التطبيقات التي تظهر عند النقر على "واجهات برمجة التطبيقات" في القائمة تعرض الاسم الداخلي للنموذج بدلاً من الاسم المعروض. إذا كنت تقوم بالتحديث إلى الإصدار وغيّرت طريقة العرض هذه، فسيتعيّن عليك إرجاع طريقة العرض لرؤية هذه التغييرات باتباع الخطوات التالية: # تسجيل الدخول كمشرف # الانتقال إلى البنية > طرق العرض # انقر على القائمة المنسدلة بجوار "تعديل" في "نماذج المستندات الذكية" للاطلاع على جميع العمليات. # إذا رأيت كلمة "تراجع"، يعني ذلك أنّك قد استبدلت الرمز بالتغيير الذي أجريته. انقر على "رجوع" لإعادة العرض إلى الحالة التلقائية. تجدر الإشارة إلى أنّ هذا الإجراء سيؤدي إلى إزالة أي تغييرات أجريتها على هذا الملف الشخصي.
DEVSOL-1578 عرض نموذجَي Weather وpetstore على عمليات التثبيت على الموقع الإلكتروني
يتم استيراد كل من نموذجَي Petstore وWeather Smart Docs إلى المواقع الإلكترونية الجديدة.
DEVSOL-1584 تعذُّر شراء الخطط
تم إصلاح مشكلة عدم إرسال نموذج شراء خطط تحقيق الربح للإصدار على السحابة الإلكترونية 15.05.27.00 و15.06.08.00 إذا كنت تستخدم مظهر Apigee السريع الاستجابة أو الموضوع الفرعي للمظهر السريع الاستجابة Apigee.
DEVSOL-1597 تعذّر تغيير إعدادات مهلة مطوّر البرامج
تم إصلاح خطأ لم يتم فيه تطبيق إعدادات مهلة اتصال Edge بشكل صحيح.
DEVSOL-1620

عمليات ترقية Me، ومؤشرات البيئة، وترقيات وحدات الميزات
تحديث أمان مهم نوعًا ما بالنسبة إلى وحدة Me (Me) وتعديلات الوحدة الخاصة بمؤشرات البيئة وميزاتها. مزيد من المعلومات:

https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator

https://www.drupal.org/project/features

DEVSOL-1648 تأكّد من أنّ قيمة arg_separator.output الإلكترونية هي "&" لمنع تعطُّل reCAPTCHA
تم إصلاح مشكلة متعلّقة بالنظام الأساسي تم فيها إصلاح مشكلة استخدام Google reCAPTCHA.
DEVSOL-1651 تعذُّر المظهر الأساسي لواجهة برمجة التطبيقات Apigee في حال عدم تفعيل وحدة Smartdocs
لم يعُد مظهر apigee_base يعتمد على وحدة Smart Docs التي يتم تفعيلها.
DEVSOL-1654

إصدار مجمَّعة من admin_views لتلقّي إصلاح الأمان المُهم
تم تحديث وحدات المساهمات التالية:

  • طرق العرض الإدارية
  • نقل
  • إعادة التوجيه
  • Redis
  • العمليات المجمّعة للمشاهدات