Administration
Configuring The Data Service
 |
 |
 |
 |
Table of Contents |
 |
 |
 |
 |
1. Initialization
- Prior the launch of the Data Service Configuration Wizard an options dialog box will appear asking whether you want the new data service use a caCORE SDK Data Source or a Custom Data Source. For this tutorial we will be creating a service using caCORE SDK Data Source. Select that option and click ok.
 |
| Data Service Style Selector |
- The wizard can be navigated by clicking the next and previous buttons at the bottom right. There is a small label on the bottom left which indicates the current step of the wizard.
- Click Next: Client.jar to proceed.
First panel of the wizard
The caCORE data service wizard will step through a series of five pages to enter information about the grid service. Once complete, the service will be fully ready to be deployed and tested. After selecting the caCORE SDK Data Source option, a dialog will appear explaining the five steps of the wizard.
2. Client jar selection
- Click the Add Jars button to open a file dialog. Find the client.jar file in %CAGRID_LOCATION%/share/lib/caCORE, and click open to add it to the service.
- Click Next: Configuration to proceed.
 |
| Select required libraries |
3. Configuration of SDK Data Source
- Enter http://cabio.nci.nih.gov/cacore31/http/remoteService
in the Service URL textbox. This URL is that of the NCI's caBIO data source.
 |
| Configure the caCORE options |
The third page of the wizard specifies the configuration options for the caCORE SDK data source. The first of these options is the service URL for the data source application. The Case Insensitive Queries option is for data services which have a back end that might require queries to be performed without regard to case. Leave this option off for now. This page also allows CSM Security to be enabled and the CSM Context Name changed if necessary. This tutorial will not be using CSM Security.
4. Domain Model
- Select the "Generate From caDSR" radio button.
- Click the "Refresh from caDSR Service" button to refresh the list of projects and packages available.
- Use the Project drop-down to select "caCORE 3.1 (version: 3.1)".
- Select "gov.nih.nci.cabio.domain" from the Package drop-down menu.
- Click the Add Package button to include this package in the service's Domain Model.
- Click Next: Schemas to proceed.
 |
| Select the service's domain model |
The domain model may also be selected from the local file system, or the developer may choose to use no domain model with their service.
5. Schema Selection
- Click the "Resolve" button for the caBIO package to open the Schema Resolution Dialog.
- In the dialog select the "Global Model Exchange" tab.
- On this tab, select "caCORE.caCORE" from the Namespace drop-down.
- When the names drop-down is finished populating, select "3.1/gov.nih.nci.cabio.domain".
- Then click Load Schemas to close the dialog.
- Click Done to complete the wizard and launch the build process.
 |
| Schema selction in the wizard |
The large button to "Find schemas using GME" will attempt to locate schemas of the default namespace in the GME for each package. Schemas may also be resolved from the local file system with the Schema Resolution Dialog.
Complete
- At this point, the data service is configured. Click the done button to complete the wizard and allow introduce to build the data service code. When this process is complete, the standard Introduce service modification dialog will appear, containing an additional tab for Data Service specific modifications.
 |
| Introduce created service layout |