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

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

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

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

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

ฟีเจอร์ใหม่

ความพร้อมให้บริการโดยทั่วไปของ SmartDocs

SmartDocuments กำลังเปลี่ยนจากรุ่นเบต้าเป็นรุ่นสำหรับผู้ใช้ทั่วไป การอัปเดตและฟีเจอร์ใหม่ๆ มีดังนี้

  • การรองรับ Swurge 2.0 รวมถึงการนำเข้าตามไฟล์หรือ URL รวมถึงการรองรับออบเจ็กต์ความปลอดภัยที่มีการตั้งชื่อที่กำหนดเอง
  • ปรับปรุงการออกแบบภาพในเทมเพลตที่สร้าง SmartDocuments
  • การเพิ่มประสิทธิภาพการใช้งานและเวิร์กโฟลว์ในพอร์ทัลนักพัฒนาซอฟต์แวร์ ซึ่งเข้าถึงได้จากเมนูเนื้อหา > SmartDocs ใน Drupal
  • สิ่งที่เคยเรียกว่าการตรวจสอบสิทธิ์ "โทเค็นที่กำหนดเอง" ปัจจุบันเปลี่ยนเป็น "คีย์ API"
  • ออบเจ็กต์ "ความปลอดภัย" การตรวจสอบสิทธิ์ที่กำหนดที่ระดับการแก้ไข
  • การกำหนดค่าการตรวจสอบสิทธิ์ไคลเอ็นต์ที่ระดับเทมเพลต การแก้ไขใหม่จะไม่รีเซ็ตข้อมูลเข้าสู่ระบบไคลเอ็นต์ SmartDocuments ที่กำหนดค่าไว้ล่วงหน้าอีกต่อไป

ดูรายละเอียดฟีเจอร์เพิ่มเติมได้ที่บล็อกโพสต์นี้

สำหรับเอกสารประกอบของ SmartDocument โปรดดูที่การใช้ SmartDocs เพื่อสร้างเอกสาร API

กระบวนการอัปเกรด SmartGoogle

หากคุณใช้ SmartGoogle ในช่วงเบต้าอยู่แล้ว ฟีเจอร์และความสามารถใหม่ๆ ในเวอร์ชันที่ให้บริการทั่วไป คุณจะต้องอัปเกรด SmartDocuments ในพอร์ทัลสำหรับนักพัฒนาซอฟต์แวร์

หน้า Smartdocs ที่เผยแพร่ในพอร์ทัลนักพัฒนาซอฟต์แวร์จะยังคงใช้งานได้ต่อไป แต่คุณจะต้องทำตามขั้นตอนการอัปเดตก่อนที่จะเผยแพร่การเปลี่ยนแปลงไปยังหน้าที่มีอยู่หรือหน้าใหม่

โปรดทราบว่าแม้คุณจะแสดงผลและเผยแพร่ SmartDocument ภายในพอร์ทัลนักพัฒนาซอฟต์แวร์ได้ แต่ SmartGoogle จะสร้างขึ้นจากโมเดล API ที่อยู่ในบริการการจัดการ Edge API ของ Apigee ของ Apigee การเปลี่ยนแปลงใดๆ ที่คุณทำกับโมเดล API ใน Edge จะเหมือนกันในสภาพแวดล้อม Pantheon ทั้งหมดของคุณ (คล้ายกับการที่นักพัฒนาซอฟต์แวร์มีอยู่ในสภาพแวดล้อม Pantheon)

วิธีอัปเกรดจาก Smartdocument เวอร์ชันเบต้าเป็นเวอร์ชันสำหรับผู้ใช้ทั่วไป

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

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

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

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

รหัสปัญหา คำอธิบาย
DEVSOL-487 ผู้ดูแลระบบควรกำหนดค่ารูปแบบวันในการสร้างรายได้
ตอนนี้คุณสามารถกำหนดค่ารูปแบบวันที่ได้แล้วในส่วน "การสร้างรายได้" ในการตั้งค่าการสร้างรายได้สำหรับรูปแบบวันที่แบบยุโรปและสหรัฐอเมริกา
DEVSOL-603 หน้าแผนการทับซ้อนอยู่ในรูปแบบที่ไม่ถูกต้อง
เมื่อซื้อแผนที่ทับซ้อนกับแพ็กเกจที่มีอยู่ ตอนนี้หน้าเว็บที่แสดงจะจัดรูปแบบอย่างเหมาะสมสำหรับผู้ใช้แล้ว
DEVSOL-642 ย้ายการกำหนดค่าระดับไคลเอ็นต์จากการตั้งค่าความปลอดภัยไปยังการตั้งค่าเทมเพลต
DEVSOL-709 SmartDocument: พารามิเตอร์เทมเพลต URL จะแก้ไขไม่ได้หลังจากส่งคำขอที่มีค่า ว่าง
แก้ไขปัญหาการแสดงผลพารามิเตอร์เทมเพลตแก้ไขไม่ได้หลังจากส่งคำขอจาก SmartGoogle ไปแล้วหลังจากลบพารามิเตอร์เทมเพลตในเอกสารเกี่ยวกับเมธอด
DEVSOL-1013 ทำให้อีเมลของผู้ใช้พอร์ทัลนักพัฒนาซอฟต์แวร์แก้ไขได้
ช่องอีเมลในหน้าแก้ไขโปรไฟล์จะไม่ปิดใช้อีกต่อไป และนักพัฒนาแอปจะเปลี่ยนอีเมลได้
DEVSOL-1273 "DevConnect Mint" ปรากฏขึ้น 2 ครั้งในรายการโมดูล
"Dev Connect Mint" แสดง 2 ครั้งในส่วนโมดูล ซึ่งตอนนี้ปัญหาได้รับการแก้ไขแล้ว
DEVSOL-1313 รองรับไฟล์ JSON/YAML หรือการนำเข้า URL สำหรับทั้ง Swagger และ WADL
สามารถนำเข้าไฟล์ WADL ผ่าน URL และอัปโหลดไฟล์ Swคนหนึ่ง ได้
DEVSOL-1339 เปลี่ยนตำแหน่งเมนูของผู้ดูแลระบบ SmartGoogle
ขณะนี้ SmartGoogle จะอยู่ในเมนูเนื้อหา และการตั้งค่า Smartdocs จะอยู่ในเมนูผู้ดูแลระบบการตั้งค่า
DEVSOL-1340 นำเวอร์ชันเบต้าออกเมื่อไปที่ GA
ตอนนี้ SmartDocuments จะอยู่ในเมนูเนื้อหา และการตั้งค่า Smartdocs จะอยู่ในเมนูผู้ดูแลระบบการตั้งค่า
DEVSOL-1390 ไลบรารี PHP SDK Edge ได้รับการอัปเดตเพื่อแก้ไขปัญหาในการเรียกใช้ __toString()
ไลบรารี PHP SDK Edge นี้ได้รับการอัปเดตเพื่อแก้ไขปัญหาการเรียกใช้ __toString() ในออบเจ็กต์ DeveloperRatePlan() แล้ว ซึ่งทำให้เกิดข้อผิดพลาดนี้: {quote} ข้อผิดพลาดร้ายแรง: การเรียกใช้โค้ดฟังก์ชันสมาชิก format.sdk นี้และเรียกใช้โค้ดที่ไม่ใช่ออบเจ็กต์ใน /Applications/MAMP/PROFILEtdocs/ordnanceที่หลากหลาย
DEVSOL-1398 โมเดล Smartdocs Petstore ที่นำเข้าเมื่อติดตั้งโดยไม่แสดงข้อความแจ้งผู้ใช้
ตอนนี้ SmartDocuments จะนำเข้าตัวอย่าง petstore ที่กริชระหว่างการติดตั้งเว็บไซต์ (http://petstore.swagger.io/v2/swคนหนึ่ง.json) แทนโมเดลสภาพอากาศ เพื่อให้มีตัวอย่างที่ครอบคลุมยิ่งขึ้นในการใช้ SmartGoogle
DEVSOL-1407 Cron ล้มเหลวเมื่อมีนักพัฒนาซอฟต์แวร์จำนวนมาก
เมื่อเรียกใช้ Drupal cron นักพัฒนาซอฟต์แวร์จำนวนมากทำให้เกิดปัญหาการหมดเวลา เมื่อองค์กรมีผู้ใช้มากกว่า 200 ราย ระบบจะใช้กระบวนการแบบกลุ่ม
DEVSOL-1470 สร้างลิงก์เมนูและมุมมองที่เกี่ยวข้องของ "API"
ตอนนี้ SmartGoogle พอร์ทัลการพัฒนามีลิงก์ไปยังเอกสารที่แสดงผลของ SmartGoogle ไว้โดยค่าเริ่มต้นในเมนูหลักชื่อ "API" ซึ่งจะลิงก์ไปยังโมเดลใดก็ตามที่มีเมธอดที่เผยแพร่

ปัญหาที่ทราบ

รุ่นนี้มีปัญหาที่ทราบดังต่อไปนี้

รหัสปัญหา คำอธิบาย
DEVSOL-1558
หน้าเมธอด Smart Docs ตัวอย่างสำหรับ Petstore แสดงผลไม่ถูกต้องในการติดตั้งใหม่
หน้าเมธอด Petstore ตัวอย่างใน SmartGoogle แสดงผลไม่ถูกต้องในการติดตั้งใหม่ วิธีแก้ปัญหานี้
  1. เลือกเนื้อหา > SmartDocs ในเมนู Drupal
  2. เลือกโมเดล "ตัวอย่างสำหรับ Petstore"
  3. เลือกแสดงผลและเผยแพร่โหนดในส่วนตัวเลือกการอัปเดต
  4. คลิกช่องทำเครื่องหมายเลือก / ยกเลิกการเลือกทั้งหมดเพื่อเลือกโหนดทั้งหมด
  5. คลิกอัปเดต

โหนดควรแสดงผลอย่างถูกต้องตอนนี้