Establishing a Connection
Creating a JDBC Data Source
You can create a JDBC data source to connect from your Java application, based on CData JDBC Driver for SAP Fieldglass.Follow these steps:
- Add the driver JAR file to the classpath. The JAR file is located in the installation directory's lib subfolder. Ensure that the .lic file is located in the same folder as the JAR file.
- Provide the driver class. For example:
cdata.jdbc.sapfieldglass.SAPFieldglassDriver
- Provide the JDBC URL. For example:
jdbc:sapfieldglass:EnvironmentURL='https://myinstance.com';OAuthClientId=clientId;OAuthClientSecret=clientSecret;APIKey=xxxxxxxx-xxxx-xxxx-xxxx;
Or, if there is a conflict in your application between drivers using the same URL format, use this form to ensure that you are using the CData driver:
jdbc:cdata:sapfieldglass:EnvironmentURL='https://myinstance.com';OAuthClientId=clientId;OAuthClientSecret=clientSecret;APIKey=xxxxxxxx-xxxx-xxxx-xxxx;
Ensure that the URL starts with either jdbc:sapfieldglass: or jdbc:cdata:sapfieldglass:. The URL can include any of the connection properties in name-value pairs separated with semicolons.
Obtaining Your Credentials
Please contact your SAP Fieldglass representative to obtain an OAuthClientId, OAuthClientSecret, and EnvironmentURL.
Connecting to SAP Fieldglass
To authenticate to production environments, specify the following:
- APIKey: Your SAP Fieldglass API Key. This is optional, but if you encounter an error from SAP Fieldglass indicating that an API Key is required, you can request one from SAP Fieldglass administration or log in to the SAP Fieldglass Integration Tools and click Create API Application.
- OAuthClientId: The OAuth Client Id that you obtained from your SAP Fieldglass representative.
- OAuthClientSecret: OAuth Client Secret that you obtained from your SAP Fieldglass representative.
- EnvironmentURL: The SAP Fieldglass Environment URL that you obtained from your SAP Fieldglass representative.