连接至 REST 数据源

可通过显示 Rational® REST Get 规范来从 REST V1 或 REST V2 数据源抽取数据。

开始之前

配置 REST 数据源需要资源的 URL。如果资源存储在受保护的服务器上,那么需要用户名和密码。

有关用户名和密码的存储方式的更多信息,请参阅 IBM® Rational Publishing Engine 的安全性注意事项

过程

  1. 在“文档规范”窗口中,展开模板 > 数据源
  2. 右键单击该数据源并选择配置选项:
    • 如果对于该数据源,存在配置层元数据,请单击使用元数据来进行配置
      1. 如果连接至配置层元数据中指定的数据源需要认证,那么一个窗口会打开,可在其中输入您的用户名、密码和认证类型。单击确定
      2. 从配置层中选择要使用的值,并单击确定

        从配置层中选择值之后,该数据源已配置,并且您不需要完成此任务的剩余部分。

    • 如果对于该数据源,不存在配置层元数据,请单击配置数据源并继续至下一步骤。
  3. 指定 REST 资源的资源信息:
    1. URL:指定资源的基本 URL。如果不知道 URL,请单击发现以定位该资源。 如果已单击发现,请继续至步骤 4,而不必完成此步骤中的剩余子步骤。
    2. 用户:如果资源位于受保护的服务器,请指定用户名。
    3. 密码:如果资源位于受保护的服务器,请指定密码。
    4. 认证:选择适用于您的数据源的认证类型。 可以选择下列其中一种认证类型:
      • Auto
      • Basic
      • Form
      • OAuth
    5. 接受头:输入您的样式表的接受类型。 示例:
      • image/jpeg
      • text/html
      • application/xml
      • */*
    6. 单击确定
  4. 如果已单击发现来查找资源,请完成向导:
    1. 在“欢迎”窗口中,单击下一步
    2. 在“基本配置”窗口中,指定数据源的详细信息:
      • 名称:对数据源指定名称。
      • 描述:对数据源指定描述。
      • 基本 URL:针对具有 href 属性的资源,提供了资源导航。
      • 认证类型:选择适用于您的数据源的认证类型。
      • 用户密码:用于向数据源应用程序认证的凭证。
      • 选择上下文:用于 Design Management 数据源。
    3. 选择资源。 会对您输入的基本 URL 自动追加 ?metadata=schema 要选择资源,请执行下列操作:
      • 在“使用数据服务来查找资源”窗口的“XML 模式”部分中,展开资源列表。
      • 在“元素属性”部分中,选择 href 并单击下一步
      • 单击下一步。此时,会显示所选资源的资源 URL。
    4. 选择 URL 并单击完成,或者使用 URL 来定位子资源。 此时,向导会完成,并且 URL 会显示在“配置”窗口中。如果资源存储在受保护的服务器上,请在“配置”窗口中输入用户名和密码。
  5. 单击确定。此时,会完成 REST 数据配置过程,而且会将信息添加至“文档规范”窗口。

示例

有关识别基本 URL 的更多信息,请参阅关于数据源的集成文档。

反馈