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 في الإصدار 2.0 من Cassandra:
   > 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

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

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

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

إزالة أداة Classic Trace من محرر خادم وكيل API

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

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

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

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

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

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

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

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

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

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

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

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

• يحلّ TargetEndpoint: request.url محلّ target.basepath.with.query.
• يحلّ TargetServer: loadbalancing.targetserver محلّ targetserver.name. بالإضافة إلى ذلك، لا تتم تعبئة 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) وواجهة برمجة التطبيقات الخاصة بالإدارة (الحصول على تفاصيل الشهادة من ملف تخزين المفاتيح أو ملف تخزين الشهادات الموثوقة). يعرض الحقل إما "sha1WithRSAEncryption" أو "sha256WithRSAEncryption"، وذلك حسب نوع خوارزمية التجزئة المستخدَمة لإنشاء الشهادة.

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

تشير صفحة "شهادات طبقة المقابس الآمنة" في واجهة مستخدم الإدارة (المشرف > شهادات طبقة المقابس الآمنة) إلى تاريخ انتهاء صلاحية شهادات طبقة المقابس الآمنة خلال 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
• تحسينات على سهولة الاستخدام وسير العمل في "بوابة المطوّرين"، وهي متاحة من خلال القائمة "المحتوى" > SmartDocs في Drupal
• أصبحت طريقة المصادقة المعروفة باسم "الرمز المميّز المخصّص" تُعرف الآن باسم "مفتاح واجهة برمجة التطبيقات".
• عناصر "الأمان" الخاصة بالمصادقة المحدّدة على مستوى المراجعة
• إعداد مصادقة العميل على مستوى النموذج لم تعُد المراجعات الجديدة تعيد ضبط أي بيانات اعتماد مُسبقة الإعداد لعميل SmartDocs.

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

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

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

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

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

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

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

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

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

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

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

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

تحقيق الربح

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

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

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

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

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

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

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

إذا لم تكن هناك رسوم متكرّرة، تتم إعادة ضبط الحِزم استنادًا إلى &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> في سياسة "ذاكرة التخزين المؤقت للاستجابة".

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

السلوك المستقبلي: سيتم تلقائيًا ضبط العنصر <ExcludeErrorResponse> في سياسة &quot;ذاكرة التخزين المؤقت للاستجابة&quot; على القيمة true. وهذا يعني أنّه سيتم تلقائيًا تخزين الردود التي تتضمّن رموز حالة 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