Configuring the Product Using the GUI

When the driver is first installed, the values of its connection options are set by default. These values appear on the driver Setup dialog box tabs when you create a new data source. You can change these default values by modifying the data source. In the following procedure, the description of each tab is followed by a table that lists the connection options for that tab and their initial default values. This table links you to a complete description of the options and their connection string attribute equivalents. The connection string attributes are used to override the default values of the data source if you want to change these values at connection time.

If you are configuring a new file data source, click Add to display a list of installed drivers; then, select a driver. Click Advanced if you want to specify attributes; otherwise, click Next to proceed. Specify a name for the data source and click Next. Verify the data source information; then, click Finish to display the driver Setup dialog box.

On this tab, provide values for the options in the following table; then, click Apply. The table provides links to descriptions of the connection options. The General tab displays fields that are required for creating a data source. The fields on all other tabs are optional, unless noted otherwise.

Connection Options: General	Description
Data Source Name	Specifies the name of a data source in your Windows Registry or odbc.ini file. Default: None
Description	Specifies an optional long description of a data source. This description is not used as a runtime connection attribute, but does appear in the ODBC.INI section of the Registry and in the odbc.ini file. Default: None
Schema Map	Specifies the directory where the internal configuration files, REST file, and the relational map of the REST data model are written. The driver looks for these files when connecting to a REST service. If the files do not exist, the driver creates them. Default: application_data_folder\Local\Progress\DataDirect\AutoREST_Schema\
Host Name	Specifies the host name portion of the HTTP endpoint to which you send requests. This option allows you to define endpoints without storing the host name component in the REST file. Default: None
REST Config File	Specifies the name and location of the input REST file used to define your endpoints. This file allows you to specify multiple endpoints, define POST requests, configure paging, or other customizations. Default: None
REST Sample Path	Specifies the endpoint that the driver connects to and samples. This option allows you to configure the driver to issue GET requests to a single endpoint without creating an input REST file. Default: None

5. Click OK. When you click OK, the values you have specified become the defaults when you connect to the data source. You can change these defaults by using this procedure to reconfigure your data source. You can override these defaults by connecting to the data source using a connection string with alternate values.

Note: The Test Connect button only partially confirms that the driver is properly configured. Since REST services lack traditional database structures, you will need to retrieve data from your endpoint to verify that you have successfully connected to your data. The Example application described in "The Example Application" allows you to quickly fetch data from your endpoint, thereby testing your connection.