אתם צופים במסמכי התיעוד של Apigee Edge.
אפשר לעבור אל מסמכי התיעוד של Apigee X. מידע
ביום שלישי, 2 ביוני 2015, השקנו גרסת ענן חדשה של פורטל שירותי הפיתוח של Apigee.
אם יש לכם שאלות, אתם יכולים לפנות אל התמיכה של Apigee Edge.
רשימה של כל נתוני הגרסה של Apigee Edge מופיעה במאמר נתוני הגרסה של Apigee.
תכונות חדשות
זמינות כללית של SmartDocs
התכונה SmartDocs יוצאת מגרסת בטא ועוברת לזמינות כללית. העדכונים והתכונות החדשות כוללים:
- תמיכה ב-Swagger 2.0, כולל ייבוא לפי קובץ או כתובת URL, כולל תמיכה ב: אובייקטים של אבטחה עם שמות מותאמים אישית.
- שיפורים בעיצוב הוויזואלי בתבניות שיוצרות מסמכים חכמים.
- שיפורים בשימושיות ובזרימת העבודה בפורטל למפתחים, שזמין דרך התפריט Content (תוכן) > SmartDocs ב-Drupal.
- מה שנקרא בעבר אימות באמצעות 'טוקן מותאם אישית' נקרא עכשיו 'מפתח API'.
- אובייקטים של אימות 'אבטחה' שמוגדרים ברמת הגרסה.
- הגדרת אימות לקוח ברמת התבנית. בגרסאות חדשות יותר, כבר לא מתבצע איפוס של פרטי הכניסה של לקוח SmartDocs שהוגדרו מראש.
לתיאורים נוספים של התכונות, אפשר לעיין בפוסט הזה בבלוג.
מידע נוסף על SmartDocs זמין במאמר שימוש ב-SmartDocs לתיעוד ממשקי API.
תהליך השדרוג של SmartDocs
אם כבר השתמשתם ב-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 (תוכן > SmartDocs > דגם), בוחרים באפשרות Security Settings (הגדרות אבטחה).
- כדי לבדוק אם יש אימות שהוגדר מראש בדף ההגדרות של המודל (Content >
SmartDocs), לוחצים על Settings (הגדרות) בעמודה Operations (פעולות).
- צריך לעדכן את כל התבניות המותאמות אישית כדי להשתמש בגרסה 6 של נכסי ה-CSS וה-JS, ולבצע שינויים שישקפו שמות אובייקטים חדשים, כמו 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} שגיאה חמורה: קריאה לפונקציית חבר format() באובייקט שאינו אובייקט ב-/Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php בשורה 221 {quote} זהו באג שמשפיע רק על לקוחות של Monetization עם קוד מותאם אישית שקורא לשיטה toString(). |
| DEVSOL-1398 | ייבוא של מודל Petstore של SmartDocs במהלך ההתקנה ללא הנחיית המשתמש מערכת 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 לא מוצגים בצורה תקינה בהתקנה חדשה. כדי לפתור את הבעיה:
הצמתים אמורים להופיע עכשיו בצורה תקינה. |