15.05.27.00 - Apigee 開發人員服務入口網站版本資訊

您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

我們在 2015 年 6 月 2 日星期二發布了新的雲端版 Apigee 開發人員服務入口網站。

如有任何疑問，請前往 Apigee 客戶服務團隊。

如需查看所有 Apigee Edge 版本資訊的清單，請參閱「Apigee 版本資訊」。

新功能

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 版升級至正式版

  1. 在 Pantheon 的開發或測試環境中更新及測試 15.05.27 版本。
  2. 建立新模型，取代您目前使用的任何現有 API 模型。
    • 如果您已匯入 Swagger 或 WADL 文件，請再次將這些文件匯入新的修訂版本。
    • 如果您一直透過 SmartDocs 模組維護 API 模型，請匯出為 SmartDocs JSON，然後使用檔案附件匯入新模型。
  3. 設定模型修訂版本的安全性屬性。在「內容」>「SmartDocs」>「模型」頁面中，選取「安全性設定」。
  4. 在「作業」欄中按一下「設定」，即可查看模型設定頁面 (「內容」>「SmartDocs」) 中預先設定的驗證機制。
  5. 更新所有自訂範本，以便使用 CSS 和 JS 素材資源的第 6 版，並進行變更，反映任何新的物件名稱，例如 authSchemes 和 apiSchema。如要瞭解如何更新 SmartDocs 範本，請參閱「使用 SmartDocs 為 API 製作說明文件」。
  6. 重新算繪及發布模型修訂版本。
  7. 驗證新版說明文件後，請將正式版入口網站更新至 15.05.27 版。

如果您是 Edge 企業客戶，並對升級程序有任何疑問或疑慮，請傳送電子郵件至 marsh@apigee.com 和 cnovak@apigee.com。如果沒有，請使用 Apigee 社群尋求最佳回覆。

修正的錯誤

這個版本修正了下列錯誤。

問題 ID 說明
DEVSOL-487 管理員應可設定營利功能中的日期格式
現在，您可以在營利功能的營利設定中，設定歐洲和美國的日期格式。
DEVSOL-603 「Conflict Plan」頁面格式不佳
當購買的方案與現有方案重疊時，現在顯示的頁面會以適合使用者的方式格式化。
DEVSOL-642 將用戶端層級設定從安全性設定移至範本設定
DEVSOL-709 SmartDocs：傳送含有空值要求後，無法編輯網址範本參數
修正在方法說明文件中刪除範本參數後，從 SmartDocs 傳送要求時，無法編輯範本參數的問題。
DEVSOL-1013 讓開發人員中心使用者的電子郵件地址可供編輯
編輯個人資料頁面中的電子郵件地址欄位不會再停用，開發人員可以變更電子郵件地址。
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 版
SmartDocs 現已位於內容選單下方，SmartDocs 設定則位於設定管理員選單下方。
DEVSOL-1390 PHP SDK Edge 程式庫已更新，以修正呼叫 __toString() 的問題
PHP SDK Edge 程式庫已更新，以修正在 DeveloperRatePlan 物件上呼叫 __toString() 的問題，這會產生以下錯誤：{quote}致命錯誤：在 /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php 的第 221 行，對非物件呼叫成員函式 format() {quote}這個錯誤只會影響 Monetization 客戶，因為他們的客製化程式碼會呼叫 toString() 方法。
DEVSOL-1398 SmartDocs Petstore 模型在安裝時會匯入，但不會提示使用者
為了提供更完整的 SmartDocs 使用範例，SmartDocs 會在網站安裝期間匯入 petstore swagger 範例 (http://petstore.swagger.io/v2/swagger.json)，而非天氣模型。
DEVSOL-1407 有許多開發人員時，Cron 會失敗
執行 Drupal cron 時，大量開發人員會導致逾時問題。當組織有超過 200 位使用者時，現在會使用批次程序。
DEVSOL-1470 建立「API」選單連結和對應的檢視畫面
現在，開發人員入口網站的 SmartDocs 預設會在「API」主選單中提供 SmartDocs 轉譯說明文件的連結，該連結會連結至任何含有已發布方法的模型。

已知問題

此版本包含下列已知問題：

問題 ID 說明
DEVSOL-1558
Petstore 範例 SmartDocs 方法頁面無法在新安裝的環境中正確顯示
SmartDocs 中的 Petstore 方法範例頁面無法在新安裝的環境中正確顯示。如要修正這個問題，請按照下列步驟操作：
  1. 在 Drupal 選單中依序選取「內容」>「SmartDocs」。
  2. 選取「Petstore Example」模型。
  3. 選取「Update Options」下方的「Render and publish nodes」。
  4. 按一下「選取 / 取消選取所有」核取方塊，即可選取所有節點。
  5. 按一下「更新」。

節點現在應該能正常顯示。