Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. Thông tin
Vào thứ Ba, ngày 2 tháng 6 năm 2015, chúng tôi đã phát hành một phiên bản đám mây mới của Cổng dịch vụ dành cho nhà phát triển Apigee.
Nếu bạn có câu hỏi, hãy liên hệ với Nhóm hỗ trợ Apigee Edge.
Để xem danh sách tất cả ghi chú phát hành của Apigee Edge, hãy xem Ghi chú phát hành của Apigee.
Tính năng mới
Phát hành rộng rãi SmartDocs
SmartDocs sẽ chuyển từ giai đoạn thử nghiệm beta sang giai đoạn phát hành rộng rãi. Các bản cập nhật và tính năng mới bao gồm:
- Hỗ trợ Swagger 2.0, bao gồm cả việc nhập theo tệp hoặc URL, bao gồm cả việc hỗ trợ các đối tượng bảo mật có tên tuỳ chỉnh.
- Cải tiến về thiết kế trực quan trong các mẫu tạo SmartDocs.
- Cải thiện khả năng sử dụng và quy trình làm việc trong Cổng thông tin dành cho nhà phát triển, có trong trình đơn Nội dung > SmartDocs trong Drupal.
- Phương thức xác thực "Mã thông báo tuỳ chỉnh" hiện được gọi là "Khoá API".
- Các đối tượng "bảo mật" xác thực được xác định ở cấp bản sửa đổi.
- Cấu hình xác thực máy khách ở cấp mẫu. Các bản sửa đổi mới sẽ không còn đặt lại bất kỳ thông tin xác thực ứng dụng khách SmartDocs nào được định cấu hình trước.
Để biết thêm nội dung mô tả về các tính năng, hãy xem bài đăng này trên blog.
Để biết tài liệu về SmartDocs, hãy xem phần Sử dụng SmartDocs để ghi lại API.
Quy trình nâng cấp SmartDocs
Nếu bạn đã sử dụng SmartDocs trong giai đoạn thử nghiệm, thì các tính năng và chức năng mới trong phiên bản phát hành công khai yêu cầu bạn nâng cấp SmartDocs trong cổng thông tin dành cho nhà phát triển.
Mọi trang SmartDocs đã được xuất bản trong cổng thông tin dành cho nhà phát triển sẽ tiếp tục hoạt động, nhưng bạn phải làm theo quy trình cập nhật trước khi chỉnh sửa hoặc xuất bản mọi thay đổi đối với các trang hiện có hoặc trang mới.
Xin lưu ý rằng mặc dù bạn có thể kết xuất và xuất bản SmartDocs trong cổng dành cho nhà phát triển, nhưng SmartDocs được tạo từ mô hình API nằm trong Dịch vụ quản lý API Edge của Apigee. Mọi thay đổi mà bạn thực hiện đối với một mô hình API trong Edge sẽ giống nhau trên tất cả các môi trường Pantheon của bạn (tương tự như cách các nhà phát triển tồn tại trên các môi trường Pantheon).
Cách nâng cấp từ phiên bản beta của SmartDocs lên phiên bản phát hành công khai
- Cập nhật và kiểm thử bản phát hành 15.05.27 trong môi trường dev hoặc test trên Pantheon.
- Tạo một mô hình mới để thay thế mọi mô hình API hiện có mà bạn đang sử dụng.
- Nếu bạn đã nhập tài liệu Swagger hoặc WADL, hãy nhập lại các tài liệu đó vào một bản sửa đổi mới.
- Nếu bạn đang duy trì mô hình API thông qua mô-đun SmartDocs, hãy xuất dưới dạng SmartDocs JSON và nhập vào mô hình mới bằng cách sử dụng tệp đính kèm.
- Đặt các thuộc tính bảo mật cho bản sửa đổi của mô hình. Trên trang Nội dung > SmartDocs > model, hãy chọn Security Settings (Chế độ cài đặt bảo mật).
- Kiểm tra mọi hoạt động xác thực được định cấu hình sẵn trong trang cài đặt mô hình (Nội dung > SmartDocs) bằng cách nhấp vào Cài đặt trong cột Thao tác.
- Cập nhật mọi mẫu tuỳ chỉnh để sử dụng phiên bản 6 của thành phần CSS và JS, đồng thời thực hiện các thay đổi để phản ánh mọi tên đối tượng mới, chẳng hạn như authSchemes và apiSchema. Để biết thông tin về cách cập nhật mẫu SmartDocs, hãy xem bài viết Sử dụng SmartDocs để lập tài liệu về API.
- Kết xuất lại và xuất bản bản sửa đổi mô hình.
- Sau khi xác thực tài liệu mới, hãy cập nhật cổng sản xuất của bạn lên bản phát hành ngày 27/5/15.
Nếu bạn là khách hàng doanh nghiệp của Edge và có thắc mắc hoặc lo ngại về quy trình nâng cấp, vui lòng gửi email đến marsh@apigee.com và cnovak@apigee.com. Nếu không, vui lòng sử dụng Cộng đồng Apigee để nhận được câu trả lời tốt nhất.
Các lỗi đã được khắc phục
Các lỗi sau đây đã được khắc phục trong bản phát hành này.
| ID vấn đề | Mô tả |
|---|---|
| DEVSOL-487 | Quản trị viên có thể định cấu hình định dạng ngày trong phần Kiếm tiền Giờ đây, bạn có thể định cấu hình định dạng ngày trong phần Kiếm tiền trong chế độ cài đặt kiếm tiền cho định dạng ngày của Châu Âu và Hoa Kỳ. |
| DEVSOL-603 | Trang Kế hoạch trùng lặp có định dạng kém Khi mua một gói trùng với một gói hiện có, trang hiển thị hiện được định dạng đẹp mắt cho người dùng. |
| DEVSOL-642 | Di chuyển cấu hình cấp ứng dụng khách từ chế độ cài đặt bảo mật sang chế độ cài đặt mẫu |
| DEVSOL-709 | SmartDocs: Không thể chỉnh sửa tham số mẫu URL sau khi gửi yêu cầu có giá trị trống Khắc phục vấn đề khiến các tham số mẫu không thể chỉnh sửa sau khi gửi yêu cầu từ SmartDocs sau khi xoá tham số mẫu trong tài liệu phương thức. |
| DEVSOL-1013 | Cho phép chỉnh sửa địa chỉ email của người dùng trên Cổng nhà phát triển Trường địa chỉ email trên trang chỉnh sửa hồ sơ sẽ không bị vô hiệu hoá nữa và nhà phát triển có thể thay đổi địa chỉ email của mình. |
| DEVSOL-1273 | "DevConnect Mint" xuất hiện 2 lần trong danh sách Modules (Mô-đun) Trong phần Modules (Mô-đun), "Dev Connect Mint" xuất hiện 2 lần. Vấn đề này hiện đã được khắc phục. |
| DEVSOL-1313 | Hỗ trợ nhập tệp JSON/YAML hoặc URL cho cả Swagger và WADL Giờ đây, bạn có thể nhập tệp WADL thông qua URL và tải tệp Swagger lên. |
| DEVSOL-1339 | Thay đổi vị trí của trình đơn Quản trị viên SmartDocs SmartDocs hiện nằm trong trình đơn nội dung và chế độ cài đặt smartdocs nằm trong trình đơn quản trị chế độ cài đặt. |
| DEVSOL-1340 | Xoá phiên bản Beta khi chuyển sang GA SmartDocs hiện nằm trong trình đơn nội dung và chế độ cài đặt smartdocs nằm trong trình đơn quản trị chế độ cài đặt. |
| DEVSOL-1390 | Thư viện PHP SDK Edge đã được cập nhật để khắc phục vấn đề khi gọi __toString() Thư viện PHP SDK Edge đã được cập nhật để khắc phục vấn đề khi gọi __toString() trên đối tượng DeveloperRatePlan. Vấn đề này tạo ra lỗi sau: {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} Đây là một lỗi chỉ ảnh hưởng đến những khách hàng sử dụng tính năng kiếm tiền có mã tuỳ chỉnh gọi phương thức toString(). |
| DEVSOL-1398 | Mô hình SmartDocs Petstore được nhập khi cài đặt mà không nhắc người dùng SmartDocs hiện nhập ví dụ về swagger petstore trong quá trình cài đặt trang web (http://petstore.swagger.io/v2/swagger.json) thay vì mô hình thời tiết để có một ví dụ đầy đủ hơn về cách sử dụng SmartDocs. |
| DEVSOL-1407 | Cron không hoạt động khi có nhiều nhà phát triển Khi chạy cron Drupal, một số lượng lớn nhà phát triển đã gây ra sự cố hết thời gian chờ. Khi một tổ chức có hơn 200 người dùng, hệ thống sẽ sử dụng quy trình xử lý hàng loạt. |
| DEVSOL-1470 | Tạo đường liên kết đến trình đơn "API" và chế độ xem tương ứng Theo mặc định, Dev Portal SmartDocs hiện có một đường liên kết đến tài liệu SmartDocs được hiển thị trong trình đơn chính có tên là "API". Đường liên kết này sẽ liên kết đến mọi mô hình có phương thức đã xuất bản. |
Vấn đề đã biết
Bản phát hành này có các vấn đề đã biết sau đây:
| ID vấn đề | Mô tả |
|---|---|
| DEVSOL-1558 |
Các trang phương thức SmartDocs trong ví dụ về cửa hàng thú cưng không được hiển thị đúng cách trên một bản cài đặt mới
Các trang phương thức Petstore mẫu trong SmartDocs không hiển thị đúng cách trên một bản cài đặt mới. Cách khắc phục vấn đề này:
Lúc này, các nút sẽ hiển thị đúng cách. |