4.15.07.00 – נתוני גרסה של Apigee Developer Services Portal

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

ביום שלישי, 8 בספטמבר 2015, השקנו גרסה רבעונית של Apigee Edge Developer Services Portal לשירות פרטי בענן.

שם המוצר הקודם, 'Apigee Edge On-Places Developer Services Portal' או 'OPDK' נקרא עכשיו 'Apigee Edge Developer Services Portal for Private Cloud'.

יש לך שאלות? אפשר להיעזר בתמיכת הלקוחות של Apigee.

בנתוני הגרסה של Apigee תוכלו למצוא רשימה של כל נתוני הגרסה של Apigee Edge.

הדרישות של Apigee Edge לפורטל

אם מחברים את הגרסה הזו של הפורטל להתקנה של Edge לענן פרטי, צריך לחבר אותו לגרסה 4.15.07.00 ואילך כדי לוודא שכל התכונות של SmartDocs נתמכות. מידע נוסף זמין במאמר 4.15.07.00 – Apigee Edge להערות מוצר של ענן פרטי.

תכונות חדשות

זמינות כללית של SmartDocs

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

  • תמיכה ב-Swagger 2.0, כולל ייבוא לפי קובץ או כתובת URL, כולל תמיכה באובייקטים של אבטחה עם שם מותאם אישית.
  • שיפורים בעיצוב החזותי בתבניות שיוצרות מסמכים חכמים ב-SmartDocs.
  • נוחות השימוש ושיפורים בתהליך העבודה בפורטל למפתחים, שזמינים דרך התפריט > תפריט SmartDocs ב-Drupal.
  • האימות שנקרא "אסימון מותאם אישית" נקרא עכשיו "מפתח API".
  • אובייקטים של "אבטחה" לאימות שמוגדרים ברמת הגרסה הקודמת.
  • הגדרת אימות לקוח ברמת התבנית. גרסאות קודמות לא מאפסות יותר פרטי כניסה של לקוח ב-SmartDocs שהוגדרו מראש.

לתיאורי תכונות נוספים, קראו את הפוסט הזה בבלוג.

למסמכי SmartDocs, ראו שימוש ב-SmartDocs לתיעוד ממשקי API.

תהליך השדרוג של SmartDocs

אם השתמשת כבר ב-SmartDocs בתקופת הבטא, כדי להשתמש בתכונות וביכולות החדשות בגרסת הזמינות הכללית צריך לשדרג את SmartDocs בפורטל המפתחים.

כל הדפים של SmartDocs שכבר פורסמו בפורטל המפתחים ימשיכו לפעול, אבל יש לפעול לפי תהליך העדכון לפני עריכת או פרסום שינויים בדפים קיימים או חדשים.

חשוב לזכור שלמרות שאפשר לעבד ולפרסם SmartDocs בפורטל המפתחים, SmartDocs נוצרים ממודל ה-API שנכלל בשירותי ניהול ממשקי ה-API של Apigee's Edge. השינויים שיבוצעו במודל API ב-Edge יהיו זהים בכל סביבות ה-Pantheon (בדומה לאופן שבו המפתחים קיימים בסביבות של Pantheon).

כדי לשדרג מגרסת הבטא של SmartDocs לזמינות כללית

  1. מעדכנים ובודקים את הגרסה של 15.05.27 בסביבות dev או test ב-Pantheon.
  2. יצירת מודל חדש שיחליף את כל מודל ה-API הקיים שבו השתמשת.
    • אם ייבאת מסמכי Swagger או WADL, עליך לייבא אותם שוב לגרסה קודמת חדשה.
    • אם עדכנת את מודל ה-API באמצעות המודול SmartDocs, עליך לייצא אותו כקובץ SmartDocs JSON ולייבא אותו למודל החדש באמצעות קובץ מצורף.
  3. הגדרת מאפייני האבטחה של הגרסה הקודמת של המודל. בדף תוכן > SmartDocs > מודל, בוחרים באפשרות הגדרות אבטחה.
  4. כדי לבדוק אימות שהוגדר מראש בדף הגדרות המודל (תוכן > SmartDocs), לוחצים על הגדרות בעמודה 'פעולות'.
  5. צריך לעדכן את התבניות המותאמות אישית כדי להשתמש בגרסה 6 של נכסי ה-CSS וה-JS, ולבצע שינויים כך שישקפו שמות של אובייקטים חדשים, כמו authSchemes ו-apiSchema. למידע על עדכון תבניות SmartDocs, אפשר לקרוא את המאמר שימוש ב-SmartDocs לממשקי API למסמכים.
  6. עבד מחדש ופרסם את גרסת המודל שלך.
  7. אחרי אימות המסמכים החדשים, צריך לעדכן את פורטל production לגרסה 15.05.27.

לקוחות ארגוניים של Edge ויש להם שאלות או חששות לגבי תהליך השדרוג, יכולים לשלוח אימייל לכתובת marsh@apigee.com או cnovak@apigee.com. אם לא, השתמשו בקהילת Apigee כדי לקבל את התשובה הטובה ביותר.

הבאגים תוקנו

הבאגים הבאים תוקנו בגרסה הזו.

מזהה הבעיה התיאור
DEVSOL-487 אדמינים צריכים להגדיר את פורמט היום ב'מונטיזציה'
פורמט התאריך ניתן עכשיו להגדרה ב'מונטיזציה' בהגדרות מונטיזציה לפורמטים של תאריכים באירופה ובארה"ב.
DEVSOL-584 פרמטר הנתיב לא זוכר בשימוש הראשון
הפרמטר של הנתיב בעת ביצוע קריאות לא תמיד נשמר בזיכרון.
DEVSOL-603 הדף של תוכנית ההתנגשות בפורמט לא תקין
כשרוכשים תוכנית שחופפת לתוכנית קיימת, הפורמט של הדף שמוצג מתאים למשתמש.
DEVSOL-709 SmartDocs: לא ניתן לערוך את הפרמטר של תבנית כתובת ה-URL אחרי שליחת בקשה עם ערך ריק
תוקנה הבעיה שבגללה המערכת לא יכולה לערוך את הפרמטרים של התבנית אחרי שליחת הבקשה מ-SmartDocs אחרי מחיקת הפרמטר של התבנית במסמכי השיטה.
DEVSOL-723 הצגת הודעות ידידותיות למשתמש בייבוא של SmartDocs נכשל
DEVSOL-1013 מגדירים את כתובות האימייל של המשתמשים בפורטל הפיתוח כניתנות לעריכה
השדה של כתובת האימייל בדף עריכת הפרופיל לא יושבת יותר והמפתחים יוכלו לשנות את כתובות האימייל שלהם.
DEVSOL-1244 אין להפעיל את המודול של Environment Indicator בגרסת OPDK
DEVSOL-1273 "DevConnect Mint" מופיע פעמיים ברשימת המודולים
בקטע 'מודולים', "Dev Connect Mint" הוצג פעמיים. השגיאה תוקנה.
DEVSOL-1313 תמיכה בייבוא של קובץ JSON/YAML או כתובת URL גם ב-Sagger וגם ב-WADL
עכשיו אפשר לייבא קובצי WADL דרך כתובת URL, ולהעלות קבצים של Swagger.
DEVSOL-1339 שינוי המיקומים בתפריט הניהול של SmartDocs
היעד של SmartDocs נמצא עכשיו בתפריט התוכן, וההגדרות של המסמכים החכמים נמצאות עכשיו בתפריט הניהול של ההגדרות.
DEVSOL-1340 הסרת גרסת הבטא במעבר ל-Google Analytics
DEVSOL-1390

ספריית PHP SDK Edge עודכנה כדי לתקן את הבעיה של ביצוע קריאה אל __toString()
ספריית PHP SDK Edge עודכנה כדי לפתור את הבעיה של הקריאה ל- __toString() באובייקט DeveloperRatePlan, שיוצר את השגיאה הזו:

שגיאה חמורה: קריאה לפורמט של פונקציית חבר() על אובייקט שאינו אובייקט ב- /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php בשורה 221

זהו באג שמשפיע רק על לקוחות מונטיזציה עם קוד מותאם אישית שקורא ל-method toString() .

DEVSOL-1398 מודל SmartDocs פטstore שמיובא בהתקנה ללא הנחיות למשתמש
SmartDocs מייבא עכשיו את הדוגמה של petstore.swagger.io/v2/swagger.json במקום מודל מזג האוויר כדי לתת דוגמה מקיפה יותר לשימוש ב-SmartDocs.
DEVSOL-1407 Cron נכשל כשיש הרבה מפתחים
כשמפעילים cron של Drupal, מספר גדול של מפתחים גורם לבעיה של זמן קצוב לתפוגה. כשלארגון יש יותר מ-200 משתמשים, נעשה עכשיו שימוש בתהליך באצווה.
DEVSOL-1410 שגיאות חיבור לא מופיעות בזמן ההתקנה של Dev Portal
נוספו הודעות שגיאה טובות יותר למנהל ההתקנה כשהחיבור לניהול Edge לא פועל, כדי לצמצם את פתרון הבעיות.
DEVSOL-1422 הסרת טופס תצורת SMTP מפרופיל Apigee
בתהליך ההתקנה לא מופיעה יותר שאלה אם ברצונך להגדיר SMTP. במקום זאת, ניתן לעשות זאת לאחר השלמת ההתקנה בהתאם להליך ה-Drupal הרגיל של הפעלת מודול ה-SMTP והגדרה שלו כראוי.
DEVSOL-1427

מוסיפים קטעי hook למודול Devconnect Developer Apps כדי לאפשר שינוי של נתוני הניתוח
המודול devconnect_developer_apps כולל עכשיו שלושה קטעי hook חדשים:

# hook_devconnect_developer_apps_analytics_chart_data_alter()

# hook_devconnect_developer_app_analytics_datapoints_params_alter()

# hook_devconnect_developer_app_analytics_datapoints_alter()

הם מאפשרים למודולים מותאמים אישית לשנות את תרשים הניתוח של נתוני האפליקציות למפתחים.

DEVSOL-1464 שגיאה חמורה בשמירת הגדרות האימות של מודל
כשמוחקים סכמת אבטחה, עכשיו מוצגת תיבת סימון שמאפשרת לבחור אם צריך למחוק גם את סכימת האימות המשויכת לתבנית.
DEVSOL-1470 יצירת קישור לתפריט "ממשקי API" ותצוגה תואמת
פורטל המפתחים של SmartDocs כולל עכשיו כברירת מחדל קישור אל המסמכים שעובדו ב-SmartDocs בתפריט הראשי בשם 'ממשקי API'. קישור זה מקשר לכל המודלים שהשיטות שלהם פורסמו.
DEVSOL-1486 קריאות ל-SmartDocs יכולות לבצע אימות באמצעות מפתח מוגדר מראש
הפעלת אימות גם באמצעות מפתחות API שסופקו מראש וגם מפתחות API שסופקו על ידי המשתמשים.
DEVSOL-1499 קוד HTML לא עובר ניתוח בתיאורים של פרמטרים ב-SmartDocs
עכשיו מתבצע ניתוח של קוד ה-HTML בתיאורים של פרמטרים ב-SmartDocs.
DEVSOL-1507 לא ניתן להוסיף כמה פרמטרים ל-API באמצעות הוספת שיטה
מעכשיו אפשר להוסיף כמה פרמטרים ל-SmartDocs API כשעורכים את השיטה.
DEVSOL-1509 אין אפשרות לערוך את השדה 'דוגמה' ל-SmartDocs API
עכשיו אפשר להגדיר את 'סוג ה-MIME לגוף', 'תיעוד גוף' ו'דגימת גוף' כשעורכים דף ב-SmartDocs.
DEVSOL-1534 סוג התוכן לא מאוכלס בפלט של SmartDocs
סוג התוכן מאוכלס עכשיו בדף שיטת SmartDocs.
DEVSOL-1554 השוואה בין תאריכים לא חוקית במונטיזציה
בכרטיסייה של התוכנית שנרכשה בפורטלים למפתחים שמופעלת בהם מונטיזציה, הלחצן 'ביטול' מעולם לא הוצג לתוכנית עם תאריך התחלה עתידי.
DEVSOL-1556 הגרסה הישנה של המודולים של Drupal בתהליך שליחה
המודול media_youtube והפיצ'רים עודכן לגרסה האחרונה.
DEVSOL-1558 דפים בשיטת SmartDocs שלא מעובדים לדוגמה מ-PetStore
בהתקנות חדשות, השיטות לדוגמה של SmartDocs PetStore יעברו רינדור עכשיו כראוי.
DEVSOL-1562 יצירת תצוגה לכל מודל SmartDocs
כשיוצרים מודל חדש, נוצרת תצוגה חדשה כברירת מחדל למודל הזה.
DEVSOL-1565 עריכה של שיטת SmartDocs יוצרת שגיאה חמורה
תוקנה בעיה שבה עריכה של שיטת SmartDocs הייתה יוצרת לפעמים שגיאה.
DEVSOL-1567 הצגת האפשרות 'הוספת מודל' בתפריט הניהול העליון
תוקנה הבעיה שפריט התפריט 'הוספת מודל' מוצג בתפריט הניהול העליון.
DEVSOL-1576 בתצוגת מסמכי ה-API מוצג שם המודל, ולא השם המוצג
בדף 'תיעוד API' שמוצג כשלוחצים על 'ממשקי API' בתפריט, הוצג השם הפנימי של המודל במקום השם לתצוגה. אם עדכנת את הגרסה ושינית את התצוגה, עליך לבצע את השלבים הבאים כדי לחזור לגרסה הקודמת כדי לראות את השינויים האלה: # התחברות כמנהל מערכת # מעבר אל 'מבנה' > 'תצוגות' # לוחצים על התפריט הנפתח לצד 'עריכה' ב'דגמים חכמים של Docs' כדי לראות את כל הפעולות. # אם מופיעה האפשרות "חזרה לגרסה הקודמת", החלפתם את הקוד עם השינוי שלכם. יש ללחוץ על 'חזרה' כדי להחזיר את התצוגה למצב ברירת המחדל. הערה: הפעולה הזו תסיר את כל השינויים שביצעתם בתצוגה המפורטת הזו.
DEVSOL-1578 עיבוד מודלים של מזג אוויר ו-Petstore בהתקנות באתר
המודלים החכמים של Petstore ו-Weather SmartDocs מיובאים לאתרים חדשים.
DEVSOL-1584 לא ניתן לרכוש תוכניות
תוקנה בעיה שבה טופס הרכישה של תוכניות מונטיזציה לא נשלח לגרסה בענן 15.05.27.00 ו-15.06.08.00 אם השתמשת בעיצוב הרספונסיבי ל-Apigee או בתת-נושא של העיצוב הרספונסיביות של Apigee.
DEVSOL-1597 לא ניתן לשנות את הגדרות הזמן הקצוב לתפוגה של המפתח
תוקן באג שגרם לכך שהגדרות הזמן הקצוב לתפוגה של חיבור Edge לא הוחלו בצורה תקינה.
DEVSOL-1620

Me, אינדיקטור הסביבה ושדרוגים של מודול התכונות
עדכון אבטחה קריטי למדי לעדכוני המודול והמודול שלי באינדיקטורים ובתכונות של הסביבה. מידע נוסף:

https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator

https://www.drupal.org/project/features

DEVSOL-1648 צריך לוודא שהשדה arg_separator.output הוא '&' כדי למנוע הפסקה של reCAPTCHA
פתרנו בעיה שקשורה לפלטפורמה, שבה היה שימוש ב-Google reCAPTCHA לא תקין.
DEVSOL-1651 העיצוב של Apigee Base נכשל אם המודול Smartdocs לא מופעל
העיצוב של apigee_base לא תלוי יותר בהפעלת המודול SmartDocs.
DEVSOL-1654

עדכון הגרסה של admin_views לצורך זיהוי תיקון אבטחה קריטי
עודכנו המודולים הבאים של התוכן:

  • תצוגות מנהלתיות
  • העברה
  • הפניה
  • Redis
  • צפיות של פעולות בכמות גדולה