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

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

我們在 2015 年 9 月 8 日星期二為私有雲發布了每季版本的 Apigee Edge Developer Services 入口網站。

原先產品名稱的「Apigee Edge On-Pre-Developer Services Portal」或「OPDK」現已改名為「Apigee Edge Developer Services Portal for Private Cloud」。

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

如需所有 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,包括依檔案或網址匯入,包括支援自訂命名的安全性物件。
  • 改善產生 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 的 devtest 環境中更新並測試 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-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 位於內容選單下方,智慧文件設定位於「設定」管理員選單下方。
DEVSOL-1340 前往正式發布版時移除 Beta 版
DEVSOL-1390

更新 PHP SDK Edge 程式庫以修正呼叫 __toString() 的問題
PHP SDK Edge 程式庫已更新,修正了對 DeveloperRatePlan 物件呼叫 __toString() 的問題:

嚴重錯誤:在 /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/library/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php 中的第 221 行中,對非物件呼叫成員 function format()

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

DEVSOL-1398 在安裝時匯入 SmartDocs Petstore Model,但使用者顯示提示
SmartDocs 現在會在安裝網站 (http://petstore.swagger.io/v2/swagger.json) 時匯入寵物店用品範例 (而非天氣模型),以便獲得更完整的使用 SmartDocs 範例。
DEVSOL-1407 如果有眾多開發人員,Cron 就會失敗
執行 Drupal Cron 時,有大量開發人員會造成逾時問題。如果機構有超過 200 位使用者,系統就會採用批次程序。
DEVSOL-1410 安裝開發入口網站時沒有明顯的連線錯誤
在 Edge 管理連線無法正常運作時,向安裝程式顯示更優質的錯誤訊息,以盡量減少疑難排解問題。
DEVSOL-1422 從 Apigee 設定檔中移除 SMTP 設定表單
安裝程序不會再詢問您是否要設定 SMTP,而您可以在安裝完成並依下列方式啟用 SMTP 模組並正確設定後,即可進行安裝。
DEVSOL-1427

在 Devconnect Developer Apps 模組中新增掛鉤,以允許修改數據分析資料
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 金鑰和使用者提供的 API 金鑰進行驗證。
DEVSOL-1499 SmartDocs 參數說明中未剖析 HTML 程式碼
系統現在會在 SmartDocs 參數說明中剖析 HTML 程式碼。
DEVSOL-1507 無法使用「新增方法」在 API 中加入多個參數
現在您可以在編輯 SmartDocs API 時,同時加入多個參數。
DEVSOL-1509 沒看到編輯 SmartDocs API 的「範例」欄位的方法
您現在可以在編輯 SmartDocs 頁面時,設定「內文 MIME 類型」、「內文文件」和「內文範例」。
DEVSOL-1534 SmartDocs 輸出內容中不會填入內容類型
系統現在會在 SmartDocs 方法頁面中填入內容類型。
DEVSOL-1554 營利中的日期比較無效
在已啟用營利功能的開發人員入口網站中,購買方案分頁的「取消」按鈕未顯示「取消」按鈕,按鈕則是未來的開始日期。
DEVSOL-1556 即將發布的舊版 Drupal 模組
media_youtube 和功能模組已更新為最新版本。
DEVSOL-1558 PetStore 的 SmartDocs 方法頁面無法轉譯範例
新的安裝作業範例 SmartDocs PetStore 方法現在可正確顯示。
DEVSOL-1562 為每個 SmartDocs 模型產生檢視表
建立新模型時,系統預設會為該模型建立新的檢視畫面。
DEVSOL-1565 編輯 SmartDocs 方法會產生嚴重錯誤
修正編輯 SmartDocs 方法有時可能會發生錯誤的問題。
DEVSOL-1567 頂端管理員選單顯示「新增模型」
修正頂端管理員選單顯示「新增模型」選單項目的問題。
DEVSOL-1576 API 說明文件檢視畫面會顯示模型名稱,而非顯示名稱
按一下選單中的「API」後,顯示的 API 說明文件頁面會顯示模型的內部名稱,而非顯示名稱。如果您更新至版本並變更了這個檢視畫面,則必須按照下列步驟還原檢視畫面,才能看到這些變更:# 以管理員身分登入 # 前往 [結構] > [資料檢視] # 在「SmartDocs 模型」中按一下「編輯」旁的下拉式選單,即可查看所有作業。# 如果看見「還原」,就表示您已自行修改程式碼覆寫程式碼。按一下「還原」,讓檢視畫面恢復預設狀態。請注意,您對這個資料檢視所做的任何變更都會遭到移除。
DEVSOL-1578 在安裝網站同時呈現天氣和 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 基礎主題會失敗
apigee_base 主題已不再依附於 SmartDocs 模組。
DEVSOL-1654

按下 admin_views 版本,選擇擷取重要的安全性修正項目
下列 contrib 模組已更新:

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