Integracja z barwiarkami

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

1. Wysyła do barwiarki zlecenia barwienia
2. 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:

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

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.

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": "A1F",
    "name": "Alpha-1-Fetoprotein"
  },
  {
    "code": "CEA",
    "name": "CEA mono"
  },
  {
    "code": "EMA",
    "name": "Epithelial Membrane Antigen"
  }
]

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