From the Outline view, you can access the configuration
layer for a data source schema and apply details that are selectable
later in the document generation configuration wizard.
Tip: In the configuration layer, only use unique
data. If you try to use priority or severity, for example, where many
pieces of data have the same value, when you configure the document
generation, your configuration layer dropdown values display duplicates.
Remember
that the configuration layer is not meant to be used as a filter,
but as a method for selecting a human readable value instead of a
complex URL.
- In the Outline view, expand Data source schemas.
- Right-click the configLayerSchema schema
that you added in the previous lesson.
- Click Edit configuration metadata.
- For the Type, select anyuri.
- For the Identifier, drag an attribute
from the Data source schema view that includes the URL for the data
source information you are trying to recover.
The Identifier
is an xPath expression that is evaluated to provide a list of values
for the parameter. You can type a value or drag one from the Data
source schema view. The expression is evaluated on the XML returned
from fetching the request URL. If an identifier expression is not
provided, then the request URL itself is the value for the parameter.
Example:- Rational® Quality Manager: /feed/entry/id
- Rational RequisitePro®: /Project/Requirements/PRRequirement/@href
- Rational Team Concert: /workitem/teamArea/@href
- For the Display, drag a query from
the Data source schema view to use as the selectable value that displays
as you configure the document generation.
The Display
is an xPath expression that is evaluated to provide display strings
for the parameter selections. The identifier and display xPath expressions
must return matching results sets, such as the same size and ordering.
If a display value is not provided, then the identifier is used as
the display string instead.
Example:- Rational Quality Manager: /feed/entry/title
- Rational RequisitePro: /Project/Requirements/PRRequirement/FullTag
- Rational Team Concert: /workitem/teamArea/name
- For the Request URL, enter a URL
or file path to your data.
The Request URL is the full
URL to retrieve the information from when finding the parameter value.
If no request URL is provided, then the user must manually enter a
value for the parameter.
Example:- Rational Quality Manager: https://server:port/qm/service/com.ibm.rqm.integration.service.IIntegrationService/resources/JKE+Banking+Quality+Management/testplan
- Rational RequisitePro: file:///%RPE_HOME%/source/XML/examples/Requirements_PR.xml
- Rational Team Concert: https://server:port/jazz/rpt/repository/workitem?fields=workitem/teamArea/(@href|name)
- Click OK.