4.15.07.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.
Truy cập vào tài liệu Apigee X.
Thông tin

Vào thứ Ba, ngày 8 tháng 9 năm 2015, chúng tôi đã phát hành phiên bản hằng quý của Cổng dịch vụ dành cho nhà phát triển Apigee Edge cho Đám mây riêng.

Tên sản phẩm cũ "Apigee Edge On-premises Developer Services Portal" hoặc "OPDK" hiện là "Apigee Edge Developer Services Portal for Private Cloud".

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.

Yêu cầu về Apigee Edge đối với cổng thông tin

Nếu đang kết nối phiên bản cổng này với một bản cài đặt Edge cho Đám mây riêng tư, thì bạn phải kết nối phiên bản này với phiên bản 4.15.07.00 trở lên để đảm bảo rằng tất cả các tính năng của SmartDocs đều được hỗ trợ. Hãy xem 4.15.07.00 – Apigee Edge cho ghi chú phát hành Private Cloud để biết thêm thông tin.

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

  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 test 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 đã 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.
  3. Đặ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).
  4. 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.
  5. 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.
  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 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-584 Không nhớ tham số đường dẫn khi sử dụng lần đầu
Tham số đường dẫn khi thực hiện cuộc gọi không phải lúc nào cũng được ghi nhớ.
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-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-723 Hiện thông báo thân thiện với người dùng khi không nhập được SmartDocs
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-1244 Không bật mô-đun Chỉ báo môi trường cho các bản phát hành OPDK
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á nhãn Beta khi chuyển sang phiên bản phát hành công khai
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, dẫn đến lỗi này:

Lỗi nghiêm trọng: Lệnh gọi đến hàm thành viên format() trên một đối tượng không phải đối tượng trong /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php ở dòng 221

Đâ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 gặp lỗi khi có nhiều nhà phát triển
Khi chạy cron Drupal, số lượng lớn nhà phát triển sẽ gây ra vấn đề 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-1410 Lỗi kết nối không xuất hiện khi cài đặt Cổng nhà phát triển
Thêm thông báo lỗi hiệu quả hơn vào trình cài đặt khi kết nối quản lý Edge không hoạt động để giảm thiểu các vấn đề về khắc phục sự cố.
DEVSOL-1422 Xoá biểu mẫu Cấu hình SMTP khỏi hồ sơ Apigee
Quy trình cài đặt sẽ không còn hỏi bạn có muốn định cấu hình SMTP hay không. Thay vào đó, bạn có thể thực hiện việc này sau khi quá trình cài đặt hoàn tất theo quy trình Drupal tiêu chuẩn là bật mô-đun SMTP và định cấu hình đúng cách.
DEVSOL-1427

Thêm các hook vào mô-đun Ứng dụng nhà phát triển Devconnect để cho phép thay đổi dữ liệu phân tích
Mô-đun devconnect_developer_apps hiện cung cấp 3 hook mới:

# hook_devconnect_developer_apps_analytics_chart_data_alter()

# hook_devconnect_developer_app_analytics_datapoints_params_alter()

# hook_devconnect_developer_app_analytics_datapoints_alter()

Những thay đổi này cho phép các mô-đun tuỳ chỉnh thay đổi biểu đồ phân tích ứng dụng của nhà phát triển.

DEVSOL-1464 Lỗi nghiêm trọng khi lưu chế độ cài đặt Uỷ quyền cho một mô hình
Khi một Lược đồ bảo mật bị xoá, giờ đây, bạn sẽ thấy một hộp đánh dấu để chọn xem Lược đồ uỷ quyền mẫu được liên kết có cần bị xoá hay khô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, 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.
DEVSOL-1486 Các lệnh gọi SmartDocs có thể xác thực bằng một khoá được xác định trước
Cho phép xác thực bằng cả khoá API được cung cấp trước và do người dùng cung cấp.
DEVSOL-1499 Mã HTML không được phân tích cú pháp trong phần mô tả tham số SmartDocs
Giờ đây, mã HTML được phân tích cú pháp trong phần mô tả tham số SmartDocs.
DEVSOL-1507 Không thể thêm nhiều tham số vào một API bằng phương thức Thêm
Giờ đây, bạn có thể thêm nhiều tham số vào một API SmartDocs khi chỉnh sửa phương thức.
DEVSOL-1509 Không thấy cách chỉnh sửa trường "mẫu" cho một API SmartDocs
Giờ đây, bạn có thể đặt "Loại MIME nội dung", "Tài liệu nội dung" và "Mẫu nội dung" khi chỉnh sửa một trang SmartDocs.
DEVSOL-1534 Loại nội dung không được điền sẵn trong đầu ra SmartDocs
Loại nội dung hiện đang được điền sẵn trong trang phương thức SmartDocs.
DEVSOL-1554 So sánh ngày không hợp lệ trong phần Kiếm tiền
Trong thẻ gói đã mua của các cổng dành cho nhà phát triển có bật tính năng kiếm tiền, nút "Huỷ" không bao giờ xuất hiện cho một gói có ngày bắt đầu trong tương lai,
DEVSOL-1556 Đang vận chuyển phiên bản cũ của các mô-đun Drupal
Mô-đun media_youtube và features đã được cập nhật lên phiên bản mới nhất.
DEVSOL-1558 Các trang phương thức SmartDocs không hiển thị cho ví dụ về PetStore
Trên các bản cài đặt mới, các phương thức SmartDocs PetStore mẫu hiện hiển thị chính xác.
DEVSOL-1562 Tạo một khung hiển thị cho từng mô hình SmartDocs
Khi tạo một mô hình mới, theo mặc định, một khung hiển thị mới sẽ được tạo cho mô hình đó.
DEVSOL-1565 Chỉnh sửa phương thức SmartDocs sẽ tạo ra Lỗi nghiêm trọng
Khắc phục vấn đề khi việc chỉnh sửa một phương thức SmartDocs đôi khi sẽ tạo ra lỗi.
DEVSOL-1567 "Thêm mô hình" xuất hiện trên trình đơn quản trị hàng đầu
Đã khắc phục vấn đề mục trình đơn "Thêm mô hình" xuất hiện trên trình đơn quản trị hàng đầu.
DEVSOL-1576 Chế độ xem tài liệu API hiển thị tên mô hình, không hiển thị tên hiển thị
Trang Tài liệu API xuất hiện khi bạn nhấp vào "API" trong trình đơn, trang này hiển thị tên nội bộ của mô hình thay vì tên hiển thị. Nếu đang cập nhật lên bản phát hành và bạn đã thay đổi chế độ xem này, thì bạn cần phải khôi phục chế độ xem để thấy những thay đổi này bằng cách làm theo các bước sau: # Đăng nhập với tư cách là quản trị viên # Chuyển đến mục Cấu trúc > Chế độ xem # Nhấp vào trình đơn thả xuống bên cạnh "Chỉnh sửa" trên "Mô hình SmartDocs" để xem tất cả các thao tác. # If you see "revert", then you have overwritten the code w/your own change. Nhấp vào "quay lại" để đưa chế độ xem về trạng thái mặc định. Xin lưu ý rằng thao tác này sẽ xoá mọi thay đổi bạn đã thực hiện đối với chế độ xem này.
DEVSOL-1578 Kết xuất cả mô hình Thời tiết và Cửa hàng thú cưng trên các bản cài đặt trang web
Cả mô hình SmartDocs của Cửa hàng thú cưng và Thời tiết đều được nhập trên các trang web mới.
DEVSOL-1584 Không mua được gói
Đã khắc phục vấn đề không gửi được biểu mẫu mua gói kiếm tiền cho bản phát hành trên đám mây 15.05.27.00 và 15.06.08.00 nếu bạn đang sử dụng giao diện Thích ứng của Apigee hoặc một giao diện con của giao diện Thích ứng của Apigee.
DEVSOL-1597 Không thể thay đổi chế độ cài đặt thời gian chờ của nhà phát triển
Chúng tôi đã khắc phục một lỗi khiến chế độ cài đặt thời gian chờ kết nối Edge không được áp dụng đúng cách.
DEVSOL-1620

Nâng cấp mô-đun về tôi, chỉ báo môi trường và các tính năng
Bản cập nhật bảo mật quan trọng vừa phải cho mô-đun về tôi và bản cập nhật mô-đun cho chỉ báo môi trường và các tính năng. Thông tin khác:

https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator

https://www.drupal.org/project/features

DEVSOL-1648 Đảm bảo arg_separator.output là "&" để ngăn reCAPTCHA bị lỗi
Chúng tôi đã khắc phục một vấn đề liên quan đến nền tảng khiến việc sử dụng Google reCAPTCHA bị lỗi.
DEVSOL-1651 Giao diện Apigee Base sẽ gặp lỗi nếu mô-đun smartdocs không được bật
Giao diện apigee_base không còn phụ thuộc vào việc mô-đun SmartDocs có được bật hay không.
DEVSOL-1654

Tăng phiên bản của admin_views để chọn bản sửa lỗi bảo mật quan trọng
Các mô-đun đóng góp sau đây đã được cập nhật:

  • Chế độ xem dành cho quản trị viên
  • Di chuyển
  • Chuyển hướng
  • Redis
  • Thao tác hàng loạt trên khung hiển thị