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

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

เมื่อวันอังคารที่ 8 กันยายน 2015 เราได้เปิดตัว Apigee Edge Developer Services Portal สำหรับ Private Cloud ในเวอร์ชันรายไตรมาส

ชื่อผลิตภัณฑ์เดิม "Apigee Edge On-Premises Developer Services Portal" หรือ "OPDK" เปลี่ยนเป็น "Apigee Edge Developer Services Portal สำหรับ Private Cloud" แล้ว

หากมีข้อสงสัย โปรดติดต่อทีมสนับสนุน Apigee Edge

ดูรายการบันทึกประจำรุ่นของ Apigee Edge ทั้งหมดได้ที่บันทึกประจำรุ่นของ Apigee

ข้อกำหนดของ Apigee Edge สำหรับพอร์ทัล

หากเชื่อมต่อพอร์ทัลรุ่นนี้กับการติดตั้ง Edge for Private Cloud คุณต้องเชื่อมต่อกับเวอร์ชัน 4.15.07.00 ขึ้นไปเพื่อให้มั่นใจว่าระบบจะรองรับฟีเจอร์ SmartDocs ทั้งหมด ดูข้อมูลเพิ่มเติมได้ที่4.15.07.00 - Apigee Edge สำหรับบันทึกประจำรุ่น Private Cloud

ฟีเจอร์ใหม่

ความพร้อมใช้งานทั่วไปของ 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 เวอร์ชันเบต้าเป็นเวอร์ชันสำหรับผู้ใช้ทั่วไป

  1. อัปเดตและทดสอบรุ่น 15.05.27 ในสภาพแวดล้อม dev หรือtest บน Pantheon
  2. สร้างโมเดลใหม่เพื่อแทนที่โมเดล API ที่มีอยู่ซึ่งคุณใช้อยู่
    • หากคุณนำเข้าเอกสาร Swagger หรือ WADL ให้นำเข้าเอกสารเหล่านั้นอีกครั้งในการแก้ไขใหม่
    • หากคุณดูแลรักษารูปแบบ API ผ่านโมดูล SmartDocs ให้ส่งออกเป็น JSON ของ SmartDocs แล้วนำเข้าไปยังโมเดลใหม่โดยใช้ไฟล์แนบ
  3. ตั้งค่าพร็อพเพอร์ตี้ความปลอดภัยของรีวิชันของโมเดล ในหน้าเนื้อหา > SmartDocs > โมเดล ให้เลือกการตั้งค่าความปลอดภัย
  4. ตรวจสอบการตรวจสอบสิทธิ์ที่กำหนดค่าไว้ล่วงหน้าในหน้าการตั้งค่าโมเดล (เนื้อหา > SmartDocs) โดยคลิกการตั้งค่าในคอลัมน์การดำเนินการ
  5. อัปเดตเทมเพลตที่กำหนดเองเพื่อใช้ชิ้นงาน CSS และ JS เวอร์ชัน 6 และทำการเปลี่ยนแปลงเพื่อให้สอดคล้องกับ ชื่อออบเจ็กต์ใหม่ เช่น authSchemes และ apiSchema ดูข้อมูลเกี่ยวกับการอัปเดตเทมเพลต SmartDocs ได้ที่การใช้ SmartDocs เพื่อจัดทำเอกสาร API
  6. แสดงผลอีกครั้งและเผยแพร่การแก้ไขโมเดล
  7. หลังจากตรวจสอบเอกสารประกอบใหม่แล้ว ให้อัปเดตพอร์ทัลเวอร์ชันที่ใช้งานจริงเป็น รุ่น 15.05.27

หากคุณเป็นลูกค้าองค์กรของ Edge และมีคำถามหรือข้อกังวลเกี่ยวกับการอัปเกรด โปรดส่งอีเมลไปที่ marsh@apigee.com และ cnovak@apigee.com หรือใช้ชุมชน Apigee เพื่อรับคำตอบที่ดีที่สุด

แก้ไขข้อบกพร่องแล้ว

ข้อบกพร่องต่อไปนี้ได้รับการแก้ไขในรุ่นนี้

รหัสปัญหา คำอธิบาย
DEVSOL-487 ผู้ดูแลระบบควรตั้งค่ารูปแบบวันในข้อมูลการสร้างรายได้ได้
ตอนนี้คุณตั้งค่ารูปแบบวันที่ในข้อมูลการสร้างรายได้ได้แล้วในการตั้งค่าการสร้างรายได้สำหรับ รูปแบบวันที่ของยุโรปและสหรัฐอเมริกา
DEVSOL-584 ระบบจำพารามิเตอร์เส้นทางไม่ได้เมื่อใช้งานครั้งแรก
ระบบไม่ได้จดจำพารามิเตอร์เส้นทางเสมอไปเมื่อทำการเรียก
DEVSOL-603 หน้าแพ็กเกจที่ขัดแย้งกันมีรูปแบบไม่ดี
เมื่อซื้อแพ็กเกจที่ทับซ้อนกับแพ็กเกจที่มีอยู่ ตอนนี้หน้าเว็บที่แสดงจะมีรูปแบบที่ดีสำหรับผู้ใช้
DEVSOL-709 SmartDocs: แก้ไขพารามิเตอร์เทมเพลต URL ไม่ได้หลังจากส่งคำขอที่มีค่าว่าง
แก้ไขปัญหาที่ทำให้แก้ไขพารามิเตอร์เทมเพลตไม่ได้หลังจากส่งคำขอ จาก SmartDocs หลังจากลบพารามิเตอร์เทมเพลตในเอกสารประกอบของเมธอด
DEVSOL-723 แสดงข้อความที่ใช้งานง่ายเมื่อนำเข้า Smart Docs ไม่สำเร็จ
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 นำเวอร์ชันเบต้าออกเมื่อเปลี่ยนเป็น 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 นำเข้าโมเดล Petstore ของ SmartDocs เมื่อติดตั้งโดยไม่ต้องแจ้งให้ผู้ใช้ทราบ
ตอนนี้ SmartDocs จะนำเข้าตัวอย่าง Swagger ของ Petstore ในระหว่างการติดตั้งเว็บไซต์ (http://petstore.swagger.io/v2/swagger.json) แทนโมเดลสภาพอากาศเพื่อให้มีตัวอย่างการใช้ SmartDocs ที่ครอบคลุมมากขึ้น
DEVSOL-1407 Cron ล้มเหลวเมื่อมีนักพัฒนาแอปจำนวนมาก
เมื่อเรียกใช้ Drupal cron นักพัฒนาแอปจำนวนมากจะทำให้เกิดปัญหาการหมดเวลา เมื่อองค์กรมีผู้ใช้มากกว่า 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 เกิดข้อผิดพลาดร้ายแรงเมื่อบันทึกการตั้งค่าการตรวจสอบสิทธิ์สำหรับโมเดล
เมื่อลบ Security Scheme ตอนนี้จะมีช่องทำเครื่องหมายให้เลือกหากต้องลบ Template Auth Scheme ที่เชื่อมโยงด้วย
DEVSOL-1470 สร้างลิงก์เมนู "API" และมุมมองที่เกี่ยวข้อง
ตอนนี้ SmartDocs ของพอร์ทัลนักพัฒนาแอปจะมีลิงก์ไปยังเอกสารประกอบที่แสดงผลของ SmartDocs ในเมนูหลักชื่อ "API" โดยค่าเริ่มต้น ซึ่งจะลิงก์ไปยังโมเดลที่มีวิธีการที่เผยแพร่
DEVSOL-1486 การเรียกใช้ SmartDocs สามารถตรวจสอบสิทธิ์ด้วยคีย์ที่กำหนดไว้ล่วงหน้า
เปิดใช้การตรวจสอบสิทธิ์ด้วยทั้งคีย์ API ที่จัดหาให้ล่วงหน้าและคีย์ API ที่ผู้ใช้จัดหาให้
DEVSOL-1499 ไม่ได้แยกวิเคราะห์โค้ด HTML ในคำอธิบายพารามิเตอร์ของ SmartDocs
ตอนนี้ระบบจะแยกวิเคราะห์โค้ด HTML ในคำอธิบายพารามิเตอร์ของ SmartDocs แล้ว
DEVSOL-1507 เพิ่มพารามิเตอร์หลายรายการลงใน API ด้วย Add Method ไม่ได้
ตอนนี้คุณเพิ่มพารามิเตอร์หลายรายการลงใน API ของ SmartDocs ได้แล้วเมื่อแก้ไขเมธอด
DEVSOL-1509 หากไม่เห็นวิธีแก้ไขช่อง "ตัวอย่าง" สำหรับ SmartDocs API
ตอนนี้คุณสามารถตั้งค่า "ประเภท MIME ของเนื้อหา" "เอกสารประกอบของเนื้อหา" และ "ตัวอย่างเนื้อหา" เมื่อแก้ไข หน้า SmartDocs
DEVSOL-1534 ไม่ได้ระบุประเภทเนื้อหาในเอาต์พุตของ Smart Docs
ตอนนี้ระบบได้ระบุประเภทเนื้อหาในหน้าเมธอดของ Smart Docs แล้ว
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" เพื่อดูการดำเนินการทั้งหมด # หากเห็น "revert" แสดงว่าคุณ เขียนทับโค้ดด้วยการเปลี่ยนแปลงของคุณเอง คลิก "เปลี่ยนกลับ" เพื่อเปลี่ยนมุมมองกลับไปเป็น สถานะเริ่มต้น โปรดทราบว่าการดำเนินการนี้จะนำการเปลี่ยนแปลงทั้งหมดที่คุณทำกับมุมมองนี้ออก
DEVSOL-1578 แสดงโมเดลทั้งสภาพอากาศและร้านขายสัตว์เลี้ยงในการติดตั้งเว็บไซต์
ระบบจะนำเข้าโมเดลทั้ง Petstore และ Weather SmartDocs ในเว็บไซต์ใหม่
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

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
  • การดำเนินการแบบกลุ่มของมุมมอง