Bedoelde je soms ?
Is dit de eerste keer dat je OnsDB gebruikt? Bekijk dan eerst de uitleg over deze applicatie.
Er zijn grofweg twee manieren waarop OnsDB gebruikt wordt: indicenteel gebruik zonder achterliggende tooling of structureel gebruik met achterliggende tooling. Doordat de uitgangspunten van beide manieren verschillen, kennen ze ook een andere benadering van de configuratie van OnsDB:
Structureel gebruik: je wilt elke dag een gestructureerd overzicht met gedetailleerde gegevens over de productiviteit binnen je organisatie. Je wilt deze gegevens inzien in een Business intelligence tool (BI-tool).
Incidenteel gebruik: je wilt in Excel eenmalig een overzicht genereren waarmee je bepaalde gegevens in een oogopslag kunt zien. Je weet op dat moment nog niet precies welke tabellen nodig zijn om dit overzicht te kunnen maken. Je wilt alle gegevens opvragen die op dit moment in de applicatie beschikbaar zijn, zodat je daarna deze gegevens zelf via een SQL-programma in kunt zien en naar Excel kunt kopiëren.
Het is raadzaam om in een dergelijk geval voor de volgende configuratie te kiezen:
Soort data:
Zet met de schema-version parameter de structuur van de data die je wilt ophalen vast. Om te voorkomen dat ongewenste data opgehaald wordt, is het raadzaam om de ondersteuning van datamodellen te bestuderen.
Kies ervoor om alleen de gewenste tabellen op te halen door middel van de include en exclude parameters. Dit zorgt ervoor dat de OnsDB run sneller verloopt en dat de lokale database minder belast of vervuild wordt met gegevens die niet gebruikt worden. Daarnaast is de kans op irrelevantie foutmeldingen in de log kleiner.
Stel een beperkte periode in door middel van de start en end parameters. Als het bijvoorbeeld niet nodig is om zorgregels op te vragen die ouder zijn dan een aantal dagen/weken/maanden/jaren, laat deze dan buiten beschouwing. Deze parameters hebben op een beperkt aantal, maar grote, tabellen invloed. Dit heeft dezelfde voordelen als het vorige punt.
Interval:
Gezien het repeterende karakter van het ophalen van gegevens, is het raadzaam om deze als automatische taak in Windows te plannen met behulp van de "task scheduler". Selecteer hierbij bij het instellen van programma het OnsDB-batch bestand.
Daarnaast is het aan te raden om de schermoutput naar een bestand te schrijven, zodat het op een later tijdstip geraadpleegd kan worden in geval van problemen bij het ophalen van data. Om schermoutput naar het bestand te schrijven kan het volgende commando aangeroepen worden via het batchbestand:
cmd/c onsdb.exe onsdb.cfg >> CMDoutput_%date:~-4,4%%date:~-7,2%%date:~-10,2%.txt 2>&1
Dit genereert een bestand met naam CMDouput_[huidigedatum].txt. Indien er meerdere runs op een dag lopen, worden deze aangevuld in hetzelfde bestand.
Op elke dinsdagavond kunnen er tussen 19:00 en 22:00 uur onderhoud en updates worden uitgevoerd aan onze systemen en infrastructuur. Als dit gebeurt op het moment dat een OnsDB-run wordt gedaan, kan dit betekenen dat de OnsDB-run mislukt. Plan daarom automatische runs op dinsdag pas na 22:00 uur.
Kies de meeste recente schema-version. Dit is automatisch het geval als je deze niet in de configuratie opgeeft. Het is af te raden om de (op dat moment) hoogste schema-version in de configuratie op te geven, want deze zal na verloop van tijd verouderd zijn. Daardoor wordt op een later moment mogelijk (onbewust) een oudere versie opgevraagd.
Kies ervoor om alle tabellen op te halen. Dit is het geval als je niet in de configuratie de include en exclude parameters opgeeft.
Gebruik geen restrictie op begin- of einddatums. Dit is het geval als je geen gebruik maakt van de start en end parameters opgeeft.
Aangezien het een eenmalige actie betreft, is het afdoende om OnsDB handmatig te starten en geen automatische taak te maken.
Op elke dinsdagavond kunnen er tussen 19:00 en 22:00 uur onderhoud en updates worden uitgevoerd aan onze systemen en infrastructuur. Als dit gebeurt op het moment dat een OnsDB-run wordt gedaan, kan dit betekenen dat de OnsDB-run mislukt. Start daarom een run niet in dat tijdvak.