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

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊

我們在 2015 年 6 月 2 日星期二發布了全新雲端版本的 Apigee Developer Services Portal。

如有任何問題，請前往 Apigee 客戶服務頁面。

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

全新功能

SmartDocs 正式發布

SmartDocs 已從 Beta 版升級為正式發布。更新和新功能包括：

  • 支援 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 的 dev 或 test 環境中更新並測試 15.05.27 版本。
  2. 建立新模型，取代已使用的任何現有 API 模型。
    • 如果您已匯入 Swagger 或 WADL 文件，請將這些文件再次匯入新的修訂版本。
    • 如果您一直透過 SmartDocs 模組維護 API 模型，請以 SmartDocs JSON 格式匯出，並使用檔案附件匯入新模型。
  3. 設定模型修訂版本的安全性屬性。在「內容」>「SmartDocs」>「模型」頁面上選取「安全性設定」。
  4. 按一下「作業」資料欄中的「設定」，在模型設定頁面 (依序點選「Content」>「SmartDocs」) 中檢查任何預先設定的驗證。
  5. 更新所有自訂範本，使其使用 CSS 和 JS 資產第 6 版，並進行變更，反映任何新的物件名稱，例如 authSchemes 和 apiSchema。如要瞭解如何更新 SmartDocs 範本，請參閱使用 SmartDocs 的文件 API。
  6. 重新轉譯並發布模型修訂版本。
  7. 驗證新說明文件後，請將 Production 入口網站更新至 15.05.27 版本。

如果您是 Edge 企業客戶，且對升級程序有問題或疑慮，請傳送電子郵件至 marsh@apigee.com 和 cnovak@apigee.com。否則，請使用 Apigee 社群獲得最好的回應。

修正錯誤

本次更新修正了下列錯誤。

問題 ID 說明
DEVSOL-487 營利中的日格式應由管理員設定
您現在可以在「營利」頁面的營利設定中，針對歐洲和美國日期格式設定日期格式。
DEVSOL-603 衝突方案頁面的格式有誤
購買與現有方案重疊的方案時，頁面現在會顯示適合使用者的格式。
DEVSOL-642 將用戶端層級設定從安全性設定移至範本設定
DEVSOL-709 SmartDocs：以空白值傳送要求後，無法編輯網址範本參數
修正在透過 SmartDocs 傳送要求後，刪除方法說明文件範本參數後會導致範本參數無法編輯的問題。
DEVSOL-1013 讓開發人員入口網站使用者電子郵件地址可供編輯
編輯個人資料頁面中的電子郵件地址欄位不會停用，開發人員也可以變更自己的電子郵件地址。
DEVSOL-1273 「模組清單」中顯示兩次「DevConnect Mint」
在「模組」下方，系統顯示「Dev Connect Mint」兩次。不過現在我們已順利解決這項問題。
DEVSOL-1313 支援 Swagger 和 WADL 的 JSON/YAML 檔案或網址匯入功能
現在可以透過網址匯入 WADL 檔案，並上傳 Swagger 檔案。
DEVSOL-1339 變更 SmartDocs 管理員選單位置
SmartDocs 位於內容選單下方，智慧文件設定位於「設定」管理員選單下方。
DEVSOL-1340 前往 Google Analytics (分析) 時移除 Beta 版
SmartDocs 位於內容選單下方，智慧文件設定位於「設定管理員」選單下方。
DEVSOL-1390 更新 PHP SDK Edge 程式庫以修正呼叫 __toString() 呼叫 {Apigee SDK Edge 程式庫} 的問題。針對在 DeveloperRatePlan 物件呼叫 __toString() 的 PHP SDK Edge 程式庫，這個問題會造成以下錯誤： {quote} 嚴重錯誤：在 /Applications/MAMP/htdocs/ordnance/ordnance/ordnance/ordnance 程式庫，呼叫成員 函式 format()
DEVSOL-1398 在安裝時匯入 SmartDocs Petstore Model，但使用者顯示提示
SmartDocs 現在會在安裝網站 (http://petstore.swagger.io/v2/swagger.json) 時匯入寵物店用品範例 (http://petstore.swagger.io/v2/swagger.json)，以獲得更全面的範例使用 SmartDocs。
DEVSOL-1407 如果有眾多開發人員，Cron 就會失敗
執行 Drupal Cron 時，有眾多開發人員造成逾時問題。如果機構有超過 200 位使用者，系統就會採用批次程序。
DEVSOL-1470 建立「API」選單連結和對應的檢視畫面
根據預設，開發人員入口網站 SmartDocs 會在名為「API」的主選單中，提供透過 SmartDocs 轉譯的說明文件連結，您可以連結至任何含有已發布方法的模型。

已知問題

這個版本包含下列已知問題：

問題 ID 說明
DEVSOL-1558
新安裝的 Petstore 範例 SmartDocs 方法頁面未正確轉譯
SmartDocs 中的 Petstore 方法頁面範例無法在新的安裝時正確轉譯。如何修正這個問題：
  1. 在 Drupal 選單中，依序選取「內容」>「SmartDocs」。
  2. 選取「Petstore 範例」模型。
  3. 選取「Update Options」下方的「Render and publish node」(轉譯及發布節點)。
  4. 按一下「Select / Unselect all」核取方塊，選取所有節點。
  5. 按一下「更新」。

節點現在應可正確顯示。