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

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

我們已於 2015 年 9 月 8 日 (星期二) 發布 Apigee Edge Developer Services Portal for Private Cloud 的季版。

舊版產品名稱「Apigee Edge On-premises Developer Services Portal」或「OPDK」,現在已改為「Apigee Edge Developer Services Portal for Private Cloud」。

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

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

入口網站的 Apigee Edge 需求

如果將這個版本的入口網站連線至 Edge for Private Cloud 安裝項目,則必須連線至 4.15.07.00 以上版本,才能確保支援所有 SmartDocs 功能。詳情請參閱「4.15.07.00 - Apigee Edge for Private Cloud 版本資訊」。

新功能

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-584 首次使用時,系統不會記住路徑參數
進行呼叫時,系統不一定會記住路徑參數。
DEVSOL-603 「衝突方案」頁面格式不佳
購買與現有方案重疊的方案時,系統現在會以適當格式向使用者顯示頁面。
DEVSOL-709 SmartDocs:以空白值傳送要求後,網址範本參數無法編輯
修正問題:從方法說明中刪除範本參數後,從 SmartDocs 傳送要求,導致範本參數無法編輯。
DEVSOL-723 在 SmartDocs 匯入失敗時顯示易於理解的訊息
DEVSOL-1013 允許編輯開發人員入口網站使用者電子郵件地址
編輯個人資料頁面的電子郵件地址欄位將不再停用, 開發人員可以變更電子郵件地址。
DEVSOL-1244 請勿為 OPDK 版本啟用環境指標模組
DEVSOL-1273 「DevConnect Mint」在「模組」清單中顯示兩次
「模組」下方顯示「Dev Connect Mint」兩次。不過現在我們已順利解決這項問題。
DEVSOL-1313 支援匯入 Swagger 和 WADL 的 JSON/YAML 檔案或網址
現在可以透過網址匯入 WADL 檔案,以及上傳 Swagger 檔案。
DEVSOL-1339 變更 SmartDocs 管理選單位置
SmartDocs 現在位於內容選單下方,而 SmartDocs 設定則位於設定管理選單下方。
DEVSOL-1340 前往 Google Analytics 時移除 Beta 版
DEVSOL-1390

PHP SDK Edge 程式庫已更新,修正呼叫 __toString() 的問題
PHP SDK Edge 程式庫已更新,修正對 DeveloperRatePlan 物件呼叫 __toString() 時會產生這個錯誤的問題:

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

這項錯誤只會影響使用自訂程式碼呼叫 toString() 方法的營利客戶。

DEVSOL-1398 SmartDocs Petstore 模型在安裝時匯入,不會提示使用者
SmartDocs 現在會在網站安裝期間匯入寵物商店 Swagger 範例 (http://petstore.swagger.io/v2/swagger.json) ,而不是天氣模型,以便提供更詳盡的 SmartDocs 使用範例。
DEVSOL-1407 開發人員人數眾多時,Cron 會失敗
執行 Drupal Cron 時,如果開發人員人數眾多,就會發生逾時問題。如果機構有超過 200 位使用者,系統現在會使用批次程序。
DEVSOL-1410 安裝開發人員入口網站時,連線錯誤不明顯
如果 Edge 管理連線無法運作,安裝程式會顯示更明確的錯誤訊息,盡量減少疑難排解問題。
DEVSOL-1422 從 Apigee 設定檔中移除 SMTP 設定表單
安裝程序不會再詢問是否要設定 SMTP,而是會在安裝完成後,按照標準 Drupal 做法啟用 SMTP 模組並正確設定。
DEVSOL-1427

在 Devconnect 開發人員應用程式模組中新增掛鉤,允許變更 Analytics 資料
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」主選單的連結,其中包含已發布方法的任何模型。
DEVSOL-1486 SmartDocs 呼叫可使用預先定義的金鑰進行驗證
可使用預先提供和使用者提供的 API 金鑰進行驗證。
DEVSOL-1499 SmartDocs 參數說明中未剖析 HTML 程式碼
SmartDocs 參數說明現在會剖析 HTML 程式碼。
DEVSOL-1507 無法使用「新增方法」將多個參數新增至 API
現在編輯方法時,可以將多個參數新增至 SmartDocs API。
DEVSOL-1509 找不到編輯 SmartDocs API「範例」欄位的方法
現在編輯 SmartDocs 頁面時,可以設定「內文 MIME 類型」、「內文說明文件」和「內文範例」。
DEVSOL-1534 SmartDocs 輸出內容未填入 Content-type
SmartDocs 方法頁面現在會填入 Content-type。
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 說明文件頁面會顯示模型的內部名稱,而非顯示名稱。如果您要更新至這個版本,且已變更這個檢視畫面,請按照下列步驟還原檢視畫面,才能看到這些變更:# 以管理員身分登入 # 前往「Structure」>「Views」# 按一下「SmartDocs Models」上「Edit」旁的下拉式選單,即可查看所有作業。# If you see "revert", then you have overwritten the code w/your own change. 按一下「還原」,即可將檢視畫面恢復為預設狀態。請注意,這會移除您對這個檢視畫面所做的任何變更。
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

https://www.drupal.org/project/features

DEVSOL-1648 請確認 arg_separator.output 為「&」,以免 reCAPTCHA 發生中斷
我們已修正平台相關問題,現在可正常使用 Google reCAPTCHA。
DEVSOL-1651 如果未啟用 SmartDocs 模組,Apigee Base 主題會失敗
apigee_base 主題不再需要啟用 SmartDocs 模組。
DEVSOL-1654

調升 admin_views 版本,以取得重大安全性修正
下列 contrib 模組已更新:

  • 管理檢視畫面
  • 遷移
  • 重新導向
  • Redis
  • 查看大量作業