20.07.27 – נתוני הגרסה של הפורטל המשולב של Apigee Edge

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X.
מידע

ביום שני, 27 ביולי, נתחיל לפרסם גרסה חדשה של הפורטל המשולב של Apigee Edge.

תכונות חדשות ושיפורים

בקטע הזה מתוארים התכונות והשיפורים החדשים בגרסה הזו.

שיפורים בנגישות ובמהירות תגובה

בטבלה הבאה מפורטים השיפורים בנגישות ובמהירות תגובה שמוטמעים בגרסה הזו.

  • ניווט באמצעות המקלדת: עכשיו אפשר לנווט באמצעות המקלדת בסרגלי הניווט בכותרת העליונה והתחתונה, בניווט הצדדי ב-SmartDocs, ברשימת האפליקציות, בתצוגת האפליקציה ובכרטיסי ה-API.
  • ניהול מיקוד: כשמנווטים בעזרת סרגל הניווט של הכותרת והניווט הצדדי ב-SmartDocs, המיקוד מועבר ל-<H1> הראשונים בדף אחרי פעולת ניווט.
  • אזורים פעילים: שינויים ברשימת ממשקי ה-API שנוצרים מסינון טקסט מדווחים עכשיו למשתמשים העושים שימוש בקורא מסך.
  • שימוש סמנטי בכותרות HTML: כל הטקסט נכלל עכשיו בתגי HTML המתאימים מבחינה סמנטית. מבנה של כותרת היררכי הולם נמצא עכשיו בשימוש בכל הפורטל.
  • שימוש יחיד ב-<H1>: לכל דף יש עכשיו רק <H1> אחד, כך שקוראי מסך יכולים לזהות בקלות את התיאור האינפורמטיבי ביותר של תוכן הדף.
  • שימוש באותיות רישיות סגנוניות: עכשיו השימוש באותיות רישיות בלבד בתור סימן ההטעמה החזותי מיושם רק ב-CSS ולא בטקסט עצמו.
  • סדר לוגי של ה-DOM: לחצני הפעולות בדפים 'יצירה ועריכה של אפליקציות' הועברו אל מתחת לרכיבי הטופס ב-DOM, כדי שאפשר יהיה להפעיל אותם בסדר לוגי, בסיום האינטראקציה עם הטופס.
  • תיאורים טקסטואליים של רכיבים חזותיים: שיפרנו את הניווט באמצעות קורא מסך ושיפרנו את השימוש בתוויות, בטקסט חלופי ובטקסט בלחצנים.
  • ניגודיות צבעים: ניגודיות הצבעים הוגדלה כדי לעמוד בדרישות הניגודיות של WCAG AA במקומות רבים במוצר. הכותרות של ממשקי ה-API ברשימת ממשקי ה-API הועברו מתחת לתמונה כדי למנוע מצב של ניגודיות צבעים מספיקה.
  • אימות טופס: בדפים 'יצירה ועריכה של אפליקציות', הלחצנים לשליחת טפסים לא מושבתים יותר ואפשר להפעיל אותם כדי לאמת את הטופס. שדות הטופס שאומתו בדפי 'יצירה ועריכה של האפליקציה' כוללים עכשיו תיאורים טקסטואליים של שגיאת האימות.
  • מהירות תגובה: עכשיו יש רוחב מקסימלי שחל על כל הדפים, למעט מסמכים חכמים. מעכשיו, הניווט ב-SmartDocs פועל במסכי טלפון צרים. הדפים 'יצירה ועריכה של אפליקציות' רספונסיביים יותר למסכים צרים.

שינויי DOM שעשויים להשפיע על הפורטל שלך

כדאי לשקול במיוחד אם:

  • סרגלי הניווט (כותרת עליונה ותחתונה) וכותרות הדפים עוצבו (או הוסתרו) על ידי שינויי CSS: מעכשיו יש רוחב מקסימלי לתוכן הדף. כדי להרחיב את סרגלי הניווט ואת הכותרות של הדפים לקצה חלון הדפדפן, Apigee עיצבה את רכיב הפסאודו של :before. מידע נוסף זמין במאמר שינוי צבעים ראשיים בסרגלי ניווט ובכותרות דפים.
  • יש רכיבים בדף עם רקעים שנמשכים עד לקצה חלון הדפדפן (מלבד תמונת הרקע במסך מלא): הרוחב המקסימלי של תוכן הדף הוגבל כדי לשפר את יכולת התגובה, מה שעלול להגביל את החלוניות הקודמות ברוחב מלא בדפים מותאמים אישית. מידע נוסף על השימוש בהגדרות החדשות של רוחב מקסימלי זמין במאמר יצירת חלונית ברוחב מלא בדף פורטל.
  • סלקטורים ב-CSS מטרגטים רמות ספציפיות של כותרות HTML כדי לשנות סגנונות של טקסט: רמת הכותרת שהוחלה על תוכן מסוים השתנתה. לדוגמה: <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>

דף ממשקי API

סיכום השינויים בדף ממשקי ה-API מופיע בהמשך, לפי קטגוריה.

  • כרטיס קלט לחיפוש/סינון ב-API:
    • <mat-card-content class="mat-card-content"> כולל עכשיו את הכותרת והקלט של כרטיס ממשקי ה-API לחיפוש
    • ב<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 והפניות לבקרה נוספו לקלט
  • הודעה ריקה לגבי רשימת ממשקי ה-API:
    • הערך 'לא נמצאו ממשקי API' הוא <H2> במקום <H1>
    • ההסבר שעכשיו הוא <H3> במקום <H2>
  • רשימת כרטיסי API:

    הערך 'אין ממשקי API שתואמים לחיפוש' הוא עכשיו <H2> במקום <H1>

  • כרטיסי API:
    • >div class="api-doc-card-content-image-gradient"></div> הוסר
    • שם ה-API הועבר מהתמונה שמכילה <div> אל <div class="api-doc-card-content-title"></div>, מיד אחרי התמונה <div>
    • שם ה-API הוא עכשיו <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
  • רשימת ממשקי ה-API כבר לא מופיעה ברשימה של כרטיסי API עם מתגים (בדומה לרשימת ממשקי ה-API). במקום זאת, זו טבלה של ממשקי API
  • הקלט של כתובת ה-URL לקריאה חוזרת הועבר לקטע חדש
  • עכשיו אפשר ללחוץ על הלחצן 'שמירה' בסגנון של לחצן מועלה על מזרן וברקע בצבע הראשי
  • הטבלאות ארוזות עכשיו ב<div> עם הסיווג .app-table-wrapper
  • כותרות של טבלאות משתמשות עכשיו ב-wrapper <thead>
  • גוף הטבלה משתמש עכשיו ב-wrapper של <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

בהמשך מופיע סיכום של השינויים בממשק SmartDocs.

  • ניווט צדדי:
    • הניווט הצדדי שוכתב לחלוטין באמצעות רכיבים מחומר זוויתי
    • הכותרות של הניווט הצדדי הן עכשיו <H2> במקום <div>
    • מעכשיו, פריטי הניווט משתמשים בצבע הטקסט שמוגדר כברירת מחדל בפורטל, במקום במאפיין 'צבע משני' בעורך העיצובים של הפורטל
    • פריטים שנבחרו, ממוקדים ופריטים עם העברת עכבר בתפריט הניווט הצדדי משתמשים עכשיו בווריאציות כהות ובהירות של עורך העיצוב בפורטל 'צבע משני' לטקסט ולרקע, בהתאמה
  • תוכן:
    • כותרות משנה רבות, כמו 'פרמטרים של נתיב' ו'פרמטרים של כותרת', הן עכשיו <H2> במקום <H3>
    • ישויות הסכימה בדף הסקירה הכללית הן עכשיו <H3>=> במקום <H2>

הוספה של שיפורי נגישות לדף בית קיים

אם יש לך פורטל יציאה, עליך לערוך את דף הבית כדי לנצל את שיפורי הנגישות החדשים עבור כרטיסים שניתן לנווט אליהם, כפי שמתואר בהמשך:

  1. מסירים את href="" ממאגר התגים <mat-card>.
  2. לכותרת הכרטיס בתוך <mat-card-header> יש להשתמש בקוד <H2> במקום <H1>.
  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
  }
}

תהליך עדכון של ניהול ממשקי API באפליקציה

אינטראקציית המשתמש לניהול ממשקי ה-API באפליקציה בפורטל המשולב השתנתה. באופן ספציפי, במהלך ניהול אפליקציה, בקטע של ממשקי ה-API המשתמשים צריכים ללחוץ על סמל ההפעלה או סמל השבתה (במקום על מתג) כדי להפעיל או להשבית את הגישה ל-API מהאפליקציה, בהתאמה.

מעדכנים את כל התהליכים בפורטל שמתארים איך לנהל ממשקי API בדף האפליקציות, אם רלוונטי. מידע נוסף זמין במאמר ניהול ממשקי ה-API באפליקציה.

הבאגים תוקנו

הבאגים הבאים תוקנו בגרסה הזו. הרשימה הזו מיועדת בעיקר למשתמשים שבודקים אם כרטיסי התמיכה שלהם תוקנו. הוא לא נועד לספק מידע מפורט לכל המשתמשים.

מזהה הבעיה שם הרכיב התיאור
161269688 פורטל משולב

תמונות ממוזערות של נכסים מעובדים באופן שגוי ב-Apigee hybrid

עכשיו תמונות ממוזערות מוצגות בצורה תקינה בדף 'נכסים'.

161295683 פורטל משולב

השרת נכשל ולא הוגדר תיאור לאפליקציה

אם לא יוגדר תיאור (שדה אופציונלי) לאפליקציה, יצירת האפליקציה תסתיים בהצלחה.

160898967 פורטל משולב

דף הנחיתה של הפורטל לא נגלל כמו שצריך

עכשיו אפשר לגלול בדף הנחיתה של הפורטל.

160613314,
159197760,
158643196,
158069283,
158069066,
140154942
פורטל משולב

תיקוני אבטחה שונים

158593496 פורטל משולב

יצירת אפליקציות למפתחים נכשלה בפורטלים של גרסה 1

תוקנה בעיה שמנעה את היצירה של אפליקציות למפתחים בפורטלים של V1.

158318079 פורטל משולב

לא ניתן להוסיף או לשנות כתובת URL לקריאה חוזרת (callback) בפורטל למפתחים

תוקנה בעיה שמנעה ממשתמשי פורטל להוסיף או לשנות כתובת URL לקריאה חוזרת (callback) בדף ה-API.

157902256 פורטל משולב

הפרסום יכול לבטל עדכון של שם הדף בדף הפרטים של הדף

תוקנה בעיה שגרמה לביטול עדכון של שם דף כשפרסמת את הפורטל (עקב תנאי של מרוצים).

138993728 פורטל משולב

מיון האימייל והחיפוש של תוכניות למפתחים לא פועלים

חיפוש ומיון של חשבונות משתמשים של צרכנים פועלים עכשיו כצפוי.

בעיות ידועות

לרשימה של בעיות ידועות בפורטל המשולב, אפשר לעיין במאמר בעיות מוכרות בפורטל המשולב.