כרגע מוצג התיעוד של 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 לזמינות כללית
- מעדכנים ובודקים את הגרסה של 15.05.27 בסביבות dev או test ב-Pantheon.
- יצירת מודל חדש שיחליף את כל מודל ה-API הקיים שבו השתמשת.
- אם ייבאת מסמכי Swagger או WADL, עליך לייבא אותם שוב לגרסה קודמת חדשה.
- אם עדכנת את מודל ה-API באמצעות המודול SmartDocs, עליך לייצא אותו כקובץ SmartDocs JSON ולייבא אותו למודל החדש באמצעות קובץ מצורף.
- הגדרת מאפייני האבטחה של הגרסה הקודמת של המודל. בדף תוכן > SmartDocs > מודל, בוחרים באפשרות הגדרות אבטחה.
- כדי לבדוק אימות שהוגדר מראש בדף הגדרות המודל (תוכן > SmartDocs), לוחצים על הגדרות בעמודה 'פעולות'.
- צריך לעדכן את התבניות המותאמות אישית כדי להשתמש בגרסה 6 של נכסי ה-CSS וה-JS, ולבצע שינויים כך שישקפו שמות של אובייקטים חדשים, כמו authSchemes ו-apiSchema. למידע על עדכון תבניות SmartDocs, אפשר לקרוא את המאמר שימוש ב-SmartDocs לממשקי API למסמכים.
- עבד מחדש ופרסם את גרסת המודל שלך.
- אחרי אימות המסמכים החדשים, צריך לעדכן את פורטל 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 לא מוצגים כמו שצריך בהתקנה חדשה. כדי לפתור את הבעיה:
עכשיו הצמתים אמורים להופיע כמו שצריך. |