Nápověda k programu SmartMEDIX®

Externí programy

Konfigurace externích programů slouží pro nastavení propojení s programy třetích stran. Při zavolání externího programu dochází k synchronizaci údajů o pacientovi a v závěru k přenosu zprávy/protokolu/obrázků z externího programu do dokumentace SmartMEDIXu. Konfigurace se provádí v menu Konfigurace→Aplikace→záložka Externí programy.

Tlačítka

• Načíst - načte ikonu z vybraného souboru
•  Převzít - načte ikonu přidruženou k vybranému programu
• Přidat nové zařízení - založí nový externí program a přednastaví parametry dle zvolené šablony

Přidání nového externího programu ze šablony

V záložce Externí programy klikneme na tlačítko Přidat nové zařízení. V okně Potvrzení, které se následně otevře, vybereme druh zařízení a poté potvrdíme kliknutím na OK.

Ruční přidání externího programu

Klikneme na tlačítko Nový nebo použijeme klávesu Ins. Poté zadáme název a nastavíme ostatní parametry dle potřeby. Potvrdíme kliknutím na tlačítko Ulož.

V obou případech přidání externího programu vždy zkontrolujte správnost cesty k externímu programu.

Sloupce tabulky

• název - název, který je zobrazen v nástrojové liště a menu.
• druh programu - u specificky komunikujících zařízení je nutné přepnout na příslušný druh programu.
• ikona - ikona použitá pro zobrazení v nástrojové liště a menu.
• zkratka - klávesová zkratka pro rychlé vyvolání.
• specvys - kód specializovaného vyšetření. Je-li nastaveno, provede se zároveň přepis do specializovaných vyšetření pacienta.
• dekurs - výstup z ext. programu je přenesen do dekursu s datem vyšetření.
• jednou - hlídání, zda již není program spuštěn. Je-li již program spuštěn, pak se pouze přenese do popředí.

Záložka: Parametry

• Program - cesta a název programu nebo jen název programu, který má být spuštěn
• Cesta - umístění, ze kterého se má program spustit
• Parametry - parametry, které jsou předány programu. Je zde možno použít předdefinovaných atributů
• Kódování - použité kódování pro vstupní/výstupní soubory a parametry
• Šablona - šablona, na základě které je vygenerován vstupní soubor pro externí program. Je zde možno použít předdefinovaných atributů
• Vstupní soubor - umístění a název vstupního souboru pro externí program
• Výstupní soubor - umístění a název výstupního souboru z externího programu pro SmartMEDIX. Je- li vyplněn, SmartMedix čeká, dokud není externí program ukončen nebo nebyla předána požadovaná data v uvedeném výstupním souboru.

Příklady šablon jsou k dispozici v podadresáři import programu.

Záložka: Dekurs

Není-li nastaven výstupní soubor, přepíše se do dekursu zde uvedený text.

Záložka: GDT rozhraní

• Odesílatel - čtyřmístný identifikační kód odesílatele (kód SmartMEDIXu - většinou EDV1)
• Příjemce -  čtyřmístný identifikační kód příjemce (kód externího programu)
• Operace - akce, která je požadována po externím programu (otevřít staré vyšetření, založit nové vyšetření)
• Metoda - požadovaný druh vyšetření (EKG, EEG, Spirometrie apod.)

Kódy příjemce a odesílatele musí být shodně nastaveny v externím programu.

Příznaky

Vybereme druhy GDT vět, které chceme přenášet do dekursu.

Příznak Nezalamovat řádky jedné věty způsobí úsporný přepis zprávy z externího programu, kdy řádky každé datové věty nejsou odřádkovány, ale jsou spojeny za sebe do jednoho odstavce. Tato volba zároveň vypne proporční písmo.

Předdefinované atributy

Formát atributu:

• %{DELKA|X}ATRIBUT% - předdefinovaný atribut. Seznam platných hodnot je uveden níže.
• #KATEGORIE\NAZEV# - použije uloženou hodnotu z profilu uživatele pro danou KATEGORII a NÁZEV
• %{DELKA|X}@SLOUPEC% - z aktuální tabulky aktuálního záznamu použije hodnotu uvedeného pole SLOUPEC
• %{DELKA|X}@SLOUPEC1|SLOUPEC2|SLOUPEC3|...% - z aktuální tabulky aktuálního záznamu použije hodnotu uvedeného pole SLOUPEC1, není-li k dispozici, použije se pole SLOUPEC2, ...

Je-li zadána délka, pak je atribut předán v dané pevné délce. Parametr X (včetně oddělovače) není povinný a určuje znak, kterým bude text do požadované délky doplněn. Pro 0 se doplňuje zleva, pro ostatní znaky zprava. U rodného čísla je délkou řízen formát.

Sezam dostupných atributů (ATRIBUT):

• RODCIS - rodné číslo pacienta - délka 10 (např. 7706271111) - výchozí, 11 (např. 770627/1111), 12 (např. 77.06.-27/1111), 13 (např. 77-06-27/1111)
• RODCIS1 - rodné číslo pacienta ve formátu 770627_1111
• DATNAR - datum narození pacienta
  • DATNAR_YMD př.: 20231230
  • DATNAR_Y-M-D př.: 2023-12-30
  • DATNAR_Y/M/D př.: 2023/12/30
• PM - poslední menstruace pacientky - délka 8 (RRRRMMDD), délka 10 (DD.MM.RRRR) - výchozí
• CELEJMENO - celé jméno pacienta
• PRIJMENI - příjmení pacienta
• JMENO - jméno pacienta
• TITUL - titul pacienta
• POHLAVI - pohlaví pacienta: M=muž, F=žena (nebo POHLAVI_MZ: M=muž, Z=žena; POHLAVI_MZ1: m=muž, z=žena; POHLAVI_12: 1=muž, 2=žena)
• ULICE - ulice trvalého bydliště
• OBEC - místo trvalého bydliště
• PSC - PSČ trvalého bydliště
• POJ - pojišťovna, u které je pacient aktuálně registrován
• KONTAKT - kontaktní telefon
• TELEFON - kontaktní telefon
• MOBIL - kontaktní mobilní číslo
• EMAIL - kontaktní email
• DATE - aktuální datum
• TIME - aktuální čas
• DATETIME (DATETIME1) - aktuální datum a čas DD.MM.RRRR HH:MM:SS (DD.MM.RRRR HH:MM)
• TIMESTAMP - časové razítko (počet milisekund)
• OSCISLO - osobní číslo pacienta
• DGx - diagnóza pacienta z dekursu, kde x je číslo od 1 do 5
• VYSKA, VAHA - výška, váha pacienta a další parametry aktuálního přítomného stavu pacienta (TLAKSYS, TLAKDIA, PULS, BMI, BMITEXT, SCORE, CHOLESTEROL, CHOLHDL, CHOLLDL, ...)
• ICP, ODB, LEKAR, LEKAR_ID, KODLEK - celé jméno, identifikátor a zkratka přihlášeného lékaře
• OSELEK, OSELEK_ID -  údaje a identifikátor ošetřujícího lékaře
• HASHOF(text) - provede výpočet MD5 zadaného textu
• IMPORT - parametr vstupního souboru
• EXPORT - parametr výstupního souboru
• PATH - parametr cesty
• TEMPLATE - parametr šablony
• GEN - vygeneruje tří-místný znakový kód unikátní v rámci 1s až 6h. Je-li v rámci jednoho volání atribut použit vícekrát, je hodnota stejná.
• INC - vygeneruje tří-místný číselný kód unikátní v rámci spuštění programu a rozsahu 000-999. Je-li v rámci jednoho volání atribut použit vícekrát, je hodnota stejná. 
• ICL - identifikační číslo lékaře zadaného v detailu karty přihlášeného lékaře

Otevření webového prohlížeče

Je-li v parametru Program uveden URL odkaz na internetovou stránku (začínající na http:// nebo https://), je otevřen výchozí webový prohlížeč a otevřeno příslušné URL. Parametry URL odkazu mohou být uvedeny přímo za URL (oddělené otazníkem) nebo v poli Parametry (bez otazníku).

Příklad:

Program: http://localhost/stranka.html?parametr1=hodnota1&parametr2=hodnota2

nebo

Program: http://localhost/stranka.html
Parametry: parametr1=hodnota1&parametr2=hodnota2

nebo

Program: iexplore.exe nebo firefox.exe
Parametry: http://localhost/stranka.html?parametr1=hodnota1&parametr2=hodnota2

Odeslání GET volání HTTP protokolem

Je-li v parametru Program uveden URL odkaz na internetovou službu (začínající na get-http:// nebo get-https://), jsou na příslušné URL předány parametry dotazu. Ty musí být uvedeny v poli Parametry (bez otazníku).

Odeslání POST volání HTTP protokolem

Je-li v parametru Program uveden URL odkaz na internetovou službu (začínající na post-http:// nebo post-https://), jsou na příslušné URL předány parametry dotazu. Ty musí být uvedeny v poli Parametry (bez otazníku).

Vyvolání externího programu

Vyvolat příjem dat z nastavených externích progamů je možné v menu Nástroje→Ext. programy a kliknutím na příslušnou ikonku.

Pro rychlé vyvolání externího programu je možné umístit ikonu na Vaši nástrojovou lištu. Pro GDT: u takto umístěné ikony je navíc možné pomocí pravého tlačítka myši dočasně změnit přednastavenou operaci (otevřít staré vyšetření, založit nové vyšetření).

Je-li nastaven parametr výstupního souboru, čeká SmartMEDIX na příjem dat z externího programu, tj. na ukončení externího programu nebo vytvoření daného výstupního souboru.

Přenos výsledků

Podporuje-li externí program přenos výsledků měření zpět, jsou tyto přepsány do SmartMEDIXu jako příloha dekursu založeného ke dni měření (je-li zapnuta volba Dekurs) nebo/a pod nastavenou skupinu specializovaného vyšetření (volba SpecVys).

Je-li součástí výsledku i externí dokument (PDF) či obrázek a je-li nastavena ve SmartMEDIXu obrazová dokumentace, pak se tyto přílohy přenesou do aktuální repozitoře a proběhne přepis těchto příloh do dekursu.

Příklad výstupu:

Práce na pozadí

Chceme-li v průběhu příjmu dat z externího programu dále pracovat, stiskneme tlačítko Storno a zvolíme Skrýt dialog. Chceme-li následně čekání na přenos ukončit, stiskneme opět ikonku externího programu na panelu nebo v menu a zvolíme Ukončit čekání.

Zrušit čekání

Chceme-li čekání na výstup z externího programu stornovat, klikneme na tlačítko Storno a zvolíme Ukončit čekání. Běží-li příjem na pozadí, stiskneme opět ikonku externího programu na panelu nebo v menu a zvolíme Ukončit čekání.

Chyba volání

Nastane-li během volání externího programu nebo příjmu dat, je uživatel informován o této skutečnosti zobrazením výstrahy Windows v pravém dolním rohu obrazovky. Chybové hlášení je rovněž zaznamenáno do systémového protokolu běhu aplikace SmartMEDIX - menu Nápověda→Zobrazit protokol.

Časté chyby a jejich řešení

V přijatých datech neodpovídá RČ pacienta - rodné číslo v odpovědi externího programu se neshoduje s rodným číslem aktivního pacienta v době volání programu.

Neodpovídá délka věty - chyba může být mimo jiné způsobena rozdílem použité znakové sady (kódováním) externího programu vůči očekávanému kódování ve SmartMEDIXu (Win1250 a UTF8). Zkusíme upravit kódování v parametrech.

Při sestavování dat pro externí program nastala chyba - při vytváření vstupního souboru nastala chyba, zkontrolujeme, zda existuje cílový adresář a zda máme do něj právo zápisu.

Při příjmu dat z externího programu nastala chyba -  při vytváření výstupního souboru nastala chyba, zkontrolujeme, zda existuje cílový adresář a zda máme do něj právo zápisu.

Externí program byl nečekaně ukončen nebo se nepodařilo úspěšně přijmout data - externí program byl ukončen, ale očekávaný výstupní soubor nebyl nalezen. Pravděpodobně nedošlo v externím programu k vygenerování výstupního souboru.

Externí program nelze spustit - volání externího programu selhalo, zkontrolujeme platnost cesty a spouštěného souboru (exe souboru).

Chybná syntaxe xml souboru - chybný formát výstupního XML souboru programu MESI

Neočekávaný identifikátor příjemce - GDT - identifikátor příjemce ve výstupním souboru se neshoduje s očekávaným identifikátorem. Zkontrolujeme, zda jsou parametry v externím programu i SmartMEDIXu shodně nastaveny.

Neočekávaný identifikátor odesílatele - GDT - identifikátor odesílatele ve výstupním souboru se neshoduje s očekávaným identifikátorem. Zkontrolujeme, zda jsou parametry v externím programu i SmartMEDIXu shodně nastaveny.

Nepodporovaný druh odpovědi - GDT - druh odpovědi ve výstupním souboru není očekáván (SmartMEDIX očekává odpověď č. 6310)

Doporučená nastavení

PACS (ICZ)

Po vložení šablony nastavení nahraďte v poli parametr výraz __HESLO__ skutečným heslem přiděleným vašemu zařízení.

Pokud budete chtít pacienta rovnou vyhledat, přidejte do pole parametr action=S. Chcete-li snímky rovnou otevřít upravte v parametru action na action=O.

BlueCherry

Konfigurace

Tlačítko Konfigurace slouží k úpravám nastavení, která souvisejí s administrativními záležitostmi, jako např. personál, zařízení apod.