Wanneer je eenmalig of niet structureel data wilt inbrengen in BlueDolphin kun je gebruik maken van de StandAlone Dataconnector. Dit artikel bevat een .zip file met de benodigde software en een template.json bestand.
Wanneer je de software hebt uitgepakt, bevat deze de "DataCollection StandAlone.msi". Deze installeer je op een machine die toegang heeft tot de data en het internet. Plaats vervolgens de template.json file in de installatie folder.
Nadat je de StandAlone Dataconnector hebt geïnstalleerd en de file hieraan hebt toegevoegd, open je het bestand "DataCollection.Agent.Host.StandAloneImport.exe.config" in de installatie folder (%PROGRAMFILESFOLDER%\ValueBlue BV\StandAloneImport).
Hierin dien je de volgende eigenschappen te configureren.
De waarden vind je terug in het beheer menu van BlueDolphin.
Configuratie eigenschap | Waarde |
DataCollection.Tenant.APIKey | Deze kun je vinden in BlueDolphin. Ga hiervoor naar het beheer menu en kies vervolgens links in het menu de optie "Algemeen". Daar vind je de Datacollectie API key. Deze vul je hier in. |
DataCollection.Tenant | Deze kun je vinden in BlueDolphin. Ga hiervoor naar het beheer menu en kies vervolgens links in het menu de optie "Algemeen". Daar vind je de waarde "Database". Deze vul je hier in. |
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 StandAlone applicatie 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 | Maak je gebruik van een Proxy server |
PresentationServiceProxyAddress | Adres van de proxy server | |
PresentationServiceProxy UseCustomCredentials | true / false | Dien je aanmeldings gegevens te specificeren voor het gebruik van de proxyserver |
PresentationServiceProxyUsername | Proxyserver gebruikers naam, deze in het formaat %domain%\%username% | |
PresentationServiceProxyPassword | Proxyserver gebruikers wachtwoord |
Zodra je de StandAlone datacollector hebt gestart krijg je onderstaande scherm.
Zoals je ziet kun je hier de Tenant name & APIKey ook nog aanpassen.
Je dient op "Connect" de drukken zodat de StandAlone connectie maakt met jouw BlueDolphin instantie. Wanneer dit gelukt is kun je een Template selecteren zodat "Data Provider", "Connection String" en "Select Statement" al worden ingevuld. Je hoeft deze alleen maar compleet te maken. Zie onderstaande scherm.
De onderstaande tabel beschrijft de velden die je moet invullen tijdens het creëren van de databron definitie en configuratie.
Veld | Functionaliteit |
BlueDolphin Target Collection | Hier specificeert je de naam van de bron, zoals deze in de BlueDolphin moet worden aangemaakt. |
Data Provider | Hier krijg je een overzicht van de op de machine aanwezige data providers. Door het selecteren van een Template word deze automatisch ingevuld. |
Connection String | Hier staat de connectie string om de data bron te benaderen. Pas %%FILEPATH%% aan, hierbij moet de naam van het bron bestand ook toegevoegd worden. Plaats dit tussen " ". Voorbeeld: "C/....Testbron.xlsx" |
Select Statement | Hier staat het select statement die de data oplevert en gebruikt dient te worden binnen BlueDolphin. Pas hier %%SHEETNAME%% aan en laat het $ teken staan. Dit hoeft niet tussen " ". |
Preview | Door op de "Preview" knop te drukken, kun je bekijken wat het resultaat is van de connectionstring en het select statement. |
Primary key(s) | Hier voer je één of meerdere velden in die een unieke rij identificeren. Er dient een Primary key gespecificeerd te zijn als men gebruik wil maken van automatische updates. Wanneer u meerdere velden wilt gebruiken dient u deze te scheiden door middel van ";" |
Zodra je de connectie gegevens compleet hebt kun je via "Preview" kijken of de data eruit ziet zoals je verwacht. Indien dit het geval is kunt je via "Start Import" de data richting jouw BlueDolphin omgeving zenden.
Configuratie laden / opslaan.
Wanneer je verwacht dezelfde bron nogmaals te moeten importeren kun je de configuratie opslaan, dit doe je door te kiezen voor "File", "Save". De configuratie zal worden opgeslagen in een .xml file.
Door te kiezen voor "File", "Load" kun je een opgeslagen .xml configuratie file laden.
Je kunt de .xml configuratie file ook met behulp van de StandAlone command line importeren in BlueDolphin