You can extract data from REST v1 or REST v2 data sources
by exposing the Rational® REST
Get Specification.
Procedure
- In the Document Specification window,
expand .
- Right-click the data source and select
a configuration option:
- If there is configuration layer metadata for the data source,
click Configure using metadata.
- If authentication is required to connect to the data source specified
in the configuration layer metadata, a window opens where you can
enter your user name, password, and authentication type. Click OK.
- Select the value to use from the configuration layer and click OK.
After
selecting a value from the configuration layer, the data source is
configured and you are not required to complete the remainder of this
task.
- If there is not configuration layer metadata for the data
source, click Configure Data Source and continue
to the next step.
- Specify the resource information for the REST resource:
- URL: Specify the base URL for
the resource. If you do not know the URL, click Discover to
locate the resource. If you clicked Discover,
continue to the step 4 without completing the remaining substeps in this
step.
- User: If the resource is in a
secured server, specify the user name.
- Password: If the resource is
in a secured server, specify the password.
- Authentication: Select the authentication
type that applies to your data source. You can select one
of the following authentication types:
- Accept header:
Enter an accept type for your stylesheet. Examples:
- image/jpeg
- text/html
- application/xml
- */*
- Click OK.
- If you clicked Discover to
locate the resource, complete the wizard:
- In the Welcome window, click Next.
- In the Base configuration window, specify the details
for the data source:
- Name: Specify a name for the data source.
- Description: Specify a description for
the data source.
- Base URL: Resource navigation is available
for resources that have an href attribute.
- Authentication type: Select the authentication
type that applies to your data source.
- User and Password:
The credentials you use to authenticate with your data source application.
- Select context: For Design Management data
sources.
- Select a resource. The base URL you entered is automatically
appended with ?metadata=schema. To
select the resources:
- In the XML schema section of the Locate resource using Data Service
window, expand the resource list.
- In the Element attributes section, select an href and
click Next.
- Click Next. The resource URL displays for
the selected resource.
- Select the URL and click Finish or
use the URL to locate the child resource. The wizard completes
and the URL displays in the Configuration window.
If the resource is stored on a secured server, enter a user name and
password in the Configuration window.
- Click OK. The REST data configuration
process is complete and the information is added to the Document
Specification window.
Example
For more information on identifying a base URL, see the
Integrating documentation for your data source.