将 REST 设计推行到生产环境

在设计系统的新部分时，我们始终建议在开发实例中设计这些新部分，对其进行全面测试，然后将这些设计转移到生产中，而不是将任何新内容直接应用到生产环境。在设计使用 REST 行为的功能时，这一点尤其重要。

有关设计和使用 REST Web 服务行为的信息，请参阅将对象链接到 REST Web 服务。有关将 REST 推行到生产环境的更多详细信息，请参阅 Ivanti 社区。

如果使用 REST Web 服务来创建设计，在将行为添加到对象时，会创建一组新对象。然后需要将这些对象转移到生产环境。本节概述了将设计从非生产环境推行到生产环境中所需的步骤。可以使用实时测试或设计转移。

测试系统到实际系统

实时测试允许使用实时测试应用程序来推行整个设计，包括对象、窗口、REST 连接设置和请求主体定义。

REST 负载的主体存储在 ObjectBody 参考列表对象的参考列表中。实时测试只迁移新的参考列表，因此，如果更新或删除其中任何项目，则需要在生产系统中手动更新这些项目。有关使用实时测试的详细信息，请参阅Test to Live。

设计转移

本节介绍了如何使用设计转移将 REST 设计推行到生产环境中。有关设计转移的详细信息，请参阅通过设计传输从数据库导出设计和将项目导入数据库。

设计转移不会转移 REST Web 服务凭据或主体内容定义，因此请准备好以下信息，以便在完成设计转移导入之后输入：

  • 端点 URI
  • 身份验证详细信息（如果选择了基本或 API 密钥（提供商））
  • 响应映射详细信息（如果需要）
  • 请求主体内容

不要将请求主体对象的对象或窗口设计添加到设计转移文件。否则，在尝试运行导入时，会导致错误。

需要创建两个导出文件：一个用于对象设计，另一个用于窗口和 REST 主体数据。

要创建导出文件 1，即对象设计文件：

  1. 在源系统上启动设计转移组件，导航至 Business Objects 文件夹。
  2. 展开在其中创建了 REST 对象的模块文件夹。
  3. 展开顶级对象 Attributes 文件夹。
  4. 选择与 REST 对象相关的集合并纳入从属对象。
    此操作也会选择要纳入的 REST 对象。
  5. 展开 REST 对象的 Attributes 文件夹，确保选择所有剩余的属性。
  6. 在操作列表上，点击导出所选项目，然后保存文件。

要创建导出文件 2，即窗口和 REST 主体数据：

  1. 重新启动设计转移组件，导航至 Reference 文件夹。
  2. 展开参考列表，然后展开包含 REST 对象的模块文件夹。
  3. 右键点击对象文件夹，然后点击选择。
    此操作将选择所有请求主体定义。或者，展开文件夹并选择所需的定义。

    4. 只会转移请求主体定义的名称。导入设计转移文件之后，需要添加请求主体定义。

  4. 导航至 Windows 文件夹，展开包含 REST 对象的模块文件夹。
  5. 展开 REST 对象文件夹，选择所需的窗口。不要纳入从属对象。
  6. 在操作列表上，点击导出所选项目，然后保存文件。

创建两个设计转移文件之后，就可以将设计导入目标系统。

将设计导入目标系统：

  1. 在目标系统中，打开设计转移组件，选择导入选项。
  2. 在操作列表中，点击打开导入文件，选择在前面创建的文件 1。
  3. 对于缺少参考对象警报，选择不设置值，然后点击导入。
    将会加载文件，同时创建 REST 主体对象。
  4. 单击确定。
  5. 在操作列表中，点击打开导入文件，选择在前面创建的文件 2。
    加载文件之后，会出现许多警告。
  6. 对于所有系统中存在对象冲突警告，选择不要新建… 选项。
  7. 对于缺少参考对象警报，选择不设置值。
  8. 单击导入。
    系统会创建为主 REST 对象选择的窗口，并且填充选中的 REST 主体参考列表条目。
  9. 单击确定。

导入过程的文件部分已经完成。现在需要完成目标系统的手动更新。

要完成设计转移的手动更新：

  1. 在对象设计器中，打开 REST 对象。
  2. 显示对象上的 REST Web 服务设置，添加连接详细信息，然后保存更改。
  3. 在窗口管理器中，依次导航至模块和 REST 对象，右键点击窗口，然后选择在 Web Access 中提供。
  4. 右键点击请求主体对象，为参考列表创建合适的窗口。
  5. 在管理组件中，展开参考列表树：
  6. 展开包含 REST 对象的模块，根据需要更新请求主体定义。还可以在此添加新定义。
    REST 对象和相关数据现在可供使用。