أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
في يوم الثلاثاء 2 حزيران (يونيو) 2015، أطلقنا إصدارًا جديدًا من "بوابة خدمات المطوّرين" من Apigee على السحابة الإلكترونية.
إذا كانت لديك أسئلة، يُرجى التواصل مع فريق دعم Apigee Edge.
للاطّلاع على قائمة بجميع ملاحظات إصدار Apigee Edge، يُرجى الرجوع إلى ملاحظات إصدار Apigee.
الميزات الجديدة
توفّر SmartDocs للجمهور العام
سيتم طرح SmartDocs للجمهور العام بعد أن كان في مرحلة الإصدار التجريبي. تشمل التحديثات والميزات الجديدة ما يلي:
- إتاحة Swagger 2.0، بما في ذلك الاستيراد حسب الملف أو عنوان URL، مع إتاحة كائنات الأمان المخصّصة الاسم.
- تحسينات على التصميم المرئي في القوالب التي تنشئ مستندات SmartDocs
- تحسينات على سهولة الاستخدام وسير العمل في "بوابة المطوّرين"، وهي متاحة من خلال قائمة "المحتوى" > SmartDocs في Drupal
- يُطلق الآن على المصادقة المعروفة باسم "الرمز المميّز المخصّص" اسم "مفتاح واجهة برمجة التطبيقات".
- عناصر "الأمان" الخاصة بالمصادقة المحدّدة على مستوى المراجعة
- إعداد مصادقة العميل على مستوى النموذج لم تعُد المراجعات الجديدة تعيد ضبط أي بيانات اعتماد مُسبقة الإعداد لعميل SmartDocs.
لمزيد من الأوصاف حول الميزات، يمكنك الاطّلاع على مشاركة المدونة هذه.
للاطّلاع على مستندات SmartDocs، يُرجى الانتقال إلى استخدام SmartDocs لإنشاء مستندات لواجهات برمجة التطبيقات.
عملية ترقية SmartDocs
إذا كنت تستخدم SmartDocs خلال الفترة التجريبية، تتطلّب الميزات والإمكانات الجديدة في الإصدار المتاح للجميع ترقية SmartDocs في بوابة المطوّرين.
ستستمر أي صفحات SmartDocs تم نشرها من قبل في بوابة المطوّرين في العمل، ولكن يجب اتّباع عملية التحديث قبل تعديل أو نشر أي تغييرات على الصفحات الحالية أو الجديدة.
يُرجى العِلم أنّه على الرغم من إمكانية عرض SmartDocs ونشرها داخل بوابة المطوّرين، يتم إنشاء SmartDocs من نموذج واجهة برمجة التطبيقات المتوفّر ضمن "خدمات إدارة واجهة برمجة التطبيقات" في Apigee Edge. ستكون أي تغييرات تجريها على نموذج واجهة برمجة التطبيقات في Edge هي نفسها في جميع بيئات Pantheon (على غرار طريقة توفّر المطوّرين في بيئات Pantheon).
للترقية من الإصدار التجريبي من SmartDocs إلى الإصدار المتوفر للجمهور العام
- عدِّل الإصدار 15.05.27 واختبِره في بيئات التطوير أو الاختبار على Pantheon.
- أنشئ نموذجًا جديدًا لاستبدال أي نموذج حالي لواجهة برمجة التطبيقات كنت تستخدمه.
- إذا كنت قد استوردت مستندات Swagger أو WADL، أعِد استيرادها إلى مراجعة جديدة.
- إذا كنت تحتفظ بنموذج واجهة برمجة التطبيقات من خلال وحدة SmartDocs، يمكنك تصديره بتنسيق SmartDocs JSON واستيراده إلى النموذج الجديد باستخدام مرفق الملف.
- اضبط خصائص الأمان الخاصة بمراجعة النموذج. في صفحة المحتوى >
SmartDocs > النموذج، اختَر إعدادات الأمان.
- تحقَّق من أي مصادقة تم إعدادها مسبقًا في صفحة إعدادات النموذج (المحتوى >
SmartDocs) من خلال النقر على الإعدادات في عمود "العمليات".
- عدِّل أي نماذج مخصّصة لاستخدام الإصدار 6 من مواد عرض CSS وJS، وأجرِ تغييرات لتعكس أي أسماء عناصر جديدة، مثل authSchemes وapiSchema. للحصول على معلومات حول تعديل نماذج SmartDocs، يُرجى الاطّلاع على استخدام SmartDocs لإنشاء مستندات لواجهات برمجة التطبيقات.
- إعادة عرض مراجعة النموذج ونشرها
- بعد التحقّق من صحة المستندات الجديدة، عدِّل بوابة الإنتاج إلى الإصدار 15.05.27.
إذا كنت من عملاء Edge Enterprise ولديك أسئلة أو مخاوف بشأن عملية الترقية، يُرجى إرسال رسالة إلكترونية إلى marsh@apigee.com وcnovak@apigee.com. بخلاف ذلك، يُرجى استخدام منتدى Apigee للحصول على أفضل ردّ.
إصلاح الأخطاء
تم إصلاح الأخطاء التالية في هذا الإصدار.
| معرّف المشكلة | الوصف |
|---|---|
| DEVSOL-487 | يجب أن يتمكّن المشرفون من ضبط تنسيق اليوم في قسم "تحقيق الربح" أصبح بإمكانك الآن ضبط تنسيق التاريخ في قسم "تحقيق الربح" ضمن إعدادات تحقيق الربح، وذلك لتنسيقات التاريخ الأوروبية والأمريكية. |
| DEVSOL-603 | تنسيق غير مناسب لصفحة "خطة التعارض" عند شراء خطة تتداخل مع خطة حالية، يتم الآن تنسيق الصفحة المعروضة بشكل مناسب للمستخدم. |
| DEVSOL-642 | نقل إعدادات مستوى العميل من إعدادات الأمان إلى إعدادات النموذج |
| DEVSOL-709 | SmartDocs: لا يمكن تعديل مَعلمة نموذج عنوان URL بعد إرسال طلب بقيمة فارغة يحلّ هذا الإصلاح المشكلة التي تجعل مَعلمات النموذج غير قابلة للتعديل بعد إرسال الطلب من SmartDocs بعد حذف مَعلمة النموذج في مستندات الطريقة. |
| DEVSOL-1013 | إتاحة تعديل عناوين البريد الإلكتروني لمستخدمي "بوابة المطوّرين" لن يتم إيقاف حقل عنوان البريد الإلكتروني في صفحة تعديل الملف الشخصي، وسيتمكّن المطوّرون من تغيير عناوين بريدهم الإلكتروني. |
| DEVSOL-1273 | يظهر "DevConnect Mint" مرتين في قائمة الوحدات ضمن "الوحدات"، ظهرت "DevConnect Mint" مرتين. نودّ إعلامك بأنّه تمّ الآن إصلاح هذه المشكلة. |
| DEVSOL-1313 | إتاحة استيراد ملفات JSON/YAML أو عناوين URL لكلّ من Swagger وWADL يمكن الآن استيراد ملفات WADL من خلال عنوان URL، كما يمكن تحميل ملفات Swagger. |
| DEVSOL-1339 | تغيير مواقع قائمة المشرف في SmartDocs أصبح SmartDocs الآن متاحًا ضمن قائمة المحتوى، وأصبحت إعدادات SmartDocs متاحة ضمن قائمة المشرف في الإعدادات. |
| DEVSOL-1340 | إزالة الإصدار التجريبي عند الانتقال إلى الإصدار العام أصبح تطبيق SmartDocs متاحًا الآن ضمن قائمة المحتوى، وتتوفر إعدادات SmartDocs ضمن قائمة إعدادات المشرف. |
| DEVSOL-1390 | تم تعديل مكتبة PHP SDK Edge لحلّ مشكلة استدعاء
__toString() تم تعديل مكتبة PHP SDK Edge لحلّ مشكلة استدعاء __toString() في عنصر DeveloperRatePlan الذي يؤدي إلى ظهور الخطأ التالي: {quote} 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 {quote} هذا خطأ يؤثر فقط في عملاء التسييل الذين يستخدمون رمزًا برمجيًا مخصّصًا يستدعي الدالة toString(). |
| DEVSOL-1398 | استيراد نموذج SmartDocs Petstore عند التثبيت بدون مطالبة المستخدم يستورد SmartDocs الآن مثال petstore swagger أثناء تثبيت الموقع الإلكتروني (http://petstore.swagger.io/v2/swagger.json) بدلاً من نموذج الطقس من أجل توفير مثال أكثر شمولاً على استخدام SmartDocs. |
| DEVSOL-1407 | تعذُّر تنفيذ Cron عند وجود عدد كبير من المطوّرين عند تنفيذ Drupal cron، تسبّب عدد كبير من المطوّرين في حدوث مشكلة متعلّقة بانتهاء المهلة. عندما تضم مؤسسة أكثر من 200 مستخدم، يتم الآن استخدام عملية مجمّعة. |
| DEVSOL-1470 | إنشاء رابط القائمة "واجهات برمجة التطبيقات" وطريقة العرض المقابلة يتضمّن Dev Portal SmartDocs الآن بشكل تلقائي رابطًا إلى مستندات SmartDocs المعروضة في القائمة الرئيسية باسم "واجهات برمجة التطبيقات"، ويربط هذا الرابط بأي نماذج تتضمّن طرقًا منشورة. |
المشاكل المعروفة
يتضمّن هذا الإصدار المشاكل المعروفة التالية:
| معرّف المشكلة | الوصف |
|---|---|
| DEVSOL-1558 |
لا يتم عرض صفحات طرق Petstore Example SmartDocs بشكل صحيح عند التثبيت الجديد
لا يتم عرض صفحات طرق Petstore النموذجية في SmartDocs بشكل صحيح عند التثبيت للمرة الأولى. لحلّ هذه المشكلة، يُرجى اتباع الخطوات التالية:
من المفترض أن يتم عرض العُقد بشكلٍ سليم الآن. |