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.
Chuyển đến tài liệu về 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" (Cổng dịch vụ dành cho nhà phát triển Apigee Edge tại chỗ) hoặc "OPDK" hiện là "Apigee Edge Developer Services Portal for Private Cloud" (Cổng dịch vụ dành cho nhà phát triển Apigee Edge cho đám mây riêng).

Nếu bạn có câu hỏi, hãy truy cập vào Nhóm hỗ trợ khách hàng của Apigee.

Để 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.

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

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

Tính năng mới

Giai đoạn phát hành rộng rãi của SmartDocs

SmartDocs sẽ chuyển từ giai đoạn thử nghiệm beta sang giai đoạn phát hành công khai. 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 theo tệp hoặc URL, cũng như hỗ trợ các đối tượng bảo mật được đặt tên tuỳ chỉnh.
  • Cải tiến thiết kế hình ảnh trong các mẫu tạo SmartDocs.
  • Các tính năng cải tiến về khả năng hữu 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ó sẵn thông qua 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 "security" (bảo mật) của quy trình xác thực được xác định ở cấp 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 bất kỳ thông tin xác thực ứng dụng SmartDocs nào được định cấu hình trước.

Để biết thêm thông tin mô tả về tính năng, hãy xem bài đăng trên blog này.

Để biết tài liệu về SmartDocs, hãy xem bài viết Sử dụng SmartDocs để ghi lại API.

Quy trình nâng cấp SmartDocs

Nếu đã sử dụng SmartDocs trong giai đoạn thử nghiệm, bạn cần phải nâng cấp SmartDocs trong cổng thông tin dành cho nhà phát triển để sử dụng 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.

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 trang hiện có hoặc trang mới.

Xin lưu ý rằng mặc dù bạn có thể hiển thị 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 nằm trong Dịch vụ quản lý API cạnh của Apigee. Mọi thay đổi bạn thực hiện đối với mô hình API trong Edge sẽ giống nhau trên tất cả môi trường Pantheon (tương tự như cách 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 SmartDocs thử nghiệm 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 phát triển 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 đã 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 tệp JSON SmartDocs và nhập vào mô hình mới bằng tệp đính kèm.
  3. Thiết lập các thuộc tính bảo mật của bản sửa đổi mô hình. Trên trang Content > SmartDocs > model (Nội dung > Tài liệu thông minh > mô hình), hãy chọn Security Settings (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 trước trong trang cài đặt mô hình (Content > SmartDocs) bằng cách nhấp vào Settings (Cài đặt) trong cột Operations (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 các 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 để ghi lại 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 thông tin phiên bản chính thức lên bản phát hành 15.05.27.

Nếu bạn là khách hàng doanh nghiệp của Edge và có câu hỏi hoặc thắc mắc 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 để đượ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 đề 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
Bạn hiệ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 định dạng ngày ở Châu Âu và Hoa Kỳ.
DEVSOL-584 Thông số đường dẫn không được ghi nhớ khi sử dụng lần đầu
Thông số đường dẫn khi thực hiện lệnh gọi không phải lúc nào cũng được ghi nhớ.
DEVSOL-603 Trang Gói xung đột có định dạng không tốt
Khi mua một gói trùng lặp với 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 chỉnh sửa được thông 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 không chỉnh sửa được thông số mẫu sau khi gửi yêu cầu từ SmartDocs sau khi xoá thông số mẫu trong tài liệu về phương thức.
DEVSOL-723 Hiển thị thông báo dễ hiểu cho người dùng về lỗi Nhập 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 trong 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-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 hai lần trong danh sách Mô-đun
Trong phần Mô-đun, "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ợ 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í trình đơn Quản trị 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ị cài đặt.
DEVSOL-1340 Xoá phiên bản thử nghiệm khi chuyển sang GA
DEVSOL-1390

Thư viện PHP SDK Edge đã được cập nhật để khắc phục vấn đề gọi __toString()
Thư viện PHP SDK Edge đã được cập nhật để khắc phục vấn đề gọi __toString() trên đối tượng DeveloperRatePlan gây ra 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 là đối tượng trong /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php trên dòng 221

Đây là lỗi chỉ ảnh hưởng đến những khách hà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 cần 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ó ví dụ đầy đủ hơn về cách sử dụng SmartDocs.
DEVSOL-1407 Cron không thành công khi có nhiều nhà phát triển
Khi chạy cron Drupal, một 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, quy trình xử lý hàng loạt sẽ được sử dụng.
DEVSOL-1410 Lỗi kết nối không rõ ràng khi cài đặt Cổng thông tin dành cho 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 Định cấu hình SMTP khỏi hồ sơ Apigee
Quá trình cài đặt 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 cài đặt xong theo phương pháp tiêu chuẩn của Drupal để bật mô-đun SMTP và định cấu hình mô-đun đó đúng cách.
DEVSOL-1427

Thêm các trình bổ trợ vào mô-đun Ứng dụng dành cho 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 trình bổ trợ 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()

Các phương thức 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 Xác thực 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 có cần xoá cả lược đồ xác thực Mẫu được liên kết hay không.
DEVSOL-1470 Tạo đường liên kết Trình đơn "API" và chế độ xem tương ứng
Theo mặc định, SmartDocs của Cổng thông tin dành cho nhà phát triển sẽ có đường liên kết đến tài liệu được hiển thị bằng SmartDocs trong trình đơn chính có tên "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 khoá được xác định trước
Cho phép xác thực bằng cả khoá API do hệ thống cung cấp 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
Mã HTML hiện đượ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 API bằng tính năng Thêm phương thức
Giờ đây, bạn có thể thêm nhiều tham số vào 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 API SmartDocs
Giờ đây, bạn có thể đặt "Loại MIME của nội dung", "Tài liệu về nội dung" và "Mẫu nội dung" khi chỉnh sửa trang SmartDocs.
DEVSOL-1534 Content-type không được điền sẵn trong đầu ra SmartDocs
Content-type 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 tính năng Kiếm tiền
Trong thẻ gói đã mua cho các cổng thông tin dành cho nhà phát triển đã bật tính năng kiếm tiền, nút "Huỷ" không bao giờ hiển thị cho một gói có ngày bắt đầu trong tương lai,
DEVSOL-1556 Phiên bản cũ của các mô-đun Drupal đang được phân phối
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ụ PetStore
Trên các lượt cài đặt mới, các phương thức PetStore SmartDocs mẫu hiện hiển thị chính xác.
DEVSOL-1562 Tạo chế độ xem cho mỗi mô hình SmartDocs
Khi tạo một mô hình mới, theo mặc định, một chế độ xem mới sẽ được tạo cho mô hình đó.
DEVSOL-1565 Việc 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 đề đôi khi việc chỉnh sửa phương thức SmartDocs sẽ tạo ra lỗi.
DEVSOL-1567 "Thêm mô hình" đang hiển thị trên trình đơn quản trị viên trên cùng
Khắc phục vấn đề mục trình đơn "Thêm mô hình" đang hiển thị trên trình đơn quản trị viên trên cùng.
DEVSOL-1576 Chế độ xem tài liệu API hiển thị tên mô hình, chứ không phải tên hiển thị
Trang Tài liệu API xuất hiện khi nhấp vào "API" trong trình đơn đang 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à đã thay đổi chế độ xem này, bạn sẽ cần huỷ bỏ chế độ xem để xem các thay đổi này bằng cách làm theo các bước sau: # Đăng nhập với tư cách quản trị viên # Chuyển đến 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ả thao tác. # Nếu bạn thấy "huỷ bỏ", thì bạn đã ghi đè mã bằng thay đổi của riêng mình. Nhấp vào "huỷ bỏ" để đưa thành phần hiển thị 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 Hiển thị cả mô hình Thời tiết và Petstore khi cài đặt trang web
Cả mô hình Petstore và mô hình SmartDocs Thời tiết đều được nhập trên các trang web mới.
DEVSOL-1584 Không thể mua gói
Khắc phục vấn đề biểu mẫu mua gói kiếm tiền không gửi được 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 Apigee hoặc giao diện phụ của giao diện thích ứng Apigee.
DEVSOL-1597 Không thể thay đổi chế độ cài đặt thời gian chờ cho nhà phát triển
Khắc phục lỗi 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 Me, chỉ báo môi trường và tính năng
Bản cập nhật bảo mật có mức độ nghiêm trọng trung bình cho mô-đun me và bản cập nhật mô-đun cho chỉ báo môi trường cũng như 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 chặn sự cố reCAPTCHA
Khắc phục vấn đề liên quan đến nền tảng, trong đó việc sử dụng Google reCAPTCHA bị lỗi.
DEVSOL-1651 Giao diện Apigee Base không hoạt động nếu mô-đun smartdocs chưa được bật
giao diện apigee_base không còn phụ thuộc vào việc mô-đun SmartDocs đã được bật hay chưa.
DEVSOL-1654

Nâng cấp phiên bản admin_views để nhậ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 quản trị
  • Di chuyển
  • Chuyển hướng
  • Redis
  • Thao tác hàng loạt trên Chế độ xem