4.15.07.00 - บันทึกประจำรุ่นของพอร์ทัลบริการสำหรับนักพัฒนาซอฟต์แวร์ Apigee

คุณกําลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info

ในวันอังคารที่ 8 กันยายน 2015 เราได้เปิดตัวพอร์ทัลบริการสำหรับนักพัฒนาซอฟต์แวร์ Apigee Edge เวอร์ชันรายไตรมาสสำหรับระบบคลาวด์ส่วนตัว

ชื่อผลิตภัณฑ์เดิม "พอร์ทัลบริการสำหรับนักพัฒนาแอปในองค์กรของ Apigee Edge" หรือ "OPDK" เปลี่ยนเป็น "พอร์ทัลบริการสำหรับนักพัฒนาแอปของ Apigee Edge สำหรับระบบคลาวด์ส่วนตัว" แล้ว

หากมีคำถาม โปรดไปที่ทีมสนับสนุนลูกค้าของ Apigee

ดูรายการบันทึกประจำรุ่นทั้งหมดของ 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 ที่อยู่ในบริการการจัดการ Edge API ของ Apigee การเปลี่ยนแปลงใดๆ ที่คุณทำกับโมเดล API ใน Edge จะเหมือนกันในทุกสภาพแวดล้อมของ Pantheon (คล้ายกับวิธีที่นักพัฒนาซอฟต์แวร์ทำงานในสภาพแวดล้อมต่างๆ ของ Pantheon)

วิธีอัปเกรดจาก SmartDocs รุ่นเบต้าเป็นเวอร์ชันที่พร้อมให้บริการแก่ผู้ใช้ทั่วไป

1. อัปเดตและทดสอบรุ่น 15.05.27 ในสภาพแวดล้อม dev หรือ test ใน Pantheon
2. สร้างโมเดลใหม่เพื่อแทนที่โมเดล API ที่มีอยู่ซึ่งคุณใช้อยู่
   • หากคุณนําเข้าเอกสาร Swagger หรือ WADL ให้นําเข้าอีกครั้งในฉบับใหม่
   • หากคุณดูแลรักษาโมเดล API ผ่านโมดูล SmartDocs ให้ส่งออกเป็น SmartDocs JSON และนําเข้าไปยังโมเดลใหม่โดยใช้ไฟล์แนบ
3. ตั้งค่าพร็อพเพอร์ตี้ความปลอดภัยของเวอร์ชันแก้ไขของโมเดล ในหน้าเนื้อหา > SmartDocs > โมเดล ให้เลือกการตั้งค่าความปลอดภัย
   
4. ตรวจสอบการตรวจสอบสิทธิ์ที่กำหนดค่าไว้ล่วงหน้าในหน้าการตั้งค่ารูปแบบ (เนื้อหา > SmartDocs) โดยคลิกการตั้งค่าในคอลัมน์การดำเนินการ
   
5. อัปเดตเทมเพลตที่กําหนดเองให้ใช้ชิ้นงาน CSS และ JS เวอร์ชัน 6 และทําการเปลี่ยนแปลงให้สอดคล้องกับชื่อออบเจ็กต์ใหม่ เช่น authSchemes และ apiSchema ดูข้อมูลเกี่ยวกับการอัปเดตเทมเพลต SmartDocs ได้ที่การใช้ SmartDocs เพื่อเขียนเอกสารประกอบ API
6. แสดงผลและเผยแพร่การแก้ไขโมเดลอีกครั้ง
7. หลังจากตรวจสอบเอกสารประกอบใหม่แล้ว ให้อัปเดตพอร์ทัลเวอร์ชันที่ใช้งานจริงเป็นรุ่น 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	อย่าเปิดใช้ข้อบ่งชี้สภาพแวดล้อมสําหรับรุ่น OPDK
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
DEVSOL-1390	อัปเดตไลบรารี PHP SDK Edge เพื่อแก้ไขปัญหาการเรียกใช้ __toString() อัปเดตไลบรารี PHP SDK Edge เพื่อแก้ไขปัญหาการเรียกใช้ __toString() ในออบเจ็กต์ DeveloperRatePlan ซึ่งทำให้เกิดข้อผิดพลาดนี้ ข้อผิดพลาดร้ายแรง: การเรียกใช้ฟังก์ชันสมาชิก 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 หรือไม่อีกต่อไป แต่คุณจะทําได้หลังจากการติดตั้งเสร็จสมบูรณ์โดยทําตามแนวทางปฏิบัติมาตรฐานของ Drupal ในการเปิดใช้ข้อบังคับ SMTP และกําหนดค่าอย่างถูกต้อง
DEVSOL-1427	เพิ่มฮุกลงในโมดูลแอปของนักพัฒนาแอป Devconnect เพื่ออนุญาตให้แก้ไขข้อมูลวิเคราะห์ ตอนนี้โมดูล devconnect_developer_apps มีฮุกใหม่ 3 รายการ ได้แก่ # 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	ระบบไม่ป้อนข้อมูลประเภทเนื้อหาในเอาต์พุต SmartDocs ตอนนี้ระบบกำลังป้อนข้อมูลประเภทเนื้อหาในหน้าเมธอด SmartDocs
DEVSOL-1554	การเปรียบเทียบวันที่ไม่ถูกต้องในการสร้างรายได้ ในแท็บแพ็กเกจที่ซื้อสำหรับพอร์ทัลนักพัฒนาแอปที่เปิดใช้การสร้างรายได้ ปุ่ม "ยกเลิก" ไม่เคยแสดงสำหรับแพ็กเกจที่มีวันที่เริ่มต้นในอนาคต
DEVSOL-1556	มีการนำส่งโมดูล Drupal เวอร์ชันเก่า อัปเดตโมดูล media_youtube และ features เป็นเวอร์ชันล่าสุดแล้ว
DEVSOL-1558	หน้าวิธีการของ SmartDocs ไม่แสดงผลสำหรับตัวอย่าง PetStore ตอนนี้วิธีการ PetStore ของ SmartDocs แสดงผลอย่างถูกต้องแล้วในการติดตั้งใหม่
DEVSOL-1562	สร้างมุมมองสำหรับโมเดล SmartDocs แต่ละรายการ เมื่อสร้างโมเดลใหม่ ระบบจะสร้างมุมมองใหม่โดยค่าเริ่มต้นสำหรับโมเดลนั้น
DEVSOL-1565	การแก้ไขเมธอด SmartDocs จะทำให้เกิดข้อผิดพลาดร้ายแรง แก้ไขปัญหาที่บางครั้งการแก้ไขเมธอด SmartDocs จะทำให้เกิดข้อผิดพลาด
DEVSOL-1567	"เพิ่มรูปแบบ" แสดงในเมนูผู้ดูแลระบบด้านบน แก้ไขปัญหาที่รายการเมนู "เพิ่มรูปแบบ" แสดงในเมนูผู้ดูแลระบบด้านบน
DEVSOL-1576	มุมมองเอกสารประกอบ API แสดงชื่อโมเดล ไม่ใช่ชื่อที่แสดง หน้าเอกสารประกอบ API ที่แสดงเมื่อคลิก "API" ในเมนูแสดงชื่อภายในของโมเดลแทนชื่อที่แสดง หากคุณอัปเดตเป็นรุ่นนี้และได้เปลี่ยนมุมมองนี้ คุณจะต้องเปลี่ยนมุมมองกลับเพื่อดูการเปลี่ยนแปลงเหล่านี้โดยทำตามขั้นตอนต่อไปนี้ # เข้าสู่ระบบในฐานะผู้ดูแลระบบ # ไปที่โครงสร้าง > มุมมอง # คลิกเมนูแบบเลื่อนลงข้าง "แก้ไข" ใน "โมเดล SmartDocs" เพื่อดูการดำเนินการทั้งหมด # หากเห็น "เปลี่ยนกลับ" แสดงว่าคุณได้เขียนทับโค้ดด้วยการเปลี่ยนแปลงของคุณเอง คลิก "เปลี่ยนกลับ" เพื่อเปลี่ยนมุมมองกลับเป็นสถานะเริ่มต้น โปรดทราบว่าการดำเนินการนี้จะนําการเปลี่ยนแปลงที่คุณทํากับมุมมองนี้ออก
DEVSOL-1578	แสดงผลทั้งโมเดลสภาพอากาศและ Petstore เมื่อติดตั้งเว็บไซต์ ระบบจะนำเข้าทั้งโมเดล SmartDocs ของ Petstore และสภาพอากาศในเว็บไซต์ใหม่
DEVSOL-1584	ซื้อแพ็กเกจไม่ได้ แก้ไขปัญหาที่แบบฟอร์มการซื้อแพ็กเกจการสร้างรายได้ไม่ส่งสำหรับรุ่นที่ใช้งานบนระบบคลาวด์แล้ว ในวันที่ 27.05.15.00 และ 08.06.15.00 หากคุณใช้ธีม Apigee Responsive หรือธีมย่อยของธีม Apigee Responsive
DEVSOL-1597	เปลี่ยนการตั้งค่าระยะหมดเวลาของนักพัฒนาแอปไม่ได้ แก้ไขข้อบกพร่องในการใช้การตั้งค่าระยะหมดเวลาของการเชื่อมต่อ Edge อย่างไม่ถูกต้องแล้ว
DEVSOL-1620	การอัปเกรดโมดูลฉัน ตัวบ่งชี้สภาพแวดล้อม และฟีเจอร์ การอัปเดตความปลอดภัยที่สำคัญปานกลางสำหรับโมดูลฉัน และการอัปเดตโมดูลตัวบ่งชี้สภาพแวดล้อมและฟีเจอร์ ข้อมูลเพิ่มเติม: https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator https://www.drupal.org/project/features
DEVSOL-1648	ตรวจสอบว่า arg_separator.output เป็น "&" เพื่อป้องกันไม่ให้ reCAPTCHA ใช้งานไม่ได้ ปัญหาเกี่ยวกับแพลตฟอร์มซึ่งทำให้การใช้ Google reCAPTCHA ใช้งานไม่ได้ได้รับการแก้ไขแล้ว
DEVSOL-1651	ธีม Apigee Base ไม่ทำงานหากไม่ได้เปิดใช้โมดูล SmartDocs ธีม apigee_base ไม่ได้ขึ้นอยู่กับการเปิดใช้โมดูล SmartDocs อีกต่อไป
DEVSOL-1654	อัปเกรดเวอร์ชัน admin_views เพื่อรับการแก้ไขความปลอดภัยที่สำคัญ อัปเดตโมดูล contrib ต่อไปนี้แล้ว มุมมองการดูแลระบบ ย้ายข้อมูล เปลี่ยนเส้นทาง Redis การดำเนินการแบบกลุ่มของยอดดู