Setting up a data source to generate configuration-aware documents

You can use a configuration URI to generate documents that report on artifacts in configurations, if the project in your data source has enabled configuration management.

About this task

Configurations group a specific set of versioned artifacts. Configurations commonly identify one version, or referenceable state, of each artifact in the set. A team, for example, might group all the requirements for a specific component into a configuration, so it is easier to identify and work with all the requirements associated with that component.

Rational® Publishing Engine discovers the URL of the OSLC delegated dialog box by reading the service provider resource of the configuration service.

Procedure

  1. Create a data source connection.
  2. In the Add data source connection window, click Select beside the Configuration field.
  3. Select a common provider. The Common providers field provides a list of predefined providers that you can use to populate the Configuration provider field. If you choose a common provider, then you only have to change the host name and port number.
  4. Alternatively, you can also manually enter the configuration provider in the Configuration provider field, for example https://<server>:9443/qm/_ajax-modules/com.ibm.rqm.configmanagement.ConfigurationPicker.
  5. Click Go to test the connection. An embedded web browser displays the OSLC delegated dialog box for you to select the configuration.
  6. Select a project area.
  7. Select a configuration from the list and click OK.
    config_picker

Feedback