คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ
Apigee X info
เมื่อวันอังคารที่ 2 มิถุนายน 2015 เราได้เปิดตัวพอร์ทัลบริการสำหรับนักพัฒนาซอฟต์แวร์ Apigee เวอร์ชันใหม่บนระบบคลาวด์
หากมีข้อสงสัย โปรดติดต่อทีมสนับสนุน Apigee Edge
ดูรายการบันทึกประจำรุ่นของ Apigee Edge ทั้งหมดได้ที่บันทึกประจำรุ่นของ Apigee
ฟีเจอร์ใหม่
ความพร้อมใช้งานทั่วไปของ Smart Docs
SmartDocs จะเปลี่ยนจากเวอร์ชันเบต้าเป็นเวอร์ชันสำหรับผู้ใช้ทั่วไป การอัปเดตและฟีเจอร์ใหม่ๆ มีดังนี้
- รองรับ Swagger 2.0 รวมถึงการนำเข้าตามไฟล์หรือ URL รวมถึงรองรับ ออบเจ็กต์ความปลอดภัยที่กำหนดชื่อเอง
- การปรับปรุงการออกแบบภาพในเทมเพลตที่สร้าง Smart Docs
- การปรับปรุงความสามารถในการใช้งานและเวิร์กโฟลว์ในพอร์ทัลนักพัฒนาซอฟต์แวร์ ซึ่งพร้อมใช้งานผ่านเมนูเนื้อหา > SmartDocs ใน Drupal
- การตรวจสอบสิทธิ์ที่เคยเรียกว่า "โทเค็นที่กำหนดเอง" ตอนนี้เรียกว่า "คีย์ API"
- ออบเจ็กต์ "security" การตรวจสอบสิทธิ์ที่กำหนดไว้ที่ระดับการแก้ไข
- การกำหนดค่าการตรวจสอบสิทธิ์ไคลเอ็นต์ที่ระดับเทมเพลต การแก้ไขใหม่จะไม่รีเซ็ต ข้อมูลเข้าสู่ระบบไคลเอ็นต์ SmartDocs ที่กำหนดค่าไว้ล่วงหน้าอีกต่อไป
ดูคำอธิบายฟีเจอร์เพิ่มเติมได้ที่บล็อก โพสต์นี้
ดูเอกสารประกอบ SmartDocs ได้ที่การใช้ SmartDocs เพื่อจัดทำเอกสารประกอบ API
กระบวนการอัปเกรด SmartDocs
หากคุณใช้ Smart Docs ในช่วงเบต้าอยู่แล้ว ฟีเจอร์และความสามารถใหม่ๆ ในเวอร์ชันที่พร้อมใช้งานทั่วไปกำหนดให้คุณต้องอัปเกรด Smart Docs ในพอร์ทัลนักพัฒนาซอฟต์แวร์
หน้า SmartDocs ที่เผยแพร่ในพอร์ทัลนักพัฒนาแอปแล้วจะยังคงใช้งานได้ แต่คุณต้องทำตามกระบวนการอัปเดตก่อนที่จะแก้ไขหรือเผยแพร่การเปลี่ยนแปลงใดๆ ในหน้าที่มีอยู่หรือหน้าใหม่
โปรดทราบว่าแม้คุณจะแสดงผลและเผยแพร่ SmartDocs ภายในพอร์ทัลนักพัฒนาซอฟต์แวร์ได้ แต่ระบบจะสร้าง SmartDocs จากโมเดล API ที่อยู่ในบริการการจัดการ API ของ Edge ของ Apigee การเปลี่ยนแปลงใดๆ ที่คุณทำกับโมเดล API ใน Edge จะเหมือนกันในสภาพแวดล้อม Pantheon ทั้งหมด (คล้ายกับวิธีที่นักพัฒนาซอฟต์แวร์มีอยู่ในสภาพแวดล้อม Pantheon)
วิธีอัปเกรดจาก SmartDocs เวอร์ชันเบต้าเป็นเวอร์ชันสำหรับผู้ใช้ทั่วไป
- อัปเดตและทดสอบรุ่น 15.05.27 ในสภาพแวดล้อม dev หรือtest บน Pantheon
- สร้างโมเดลใหม่เพื่อแทนที่โมเดล API ที่มีอยู่ซึ่งคุณใช้อยู่
- หากคุณนำเข้าเอกสาร Swagger หรือ WADL ให้นำเข้าเอกสารเหล่านั้นอีกครั้งในการแก้ไขใหม่
- หากคุณดูแลรักษารูปแบบ API ผ่านโมดูล SmartDocs ให้ส่งออกเป็น JSON ของ SmartDocs แล้วนำเข้าไปยังโมเดลใหม่โดยใช้ไฟล์แนบ
- ตั้งค่าพร็อพเพอร์ตี้ความปลอดภัยของรีวิชันของโมเดล ในหน้าเนื้อหา >
SmartDocs > โมเดล ให้เลือกการตั้งค่าความปลอดภัย
- ตรวจสอบการตรวจสอบสิทธิ์ที่กำหนดค่าไว้ล่วงหน้าในหน้าการตั้งค่าโมเดล (เนื้อหา >
SmartDocs) โดยคลิกการตั้งค่าในคอลัมน์การดำเนินการ
- อัปเดตเทมเพลตที่กำหนดเองเพื่อใช้ชิ้นงาน CSS และ JS เวอร์ชัน 6 และทำการเปลี่ยนแปลงเพื่อให้สอดคล้องกับ ชื่อออบเจ็กต์ใหม่ เช่น authSchemes และ apiSchema ดูข้อมูลเกี่ยวกับการอัปเดตเทมเพลต SmartDocs ได้ที่การใช้ SmartDocs เพื่อจัดทำเอกสาร API
- แสดงผลอีกครั้งและเผยแพร่การแก้ไขโมเดล
- หลังจากตรวจสอบเอกสารประกอบใหม่แล้ว ให้อัปเดตพอร์ทัลเวอร์ชันที่ใช้งานจริงเป็น รุ่น 15.05.27
หากคุณเป็นลูกค้าองค์กรของ Edge และมีคำถามหรือข้อกังวลเกี่ยวกับการอัปเกรด โปรดส่งอีเมลไปที่ marsh@apigee.com และ cnovak@apigee.com หรือใช้ชุมชน Apigee เพื่อรับคำตอบที่ดีที่สุด
แก้ไขข้อบกพร่องแล้ว
ข้อบกพร่องต่อไปนี้ได้รับการแก้ไขในรุ่นนี้
| รหัสปัญหา | คำอธิบาย |
|---|---|
| DEVSOL-487 | ผู้ดูแลระบบควรตั้งค่ารูปแบบวันในข้อมูลการสร้างรายได้ได้ ตอนนี้คุณตั้งค่ารูปแบบวันที่ในข้อมูลการสร้างรายได้ได้แล้วในการตั้งค่าการสร้างรายได้สำหรับ รูปแบบวันที่ของยุโรปและสหรัฐอเมริกา |
| DEVSOL-603 | หน้าแพ็กเกจที่ขัดแย้งกันมีรูปแบบไม่ดี เมื่อซื้อแพ็กเกจที่ทับซ้อนกับแพ็กเกจที่มีอยู่ ตอนนี้หน้าเว็บที่แสดงจะมีรูปแบบที่ดีสำหรับผู้ใช้ |
| DEVSOL-642 | ย้ายการกำหนดค่าระดับลูกค้าจากการตั้งค่าความปลอดภัยไปยังการตั้งค่าเทมเพลต |
| DEVSOL-709 | SmartDocs: แก้ไขพารามิเตอร์เทมเพลต URL ไม่ได้หลังจากส่งคำขอที่มีค่าว่าง แก้ไขปัญหาที่ทำให้แก้ไขพารามิเตอร์เทมเพลตไม่ได้หลังจากส่งคำขอ จาก SmartDocs หลังจากลบพารามิเตอร์เทมเพลตในเอกสารประกอบของเมธอด |
| DEVSOL-1013 | ทำให้แก้ไขอีเมลผู้ใช้พอร์ทัลนักพัฒนาแอปได้ ระบบจะไม่ปิดใช้ช่องอีเมลในหน้าแก้ไขโปรไฟล์อีกต่อไป และ นักพัฒนาแอปจะเปลี่ยนอีเมลของตนเองได้ |
| 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 | นำเวอร์ชันเบต้าออกเมื่อไปที่ 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 | นำเข้าโมเดล Petstore ของ SmartDocs เมื่อติดตั้งโดยไม่ต้องแจ้งให้ผู้ใช้ทราบ ตอนนี้ SmartDocs จะนำเข้าตัวอย่าง Swagger ของ Petstore ในระหว่างการติดตั้งเว็บไซต์ (http://petstore.swagger.io/v2/swagger.json) แทนโมเดลสภาพอากาศเพื่อให้มี ตัวอย่างการใช้ SmartDocs ที่ครอบคลุมมากขึ้น |
| DEVSOL-1407 | Cron ทำงานไม่สำเร็จเมื่อมีนักพัฒนาแอปจำนวนมาก เมื่อเรียกใช้ Drupal cron นักพัฒนาแอปจำนวนมากทำให้เกิดปัญหาการหมดเวลา เมื่อองค์กรมีผู้ใช้มากกว่า 200 คน ระบบจะใช้กระบวนการแบบเป็นชุด |
| DEVSOL-1470 | สร้างลิงก์เมนู "API" และมุมมองที่เกี่ยวข้อง ตอนนี้ SmartDocs ของพอร์ทัลนักพัฒนาแอปจะมีลิงก์ไปยังเอกสารประกอบที่แสดงผลของ SmartDocs ในเมนูหลักชื่อ "API" โดยค่าเริ่มต้น ซึ่งจะลิงก์ไปยังโมเดลที่มีวิธีการที่เผยแพร่ |
ปัญหาที่ทราบ
รุ่นนี้มีปัญหาที่ทราบดังต่อไปนี้
| รหัสปัญหา | คำอธิบาย |
|---|---|
| DEVSOL-1558 |
หน้าวิธีการของ Petstore Example SmartDocs แสดงผลไม่ถูกต้องในการติดตั้งใหม่
หน้าวิธีการของ Petstore ตัวอย่างใน SmartDocs แสดงผลไม่ถูกต้องในการติดตั้งใหม่
วิธีแก้ปัญหานี้
ตอนนี้โหนดควรแสดงผลอย่างถูกต้องแล้ว |