您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息
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,包括通过文件或网址导入,还支持自定义命名的安全对象。
- 改进了生成 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 版升级到正式版
- 在 Pantheon 的开发或测试环境中更新并测试 15.05.27 版本。
- 创建新模型以替换您一直在使用的任何现有 API 模型。
- 如果您之前导入过 Swagger 或 WADL 文档,请将它们再次导入到新的修订版本中。
- 如果您一直通过 SmartDocs 模块维护 API 模型,请导出为 SmartDocs JSON,然后使用文件附件导入到新模型中。
- 设置模型修订版本的安全属性。在内容 > SmartDocs > 模型页面上,选择安全设置。

- 点击“操作”列中的设置,在模型设置页面(内容 > SmartDocs)中检查所有预配置的身份验证。

- 更新所有自定义模板,以使用 CSS 和 JS 资源的版本 6,并进行更改以反映所有新对象名称,例如 authSchemes 和 apiSchema。如需了解如何更新 SmartDocs 模板,请参阅使用 SmartDocs 记录 API。
- 重新渲染并发布模型修订版本。
- 验证新文档后,将您的生产门户更新到 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 | 使开发者门户网站用户电子邮件地址可修改 “修改个人资料”页面中的电子邮件地址字段将不再处于停用状态,开发者可以更改自己的电子邮件地址。 |
| DEVSOL-1244 | 不为 OPDK 版本启用环境指示器模块 |
| DEVSOL-1273 | “DevConnect Mint”在模块列表中显示两次 在“模块”下,“Dev Connect Mint”显示了两次。此问题现已解决。 |
| DEVSOL-1313 | 支持通过 JSON/YAML 文件或网址导入 Swagger 和 WADL 现在可以通过网址导入 WADL 文件,也可以上传 Swagger 文件。 |
| DEVSOL-1339 | 更改 SmartDocs 管理员菜单位置 SmartDocs 现在位于内容菜单下,而 SmartDocs 设置位于设置管理员菜单下。 |
| DEVSOL-1340 | 在发布正式版时移除 Beta 版 |
| DEVSOL-1390 |
PHP SDK Edge 库已更新,以修复调用 __toString() 时出现的问题 致命错误:在 /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php 的第 221 行上,对非对象调用了成员函数 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 | 安装开发者门户时连接错误不明显 在 Edge 管理连接无法正常工作时,向安装程序添加了更明确的错误消息,以尽可能减少问题排查。 |
| DEVSOL-1422 | 从 Apigee 配置文件中移除了 SMTP 配置表单 安装过程不再询问您是否要配置 SMTP,而是可以在安装完成后执行此操作,方法是按照标准的 Drupal 做法启用 SMTP 模块并正确配置它。 |
| DEVSOL-1427 |
向 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 现在默认在主菜单中提供指向 SmartDocs 呈现的文档的链接,该链接名为“API”,可链接到任何具有已发布方法的模型。 |
| DEVSOL-1486 | SmartDocs 调用可以使用预定义的密钥进行身份验证 支持使用预先提供的 API 密钥和用户提供的 API 密钥进行身份验证。 |
| DEVSOL-1499 | SmartDocs 参数说明中未解析 HTML 代码 现在,SmartDocs 参数说明中会解析 HTML 代码。 |
| DEVSOL-1507 | 无法使用 Add 方法向 API 添加多个参数 现在,您可以在编辑方法时向 SmartDocs API 添加多个参数。 |
| DEVSOL-1509 | 找不到用于修改 SmartDocs API 的“示例”字段的方法 现在,您可以在修改 SmartDocs 页面时设置“正文 MIME 类型”“正文文档”和“正文示例”。 |
| DEVSOL-1534 | SmartDocs 输出中未填充内容类型 现在,SmartDocs 方法页面中会填充内容类型。 |
| 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 文档页面显示的是模型的内部名称,而非显示名称。如果您要更新到该版本,并且已更改此视图,则需要按照以下步骤将视图恢复原样,才能看到这些更改:# 以管理员身份登录 # 前往“结构”>“视图”# 点击“SmartDocs 模型”上“修改”旁边的下拉菜单,查看所有操作。# 如果您看到“还原”,则说明您已使用自己的更改覆盖了代码。点击“恢复”即可将视图恢复为默认状态。请注意,此操作会移除您对此视图所做的任何更改。 |
| DEVSOL-1578 | 在网站安装时同时呈现天气和 Petstore 模型 Petstore 和天气 SmartDocs 模型均已导入到新网站中。 |
| DEVSOL-1584 | 无法购买方案 修复了以下问题:如果您使用的是 Apigee 响应式主题或 Apigee 响应式主题的子主题,则创收方案购买表单无法针对云版本 15.05.27.00 和 15.06.08.00 提交。 |
| DEVSOL-1597 | 无法更改开发者超时设置 修复了 Edge 连接超时设置未正确应用的 bug。 |
| DEVSOL-1620 |
“我”模块、环境指示器和功能模块升级 https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | 确保 arg_separator.output 为“&”,以防止 reCAPTCHA 损坏 修复了与平台相关的使用 Google reCAPTCHA 时出现的问题。 |
| DEVSOL-1651 | 如果未启用 SmartDocs 模块,Apigee Base 主题会失败 apigee_base 主题不再依赖于 SmartDocs 模块是否已启用。 |
| DEVSOL-1654 |
提升了 admin_views 的版本以获取关键安全修复
|