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

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

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

تم تغيير اسم المنتج السابق "بوابة خدمات المطوّرين على الموقع الإلكتروني لـ Apigee Edge" أو "OPDK" إلى "بوابة خدمات المطوّرين في Apigee Edge للسحابة الإلكترونية الخاصة".

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

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

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

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

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

توفّر ميزة 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 إلى الإصدار العلني

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 للحصول على أفضل ردّ.

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

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

معرّف المشكلة	الوصف
DEVSOL-487	يجب أن يتمكّن المشرفون من ضبط تنسيق اليوم في "تحقيق الربح" يمكن الآن ضبط تنسيق التاريخ في "تحقيق الربح" ضمن إعدادات تحقيق الربح لأجل تنسيقات التاريخ في أوروبا والولايات المتحدة.
DEVSOL-584	عدم تذكُّر مَعلمة المسار عند الاستخدام الأول لم تكن مَعلمة المسار تُتذكَّر دائمًا عند إجراء المكالمات.
DEVSOL-603	تنسيق صفحة "الخطة المتضاربة" سيئ عند شراء خطة تتداخل مع خطة حالية، يتم الآن تنسيق الصفحة المعروضة بشكل جيد للمستخدم.
DEVSOL-709	SmartDocs: لا يمكن تعديل مَعلمة نموذج عنوان URL بعد إرسال طلب يحتوي على قيمة خالية تم إصلاح المشكلة التي تجعل مَعلمات النماذج غير قابلة للتعديل بعد إرسال الطلب من SmartDocs بعد حذف مَعلمة النموذج في مستندات الطريقة.
DEVSOL-723	عرض رسائل سهلة الاستخدام في حال تعذُّر استيراد SmartDocs
DEVSOL-1013	إتاحة تعديل عناوين البريد الإلكتروني لمستخدمي "بوابة المطوّرين" لن يتم إيقاف حقل عنوان البريد الإلكتروني في صفحة تعديل الملف الشخصي بعد الآن، ويمكن للمطوّرين تغيير عناوين بريدهم الإلكتروني.
DEVSOL-1244	عدم تفعيل وحدة "مؤشر البيئة" لإصدارات OPDK
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"
DEVSOL-1390	تم تعديل مكتبة PHP SDK Edge لحلّ مشكلة استدعاء ‎(__toString())‎ تم تعديل مكتبة PHP SDK Edge لحلّ مشكلة استدعاء ‎(__toString())‎ على ‎ DeveloperRatePlan الذي يتسبب في ظهور هذا الخطأ: خطأ فادح: تمّت الدعوة إلى الدالة format() على عنصر غير مثيل في ‎/Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php في السطر 221 هذا خطأ لا يؤثر إلا في عملاء ميزة "تحقيق الربح" الذين يستخدمون رمزًا مخصّصًا يستدعي الأسلوب toString()‎.
DEVSOL-1398	استيراد نموذج متجر الحيوانات الأليفة في SmartDocs أثناء التثبيت بدون طلب المستخدم تستورد SmartDocs الآن مثال swagger لمتجر الحيوانات الأليفة أثناء تثبيت الموقع الإلكتروني (http://petstore.swagger.io/v2/swagger.json) بدلاً من نموذج الطقس للحصول على مثال أكثر شمولاً لاستخدام SmartDocs.
DEVSOL-1407	تعذُّر تشغيل Cron عند توفُّر عدد كبير من المطوّرين عند تشغيل Cron في Drupal، سيؤدي عدد كبير من المطوّرين إلى حدوث مشكلة في المهلة. عندما تضم المؤسسة أكثر من 200 مستخدم، يتم الآن استخدام عملية مجمّعة.
DEVSOL-1410	عدم ظهور أخطاء الاتصال عند تثبيت Dev Portal تمت إضافة رسائل خطأ أفضل إلى أداة التثبيت عندما لا يعمل اتصال إدارة Edge بهدف تقليل مشاكل تحديد المشاكل وحلّها.
DEVSOL-1422	إزالة نموذج إعداد SMTP من ملف تعريف Apigee لم تعُد عملية التثبيت تسألك عما إذا كنت تريد ضبط SMTP، وبدلاً من ذلك، يمكن انجامه بعد اكتمال التثبيت باتّباع الممارسة العادية في Drupal لتفعيل وحدة SMTP وضبطها بشكل صحيح.
DEVSOL-1427	إضافة علامات إلى وحدة Devconnect Developer Apps للسماح بتغيير بيانات الإحصاءات توفّر وحدة 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	إنشاء رابط قائمة "واجهات برمجة التطبيقات" والعرض المقابل تتضمّن بوابة المطوّرين SmartDocs الآن تلقائيًا رابطًا إلى مستندات SmartDocs المعروضة في القائمة الرئيسية التي تحمل اسم "واجهات برمجة التطبيقات"، والتي ترتبط بأي نماذج تحتوي على methods منشورة.
DEVSOL-1486	يمكن أن تتم مصادقة طلبات SmartDocs باستخدام مفتاح محدّد مسبقًا يتيح هذا الخيار المصادقة باستخدام كلٍ من مفاتيح واجهة برمجة التطبيقات المقدَّمة مسبقًا والمقدَّمة من المستخدم.
DEVSOL-1499	عدم تحليل رمز HTML في أوصاف مَعلمات SmartDocs يتم الآن تحليل رمز HTML في أوصاف مَعلمات SmartDocs.
DEVSOL-1507	لا يمكن إضافة مَعلمات متعدّدة إلى واجهة برمجة تطبيقات باستخدام Add Method يمكنك الآن إضافة مَعلمات متعدّدة إلى واجهة برمجة تطبيقات SmartDocs عند تعديل الطريقة.
DEVSOL-1509	عدم العثور على طريقة لتعديل الحقل "عيّنة" لواجهة برمجة التطبيقات SmartDocs API يمكنك الآن ضبط "نوع 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	عرض مستندات واجهة برمجة التطبيقات يعرِض اسم النموذج وليس الاسم المعروض كانت صفحة مستندات واجهة برمجة التطبيقات التي تظهر عند النقر على "واجهات برمجة التطبيقات" في القائمة تعرِض الاسم الداخلي للنموذج بدلاً من الاسم المعروض. إذا كنت بصدد التحديث إلى الإصدار و قد غيّرت هذا العرض، عليك الرجوع إلى العرض للاطّلاع على هذه التغييرات من خلال اتّباع الخطوات التالية: # تسجيل الدخول بصفتك مشرفًا # الانتقال إلى "البنية" > "المشاهد" # النقر على القائمة المنسدلة بجانب "تعديل" في "نماذج SmartDocs" للاطّلاع على جميع العمليات. # إذا ظهر لك الخيار "التراجع"، يعني ذلك أنّه تم استبدال الرمز البرمجي بتغييرك. انقر على "الرجوع" لإعادة العرض إلى حالته التلقائية. يُرجى العِلم أنّ هذا الإجراء سيؤدي إلى إزالة أي تغييرات أجريتها على طريقة العرض هذه.
DEVSOL-1578	عرض طُرز Weather وPetstore عند تثبيت المواقع الإلكترونية يتم استيراد طُرز Petstore وWeather SmartDocs على المواقع الإلكترونية الجديدة.
DEVSOL-1584	تعذُّر شراء الخطط تم حلّ المشكلة التي كانت تمنع إرسال نموذج شراء خطط تحقيق الربح في الإصدار 15.05.27.00 و15.06.08.00 من الإصدار المخصّص للسحابة الإلكترونية إذا كنت تستخدم تصميم Apigee Responsive أو تصميمًا فرعيًا من تصميم Apigee Responsive.
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 للحصول على إصلاح أمان مهم تم تعديل الوحدات التالية التي ساهم فيها مطوّرون خارجيون: عدد مرات اطّلاع المشرف على المحتوى نقل إعادة توجيه Redis العمليات المجمّعة للمشاهدات