4.15.07.00 - ملاحظات الإصدار من Apigee Edge for Private Cloud

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

في يوم الثلاثاء الموافق 8 سبتمبر 2015، طرحنا إصدارًا رئيسيًا من ميزات Apigee Edge Private Cloud.

منذ الإصدار الفصلي السابق من Edge for Private Cloud (الإصدار 4.15.04.00)، تم طرح الإصدارات التالية وهي مضمّنة في هذا الإصدار الفصلي:

• السحابة الإلكترونية: 15.04.15 و15.04.29 و15.05.27 و15.06.10 و15.06.24
• السحابة الإلكترونية الخاصة: 4.15.04.01

إصدارات Edge التي يمكن الترقية إليها 4.15.07.00

استنادًا إلى إصدار Edge الحالي، يمكنك إجراء أحد الإجراءَين التاليَين:

• الترقية مباشرةً إلى الإصدار 4.15.07.00
• يجب إجراء الترقية بشكل تدريجي، أي عليك الترقية من الإصدار الحالي إلى إصدار آخر من Edge، ثم الترقية إلى الإصدار 4.15.07.00.

لمزيد من المعلومات، يُرجى الاطّلاع على إصدارات Edge for Private Cloud التي يمكنك الترقية إليها 4.15.07.00.

قبل الترقية من الإصدار 4.15.01.x أو من إصدار سابق

1. تحقَّق من إصدار Cassandra SSTable:
   1. غيِّر الدليل إلى /<install-root>/apigee4/data/cassandra/data.
   2. نفِّذ أمر بحث،
      > find . -name *-ic-*
      يجب أن تعرض النتائج مجموعة من ملفات ‎ .db إذا كنت تستخدم Cassandra 1.2 SSTable.
   3. نفِّذ أمر البحث التالي:
      > find . -name *-hf-*
      يجب أن تكون النتائج فارغة، ما يعني عدم توفّر أي ملفات ‎ .db بتنسيق hf. إذا لم تظهر لك أي ملفات بتنسيق hf، تكون قد انتهيت ويمكنك الترقية إلى الإصدار 4.15.07.00.
      
      تنسيق hf مخصّص لجداول SSTable في Cassandra 1.0. إذا كان لديك أي ملفات ‎ *.db بتنسيق hf، عليك ترقية SSTable كما هو موضّح في بقية هذا الإجراء.
2. إذا عثرت على أي ملفات ‎ *.db بتنسيق hf، عليك ترقية SSTable من خلال تنفيذ الأمر التالي على كل عقدة Cassandra إلى أن تتم ترقية جميع عقد Cassandra:
   > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradesstables -a
3. كرِّر الخطوة 1 للتأكّد من أنّ جميع ملفات ‎ *.db بتنسيق ic لإصدار Cassandra 1.2.
4. كرِّر الخطوات من 1 إلى 3 على كل عقدة Cassandra في عملية تثبيت Edge.
5. رقِّ إلى الإصدار 4.15.07.00 من Edge.
6. بعد الترقية إلى الإصدار 4.15.07.00، تحقَّق من ملفات ‎ *.db للتأكّد من ترقيتها بالكامل إلى sstable بنمط C* 2.0:
   > cd /<install-root>/apigee4/data/cassandra/data
   > find . -name *-jb-*
   من المفترض أن يعرض هذا الأمر مجموعة من ملفات ‎ .db إذا كنت تستخدم Cassandra 2.0.

الميزات والتحسينات الجديدة

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

التثبيت والترقية

ترقية المكوّنات وإزالتها بشكل انتقائي

تتيح لك الآن النصوص البرمجية apigee-upgrade.sh وapigee-uninstall.sh اختيار مكوّنات Edge التي تريد ترقيتها أو إلغاء تثبيتها. في السابق، كان يتم ترقية جميع المكوّنات على العُقدة أو إلغاء تثبيتها. (OPDK-1377, OPDK-1175)

العودة إلى الإصدار السابق من الترقية

إذا تعذّر تنفيذ apigee-upgrade.sh أثناء عملية الترقية، يمكنك الآن استخدام النص البرمجي apigee-rollback.sh للتراجع عن الترقية. بعد حلّ أي مشاكل في الترقية، يمكنك إعادة محاولة الترقية. (OPDK-1275)

خيارات نص برنامج التثبيت المختصر

لم تعُد نصوص التثبيت البرمجية تقبل الشكل الطويل للخيارات، مثل --help. أصبحت تقبل الآن خيارات تتألف من حرف واحد فقط، مثل -h. (OPDK-1356)

تثبيت SmartDocs

عند تثبيت SmartDocs باستخدام النص البرمجي setup-smartdocs.sh، سيُطلب منك إدخال المؤسسة والبيئة والمضيف الافتراضي، ما يضمن تثبيت SmartDocs في الموقع الجغرافي المتوقّع. في السابق، كانت هذه القيم مبرمَجة بشكل ثابت في النص البرمجي. (OPDK-1310)

تشغيل update-cass-pwd-in-config.sh بدون طلبات

يمكن تشغيل النص البرمجي update-cass-pwd-in-config.sh بدون طلبات إذا ضبطت متغيرات البيئة ENABLE_CASS_AUTH وCASS_USERNAME وCASS_PASSWORD. (OPDK-1309)

Edge Platform

في ما يلي ميزات منصة Edge الجديدة المضمّنة في هذا الإصدار.

إصدار OpenJDK 1.7 المتوافق مع Edge Private Cloud

يتوافق هذا الإصدار من Edge مع Oracle JDK 1.7 وOpenJDK 7، وتمت إزالة التوافق مع JDK 1.6. (OPDK-1187)

أنظمة التشغيل المتوافقة

تم توسيع نطاق أنظمة التشغيل المتوافقة مع Apigee Edge for Private Cloud ليشمل Red Hat Enterprise Linux 6.6 و7.0 (64 بت) وCentOS 6.5 و6.6 و7.0 (64 بت) وOracle Linux 6.5.

تم تضمين الإصدار 2.0.15 من Cassandra في الإصدار 15.07 من OPDK

يُثبِّت هذا الإصدار Cassandra 2.0.15. إذا كنت بصدد الترقية من إصدار سابق، سيتم تعديل إصدار Cassandra. (OPDK-1197)

إتاحة SHA2 لتجزئة رموز OAuth المميزة

لتوفير حماية أفضل لرموز OAuth المميزة في حال حدوث خرق أمني لقاعدة البيانات، يتيح Edge استخدام خوارزميات SHA2 لتجزئة رموز OAuth المميزة (بالإضافة إلى SHA1). باستخدام السمات الجديدة على مستوى المؤسسة، يمكنك تفعيل التجزئة وإعدادها للرموز المميزة الجديدة، بالإضافة إلى الاحتفاظ بالتجزئة القديمة على أي رموز مميزة كانت متوفّرة قبل إطلاق هذه الميزة الجديدة. في الإصدارات السابقة من Edge for Private Cloud، كان هناك خيار باسم hash.oauth.tokens.enabled في ملف keymanagement.properties (على خادم الإدارة ومعالجات الرسائل) يتيح التجزئة التلقائية لرموز OAuth المميزة باستخدام خوارزمية SHA1. تم إيقاف هذه السمة نهائيًا.

إذا كنت قد استخدمت سابقًا السمة hash.oauth.tokens.enabled لتفعيل التجزئة باستخدام SHA1، سيُنشئ برنامج الترقية الخاص بهذا الإصدار تلقائيًا السمات الجديدة على مستوى المؤسسة. لإثبات الملكية بعد الترقية، أرسِل طلب GET بصفتك مشرف نظام باستخدام واجهة برمجة التطبيقات هذه: https://{host}:{port}/v1/o/{your_org}.

• للحصول على معلومات حول تفعيل تجزئة الرموز المميزة في مؤسستك باستخدام الخصائص الجديدة، راجِع قسم "تجزئة الرموز المميزة في قاعدة البيانات" ضمن موضوع طلب رموز الدخول.
• للحصول على معلومات حول التجزئة المجمّعة للرموز المميزة الحالية، راجِع دليل العمليات في Edge for Private Cloud. (APIRT-1389)

بنية دليل مسطّحة لملفات السجلّات

يمكنك ضبط Edge لتخزين ملفات السجلّ في بنية دليل مسطّحة من خلال ضبط السمة الجديدة enable.flat.directory.structure على القيمة true في ملف message-logging.properties. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة تسجيل الرسائل. (APIRT-1394)

أداء ذاكرة التخزين المؤقت للبيئة

لتحسين إدارة واستخدام ذاكرة التخزين المؤقت داخل الذاكرة، تم إيقاف إعدادات "الحد الأقصى للعناصر في الذاكرة" في موارد ذاكرة التخزين المؤقت للبيئة. يعتمد إجمالي عدد العناصر المتوفّرة في جميع موارد ذاكرة التخزين المؤقت (بما في ذلك ذاكرة التخزين المؤقت التلقائية) على إجمالي الذاكرة المخصّصة لذاكرة التخزين المؤقت. بشكلٍ تلقائي، تبلغ نسبة إجمالي الذاكرة المخصّصة للتخزين المؤقت داخل الذاكرة على معالج رسائل معيّن 40% من إجمالي الذاكرة المتاحة، ويتم تحديدها من خلال إعدادات سمة ذاكرة التخزين المؤقت في ملف cache.properties الخاص بذاكرة التخزين المؤقت لمعالج الرسائل. لن تتم إزالة العناصر من ذاكرة التخزين المؤقت إلا عندما تكون ذاكرة التخزين المؤقت غير كافية أو عندما تنتهي صلاحية العناصر.

للرجوع إلى السلوك القديم المتمثل في استخدام السمة "الحد الأقصى للعناصر في الذاكرة" لإدارة ذاكرة التخزين المؤقت، اضبط السمة overrideMaxElementsInCacheResource=false في ملف cache.properties. (APIRT-1140)

خدمات واجهات برمجة التطبيقات

في ما يلي ميزات "خدمات واجهة برمجة التطبيقات" الجديدة المضمّنة في هذا الإصدار.

استخدام "محرّر الخادم الوكيل" الجديد كإعداد تلقائي

يتم تفعيل محرّر خادم وكيل واجهة برمجة التطبيقات الجديد تلقائيًا في واجهة مستخدم الإدارة. يتضمّن المحرّر الجديد العديد من التحسينات على قابلية الاستخدام، بما في ذلك طرق عرض أكثر شمولاً للتدفّقات الشرطية ونقاط النهاية في صفحة &quot;نظرة عامة&quot;، وكل الإعدادات في صفحة &quot;تطوير&quot;، وإضافة أكثر سهولة للتدفّقات الشرطية ونقاط النهاية والسياسات، وطرق عرض XML أكثر اكتمالاً بدلاً من المقتطفات الصغيرة، والبحث الذي يتتبّع أسماء الملفات والنصوص، وغير ذلك. (MGMT-2279)

سياسة "حذف معلومات OAuth الإصدار 2.0" الجديدة

تتيح لك سياسة "حذف معلومات OAuth v2.0" حذف رموز الدخول ورموز التفويض الخاصة ببروتوكول OAuth v2. تحلّ السياسة محلّ الوظائف التي كانت توفّرها واجهة برمجة التطبيقات الإدارية سابقًا. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة حذف معلومات OAuthV2. (MGMT-2257)

سياسة "حذف معلومات OAuth الإصدار 1.0" الجديدة

تتيح لك سياسة "حذف معلومات OAuth الإصدار 1.0" الجديدة حذف رموز طلب OAuth الإصدار 1.0 ورموز الدخول ورموز التحقّق. تحلّ هذه السياسة محل الوظائف التي كانت توفّرها واجهة برمجة التطبيقات الإدارية سابقًا. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة حذف معلومات OAuth الإصدار 1. (APIRT-1351)

سياسة "التحكّم في الوصول"

تم تحسين سياسة &quot;التحكّم في الوصول&quot; للسماح بتقييم أكثر دقة لعناوين IP في القوائم المسموح بها والقوائم المحظورة عندما تكون عناوين IP مضمّنة في عنوان HTTP X-FORWARDED-FOR.

عند تفعيل ميزة فحص عناوين IP المتعددة في العنوان (يُرجى التواصل مع فريق الدعم لإعداد feature.enableMultipleXForwardCheckForACL)، يتيح لك عنصر <ValidateBasedOn> جديد في السياسة إجراء عملية الفحص استنادًا إلى عنوان IP الأول أو الأخير أو جميع عناوين IP في العنوان. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة التحكّم في الوصول.

كيانات جديدة في سياسة Access Entity

توفّر سياسة "كيان الوصول" إمكانية الوصول إلى الكيانات الجديدة التالية: consumerkey-scopes وauthorizationcode وrequesttoken وverifier. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة "كيان الوصول".

سياسة "أداة جمع الإحصاءات": التحويل التلقائي لاسم الإحصاءات إلى أحرف صغيرة

عند إنشاء مجموعة إحصاءات مخصّصة في أداة تعديل خادم وكيل لواجهة برمجة التطبيقات (صفحة "تطوير" > "الأدوات" > "مجموعة إحصاءات مخصّصة")، يجب أن يكون اسم متغيّر أداة جمع البيانات (الإحصاءات) بالأحرف الصغيرة. في حال إدخال الاسم بأحرف كبيرة، تحوّل الأداة اسم الإحصاء تلقائيًا إلى أحرف صغيرة في سياسة &quot;أداة جمع الإحصاءات&quot;. (MGMT-740)

إزالة أداة Classic Trace في محرّر خادم وكيل واجهة برمجة التطبيقات

انتقل أحدث إصدار من وظيفة &quot;التتبُّع&quot; في محرّر خادم وكيل واجهة برمجة التطبيقات من الإصدار التجريبي إلى الإصدار المتوفّر للجميع. لم يعُد بإمكانك الوصول إلى "التتبُّع الكلاسيكي" باستخدام الرابط "الوصول إلى الإصدار الكلاسيكي من التتبُّع".

الوصول إلى "منتدى Apigee" من قائمة "المساعدة" في واجهة مستخدم الإدارة

يمكنك الوصول إلى "منتدى Apigee" من قائمة "المساعدة" في واجهة مستخدم الإدارة.

رسائل الخطأ في واجهة مستخدم الإدارة

في ما يلي تحسينات على رسائل الخطأ في واجهة مستخدم الإدارة:

• واجهة مستخدم الإدارة المستخدَمة لتجميع جميع رسائل الخطأ وعرضها على واجهة المستخدم لجلسة تسجيل الدخول بأكملها ما لم يتم إغلاقها. من خلال هذا التحديث، يتم محو رسائل الخطأ تلقائيًا عند الانتقال من الصفحة التي ظهرت فيها. (MGMT-2254)
• لم تعُد واجهة مستخدم الإدارة تخفي رسائل الخطأ المكرّرة. (MGMT-2242)

تحسينات على أداء واجهة المستخدم والأخطاء

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

روابط تشعّبية للأدوار في صفحة "مستخدمو المؤسسة" ضمن واجهة مستخدم الإدارة

في صفحة "مستخدمو المؤسسة" ضمن واجهة مستخدم الإدارة (المدير &gt; مستخدمو المؤسسة)، أصبحت أسماء الأدوار مرتبطة الآن بتشعبات، ما يتيح لك الانتقال بسرعة إلى صفحات الأدوار. (MGMT-1055)

متغيّرات استهداف جديدة في مسار الرسائل

توفّر المتغيرات الجديدة في مسارات الرسائل معلومات أكثر اكتمالاً عن عناوين URL لنقاط النهاية المستهدَفة والخوادم المستهدَفة:

• يحلّ TargetEndpoint: request.url محلّ target.basepath.with.query.
• ‫TargetServer: يتم استبدال targetserver.name بـ loadbalancing.targetserver. بالإضافة إلى ذلك، لا تتم تعبئة target.basepath إلا عند استخدام العنصر <Path> في العنصر <LoadBalancer> HTTPTargetConnection الخاص بـ TargetEndpoint.

التوافق مع إشارة اسم الخادم (SNI)

يتيح Edge استخدام "الإشارة إلى اسم الخادم" في اتجاه الجنوب (من معالج الرسائل إلى نقاط النهاية المستهدَفة). إذا كنت تريد استخدام SNI، يُرجى التواصل مع فريق دعم Apigee Edge.

يجب توفّر Java 1.7.

باستخدام SNI، وهو امتداد لبروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL)، يمكن عرض عدة أهداف HTTPS من عنوان IP ومنفذ واحد بدون الحاجة إلى أن تستخدم جميع هذه الأهداف الشهادة نفسها.

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

يستخرج Edge تلقائيًا اسم المضيف من عنوان URL للطلب ويضيفه إلى طلب تأكيد اتصال طبقة المقابس الآمنة (SSL). على سبيل المثال، إذا كان المضيف المستهدف هو https://example.com/request/path، ستضيف Edge الإضافة server_name كما هو موضّح أدناه:

لمزيد من المعلومات حول SNI، يُرجى الاطّلاع على http://en.wikipedia.org/wiki/Server_Name_Indication.

"خوارزمية التوقيع" في تفاصيل شهادات SSL

تمت إضافة حقل جديد باسم "خوارزمية التوقيع" إلى تفاصيل شهادة SSL، ويمكن الاطّلاع عليه في واجهة المستخدم الخاصة بالإدارة (المشرف > شهادات SSL) وواجهة برمجة التطبيقات الخاصة بالإدارة (الحصول على تفاصيل الشهادة من ملف تخزين المفاتيح أو ملف تخزين الشهادات الموثوقة). يعرض الحقل إما "sha1WithRSAEncryption" أو "sha256WithRSAEncryption"، وذلك حسب نوع خوارزمية التجزئة المستخدَمة لإنشاء الشهادة.

عرض شهادات طبقة المقابس الآمنة التي اقتربت صلاحيتها من الانتهاء

تشير صفحة "شهادات SSL" في واجهة مستخدم الإدارة (المشرف > شهادات SSL) إلى تاريخ انتهاء صلاحية شهادات SSL خلال 10 أو 15 أو 30 أو 90 يومًا، وذلك استنادًا إلى اختيارك في حقل القائمة المنسدلة الجديد الخاص بتاريخ انتهاء الصلاحية.

إعدادات خطأ الحماية من التهديدات

تلقائيًا، يعرض Edge رمز حالة HTTP 500 Internal Server Error والخطأ ExecutionFailed إذا لم تتمكّن الرسالة من تجاوز سياسة الحماية من التهديدات بتنسيق JSON أو XML. يمكنك تغيير سلوك الخطأ هذا باستخدام موقع جديد على مستوى المؤسسة. عند ضبط السمة org على القيمة features.isPolicyHttpStatusEnabled، يحدث السلوك التالي:

• الطلب: عند إرفاق سياسة حماية من التهديدات بأي مسار طلب، تعرض الرسائل غير الصالحة رمز الحالة 400، بالإضافة إلى رسالة خطأ خاصة بالسياسة.
• الاستجابة: عند إرفاق سياسة حماية من التهديدات بأي مسار استجابة، ستستمر الرسائل غير الصالحة في عرض رمز الحالة 500، وسيتم عرض إحدى رسائل الخطأ الخاصة بالسياسة (بدلاً من ExecutionFailed فقط).

على عملاء Cloud التواصل مع فريق دعم Apigee Edge لضبط سمة المؤسسة. ستتوفّر هذه الميزة لعملاء Edge Private Cloud في الإصدار الفصلي التالي من Private Cloud.

مخططات محدَّثة لنقاط النهاية والوكلاء والعناصر الأخرى

تم تعديل المخططات المرجعية للكيانات غير التابعة للسياسة، مثل TargetEndpoint وProxyEndpoint وAPIProxy وغيرها الكثير. يُرجى الاطّلاع على https://github.com/apigee/api-platform-samples/tree/master/schemas. (APIRT-1249)

خدمات المطوّرين

في ما يلي الميزات الجديدة في "خدمات المطوّرين" التي يتضمّنها هذا الإصدار.

توفّر SmartDocs للجمهور العام

سيتم طرح SmartDocs للجمهور العام بعد أن كان في مرحلة الإصدار التجريبي. تشمل التحديثات والميزات الجديدة ما يلي:

• إتاحة Swagger 2.0، بما في ذلك الاستيراد حسب الملف أو عنوان URL، مع إتاحة كائنات الأمان المخصّصة الاسم.
• تحسينات على التصميم المرئي في القوالب التي تنشئ مستندات SmartDocs
• تحسينات على سهولة الاستخدام وسير العمل في &quot;بوابة المطوّرين&quot;، وهي متاحة من خلال قائمة &quot;المحتوى&quot; &gt; SmartDocs في Drupal
• يُطلق الآن على المصادقة المعروفة باسم "الرمز المميّز المخصّص" اسم "مفتاح واجهة برمجة التطبيقات".
• عناصر "الأمان" الخاصة بالمصادقة المحدّدة على مستوى المراجعة
• إعداد مصادقة العميل على مستوى النموذج لم تعُد المراجعات الجديدة تعيد ضبط أي بيانات اعتماد مُسبقة الإعداد لعميل SmartDocs.

لمزيد من الأوصاف حول الميزات، يمكنك الاطّلاع على مشاركة المدونة هذه.

للاطّلاع على مستندات SmartDocs، يُرجى الانتقال إلى استخدام SmartDocs لإنشاء مستندات لواجهات برمجة التطبيقات.

اسم تطبيق المطوّر المعروض في واجهة مستخدم الإدارة

تحتوي تطبيقات المطوّرين في Edge على اسم داخلي لا يتغيّر واسم معروض يمكنك تغييره. في صفحة "تطبيق المطوّر" ضمن واجهة مستخدم الإدارة (Publish > Developer Apps > اسم التطبيق)، يتم عرض "الاسم" الداخلي للتطبيق مع "الاسم المعروض"، ما يسهّل تحديد التطبيقات بصريًا من خلال أسمائها الداخلية لأغراض تحديد المشاكل وإدارة واجهة برمجة التطبيقات.

خدمات الإحصاءات

في ما يلي ميزات "خدمات الإحصاءات" الجديدة المضمّنة في هذا الإصدار.

الحدّ الأقصى لمدة الاحتفاظ بالبيانات

عند إنشاء تقارير إحصائية باستخدام واجهة مستخدم الإدارة أو واجهة برمجة التطبيقات، لا يمكن الوصول تلقائيًا إلى البيانات الأقدم من ستة أشهر من التاريخ الحالي. إذا أردت الوصول إلى بيانات أقدم من ستة أشهر، يُرجى التواصل مع فريق دعم Apigee Edge.

إزالة الإصدار الكلاسيكي من التقارير المخصّصة من واجهة مستخدم الإدارة

لم يعُد الإصدار الكلاسيكي الاختياري من تقارير الإحصاءات المخصّصة متاحًا في واجهة إدارة المستخدم.

أداء أداة "تفاعل المطوّرين" المصغّرة

تم تحسين أداة &quot;المسار الإحالي الناجح&quot; في لوحة بيانات الإحصاءات الرئيسية (قسم &quot;تفاعل المطوّرين&quot;) لتحسين الأداء.

تحقيق الربح

في ما يلي ميزات تحقيق الربح الجديدة المضمّنة في هذا الإصدار.

الإشعارات عبر البريد الإلكتروني بشأن خطط الأسعار

يتيح لك نوع جديد من إشعارات البريد الإلكتروني بشأن خطط الأسعار إرسال إشعارات إلى المطوّرين عندما يبلغون حدًا معيّنًا من المعاملات أو الدولارات في خطط الأسعار المجمّعة أو المستندة إلى عدد مرات الاستخدام التي اشتروها. لمعرفة التفاصيل، يُرجى الاطّلاع على إعداد الإشعارات باستخدام نماذج الإشعارات.

مزامنة فترات الرسوم المتكررة وأسس التجميع

في خطة الأسعار، كان من المحتمل أن تكون هناك فترتان زمنيتان مختلفتان ساريتان:

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

تتم الآن مزامنة هاتين الفترتين. عندما تتوفّر رسوم متكررة غير صفرية وبطاقة أسعار &quot;حزمة&quot; أو &quot;حجم&quot; في خطة أسعار، يتم استخدام فترة الرسوم المتكررة لكليهما. على سبيل المثال، إذا كانت هناك رسوم متكرّرة شهرية، تتم إعادة ضبط حِزم قائمة الأسعار أيضًا شهريًا (تلقائيًا في بداية الشهر).

إذا لم تكن هناك رسوم متكرّرة، تتم إعادة ضبط الحِزم استنادًا إلى "أساس التجميع" المحدّد في قائمة الأسعار. على سبيل المثال، إذا بدأ أحد المطوّرين استخدام بطاقة أسعار في اليوم 19 من الشهر، وكان أساس التجميع كل شهر، تتم إعادة ضبط استخدام الحزمة بعد شهر من اليوم 19.

سيتم إيقاف ميزة "أساس التجميع" نهائيًا وإزالتها من ميزة تحقيق الربح في إصدار مستقبلي. لمزيد من المعلومات، يُرجى الاطّلاع على تحديد تفاصيل خطة بطاقة الأسعار.

السمات المخصّصة في تقارير ملخّص الأرباح

تتيح لك سياسات تسجيل المعاملات بشكل اختياري جمع بيانات السمات المخصّصة من المعاملات، ويمكنك الآن تضمين سمات المعاملات المخصّصة هذه في تقارير الأرباح الموجزة. من خلال إضافة السمة MINT.SUMMARY_CUSTOM_ATTRIBUTES إلى مؤسستك، يمكنك تحديد السمات المخصّصة التي تتم إضافتها إلى جداول قاعدة البيانات لاستخدامها في التقارير.

يمكن لعملاء Apigee Edge Private Cloud ضبط العلامة باستخدام طلب البيانات من واجهة برمجة التطبيقات التالي وبيانات اعتماد مشرف النظام.

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

يُرجى العِلم أنّ مصفوفة السمات المخصّصة في طلب البيانات من واجهة برمجة التطبيقات تكون بترميز عنوان URL.

عملية ترقية SmartDocs

إذا كنت تستخدم SmartDocs خلال الفترة التجريبية، تتطلّب الميزات والإمكانات الجديدة في الإصدار المتاح للجميع ترقية SmartDocs في بوابة المطوّرين.

ستستمر أي صفحات SmartDocs تم نشرها من قبل في بوابة المطوّرين في العمل، ولكن يجب اتّباع عملية التحديث قبل تعديل أو نشر أي تغييرات على الصفحات الحالية أو الجديدة.

يُرجى العِلم أنّه على الرغم من إمكانية عرض SmartDocs ونشرها داخل بوابة المطوّرين، يتم إنشاء SmartDocs من نموذج واجهة برمجة التطبيقات المتوفّر ضمن &quot;خدمات إدارة واجهة برمجة التطبيقات&quot; في Apigee Edge. ستكون أي تغييرات تجريها على نموذج واجهة برمجة التطبيقات في Edge هي نفسها في جميع بيئات Pantheon (على غرار طريقة توفّر المطوّرين في بيئات Pantheon).

للترقية من الإصدار التجريبي من SmartDocs إلى الإصدار المتوفر للجمهور العام

1. عدِّل الإصدار 15.05.27 واختبِره في بيئات التطوير أو الاختبار على Pantheon.
2. أنشئ نموذجًا جديدًا لاستبدال أي نموذج حالي لواجهة برمجة التطبيقات كنت تستخدمه.
   • إذا كنت قد استوردت مستندات Swagger أو WADL، أعِد استيرادها إلى مراجعة جديدة.
   • إذا كنت تحتفظ بنموذج واجهة برمجة التطبيقات من خلال وحدة SmartDocs، يمكنك تصديره بتنسيق SmartDocs JSON واستيراده إلى النموذج الجديد باستخدام مرفق الملف.
3. اضبط خصائص الأمان الخاصة بمراجعة النموذج. في صفحة المحتوى > SmartDocs > النموذج، اختَر إعدادات الأمان.
   
4. تحقَّق من أي مصادقة تم ضبطها مسبقًا في صفحة إعدادات النموذج (المحتوى > SmartDocs) من خلال النقر على الإعدادات في عمود العمليات.
   
5. عدِّل أي نماذج مخصّصة لاستخدام الإصدار 6 من مواد عرض CSS وJS، وأجرِ تغييرات لتعكس أي أسماء عناصر جديدة، مثل authSchemes وapiSchema. للحصول على معلومات حول تعديل نماذج SmartDocs، يُرجى الاطّلاع على استخدام SmartDocs لإنشاء مستندات لواجهات برمجة التطبيقات.
6. إعادة عرض مراجعة النموذج ونشرها
7. بعد التحقّق من صحة المستندات الجديدة، عليك تعديل بوابة الإنتاج إلى الإصدار 15.05.27.

إذا كنت من عملاء Edge Enterprise ولديك أسئلة أو مخاوف بشأن عملية الترقية، يُرجى إرسال رسالة إلكترونية إلى marsh@apigee.com وcnovak@apigee.com. بخلاف ذلك، يُرجى استخدام منتدى Apigee للحصول على أفضل رد.

التغييرات والتحسينات المستقبلية على الميزات

يعرض هذا القسم معاينة للتغييرات والتحسينات المستقبلية المتوقّعة في الميزات:

تغيير في سلوك سياسة ذاكرة التخزين المؤقت للاستجابة

في إصدار مستقبلي (سيتم تحديده لاحقًا)، سيتغيّر السلوك التلقائي للعنصر <ExcludeErrorResponse> في سياسة &quot;ذاكرة التخزين المؤقت للردود&quot;.

السلوك الحالي: تكون قيمة العنصر <ExcludeErrorResponse> في سياسة ذاكرة التخزين المؤقت للاستجابة هي "خطأ" تلقائيًا. وهذا يعني أنّ السياسة &quot;ذاكرة التخزين المؤقت للاستجابات&quot; تخزّن تلقائيًا الاستجابات التي تتضمّن أي رمز حالة HTTP ممكن (بما في ذلك 3xx).

السلوك المستقبلي: سيتم ضبط القيمة التلقائية للعنصر <ExcludeErrorResponse> في سياسة "ذاكرة التخزين المؤقت للردود" على "صحيح". وهذا يعني أنّه سيتم تلقائيًا تخزين الردود التي تتضمّن رموز حالة HTTP من 200 إلى 205 مؤقتًا. لتجاوز هذا السلوك وتخزين الاستجابات مؤقتًا لجميع رموز الحالة، عليك ضبط العنصر <ExcludeErrorResponse> على القيمة true بشكل صريح.

الحلّ الحالي: في الإصدارات 4.15.07.00 والإصدارات الأقدم من Private Cloud، إذا كنت تريد تخزين الردود مؤقتًا التي تتضمّن رموز الحالة من 200 إلى 205 فقط، عليك ضبط العنصر <ExcludeErrorResponse> على "صحيح" بشكل صريح.

إصلاح الأخطاء

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

المشاكل المعروفة

يتضمّن هذا الإصدار المشاكل المعروفة التالية.

> source /{install-dir}/apigee4/bin/apigee-env.sh

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4`

> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh

> rm /install-dir/apigee4/share/monetization

**************************************
In order to complete the monetization upgrade please run:
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh
**************************************

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

<install_dir>/apigge4/bin/apigee-service message-processor restart