אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע
ביום שלישי, 8 בספטמבר 2015, פרסמנו גרסה רבעונית של פורטל שירותי הפיתוח של Apigee Edge ל-Private Cloud.
השם הקודם של המוצר, Apigee Edge On-premises Developer Services Portal או OPDK, הוא עכשיו Apigee Edge Developer Services Portal for Private Cloud.
אם יש לכם שאלות, אתם יכולים לפנות לתמיכה של Apigee Edge.
רשימה של כל נתוני הגרסה של Apigee Edge מופיעה במאמר נתוני הגרסה של Apigee.
הדרישות של Apigee Edge לפורטל
אם אתם מחברים את הגרסה הזו של הפורטל להתקנה של Edge for Private Cloud, אתם צריכים לחבר אותה לגרסה 4.15.07.00 ואילך כדי לוודא שכל התכונות של SmartDocs נתמכות. מידע נוסף זמין ב4.15.07.00 - הערות המוצר של Apigee Edge לענן פרטי.
תכונות חדשות
זמינות לכלל המשתמשים (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-584 | פרמטר של נתיב לא נשמר בשימוש הראשון פרמטר של נתיב כשמבצעים שיחות לא תמיד נשמר. |
| DEVSOL-603 | הדף 'תוכנית עם חפיפה' לא מעוצב בצורה טובה כשרוכשים תוכנית שחופפת לתוכנית קיימת, הדף שמוצג למשתמש מעוצב עכשיו בצורה טובה. |
| DEVSOL-709 | SmartDocs: אי אפשר לערוך פרמטר של תבנית כתובת URL אחרי שליחת בקשה עם ערך ריק הבעיה שגורמת לכך שאי אפשר לערוך את הפרמטרים של התבנית אחרי שליחת הבקשה מ-SmartDocs אחרי מחיקת הפרמטר של התבנית בתיעוד של השיטה נפתרה. |
| DEVSOL-723 | הצגת הודעות ידידותיות למשתמשים על כשל בייבוא של SmartDocs |
| DEVSOL-1013 | הפיכת כתובות האימייל של משתמשים בפורטל למפתחים לניתנות לעריכה שדה כתובת האימייל בדף פרופיל עריכה לא יושבת יותר ומפתחים יוכלו לשנות את כתובות האימייל שלהם. |
| DEVSOL-1244 | לא מפעילים את המודול Environment Indicator (אינדיקטור סביבה) למהדורות OPDK |
| 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 | הסרת גרסת הבטא כשעוברים לזמינות כללית |
| DEVSOL-1390 |
הספרייה PHP SDK Edge עודכנה כדי לפתור את הבעיה של קריאה ל-__toString() שגיאה חמורה: קריאה לפונקציית חבר format() באובייקט שאינו אובייקט בכתובת /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php בשורה 221 זוהי באג שמשפיעה רק על לקוחות של מוצרים למונטיזציה עם קוד מותאם אישית שקורא לשיטה toString(). |
| DEVSOL-1398 | מודל SmartDocs Petstore מיובא במהלך ההתקנה בלי להציג למשתמש הנחיות מודל SmartDocs מייבא עכשיו את דוגמת petstore swagger במהלך התקנת האתר (http://petstore.swagger.io/v2/swagger.json) במקום את מודל מזג האוויר, כדי לספק דוגמה מקיפה יותר לשימוש ב-SmartDocs. |
| DEVSOL-1407 | הפעולה Cron נכשלת כשיש הרבה מפתחים כשמריצים את Drupal cron, מספר גדול של מפתחים גורם לבעיית חריגה מזמן קצוב. כשבארגון יש יותר מ-200 משתמשים, נעשה עכשיו שימוש בתהליך אצווה. |
| DEVSOL-1410 | שגיאות חיבור לא מופיעות כשמתקינים את Dev Portal הוספנו הודעות שגיאה טובות יותר למתקין כשחיבור הניהול של Edge לא פועל, כדי לצמצם את הבעיות שדורשות פתרון. |
| DEVSOL-1422 | הסרנו את טופס ההגדרה של SMTP מפרופיל Apigee במהלך ההתקנה לא תישאלו יותר אם אתם רוצים להגדיר SMTP. במקום זאת, תוכלו לעשות זאת אחרי שההתקנה תושלם, בהתאם לשיטה הסטנדרטית של Drupal להפעלת מודול ה-SMTP ולהגדרתו בצורה נכונה. |
| DEVSOL-1427 |
הוספת hooks למודול Devconnect Developer Apps כדי לאפשר שינוי של נתוני Analytics # hook_devconnect_developer_apps_analytics_chart_data_alter() # hook_devconnect_developer_app_analytics_datapoints_params_alter() # hook_devconnect_developer_app_analytics_datapoints_alter() ההגדרות האלה מאפשרות למודולים בהתאמה אישית לשנות את התרשים של ניתוח של נתוני אפליקציות למפתחים. |
| DEVSOL-1464 | שגיאה חמורה בשמירת הגדרות אימות של מודל כשמוחקים תוכנית אבטחה, מוצגת עכשיו תיבת סימון שמאפשרת לבחור אם צריך למחוק גם את תוכנית האימות של התבנית המשויכת. |
| DEVSOL-1470 | יצירת קישור לתפריט 'ממשקי API' ותצוגה תואמת ב-Dev Portal SmartDocs יש עכשיו כברירת מחדל קישור לתיעוד שעבר עיבוד ב-SmartDocs בתפריט הראשי בשם 'ממשקי API'. הקישור הזה מוביל לכל המודלים עם שיטות שפורסמו. |
| DEVSOL-1486 | אפשר לאמת קריאות ל-SmartDocs באמצעות מפתח מוגדר מראש מאפשר אימות באמצעות מפתחות API שסופקו מראש ומפתחות API שסופקו על ידי המשתמש. |
| DEVSOL-1499 | קוד HTML לא מנותח בתיאורי פרמטרים של SmartDocs קוד HTML מנותח עכשיו בתיאורי פרמטרים של SmartDocs. |
| DEVSOL-1507 | אי אפשר להוסיף כמה פרמטרים ל-API באמצעות Add Method עכשיו אפשר להוסיף כמה פרמטרים ל-SmartDocs API כשעורכים את השיטה. |
| DEVSOL-1509 | לא רואים אפשרות לערוך את השדה 'דוגמה' עבור SmartDocs API עכשיו אפשר להגדיר את האפשרויות 'סוג MIME של גוף הבקשה', 'תיעוד גוף הבקשה' ו'דוגמה לגוף הבקשה' כשעורכים דף SmartDocs. |
| DEVSOL-1534 | השדה Content-type לא מאוכלס בפלט של SmartDocs השדה Content-type מאוכלס עכשיו בדף השיטה של SmartDocs. |
| DEVSOL-1554 | השוואת תאריכים לא תקינה במונטיזציה בכרטיסייה 'תוכנית שנרכשה' בפורטלים למפתחים שמופעלת בהם מונטיזציה, הלחצן 'ביטול' לא הוצג אף פעם לתוכנית עם תאריך התחלה עתידי, |
| DEVSOL-1556 | גרסה ישנה של מודולים של Drupal נשלחת המודולים media_youtube ו-features עודכנו לגרסה האחרונה. |
| DEVSOL-1558 | דפי שיטות של SmartDocs לא מוצגים בדוגמה של PetStore בהתקנות חדשות, השיטות של SmartDocs PetStore מוצגות עכשיו בצורה תקינה. |
| DEVSOL-1562 | יצירת תצוגה לכל מודל SmartDocs כשיוצרים מודל חדש, נוצרת לו תצוגה חדשה כברירת מחדל. |
| DEVSOL-1565 | עריכת שיטה ב-SmartDocs יוצרת שגיאה חמורה תוקנה הבעיה שבה עריכת שיטה ב-SmartDocs יצרה לפעמים שגיאה. |
| DEVSOL-1567 | האפשרות 'הוספת מודל' מוצגת בתפריט האדמין העליון תוקנה הבעיה שפריט התפריט 'הוספת מודל' מוצג בתפריט האדמין העליון. |
| DEVSOL-1576 | בתצוגה של תיעוד ה-API מוצג שם המודל ולא השם המוצג בדף תיעוד ה-API שמוצג כשלוחצים על 'ממשקי API' בתפריט, הוצג השם הפנימי של המודל במקום השם המוצג. אם אתם מעדכנים לגרסה הזו ושיניתם את התצוגה הזו, תצטרכו להחזיר את התצוגה כדי לראות את השינויים האלה. לשם כך: # מתחברים בתור אדמין # עוברים אל Structure > Views # לוחצים על התפריט הנפתח לצד Edit ב-SmartDocs Models כדי לראות את כל הפעולות. # אם מופיעה האפשרות 'revert', סימן שהחלפת את הקוד בשינוי משלך. לוחצים על 'חזרה' כדי להחזיר את התצוגה למצב ברירת המחדל. שימו לב: הפעולה הזו תסיר את כל השינויים שביצעתם בתצוגה הזו. |
| DEVSOL-1578 | עיבוד של מודלים של מזג אוויר ושל חנות חיות בהתקנות באתר שני המודלים של Petstore ו-Weather SmartDocs מיובאים לאתרים חדשים. |
| DEVSOL-1584 | אי אפשר לרכוש תוכניות תוקנה בעיה שבה טופס הרכישה של תוכניות המונטיזציה לא נשלח לגרסת הענן 15.05.27.00 ו-15.06.08.00 אם השתמשתם בערכת הנושא Apigee Responsive או בערכת נושא משנית של ערכת הנושא Apigee Responsive. |
| DEVSOL-1597 | אי אפשר לשנות את הגדרות הזמן הקצוב לתפוגה של מפתחים תוקן באג שבו הגדרות הזמן הקצוב לתפוגה של חיבור Edge לא הוחלו כמו שצריך. |
| DEVSOL-1620 |
שדרוגים של המודול 'הדף שלי', של מחוון הסביבה ושל מודול התכונות https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | כדי למנוע בעיות ב-reCAPTCHA, צריך לוודא שהערך של arg_separator.output הוא '&' תוקנה בעיה שקשורה לפלטפורמה, שגרמה לשיבוש השימוש ב-Google reCAPTCHA. |
| DEVSOL-1651 | העיצוב הבסיסי של Apigee נכשל אם מודול SmartDocs לא מופעל העיצוב הבסיסי של Apigee כבר לא תלוי בהפעלה של מודול SmartDocs. |
| DEVSOL-1654 |
הועלתה גרסה של admin_views כדי לכלול תיקון אבטחה קריטי
|