16.08.17 - ملاحظات إصدار Apigee Edge for Public Cloud

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

في يوم الثلاثاء الموافق 30 أغسطس 2016، أطلقنا إصدارًا جديدًا من Apigee Edge للسحابة الإلكترونية العامة.

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

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

حمولات JSON في سياستَي Assign Message وRaise Fault

باستخدام هذا التحسين، لن تكون هناك حاجة إلى حلول بديلة لضمان تنسيق رسالة JSON بشكلٍ صحيح، و يمكن تحديد المتغيرات باستخدام أقواس معقوفة بدون إنشاء JSON غير صالح. على سبيل المثال، يُدرِج ما يلي قيمة message.content في رسالة JSON:

<Payload contentType="application/json">{"message" : "{message.content}"}</Payload>

إذا كنت قد استخدمت حلاً بديلاً، سيستمر الرمز البرمجي في العمل كما هو. يمكنك أيضًا استخدام variablePrefix وvariableSuffix بدلاً من الأقواس المعقوفة للإشارة إلى المتغيرات.

يُرجى الاطّلاع على العنصر <Set><Payload> في مستندات مرجع سياستَي Assign Message و Raise Fault policy. (APIRT-1160)

تحسينات على سياسة XML to JSON

تم تحسين سياسة XML to JSON من خلال الإمكانات التالية. يمكنك ضبط السياسة على ما يلي:

• التعامل مع بعض عناصر XML على أنّها صفائف أثناء التحويل، ما يضع القيم بين أقواس مربّعة "[ ]" في مستند JSON.
• إزالة مستويات من التسلسل الهرمي لمستند XML في مستند JSON النهائي.

لمزيد من المعلومات، يُرجى الاطّلاع على سياسة XML إلى JSON. (APIRT-1144)

أحرف بدل متعدّدة في مسارات موارد منتج واجهة برمجة التطبيقات

عند تحديد مسارات الموارد في منتج واجهة برمجة التطبيقات، يمكنك تضمين أحرف بدل في مواضع متعدّدة في مسار مورد. على سبيل المثال، يسمح المسار /team/*/invoices/** بطلبات واجهة برمجة التطبيقات التي تتضمّن أي قيمة واحدة بعد /team وأي مسارات موارد بعد invoices/. سيكون عنوان URI المسموح به في طلب بيانات من واجهة برمجة التطبيقات هو proxyBasePath/team/finance/invoices/company/a.

إذا توقّفت مسارات موارد منتج واجهة برمجة التطبيقات الحالية عن العمل على النحو المتوقّع بعد هذا الإصدار، اضبط السمة التالية في مؤسستك للرجوع إلى السلوك السابق: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

وظائف التشفير في JavaScript

تتوفّر مجموعة جديدة من وظائف JavaScript عالية الأداء crypto لإنشاء كائنات التجزئة التالية والحصول عليها وتعديلها: MD5 وSHA-1 وSHA256 وSHA512. يسمح لك كائن التشفير أيضًا بالحصول على التاريخ بتنسيقات مختلفة. لمزيد من المعلومات، يُرجى الاطّلاع على نموذج كائنات JavaScript. (APIRT-2886)

التحقّق من إصدار ملف JAR في Java Callout

عند تحميل مورد Java JAR إلى خادم وكيل لواجهة برمجة التطبيقات، يتم عرض رمز حالة HTTP ‏400 (بدلاً من 500) إذا كان إصدار مورد Java غير متوافق مع إصدار Java المتوافق مع Edge والمدرَج في البرامج والإصدارات المتوافقة. (MGMT-3420)

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

عندما تكون لديك ملفات موارد خادم وكيل لواجهة برمجة التطبيقات (مثل JavaScript أو Java JAR) مخزّنة على مستوى البيئة أو المؤسسة، لا يطلب منك إطار التحقّق من الصحة أيضًا تضمين هذه الموارد على مستوى خادم وكيل لواجهة برمجة التطبيقات في حزمة خادم وكيل لاستيرادها من أجل اجتياز عملية التحقّق من الصحة. يتم الآن التحقّق من صحة الموارد في وقت النشر، وليس في وقت الاستيراد. (MGMT-1430)

ضبط المهلة الزمنية لخوادم وكيل لواجهة برمجة التطبيقات الفردية

يمكنك ضبط خوادم وكيل لواجهة برمجة التطبيقات بحيث تنتهي مهلتها الزمنية بعد وقت محدّد (مع رمز حالة المهلة الزمنية للبوّابة 504 ). حالة الاستخدام الأساسية هي لعملاء السحابة الإلكترونية الخاصة الذين لديهم خوادم وكيل لواجهة برمجة التطبيقات تستغرق وقتًا أطول للتنفيذ. على سبيل المثال، لنفترض أنّك تحتاج إلى انتهاء المهلة الزمنية لخوادم وكيل معيّنة في غضون 3 دقائق. يمكنك استخدام سمة api.timeout جديدة في إعداد خادم وكيل لواجهة برمجة التطبيقات. إليك كيفية إجراء ذلك باستخدام مثال الدقائق الثلاث:

1. أولاً، احرص على ضبط موازنة التحميل والموجّه ومعالج الرسائل بحيث تنتهي مهلتها الزمنية بعد 3 دقائق.
2. بعد ذلك، اضبط خوادم الوكيل ذات الصلة بحيث تنتهي مهلتها الزمنية في غضون 3 دقائق. حدِّد القيمة بالملّي ثانية. على سبيل المثال:

   <ProxyEndpoint name="default">
     <HTTPProxyConnection>
       <BasePath>/v1/weather</BasePath>
       <Properties>
         <!-- api.timeout is in milliseconeds -->
         <Property name="api.timeout">180000</Property>
       </Properties>
       ...

3. يُرجى العِلم أنّ زيادة المهلات الزمنية للنظام قد تؤدي إلى حدوث مشاكل في الأداء، لأنّ جميع خوادم الوكيل التي ليس لديها إعداد api.timeout تستخدم المهلات الزمنية الجديدة الأعلى لموازنة التحميل والموجّه و معالج الرسائل. لذا، اضبط خوادم وكيل لواجهة برمجة التطبيقات الأخرى التي لا تتطلّب مهلات زمنية أطول لاستخدام مهلات زمنية أقل. على سبيل المثال، يضبط ما يلي خادم وكيل لواجهة برمجة التطبيقات بحيث تنتهي مهلته الزمنية بعد دقيقة واحدة:
   <Property name="api.timeout">60000</Property>

يمكن لعملاء السحابة الإلكترونية، الذين لا يمكنهم تعديل المهلات الزمنية في Edge، ضبط مهلة زمنية لخادم وكيل لواجهة برمجة التطبيقات أيضًا، طالما أنّ المهلة الزمنية أقصر من المهلة الزمنية العادية لمعالج الرسائل في Edge والتي تبلغ 57 ثانية.

لا يمكنك ملء القيمة بمتغيّر. تمت تغطية هذه السمة في الـ مرجع خصائص نقطة النهاية. (APIRT-1778)

بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) في سياسة Message logging

<KeyStore> و<TrustStore> يمكن ضبطهما في إعداد SSLInfo في سياسة Message Logging، ما يسمح ببروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) أحادي الاتجاه وثنائي الاتجاه مع خدمة تسجيل. يمكنك ضبط SSLInfo في سياسة Message Logging بالطريقة نفسها التي تضبط بها TargetEndpoint لخادم وكيل. ومع ذلك، لا يتيح بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) في Message Logging سوى بروتوكول TCP. (APIRT-1858)

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

تم إصلاح الأخطاء التالية في هذا الإصدار. هذه القائمة مخصّصة في المقام الأول للمستخدمين الذين يتحقّقون مما إذا تم إصلاح تذاكر الدعم الخاصة بهم. وليس الغرض منها تقديم معلومات مفصّلة لـ جميع المستخدمين.