คุณกําลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info
เมื่อวันอังคารที่ 2 มิถุนายน 2015 เราได้เปิดตัวพอร์ทัลบริการสำหรับนักพัฒนาแอป Apigee เวอร์ชันใหม่ในระบบคลาวด์
หากมีคำถาม โปรดไปที่ทีมสนับสนุนลูกค้าของ Apigee
ดูรายการบันทึกประจำรุ่นทั้งหมดของ Apigee Edge ได้ที่บันทึกประจำรุ่นของ Apigee
ฟีเจอร์ใหม่
SmartDocs พร้อมให้บริการสำหรับผู้ใช้ทั่วไป
SmartDocs กำลังจะออกจากเวอร์ชันเบต้าและพร้อมให้บริการแก่ผู้ใช้ทั่วไป การอัปเดตและฟีเจอร์ใหม่ๆ ประกอบด้วย
- รองรับ Swagger 2.0 ซึ่งรวมถึงการนําเข้าด้วยไฟล์หรือ URL รวมถึงรองรับออบเจ็กต์ความปลอดภัยที่มีชื่อที่กำหนดเอง
- การปรับปรุงการออกแบบภาพในเทมเพลตที่สร้าง SmartDocs
- ความสามารถในการใช้งานและการเพิ่มประสิทธิภาพเวิร์กโฟลว์ในพอร์ทัลนักพัฒนาซอฟต์แวร์ ซึ่งเข้าถึงได้ผ่านเมนูเนื้อหา > SmartDocs ใน Drupal
- การตรวจสอบสิทธิ์ที่เรียกว่า "โทเค็นที่กำหนดเอง" เปลี่ยนชื่อเป็น "คีย์ API" แล้ว
- ออบเจ็กต์ "ความปลอดภัย" ของการตรวจสอบสิทธิ์ที่กําหนดไว้ที่ระดับการแก้ไข
- การกําหนดค่าการตรวจสอบสิทธิ์ไคลเอ็นต์ที่ระดับเทมเพลต การแก้ไขใหม่จะไม่รีเซ็ตข้อมูลเข้าสู่ระบบไคลเอ็นต์ SmartDocs ที่กําหนดค่าไว้ล่วงหน้าอีกต่อไป
ดูคำอธิบายฟีเจอร์เพิ่มเติมได้ในบล็อกโพสต์นี้
ดูเอกสารประกอบของ SmartDocs ได้ที่การใช้ SmartDocs เพื่อเขียนเอกสารประกอบ API
กระบวนการอัปเกรด SmartDocs
หากคุณใช้ SmartDocs อยู่แล้วในช่วงเบต้า คุณจะต้องอัปเกรด SmartDocs ในพอร์ทัลนักพัฒนาซอฟต์แวร์เพื่อใช้ฟีเจอร์และความสามารถใหม่ๆ ในเวอร์ชันที่พร้อมให้บริการแก่ผู้ใช้ทั่วไป
หน้า SmartDocs ที่เผยแพร่ในพอร์ทัลนักพัฒนาแอปแล้วจะยังคงใช้งานได้ต่อไป แต่คุณต้องทําตามกระบวนการอัปเดตก่อนแก้ไขหรือเผยแพร่การเปลี่ยนแปลงในหน้าที่มีอยู่หรือหน้าใหม่
โปรดทราบว่าแม้ว่าคุณจะแสดงผลและเผยแพร่ SmartDocs ภายในพอร์ทัลนักพัฒนาแอปได้ แต่ SmartDocs จะสร้างขึ้นจากโมเดล API ที่อยู่ในบริการการจัดการ Edge API ของ Apigee การเปลี่ยนแปลงใดๆ ที่คุณทำกับโมเดล 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 Enterprise และมีคำถามหรือข้อกังวลเกี่ยวกับกระบวนการอัปเกรด โปรดส่งอีเมลไปที่ 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 ครั้ง ในส่วนโมดูล "Dev Connect 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} ข้อผิดพลาดร้ายแรง: การเรียกใช้ฟังก์ชัน format() ของสมาชิกในออบเจ็กต์ที่ไม่ใช่ออบเจ็กต์ใน /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php บรรทัดที่ 221 {quote} นี่เป็นข้อบกพร่องที่ส่งผลกระทบต่อลูกค้าที่สร้างรายได้ด้วยโค้ดที่กำหนดเองซึ่งเรียกใช้เมธอด toString() เท่านั้น |
| DEVSOL-1398 | SmartDocs นำเข้าโมเดล Petstore เมื่อติดตั้งโดยไม่แจ้งให้ผู้ใช้ทราบ ตอนนี้ SmartDocs จะนำเข้าตัวอย่างสวาร์ก Petstore ระหว่างการติดตั้งเว็บไซต์ (http://petstore.swagger.io/v2/swagger.json) แทนโมเดลสภาพอากาศเพื่อให้มีตัวอย่างการใช้งาน SmartDocs ที่ครอบคลุมมากขึ้น |
| DEVSOL-1407 | Cron ทำงานไม่สำเร็จเมื่อมีนักพัฒนาซอฟต์แวร์จำนวนมาก เมื่อเรียกใช้ Cron ของ Drupal นักพัฒนาซอฟต์แวร์จำนวนมากทำให้เกิดปัญหาการหมดเวลา เมื่อองค์กรมีผู้ใช้มากกว่า 200 คน ระบบจะใช้กระบวนการแบบเป็นกลุ่ม |
| DEVSOL-1470 | สร้างลิงก์เมนู "API" และมุมมองที่เกี่ยวข้อง ตอนนี้ SmartDocs ในพอร์ทัลนักพัฒนาซอฟต์แวร์จะมีลิงก์ไปยังเอกสารประกอบที่แสดงผลแล้วของ SmartDocs ในเมนูหลักชื่อ "API" โดยค่าเริ่มต้น ซึ่งลิงก์ไปยังโมเดลที่มีเมธอดที่เผยแพร่ |
ปัญหาที่ทราบ
เวอร์ชันนี้มีปัญหาที่ทราบดังต่อไปนี้
| รหัสปัญหา | คำอธิบาย |
|---|---|
| DEVSOL-1558 |
หน้าวิธีการของ SmartDocs ของตัวอย่าง Petstore แสดงผลอย่างไม่ถูกต้องในการติดตั้งใหม่
หน้าวิธีการของ Petstore ใน SmartDocs แสดงผลไม่ถูกต้องในการติดตั้งใหม่ วิธีแก้ปัญหานี้
ตอนนี้โหนดควรแสดงผลอย่างถูกต้องแล้ว |