Dit artikel is vertaald met behulp van AI en kan kleine onnauwkeurigheden bevatten. Raadpleeg de Engelse versie voor volledige nauwkeurigheid.
Als je een bestand met brondata eenmalig of niet structureel wilt importeren in BlueDolphin, kun je de StandAlone DataCollector-tool gebruiken.
Dit artikel bevat een .zip-bestand met de benodigde installer voor de software en een template.json-bestand. Je kunt dit installeren op een computer met Microsoft Windows, waarop de Microsoft Access DB Engine is geïnstalleerd en die toegang heeft tot internet.
Wanneer je het zip-bestand uitpakt, bevat het een "DataCollection StandAlone.msi"-bestand.
Plaats het template.json-bestand in de installatiemap.
Na het installeren van de StandAlone DataCollector, bewerk je het bestand "DataCollection.Agent.Host.StandAloneImport.exe.config", dat zich bevindt in de installatiemap (%PROGRAMFILESFOLDER%\ValueBlue BV\StandAloneImport), met een eenvoudige teksteditor.
Je moet de volgende instellingen configureren om de StandAlone DataCollector te laten werken. De benodigde waarden vind je in het onderdeel Algemeen van de module Admin.
Configuratie-eigenschap | Waarde |
DataCollection.Tenant.APIKey | De waarde vind je in je BlueDolphin-tenant, menu Admin > Algemeen > Datacollection API key. |
DataCollection.Tenant | De waarde vind je in |
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 adressen, afhankelijk van de locatie van je tenant. Na het bewerken en opslaan van het config-bestand moet je de StandAlone applicatie opnieuw starten. |
Als er een proxyserver nodig is om verbinding te maken met internet, zijn er configuratie-instellingen beschikbaar.
Configuratie-eigenschap | Waarde | Beschrijving |
PresentationServiceUseProxy | true / false | Is er een proxyserver nodig |
PresentationServiceProxyAddress |
| Adres van de proxyserver |
PresentationServiceProxy UseCustomCredentials | true / false | Zijn er andere inloggegevens nodig om verbinding te maken met de proxy. |
PresentationServiceProxyUsername |
| Gebruikersnaam om te authenticeren bij de proxyserver. Gebruik het formaat: %domain%\%username% |
PresentationServiceProxyPassword |
| Wachtwoord om te authenticeren bij de proxyserver |
Als alle instellingen juist zijn, kun je de StandAlone DataCollector-tool starten en verschijnt het onderstaande scherm.
Als dit nog niet is ingesteld in het config-bestand, kun je de Tenant naam & Tenant API Key aanpassen voordat je verbinding maakt met je BlueDolphin-tenant. Om deze informatie te vinden in je BlueDolphin-tenant, ga je naar Admin > Systeem > Algemeen. De tenantnaam heet 'Database' in BlueDolphin en de API key heet 'Datacollection API key'.
Zodra je zeker weet dat de tenantnaam & tenant API Key correct zijn, klik je op Koppel en wordt er verbinding gemaakt met de opgegeven BlueDolphin-tenant.
Als de verbinding is gelukt, kun je een "Target Collection" of een "Template" selecteren uit je BlueDolphin-tenant.
Een Template vult de velden "Data Provider", "Connection String" en "Select Statement" alvast in.
Je hoeft dan alleen nog de overige velden in te vullen (zie de afbeelding hieronder).
De onderstaande tabel legt de velden uit die aanwezig zijn in de StandAlone DataCollector-configuratie.
Veld | Beschrijving |
BlueDolphin Target Collection | Hier geef je de naam van de collectie op. Alle data uit de ingestelde bron wordt in deze collectie geladen. |
Data Provider | Hier kun je alle mogelijke data providers selecteren die op de machine zijn geïnstalleerd. De actieve data provider wordt geselecteerd. |
Connection String | Hier staat de connection string die door de Data Provider wordt gebruikt om verbinding te maken met de databron. |
Select Statement | Hier staat de select statement die door de data provider wordt gebruikt om de data uit de databron te halen (met de opgegeven connection string). |
Preview | Door op de knop Preview te drukken, krijg je alvast een voorbeeld van het resultaat van de connection string en de select statement. |
Primary key(s) | Hier moet je één of meerdere velden opgeven om een rij in de databron uniek te identificeren. Er moet een Primary Key aanwezig zijn als je de update-functionaliteit wilt gebruiken. Als je meerdere velden nodig hebt, kun je de velden scheiden met het teken ";" |
Als je klaar bent met het vervangen van de connection string en select statement, kun je op Preview klikken om te controleren of de data eruitziet zoals verwacht. Als de data goed is, klik je op Start Import om de data naar je BlueDolphin-omgeving te sturen.
Sla een importconfiguratie op of laad deze vanuit een bestand
Als je verwacht exact dezelfde data opnieuw te importeren, kun je de importconfiguratie opslaan in een bestand. Dit doe je door "Bestand" en "Sla op" te kiezen. De configuratie wordt nu opgeslagen in een .xml-bestand.
Door "Bestand" en "Laad" te kiezen, kun je het eerder opgeslagen .xml-configuratiebestand laden.
Je kunt een .xml-configuratiebestand ook gebruiken met de StandAlone Commandline.