Discovering an OSLC resource for global configurations

You can discover the value of a configuration URI to support document-style report generation for configurations.

Before you begin

Refer to the documentation of the configuration provider for specific information needed to complete the OSLC Selection details.

About this task

Document specifications have a data source property that specifies the configuration URI. If this property is defined, an OSLC configuration HTTP header is added to every HTTP GET request made to the data service. This header is processed by any configuration-capable data service. The global configuration property value might be changed by scripts in the document template during document-style report generation. IBM Engineering Lifecycle Optimization - Publishing discovers the URL of the OSLC delegated dialog box by reading the service provider resource of the configuration service. An embedded web browser opens the OSLC window where you can select the configuration.
Note: Version 1.3.0 and later support document-style report generation from Engineering Lifecycle Management environments that are enabled for configuration management (version 6.0.3 and later). Local configurations work the same way as global configurations.

To generate document-style reports in the context of a specific configuration, you must select the configuration that you want in the document specification.

Procedure

  1. In the Document Specification view, right-click your data source and select OSLC Configuration Selection to open the OSLC Service Discovery and Selection wizard.
  2. Specify the Root service document of the configuration provider and click Next.
  3. Select the Restrict search to OSLC Configuration Domain service providers check box to restrict the search to providers and pickers from the OSLC configuration domain.
  4. Select the OSLC Service catalog, Service provider and Selection dialog that you want to use.
  5. Select Use external browser only if you encounter problems with the embedded browser in the wizard. Click Next.
    • If you did not select the Use external browser check box, choose the configuration by using the embedded browser in the wizard.
      • You must authenticate again when the embedded browser loads the page for the first time.
      • If the full selection of options is not visible, scroll down to find the OK or Select buttons.
    • If you selected the Use external browser check box, choose the configuration in an external browser.
  6. Click OK and click Finish.
    The selected value is set in the Configuration context property of the data source.

Results

You can now generate document-style reports for different configurations. PUB sends the configuration's URL in a header with each request it makes to the data source. The provider responds with the data matching the selected configuration.