MicroHis Extraction Tool (installation and configuration)

OmniHis Extractie Tool (installatie, configuratie en extractie)
Inleiding
De OmniHis Extractie Tool is ontwikkeld om het eenvoudig te maken voor de zorgverlener om een
data extractie uit OmniHis te maken. Nadat de tool geïnstalleerd is kan de zorgverlener op
eenvoudige wijze een zip file genereren die vervolgens geüpload kan worden naar VIPLive. Van de
tool is zowel een Windows versie als een MacOS versie (voor Apple computers) beschikbaar.
Installatie
1. Kopieer de juiste versie (Windows of MacOS) van de tool (als zip-bestand) naar de gewenste
computer. De tool kan op de OmniHis server computer zelf worden geïnstalleerd, of op een
computer die toegang heeft tot de OmniHis server via een netwerk verbinding.
2. Creëer op de computer een “Calculus” folder, met daarin een subfolder, genaamd “Data” en
een subfolder genaamd “Extractor”. Unzip de zip file naar deze laatste subfolder.
pagina 1 van 4
Configuratie en extractie
1. Dubbelklik
het
“omnihis_extractor.exe”
bestand
(Windows
versie)
of
de
“omnihis_extractor.app” folder (MacOS versie) in de “Extractor” subfolder. De extractie tool
zal nu starten. Er verschijnt een zwart MS-DOS scherm en een grafisch configuratiescherm.
In het configuratiescherm kunnen de verbindingsinstellingen worden ingesteld om contact te
maken met de OmniHis database.
De volgende gegevens dienen te worden ingevuld of aangepast:





Server: Vul hier de computernaam van de OmniHis server computer in, of het IP-adres. Het
default IP-adres 127.0.0.1 kan gebruikt worden wanneer de extractie tool op de OmniHis
server computer zelf wordt geïnstalleerd.
Port: Dit is de communicatie poort via welke de extractie tool contact maakt de OmniHis
database. De standaard poort is 3306, deze kan naar behoefte aangepast worden indien er
communicatie problemen zijn.
Database: Vul hier de naam in van de OmniHis database waarvan de extractie gemaakt
moet worden. Deze gegevens zijn bekend bij de zorgverlener of diens systeembeheerder.
Username: Vul hier de gebruikersnaam in waarmee ingelogd kan worden op de OmniHis
database. Deze gegevens zijn bekend bij de zorgverlener of diens systeembeheerder.
Password: Vul hier het wachtwoord in behorend bij de gebruikersnaam waarmee ingelogd
wordt.
De ingevulde verbindingsgegevens kunnen worden bewaard door ze weg te schrijven naar een
configuratie file. Klik hiertoe op de knop “Save configuration to file” en sla het config.ini bestand
op in de “Extractor” subfolder. NB het ingevulde wachtwoord wordt hierbij gecodeerd opgeslagen.
Bij vervolg extracties kan de zorgverlener de opgeslagen gegevens weer openen door te klikken
op “Load configuration from file” en vervolgens de config.ini file in de “Extractor” subfolder te
selecteren.
pagina 2 van 4
2. Nadat de verbindingsgegevens zijn ingevuld of geladen van een configuratie file, dient nog de
export locatie en naam van het extractiebestand te worden gespecificeerd. Door op “Next” te
klikken verschijnt het volgende scherm:
De volgende gegevens dienen te worden ingevuld of aangepast:


Export location: Selecteer hier de folder waar het extractiebestand dient te worden
opgeslagen. Standaard kan hiervoor de subfolder “Data” in de “Calculus” folder worden
gebruikt (zie stap 2 van de installatie), maar andere folders zijn ook mogelijk.
Archive filename: Vul hier de gewenste naam in van het extractiebestand. Standaard is dit
“extractie.zip”. Dit kan veranderd worden in een meer specifieke naam, bijvoorbeeld met de
praktijknaam, zoals “extractie praktijknaam.zip”.
3. Klik vervolgens op “Next” om de configuratie van de extractie op te slaan. Het volgende
scherm verschijnt:
pagina 3 van 4
4. Klik op “Start” om de extractie te starten. Een voortgangsbalk geeft de voortgang van de
extractie weer. Zodra de extractie voltooid is verschijnt een “Exit” knop. Klik op deze knop om
de extractie tool te sluiten.
5. De data kan vervolgens geüpload worden naar VIPLive. Verwijder na afloop altijd de zip file
van de extractie uit de data folder, zodat er geen patiëntengegevens meer buiten OmniHis om
beschikbaar zijn.
Overige opmerkingen

Indien gewenst kan een shortcut naar de extractie tool op het bureaublad van de zorgverlener
worden geplaatst. Klik hiertoe in Windows met de rechter muisknop op het bestand
“microhis_extractor.exe” en selecteer “verstuur naar” en vervolgens “bureaublad (creëer
shortcut)”. Er wordt nu een shortcut op het bureaublad van de gebruiker geplaatst. Bij Apple
computers kan de “omnihis_extractor.app” folder van de extractor naar de werkbalk op het
bureaublad worden gesleept om een shortcut te maken.

De extractie tool genereert bij iedere extractie een log file in dezelfde folder als het extractie
bestand. Wanneer er problemen zijn met de extractie kan deze logfile bekeken worden voor
eventuele foutmeldingen.

Wanneer er meerdere databases (praktijken) aanwezig zijn op de OmniHis server en er
herhaaldelijk extracties van verschillende databases gemaakt moeten worden, is het aan te raden
om voor iedere database een eigen configuratie file op te slaan. De standaard naam “config.ini”
kan daarbij gewijzigd worden in bijvoorbeeld “config_praktijk1.ini” en “config_praktijk2.ini”. Ook is
het handig om de extractie files van verschillende praktijken op te slaan in verschillende data
folders, om te voorkomen dat extracties elkaar overschrijven.
pagina 4 van 4