Om een dataset in te brengen in BlueDolphin kan gebruik worden gemaakt van de datacollectie FrontEnd & Service programma. Dit artikel bevat een .zip file met de benodigde software zie onderaan. Download ook het templates.json, ook te vinden onderaan in dit artikel.
Om data van je lokale omgeving naar BlueDolphin te transporteren bieden we verschillende mogelijkheden, welke dat zijn, vind je hier.
Installeer: (1) DataCollection Windows Service
Wanneer je de software hebt uitgepakt, bevat deze een aantal MSI files. Installeer nu als eerste "DataCollection.Deployment.WindowsService.x64.msi"
Deze installeer je op een machine die toegang heeft tot de data en het internet. Het MSI bestand installeert een Windows service op de machine. BlueDolphin is gehost in Microsoft Azure (een cloud leverancier), daarom heeft de machine connectie nodig naar het internet. De applicatie maakt verbindingen naar
-
https://api.eu.bluedolphin.app (voor EU) of http://api.us.bluedolphin.app (voor VS) - tcp/443
Vanwege de verouderde domeinen https://api.bluedolphin.valueblue.nl en https://api2.bluedolphin.valueblue.nl die binnenkort worden afgeschaft, moet je de URL wijzigen naar een van de bovenstaande, afhankelijk van de locatie. - https://bdprdeudata.blob.core.windows.net - tcp/443
Nadat je de Windows Service hebt geïnstalleerd, moet je zorgen dat volledige schrijf rechten heeft op deze installatie folder om de waardes die hieronder vermeld staan goed kunt opslaan.
Tip: middels Kladblok als administrator uit te voeren of door de Eigenschappen van de folder aan te passen kun je de juiste rechten instellen.
Open het bestand "DataCollection.Agent.Host.WindowsService.exe.config" in de installatie folder (%PROGRAMFILESFOLDER%\ValueBlue BV\DataCollection Windows Service).
Hierin dien je de volgende eigenschappen te configureren. Middels de waarden vind je terug in het beheergedeelte van BlueDolphin.
Configuratie eigenschap | Waarde |
DataCollection.Tenant.APIKey |
Deze kunt u vinden in BlueDolphin. Ga hiervoor naar het Beheer en kies vervolgens links in het menu de optie "Algemeen". Daar vindt u de Datacollectie API key. Deze vult u hier in. Let op: Tenant.APIKey" value="%APIKEY%" /> wordt: Tenant.APIKey" value="12345adcedmm" /> Let op: zonder%
|
DataCollection.Tenant |
Deze kunt u vinden in BlueDolphin. Ga hiervoor naar het Beheer en kies vervolgens links in het menu de optie "Algemeen". Daar vindt u de waarde "Database". Deze vult u hier in. Tenant" value="%TENANT%" /> Wordt: Tenant" value="Pietjepuck" /> Let op zonder %
|
PresentationServiceEndPointAddress |
Voor EU: https://api.eu.bluedolphin.app/api/ Voor VS: https://api.us.bluedolphin.app/api/ Vanwege de verouderde domeinen https://api.bluedolphin.valueblue.nl en https://api2.bluedolphin.valueblue.nl die binnenkort worden afgeschaft, moet je de waarde wijzigen naar een van de bovenstaande, afhankelijk van de locatie. Na het bewerken en opslaan van het configuratiebestand, moet je de BlueDolphin DataCollector Service opnieuw starten. |
Wanneer binnen jouw organisatie gebruik wordt gemaakt van een Proxy server om naar het internet te verbinden, dienen de onderstaande configuratie elementen van een waarde voorzien te worden.
Configuratie eigenschap | Waarde | Beschrijving |
PresentationServiceUseProxy | true / false | Maakt u gebruik van een Proxy server |
PresentationServiceProxyAddress | Adres van de proxy server | |
PresentationServiceProxy UseCustomCredentials | true / false | Dient u aanmeldings gegevens te specificeren voor het gebruik van de proxyserver |
PresentationServiceProxyUsername | Proxyserver gebruikers naam, deze in het formaat %domain%\%username% | |
PresentationServiceProxyPassword | Proxyserver gebruikers wachtwoord |
Nadat je de configuratie hebt voltooid kun je de services starten:
BlueDolphin Data Collection Service
Mocht je de service draaien onder een service account en start de service niet goed, controleer dan de Windows Event Viewer op de volgende melding:
"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 als administrator het volgende commando uit (vervang DOMAIN en USERNAME door juiste waarden):
netsh http add urlacl url=http://+:8000/DataCollectionAgentService user=DOMAIN\USERNAME
Installeer: (2) Datacollection Frontend en templates
DataCollection Front-End
Nadat je de Windows Service hebt geïnstalleerd en gestart, kun je de installatie van de Front-End starten. Dit kun je doen door "DataCollection Frontend.msi" uit te voeren. Met de DataCollection Front-End & Service kun je data van en naar BlueDolphin configureren.
Templates.json
Zoek in de download map naar templates.json.
Copy dit bestand en plaats het in: Program Files (x86) \ ValueBlue BV \Datacollection Frontend
Data uit BlueDolphin (Export)
Je kunt naast data vanuit uw omgeving naar BlueDolphin te brengen, ook de data vanuit BlueDolphin naar je omgeving halen. Dit doe je door te kiezen voor het Tabblad "from BlueDolphin (Export)". Wanneer je een nieuwe export wilt toevoegen kies je voor "Add". Je krijgt vervolgens onderstaande scherm.
Je geef het Export item een naam (zoals deze in de tool zichtbaar is), hierna selecteer je een rapport. De rapporten welke je wilt gebruiken bij de export dienen geplaatst te zijn in de "Dataset" map in de BI omgeving.
Na het toevoegen van het Export item zie je onderstaande scherm.
De onderstaande tabel beschrijft de velden die u kunt gebruiken tijdens het creëren / configureren van de export definitie.
Veld | Functionaliteit |
Selected output format |
U kunt de data direct opslaan vanuit de rapportage omgeving, de data zal dan exact hetzelfde zijn als wanneer u het rapport download via de BI webinterface. |
Direct output location | Hier specificeerd u het pad waar het directe bestand moet worden opgeslagen |
Postprocess data using extension | Wanneer u meer controle wilt over de data kunt u gebruik maken van een extension. Vanuit ValueBlue zullen er extensies geleverd worden. U kunt ook zelf een extensie maken. |
Post process data | Wanneer u kiest voor "Postprocess data using extension" kunt u in de dropdown een van de bekende extensies selecteren |
Selected Extension parameters | Afhankelijk van de gekozen extensies zullen hier de mogelijke parameters van de gekozen extensie verschijnen. |
Empty before update | Hier geeft u aan of de aanwezige items in de database moeten worden verwijderd bij een synchronisatie. |
Should this report refresh in the background | Indien u de export op interval basis wilt downloaden, dient u deze optie aan te vinken. |
Update interval | Hier voert u de synchronisatie interval in (in uren). |
Start on | Hier voert u de datum in vanaf wanneer u de synchronisatie wilt starten. |
Om de aangemaakte export definitie op te slaan, kiest u voor "Save" in het "File" menu.
Wanneer je niet wilt wachten op de download interval of wanneer je een download wilt forceren, selecteer je het synchronisatie icoon (recht boven bij de export gegevens) .
DataCollection Versies
Hieronder ziet u een overzicht van de verschillen tussen de BlueDolphin DataCollection versies
Bestand | Opmerkingen |
BlueDolphin DataCollection - 20200731 |
Huidige versie |
BlueDolphin DataCollection - 20180430 | Tweede versie, Ondersteuning voor TLS1.1 & TLS 1.2 (update interval in minuten) |
BlueDolphin DataCollection | Initiele versie, ondersteuning voor TLS 1.0 |
Opmerkingen
0 opmerkingen
U moet u aanmelden om een opmerking te plaatsen.