Adding an XML/HTTP Data Source
Use the steps in this section to add an XML/HTTP data source. After adding the data source, see
Retrieving XML Data Over HTTP, for details on how to access the data.
To create an XML/HTTP data source
1. Right-click at a location in the Studio resource tree where you want this data source to reside, and select New Data Source.
2. In the New Physical Data Source dialog, select XML/HTTP and click Next.
3. Supply this connection information for an XML/HTTP data source:
— Name—Name for the data source.
On the Basic tab, provide this information for an XML/HTTP data source:
— URL—URL to the HTTP server hosting the XML source.
— Method—GET or POST
Use GET to request data by sending the request information to the HTTP server. Typically, GET is used to retrieve a static resource. However, a query string or extra path information can be appended as a text string after a question mark ( ? ) in the URL of a GET request to trigger server-side processing.
Use POST to send data to the HTTP server to be processed, making sure that the data format of the sending and the receiving programs are compatible.
— Login—Valid username and password to access the HTTP server.
— Password—Password for the sign-in username to access the HTTP server.
— Save Password—Check box that is enabled only if Pass-through Login is enabled.
— Pass-through Login— Refer the User Guide, About Pass-Through Login, for more information.
— Authentication—Choose the method of authentication for this data source.
— Domain—For NTLM authentication only, enter the domain.
— Service Principal Name—For NEGOTIATE authentication only, enter the service principal name.
— Access Token—For OAUTH, type the value of the token. For example:
e72e16c7e42f292c6912e7710c838347ae178b4a&scope=user%2Cgist&token_type=bearer
— Automatically Retrieve Access Token—For OAUTH.
— No Input—Select if no input is required.
— Input in URL—Select if the input is in the URL.
— Input Document Definition—To specify the input document definition, use the
Browse button to locate the definition set you created as described in
Creating an XML Definition Set.
— Output Document Definition—To specify the output document definition, browse to the path of the output document definition that supplies the schema for retrieving XML data, as in this example:
/<path to definition set>/xmlhttp_ds_schema/GetVotersResponse
When you click the Browse button for the Input Document Definition or the Output Document Definition, the Choose Schema window opens.
a. In the left pane, select the XML definition set in the resource tree.
b. In the right pane, make sure that Element is selected in the Show drop-down list, and select the definition.
When Element is selected, a specific schema response is expected by the XML/HTTP service. The fully qualified name of the document element must be the same as the element chosen from the schema.
When a Type is selected, the document element must be of the same type.
When you make your selection in the right pane, the Schema field is automatically filled with the complete path to the input or output document definition.
c. Click OK.
You return to the New Physical Data Source window.
4. Click the Advanced tab.
5. On the Advanced tab, enter this information:
— Certificates—Enter information about the security certificates used for the XML/HTTP data source. You can click the buttons above the table to:
— Import Certificate Key Store From File—Type or browse to the path, and select the type and password for the key store.
— Export Certificate Key Store To File—Export a key store to a file.
— Clear Certificate Key Store—Clear the key store.
— Channel Pass-through—Identifies the name of the HTTP request header property that is to be passed through to the XML or HTTP data source. Multiple values can be passed through to the data source by specifying the names as a comma-separated list.
— Environment Pass-through—Enter one or many environment variables to pass to the XML or HTTP data source for login authentication or other purposes.
6. Click one of these buttons:
— Create & Introspect—To proceed immediately with introspection.
— Create & Close—To create the data source; you can introspect at a later time.
7. Refer the User Guide, Chapter Retrieving Data Source Metadata, for how to introspect now or later.