====== Integracja z barwiarkami ======

System LISPAT wspiera integrację z automatycznymi barwiarkami w taki sposób, że:

  - Wysyła do barwiarki zlecenia barwienia
  - Odbiera od barwiarki informację o wykonanym barwieniu

System LISPAT wysyła zlecenia barwienia natychmiast po jego zleceniu na liście materiałów, o ile mechanizm integracji jest uruchomiony.

System LISPAT wspiera komunikację z barwiarkami przy użyciu protokołu HL7 oraz połączenia TCP.

Integracja z barwiarkami wymaga następujących kroków:

  - Definicja połączenia HL7
  - Definicja barwiarki
  - Mapowanie zlecanych barwień do protokołów barwiących w urządzeniu
  - Zlecanie barwień
  - Przesyłanie informacji pomiędzy LISPAT a urządzeniem

==== Definicja HL7 ====

Definicję połączenia HL7 dokonuje się w menu Administracja > Konfiguracja > Komunikacja > Integracje. Administrator powinien wprowadzić stosowne informacje na zakładce HL7 device:

Uwaga! Ze względu na wygodę użytkowania i kontrolę nad integracją, po stronie LISPAT bramką HL7 do komunikacji z barwiarką powinien być komputer (stacja robocza) użytkownika kontrolującego barwiarkę. Ma to znaczenie podczas definiowania połączenia HL7 oraz adresu IP po stronie LISPAT.

  * Pod-zakładka: Connection - Podać IP bramki HL7 po stronie urządzenia oraz docelowy port jak również lokalny port TCP na którym będzie nasłuchiwała bramka HL7 systemu LISPAT. Domyślnie timeout wynosi 5 sekund. Pole Autostart pozostawić wyłączone
  * Pod-zakładka: Msg Header - Wprowadzić ustalone z osobą odpowiedzialną za integrację po stronie urządzenia nazwy aplikacji i miejsca oraz ustaloną wersję komunikatów.
  * Pod-zakładka: Schema - Wprowadzić Order message type - typ wiadomości, który będzie wysyłany do urządzenia.

Informacje na pozostałych zakładkach nie są wymagane i będą ignorowane przez LISPAT.

==== Definicja Barwiarki ====

Barwiarkę definiuje się w menu Administracja > Zarządzaj wyposażeniem. Z punktu widzenia integracji istotne jest uzupełnienie następujących pól:

  * Kod urządzenia i nazwa urządzenia
  * Na zakładce "Połączenie"
      * Sposób pracy: Query
      * Integracja: <wybrać nazwę integracji zdefiniowanej w poprzednim kroku>
      * Stacja robocza: <podać nazwę BETBIOS stacji roboczej, która będzie pełniła rolę bramki HL7>
      * Aktywny: Tak

Wypełnienie pola "Dostępne kody zleceń" ułatwia mapowanie barwień, ale nie jest niezbędne do działania. 

//Wyjaśnienie: Barwiarki oferują dużą różnorodność protokołów barwiących. Administrator / użytkownik musi (w kolejnym kroku) zmapować nazwy barwień stosowane w systemie LISPAT z nazwami stosowanymi w barwiarce. Mapowanie musi być precyzyjne, ponieważ zmiana jednej litery w nazwie protokołu barwiącego może spowodować, że zlecenie nie zostanie rozpoznanie przez barwiarkę. Aby ułatwić ten proces, administrator może przygotować listę dostępnych protokołów tak, aby możliwe było ich wybranie z listy podczas mapowania. Taka wstępnia przygotowana lista barwień przyjmuje formę kodu JSON wklejanego w polu "Dostępne kody zleceń". Przygotowany kod JSON musi mieć określoną strukturę aby działał prawidłowo. 

Przykładowy zestaw dostępnych barwień pokazany jest poniżej//

<code>
[
  {
    "code": "A1F",
    "name": "Alpha-1-Fetoprotein"
  },
  {
    "code": "CEA",
    "name": "CEA mono"
  },
  {
    "code": "EMA",
    "name": "Epithelial Membrane Antigen"
  }
]
</code>

==== Użytkowanie barwiarki w połączeniu z LISTAP ====

Procedury wykonawcze zostały opisane w artykule: [[praca_z_barwiarkami|Praca z barwiarkami - Instrukcja dla operatora]]