Extended Functions → Using REST Data Sources → REST Service Configuration Dialog Box
This dialog box opens when you do one of the following:
|URL selection / Address
|In the drop-down
URL selection field, select from available options and
fill in the adjoining
Address field as follows:
Any input parameters are immediately added to the Inputs section, and the sample data and outputs columns are automatically populated.
Adds add a new input parameter. When you add a new parameter, the URL is immediately updated.
|Removes the selected input parameter.
|Get Sample Data
|Populates the sample data column based on the REST service URL and any URL parameters. Use the button to initially populate the column or to refresh the sample data from the URL after you edit the data.
|using security token
|This option is enabled only if Security Token is selected in Authentication and relates to the Get Sample Data option. If selected, this passes your security token, which is retrieved based on your SBM Composer Repository credentials, to the REST service to obtain sample data.
|Edit Sample Data
|Use to modify sample data. For example, you may want to duplicate repeating data. You can also import data. For details, refer to Edit Sample REST Data Dialog Box.
Displays input parameters that are sent to a REST service. The parameters are populated when you provide a URL.
You can set new default values for input parameters that override ones set in a provided URL. The URL is updated after you change a parameter name or value, and then click somewhere else or press the Enter key.
(REST Grid widget only) Runtime values for parameters are specified on the Query tab.
(REST data source only) You can parameterize the URL by using square brackets [ ] inside the URL portion before the ?. The format is [name=value]. After you create an input parameter, you can add options in the Inputs table.
For example, if you want to provide different values for "geocode" in the following URL:
modify the URL as follows:
Displays sample data from the REST service.
Select the Wrap check box to wrap the sample data so it is visible without scrolling.
Select the Format check box to properly format the data.
Displays output structure received from a REST service. Formatting hints include:
| Authentication can be specified to
initialize the REST service endpoint and to retrieve sample data.
Options available are:
If you do not provide credentials for REST services that require authentication, you are prompted to enter this information before you can continue.
Note: This information is for initialization of the environment endpoints to which you map this process app endpoint during deployment. At runtime, the authentication method is always retrieved from the environment endpoint settings in SBM Application Repository. Changing it here in SBM Composer has no effect on the mapped environment endpoint after the initial deployment to an environment.
|Bypass browser cache
|Always goes directly to the server to get results, rather than relying on the browser cache. Select this check box if your REST results change over time and you want to have the latest data, not the cached data.
|Ignore XML prefixes
|Specify whether XML namespace prefixes should be ignored.
Namespace prefixes are arbitrary, can be automatically generated, and can change. The REST data source and the REST Grid widget require a constant namespace prefix, so if the prefix changes, they do not work. If you select this check box, the namespace prefix that is returned in the data from the REST service is not used, so the widget works consistently.
This checkbox appears only for REST services that return XML. It does not appear for REST services that return JSON.
Defines the array in the data set to be used for rows in the grid. The first available array is selected by default, but the list can be edited if more than one array is present. If no arrays are detected, the list includes all potential elements, and at runtime, the user must select the element that will contain repeating data.
Copyright © 2007–2018 Serena Software, Inc., a Micro Focus company. All rights reserved.