< Previous | Next >

Lesson 1: Adding the schema

A schema is required to design templates and generate documents.

For more information about how user names and passwords are stored, see Security considerations for IBM® Rational® Publishing Engine.

  1. Create a new document and start the REST Schema Discovery by clicking Data > Schema Discovery > REST Schema Discovery.
  2. Specify the connection details in the following fields:
    1. URL: Specify the base URL for the resource.
    2. Authentication Type: Select the authentication type from the list.
    3. User: Specify the user name if the resource is on secure location.
    4. Password: Specify the password if the resource is on secure location.
      Note: For more information about the base URL and the credentials, refer to the REST data source documentation.
  3. Click Next.
  4. In the Create a Resource window, specify the details for the new resource in the following fields:
    1. Name: Specify a name for the new resource.
    2. Description: Specify a description for the new resource.
    3. Relative path: Select the Manual Entry option to specify a relative path manually for the new resource or click Locate using data service to locate the resource.

      REST Resource Discovery Wizard

    4. To select the resources using the Locate using data service:
      1. In the left view, select an element in the XML schema tree.
      2. In Element attributes, select the href value from the attributes list box.

        Locate resource using data services

      3. Click Next. The resource URL is displayed for the selected resource.

        REST URL discovered by data source

      Note: Either select the URL and click Finish, or you can use the URL to locate the child resource.
  5. To use the URL to locate the child resource:
    1. Select the resource URL and click Next.
    2. Select an element in the XML schema tree from the left view.

      Locating child resource

    3. Select the href value from the Element attributes section and click Next. The resource URLs for the resource is displayed.
    4. Select the resource URL discovered by the data source.

      Child resource URLs discovered by data source

  6. Click Finish.

Lesson checkpoint

You have added a schema.
< Previous | Next >

Feedback