אתם צופים במסמכי התיעוד של Apigee Edge.
אפשר לעבור אל מסמכי התיעוד של Apigee X. מידע
ביום שלישי, 8 בספטמבר 2015, השקנו גרסה רבעונית של פורטל שירותי הפיתוח של Apigee Edge לענן פרטי.
השם הקודם של המוצר, 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 for Private Cloud release notes.
תכונות חדשות
זמינות כללית של 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-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 | ייבוא של מודל Petstore של SmartDocs במהלך ההתקנה בלי להציג בקשה למשתמש מערכת 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 |
הוספת ווים למודול Devconnect Developer Apps כדי לאפשר שינוי של נתוני הניתוח # 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 | לא רואים אפשרות לערוך את השדה 'דוגמה' של API ב-SmartDocs עכשיו אפשר להגדיר את האפשרויות 'סוג 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 כדי לראות את כל הפעולות. # If you see "revert", then you have overwritten the code w/your own change. לוחצים על 'חזרה' כדי להחזיר את התצוגה למצב ברירת המחדל. שימו לב: הפעולה הזו תגרום להסרת כל השינויים שביצעתם בתצוגה הזו. |
| DEVSOL-1578 | עיבוד של שני המודלים Weather ו-Petstore בהתקנות באתר שני המודלים 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 כדי לפתור בעיית אבטחה קריטית
|