15.05.27.00 - Ghi chú phát hành Cổng dịch vụ dành cho nhà phát triển Apigee

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về 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ới trên đám mây 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 truy cập vào Apigee Customer Support.

Để biết 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ạm vi cung cấp rộng rãi

SmartDocs phát triể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ả tính năng nhập bằng tệp hoặc URL, bao gồm tính năng hỗ trợ cho các đối tượng bảo mật được đặt tên tuỳ chỉnh.
  • Cải thiện thiết kế hình ảnh trong các mẫu tạo tài liệu thông minh.
  • Các tính năng nâng cao cho quy trình công việc và khả năng hữu dụng trong Cổng thông tin cho nhà phát triển có trong trình đơn Nội dung > SmartDocs trong Drupal.
  • Phần đã được gọi là xác thực "Mã thông báo tuỳ chỉnh" giờ đây được gọi là "Khoá API".
  • Xác thực các đối tượng "bảo mật" được xác định ở cấp bản sửa đổi.
  • Cấu hình xác thực ứng dụng ở cấp mẫu. Các bản sửa đổi mới không còn đặt lại mọi thông tin đăng nhập của ứng dụng SmartDocs được định cấu hình sẵn nữa.

Để tìm hiểu thêm về nội dung mô tả tính năng, hãy xem bài đăng trên blog này.

Để xem tài liệu về SmartDocs, hãy xem phần Sử dụng SmartDocs để ghi tài liệu API.

Quy trình nâng cấp Tài liệu thông minh

Nếu bạn đang 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 rộng rãi sẽ 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 của bạn sẽ tiếp tục hoạt động, nhưng bạn phải tuân theo quy trình cập nhật trước khi chỉnh sửa hoặc xuất bản bất kỳ thay đổi nào đối với 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 bên trong cổng thông tin dành cho nhà phát triển, nhưng SmartDocs được tạo từ mô hình API hoạt động trong Dịch vụ quản lý API Edge của Apigee. Mọi thay đổi 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 nhà phát triển tồn tại trong các môi trường Pantheon).

Cách nâng cấp từ SmartDocs thử nghiệm lên phiên bản phát hành rộng rãi

  1. 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 kiểm thử trên Pantheon.
  2. 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 đang nhập các 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 vẫn duy trì mô hình API thông qua mô-đun SmartDocs, hãy xuất dưới dạng JSON của SmartDocs rồi nhập vào mô hình mới bằng tệp đính kèm.
  3. Đặt thuộc tính bảo mật của bản sửa đổi mô hình của bạn. Trên trang Nội dung > SmartDocs > mẫu, chọn Cài đặt bảo mật.
  4. Kiểm tra mọi phương thức xác thực được định cấu hình sẵn trên 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.
  5. Hãy cập nhật mọi mẫu tuỳ chỉnh để sử dụng các thành phần CSS và JS phiên bản 6, đồ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, xem phần Sử dụng SmartDocs cho API tài liệu.
  6. Kết xuất lại và xuất bản bản sửa đổi mô hình.
  7. Sau khi xác thực tài liệu mới, hãy cập nhật cổng phát hành công khai lên bản phát hành 15.05.27.

Nếu bạn là khách hàng doanh nghiệp Edge và có câu hỏi hoặc thắc mắc về quá 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 API để nhận được phản hồi tốt nhất.

Đã sửa lỗi

Các lỗi sau đây đã được khắc phục trong bản phát hành này.

ID vấn đề Nội dung mô tả
DEVSOL-487 Quản trị viên nên đị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 phần cài đặt kiếm tiền cho các định dạng ngày ở Châu Âu và Hoa Kỳ.
DEVSOL-603 Trang Kế hoạch xung đột có định dạng không phù hợp
Khi mua một gói trùng lặp với một gói hiện có, trang hiển thị giờ đây sẽ được định dạng vừa vặn cho người dùng.
DEVSOL-642 Di chuyển cấu hình cấp ứng dụng từ phần cài đặt bảo mật sang phần 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 đề hiển thị không thể chỉnh sửa tham số mẫu sau khi gửi yêu cầu từ SmartDocs sau khi xóa tham số mẫu trong tài liệu về 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 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 họ.
DEVSOL-1273 "DevConnect Mint" xuất hiện 2 lần trong danh sách Mô-đun
Trong phần Phụ lục, "Dev Connect Mint" xuất hiện hai lần. Vấn đề này hiện đã được khắc phục.
DEVSOL-1313 Hỗ trợ tệp JSON/YAML hoặc tính năng nhập URL cho cả Swagger và WADL
Giờ đây, bạn có thể nhập tệp WADL qua URL và tải tệp Swagger lên.
DEVSOL-1339 Thay đổi vị trí trình đơn Quản trị viên của SmartDocs
Giờ đây, SmartDocs nằm trong trình đơn nội dung, còn chế độ cài đặt Smartdocs nằm trong trình đơn quản trị phần cài đặt.
DEVSOL-1340 Xoá bản Beta khi chuyển đến GA
Giờ đây, SmartDocs nằm trong trình đơn nội dung, còn chế độ cài đặt Smartdocs nằm trong trình đơn quản trị phần cài đặt.
DEVSOL-1390 Thư viện PHP SDK Edge đã được cập nhật để khắc phục lỗi gọi __toString()
Thư viện PHP SDK Edge gọi __toString() trên đối tượng DeveloperRatePlan sẽ tạo ra lỗi này: {dấu ngoặc kép} Lỗi nghiêm trọng: Gọi đến một đối tượng thành viên
DEVSOL-1398 Mô hình SmartDocs Petstore được nhập khi cài đặt mà không có lời nhắc người dùng
Giờ đây, SmartDocs nhập ví dụ về sự phong phú của cửa hàng thú cưng 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ó ví dụ đầy đủ hơn về cách sử dụng SmartDocs.
DEVSOL-1407 Cron này gặp sự cố khi có nhiều nhà phát triển
Khi chạy cron của 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, quy trình xử lý hàng loạt sẽ được sử dụng.
DEVSOL-1470 Tạo đường liên kết đến trình đơn "API" và chế độ xem tương ứng
Theo mặc định, SmartDocs cung cấp đường liên kết đến tài liệu được kết xuất của SmartDocs trong trình đơn chính có tên là "API". Các API này liên kết đến mọi mô hình có phương thức đã phát hành.

Vấn đề đã biết

Bản phát hành này gặp một số vấn đề đã biết sau đây:

ID vấn đề Nội dung mô tả
DEVSOL-1558
Các trang phương thức SmartDocs ví dụ về thú cưng không hiển thị chính xác trên bản cài đặt mới
Ví dụ về các trang phương thức Petstore trong SmartDocs không hiển thị chính xác trên một bản cài đặt mới. Cách khắc phục vấn đề này:
  1. Chọn Nội dung > SmartDocs trong trình đơn Drupal.
  2. Chọn mô hình "Ví dụ về cửa hàng thú cưng".
  3. Chọn Hiển thị và xuất bản nút trong phần Tuỳ chọn cập nhật.
  4. Nhấp vào hộp đánh dấu Select/Unselect all (Chọn/Bỏ chọn tất cả) để chọn tất cả các nút.
  5. Nhấp vào Cập nhật.

Các nút hiện đã hiển thị chính xác.