You can discover the value of a configuration URI to support
configuration aware document generation.
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 will be processed by any configuration-capable
data service. The global configuration property value may be changed
by scripts in the document template during document generation.
Rational® Publishing Engine discovers
the URL of the OSLC delegated dialog by reading the service provider
resource of the configuration service. An embedded web browser displays
the OSLC delegated dialog for you to select the configuration.
Procedure
To generate documents in the context of a specific configuration,
you must select the desired configuration in the document specification.
To discover the OSLC resource:
- In the Document Specification view, right click your data
source and select OSLC Configuration Selection. The OSLC Service Discovery and Selection wizard
opens.
- Specify the Root service document
of the configuration provider and click Next.
- 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.
- Select the OSLC Service catalog, Service
provider and the OSLC Selection dialog that
you want to use.
- 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 using the embedded browser in the wizard.
Note: - 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.
- Click OK and click Finish. The selected value is set in the Configuration-Context
property of the data source.
Results
You can now generate documents for different configurations.
Rational Publishing Engine 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.