Integracja to miejsce, w którym placówka szpitalna rejestruje kanały wymiany danych ze szpitalnym systemem informatycznym (HIS) i z zewnętrznym logowaniem (SSO), a potem patrzy, co przez te kanały przeszło. Ekran opisuje sam siebie jednym zdaniem: „Zarządzaj konektorami HIS/SSO i magistralą komunikatów."
Jak to zrobić
Dodaj konektor
Kliknij Dodaj konektor. Panel prosi o trzy rzeczy:
- Typ konektora — HL7 v2 (HIS), FHIR (HIS), SSO — SAML albo SSO — OIDC.
- Nazwa — dowolna, opisowa; w gabinecie musi być niepowtarzalna.
- Konfiguracja (JSON) — adresy i klucze dostawcy.
Zatwierdzasz przyciskiem Zapisz konektor, Heltio kwituje Konektor zapisano.
Poprawiaj przez zastąpienie, nie przez edycję
Edytuj pozwala zmienić nazwę, a konfigurację wyłącznie nadpisać: zaznaczasz Zastąp konfigurację i wpisujesz całość od nowa. Ostrzeżenie obok nie jest ozdobą — „Istniejąca konfiguracja zostanie trwale nadpisana."
Wyłącz zamiast usuwać
Wyłącz zatrzymuje kierowanie komunikatów przez konektor i da się cofnąć: „Komunikaty przestaną być kierowane przez ten konektor. Możesz go ponownie włączyć w dowolnym momencie." Kolumna Status pokazuje wtedy Wyłączony zamiast Aktywny.
Usuń jest nieodwracalne i zabiera ze sobą powiązania: „Wszystkie komunikaty powiązane z tym konektorem zostaną odpięte. Tej operacji nie można cofnąć." Do wyciszenia kanału na kilka dni używaj wyłączenia.
Sprawdź stan magistrali
Przycisk Stan w nagłówku otwiera Stan integracji. Cztery kafelki na górze: W kolejce, Błędy, Ostatnio przetworzono (albo Nigdy) i Konektory.
Niżej lista Komunikaty z kolumnami Odebrano, Kierunek (Wejście / Wyjście), Typ, Status, Próby i Ostatni błąd. Filtruj po statusie zawęża listę do W kolejce, Przetworzono, Błąd albo Pominięto; Wszystkie przywraca pełną historię.
Ten ekran czyta się od góry. 2 to cztery liczby mówiące, czy magistrala w ogóle pracuje — rosnąca kolejka przy zerowym Ostatnio przetworzono znaczy, że nic jej nie odbiera. 3 to Filtruj po statusie. 4 to kolumna Status — miejsce, w którym szukasz wpisów Błąd przed sięgnięciem po Ponów.
Ponów albo pomiń komunikat
Komunikat, który padł, Heltio ponawia sam — do sześciu prób, z coraz dłuższą przerwą między nimi. Po wyczerpaniu prób zostaje na liście ze statusem Błąd; nic nie ginie po cichu.
Ponów wstawia go do kolejki od razu (Komunikat ponownie w kolejce). Oznacz jako pominięty zamyka sprawę na stałe: „Komunikat zostanie trwale oznaczony jako IGNORED i usunięty z kolejki ponowień." Używaj tego dla komunikatów, które przestały być aktualne — nie dla tych, które trzeba naprawić.
Udowodnij, że magistrala żyje
Wyślij test echo wpuszcza na magistralę komunikat wewnętrzny, który nie wymaga żadnego zewnętrznego systemu. Heltio potwierdza Echo dodane do kolejki — obserwuj listę komunikatów. Jeśli echo zostaje w stanie W kolejce i nie przechodzi w Przetworzono, przetwarzanie komunikatów nie jest w tej instalacji uruchomione — napisz do wsparcia Heltio, zanim zaczniesz szukać winy w konfiguracji dostawcy.
Kiedy coś nie działa
Konektor o tej nazwie już istnieje.
Co to znaczy: Nazwy konektorów muszą być niepowtarzalne w obrębie gabinetu.
Nieprawidłowy JSON
Co to znaczy: Treść pola Konfiguracja (JSON) nie jest poprawnym dokumentem JSON — najczęściej brakuje cudzysłowu albo jest przecinek po ostatnim polu.
Błąd zapisu konektora
Co to znaczy: Zapis nie doszedł do serwera albo szyfrowanie konfiguracji się nie udało.
Nie udało się załadować konektorów.
Co to znaczy: Lista nie odpowiedziała. Ten sam objaw po stronie ekranu stanu brzmi **Nie udało się załadować stanu integracji.**
Błąd ponowienia
Co to znaczy: Komunikat nie wrócił do kolejki — zwykle dlatego, że w tym czasie zmienił stan (na przykład ktoś oznaczył go jako pominięty).
Brak komunikatów o tym statusie. Wybierz 'Wszystkie', aby zobaczyć pełną historię.
Co to znaczy: Filtr jest ustawiony na status, którego żaden komunikat dziś nie ma.
Kto ma dostęp
Admin gabinetuCały ten ekran — także sam odczyt listy i stanu — jest zarezerwowany dla właściciela i administratora gabinetu. Koordynator jest tu wykluczony celowo, choć w placówce szpitalnej zarządza strukturą i zespołami: konfiguracja techniczna z kluczami dostawcy to inna sprawa niż prowadzenie oddziału.
Dodanie, zmiana, włączenie, wyłączenie i usunięcie konektora oraz każde ponowienie i pominięcie komunikatu zostawiają wpis w dzienniku audytu.
Powiązane
- Role i uprawnienia — dlaczego Koordynator tu nie wchodzi.
- Dziennik audytu — gdzie widać, kto zmienił konektor.
- P1 — przegląd — druga, niezależna droga wymiany danych medycznych.
Powiązane funkcje
Role i uprawnienia
Trzynaście ról: cztery w zwykłym gabinecie, osiem dodatkowych w placówce szpitalnej i jedna po stronie pacjenta. Co każda widzi, co może zmienić i dlaczego roli nie da się nadpisać pojedynczym uprawnieniem.
Dziennik audytu
Zapis tego, kto i kiedy sięgnął po dane pacjentów albo je zmienił. Filtry, eksport do CSV lub JSON, punkt wyjścia dla kontroli RODO i wyjaśnień wewnętrznych.
Integracja z P1 — przegląd
Kogo dotyczy obowiązek raportowania do systemu e-Zdrowia, jak przebiega konfiguracja w Heltio i gdzie sprawdzisz, czy wizyty faktycznie docierają do Centrum e-Zdrowia.