אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info
ביום שלישי, 8 בספטמבר 2015, השקנו גרסה רבעונית של פורטל שירותי הפיתוח של Apigee Edge לענן פרטי.
שם המוצר הקודם, 'Apigee Edge On-premises Developer Services Portal' או 'OPDK', הוא עכשיו 'Apigee Edge Developer Services Portal for Private Cloud'.
אם יש לכם שאלות, אתם יכולים להיכנס אל תמיכת הלקוחות של Apigee.
רשימה של כל נתוני הגרסה של Apigee Edge מופיעה במאמר נתוני הגרסה של Apigee.
הדרישות של Apigee Edge לפורטל
אם אתם מחברים את הגרסה הזו של הפורטל להתקנה של Edge for Private Cloud, עליכם לחבר אותה לגרסה 4.15.07.00 ואילך כדי להבטיח שתהיה תמיכה בכל התכונות של SmartDocs. מידע נוסף זמין במאמר 4.15.07.00 – הערות המוצר של Apigee Edge לענן פרטי.
תכונות חדשות
זמינות כללית של 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-584 | פרמטר הנתיב לא נשמר בשימוש הראשון פרמטר הנתיב בזמן ביצוע שיחות לא תמיד נשמר. |
| DEVSOL-603 | הפורמט של הדף 'תוכנית עם חפיפה' לא טוב כשקונים תוכנית שחופפת לתוכנית קיימת, הדף שמוצג למשתמשים מעוצב עכשיו בצורה נעימה. |
| DEVSOL-709 | SmartDocs: URL template parameter not editable after sending request with empty
value תוקנה הבעיה שבה לא ניתן לערוך את פרמטר התבנית אחרי שליחת הבקשה מ-SmartDocs, אחרי שמוחקים את פרמטר התבנית במסמכי התיעוד של השיטה. |
| DEVSOL-723 | הצגת הודעות ידידותיות למשתמש במקרה של כשל בייבוא של SmartDocs |
| DEVSOL-1013 | אפשרות לערוך את כתובות האימייל של משתמשים ב-Dev Portal שדה כתובת האימייל בדף העריכה של הפרופיל לא יושבת יותר, ומפתחים יכולים לשנות את כתובות האימייל שלהם. |
| DEVSOL-1244 | לא מפעילים את המודול של מדדי הסביבה במהדורות של OPDK |
| 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 |
| 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 נכשלת כשיש הרבה מפתחים כשמריצים את cron של Drupal, כמות גדולה של מפתחים עלולה לגרום לבעיה של זמן קצוב לתפוגה. אם בארגון יש יותר מ-200 משתמשים, המערכת משתמשת עכשיו בתהליך באצווה. |
| DEVSOL-1410 | שגיאות חיבור לא מופיעות בהתקנת Dev Portal כדי למזער בעיות בפתרון בעיות, הוספנו הודעות שגיאה טובות יותר למתקין כשהחיבור לניהול Edge לא פועל. |
| DEVSOL-1422 | הסרת הטופס להגדרת SMTP מהפרופיל ב-Apigee בתהליך ההתקנה לא תופיע יותר השאלה אם רוצים להגדיר SMTP. במקום זאת, אפשר להגדיר את ה-SMTP אחרי השלמת ההתקנה לפי השיטות הרגילות ב-Drupal להפעלת המודול של ה-SMTP ולהגדרתו בצורה נכונה. |
| DEVSOL-1427 |
הוספת וו hooks למודול 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 | יצירת קישור לתפריט 'APIs' והתצוגה התואמת התכונה SmartDocs ב-Dev Portal כוללת עכשיו כברירת מחדל קישור לתיעוד המנוהל של SmartDocs בתפריט הראשי 'APIs', שמקשר לכל המודלים עם השיטות שפורסמו. |
| DEVSOL-1486 | קריאות SmartDocs יכולות לבצע אימות באמצעות מפתח מוגדר מראש מאפשרת לבצע אימות באמצעות מפתחות API שסופקו מראש וגם מפתחות API שסופקו על ידי משתמשים. |
| DEVSOL-1499 | קוד HTML לא עבר ניתוח בתיאורי הפרמטרים של SmartDocs קוד HTML עובר עכשיו ניתוח בתיאורי הפרמטרים של SmartDocs. |
| DEVSOL-1507 | לא ניתן להוסיף כמה פרמטרים ל-API באמצעות Add Method עכשיו אפשר להוסיף כמה פרמטרים ל-SmartDocs API בזמן עריכת השיטה. |
| DEVSOL-1509 | לא מוצאים דרך לערוך את השדה 'sample' ב-SmartDocs API עכשיו אפשר להגדיר את 'Body MIME type', 'Body documentation' ו-'Body sample' כשעורכים דף SmartDocs. |
| DEVSOL-1534 | הסוג 'סוג תוכן' לא מאוכלס בפלט של SmartDocs הסוג 'סוג תוכן' מאוכלס עכשיו בדף השיטה של SmartDocs. |
| DEVSOL-1554 | השוואת תאריכים לא חוקית ב'מונטיזציה' בכרטיסייה של התוכנית שנרכשה בפורטלים של מפתחים שמופעלת בהם מונטיזציה, הלחצן 'ביטול' מעולם לא הופיע בתוכנית עם תאריך התחלה עתידי, |
| DEVSOL-1556 | גרסה ישנה של מודולים של Drupal נשלחת המודול media_youtube והמודול features עודכנו לגרסה האחרונה. |
| DEVSOL-1558 | דפי שיטות של SmartDocs לא מוצגים בדוגמה של PetStore בהתקנות חדשות, שיטות הדוגמה של SmartDocs PetStore מוצגות עכשיו בצורה תקינה. |
| DEVSOL-1562 | יצירת תצוגה לכל מודל של SmartDocs כשיוצרים מודל חדש, נוצרת כברירת מחדל תצוגה חדשה למודל הזה. |
| DEVSOL-1565 | עריכה של שיטת SmartDocs יוצרת שגיאה מסוג Fatal תוקנה בעיה שבה עריכה של שיטת SmartDocs יוצרת לפעמים שגיאה. |
| DEVSOL-1567 | האפשרות 'הוספת מודל' מוצגת בתפריט האדמין העליון תוקנה הבעיה שבה פריט התפריט 'הוספת מודל' מוצג בתפריט האדמין העליון. |
| DEVSOL-1576 | בתצוגת מסמכי התיעוד של ה-API מוצג שם המודל, ולא השם המוצג בדף מסמכי התיעוד של ה-API שמוצג כשלוחצים על 'APIs' בתפריט, הופיע השם הפנימי של המודל במקום השם המוצג. אם אתם מעדכנים לגרסה הזו ושינו את התצוגה, תצטרכו להחזיר את התצוגה כדי לראות את השינויים. לשם כך, פועלים לפי השלבים הבאים: # מתחברים כאדמינים # עוברים אל 'מבנה' > 'תצוגות' # לוחצים על התפריט הנפתח לצד 'עריכה' בקטע 'מודלים של SmartDocs' כדי לראות את כל הפעולות. # אם מופיע 'החזרה למצב הקודם', סימן שהחלפתם את הקוד בשינוי שלכם. לוחצים על 'חזרה למצב הקודם' כדי להחזיר את התצוגה למצב ברירת המחדל. חשוב לזכור שהפעולה הזו תגרום להסרה של כל השינויים שביצעתם בתצוגה הזו. |
| DEVSOL-1578 | עיבוד של המודלים של Petstore ושל Weather בהתקנות של אתרים מודלים של SmartDocs של Petstore ושל Weather מיובאים לאתרים חדשים. |
| 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_base לא תלוי יותר בהפעלה של מודול SmartDocs. |
| DEVSOL-1654 |
שדרוג הגרסה של admin_views כדי לכלול תיקון אבטחה קריטי
|