15.05.27 - ملاحظات إصدار Apigee Edge على السحابة الإلكترونية

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

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

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

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

الميزات والتحسينات الجديدة

في ما يلي الميزات والتحسينات الجديدة في هذا الإصدار.

مدى توفّر ميزة SmartDocs بشكل عام

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

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

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

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

الإصدار التجريبي من محرِّر واجهة برمجة التطبيقات الوكيل

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

سياسة OAuthV2 الجديدة

تتيح لك سياسة DeleteOAuthV2Info الجديدة حذف رموز التفويض ورموز الوصول. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة حذف معلومات OAuthV2.

الكيانات الجديدة في سياسة "وصول الكيان"

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

عرض شهادات طبقة المقابس الآمنة التي أوشكت صلاحيتها على الانتهاء

تشير صفحة "شهادات طبقة المقابس الآمنة" في واجهة مستخدم الإدارة (المشرف > شهادات طبقة المقابس الآمنة) إلى موعد انتهاء صلاحية شهادات طبقة المقابس الآمنة خلال 10 أو 15 أو 30 أو 90 يومًا، وذلك استنادًا إلى اختيارك في حقل القائمة المنسدلة لتاريخ انتهاء الصلاحية الجديد.

اسم تطبيق المطوّر المعروض في واجهة مستخدم الإدارة

تحتوي تطبيقات المطوّرين في Edge على اسم داخلي لا يتغيّر واسم معروض يمكنك تغييره. في صفحة "تطبيق المطوّر" ضمن واجهة مستخدِم الإدارة (نشر > تطبيقات المطوّرين > اسم التطبيق)، يتم عرض "الاسم" الداخلي للتطبيق مع "الاسم المعروض"، ما يسهّل التعرّف على التطبيقات بصريًا من خلال أسمائها الداخلية لتحديد المشاكل وحلّها وإدارة واجهات برمجة التطبيقات.

إزالة الإصدار الكلاسيكي من التقارير المخصّصة من واجهة مستخدِم الإدارة

لم يعُد الإصدار الكلاسيكي الاختياري من تقارير الإحصاءات المخصّصة متوفّرًا في واجهة مستخدِم إدارة الأداء.


عملية ترقية SmartDocs

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

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

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

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

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

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

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

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

معرّف المشكلة الوصف
TBD-72 مشكلة في سياسة تسجيل الرسائل
MGMT-2124 إعادة ضبط أذونات دور العميل عند حفظ الأذونات في واجهة المستخدِم
MGMT-2048 يمكن للمستخدم الذي لديه دور مخصّص يحدّ من أذونات النشر على بيئة واحدة النشر في بيئات أخرى
MGMT-2041 إزالة عنصر FaultRules من نموذج المرفق التلقائي
لم يعُد عنصر FaultRules، الذي لا يتم استخدامه في السياسات أو خطوات وكيل واجهة برمجة التطبيقات، تتم إضافته تلقائيًا عند إنشاء وكلاء واجهة برمجة التطبيقات أو إضافة سياسات.
MGMT-2034 تؤدي عملية جلب WSDL إلى حدوث خطأ: "خطأ في جلب WSDL: حدث خطأ في معالجة WSDL".
MGMT-1812 إضافة عملية التحقّق من TargetEndpoint أثناء الاستيراد
على غرار ProxyEndpoint، سيتم التحقّق من TargetEndpoint للتأكّد من استخدام المخطّط المناسب و التعابير المستخدَمة في الشروط أثناء استيراد الوكيل لواجهة برمجة التطبيقات.
MGMT-1345 يؤدي استيراد ملف WSDL الذي يتضمّن مساحات أسماء متعددة إلى حدوث خطأ في خطوة إنشاء SOAP
MGMT-800 يؤدي إنشاء مورد باسم "default" إلى تعطُّل واجهة المستخدم
MGMT-602 عرض تطوير الوكيل لواجهة برمجة التطبيقات: إضافة سياسة ذاكرة تخزين مؤقت للردّ عندما لا تحتوي نقطة النهاية على PreFlow/PostFlow يتسبب في حدوث خطأ
MGMT-460 تؤدي إعادة تسمية السياسة إلى حدوث أخطاء في الأداء، وظهور سياسة مكرّرة لا يمكن إزالتها
DEVRT-1565 فواصل زمنية مدتها 15 دقيقة لعمليات الشحن
AXAPP-1728 تجاهُل متغيّرات تحقيق الربح في الإحصاءات
AXAPP-1690 "خطأ في واجهة برمجة التطبيقات" في التقارير المخصّصة
AXAPP-1533 تُظهر "الخريطة الجغرافية في "إحصاءات Google" خطأ "طلب بيانات من واجهة برمجة التطبيقات غير صالح"
APIRT-52 التقارير المخصّصة: رمز حالة الردّ على طلب البيانات من العديد من واجهات برمجة التطبيقات غير صالح