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