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

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

ביום שלישי, 2 ביוני 2015, פרסמנו גרסת ענן חדשה של Apigee Developer Services Portal.

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

בנתוני הגרסה של Apigee תוכלו למצוא רשימה של כל נתוני הגרסה של 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-603 הדף של תוכנית ההתנגשות בפורמט לא תקין
כשרוכשים תוכנית שחופפת לתוכנית קיימת, הפורמט של הדף שמוצג מתאים למשתמש.
DEVSOL-642 העברת הגדרות ברמת הלקוח מהגדרות האבטחה להגדרות התבנית
DEVSOL-709 SmartDocs: לא ניתן לערוך את הפרמטר של תבנית כתובת ה-URL אחרי שליחת בקשה עם ערך ריק
תוקנה הבעיה שבגללה המערכת לא יכולה לערוך את הפרמטרים של התבנית אחרי שליחת הבקשה מ-SmartDocs אחרי מחיקת הפרמטר של התבנית במסמכי השיטה.
DEVSOL-1013 מגדירים את כתובות האימייל של המשתמשים בפורטל הפיתוח כניתנות לעריכה
השדה של כתובת האימייל בדף עריכת הפרופיל לא יושבת יותר והמפתחים יוכלו לשנות את כתובות האימייל שלהם.
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
הכלי SmartDocs זמין עכשיו בתפריט התוכן, וההגדרות של Smartdocs נמצאות בתפריט האדמין של ההגדרות.
DEVSOL-1390 הספרייה הזו של PHP SDK Edge Edge עודכנה כדי לתקן את הבעיה של קריאה ל- __toString()
ספריית PHP SDK SDK Edge עודכנה כדי לתקן את הבעיה של קריאה ל- __toString() באובייקט DeveloperRatePlan, שיוצרת את השגיאה הזו: {quote} שגיאה חמורה: Call to a member function format() ב-non-object ב- /Applications/MAMP/htdocs/ordapiges?
DEVSOL-1398 מודל של SmartDocs Petstore שמיובא בהתקנה ללא הנחיות למשתמש
SmartDocs מייבא עכשיו את הדוגמה של petstore.swagger.io/v2/swagger.json כדי לקבל דוגמה מקיפה יותר לשימוש ב-SmartDocs.
DEVSOL-1407 ה-Cron נכשל כשיש הרבה מפתחים
במהלך הפעלת cron של Drupal, מספר גדול של מפתחים גרם לבעיה של זמן קצוב לתפוגה. כשיש יותר מ-200 משתמשים בארגון, נעשה עכשיו שימוש בתהליך באצווה.
DEVSOL-1470 יצירת קישור לתפריט "ממשקי API" ותצוגה תואמת
פורטל המפתחים של SmartDocs כולל עכשיו כברירת מחדל קישור אל המסמכים שעובדו ב-SmartDocs בתפריט הראשי בשם 'ממשקי API'. קישור זה מקשר לכל המודלים שהשיטות שלהם פורסמו.

בעיות ידועות

הגרסה הזו כוללת את הבעיות המוכרות הבאות:

מזהה הבעיה התיאור
DEVSOL-1558
דפים של שיטת SmartDocs לדוגמה ב-Petstore לא מעובדים כראוי בהתקנה חדשה
דפי השיטה לדוגמה של Petstore ב-SmartDocs לא מוצגים כמו שצריך בהתקנה חדשה. כדי לפתור את הבעיה:
  1. בתפריט Drupal, בוחרים באפשרות תוכן > SmartDocs.
  2. בוחרים במודל 'דוגמה ל-Petstore'.
  3. בקטע עדכון אפשרויות, בוחרים באפשרות עיבוד ופרסום של צמתים.
  4. לוחצים על תיבת הסימון Select / Unselect all כדי לבחור את כל הצמתים.
  5. לוחצים על עדכון.

עכשיו הצמתים אמורים להופיע כמו שצריך.