Version

    Using Data Services

    Deploying Data Service
    Publishing and Unpublishing Data Service from Sandbox
    Publishing Data Service Examples
    Changing Data Service to Anonymous
    Running Data Service on HTTPS
    Running Data Service on HTTPS on Cluster
    Monitoring Data Service
    Testing Data Service
    Performance Tuning
    Exporting Data Service Configuration
    Importing Data Service Configuration
    Avoiding Premature Marking of Data Service as Failing
    Looking up Particular Data Service
    Resetting State of Failing Data Service Endpoint

    Deploying Data Service

    To deploy Data Service from the Server, go to Data Services tab, click Publish Data Service job and choose a sandbox and .rjob file.

    Publishing Data Service job

    Figure 46.16. Publishing Data Service job


    You can choose between Data Service with or without required authentication. In the latter case, the Data Service will run under the specified account.

    Publishing Data Service job that does not require authentication

    Figure 46.17. Publishing Data Service job that does not require authentication


    Publishing Multiple Jobs

    To deploy multiple jobs, tick the Publish another checkbox. After deploying one job, the dialog for publishing Data Service is displayed again to let you enter the next one.

    Publishing and Unpublishing Data Service from Sandbox

    You can deploy Data Service directly from a sandbox. To do so, you need the read access to the sandbox and List Data Services and Manage Data Services privileges.

    In the Sandboxes section of the Server GUI, select a data service to be published/unpublished. In the top right corner of the overview, there are options for publishing or unpublishing the data service, as well as editing, showing data service in Execution History, downloading/downloading as ZIP and deleting the data service.

    Publishing Data Service Examples

    CloverDX Server contains a built-in set of Data Service examples. These examples are not deployed by default.

    The Data Service examples can be deployed directly from the Data Services tab. If you do not have any Data Service deployed, click the Publish Data service Examples link.

    Publishing Data Service examples

    Figure 46.18. Publishing Data Service examples


    If there is an existing Data Service, the button to publish examples is in the menu accessible under the three-dot-button.

    Publishing Data Service examples - II

    Figure 46.19. Publishing Data Service examples - II


    See Built-in Data Service Examples.

    Changing Data Service to Anonymous

    By default, the Data Service requires a client to send the credentials. To create the Data Service that does not require authentication, switch to the Configuration tab in the Data Service Detail pane and change Authentication method to Do not require authentication. The Data service runs with privileges of an existing user; therefore, you should set the Run as field to the suitable user. This user should have permissions necessary to run the Data Service.

    Configuring Anonymous Data Service

    Figure 46.20. Configuring Anonymous Data Service


    In the list of Data Services, the Data Service that does not require credentials is indicated by unlocked padlock icon.

    Data Service without authentication

    Figure 46.21. Data Service without authentication


    Running Data Service on HTTPS

    By default, the Data Service runs on HTTP and you can configure it to run on HTTPS.

    To run Data Service on HTTPS, create a new HTTPS Connector.

    Creating a new Data Service Connector

    Figure 46.22. Creating a new Data Service Connector


    Enter a name, port, keystore path, and keystore and key passwords.

    Creating a new Data Service Connector II

    Figure 46.23. Creating a new Data Service Connector II


    In Data ServicesEndpoints, select the Data Service to be running on HTTPS and switch to the Configuration tab.

    Select the HTTPS connector from the combo box and click the Save & Apply button. Now, the Data Service runs on HTTPS.

    Using the HTTPS Connector in Data Service endpoint

    Figure 46.24. Using the HTTPS Connector in Data Service endpoint


    You can have more independent HTTPS contexts running on one Server. There can be multiple Data Services running on the same HTTPS context.

    Running Data Service on HTTPS on Cluster

    This case extends the case of Running Data Service on HTTPS. Different Cluster nodes have different domain names, but the Java KeyStore has to have one certificate. There are two way to solve the problem with certificates.

    • Use a wildcard certificate. The keystore file should be placed on the shared file system.

    • Use different certificates for each Cluster node. The keystores with the certificates must be on the same path on all Cluster nodes.

    Monitoring Data Service

    To see the activity of Data Service, use the list of Data Services. There you can see the main overview of data services.

    The state of a particular Data Service is on the State and History tab.

    Testing Data Service

    To test the Data Service, select the Data Service in the list, switch to the Data App tab and click the Run App button. See Data App usage for more information.

    Performance Tuning

    To improve performance, do not save job execution records in Execution History. To do so, do not tick Save job execution records in Execution History on Configuration tab.

    Exporting Data Service Configuration

    You can export the Data Service configuration from Data ServicesEndpoints tab. Click the three-dot-button and select Export Data Services Configuration from context menu.

    Data Services - Export

    Figure 46.25. Data Services - Export


    The Data Services configuration will be exported.

    You can also export Data Service configuration in ConfigurationExport See Server Configuration Export.

    Importing Data Service Configuration

    You can import the Data Service configuration from Data ServicesEndpoints. Click the three-dot-button and select Import Data Services Configuration from the context menu.

    Data Services - Import

    Figure 46.26. Data Services - Import


    You can also import the Data Service configuration directly in ConfigurationImport See Server Configuration Import.

    Avoiding Premature Marking of Data Service as Failing

    Data Service might prematurely switch to a failing state if the failure indication is set up to switch to a failing state after a given percentage of executions fails in a given time window. E.g. First execution fails.

    To avoid this, you can set the minimum number of events necessary to be taken into account when calculating the change of Data Service state. It can be set with the trigger.failure.ratio.min.record.count configuration property. The default value is 3 executions.

    It can be set in ConfigurationSetupConfiguration File. Add a line containing

    trigger.failure.ratio.min.record.count=3

    to the configuration file.

    You can set it to any reasonable positive integer. This configuration is valid for all Data Services available on the Server.

    See also Chapter 17, List of Configuration Properties.

    Looking up Particular Data Service

    If you have multiple Data Services available, you can search for a specific Data Service:

    If you know the endpoint name, you can look it up. Enter the text into the Search endpoints field and click the Refresh button. The Data Services will be filtered.

    The entered text will be searched in the title of the Data Service, in the name of the request method, in the name of .rjob file and in the path that the Data Service uses.

    If you would like to see invalid endpoints only, click the failing and invalid only icon. The both filters can be combined.

    To switch off the filters, click the Show All button.

    Resetting State of Failing Data Service Endpoint

    If the Data Service endpoint is in the failing state and the problem has been fixed, you can reset the endpoint state manually.

    To reset the state, open the details of the endpoint, switch to the Alerts and Notification tab and click the Apply and Reset State button.

    If the endpoint has an email address set, a notification email will be sent to this address.

    Enabling CORS Filter

    CORS (Cross-Origin Resource Sharing) is a mechanism that allows browsers to give a web application running at one origin, access to resources from another origin.

    In order to grant an application access to Data Service endpoints, CORS response headers have to be properly configured using dataservice.access.control.* configuration properties. See the list of Data Service configuration properties.

    For example, using the following configuration, any web application will be allowed to access Data Service endpoints using GET requests:

    dataservice.access.control.allow.origin=*
    dataservice.access.control.allow.methods=GET