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

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
info

في يوم الثلاثاء 8 أيلول (سبتمبر) 2015، أطلقنا إصدارًا ربع سنوي من "بوابة" Apigee Edge Developer Services لـ "السحابة الخاصة".

اسم المنتج السابق "Apigee Edge On-premises Developer Services Portal" أو "OPDK" هو الآن "Apigee Edge Developer Services Portal for Private Cloud".

إذا كانت لديك أسئلة، يُرجى التواصل مع فريق دعم Apigee Edge.

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

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

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

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

توفّر SmartDocs للجمهور العام

سيتم طرح SmartDocs للجمهور العام بعد أن كان في مرحلة الإصدار التجريبي. تشمل التحديثات والميزات الجديدة ما يلي:

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

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

للاطّلاع على مستندات SmartDocs، يُرجى الانتقال إلى استخدام SmartDocs لإنشاء مستندات لواجهات برمجة التطبيقات.

عملية ترقية SmartDocs

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

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

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

للترقية من الإصدار التجريبي من SmartDocs إلى الإصدار المتوفر للجمهور العام

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

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

إصلاح الأخطاء

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

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

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

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

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

DEVSOL-1398 استيراد نموذج SmartDocs Petstore عند التثبيت بدون مطالبة المستخدم
يستورد SmartDocs الآن مثال petstore swagger أثناء تثبيت الموقع الإلكتروني (http://petstore.swagger.io/v2/swagger.json) بدلاً من نموذج الطقس من أجل تقديم مثال أكثر شمولاً على استخدام SmartDocs.
DEVSOL-1407 تعذُّر تنفيذ Cron عند وجود عدد كبير من المطوّرين
عند تنفيذ 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 إنشاء رابط القائمة "واجهات برمجة التطبيقات" وطريقة العرض المقابلة
يتضمّن Dev Portal SmartDocs الآن بشكل تلقائي رابطًا إلى مستندات SmartDocs المعروضة في القائمة الرئيسية باسم "واجهات برمجة التطبيقات"، ويربط هذا الرابط بأي نماذج تتضمّن طرقًا منشورة.
DEVSOL-1486 يمكن أن تتم مصادقة طلبات SmartDocs باستخدام مفتاح محدّد مسبقًا
يتيح هذا الخيار إجراء المصادقة باستخدام مفاتيح واجهة برمجة التطبيقات التي يتم توفيرها مسبقًا وتلك التي يوفّرها المستخدم.
DEVSOL-1499 عدم تحليل رمز HTML في أوصاف مَعلمات SmartDocs
تم الآن تحليل رمز HTML في أوصاف مَعلمات SmartDocs.
DEVSOL-1507 لا يمكن إضافة مَعلمات متعدّدة إلى واجهة برمجة تطبيقات باستخدام "إضافة طريقة"
يمكنك الآن إضافة مَعلمات متعدّدة إلى واجهة برمجة تطبيقات SmartDocs عند تعديل الطريقة.
DEVSOL-1509 لا يظهر لك خيار تعديل الحقل "عينة" لواجهة برمجة تطبيقات SmartDocs
يمكنك الآن ضبط "نوع MIME الخاص بالنص" و"مستندات النص" و"عينة النص" عند تعديل صفحة SmartDocs.
DEVSOL-1534 عدم ملء حقل نوع المحتوى في ناتج SmartDocs
يتم الآن ملء حقل نوع المحتوى في صفحة طريقة SmartDocs.
DEVSOL-1554 مقارنة غير صالحة للتاريخ في قسم "تحقيق الربح"
في علامة التبويب "الخطة التي تم شراؤها" لبوابات المطوّرين التي تم تفعيل ميزة تحقيق الربح فيها، لم يظهر الزر "إلغاء" أبدًا لخطة لها تاريخ بدء مستقبلي.
DEVSOL-1556 يتم شحن إصدار قديم من وحدات Drupal
تم تحديث وحدة media_youtube ووحدة features إلى أحدث إصدار.
DEVSOL-1558 عدم عرض صفحات طرق SmartDocs لمثال PetStore
في عمليات التثبيت الجديدة، يتم الآن عرض طرق مثال SmartDocs PetStore بشكل صحيح.
DEVSOL-1562 إنشاء طريقة عرض لكل نموذج SmartDocs
عند إنشاء نموذج جديد، يتم إنشاء طريقة عرض جديدة تلقائيًا لهذا النموذج.
DEVSOL-1565 تعديل طريقة SmartDocs يؤدي إلى حدوث خطأ فادح
تم إصلاح المشكلة التي كانت تؤدي أحيانًا إلى حدوث خطأ عند تعديل طريقة SmartDocs.
DEVSOL-1567 عرض"إضافة نموذج" في قائمة المشرفين العلوية
تم إصلاح المشكلة التي تتسبّب في عرض عنصر القائمة "إضافة نموذج" في قائمة المشرفين العلوية.
DEVSOL-1576 تعرض صفحة "مستندات واجهة برمجة التطبيقات" اسم النموذج وليس الاسم المعروض
كانت صفحة "مستندات واجهة برمجة التطبيقات" التي تظهر عند النقر على "واجهات برمجة التطبيقات" في القائمة تعرض الاسم الداخلي للنموذج بدلاً من الاسم المعروض. إذا كنت بصدد التحديث إلى الإصدار الجديد وسبق لك تغيير طريقة العرض هذه، عليك الرجوع إلى طريقة العرض السابقة للاطّلاع على هذه التغييرات من خلال اتّباع الخطوات التالية: # سجِّل الدخول بصفتك مشرفًا # انتقِل إلى "البنية" (Structure) > "طرق العرض" (Views) # انقر على القائمة المنسدلة بجانب "تعديل" (Edit) في "نماذج SmartDocs" (SmartDocs Models) للاطّلاع على جميع العمليات. # If you see "revert", then you have overwritten the code w/your own change. انقر على "الرجوع" لإعادة العرض إلى الحالة التلقائية. يُرجى العِلم أنّ هذا الإجراء سيؤدي إلى إزالة أي تغييرات أجريتها على طريقة العرض هذه.
DEVSOL-1578 عرض كلّ من نموذجي "الطقس" و"متجر الحيوانات الأليفة" عند تثبيت المواقع الإلكترونية
يتم استيراد نموذجي SmartDocs "متجر الحيوانات الأليفة" و"الطقس" إلى المواقع الإلكترونية الجديدة.
DEVSOL-1584 تعذُّر شراء الخطط
تم إصلاح مشكلة عدم إرسال نموذج شراء خطط تحقيق الربح في الإصدار السحابي 15.05.27.00 و15.06.08.00 إذا كنت تستخدم تصميم Apigee المتجاوب أو تصميمًا فرعيًا من تصميم Apigee المتجاوب.
DEVSOL-1597 تعذُّر تغيير إعدادات مهلة المطوّر
تم إصلاح خطأ كان يتسبّب في عدم تطبيق إعدادات مهلة الاتصال في Edge بشكل صحيح.
DEVSOL-1620

ترقيات على وحدة "أنا" ومؤشر البيئة ووحدة الميزات
تحديث أمان مهم إلى حد ما لوحدة "أنا" وتحديثات على وحدة مؤشر البيئة ووحدة الميزات. مزيد من المعلومات:

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 Base إذا لم يتم تفعيل وحدة SmartDocs
لم يعُد المظهر الأساسي apigee_base يعتمد على تفعيل وحدة SmartDocs.
DEVSOL-1654

زيادة رقم إصدار admin_views لتضمين إصلاح أمني مهم
تم تعديل وحدات contrib التالية:

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