LISPAT - Dokumentacja

Ta strona jest tylko do odczytu. Możesz wyświetlić źródła tej strony ale nie możesz ich zmienić.
====== Instrukcja konfigurowania połączenia HL7 ======

Konfigurację połączenia HL7 wykonuje się w menu:

Administracja > Konfiguracja > Komunikacja > Integracje

Okno konfiguracji połączenia HL7 jest podzielone na zakładki

=== Jednostka zlecająca === 

Na tej zakładce wybieramy z listy jednostkę zlecającą. 

{{::hl7-konfiguracja-02.png|}}

=== Połaczenie ===

  * W polu HIS Host podajemy adres IP bramki HL7 po stronie jednostki zlecającej
  * W polu HIS Port podajemy numer portu, na który wysyłane są nasze komunikaty
  * W polu LIS Port podajemy numer portu, na którym nasłuchuje nasza bramka, i na którą jednostka zlecająca wysyła swoje komunikaty
  * W polu Timeout ACK podajemy czas (w sekundach), jaki nasza bramka będzie oczekiwała aż jednostka zlecająca potwierdzi odbiór naszego komunikatu. Po upływie tego czasu, jeżeli nie otrzymamy potwierdzenia, LISPAT uzna komunikat za niewysłany.
  * W polu Timeout połączenia podajemy czas (w sekundach), jaki nasza bramka będzie oczekiwała na nawiązanie połączenia przy próbie wysyłki komunikatu
  * Kontrolka Autostart wymusza na bramce HL7, automatyczne uruchomienie nasłuchu od danej jednostki kierującej po uruchomieniu aplikacji LISPAT TCP

{{::hl7-konfiguracja-03.png|}}

=== Wiadomość > Nagłówek ===

W tej sekcji podajemy nazwy aplikacji oraz jednostki po obu stronach połączenia. System LISPAT ignoruje te ustawienia, jednak bramki HL7 niektórych dostawców wymagają podania tych informacji, więc należy je uzgodnić ze stroną przeciwną.

{{::hl7-konfiguracja-04.png|}}

=== Wiadomość > Zlecenie ===

  * W polu Lekarz zlecający należy wybrać pole komunikatu, w którym będą wysyłane dane lekarza kierującego. Należy to uzgodnić ze stroną przeciwną lub odczytać z komunikatu testowego jednostki zlecającej.
  * Zaznaczenie kontrolki Zarejestruj nowego lekarza spowoduje, że jeżeli w komunikacie HL7 pojawią się dane lekarza, który nie został jeszcze zarejestrowany w systemie LISPAT, zostanie on dodany do bazy danych. Uwaga! To pole należy włączyć TYLKO, jeżeli mamy pewność, że w otrzymywanych komunikatach będziemy otrzymywali tylko pewne dane i nie spowoduje to zaśmiecenia naszej bazy danych
  * W polu Oddział zlecający należy wybrać pole komunikatu, w którym będą wysyłane dane oddziału kierującego. Należy to uzgodnić ze stroną przeciwną lub odczytać z komunikatu testowego jednostki zlecającej.
  * Zaznaczenie kontrolki Zarejestruj nowe oddziały spowoduje, że jeżeli w komunikacie HL7 pojawią się dane oddziału, który nie został jeszcze zarejestrowany w systemie LISPAT, zostanie on dodany do bazy danych. Uwaga! 
  * W polu Identyfikator zdarzenia medycznego należy wybrać pole, w którym strona zlecająca prześle do nas identyfikator zdarzenia medycznego zarejestrowanego w systemie P1.
  * W polu Numer próbki należy wybrać pole, w którym będziemy otrzymywali oznaczenie próbki biologicznej przesyłanej do badania (numeru, którym dana próbka będzie oznakowana). 
  * W polu Utrwalacz należy wybrać pole, w którym będziemy otrzymywać tą informację.
  * W polu data / godzina utrwalania należy wybrać pole, w którym będziemy otrzymywać tą informację

{{::hl7-konfiguracja-05.png|}}

=== Parametry ===

Ponieważ oznaczenia zlecanych badań jednostki zlecającej są zazwyczaj inne niż oznaczenia stosowane w systemie LISPAT, należy zdefiniować Mapowanie procedur.

W polu FieldValue sekcji procedureMapping należy podać specjalnie skonstruowany ciąg, np.

<code>G,2,Cytologia ginekologiczna;H,1,Histopatologia;C,5,Cytologia</code>

Konstrukcja ciągu danych jest następująca:

<code><procedura> <średnik> <procedura> <średnik> <procedura></code>

//Ilość mapowanych procedur jest dowolna a po ostatniej procedurze nie ma średnika//

Procedura jest zbudowana z trzech elementów rozdzielonych przecinkami:

<code><oznaczenie procedury u zleceniodawcy> <przecinek> <identyfikator procedury w LISPAT> <przecinek> <nazwa procedury></code>

  * Oznaczenie procedury u zleceniodawcy to np. BDPAT (badanie patologiczne), BAC, HIST itd.
  * Identyfikatory LISPAT są następujące: 
      * Histopatologia - 1
      * Cytologia ginekologiczne - 2
      * Cytologia płynów - 5
  * Nazwa procedury nie ma dużego znaczenia i jest podawana tylko dla zachowania czytelności

{{::hl7-konfiguracja-01.png|}}

=== Wiadomość > Potwierdzenia ===

W tej sekcji definiujemy, czy LISPAT będzie wysyłał do zleceniodawcy potwierdzenia aplikacyjne oraz czy będzie wysyłał (jako osobną wiadomość HL7) informację o rozpoczęciu realizacji zlecenia (LISPAT uznaje że rozpoczęto realizację zlecenia w momencie, gdy podana zostanie informacja o dacie otrzymania materiału)

{{::hl7-konfiguracja-06.png|}}

=== Wiadomość > Wynik ===

W tej sekcji podajemy informację, o wysyłanych identyfikatorach w komunikacie wyniku. Konieczność wysyłania tych informacji należy uzgodnić ze zleceniodawcą, jednak najczęściej należy zaznaczyć wszystkie trzy pola.

{{::hl7-konfiguracja-07.png|}}

=== Wiadomość > Treść wyniku ===

W tej sekcji definiujemy, jakie informacje będą wysyłane w komunikacie wyniku (poza samą treścią wyniku). Istnieje możliwość włączenia:

  * Opisu makroskopowego
  * Stopnia zaawansowania
  * ICD-10
  * ICD-O
  * Flaga krytyczności rozpoznania
  * Wnioski i zalecenia

Istnieje też możliwość zdefiniowania, w jaki sposób strona zlecająca będzie otrzymywała wynik badania w postaci podpisanego elektronicznie pliku PDF lub pliku XML z komunikatem PIK HL7 CDA. Dla każdego z obu tych typów plików istnieje możliwość wyboru:

  * Nie wysyłaj
  * Link systemowy w sekcji NTE
  * Link systemowy w sekcji OBX
  * Link dla użytkownika w sekcji NTE
  * Link dla użytkownika w sekcji OBX
  * Base64 w sekcji OBX

Linki systemowe pozwalają na integrację na poziomie systemów (system zleceniodawcy będzie automatycznie pobierał pliki).

Linki dla użytkownika odsyłają użytkownika do modułu WEB systemu LISPAT pozwalając użytkownikowi (po zalogowaniu) na ręczne pobranie dokumentu.

Base64 w sekcji OBX załącza dokument bezpośrednio do wiadomości HL7. W ten sposób wiadomość jest bardzo duża, ale zawiera komplet informacji. System informatyczny zlecającego musi posiadać mechanizmy ekstrakcji takich dokumentów.

{{::hl7-konfiguracja-08.png|}}