Dokumentacja dla integracji upmedic z INFINITT G7 modułem opisowym

Wybór sposobu wdrożenia

W zależności od wymagań lekarzy i podmiotu, wdrożenie upmedic ma różne ścieżki.

Kluczowa decyzja: czy placówka chce korzystać z modułu dla transkrypcjonistów?

JEŻELI NIE - realizujesz wszystkie kroki z Checklista wdrożeniowa dla integracji upmedic z modułem opisowym IFINITT G7 Kambu

JEŻELI TAK - realizujesz wszystkie kroki z Checklista wdrożeniowa dla integracji upmedic z modułem opisowym IFINITT G7 z modułem dla transkrypcjonistów wtyczką

Jeżeli ta decyzja zmieniła się w trakcie projektu, koniecznie zgłoś ten fakt do upmedic. 

 Checklista wdrożeniowa dla integracji upmedic z modułem opisowym IFINITT G7 Kambu

1. uzyskaj credentiale clinic_id, clinic_secret  (zwróć  uwagę, że to nie clinic_token) od zespołu upmedic - pamiętaj o bezpiecznym przekazywaniu w zespole secretów, wyłącznie poprzez przekazany od upmedic link do 1password

2. sprawdź, czy w koncie w INFINITT lekarz ma uzupełnione: imię, nazwisko, email (gdy nie udostębpnia, to możye być placeholder typu imie.nazwisko@nazwa-podmiotu.pl), telefon (gdy nie udostęmpnia, może być placeholder typu +48000000000).
   Pamiętaj, że emaile w upmedic są globalnie unikatowe, wobec tego Twoje konto wdrożeniowe dla tej instancji INFINITT też musi mieć unikalnego maila, sugerujemy konwencję:  imię.nazwisko@nazwa-podmiotu.grupaq.pl

3. Sprawdź, czy lekarze zaangażowani w projekt, będą mieli mikrofony, jeśli chcą używać mowy podczas korzystania z upmedic. 

4. Jeżeli przeglądarka www blokuje dostęp do mikrofonu, to wynika prawdopodobnie z braku HTTPS używanego do łączenia się z adresem instancja-infinitt.local Trzeba dodać ten adres do wyjątków wg instrukcji https://it.upmedic.io/#h.n6r3ayu1uuge 

5. Na stanowiskach lekarzy zalecana jest instalacja sound agenta wg instrukcji (może być konieczny udział  administratora IT placówki) https://it.upmedic.io/wtyczka 

6. Na adres: templates@upmedic.io prześlij informację o zgłoszeniu lekarza, każdy lekarz w osobnym wątku mailowym. W wiadomości: 

   • imię, nazwisko lekarza, przynajmniej jedna forma skutecznego kontaktu: tel (preferowany), email (jeśli używa)

   • plik z szablonami w formacie docx, txt lub excel 

   • inne informacje dla kontekstu dotyczącego lekarza. 

7. Materiały dla lekarzy dostępne są pod adresami: dla radiologów radiologia.upmedic.io dla klinicystów: edu.upmedic.io 

8. Inne informacje wdrożeniowe, szczególnie dla zespołów IT placówek: it.upmedic.io  

9. Support: support.upmedic.io

10. Compliance: compliance.upmedic.io 

Checklista wdrożeniowa dla integracji upmedic z modułem opisowym IFINITT G7 z modułem dla transkrypcjonistów wtyczką (od wersji wtyczki 2.14.0)

1. uzyskaj clinic_token  (zwróć  uwagę, że to nie clinic_secret ani clinic_id) od zespołu upmedic - pamiętaj o bezpiecznym przekazywaniu w zespole secretów, wyłącznie poprzez przekazany od upmedic link do 1password

2. sprawdź, czy skonfigurowany INFINITT przekazuje do modułu opisowego: userlogin oraz exam_id jako parametry URL (tzw. query params), np: http://instancja-infinitt.local/modul-opisowy/?jakis-param=1111111&userlogin=21&exam_id=37

3. Sprawdź, czy lekarze zaangażowani w projekt, będą mieli mikrofony, jeśli chcą używać mowy podczas korzystania z upmedic. 

4. Jeżeli przeglądarka www blokuje dostęp do mikrofonu, to wynika prawdopodobnie z braku HTTPS używanego do łączenia się z adresem instancja-infinitt.local Trzeba dodać ten adres do wyjątków wg instrukcji https://it.upmedic.io/#h.n6r3ayu1uuge 

5. Na stanowiskach lekarzy konieczna jest instalacja wtyczki oraz zalecana jest instalacja sound agenta wg instrukcji: https://it.upmedic.io/#h.wai86cw2m8a4 

6. Konfiguracja wtyczki:

   1. Należy wprowadzić clinic_token z pkt. 1

   2. Należy ustawić przełącznik Infinitt-support na true

   3. Należy wprowadzić selektory wspieranych pól

      1. Główne pole opisowe

         1. Target (pierwsze pole do wpisania): #app > div.main-wrapper > div > div.d-flex.jusitfy-content-between.expandable.description-text-box > div.text-area-wrapper > div.editor

         2. Output (drugie pole do wpisania w tej samej linii): #app > div.main-wrapper > div > div.d-flex.jusitfy-content-between.expandable.description-text-box > div.text-area-wrapper > div.editor > div > div.editor__content > div

   4. Należy się upewnić, że clinic_token oraz selektory wpisywane są bez spacji

7. Na adres: templates@upmedic.io prześlij informację o zgłoszeniu lekarzy i transkrypcjonistów najlepiej każda osoba w osobnym wątku mailowym lub w tabeli np. excel
   W wiadomości: 

   1. typ użytkownika: transkrypcjonista/lekarz,

   2. wartość parametru userlogin z INFINITT dla tego użytkownika

   3. imię, nazwisko, nr telefonu, email

   4. plik z szablonami w formacie docx, txt lub excel 

   5. tylko lekarze: informacja o tym czy lekarz chce korzystać z całego upmedic czy tylko z nagrywania głosu dla transkrypcjonistów. Jeśli w trakcie używania lekarz chce zmienić tryb pracy (np. dyktowanie na bieżąco bez transkrypcjonisty) koniecznie poinformuj o tym upmedic, najlepiej w tym wątku mailowym, to zmienimy konfigurację konta upmedic. Nie można korzystać z dwóch trybów jednocześnie, bo one wzajemnie się wykluczają.

   6. inne informacje dla kontekstu dotyczącego lekarza, transkrypcjonisty, które mogą pomóc w konfigurowaniu szablonów

8. Materiały dla lekarzy dostępne są pod adresami: dla radiologów radiologia.upmedic.io dla klinicystów: edu.upmedic.io 

9. Inne informacje wdrożeniowe, szczególnie dla zespołów IT placówek: it.upmedic.io , szczególnie kwestia zarządzania konfiguracją wtyczki upmedic i jej propagacji w ramach domeny https://it.upmedic.io/wtyczka 

10. Support: support.upmedic.io

11. Compliance: compliance.upmedic.io