To enter data in BlueDolphin, you can use the DataCollection Frontend and Service applications. The DataCollection applications run on Microsoft Windows only.
This article contains a .zip file containing the installer for the DataCollection software. See the bottom of this article. Also, download the templates.json file, which can also be found at the bottom of this article.

Install (1): DataCollection Windows Service

The .zip file contains two MSI files:

DataCollection Windows Service.msi
DataCollection Frontend.msi

The "DataCollection Windows Service.msi" should be installed on a Windows machine that can connect to the data you would like to upload to BlueDolphin. As BlueDolphin is hosted in Microsoft Azure (a cloud provider), the machine should also have access to the internet. Specifically, the application connects to:

https://api.eu.bluedolphin.app/api/ (for EU-based tenants) or https://api.us.bluedolphin.app/api/ (for US-based tenants) - tcp/443

Due to the old domains https://api.bluedolphin.valueblue.nl and https://api2.bluedolphin.valueblue.nl being deprecated soon, you should change the URL to one of the above, depending on the location of your tenant. The URL below needs to be reachable for up- and downloading files:

https://bdprdeudata.blob.core.windows.net/ - tcp/443

And the application should be able to connect to various sources.

The MSI will install the application and a Windows Service.

After you have installed the Windows Service, you need to open the file DataCollection.Agent.Host.WindowsService.exe.config in the default installation folder (%PROGRAMFILESFOLDER%\ValueBlue BV\DataCollection Windows Service). In this file you will configure the properties needed to connect to your BlueDolphin instance.

The values you will need can be found in BlueDolphin under Admin\General.

Configuration property	Value
DataCollection.Tenant.APIKey	This can be found in BlueDolphin. Go to Admin and choose General in the menu on the left. There you will find the Datacollection API key. Use that value in here.
DataCollection.Tenant	This can be found in BlueDolphin. Go to Admin and choose General in the menu on the left. There you will find Database. Use that value in here.
PresentationServiceEndPointAddress	For EU-based tenants: https://api.eu.bluedolphin.app/api/ For US-based tenants: https://api.us.bluedolphin.app/api/ Due to the old domains https://api.bluedolphin.valueblue.nl and https://api2.bluedolphin.valueblue.nl being deprecated soon, please change the value to one of the above, depending on the location of your tenant. After editing and saving the config file, you need to restart the BlueDolphin DataCollector Service.

When your organization uses a Proxy server to connect to the internet, the following configuration properties will need to be filled in:

Configuration property	Value	Description
PresentationServiceUseProxy	true / false	True if you use a proxy server
PresentationServiceProxyAddress		Proxy server address
PresentationServiceProxy UseCustomCredentials	true / false	True if you need to specify credentials
PresentationServiceProxyUsername		Proxy server user name. Syntax: %domain%\%username%
PresentationServiceProxyPassword		Proxy server password

After you have completed the configuration, you can start the service. In the case that the service runs under a service account and the service does not start, please check the Windows Event Viewer for the following error:

"Service cannot be started. System.ServiceModel.AddressAccessDeniedException: HTTP could not register URL http://+:8000/DataCollectionAgentService/. Your process does not have access rights to this namespace (see http://go.microsoft.com/fwlink/?LinkId=70353 for details). ---> System.Net.HttpListenerException: Access is denied"

When this is the case, please run the following command (as an administrator):

netsh http add urlacl url=http://+:8000/DataCollectionAgentService user=DOMAIN\USERNAME

Please replace DOMAIN and USERNAME with the appropriate values.

Install (2): DataCollection Frontend and templates

Datacollection Frontend

After you have installed the DataCollection Windows Service and started it, you can install the DataCollection Frontend by using the DataCollection Frontend.msi. By using the DataCollection Frontend, you can configure the format of the data going in and out of BlueDolphin.

Templates.json

In the download folder, search for templates.json.

Copy this file and put this in Program Files (x86) \ ValueBlue BV \Datacollection Frontend

Important: Export is no longer supported. If you try to create a new export, the system returns a 410 Gone error.

DataCollection versions

Below you can see an overview of the differences between the BlueDolphin DataCollection versions.

BlueDolphin DataCollection v4	Current version
BlueDolphin DataCollection v3	Third version
BlueDolphin DataCollection v2	Second version, added support of TLS1.1 & TLS 1.2 (update interval in minutes)
BlueDolphin DataCollection v1	Initial version, supports TLS 1.0