Specyfikacja interoperacyjności prototypu SSIDL, published by Uniwersytet Medyczny w Łodzi. This guide is not an authorized publication; it is the continuous build for version 0.1.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/SSIDL/ssidl-ig/ and changes regularly. See the Directory of published versions

Przypadki użycia usługi terminologicznej

T-01: Pobierz listę dostępnych pakietów terminologicznych i specyfikacyjnych

Serwer terminologii umożliwia pobranie (za pomocą interfejsu programistycznego zgodnego ze standardem FHIR) listy dostępnych pakietów terminologicznych i specyfikacyjnych. Przypadek użycia jest dostępny dla wszystkich uprawnionych systemów zewnętrznych i wewnętrznych.

Usługa jest realizowana za pomocą operacji $get-available-packages, zdefiniowanej zgodnie z zasadami standardu HL7 FHIR. W wywołaniu usługi nie jest przekazywany żaden parametr. Usługa zwraca zasób FHIR typu Parameters zawierający nazwy dostępnych pakietów.

T-02: Pobierz pakiet terminologiczny lub specyfikacyjny

Serwer terminologii, za pomocą interfejsu programistycznego zgodnego ze standardem FHIR, umożliwia pobranie pakietu terminologicznego lub specyfikacyjnego. Pobrany pakiet może zostać wykorzystany do implementacji słownika lub specyfikacji w systemach zewnętrznych. Przypadek użycia jest dostępny dla wszystkich uprawnionych systemów zewnętrznych i wewnętrznych.

Usługa jest realizowana za pomocą operacji $get-package, zdefiniowanej zgodnie z zasadami standardu HL7 FHIR. W wywołaniu usługi przekazywana jest nazwa pakietu. Usługa zwraca zasób FHIR typu Binary zawierający pakiet o podanej nazwie.

T-03: Sprawdź występowanie kodu w słowniku

Serwer terminologii, za pomocą interfejsu programistycznego zgodnego ze standardem FHIR, umożliwia weryfikację występowania kodu w słowniku terminologicznym. Przypadek użycia obejmuje słownik LOINC oraz słowniki opracowane w toku projektu. Przypadek użycia jest dostępny dla wszystkich uprawnionych systemów zewnętrznych i wewnętrznych.

Usługa jest realizowana za pomocą standardowej operacji serwera FHIR [base]/CodeSystem/$validate-code. W wywołaniu przekazywane są co najmniej: kod pozycji oraz identyfikator słownika (kanoniczny URL). Usługa zwraca wynik operacji w postaci zasobu FHIR typu Paramaters.

T-04: Sprawdź występowanie kodu w zbiorze wartości

Serwer terminologii, za pomocą interfejsu programistycznego zgodnego ze standardem FHIR, umożliwia weryfikację występowania kodu w zbiorze wartości. Przypadek użycia obejmuje zbiory wartości opracowane w toku projektu. Przypadek użycia jest dostępny dla wszystkich uprawnionych systemów zewnętrznych i wewnętrznych.

Usługa jest realizowana za pomocą standardowej operacji serwera FHIR [base]/ValueSet/$validate-code. W wywołaniu przekazywane są co najmniej: kod pozycji oraz identyfikator zbioru wartości (kanoniczny URL). Usługa zwraca wynik operacji w postaci zasobu FHIR typu Paramaters.

T-05: Wyszukaj zmapowaną pozycję innego słownika

Serwer terminologii, za pomocą interfejsu programistycznego zgodnego ze standardem FHIR, umożliwia wyszukanie pozycji innego słownika, która została zmapowana na pozycję słownika źródłowego. Przypadek użycia obejmuje mapowanie pozycji słownika LOINC na pozycje słownika ICD-9-PL, które zostało wygenerowane przez prototyp SSIDL na podstawie kodów zawartych w opracowanych w projekcie definicjach usług laboratoryjnych. Przypadek użycia jest dostępny dla wszystkich uprawnionych systemów zewnętrznych i wewnętrznych.

Usługa jest realizowana za pomocą standardowej operacji serwera FHIR [base]/ConceptMap/$translate. W wywołaniu przekazywane są co najmniej: kod pozycji i identyfikator źródłowego słownika (kanoniczny URL) oraz identyfikator słownika docelowego (kanoniczny URL). Usługa zwraca wynik operacji w postaci zasobu FHIR typu Parameters oraz parametry pozycji słownika docelowego z określeniem typu relacji mapowania i parametrów mapowania.

T-06: Wyszukaj pozycje słownika

Serwer terminologii, za pomocą interfejsu programistycznego zgodnego ze standardem FHIR, umożliwia wyszukanie pozycji słownika na podstawie fragmentu nazwy tej pozycji. Przypadek użycia jest dostępny dla wszystkich uprawnionych systemów zewnętrznych i wewnętrznych.

Usługa jest realizowana za pomocą operacji $search-code, zdefiniowanej zgodnie z zasadami standardu HL7 FHIR. W wywołaniu przekazywany jest fragment nazwy pozycji słownika oraz opcjonalnie identyfikator słownika (kanoniczny URL). Usługa zwraca zasób FHIR typu Parameters zawierający parametry pozycji słownika(ów) spełniających kryteria wyszukiwania.

T-07: Pobierz zbiór wartości

Serwer terminologii, za pomocą interfejsu programistycznego zgodnego ze standardem FHIR, umożliwia pobranie definicji zbioru wartości oraz (opcjonalnie) listę pozycji słownika (lub słowników), które są reprezentowane w tym zbiorze wartości. Przypadek użycia jest dostępny dla wszystkich uprawnionych systemów zewnętrznych i wewnętrznych.

Usługa jest realizowana za pomocą dwóch operacji:

• standardowego mechanizmu pobierania zasobów FHIR. W wywołaniu usługi przekazywany jest typ i identyfikator instancji zasobu FHIR. Usługa zwraca zasób FHIR reprezentujący zbiór wartości

• standardowej operacji FHIR [base]/ValueSet/$expand W wywołaniu przekazywany jest identyfikator zbioru wartości (kanoniczny URL). Usługa zwraca nazwę słownika zasób FHIR typu ValueSet zawierający listę pozycji słownika/słowników zawartych we wskazanym zbiorze wartości.

T-08: Pobierz pozycję słownika

Serwer terminologii, za pomocą interfejsu programistycznego zgodnego ze standardem FHIR, umożliwia pobranie określonej pozycji słownika wraz z jej parametrami. Przypadek użycia jest dostępny dla wszystkich uprawnionych systemów zewnętrznych i wewnętrznych.

Usługa jest realizowana za pomocą standardowej operacji FHIR [base]/CodeSystem/$lookup. W wywołaniu przekazywany jest co najmniej: kod pozycji oraz identyfikator słownika. Usługa zwraca zasób FHIR typu Parameters zawierający nazwę słownika, wersję słownika oraz nazwę pozycji słownika.