您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info
我們在 2015 年 9 月 8 日星期二發布了 Apigee Edge 開發人員服務入口網站的季度版本，適用於私有雲。
原先的產品名稱「Apigee Edge 內部開發人員服務入口網站」或「OPDK」現已改為「Apigee Edge 私人雲端開發人員服務入口網站」。
如有任何疑問，請前往 Apigee 客戶服務團隊。
如需查看所有 Apigee Edge 版本資訊的清單，請參閱「Apigee 版本資訊」。
入口網站的 Apigee Edge 需求
如果您要將這個版本的入口網站連結至私有雲 Edge 安裝作業，則必須連結至 4.15.07.00 以上版本，確保系統支援所有 SmartDocs 功能。詳情請參閱 4.15.07.00 - Apigee Edge for Private Cloud 版本資訊。
新功能
SmartDocs 正式發布
SmartDocs 已從測試版畢業並全面上線。更新和新功能包括：
- 支援 Swagger 2.0，包括透過檔案或網址匯入，以及支援自訂名稱的安全性物件。
- 改善產生 SmartDocs 的範本視覺設計。
- 開發人員入口網站中的可用性和工作流程強化功能，可透過 Drupal 中的「內容」>「SmartDocs」選單存取。
- 先前的「自訂權杖」驗證機制現已改稱為「API 金鑰」。
- 在修訂版本層級定義的驗證「安全性」物件。
- 在範本層級設定用戶端驗證機制。新修訂版本不再重設任何預先設定的 SmartDocs 用戶端憑證。
如需更多功能說明，請參閱這篇網誌文章。
如需 SmartDocs 說明文件，請參閱「使用 SmartDocs 來記錄 API」。
SmartDocs 升級程序
如果您在 Beta 版期間已開始使用 SmartDocs，則必須在開發人員入口網站中升級 SmartDocs，才能使用正式版的全新功能。
在開發人員入口網站中發布的任何 SmartDocs 頁面都會繼續運作，但您必須先按照更新程序操作，才能編輯或發布現有或新頁面的任何變更。
請注意，雖然您可以在開發人員入口網站中轉譯及發布 SmartDocs，但 SmartDocs 是根據 Apigee 的 Edge API 管理服務中 API 模型產生。您在 Edge 中對 API 模型所做的任何變更，都會在所有 Pantheon 環境中保持一致 (類似於開發人員在各個 Pantheon 環境中存在的情況)。
如何從 SmartDocs Beta 版升級至正式版
- 在 Pantheon 的開發或測試環境中更新及測試 15.05.27 版本。
- 建立新模型，取代您目前使用的任何現有 API 模型。
- 如果您已匯入 Swagger 或 WADL 文件，請再次將這些文件匯入新的修訂版本。
- 如果您一直透過 SmartDocs 模組維護 API 模型，請匯出為 SmartDocs JSON，然後使用檔案附件匯入新模型。
- 設定模型修訂版本的安全性屬性。在「內容」>「SmartDocs」>「模型」頁面中，選取「安全性設定」。
- 在「作業」欄中按一下「設定」，即可查看模型設定頁面 (「內容」>「SmartDocs」) 中預先設定的驗證機制。
- 更新所有自訂範本，以便使用 CSS 和 JS 素材資源的第 6 版，並進行變更，反映任何新的物件名稱，例如 authSchemes 和 apiSchema。如要瞭解如何更新 SmartDocs 範本，請參閱「使用 SmartDocs 為 API 製作說明文件」。
- 重新算繪及發布模型修訂版本。
- 驗證新版說明文件後，請將正式版入口網站更新至 15.05.27 版。
如果您是 Edge 企業客戶，並對升級程序有任何疑問或疑慮，請傳送電子郵件至 marsh@apigee.com 和 cnovak@apigee.com。如果沒有，請使用 Apigee 社群尋求最佳回覆。
修正的錯誤
這個版本修正了下列錯誤。
| 問題 ID | 說明 |
|---|---|
| DEVSOL-487 | 管理員應可設定營利功能中的日期格式 現在，您可以在營利功能的營利設定中，設定歐洲和美國的日期格式。 |
| DEVSOL-584 | 路徑參數在首次使用時未記住 在進行呼叫時，系統不一定會記住路徑參數。 |
| DEVSOL-603 | 「Conflict Plan」頁面格式不佳 當購買的方案與現有方案重疊時，現在顯示的頁面會以適合使用者的方式格式化。 |
| DEVSOL-709 | SmartDocs：傳送含有空值要求後，無法編輯網址範本參數 修正在方法說明文件中刪除範本參數後，從 SmartDocs 傳送要求時，無法編輯範本參數的問題。 |
| DEVSOL-723 | 在 SmartDocs 匯入失敗時顯示友善使用者訊息 |
| DEVSOL-1013 | 讓開發人員中心使用者的電子郵件地址可供編輯 編輯個人資料頁面中的電子郵件地址欄位不會再停用，開發人員可以變更電子郵件地址。 |
| DEVSOL-1244 | 不要為 OPDK 版本啟用環境指標模組 |
| DEVSOL-1273 | 「DevConnect Mint」在「Modules」清單中顯示兩次 「Modules」下方顯示兩次「DevConnect Mint」。不過現在我們已順利解決這項問題。 |
| DEVSOL-1313 | 支援 JSON/YAML 檔案或網址匯入功能，適用於 Swagger 和 WADL 現在可以透過網址匯入 WADL 檔案，也可以上傳 Swagger 檔案。 |
| DEVSOL-1339 | 變更 SmartDocs 管理員選單位置 SmartDocs 現已位於內容選單下方，而 SmartDocs 設定則位於設定管理員選單下方。 |
| DEVSOL-1340 | 前往 GA 時移除 Beta 版 |
| DEVSOL-1390 |
PHP SDK Edge 程式庫已更新，以修正呼叫 __toString() 的問題 致命錯誤：在 /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php 的 221 行，對非物件呼叫成員函式 format() 這個錯誤只會影響營利服務客戶，且僅會影響呼叫 toString() 方法的自訂程式碼。 |
| DEVSOL-1398 | SmartDocs Petstore 模型在安裝時會匯入，但不會提示使用者 為了提供更完整的 SmartDocs 使用範例，SmartDocs 會在網站安裝期間匯入 petstore swagger 範例 (http://petstore.swagger.io/v2/swagger.json)，而非天氣模型。 |
| DEVSOL-1407 | 有許多開發人員時，Cron 會失敗 執行 Drupal cron 時，大量開發人員會導致逾時問題。當機構有超過 200 位使用者時，現在會使用批次程序。 |
| DEVSOL-1410 | 安裝開發人員入口網站時，連線錯誤訊息不明顯 在 Edge 管理連線無法運作時，安裝程式會顯示更明確的錯誤訊息，以便盡量減少疑難排解問題。 |
| DEVSOL-1422 | 從 Apigee 設定檔移除 SMTP 設定表單 安裝程序不再詢問您是否要設定 SMTP，而是在安裝完成後，按照標準 Drupal 做法啟用 SMTP 模組並正確設定，即可完成設定。 |
| DEVSOL-1427 |
在 Devconnect Developer Apps 模組中新增鉤子，以便修改分析資料 # hook_devconnect_developer_apps_analytics_chart_data_alter() # hook_devconnect_developer_app_analytics_datapoints_params_alter() # hook_devconnect_developer_app_analytics_datapoints_alter() 這些設定可讓自訂模組變更開發人員應用程式分析圖表。 |
| DEVSOL-1464 | 儲存模型的驗證設定時發生嚴重錯誤 現在，刪除安全性配置時，系統會提供核取方塊，讓您選取是否也要刪除相關聯的範本驗證配置。 |
| DEVSOL-1470 | 建立「API」選單連結和對應的檢視畫面 現在，開發人員入口網站的 SmartDocs 預設會在「API」主選單中提供 SmartDocs 轉譯說明文件的連結，該連結會連結至任何含有已發布方法的模型。 |
| DEVSOL-1486 | SmartDocs 呼叫可使用預先定義的金鑰進行驗證 啟用預先提供和使用者提供的 API 金鑰驗證。 |
| DEVSOL-1499 | HTML 程式碼未在 SmartDocs 參數說明中剖析 現在，HTML 程式碼會在 SmartDocs 參數說明中剖析。 |
| DEVSOL-1507 | 無法透過「新增方法」將多個參數新增至 API 現在，您可以在編輯方法時，將多個參數新增至 SmartDocs API。 |
| DEVSOL-1509 | 找不到編輯 SmartDocs API 的「sample」欄位的方法 現在您可以在編輯 SmartDocs 頁面時設定「Body MIME type」、「Body documentation」和「Body sample」。 |
| DEVSOL-1534 | SmartDocs 輸出內容未填入內容類型 現在已在 SmartDocs 方法頁面中填入內容類型。 |
| DEVSOL-1554 | 營利功能中的日期比較無效 在已啟用營利功能的開發人員入口網站中，如果方案的開始日期在未來，系統就不會顯示「取消」按鈕。 |
| DEVSOL-1556 | 發布的 Drupal 模組為舊版 media_youtube 和 features 模組已更新至最新版本。 |
| DEVSOL-1558 | SmartDocs 方法頁面無法為 PetStore 範例顯示 在新的安裝作業中，範例 SmartDocs PetStore 方法現在可以正確顯示。 |
| DEVSOL-1562 | 為每個 SmartDocs 模型產生檢視畫面 建立新模型時，系統會根據預設為該模型建立新檢視畫面。 |
| DEVSOL-1565 | 編輯 SmartDocs 方法會產生致命錯誤 修正編輯 SmartDocs 方法時有時會產生錯誤的問題。 |
| DEVSOL-1567 | 「新增模型」顯示在頂端管理員選單中 修正「新增模型」選單項目顯示在頂端管理員選單中的問題。 |
| DEVSOL-1576 | API 說明文件檢視畫面顯示的是型號名稱，而非顯示名稱 在選單中按一下「API」時，API 說明文件頁面會顯示型號的內部名稱，而非顯示名稱。如果您要更新至這項版本，且已變更這個檢視畫面，則需要按照下列步驟還原檢視畫面，才能查看這些變更：# 以管理員身分登入 # 前往「結構」>「檢視畫面」# 按一下「SmartDocs 模型」上「編輯」旁的下拉式選單，即可查看所有作業。# 如果您看到「revert」，表示您已覆寫程式碼，按一下「還原」即可將檢視畫面還原為預設狀態。請注意，這麼做會移除您對這個檢視畫面所做的所有變更。 |
| DEVSOL-1578 | 在網站安裝作業中同時算繪 Weather 和 Petstore 模型 在新的網站中匯入 Petstore 和 Weather SmartDocs 模型。 |
| DEVSOL-1584 | 無法購買方案 如果您使用的是 Apigee 響應式主題或 Apigee 響應式主題的子主題，則已修正雲端版本 15.05.27.00 和 15.06.08.00 的營利方案購買表單無法提交的問題。 |
| DEVSOL-1597 | 無法變更開發人員逾時設定 修正了 Edge 連線逾時設定未正確套用的錯誤。 |
| DEVSOL-1620 |
「我」模組、環境指標和功能模組升級 https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | 請確認 arg_separator.output 為 '&'，以免 reCAPTCHA 無法運作 Google reCAPTCHA 無法運作的平台相關問題已修正。 |
| DEVSOL-1651 | 未啟用 SmartDocs 模組，Apigee Base 主題會失敗 apigee_base 主題不再依賴啟用 SmartDocs 模組。 |
| DEVSOL-1654 |
更新 admin_views 版本，以便採用重要安全性修復功能
|