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

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

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

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

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

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

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

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

تغييرات نموذج العناصر في المستند (DOM) التي قد تؤثر في البوابة

يجب وضع النقاط التالية في الاعتبار على وجه الخصوص:

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

في ما يلي ملخّص بالتغييرات التي تم إجراؤها على واجهة Smart Docs.

• التنقل الجانبي:
  • تمت إعادة كتابة شريط التنقّل الجانبي بالكامل باستخدام مكوّنات من مواد زاوية.
  • أصبحت عناوين التنقّل الجانبية الآن <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 Hybrid تظهر الصور المصغّرة الآن بشكل صحيح على صفحة "مواد العرض".
161295683	البوابة المدمجة	تعذُّر الخادم مع عدم ضبط وصف للتطبيق ستنجح الآن عملية إنشاء التطبيق إذا لم يتم تحديد الوصف (حقل اختياري) لأحد التطبيقات.
160898967	البوابة المدمجة	لا يتم تمرير الصفحة المقصودة للبوابة بشكل صحيح يمكن الآن التمرير في الصفحة المقصودة للبوابة.
160613314، 159197760، 158643196، 158069283، 158069066، 140154942	البوابة المدمجة	إصلاحات أمان متنوعة
158593496	البوابة المدمجة	تعذُّر إنشاء تطبيقات المطوِّرين في بوابات V1 تم إصلاح مشكلة كانت تمنع إنشاء تطبيقات المطوّرين على بوابات الإصدار 1.
158318079	البوابة المدمجة	عدم إمكانية إضافة عنوان URL لمعاودة الاتصال أو تعديله في بوابة المطوّرين تم إصلاح مشكلة كانت تمنع مستخدمي البوابة من إضافة عنوان URL لمعاودة الاتصال أو تعديله في صفحة واجهات برمجة التطبيقات.
157902256	البوابة المدمجة	يمكن أن يؤدي النشر إلى إلغاء تعديل اسم الصفحة في صفحة "تفاصيل الصفحة" تم إصلاح مشكلة كانت تتسبب في إلغاء تعديل اسم الصفحة عندما نشرت البوابة (بسبب أحد شروط السباق).
138993728	البوابة المدمجة	عدم عمل ميزة ترتيب الرسائل الإلكترونية والبحث فيها لبرامج المطوّرين يعمل البحث عن حسابات المستخدمين وترتيبها الآن على النحو المتوقع.

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

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