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

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

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

如有任何問題，請與 Apigee Edge 支援團隊聯絡。

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

新功能

SmartDocs 正式發布

SmartDocs 已從 Beta 版畢業並全面上線。更新與新功能包括：

  • 支援 Swagger 2.0，包括透過檔案或 URL 匯入，以及支援自訂名稱的安全物件。
  • 改善範本的視覺設計，讓範本產生的 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 Enterprise 客戶，對升級程序有任何疑問或疑慮，請傳送電子郵件至 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 現在位於內容選單下方，而 SmartDocs 設定則位於設定管理選單下方。
DEVSOL-1340 前往 GA 時移除 Beta 版
SmartDocs 現在位於內容選單下方，而 SmartDocs 設定則位於設定管理選單下方。
DEVSOL-1390 PHP SDK Edge 程式庫已更新，修正呼叫 __toString() 的問題
PHP SDK Edge 程式庫已更新，修正對 DeveloperRatePlan 物件呼叫 __toString() 時發生的問題，這個問題會導致以下錯誤：{quote} Fatal error: Call to a member function format() on a non-object in /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php on line 221 {quote} 這項錯誤只會影響貨幣化客戶，且這些客戶的自訂程式碼會呼叫 toString() 方法。
DEVSOL-1398 SmartDocs Petstore 模型會在安裝期間匯入，不會提示使用者
SmartDocs 現在會在網站安裝期間匯入 petstore swagger 範例 (http://petstore.swagger.io/v2/swagger.json)， 而非天氣模型，以便提供更詳盡的 SmartDocs 使用範例。
DEVSOL-1407 開發人員眾多時，Cron 會失敗
執行 Drupal Cron 時，如果開發人員眾多，就會發生逾時問題。如果機構有超過 200 位使用者，系統現在會使用批次程序。
DEVSOL-1470 建立「API」選單連結和對應的檢視畫面
開發人員入口網站 SmartDocs 現在預設會提供「API」主選單的連結，其中包含已發布方法的任何模型。

已知問題

這個版本有下列已知問題：

問題 ID 說明
DEVSOL-1558
在新安裝的 SmartDocs 中，Petstore 範例方法頁面無法正確顯示
在新安裝的 SmartDocs 中，Petstore 方法頁面範例無法正確顯示。如要修正這個問題：
  1. 在 Drupal 選單中選取「Content」>「SmartDocs」。
  2. 選取「Petstore Example」模型。
  3. 選取「更新選項」下方的「算繪並發布節點」。
  4. 按一下「選取 / 取消選取全部」核取方塊，即可選取所有節點。
  5. 按一下「更新」。

節點現在應該可以正常算繪。