Dit artikel is vertaald met behulp van AI en kan kleine onnauwkeurigheden bevatten. Raadpleeg de Engelse versie voor volledige nauwkeurigheid.
Om gegevens in te voeren in BlueDolphin kun je de DataCollection Frontend en Service applicaties gebruiken. De DataCollection applicaties werken alleen op Microsoft Windows.
Dit artikel bevat een .zip-bestand met de installer voor de DataCollection software. Zie onderaan dit artikel. Download ook het templates.json-bestand, dat je eveneens onderaan dit artikel vindt.
Installatie (1): DataCollection Windows Service
Het .zip-bestand bevat twee MSI-bestanden:
DataCollection Windows Service.msi
DataCollection Frontend.msi
De "DataCollection Windows Service.msi" moet worden geïnstalleerd op een Windows-machine die verbinding kan maken met de gegevens die je wilt uploaden naar BlueDolphin. Omdat BlueDolphin wordt gehost in Microsoft Azure (een cloudprovider), moet de machine ook toegang hebben tot het internet. De applicatie maakt specifiek verbinding met:
https://api.eu.bluedolphin.app/api/ (voor EU-gebaseerde tenants) of https://api.us.bluedolphin.app/api/ (voor US-gebaseerde tenants) - tcp/443
Omdat de oude domeinen https://api.bluedolphin.valueblue.nl en https://api2.bluedolphin.valueblue.nl binnenkort worden uitgefaseerd, moet je de URL wijzigen naar een van bovenstaande, afhankelijk van de locatie van je tenant. De onderstaande url moet bereikbaar zijn voor het up- en downloaden van bestanden:
En de applicatie moet verbinding kunnen maken met verschillende bronnen.
De MSI installeert de applicatie en een Windows Service.
Na het installeren van de Windows Service moet je het bestand DataCollection.Agent.Host.WindowsService.exe.config openen in de standaard installatiemap (%PROGRAMFILESFOLDER%\ValueBlue BV\DataCollection Windows Service). In dit bestand stel je de eigenschappen in die nodig zijn om verbinding te maken met jouw BlueDolphin-omgeving.
De waarden die je nodig hebt, vind je in BlueDolphin onder Admin\Algemeen.
Configuratie-eigenschap | Waarde |
DataCollection.Tenant.APIKey | Deze vind je in BlueDolphin. |
DataCollection.Tenant | Deze vind je in BlueDolphin. |
PresentationServiceEndPointAddress | Voor EU-gebaseerde tenants: https://api.eu.bluedolphin.app/api/ Voor US-gebaseerde tenants: https://api.us.bluedolphin.app/api/ Omdat de oude domeinen https://api.bluedolphin.valueblue.nl en https://api2.bluedolphin.valueblue.nl binnenkort worden uitgefaseerd, wijzig de waarde naar een van bovenstaande, afhankelijk van de locatie van je tenant. Na het bewerken en opslaan van het config-bestand moet je de BlueDolphin DataCollector Service opnieuw starten. |
Wanneer jouw organisatie een proxyserver gebruikt om verbinding te maken met het internet, moeten de volgende configuratie-eigenschappen worden ingevuld:
Configuratie-eigenschap | Waarde | Beschrijving |
PresentationServiceUseProxy | true / false | True als je een proxyserver gebruikt |
PresentationServiceProxyAddress |
| Adres van de proxyserver |
PresentationServiceProxy UseCustomCredentials | true / false | True als je inloggegevens moet opgeven |
PresentationServiceProxyUsername |
| Gebruikersnaam van de proxyserver. Syntax: %domein%\%gebruikersnaam% |
PresentationServiceProxyPassword |
| Wachtwoord van de proxyserver |
Na het afronden van de configuratie kun je de service starten. Als de service draait onder een serviceaccount en niet wil starten, controleer dan de Windows Event Viewer op de volgende foutmelding:
"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"
Is dit het geval, voer dan het volgende commando uit (als administrator):
netsh http add urlacl url=http://+:8000/DataCollectionAgentService user=DOMAINE\GEBRUIKERSNAAM
Vervang DOMAINE en GEBRUIKERSNAAM door de juiste waarden.
Installatie (2): DataCollection Frontend en templates
Datacollection Frontend
Nadat je de DataCollection Windows Service hebt geïnstalleerd en gestart, kun je de DataCollection Frontend installeren met de DataCollection Frontend.msi. Met de DataCollection Frontend kun je het formaat van de gegevens die in en uit BlueDolphin gaan configureren.
Templates.json
Zoek in de downloadmap naar templates.json.
Kopieer dit bestand en plaats het in Program Files (x86) \ ValueBlue BV \Datacollection Frontend
Belangrijk: Exporteren wordt niet langer ondersteund. Als je probeert een nieuwe export te maken, geeft het systeem een 410 Gone-foutmelding.
DataCollection versies
Hieronder zie je een overzicht van de verschillen tussen de BlueDolphin DataCollection versies.
BlueDolphin DataCollection v4 | Huidig |
BlueDolphin DataCollection v3 | Derde versie |
BlueDolphin DataCollection v2 | Tweede versie, ondersteuning voor TLS1.1 & TLS 1.2 toegevoegd (update-interval in minuten) |
BlueDolphin DataCollection v1 | Eerste versie, ondersteunt TLS 1.0 |