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 quý của Cổng dịch vụ dành cho nhà phát triển Apigee Edge dành cho đám mây riêng tư.
Tên sản phẩm trước đây là "Apigee Edge Developer Services Services" (Cổng dịch vụ tại cơ sở dành cho nhà phát triển API) hay "OPDK" hiện là "Apigee Edge Developer Services cổng for Private Cloud".
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.
Các yêu cầu về Apigee Edge đối với cổng thông tin
Nếu đang kết nối bản phát hành này của cổng thông tin với một bản cài đặt của Edge for Private Cloud, thì bạn phải kết nối Edge 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 của SmartDocs được hỗ trợ. Vui lòng xem ghi chú phát hành của ứng dụng Apigee Edge về đám mây riêng tư (4.15.07.00) để biết thêm thông tin.
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
- 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.
- 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.
- Đặ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.
- 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.
- 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.
- 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 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-584 | Tham số đường dẫn không được ghi nhớ trong lần sử dụng đầu tiên Tham 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 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-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-723 | Hiện thông báo thân thiện với người dùng về lỗi nhập được từ SmartDocs |
| 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-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 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 |
| DEVSOL-1390 |
Thư viện PHP SDK Edge đã được cập nhật để khắc phục vấn đề gọi __toString() Lỗi nghiêm trọng: Gọi đến một 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/Xuất-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php trên dòng 221 Đây là lỗi chỉ ảnh hưởng đến 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ó lời nhắc người dùng Giờ đây, SmartDocs nhập ví dụ về mẫu thú cưng của cửa hà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 sẽ 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-1410 | Lỗi kết nối không rõ ràng khi cài đặt Cổng nhà phát triển Thêm thông báo lỗi tốt hơn cho 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 đề 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 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 sau khi quá trình cài đặt hoàn tất 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 hook 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 # hook_devconnect_developer_apps_analytics_Chart_data_alter() # hook_devconnect_developer_app_analytics_datapoints_params_alter() # hook_devconnect_developer_app_analytics_datapoints_alter() Điều này cho phép các mô-đun tùy 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 xoá lược đồ bảo mật, hệ thống sẽ cung cấp một hộp đánh dấu để chọn xem bạn có cần xoá 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 đế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. |
| DEVSOL-1486 | Cuộc gọi SmartDocs có thể xác thực bằng một khoá được xác định trước Bật tính năng xác thực bằng cả khoá API do người dùng cung cấp và khoá API 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ả thông số SmartDocs Mã HTML giờ đây được phân tích cú pháp trong phần mô tả thông số SmartDocs. |
| DEVSOL-1507 | Không thể thêm nhiều tham số vào API bằng phương thức thêm 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 nội dung", "Tài liệu nội dung" và "Mẫu nội dung" khi chỉnh sửa trang SmartDocs. |
| DEVSOL-1534 | Loại nội dung không được điền vào dữ liệu đầu ra của SmartDocs Loại nội dung hiện đang được điền vào trang phương thức SmartDocs. |
| DEVSOL-1554 | So sánh ngày không hợp lệ trong mục Kiếm tiền Trong thẻ gói đã mua trên cổng thông tin 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 đối với 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 vận chuyển Mô-đun media_youtube và mô-đun tính năng đã đượ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 kết xuất cho ví dụ về PetStore Trên các lượt cài đặt mới, các ví dụ về phương thức SmartDocs PetStore hiện hiển thị chính xác. |
| DEVSOL-1562 | Tạo khung hiển thị cho từng mô hình SmartDocs Khi tạo mô hình mới, theo mặc định, hệ thống sẽ tạo một khung hiển thị mới cho mô hình đó. |
| DEVSOL-1565 | Việc chỉnh sửa phương thức SmartDocs tạo ra lỗi nghiêm trọng Khắc phục vấn đề trong đó việc chỉnh sửa phương thức SmartDocs đôi khi gây ra lỗi. |
| DEVSOL-1567 | "Thêm mô hình" đang hiển thị ở trình đơn quản trị trên cùng Khắc phục sự cố khiến mục trong trình đơn "Thêm mô hình" xuất hiện ở trình đơn quản trị trên cùng. |
| DEVSOL-1576 | Khung hiển thị tài liệu API cho thấy 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 bạn nhấp vào "API" trong trình đơn cho thấy tên nội bộ của mô hình thay vì tên hiển thị. Nếu bạn đ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 hoàn nguyên 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ả các thao tác. # Nếu bạn thấy chữ "huỷ bỏ" thì tức là bạn đã ghi đè mã bằng thay đổi của chính bạn. Nhấp vào "đảo ngược" để đưa chế độ xem trở về trạng thái mặc định. 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 Weather và Petstore trên lượt cài đặt trang web Cả mô hình Petstore và Weather SmartDocs đề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 đề không gửi biểu mẫu mua gói kiếm tiền cho bản phát hành đám mây vào ngày 15.05.27.00 và 15.06.08.00 nếu bạn đang dùng giao diện thích ứng Apigee hoặc một 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ờ của nhà phát triển Chúng tôi đã khắc phục một lỗi trong đó chế độ cài đặt thời gian chờ kết nối Edge không được áp dụng đúng cách. |
| DEVSOL-1620 |
Tôi, chỉ báo môi trường và các bản nâng cấp mô-đun tính năng https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | Đảm bảo rằng arg_separator.output là '&' để ngăn lỗi reCAPTCHA Đã khắc phục một vấn đề liên quan đến nền tảng, trong đó việc sử dụng reCAPTCHA của Google bị lỗi. |
| DEVSOL-1651 | Giao diện API Apigee Base sẽ không hoạt động nếu không bật mô-đun Smartdocs Giao diện apigee_base không còn phụ thuộc vào việc bật mô-đun SmartDocs. |
| DEVSOL-1654 |
Tải phiên bản admin_view để phát hiện bản sửa lỗi bảo mật quan trọng
|