20.07.27: ملاحظات إصدار بوابة Apigee Edge المدمَجة

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

سنبدأ يوم الاثنين في 27 تموز (يوليو) بإطلاق إصدار جديد من بوابة Apigee Edge المتكاملة.

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

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

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

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

• التنقُّل باستخدام لوحة المفاتيح: من الممكن الآن التنقّل في أشرطة التنقّل في الرؤوس والتذييلات، وشريط التنقّل الجانبي في "مستندات Google الذكية"، و"قائمة التطبيقات"، و"عرض التطبيقات"، و"بطاقات واجهة برمجة التطبيقات" باستخدام لوحة المفاتيح.
  
• إدارة التركيز: يؤدي التنقّل باستخدام شريط التنقّل في رأس الصفحة وشريط التنقّل الجانبي في "مستندات Google الذكية" إلى نقل التركيز إلى أول <H1> في الصفحة بعد إجراء التنقّل.
• المناطق المباشرة: يتم الآن إبلاغ المستخدمين الذين يستخدمون قارئ الشاشة بالتغييرات التي تطرأ على قائمة واجهات برمجة التطبيقات الناتجة عن الفلترة النصية.
• الاستخدام الدلالي لعناوين HTML: يتم الآن تضمين كل النص في علامات HTML المناسبة دلاليًا. يتم الآن استخدام هيكل عنوان هرمي مناسب في جميع أنحاء البوابة.
• استخدام <H1> الفردي: تحتوي كل صفحة الآن على سمة <H1> واحدة فقط، ما يتيح لبرامج قراءة الشاشة التعرّف بسهولة على الوصف الأكثر إفادة لمحتوى الصفحة.
• الكتابة بالأحرف اللاتينية الكبيرة: أصبح الآن يتم الآن استخدام أحرف كبيرة بالكامل كتمييز مرئي باستخدام لغة CSS فقط بدلاً من تطبيقها في النص الفعلي.
• الترتيب المنطقي لعناصر DOM: تم نقل أزرار الإجراءات في صفحات "إنشاء التطبيق" و"تعديله" أسفل عناصر النموذج في نموذج العناصر في المستند (DOM) حتى يمكن تفعيلها بترتيب منطقي عند اكتمال التفاعل مع النموذج.
• الأوصاف النصية للعناصر المرئية: يتم تحسين استخدام التصنيفات والنص البديل ونص الزر، ما يحسّن التنقّل باستخدام قارئ الشاشة.
• تباين الألوان: تمت زيادة تباين الألوان لاستيفاء متطلبات تباين WCAG AA في عدة أماكن في المنتج. تم نقل عناوين واجهة برمجة التطبيقات في قائمة واجهات برمجة التطبيقات إلى أسفل الصورة لتجنّب احتمال وجود تباين غير كافٍ للألوان.
• التحقّق من صحة النموذج: في صفحات "إنشاء التطبيق" و"تعديله"، لم تعد أزرار إرسال النموذج متوقّفة ويمكن تفعيلها للتحقّق من صحة النموذج. تشتمل حقول النماذج التي تم إثبات صحتها على صفحات "إنشاء التطبيق" و"تعديله" الآن على أوصاف نصية لخطأ التحقق.
• الاستجابة: يتوفّر الآن حد أقصى للعرض ينطبق على جميع الصفحات باستثناء "مستندات ذكية". يعمل التنقل في Smart Docs الآن على الشاشات الضيقة بحجم الهاتف. أصبحت صفحات إنشاء التطبيق وتعديله الآن أكثر استجابة للشاشات الضيقة.

تغييرات DOM التي قد تؤثر في البوابة

يجب أخذ النقاط التالية في الاعتبار بشكل خاص في الحالات التالية:

• تم تغيير (أو إخفاء) أشرطة التنقل (الرؤوس والتذييلات) وعناوين الصفحات باستخدام عمليات إلغاء CSS: يوجد الآن حد أقصى لعرض محتوى الصفحة. لتوسيع أشرطة التنقل وعناوين الصفحات إلى حافة نافذة المتصفح، صمّمت Apigee العنصر :before الزائف. لمزيد من المعلومات، يُرجى الاطّلاع على إلغاء الألوان الأساسية لأشرطة التنقّل وعناوين الصفحات.
• تتوفّر عناصر صفحة بخلفيات تمتد إلى حافة نافذة المتصفّح (بخلاف صورة الخلفية بملء الشاشة): تم تحديد الحدّ الأقصى لعرض محتوى الصفحة لتحسين سرعة الاستجابة، ما قد يؤدي إلى تقييد أيّ لوحات بعرض كامل سابقًا ضمن الصفحات المخصّصة. للحصول على مزيد من المعلومات عن استخدام إعدادات الحد الأقصى للعرض، يمكنك الاطّلاع على إنشاء لوحة بعرض كامل في صفحة بوابة.
• تم استهداف مستويات معيّنة لعناوين HTML باستخدام أدوات اختيار لغة CSS لتعديل أنماط النص: تم تغيير مستوى العنوان المطبّق على محتوى معيّن. على سبيل المثال: <H1> → <H2> يُرجى مراجعة قائمة التغييرات المفصّلة الخاصة بهذا الإصدار لمعرفة المحتوى المتأثر بالضبط.
• يتم اختيار اللون الأبيض أو الفاتح جدًا باعتباره "اللون الثانوي" في محرِّر مظاهر البوابة: يتم استخدام اللون الثانوي لعناصر التنقّل التي يصعب رؤيتها على خلفية بيضاء. ننصحك باختيار لون ثانوي يمكن الوصول إليه ثم تجاوزه إذا لزم الأمر باستخدام scss مخصَّصة في مواقف معيّنة.
• تخصيص نمط الروابط النصية: أصبح بإمكانك الآن الوصول إلى نمط الروابط بشكل أكبر. اطّلِع على التغييرات أدناه لفهم كيفية تفاعله مع نمطك الحالي.
• تم تغيير نمط الجزء السفلي من الحد الذي يبلغ 2 بكسل في منطقة المحتوى في بطاقات المشاهدة الرئيسية أو إخفاؤها باستخدام عمليات إلغاء CSS: تم نقل هذا الحد من <mat-card-content> إلى أعلى الحد في <mat-card-actions>.

ملخص التغييرات التفصيلية

تلخّص الأقسام التالية التغييرات التفصيلية التي تم تنفيذها في هذا الإصدار، حسب الفئة.

التغييرات على مستوى البوابة

في ما يلي ملخّص عن التغييرات على مستوى البوابة.

• لم تعُد المتغيّرات التالية قيد الاستخدام:
  • $layout-horizontal-padding
  • $layout-main-content-horiz-padding
  • $layout-header-horiz-padding
  • $layout-context-bar-horiz-padding
• تتوفّر متغيّرات جديدة توفّر إمكانية التحكّم في الحدّ الأقصى لعرض منطقة المحتوى الرئيسية والحد الأدنى من المساحة المتروكة الأفقية لمنطقة المحتوى الرئيسية:
  • $layout-main-content-max-width
  • $layout-horizontal-min-padding

تغييرات شريط التنقّل الأساسي

في ما يلي ملخّص للتغييرات التي يتم إجراؤها على شريط التنقّل الأساسي.

• الشعار <img> مضمَّن الآن في <a> لأحجام شاشات أجهزة الكمبيوتر المكتبي والأجهزة الجوّالة.
• أصبح زر القائمة المنسدلة للمستخدم الآن <button> بدلاً من <a>

تغييرات نمط الرابط

تحتوي الروابط العادية <a> ضمن النص الآن على تسطير تلقائيًا ولون للخلفية عند التمرير فوقه (بناءً على إعدادات المظهر "اللون الثانوي")

تغييرات الصفحة 404

في ما يلي ملخّص للتغييرات التي يتم إجراؤها على صفحة 404.

• أصبح "تسجيل الدخول الآن" الآن <H2> بدلاً من <H1>
• نص الشرح الآن هو <H2> بدلاً من <H1>.

صفحة واجهات برمجة التطبيقات

في ما يلي ملخّص للتغييرات التي تطرأ على صفحة واجهات برمجة التطبيقات حسب الفئة.

• بطاقة إدخال فلتر/بحث واجهة برمجة التطبيقات:
  • يضم <mat-card-content class="mat-card-content"> الآن عنوان بطاقة واجهات برمجة التطبيقات للبحث والإدخال.
  • يستخدم <H2> الآن class="mat-subheading-1" بدلاً من class="api-doc-filter-title"
  • يستخدم <mat-form-field> الآن appearance="outline"
  • تمت إضافة رمز بحث إلى <mat-form-field> قبل الإدخال: "<mat-icon matPrefix>search</mat-icon>"
  • تمت إضافة تصنيفات أريا ومراجع التحكّم إلى الإدخال.
• رسالة فارغة لقائمة واجهة برمجة التطبيقات:
  • أصبحت حالة "لم يتم العثور على واجهات برمجة تطبيقات" الآن <H2> بدلاً من <H1>
  • أصبح الشرح الآن <H3> بدلاً من <H2>.
• قائمة بطاقات واجهة برمجة التطبيقات:

  أصبحت عبارة "لا تتطابق أي واجهات برمجة تطبيقات مطابقة مع بحثك" الآن بـ <H2> بدلاً من <H1>

• بطاقات واجهة برمجة التطبيقات:
  • تمت إزالة >div class="api-doc-card-content-image-gradient"></div>.
  • تمّ نقل عنوان واجهة برمجة التطبيقات من الصورة التي تحتوي على <div> إلى <div class="api-doc-card-content-title"></div> بعد الصورة <div> مباشرةً.
  • أصبح عنوان واجهة برمجة التطبيقات الآن <H2> بدلاً من <H1>

قائمة التطبيقات:

• حالة فارغة:
  • أصبح "البدء" الآن <H2> بدلاً من <H1>
  • تم ضبط إرشادات الحالة الفارغة الآن على <H3> بدلاً من <H2>.
• قائمة:
  • أصبح "تطبيقاتي" الآن <H2> بدلاً من <H1>
  • <mat-row> ملتوي الآن في <a>

إنشاء صفحات التطبيقات وتعديلها

يتم تلخيص التغييرات التي يتم إجراؤها على صفحات "إنشاء التطبيق" وتعديله أدناه.

• تم نقل <div class="app-buttons"> إلى نهاية <form> واستبداله بـ <div class="form-buttons-sticky-container">.
• تم تغيير جميع استخدامات الفئة .app-layout-section إلى .details-layout-section
• تم تغيير جميع استخدامات الفئة .app-layout-section-title إلى .details-layout-section-title
• جميع عناوين الأقسام الآن <H2> بدلاً من <div>
• تم تغيير جميع استخدامات الفئة .app-layout-section-content إلى .details-layout-section-content
• لم تعد قائمة واجهات برمجة التطبيقات قائمة ببطاقات واجهة برمجة التطبيقات التي تتضمن مفاتيح تبديل (على غرار قائمة واجهات برمجة التطبيقات). فهو جدول بواجهات برمجة التطبيقات
• تم نقل إدخال عنوان URL لمعاودة الاتصال إلى قسم جديد
• يستخدم زر الحفظ الآن نمط الزر "مات برفعه" وخلفية اللون الأساسية.
• الجداول الآن متصلة في <div> بالصف .app-table-wrapper
• تستخدم عناوين الجداول الآن برنامج تضمين <thead>
• نص الجدول يستخدم الآن برنامج تضمين <tbody>
• لم يعُد يتم استخدام "[style.width]" لضبط عرض أعمدة الجدول.
• جميع علامات <a> داخل الجدول تستخدم الآن <button بدلاً من ذلك

قائمة الفِرق

في ما يلي ملخّص للتغييرات التي يتم إجراؤها على قائمة "الفريق".

• حالة فارغة:
  • أصبح "البدء" الآن <H2> بدلاً من <H1>
  • أصبح خيار "إنشاء فريق لإدارة الملكية المشتركة للتطبيق" هو <H3> بدلاً من <H2>.
• القائمة:

  أصبح عنوان "الفِرق" <H2> بدلاً من <H1>.

إنشاء صفحات الفريق وتعديلها

في ما يلي ملخّص للتغييرات التي يتم إجراؤها على صفحات إنشاء الفريق وتعديله.

• في <form>، تم استبدال الصف .teams-form بـ .details-form
• تم نقل <div class="teams-buttons"> إلى نهاية <form> واستبداله بـ <div class="form-buttons-sticky-container">.
• تم تغيير جميع استخدامات الفئة .teams-layout-section إلى .details-layout-section
• تم تغيير جميع استخدامات الفئة .teams-layout-section-title إلى .details-layout-section-title
• تم تغيير جميع استخدامات الفئة .teams-layout-section-content إلى .details-layout-section-content
• تمت إضافة <div class="team-apps-container"> حول <table class="team-apps">

SmartDocs

في ما يلي ملخّص للتغييرات التي تم إجراؤها على واجهة "المستندات الذكية".

• شريط التنقّل الجانبي:
  • تمت إعادة كتابة شريط التنقّل الجانبي بالكامل باستخدام مكونات المواد الزاويّة.
  • أصبحت عناوين التنقّل الجانبي الآن <H2> بدلاً من <div>
  • تستخدم عناصر التنقّل الآن لون النص التلقائي للبوابة بدلاً من "اللون الثانوي" في محرِّر مظهر البوابة.
  • تستخدم العناصر المحدّدة والمركزة والتي تم تمريرها في شريط التنقّل الجانبي الآن أشكالاً داكنة وفاتحة اللون في محرّر مظهر البوابة "اللون الثانوي" للنص والخلفية على التوالي.
• المحتوى:
  • أصبحت العديد من العناوين الفرعية مثل "معلَمات المسار" و "معلَمات العناوين" الآن <H2> بدلاً من <H3>
  • أصبحت عناصر المخطط في صفحة النظرة العامة الآن <H3>=> بدلاً من <H2>.

إضافة تحسينات إمكانية الوصول إلى صفحة رئيسية حالية

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

1. أزِل href="" من حاوية <mat-card>.
2. استخدِم <H2> بدلاً من <H1> لعنوان البطاقة ضمن <mat-card-header>.
3. داخل عنوان البطاقة <h2>، يتم لف النص في <a class="navigable-content" href="href-name"> وضبط href-name على القيمة المناسبة للتنقّل في البطاقة.

بدلاً من ذلك، يمكنك استخدام نموذج البطاقة التالي:

<mat-card class="home-page-card quick-start">
  <mat-card-header class="home-page-card-header" color="primary">
    <mat-icon class="home-page-card-header-icon">
      check_circle
    </mat-icon>
    <h2 class="home-page-card-header-text">
      <a class="navigable-content" href="page-route">
        Card heading
      </a>
    </h2>
  </mat-card-header>
  <mat-card-content class="home-page-card-content">
    <p class="home-page-card-content-text">
      Extra content
    </p>
  </mat-card-content>
</mat-card>
</p>

إلغاء الألوان الأساسية لأشرطة التنقل وعناوين الصفحات

لتوسيع أشرطة التنقل وعناوين الصفحات إلى حافة نافذة المتصفّح، يمكنك إضافة تصميم مخصّص لأشرطة التنقل وعناوين الصفحات باستخدام أداة تعديل المظاهر المتقدّمة، كما هو موضّح في ما يلي لشريط التنقّل في العنوان:

// Override use of the primary color for header navigation bar background-color
.nav-header .mat-toolbar {
  color: #fff //  color for navigation text

  // Use the :before pseudo element to style the background of full-width bars
  // (header and footer navigation bars and page headers)
  &:before {
    background-color: #000; // background color for header navigation bar
  }
}

تحديث إجراء إدارة واجهات برمجة التطبيقات لأحد التطبيقات

تم تغيير تفاعل المستخدم لإدارة واجهات برمجة التطبيقات في تطبيق على البوابة المدمجة. وعلى وجه التحديد، عند إدارة تطبيق، يجب على المستخدمين في قسم واجهات برمجة التطبيقات النقر على أو (بدلاً من زر الإيقاف/التفعيل) لتفعيل الوصول إلى واجهة برمجة التطبيقات من التطبيق أو إيقافه.

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

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

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

معرّف المشكلة	اسم المكوّن	الوصف
161269688	بوابة متكاملة	يتم عرض الصور المصغّرة لمواد العرض بشكل غير صحيح في ملف Apigee المختلط. تظهر الصور المصغّرة الآن بشكل صحيح في صفحة "مواد العرض".
161295683	بوابة متكاملة	يعمل الخادم بدون ضبط وصف للتطبيق ستنجح عملية إنشاء التطبيق الآن في حال عدم تحديد الوصف (حقل اختياري) للتطبيق.
160898967	بوابة متكاملة	لا يتم الانتقال في الصفحة المقصودة للبوابة بشكل صحيح الصفحة المقصودة للبوابة قابلة للتمرير الآن.
160613314، 159197760، 158643196، 158069283، 158069066، 140154942	بوابة متكاملة	إصلاحات متنوعة للأمان
158593496	بوابة متكاملة	تعذُّر إنشاء تطبيقات المطوّرين في بوابات V1 تم إصلاح مشكلة كانت تمنع إنشاء تطبيقات المطوّرين على بوابات الإصدار الأول.
158318079	بوابة متكاملة	عدم عمل إضافة أو تعديل عنوان URL لمعاودة الاتصال في بوابة المطوّرين تم إصلاح مشكلة كانت تمنع مستخدمي البوابة من إضافة أو تعديل عنوان URL لمعاودة الاتصال في صفحة واجهات برمجة التطبيقات.
157902256	بوابة متكاملة	يمكن أن يؤدي النشر إلى إلغاء تعديل اسم الصفحة في صفحة "تفاصيل الصفحة" تم إصلاح مشكلة تسببت في إلغاء تعديل اسم الصفحة عند نشر البوابة (يتسبب ذلك في حدوث مشكلة متعلّقة بالسباق).
138993728	بوابة متكاملة	تعذُّر ترتيب الرسائل الإلكترونية وعمليات البحث في برامج المطوّرين يعمل البحث عن حسابات المستخدمين وترتيبها الآن على النحو المتوقع.

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

للحصول على قائمة بالمشاكل المعروفة في المنصة المدمجة، يمكنك الاطّلاع على المشاكل المعروفة في المنصة المدمجة.