Configuring metadata for document-style reports

You can add metadata to the variables or data source schemas in a template. Then, you can import the template into the integrated product that uses Engineering Document Generation, and filter your data as needed.

1. In the Outline view, right-click the variable or data source schema.
2. Click Edit Configuration Metadata.
3. Enter the metadata details:
   • Dynamic metadata:
     • Type: The value type. Example: string
     • Identifier: 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 View. Example: workitem/workitem/id. 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.
     • Display: An XPath expression that is evaluated to provide display strings for the parameter selections. You can type a value or drag one from the Data Source View. Example: workitem/workitem/summary. 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.
     • Request URL: 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.
4. If you entered dynamic metadata, review the metadata that you entered and replace values with variables that are defined by your data source whenever possible.
   For example, IBM Engineering Lifecycle Management provides these variables for the identifier, display, and request URL parameters:

   • ${public}: Resolves to the front-side URL of the application where the report is running.
   • ${projectAreaUUID}: Resolves to the UUID of the project where the report is running.
   • ${userInput}: Replaced by a user-provided filter string when the report is run.
5. Click OK to save the changes.
6. Save the template.