คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่
เอกสารประกอบของ Apigee X info
เมื่อวันอังคารที่ 8 กันยายน 2015 เราได้เปิดตัวพอร์ทัลบริการสำหรับนักพัฒนาแอป Apigee Edge สำหรับ Private Cloud เวอร์ชันรายไตรมาส
ชื่อผลิตภัณฑ์เดิม "พอร์ทัลบริการสำหรับนักพัฒนาแอป Apigee Edge ภายในองค์กร" หรือ "OPDK" เปลี่ยนเป็น "พอร์ทัลบริการสำหรับนักพัฒนาแอป Apigee Edge สำหรับ Private Cloud" แล้ว
หากมีคำถาม โปรดติดต่อทีมสนับสนุนของ Apigee Edge
ดูรายการบันทึกประจำรุ่นทั้งหมดของ Apigee Edge ได้ที่ บันทึกประจำรุ่นของ Apigee
ข้อกำหนดของ Apigee Edge สำหรับพอร์ทัล
หากคุณเชื่อมต่อพอร์ทัลเวอร์ชันนี้กับการติดตั้ง Edge สำหรับ Private Cloud คุณต้องเชื่อมต่อกับเวอร์ชัน 4.15.07.00 ขึ้นไปเพื่อให้แน่ใจว่าระบบรองรับฟีเจอร์ SmartDocs ทั้งหมด ดูข้อมูลเพิ่มเติมได้ที่ 4.15.07.00 - Apigee Edge บันทึกประจำรุ่นสำหรับ Private Cloud
ฟีเจอร์ใหม่
SmartDocs พร้อมให้บริการเวอร์ชันสำหรับผู้ใช้ทั่วไปแล้ว
SmartDocs เปลี่ยนจากเวอร์ชันเบต้าเป็นเวอร์ชันสำหรับผู้ใช้ทั่วไปแล้ว การอัปเดตและฟีเจอร์ใหม่ มีดังนี้
- รองรับ Swagger 2.0 รวมถึงการนำเข้าด้วยไฟล์หรือ URL และรองรับออบเจ็กต์ความปลอดภัยที่มีชื่อที่กำหนดเอง
- ปรับปรุงการออกแบบภาพในเทมเพลตที่สร้าง SmartDocs
- ปรับปรุงการใช้งานและเวิร์กโฟลว์ในพอร์ทัลสำหรับนักพัฒนาแอป ซึ่งเข้าถึงได้ผ่านเมนูเนื้อหา > SmartDocs ใน Drupal
- การตรวจสอบสิทธิ์ที่เคยเรียกว่า "โทเค็นที่กำหนดเอง" เปลี่ยนชื่อเป็น "คีย์ API" แล้ว
- ออบเจ็กต์ "ความปลอดภัย" ในการตรวจสอบสิทธิ์ที่กำหนดไว้ที่ระดับการแก้ไข
- การกำหนดค่าการตรวจสอบสิทธิ์ไคลเอ็นต์ที่ระดับเทมเพลต การแก้ไขใหม่จะไม่รีเซ็ต ข้อมูลเข้าสู่ระบบไคลเอ็นต์ SmartDocs ที่กำหนดค่าไว้ล่วงหน้าอีกต่อไป
ดูคำอธิบายฟีเจอร์เพิ่มเติมได้ในบล็อก โพสต์นี้
ดูเอกสารประกอบของ SmartDocs ได้ที่ การใช้ SmartDocs เพื่อจัดทำเอกสารประกอบของ API
กระบวนการอัปเกรด SmartDocs
หากคุณใช้ 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 ให้ส่งออกเป็น SmartDocs JSON แล้วนำเข้าไปยังโมเดลใหม่โดยใช้ไฟล์แนบ
- ตั้งค่าพร็อพเพอร์ตี้ความปลอดภัยของการแก้ไขโมเดล ในหน้าเนื้อหา >
SmartDocs > โมเดล ให้เลือกการตั้งค่าความปลอดภัย

- ตรวจสอบการตรวจสอบสิทธิ์ที่กำหนดค่าไว้ล่วงหน้าในการตั้งค่าโมเดล (เนื้อหา >
SmartDocs) โดยคลิกการตั้งค่า ในคอลัมน์การดำเนินการ

- อัปเดตเทมเพลตที่กำหนดเองเพื่อใช้ชิ้นงาน CSS และ JS เวอร์ชัน 6 และทำการเปลี่ยนแปลงเพื่อให้แสดง ชื่อออบเจ็กต์ใหม่ เช่น authSchemes และ apiSchema ดูข้อมูลเกี่ยวกับการอัปเดตเทมเพลต SmartDocs ได้ที่ การใช้ SmartDocs เพื่อจัดทำเอกสารประกอบของ API
- แสดงผลและเผยแพร่การแก้ไขโมเดลอีกครั้ง
- หลังจากตรวจสอบเอกสารประกอบใหม่แล้ว ให้อัปเดตพอร์ทัลเวอร์ชันที่ใช้งานจริง เป็นเวอร์ชัน 15.05.27
หากคุณเป็นลูกค้าองค์กรของ Edge และมีคำถามหรือข้อกังวลเกี่ยวกับกระบวนการอัปเกรด โปรดส่งอีเมลไปที่ 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 | อย่าเปิดใช้โมดูลตัวบ่งชี้สภาพแวดล้อมสำหรับเวอร์ชัน OPDK |
| DEVSOL-1273 | "DevConnect Mint" ปรากฏ 2 ครั้งในรายการโมดูล "DevConnect Mint" ปรากฏ 2 ครั้งในส่วนโมดูล ซึ่งตอนนี้ได้รับการแก้ไขแล้ว |
| DEVSOL-1313 | รองรับการนำเข้าไฟล์ JSON/YAML หรือ URL สำหรับทั้ง Swagger และ WADL ตอนนี้คุณนำเข้าไฟล์ WADL ผ่าน URL และอัปโหลดไฟล์ Swagger ได้แล้ว |
| DEVSOL-1339 | เปลี่ยนตำแหน่งเมนูผู้ดูแลระบบ SmartDocs ตอนนี้ SmartDocs อยู่ในเมนูเนื้อหา และการตั้งค่า SmartDocs อยู่ใน เมนูผู้ดูแลระบบการตั้งค่า |
| DEVSOL-1340 | นำเวอร์ชันเบต้าออกเมื่อเปลี่ยนเป็นเวอร์ชันสำหรับผู้ใช้ทั่วไป |
| DEVSOL-1390 |
อัปเดตไลบรารี PHP SDK Edge เพื่อแก้ไขปัญหาการเรียก
__toString() 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 นี่เป็นข้อบกพร่องที่มีผลเฉพาะลูกค้าของระบบสร้างรายได้ที่มีโค้ดที่กำหนดเองซึ่งเรียกใช้เมธอด toString() |
| DEVSOL-1398 | ระบบนำเข้าโมเดล SmartDocs Petstore เมื่อติดตั้งโดยไม่ต้องแจ้งให้ผู้ใช้ทราบ ตอนนี้ SmartDocs จะนำเข้าตัวอย่าง Swagger ของ Petstore ระหว่างการติดตั้งเว็บไซต์ (http://petstore.swagger.io/v2/swagger.json) แทนโมเดลสภาพอากาศเพื่อให้มีตัวอย่างการใช้ SmartDocs ที่ครอบคลุมมากขึ้น |
| DEVSOL-1407 | Cron ทำงานไม่สำเร็จเมื่อมีนักพัฒนาแอปจำนวนมาก เมื่อเรียกใช้ Drupal cron นักพัฒนาแอปจำนวนมากจะทำให้เกิดปัญหาการหมดเวลา เมื่อองค์กรมีผู้ใช้มากกว่า 200 คน ระบบจะใช้กระบวนการแบบกลุ่ม |
| DEVSOL-1410 | ข้อผิดพลาดในการเชื่อมต่อไม่ชัดเจนเมื่อติดตั้งพอร์ทัลสำหรับนักพัฒนาแอป เพิ่มข้อความแสดงข้อผิดพลาดที่ดีขึ้นลงในโปรแกรมติดตั้งเมื่อการเชื่อมต่อการจัดการ 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" และมุมมองที่เกี่ยวข้อง ตอนนี้ SmartDocs ของพอร์ทัลสำหรับนักพัฒนาแอปมาพร้อมกับลิงก์ไปยังเอกสารประกอบที่แสดงผลของ SmartDocs ในเมนูหลักที่ชื่อว่า "API" ซึ่งลิงก์ไปยังโมเดลที่มีเมธอดที่เผยแพร่ |
| DEVSOL-1486 | การเรียก SmartDocs สามารถตรวจสอบสิทธิ์ด้วยคีย์ที่กำหนดไว้ล่วงหน้า เปิดใช้การตรวจสอบสิทธิ์ด้วยคีย์ API ที่ให้ไว้ล่วงหน้าและคีย์ API ที่ผู้ใช้ให้ไว้ |
| DEVSOL-1499 | ระบบไม่แยกวิเคราะห์โค้ด HTML ในคำอธิบายพารามิเตอร์ SmartDocs ตอนนี้ระบบแยกวิเคราะห์โค้ด HTML ในคำอธิบายพารามิเตอร์ SmartDocs แล้ว |
| DEVSOL-1507 | เพิ่มพารามิเตอร์หลายรายการลงใน API ด้วย "เพิ่มเมธอด" ไม่ได้ ตอนนี้คุณเพิ่มพารามิเตอร์หลายรายการลงใน SmartDocs API ได้แล้วเมื่อแก้ไขเมธอด |
| DEVSOL-1509 | ไม่เห็นวิธีแก้ไขช่อง "ตัวอย่าง" สำหรับ SmartDocs API ตอนนี้คุณตั้งค่า "ประเภท MIME ของเนื้อหา" "เอกสารประกอบของเนื้อหา" และ "ตัวอย่างเนื้อหา" ได้แล้วเมื่อแก้ไข หน้า SmartDocs |
| DEVSOL-1534 | ระบบไม่ป้อนข้อมูล Content-Type ในเอาต์พุต SmartDocs ตอนนี้ระบบป้อนข้อมูล Content-Type ในหน้าเมธอด SmartDocs แล้ว |
| DEVSOL-1554 | การเปรียบเทียบวันที่ไม่ถูกต้องในระบบสร้างรายได้ ในแท็บแผนที่ซื้อสำหรับพอร์ทัลสำหรับนักพัฒนาแอปที่เปิดใช้ระบบสร้างรายได้ ปุ่ม "ยกเลิก" จะไม่แสดงสำหรับแผนที่มีวันที่เริ่มต้นในอนาคต |
| DEVSOL-1556 | ระบบจัดส่งโมดูล Drupal เวอร์ชันเก่า โมดูล media_youtube และโมดูลฟีเจอร์ได้รับการอัปเดตเป็นเวอร์ชันล่าสุดแล้ว |
| DEVSOL-1558 | หน้าเมธอด SmartDocs ไม่แสดงผลสำหรับตัวอย่าง PetStore ในการติดตั้งใหม่ ตอนนี้เมธอด SmartDocs PetStore ตัวอย่างจะแสดงผลอย่างถูกต้องแล้ว |
| DEVSOL-1562 | สร้างมุมมองสำหรับโมเดล SmartDocs แต่ละรายการ เมื่อสร้างโมเดลใหม่ ระบบจะสร้างมุมมองใหม่สำหรับโมเดลนั้นโดยค่าเริ่มต้น |
| DEVSOL-1565 | การแก้ไขเมธอด SmartDocs ทำให้เกิดข้อผิดพลาดร้ายแรง แก้ไขปัญหาที่การแก้ไขเมธอด SmartDocs บางครั้งทำให้เกิดข้อผิดพลาด |
| DEVSOL-1567 | "เพิ่มโมเดล" แสดงในเมนูผู้ดูแลระบบด้านบน แก้ไขปัญหาที่รายการเมนู "เพิ่มโมเดล" แสดงในเมนูผู้ดูแลระบบด้านบน |
| DEVSOL-1576 | มุมมองเอกสารประกอบ API แสดงชื่อโมเดล ไม่ใช่ชื่อที่แสดง หน้าเอกสารประกอบ API ที่แสดงเมื่อคลิก "API" ในเมนูจะแสดงชื่อภายในของโมเดลแทนชื่อที่แสดง หากคุณอัปเดตเป็นเวอร์ชันนี้และคุณ ได้เปลี่ยนมุมมองนี้ คุณจะต้องเปลี่ยนมุมมองกลับเพื่อดูการเปลี่ยนแปลงเหล่านี้โดยทำตามขั้นตอนต่อไปนี้ # เข้าสู่ระบบในฐานะผู้ดูแลระบบ # ไปที่โครงสร้าง > มุมมอง # คลิกเมนูแบบเลื่อนลง ข้าง "แก้ไข" ใน "โมเดล SmartDocs" เพื่อดูการดำเนินการทั้งหมด # หากเห็น "เปลี่ยนกลับ" แสดงว่าคุณ เขียนโค้ดทับด้วยการเปลี่ยนแปลงของคุณเอง คลิก "เปลี่ยนกลับ" เพื่อเปลี่ยนมุมมองกลับเป็นสถานะเริ่มต้น โปรดทราบว่าการดำเนินการนี้จะนำการเปลี่ยนแปลงที่คุณทำกับมุมมองนี้ออก |
| DEVSOL-1578 | แสดงผลทั้งโมเดลสภาพอากาศและ Petstore ในการติดตั้งเว็บไซต์ ระบบจะนำเข้าทั้งโมเดล SmartDocs ของ Petstore และสภาพอากาศในเว็บไซต์ใหม่ |
| DEVSOL-1584 | ซื้อแผนไม่ได้ แก้ไขปัญหาที่แบบฟอร์มการซื้อแผนระบบสร้างรายได้จะไม่ส่งสำหรับเวอร์ชันระบบคลาวด์ 15.05.27.00 และ 15.06.08.00 หากคุณใช้ธีม Apigee Responsive หรือธีมย่อยของ ธีม Apigee Responsive |
| DEVSOL-1597 | เปลี่ยนการตั้งค่าการหมดเวลาของนักพัฒนาแอปไม่ได้ แก้ไขข้อบกพร่องที่การตั้งค่าการหมดเวลาการเชื่อมต่อ Edge ไม่ได้นำไปใช้อย่างถูกต้อง |
| DEVSOL-1620 |
การอัปเกรดโมดูล Me, ตัวบ่งชี้สภาพแวดล้อม และฟีเจอร์ https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | ตรวจสอบว่า arg_separator.output เป็น '&' เพื่อป้องกันไม่ให้ reCAPTCHA
ใช้งานไม่ได้ แก้ไขปัญหาที่เกี่ยวข้องกับแพลตฟอร์มซึ่งทำให้ Google reCAPTCHA ใช้งานไม่ได้ |
| DEVSOL-1651 | ธีมพื้นฐานของ Apigee ทำงานไม่สำเร็จหากไม่ได้เปิดใช้โมดูล SmartDocs ธีม apigee_base ไม่ได้ขึ้นอยู่กับการเปิดใช้โมดูล SmartDocs อีกต่อไป |
| DEVSOL-1654 |
เพิ่มเวอร์ชัน admin_views เพื่อรับการแก้ไขความปลอดภัยที่สำคัญ
|