אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע
ביום שלישי, 2 ביוני 2015, השקנו גרסת ענן חדשה של פורטל שירותי הפיתוח של Apigee.
אם יש לכם שאלות, אתם יכולים לפנות לתמיכה של Apigee Edge.
רשימה של כל נתוני הגרסה של Apigee Edge מופיעה במאמר נתוני הגרסה של Apigee.
תכונות חדשות
זמינות לכלל המשתמשים (GA) של SmartDocs
התכונה SmartDocs עוברת מגרסת בטא לגרסה שזמינה לכלל המשתמשים (GA). העדכונים והתכונות החדשות כוללים:
- תמיכה ב-Swagger 2.0, כולל ייבוא לפי קובץ או כתובת URL, כולל תמיכה ב: אובייקטים של אבטחה עם שמות מותאמים אישית.
- שיפורים בעיצוב החזותי בתבניות שיוצרות מסמכים חכמים.
- שיפורים בשימושיות ובזרימת העבודה בפורטל למפתחים, שזמינים דרך התפריט Content (תוכן) > SmartDocs ב-Drupal.
- מה שנקרא בעבר אימות באמצעות 'טוקן בהתאמה אישית' נקרא עכשיו 'מפתח API'.
- אובייקטים של אימות (Authentication) ושל אבטחה (Security) שמוגדרים ברמת השינוי.
- הגדרת אימות לקוח ברמת התבנית. בגרסאות חדשות יותר, אי אפשר יותר לאפס את פרטי הכניסה של לקוח SmartDocs שהוגדרו מראש.
לתיאורים נוספים של התכונות, אפשר לעיין בפוסט הזה בבלוג.
מידע נוסף על SmartDocs זמין במאמר שימוש ב-SmartDocs לתיעוד ממשקי API.
תהליך השדרוג של SmartDocs
אם כבר השתמשתם ב-SmartDocs במהלך תקופת הבטא, תכונות ויכולות חדשות בגרסת הזמינות לכלל המשתמשים (GA) דורשות שתשדרגו את SmartDocs בפורטל למפתחים.
כל הדפים של SmartDocs שכבר פורסמו בפורטל למפתחים ימשיכו לפעול, אבל תצטרכו לפעול לפי תהליך העדכון לפני שתערכו או תפרסמו שינויים בדפים קיימים או בדפים חדשים.
חשוב לזכור שאפשר לעבד ולפרסם SmartDocs בפורטל המפתחים, אבל מסמכי SmartDocs נוצרים ממודל ה-API שקיים בשירותי ניהול ה-API של Apigee Edge. כל שינוי שתבצעו במודל API ב-Edge יהיה זהה בכל סביבות Pantheon שלכם (בדומה לאופן שבו מפתחים קיימים בסביבות Pantheon).
כדי לשדרג מגרסת הבטא של SmartDocs לגרסה שזמינה לכלל המשתמשים
- צריך לעדכן ולבדוק את הגרסה 15.05.27 בסביבות הפיתוח או הבדיקה ב-Pantheon.
- יוצרים מודל חדש כדי להחליף מודל API קיים שבו השתמשתם.
- אם ייבאתם מסמכי Swagger או WADL, ייבאו אותם שוב לגרסה חדשה.
- אם אתם מנהלים את מודל ה-API באמצעות מודול SmartDocs, תוכלו לייצא אותו כ-SmartDocs JSON ולייבא אותו למודל החדש באמצעות קובץ מצורף.
- מגדירים את מאפייני האבטחה של הגרסה של המודל. בדף Content >
SmartDocs > model, בוחרים באפשרות Security Settings.
- כדי לבדוק אם יש אימות שהוגדר מראש בדף הגדרות המודל (Content >
SmartDocs), לוחצים על Settings (הגדרות) בעמודה Operations (פעולות).
- צריך לעדכן את כל התבניות המותאמות אישית כדי להשתמש בנכסי CSS ו-JS בגרסה 6, ולבצע שינויים שישקפו שמות אובייקטים חדשים, כמו authSchemes ו-apiSchema. מידע על עדכון תבניות SmartDocs זמין במאמר שימוש ב-SmartDocs לתיעוד ממשקי API.
- מבצעים רינדור מחדש ומפרסמים את הגרסה המתוקנת של המודל.
- אחרי אימות התיעוד החדש, מעדכנים את פורטל הייצור לגרסה 15.05.27.
אם אתם לקוחות של Edge Enterprise ויש לכם שאלות או חששות לגבי תהליך השדרוג, אתם יכולים לשלוח אימייל לכתובות marsh@apigee.com ו-cnovak@apigee.com. אחרת, מומלץ להשתמש בקהילת Apigee כדי לקבל את התשובה הטובה ביותר.
באגים שתוקנו
בגרסה הזו תוקנו הבאגים הבאים.
| מזהה הבעיה | תיאור |
|---|---|
| DEVSOL-487 | אדמינים צריכים להיות מסוגלים להגדיר את פורמט התאריך בדף 'מונטיזציה' עכשיו אפשר להגדיר את פורמט התאריך בדף 'מונטיזציה' בהגדרות המונטיזציה, לפורמטים של תאריכים באירופה ובארה"ב. |
| DEVSOL-603 | הדף 'תוכנית עם חפיפה' לא מעוצב בצורה טובה כשרוכשים תוכנית שחופפת לתוכנית קיימת, הדף שמוצג למשתמש מעוצב עכשיו בצורה טובה. |
| DEVSOL-642 | העברת הגדרות ברמת הלקוח מהגדרות האבטחה להגדרות התבנית |
| DEVSOL-709 | SmartDocs: אי אפשר לערוך פרמטר של תבנית כתובת URL אחרי שליחת בקשה עם ערך ריק הבעיה שגורמת לכך שאי אפשר לערוך את הפרמטרים של התבנית אחרי שליחת הבקשה מ-SmartDocs אחרי מחיקת הפרמטר של התבנית בתיעוד של השיטה נפתרה. |
| DEVSOL-1013 | הפיכת כתובות האימייל של משתמשים בפורטל למפתחים לניתנות לעריכה שדה כתובת האימייל בדף פרופיל עריכה לא יושבת יותר ומפתחים יוכלו לשנות את כתובות האימייל שלהם. |
| DEVSOL-1273 | האפשרות DevConnect Mint מופיעה פעמיים ברשימת המודולים בקטע Modules, האפשרות Dev Connect Mint מוצגת פעמיים. השגיאה תוקנה. |
| DEVSOL-1313 | תמיכה בייבוא של קובץ JSON/YAML או כתובת URL גם עבור Swagger וגם עבור WADL עכשיו אפשר לייבא קובצי WADL באמצעות כתובת URL, ואפשר להעלות קובצי Swagger. |
| DEVSOL-1339 | שינוי המיקומים של תפריט הניהול של SmartDocs האפשרות SmartDocs נמצאת עכשיו בתפריט התוכן, וההגדרות של SmartDocs נמצאות בתפריט הניהול של ההגדרות. |
| DEVSOL-1340 | הסרת גרסת הבטא כשעוברים אל GA SmartDocs נמצא עכשיו בתפריט התוכן, וההגדרות של SmartDocs נמצאות בתפריט הניהול של ההגדרות. |
| DEVSOL-1390 | ספריית ה-SDK Edge ל-PHP עודכנה כדי לפתור את הבעיה שקשורה לקריאה ל-__toString() ספריית ה-SDK Edge ל-PHP עודכנה כדי לפתור את הבעיה שקשורה לקריאה ל-__toString() באובייקט DeveloperRatePlan, שיוצר את השגיאה הבאה: {quote} Fatal error: Call to a member function format() on a non-object in /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php on line 221 {quote} זוהי באג שמשפיע רק על לקוחות של Monetization עם קוד מותאם אישית שקורא לשיטה toString(). |
| DEVSOL-1398 | ייבוא של מודל SmartDocs Petstore במהלך ההתקנה ללא הנחיה למשתמש מערכת SmartDocs מייבאת עכשיו את הדוגמה petstore swagger במהלך התקנת האתר (http://petstore.swagger.io/v2/swagger.json) במקום את מודל מזג האוויר, כדי לספק דוגמה מקיפה יותר לשימוש ב-SmartDocs. |
| DEVSOL-1407 | הפעולה של Cron נכשלת כשיש הרבה מפתחים כשמריצים את Drupal cron, מספר גדול של מפתחים גורם לבעיה של פסק זמן. כשבארגון יש יותר מ-200 משתמשים, נעשה עכשיו שימוש בתהליך אצווה. |
| DEVSOL-1470 | יצירת קישור לתפריט 'ממשקי API' ותצוגה תואמת ב-Dev Portal SmartDocs יש עכשיו כברירת מחדל קישור לתיעוד שעבר עיבוד ב-SmartDocs בתפריט הראשי בשם 'ממשקי API'. הקישור הזה מוביל לכל המודלים עם שיטות שפורסמו. |
בעיות מוכרות
הגרסה הזו כוללת את הבעיות הידועות הבאות:
| מזהה הבעיה | תיאור |
|---|---|
| DEVSOL-1558 |
דפי שיטות לדוגמה של Petstore SmartDocs לא מוצגים בצורה תקינה בהתקנה חדשה
דפי השיטות של Petstore לדוגמה ב-SmartDocs לא מוצגים בצורה תקינה בהתקנה חדשה. כדי לפתור את הבעיה:
הצמתים אמורים להופיע עכשיו בצורה תקינה. |