אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info
ביום שלישי, 2 ביוני 2015, השקנו גרסה חדשה בענן של פורטל השירותים למפתחים של Apigee.
אם יש לכם שאלות, אתם יכולים להיכנס אל תמיכת הלקוחות של Apigee.
רשימה של כל נתוני הגרסה של Apigee Edge מופיעה במאמר נתוני הגרסה של Apigee.
תכונות חדשות
זמינות כללית של SmartDocs
SmartDocs עובר מגרסת בטא לזמינות לכולם. העדכונים והתכונות החדשות כוללים:
- תמיכה ב-Swagger 2.0, כולל ייבוא באמצעות קובץ או כתובת URL, כולל תמיכה באובייקטי אבטחה עם שמות מותאמים אישית.
- שיפורים בעיצוב החזותי של התבניות שמשמשות ליצירת מסמכי SmartDocs.
- שיפורים בממשק המשתמש ובתהליך העבודה בפורטל למפתחים, שזמינים דרך התפריט 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 ובודקים אותה בסביבות dev או test ב-Pantheon.
- יוצרים מודל חדש שיחליף כל מודל API קיים שבו השתמשתם.
- אם מייבאים מסמכי Swagger או WADL, צריך לייבא אותם שוב לגרסה חדשה.
- אם טיפלתם במודל ה-API דרך המודול SmartDocs, תוכלו לייצא אותו כ-JSON של SmartDocs ולייבא אותו למודל החדש באמצעות צירוף קובץ.
- מגדירים את מאפייני האבטחה של הגרסה של המודל. בדף תוכן >
מסמכים חכמים > דגם, בוחרים באפשרות הגדרות אבטחה.
- בדף ההגדרות של המודל (תוכן >
SmartDocs), לוחצים על הגדרות בעמודה Operations (פעולות).
- מעדכנים את התבניות בהתאמה אישית כך שישתמשו בגרסה 6 של נכסי ה-CSS וה-JS, ומבצעים שינויים כך שישקפו את שמות האובייקטים החדשים, כמו authSchemes ו-apiSchema. מידע נוסף על עדכון תבניות של SmartDocs זמין במאמר שימוש ב-SmartDocs לתיעוד ממשקי API.
- מבצעים עיבוד מחדש (re-render) של הגרסה המתוקנת של המודל ומפרסמים אותה.
- אחרי שתאמתו את המסמכים החדשים, עליכם לעדכן את הפורטל של ייצור לגרסה 15.05.27.
לקוחות Edge Enterprise שיש להם שאלות או חששות לגבי תהליך השדרוג יכולים לשלוח אימייל לכתובות marsh@apigee.com ו-cnovak@apigee.com. לחלופין, אפשר להיעזר בקהילת Apigee כדי לקבל את התשובה הטובה ביותר.
באגים שתוקנו
בגרסה הזו תוקנו הבאגים הבאים.
| מזהה הבעיה | תיאור |
|---|---|
| DEVSOL-487 | אדמינים יכולים להגדיר את פורמט היום ב'מונטיזציה' עכשיו אפשר להגדיר את פורמט התאריך ב'מונטיזציה' בקטע 'הגדרות מונטיזציה', עבור פורמטים של תאריכים באירופה ובארה"ב. |
| DEVSOL-603 | הפורמט של הדף 'תוכנית עם חפיפה' לא טוב כשקונים תוכנית שחופפת לתוכנית קיימת, הדף שמוצג למשתמשים מעוצב עכשיו בצורה נעימה. |
| DEVSOL-642 | העברת הגדרות ברמת הלקוח מהגדרות האבטחה להגדרות התבנית |
| DEVSOL-709 | SmartDocs: URL template parameter not editable after sending request with empty
value תוקנה הבעיה שבה לא ניתן לערוך את פרמטר התבנית אחרי שליחת הבקשה מ-SmartDocs, אחרי שמוחקים את פרמטר התבנית במסמכי התיעוד של השיטה. |
| DEVSOL-1013 | אפשרות לערוך את כתובות האימייל של משתמשים ב-Dev Portal שדה כתובת האימייל בדף העריכה של הפרופיל לא יושבת יותר, ומפתחים יכולים לשנות את כתובות האימייל שלהם. |
| DEVSOL-1273 | המודול DevConnect Mint מופיע פעמיים ברשימת המודולים בקטע 'מודולים', המודול 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 | ספריית PHP SDK Edge עודכנה כדי לפתור את הבעיה של הקריאה ל-__toString() הספרייה PHP SDK Edge עודכנה כדי לפתור את הבעיה של הקריאה ל-__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} מדובר בבאג שמשפיע רק על לקוחות מונטיזציה עם קוד מותאם אישית שמפעיל את השיטה toString(). |
| DEVSOL-1398 | המודל של SmartDocs Petstore מיובא במהלך ההתקנה בלי להציג בקשה למשתמש SmartDocs מייבא עכשיו את הדוגמה של petstore swagger במהלך התקנת האתר (http://petstore.swagger.io/v2/swagger.json) במקום את מודל מזג האוויר, כדי לספק דוגמה מקיפה יותר לשימוש ב-SmartDocs. |
| DEVSOL-1407 | Cron נכשל כשיש הרבה מפתחים כשמריצים את cron של Drupal, מספר גדול של מפתחים גרם לבעיה של זמן קצוב לתפוגה. אם בארגון יש יותר מ-200 משתמשים, המערכת משתמשת עכשיו בתהליך באצווה. |
| DEVSOL-1470 | יצירת קישור לתפריט 'APIs' והתצוגה התואמת התכונה SmartDocs ב-Dev Portal כוללת עכשיו כברירת מחדל קישור לתיעוד המנוהל של SmartDocs בתפריט הראשי 'APIs', שמקשר לכל המודלים עם השיטות שפורסמו. |
בעיות מוכרות
בגרסה הזו יש את הבעיות הידועות הבאות:
| מזהה הבעיה | תיאור |
|---|---|
| DEVSOL-1558 |
דפי שיטות של SmartDocs לדוגמה של Petstore לא עוברים עיבוד בצורה נכונה בהתקנה חדשה
דפי הדוגמה של שיטות Petstore ב-SmartDocs לא מוצגים כראוי בהתקנה חדשה. כדי לפתור את הבעיה:
הצמתים אמורים להופיע עכשיו בצורה תקינה. |