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
Gegevens uit BlueDolphin (Export)
Naast het importeren van gegevens in BlueDolphin kun je ook gegevens exporteren uit BlueDolphin.
Kies de optie from BlueDolphin (Export). Wil je een nieuwe export toevoegen, selecteer dan Toevoegen. Het volgende scherm verschijnt:
Je kunt een naam geven aan het exportitem en zo wordt het item zichtbaar in de tool. Daarna selecteer je het rapport. De rapporten die je wilt exporteren moeten in de BI-omgeving in de map "Dataset" staan.
Nadat je het exportitem hebt toegevoegd, zie je het volgende scherm:
In de onderstaande tabel vind je uitleg over de verschillende velden, zodat je de juiste exportdefinitie kunt maken.
Veld | Uitleg |
Geselecteerd uitvoerformaat | Je kunt de gegevens direct uit je rapporten opslaan, dit zijn exact dezelfde gegevens als wanneer je de rapporten downloadt vanuit de BI webinterface. |
Directe uitvoerlocatie | Hier geef je het pad op waar je bestand wordt opgeslagen. |
Data nabewerken met extensie | Wil je meer controle over de gegevens, dan kun je een extensie gebruiken. Extensies worden geleverd door ValueBlue, maar je kunt ze ook zelf maken. |
Data nabewerken | Als je kiest voor Data nabewerken met extensie, kun je een van de bekende extensies selecteren in de dropdown. |
Geselecteerde extensieparameters | Afhankelijk van de gekozen extensie verschijnen hier de mogelijke parameters van de gekozen extensie. |
Leegmaken voor update | Hier kun je aangeven of de database eerst geleegd moet worden voordat de synchronisatie start. |
Moet dit rapport op de achtergrond verversen | Wil je dat je export periodiek wordt ververst, vink dan het vakje aan. |
Update-interval | Hier kun je het synchronisatie-interval in uren instellen. |
Start op | Vul hier de datum in vanaf wanneer je de synchronisatie wilt laten starten. |
Om de gemaakte exportdefinitie op te slaan, kies Sla op in het Bestand-menu.
Wil je niet wachten op het download-interval of wil je een download forceren, selecteer dan het synchronisatie-icoon (rechtsboven bij de exportgegevens).
Voor uitleg over het maken van een rapport via DataCollector, ga naar deze pagina.
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 |