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.
Note: Rational Publishing Engine 1.3.0 and
later supports document generation from CLM environments that are enabled for fine-grained
components (for CLM 6.0.3 and later). Configuration for fine-grained components works the same way
as for global configurations.
Procedure
- Create a data source connection.
- In the Add data source connection window, click Select beside the Configuration field.
- 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.
- 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.
- Click Go to test the connection. An embedded web browser displays the OSLC delegated dialog box for you to select the configuration.
- Select a project area.
- Select a configuration from the list and click OK.

