Templates operate with data schemas, not with actual data
sources. You can add a data source schema to an open template.
Before you begin
You cannot edit with the Schema discovery wizard, export,
or replace data source schemas that contain custom attributes.
About this task
The data source schema for each data source type is
structured differently. If you are unsure which data source type your
product is, in the Integrating section, refer to the "Designing
templates" topic for your product. Each topic includes steps for
adding a data source schema with the appropriate data source type
selection. The data source schema URL is verified before you complete
the wizard to add it. If you happen to select the wrong data source
type when you are configuring the data source schema, you receive
an error and cannot complete the wizard. If this issue occurs and
you know that your URL is correct, use a different data source type.
Procedure
- Choose one of the following methods
to open the Add data source schema wizard:
- In Document Studio, click .
- In the Outline view, click .
- In the Data Source View, click the Add data source
schema icon
.
- In the Add data source schema welcome
window, click Next.
- Select a data source schema:
- In the Predefined field, select
one of the following data sources:
- DS
- DNG Text
- DNG Module
- DOORS®
- DOORS_DB
- Rhapsody®
- RQM Feed
- RQM QM
- RTC Workitems
- ReqPro Sample
- In Type,
select the type of the schema from the list. You can select one of the following types:
- Generic XML
- REST
- REST v2
- Rational® DOORS
- Rational DOORS
structure
- Edit the Schema field
or click Browse to select the path for the
schema file. The schema can be on the local file system, the Central Management component, or can be a URI
that is accessible from the computer. You must provide a full path.
Tip: To construct a
specific resource type schema, open your data source schema and from the
.xml
file take the URI for a particular resource. Then, add
?metadata=schema to
the end of the URI. Examples:
- http://server:port/fp/resources/workspaces/4/modules/1/elements/?metadata=schema
- https://server:port/ccm/rpt/repository/workitem?metadata=schema
- Provide a name and description for the schema or accept
the default settings.
- In the Extra Headers field, enter a POX (Plain Old XML) link, for
example <http://jazz.net/ns/profile#POX>; rel="profile". This is useful
when creating
traceability documents from CLM applications (CLM 6.0.2 and later only).
- Click Next.
- In the Summary window,
review the information and click Finish.
What to do next
When displaying a data source schema, the
label annotation
is used, if present, by default. You can display the names in the
Rational Publishing Engine browser.
To view the raw schema instead:
- Click .
- Expand RPE.
- Select the Document Design tab.
- For the Use Schema annotations for display option,
select No.
- Click OK to save the change.
You can search for a list of elements that use a specific query or
attribute in a template by right-clicking the query or attribute in the Data Source View and
selecting Search data references. The Search view opens and a list of
occurrences displays. You can double-click an occurrence in the results to edit it.