أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
في يوم الثلاثاء 2 حزيران (يونيو) 2015، أطلقنا إصدارًا جديدًا من خدمات Apigee Developer Portal على السحابة الإلكترونية.
إذا كانت لديك أسئلة، يُرجى الانتقال إلى دعم عملاء Apigee.
للحصول على قائمة بجميع ملاحظات إصدار Apigee Edge، يُرجى الاطّلاع على ملاحظات إصدار Apigee.
الميزات الجديدة
توفّر ميزة SmartDocs للجمهور العام
أصبح تطبيق SmartDocs متوفّرًا للجمهور العام بعد أن كان متاحًا في إصدار تجريبي. تشمل التحديثات والميزات الجديدة ما يلي:
- إتاحة استخدام Swagger 2.0، بما في ذلك الاستيراد من خلال ملف أو عنوان URL، بما في ذلك إتاحة استخدام عناصر الأمان ذات الأسماء المخصّصة
- تحسينات على التصميم المرئي في النماذج التي تُنشئ مستندات SmartDocs
- تحسينات على سهولة الاستخدام وعملية سير العمل في "بوابة المطوّرين"، وهي متاحة من خلال قائمة المحتوى > SmartDocs في Drupal
- يُطلق الآن على طريقة المصادقة المعروفة باسم "الرمز المميّز المخصّص" اسم "مفتاح واجهة برمجة التطبيقات".
- عناصر "الأمان" للمصادقة المحدّدة على مستوى المراجعة
- ضبط مصادقة العميل على مستوى النموذج لم تعُد النُسخ الجديدة تُعيد ضبط أي بيانات اعتماد مُعدّة مسبقًا لعميل SmartDocs.
لمزيد من أوصاف الميزات، يمكنك الاطّلاع على مشاركة المدونة هذه.
للاطّلاع على مستندات SmartDocs، يُرجى الاطّلاع على مقالة استخدام SmartDocs لتوثيق واجهات برمجة التطبيقات.
عملية ترقية SmartDocs
إذا كنت تستخدم SmartDocs خلال الفترة التجريبية، يجب ترقية SmartDocs في بوابة المطوّرين لبدء استخدام الميزات والإمكانات الجديدة في الإصدار المتاح للجميع.
سيستمر عمل أي صفحات SmartDocs سبق أن تم نشرها في بوابة المطوّرين، ولكن عليك اتّباع عملية التحديث قبل تعديل أو نشر أي تغييرات على الصفحات الحالية أو الجديدة.
تجدر الإشارة إلى أنّه على الرغم من أنّه يمكنك عرض مستندات SmartDocs ونشرها داخل بوابة المطوّرين، يتم إنشاء مستندات SmartDocs من نموذج واجهة برمجة التطبيقات الذي يتوفّر ضمن خدمات إدارة واجهة برمجة التطبيقات Edge API من Apigee. إنّ أي تغييرات تجريها على نموذج واجهة برمجة التطبيقات في Edge ستكون متطابقة في جميع بيئات Pantheon (على غرار طريقة ظهور المطوّرين في جميع بيئات Pantheon).
الترقية من الإصدار التجريبي من SmartDocs إلى الإصدار العلني
- عليك تحديث الإصدار 15.05.27 واختباره في بيئتَي dev أو test على Pantheon.
- أنشئ نموذجًا جديدًا ليحلّ محلّ أي نموذج واجهة برمجة تطبيقات حالي كنت تستخدمه.
- إذا كنت تستورد مستندات Swagger أو WADL، استورِدها مرة أخرى إلى مراجعة جديدة.
- إذا كنت تحافظ على نموذج واجهة برمجة التطبيقات من خلال وحدة SmartDocs، يمكنك التصدير بتنسيق SmartDocs JSON والاستيراد إلى النموذج الجديد باستخدام مرفق الملف.
- اضبط سمات الأمان لمراجعة النموذج. في صفحة المحتوى >
SmartDocs > النموذج، اختَر إعدادات الأمان.
- تحقَّق من أي مصادقة تم ضبطها مسبقًا في صفحة إعدادات النموذج (المحتوى >
SmartDocs) من خلال النقر على الإعدادات في عمود "العمليات".
- عدِّل أي نماذج مخصّصة لاستخدام الإصدار 6 من أصول CSS وJS، وأدخِل تغييرات لتعكس أي أسماء جديدة للكائنات، مثل authSchemes وapiSchema. للحصول على معلومات عن تعديل نماذج "مستندات ذكية"، يُرجى الاطّلاع على مقالة استخدام "مستندات ذكية" لتوثيق واجهات برمجة التطبيقات.
- أعِد عرض النسخة المعدَّلة من النموذج وانشرها.
- بعد التحقّق من صحة المستندات الجديدة، عدِّل البوابة في قناة الإصدار العلني لتصبح مثبّتةً على إصدار 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" مرتين في قائمة "الوحدات" ضمن "الوحدات"، تم عرض "Dev Connect Mint" مرتين. نودّ إعلامك بأنّه تمّ الآن إصلاح هذه المشكلة. |
| DEVSOL-1313 | إتاحة استيراد ملف JSON/YAML أو عنوان URL لكلٍّ من Swagger وWADL يمكن الآن استيراد ملفات WADL من خلال عنوان URL وتحميل ملفات Swagger. |
| DEVSOL-1339 | تغيير مواضع قائمة "مشرف SmartDocs" يمكن الآن العثور على SmartDocs ضمن قائمة المحتوى، وإعدادات SmartDocs ضمن قائمة "مشرف الإعدادات". |
| DEVSOL-1340 | إزالة الإصدار التجريبي عند الانتقال إلى "إحصاءات Google" يمكن العثور على ميزة SmartDocs الآن ضمن قائمة المحتوى، وإعدادات SmartDocs ضمن قائمة إعدادات المشرف. |
| DEVSOL-1390 | تم تعديل مكتبة PHP SDK Edge لحلّ مشكلة استدعاء (__toString()) تم تعديل مكتبة PHP SDK Edge لحلّ مشكلة استدعاء (__toString()) على DeveloperRatePlan الذي يتسبب في ظهور هذا الخطأ: {quote} خطأ فادح: تم استدعاء member function format() على عنصر غير object في /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php في السطر 221 {quote} هذا خطأ لا يؤثر إلا في عملاء "تحقيق الربح" الذين يستخدمون رمزًا مخصّصًا يستدعي أسلوب toString(). |
| DEVSOL-1398 | استيراد نموذج متجر الحيوانات الأليفة في SmartDocs أثناء التثبيت بدون طلب المستخدم تستورد أداة SmartDocs الآن مثال swagger لمتجر الحيوانات الأليفة أثناء تثبيت الموقع الإلكتروني (http://petstore.swagger.io/v2/swagger.json) بدلاً من نموذج الطقس للحصول على مثال أكثر شمولاً لاستخدام SmartDocs. |
| DEVSOL-1407 | تعذُّر تشغيل Cron عند توفُّر عدد كبير من المطوّرين عند تشغيل Cron في Drupal، تسبّب عدد كبير من المطوّرين في حدوث مشكلة في المهلة. عندما تضم المؤسسة أكثر من 200 مستخدم، يتم الآن استخدام عملية مجمّعة. |
| DEVSOL-1470 | إنشاء رابط قائمة "واجهات برمجة التطبيقات" والعرض المقابل تتضمّن بوابة المطوّرين SmartDocs الآن تلقائيًا رابطًا إلى مستندات SmartDocs المعروضة في القائمة الرئيسية التي تحمل اسم "واجهات برمجة التطبيقات"، والتي ترتبط بأي نماذج تحتوي على methods منشورة. |
المشاكل المعروفة
يتضمّن هذا الإصدار المشاكل المعروفة التالية:
| معرّف المشكلة | الوصف |
|---|---|
| DEVSOL-1558 |
لا يتم عرض صفحات طرق Petstore Example SmartDocs بشكل صحيح عند التثبيت الجديد
لا يتم عرض نموذج صفحات طرق Petstore في SmartDocs بشكل صحيح عند التثبيت الجديد
لحلّ هذه المشكلة، يُرجى اتباع الخطوات التالية:
من المفترض أن يتم عرض العقد بشكل صحيح الآن. |