Wanneer u eenmalig of niet structureel data wilt inbrengen in (of exporten uit) BlueDolphin, kunt u de StandAlone Commandline tool gebruiken. Deze commandline tool gebruikt de opgeslagen StandAlone Import configuratie bestanden als input. Dit artikel bevat een .zip file met de benodigde software.
Wanneer u de software heeft uitgepakt, bevat deze de bestanden voor de "StandAlone Commandline tool". U dient wel (eenmalig) de configuratie uit te voeren, dit doet u door het bestand "DataCollection.Agent.Host.StandAloneCmd.exe.config" te openen.
Hierin dient u de volgende eigenschappen te configureren. De waarden vindt u terug in het beheer menu van BlueDolphin.
Configuratie eigenschap | Waarde |
DataCollection.Tenant.APIKey | Deze kunt u vinden in BlueDolphin. Ga hiervoor naar het beheer menu en kies vervolgens links in het menu de optie "Algemeen". Daar vindt u de Datacollectie API key. Deze vult u hier in. |
DataCollection.Tenant | Deze kunt u vinden in BlueDolphin. Ga hiervoor naar het beheer menu en kies vervolgens links in het menu de optie "Algemeen". Daar vindt u de waarde "Database". Deze vult u 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. |
Wanneer binnen uw organisatie gebruik wordt gemaakt van een Proxy server om naar het internet te verbinden, dient u de onderstaande configuratie elementen van een waarde te voorzien.
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 |
Gebruik
Zoals aangegeven verwerkt de Commandline tool de configuratie bestanden van de StandAlone Import tool als import.
De Commandline tool ondersteund de volgende argumenten
Argument | Waarde |
--files | Hier geeft u de configuratie bestand(en) welke u wilt laten verwerken door de Commandline tool |
--replace | Hier kunt u variabelen in de configuratie bestanden een waarde geven. Het is dus mogelijk de configuratie bestanden te voorzien van een variabele. |
--mode | Hier geeft u aan of er een import of export moet plaatsvinden. |
Voorbeelden
Import enkele file, geen variabelen
Commando : DataCollection.Agent.Host.StandAloneCmd.exe --files import1.xml
Uitvoer: Bovenstaande commando verwerkt het bestand "import1.xml" uit de huidige folder
Import meerdere files, geen variabelen
Commando : DataCollection.Agent.Host.StandAloneCmd.exe --files import1.xml "d:\import2.xml" "c:\temp\import3.xml"
Uitvoer: Bovenstaande command verwerkt de configuratie bestanden : "import1.xml" uit de huidige folder, "import2.xml" uit d:\ en "import3.xml" uit c:\temp
Import enkele file, met variabelen
Commando : DataCollection.Agent.Host.StandAloneCmd.exe --files import1.xml --replace "%pass%=geheim" "serverwaarde=server01"
Uitvoer : Bovenstaande commando verwerkt het bestand import1.xml uit de huidige folder. Hierin wordt de waarde %pass% vervangen door geheim en serverwaarde vervangen door server01.
Export enkele file, geen variabelen
Commando : DataCollection.Agent.Host.StandAloneCmd.exe --files export1.xml --mode export
Uitvoer: Bovenstaande commando verwerkt het bestand "export1.xml" uit de huidige folder, en zal dus informatie exporteren uit BlueDolphin.