4.15.07.00 - Apigee 开发者服务门户版本说明

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档
信息

2015 年 9 月 8 日,星期二,我们发布了适用于私有云的 Apigee Edge 开发者服务门户的季度版本。

“Apigee Edge 本地开发者服务门户”或“OPDK”以前的产品名称现已更名为“适用于私有云的 Apigee Edge 开发者服务门户”。

如果您有任何疑问,请转到 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 页面都将继续正常运行,但您必须按照更新流程操作,才能修改现有页面或新页面或发布任何更改。

请注意,虽然您可以在开发者门户内渲染和发布 SmartDoc,但 SmartDocs 是由 Apigee Edge API 管理服务中的 API 模型生成的。您在 Edge 中对 API 模型所做的任何更改在您的所有 Pantheon 环境中都相同(类似于开发者跨 Pantheon 环境中的存在方式)。

从 SmartDocs Beta 版升级到正式版

  1. 在 Pantheon 的devdev环境中更新并测试 15.05.27 版本。
  2. 创建新模型以替换您我们一直在使用的任何现有 API 模型。
    • 如果您一直在导入 Swagger 或 WADL 文档,请再次将其导入新的修订版本。
    • 如果您一直在通过 SmartDocs 模块维护 API 模型,请将模型导出为 SmartDocs JSON,并使用文件附件导入新模型。
  3. 设置模型修订版本的安全属性。在内容 > SmartDocs > 模型页面上,选择安全设置
  4. 点击“操作”列中的设置,在模型设置页面(内容 > SmartDocs)中检查所有预配置的身份验证。
  5. 将所有自定义模板更新为使用 v6 的 CSS 和 JS 资源,并进行更改以反映所有新的对象名称,例如 authSchemes 和 apiSchema。如需了解如何更新 SmartDocs 模板,请参阅使用 SmartDocs 记录 API
  6. 重新渲染并发布模型修订版本。
  7. 验证新文档后,将生产门户更新到 15.05.27 版本。

如果您是 Edge 企业客户,对升级流程有任何问题或疑虑,请发送电子邮件至 marsh@apigee.com 和 cnovak@apigee.com。否则,请使用 Apigee 社区获取最佳回复。

已修复 Bug

此版本修复了以下 bug。

问题 ID 说明
DEVSOL-487 “创收”功能中的日期格式应由管理员配置
现在,可在“创收”部分的“创收”中针对欧洲和美国的日期格式配置日期格式。
DEVSOL-584 首次使用时不记住路径参数
系统有时无法记住发出调用时的路径参数。
DEVSOL-603 “冲突方案”页面的格式有误
当购买的方案与现有方案重叠时,显示的页面格式现在很适合用户。
DEVSOL-709 SmartDocs:在发送包含空值的请求后无法修改网址模板参数
修复了以下问题:在方法文档中删除模板参数后,从 SmartDocs 发送请求后,模板参数无法修改。
DEVSOL-723 在 SmartDocs 导入失败时显示便于用户理解的消息
DEVSOL-1013 修改 Dev Portal 用户的电子邮件地址
修改个人资料页面中的电子邮件地址字段将不再停用,并且开发者可以更改其电子邮件地址。
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() 时会导致以下错误的问题:

严重错误:对第 221 行 /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php 中的非对象调用成员函数 format()

此 bug 只会影响自定义代码调用 toString() 方法的变现客户。

DEVSOL-1398 在安装时导入 SmartDocs Petstore 模型,而不提示用户
SmartDocs 现在会在网站安装期间导入 petstore swagger 示例 (http://petstore.swagger.io/v2/swagger.json),而不是天气模型,以便获得更详尽的 SmartDocs 使用示例。
DEVSOL-1407 如果有许多开发者,Cron 会失败
运行 Drupal Cron 时,大量开发者都会导致超时问题。当一个组织中的用户超过 200 人时,现在使用批处理。
DEVSOL-1410 安装开发门户时连接错误不明显
改进了当边缘管理连接无法正常运行时向安装程序提供的错误消息,以尽可能减少排查问题。
DEVSOL-1422 从 Apigee 配置文件中移除 SMTP 配置表单
安装过程不再询问您是否要配置 SMTP,您可以在安装完成后按照标准 Drupal 做法(启用 SMTP 模块并对其进行正确配置)完成此操作。
DEVSOL-1427

在 Devconnect 开发者应用模块中添加了钩子,以允许更改分析数据
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”菜单链接和相应视图
Dev Portal SmartDocs 现在默认包含指向主菜单中名为“API”的 SmartDocs 呈现的文档的链接,该链接会链接到具有已发布方法的任何模型。
DEVSOL-1486 SmartDocs 调用可以使用预定义的密钥进行身份验证
使用预先提供的 API 密钥和用户提供的 API 密钥启用身份验证。
DEVSOL-1499 SmartDocs 参数说明中无法解析 HTML 代码
现在,SmartDocs 参数说明中会解析 HTML 代码。
DEVSOL-1507 无法使用 Add 方法向 API 添加多个参数
现在,您可以在修改该方法时向 SmartDocs API 添加多个参数。
DEVSOL-1509 没有看到修改 SmartDocs API 的“sample”字段的方法
您现在可以在修改 SmartDocs 页面时设置“Body MIME 类型”“Body 文档”和“正文示例”。
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 在安装网站时同时渲染 Weather 和 Petstore 模型
Petstore 和 Weather SmartDocs 模型都会导入新网站中。
DEVSOL-1584 无法购买方案
解决了以下问题:如果您使用的是 Apigee 自适应主题或 Apigee 自适应主题的子主题,则无法为 Cloud 版本 15.05.27.00 和 15.06.08.00 提交创收方案购买表单。
DEVSOL-1597 无法更改开发者超时设置
修复了未正确应用 Edge 连接超时设置的错误。
DEVSOL-1620

Me、环境指示器和功能模块升级
对 ME 模块进行中等重要的安全更新,以及针对环境指示器和功能进行的模块更新。更多信息:

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
  • 查看批量操作