Nedap healthcare OnsDB: Certificaataanvraag, selectie van gegevens (parameters) en gebruik

Transcriptie

1 OnsDB: Certificaataanvraag, Voordat OnsDB voor de eerste keer op een computer gebruikt kan worden is het nodig om door Nedap een certificaat te laten goedkeuren. Het certificaat wordt aangevraagd door OnsDB de eerste keer te starten. Hoe dat precies in zijn werk gaat wordt in dit artikel toegelicht. Ook wordt toegelicht welke parameters op te geven zijn en wat deze inhouden. Bij het configureren van de parameters is het raadzaam om de toepassingsmogelijkheden van OnsDB te kennen. In dat artikel wordt aan de hand van twee voorbeelden uitgelegd welke parameters in welke situatie raadzaam zijn. Ons DB 4 certificaataanvraag Voor het aanvragen van het certificaat moet eerst het configuratiebestand gevuld zijn. Verderop in deze handleiding staat beschreven hoe het configuratiebestand opgebouwd moet worden. Start een command prompt, ga naar het pad waar de OnsDB 4 executable staat en start het programma met een configuratiebestand als parameter. Het starten van OnsDB met een bestaand configuratiebestand genaamd onsdb.cfg in dezelfde map kan bijvoorbeeld als volgt: C:\onsdb>onsdb.exe onsdb.cfg Let op: De eerste keer dat OnsDB 4 gestart wordt op een nieuwe machine of voor een nieuwe klantomgeving is het noodzakelijk dat er een certificaat aangevraagd wordt. Deze aanvraag bestaat uit 2 stappen: U dient OnsDB te openen en de aanvraag middels OnsDB te doen. Dit gebeurt automatisch zodra OnsDB de eerste keer gestart wordt. U dient de naam van het certificaat bij Nedap bekend te maken. Dit kan alleen via een support ticket. De getoonde naam van het certificaat is zichtbaar in OnsDB op het moment dat deze de eerste keer wordt gestart. Zodra wij de aanvraag via het ticket hebben ontvangen, wordt gecontroleerd of de naam van het opgegeven certificaat en de aanvrager daarvan overeen komt met de gegevens die wij zien in de certificaataanvraag. Alleen personen in dienst bij de zorginstelling zoals deze bij ons bekend zijn, kunnen deze aanvraag indienen. Zodra de gegevens door ons gecontroleerd zijn, zullen wij de certificaataanvraag goedkeuren. Zodra dat is gedaan, is een geldig certificaat aanwezig waarmee OnsDB verbinding kan maken. Pagina 1 / 10

2 Let op: publiceer of deel de 'public key' niet. Niet met Nedap, niet met collega's, niet met andere organisaties. Bovenstaande melding wordt teruggegeven zodra het commando is uitgevoerd. De naam van het certificaat dient doorgegeven te worden aan Nedap door middel van een ticket. In dit voorbeeld kan in het ticket vermeld worden: "Graag ontvangen we goedkeuring voor het gebruik van OnsDB met certificaatnaam: onsdb-te0039-nvc2852" Pagina 2 / 10

3 Wanneer OnsDB opnieuw wordt opgestart, wordt deze melding gegeven zolang het certificaat niet door Nedap is goedgekeurd. De certificaatnaam wordt daarbij steeds getoond, zodat deze alsnog doorgegeven kan worden indien dit in de vorige stap is misgegaan. Starten van OnsDB 4 OnsDB 4 wordt altijd uitgevoerd via de command prompt. Dit maakt het makkelijk om via een taskscheduler op vaste tijdstippen de download te laten plaatsvinden. In tegenstelling tot versie 1.x beschikt versie 4 niet over een grafische user interface. Het starten van OnsDB 4 wordt gedaan met het volgende commando(onsdb.exe) en parameter(onsdb.cfg): onsdb.exe onsdb.cfg Pagina 3 / 10

4 Configuratiebestand In het configuratiebestand wordt aangegeven welke gegevens gedownload worden en hoe het in de database opgeslagen moet worden. Witregels en regels die beginnen met een # worden genegeerd. De instellingen zelf volgen het formaat: instelling = waarde De instellingen in dit bestand zijn verdeeld in een aantal categoriëen, een categorie wordt aangegeven als: [categorie] Alle mogelijke instellingen worden hieronder beschreven. Daarna volgt een volledig voorbeeld van het configuratiebestand. Uitsluiten van een regel Indien een regel begint met een # (hashtag), wordt de betreffende regel genegeerd. Een voorbeeld is gebruik van de schema-versie. Pagina 4 / 10

5 #schema-version = In dit geval wordt, ook al staat het versienummer opgegeven, het versienummer genegeerd en treed de default-waarde in werking. In dit voorbeeld houdt het in dat de nieuwste schemaversie wordt gebruikt. Categorie [onsdb] De categorie onsdb bevat instellingen gerelateerd aan de werking van onsdb. [onsdb] url (verplicht) De URL van de applicatie. url = klantnaam.ioservice.net start en end Hiermee kan het begin en einde van een periode opgegeven worden. De einddatum is tot-enmet. Deze periode wordt gebruikt om de tabellen die dat ondersteunen tijdsgebonden op te halen (bijvorbeeld voor presence_logs, finance_logs of presence_logs_products). Hiermee worden onnodig lange doorlooptijden voorkomen. De waarde moet opgegeven worden in het formaat: jjjj-mm-dd Waarbij jjjj staat voor het jaar, mm de maand en dd de dag. Er zijn een aantal speciale waardes die ook gebruikt kunnen worden. Deze waarden zijn case- sensitive: today yesterday Deze berekenen de huidige dag of gisteren op basis van het moment van starten van OnsDB. Pagina 5 / 10

6 Indien deze instellingen niet opgegeven worden dan zal OnsDB de standaard waardes gebruiken. Voor start is dit 1 januari van het voorgaande jaar en voor end is dit yesterday. Om bijvoorbeeld alleen de gegevens van juni 2017 te downloaden: start = end = Om alle gegevens vanaf 1 januari 2018 tot-en-met vandaag te downloaden: start = end = today include en exclude Met deze parameters kan worden aangegeven welke tabellen juist wel of niet gedownload moeten worden. Beide parameters verwachten een komma-gescheiden lijst van tabelnamen. Met include kun je een lijst opgegeven van tabellen die juist alleen gedownload moeten worden. Met exclude kun je een lijst opgeven van tabellen die juist niet gedownload moeten worden. Om bijvoorbeeld alleen de invoices en invoice_rows te downloaden: include = invoices, invoice_rows Of om alle tabellen behalve de presence_logs te downloaden: exclude = presence_logs Het is mogelijk om OnsDB een rapport te laten versturen naar een zelfgekozen adres. Dit rapport bevat een overzicht van de doorlooptijd en eventuele fouten die zijn tegengekomen. Bijvoorbeeld: = mail@example.com Pagina 6 / 10

7 schema-version Met deze instelling kan opgegeven worden welke versie van het OnsDB datamodel gedownload moet worden. Dit biedt de mogelijkheid om op eigen gelegenheid te migreren naar een nieuwere versie van het datamodel. Als deze instelling niet wordt opgegeven, zal altijd de meest recente versie van het datamodel gedownload worden. Let op: Als de schema-versie niet wordt vastgezet (en dus de meest recente versie wordt gedownload), zal dit gevolgen kunnen hebben voor achterliggende tooling. Nieuwere datamodellen kunnen namelijk nieuwe tabellen bevatten, maar ook kunnen oude tabellen zijn verwijderd. Eventueel daarop aangesloten tooling zoekt in een dergelijk geval naar gegevens die er niet meer zijn. Om dit (in de meeste situaties) te kunnen voorkomen is het raadzaam om het datamodel vast te zetten en periodiek aan te passen. Datamodellen worden 6 maanden ondersteund. Om bijvoorbeeld versie 4048 te downloaden: schema-version = 4048 Een lijst met alle beschikbare versie van het datamodel is op te vragen met de -list-versions parameter. C:\onsdb>onsdb.exe onsdb.cfg -list-versions threads Met deze instelling wordt aangegeven hoeveel systeem-threads gebruikt mogen worden tijdens het downloaden. De waarde van deze instelling kan invloed hebben op de doorlooptijd van OnsDB. De standaardwaarde van deze instelling is 4. De aanbevolen waarde is het aantal processoren die er beschikbaar zijn, maar nooit meer dan 4. proxy Indien gebruik gemaakt wordt van een proxy-server, dan kan hiermee de URL van de proxyserver aangegeven worden. [database] De categorie database bevat de verbindingsinstellingen voor de lokale database. Pagina 7 / 10

8 [database] type (verplicht) Het type van de lokale database. Ondersteunde waardes zijn mssql voor een Microsoft SQL Server database of mysql voor een MySQL database. Om bijvoorbeeld een verbinding met een Microsoft SQL server te maken via ODBC: type = mssql of voor een MySQL server: type = mysql odbc Om gebruik te maken van een Microsoft SQL Server database moet een ODBC koppeling gemaakt worden. Deze instelling moet de naam van deze koppeling bevatten. odbc = onsdb4 username en password Indien een gebruikersnaam en wachtwoord nodig zijn om verbinding te maken met de lokale database dan kunnen die met deze instellingen aangegeven worden. username = onsdb password = 123 database Met deze instelling wordt de naam van de te gebruiken database opgegeven. database = onsdb Pagina 8 / 10

9 host en port Indien de databaseserver niet op de lokale machine draait dan kan hiermee het IP nummer of de hostname en de poort van de databaseserver opgegeven worden. host = port = 3308 options Eventuele extra verbindingsopties kunnen met behulp van deze instelling opgegeven worden. Standaard wordt in MySQL de datum en tijd opgeslagen in de UTC tijdzone. Afhankelijk van wintertijd en zomertijd kan het verschil met de Nederlandse tijd 1 of 2 uur zijn. Dit kan leiden tot een verschil van 1 dag in sommige gevallen. Om de datum en tijd in de nederlandse tijdzone op te slaan kan er de volgende optie gebruikt worden: options = loc=local [certificate] De categorie certificate bevat de contactgegevens van de persoon die verantwoordelijk is voor het beheren van het toegangscertificaat. [certificate] name, en tel (verplicht) De naam en contactgegevens van de verantwoordelijke. name = Voornaam Achternaam = @example.com tel = Pagina 9 / 10

10 Voorbeeld configuratiebestand [onsdb] url = klantnaam.ioservice.net start = end = yesterday include = presence_logs #exclude = #schema-version = 4048 #threads = 4 #proxy = = mail@example.com [database] type = mssql odbc = onsdb username = onsdb password = onsdb database = onsdb #host = localhost #port = 3306 #options = loc=local [certificate] name = Voornaam Achternaam = @example.com tel = Pagina 10 / 10