将 REST 设计推行到生产环境
在设计系统的新部分时,我们始终建议在开发实例中设计这些新部分,对其进行全面测试,然后将这些设计转移到生产中,而不是将任何新内容直接应用到生产环境。在设计使用 REST 行为的功能时,这一点尤其重要。
有关设计和使用 REST Web 服务行为的信息,请参阅将对象链接到 REST Web 服务。有关将 REST 推行到生产环境的更多详细信息,请参阅 Ivanti 社区。
如果使用 REST Web 服务来创建设计,在将行为添加到对象时,会创建一组新对象。然后需要将这些对象转移到生产环境。本节概述了将设计从非生产环境推行到生产环境中所需的步骤。可以使用实时测试或设计转移。
测试系统到实际系统
实时测试允许使用实时测试应用程序来推行整个设计,包括对象、窗口、REST 连接设置和请求主体定义。
REST 负载的主体存储在 ObjectBody 参考列表对象的参考列表中。实时测试只迁移新的参考列表,因此,如果更新或删除其中任何项目,则需要在生产系统中手动更新这些项目。有关使用实时测试的详细信息,请参阅Test to Live。
设计转移
本节介绍了如何使用设计转移将 REST 设计推行到生产环境中。有关设计转移的详细信息,请参阅通过设计传输从数据库导出设计和将项目导入数据库。
设计转移不会转移 REST Web 服务凭据或主体内容定义,因此请准备好以下信息,以便在完成设计转移导入之后输入:
- 端点 URI
- 身份验证详细信息(如果选择了基本或 API 密钥(提供商))
- 响应映射详细信息(如果需要)
- 请求主体内容
不要将请求主体对象的对象或窗口设计添加到设计转移文件。否则,在尝试运行导入时,会导致错误。
需要创建两个导出文件:一个用于对象设计,另一个用于窗口和 REST 主体数据。
要创建导出文件 1,即对象设计文件:
- 在源系统上启动设计转移组件,导航至 Business Objects 文件夹。
- 展开在其中创建了 REST 对象的模块文件夹。
- 展开顶级对象 Attributes 文件夹。
- 选择与 REST 对象相关的集合并纳入从属对象。
此操作也会选择要纳入的 REST 对象。 - 展开 REST 对象的 Attributes 文件夹,确保选择所有剩余的属性。
- 在操作列表上,点击导出所选项目,然后保存文件。
要创建导出文件 2,即窗口和 REST 主体数据:
- 重新启动设计转移组件,导航至 Reference 文件夹。
- 展开参考列表,然后展开包含 REST 对象的模块文件夹。
- 右键点击对象文件夹,然后点击选择。
此操作将选择所有请求主体定义。或者,展开文件夹并选择所需的定义。 - 导航至 Windows 文件夹,展开包含 REST 对象的模块文件夹。
- 展开 REST 对象文件夹,选择所需的窗口。不要纳入从属对象。
- 在操作列表上,点击导出所选项目,然后保存文件。
只会转移请求主体定义的名称。导入设计转移文件之后,需要添加请求主体定义。
创建两个设计转移文件之后,就可以将设计导入目标系统。
将设计导入目标系统:
- 在目标系统中,打开设计转移组件,选择导入选项。
- 在操作列表中,点击打开导入文件,选择在前面创建的文件 1。
- 对于缺少参考对象警报,选择不设置值,然后点击导入。
将会加载文件,同时创建 REST 主体对象。 - 单击确定。
- 在操作列表中,点击打开导入文件,选择在前面创建的文件 2。
加载文件之后,会出现许多警告。 - 对于所有系统中存在对象冲突警告,选择不要新建… 选项。
- 对于缺少参考对象警报,选择不设置值。
- 单击导入。
系统会创建为主 REST 对象选择的窗口,并且填充选中的 REST 主体参考列表条目。 - 单击确定。
导入过程的文件部分已经完成。现在需要完成目标系统的手动更新。
要完成设计转移的手动更新:
- 在对象设计器中,打开 REST 对象。
- 显示对象上的 REST Web 服务设置,添加连接详细信息,然后保存更改。
- 在窗口管理器中,依次导航至模块和 REST 对象,右键点击窗口,然后选择在 Web Access 中提供。
- 右键点击请求主体对象,为参考列表创建合适的窗口。
- 在管理组件中,展开参考列表树:
- 展开包含 REST 对象的模块,根据需要更新请求主体定义。还可以在此添加新定义。
REST 对象和相关数据现在可供使用。