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

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

أصدرنا يوم الثلاثاء، 8 أيلول (سبتمبر) 2015، إصدارًا رئيسيًا من ميزات Apigee Edge الخاصة بالسحابة الإلكترونية الخاصة.

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

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

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

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

الترقية الانتقائية للمكوّنات وإلغاء تثبيتها

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

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

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

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

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

تثبيت "المستندات الذكية"

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

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

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

النظام الأساسي Edge

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

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

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

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

تم توسيع نطاق دعم نظام التشغيل Apigee Edge الخاص بـ Private Cloud لتتضمّن Red Hat Enterprise Linux 6.6 و7.0 (64 بت) وCentOS 6.5 و6.6 و7.0 (64 بت) وOracle Linux 6.5.

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

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

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

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

إذا سبق لك استخدام سمة value.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)

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

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

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

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

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

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

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

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

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

تم تحسين سياسة "التحكّم في الوصول" للسماح بإجراء تقييم أكثر دقة لعناوين IP من أجل إضافة عناوين IP إلى القائمة المسموح بها والقائمة المرفوضة عندما تكون عناوين IP مضمَّنة في عنوان HTTP الذي يتضمّن العنصر X-FORWARDED-FOR.

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

الكيانات الجديدة في سياسة "جهة الوصول"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

دعم إشارة اسم الخادم (SNI)

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

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)

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

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

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

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

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

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

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

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

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

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

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

مدى التوفّر للجمهور العام في Smart Docs

ستتم ترقية "مستندات Google الذكية" من الإصدار التجريبي إلى مدى التوفّر للجمهور العام. تشمل التحديثات والميزات الجديدة ما يلي:

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

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

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

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

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

خدمات التحليلات

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

الحد الزمني للبيانات المحفوظة

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

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

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

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

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

تحقيق الربح

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

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

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

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

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

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

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

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

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

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

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

يمكن لعملاء Apigee Edge for 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.

عملية ترقية "المستندات الذكية"

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

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

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

للترقية من الإصدار التجريبي من "مستندات ذكية" إلى مرحلة التوفّر للجمهور العام

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

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

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

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

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

في إصدار مستقبلي (سيتم تحديده)، سيتغير السلوك التلقائي لعنصر <REMOVEErrorResponse> في سياسة "ذاكرة التخزين المؤقت للاستجابة".

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

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

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

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

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

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

يحتوي هذا الإصدار على المشاكل المعروفة التالية.

> 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