Katalogtjänster för federativ samverkan (T2) - Lokal utvecklingsbygge (v0.2.0) byggt av FHIR (HL7® FHIR® Standard) Build Tools. Se katalogen över publicerade versioner

Hem

Official URL: https://fhir.inera.se/ig/katalogtjanster/ImplementationGuide/inera.katalogtjanster				Version: 0.2.0
Draft as of 2026-08-25				Computable Name: Katalogtjanster

Denna implementationsguide beskriver två av stödtjänsterna i målarkitekturen för samverkan enligt T2 inom svensk välfärd:

• Federationsmedlemskatalogen — information om aktörers deltagande i en informationsfederation, som grund för tillit och åtkomstbeslut.
• Tjänstekatalogen — stöd för en klient att hitta den tekniska anropsadressen till en API-producent, givet en interoperabilitetsspecifikation och en logisk adress.

Katalogerna realiseras som FHIR R5-baserade kataloger. Informationsmodellen återanvänder FHIR-resurser och bygger på katalogmönstren i IHE Mobile Care Services Discovery (mCSD) — särskilt Organization, OrganizationAffiliation och Endpoint för aktörer, medlemskap och anslutningspunkter. Tekniska tjänstebeskrivningar bärs av CapabilityStatement: kind=requirements beskriver en interoperabilitetsspecifikation och kind=instance en registrerad, driftsatt tjänsteinstans — en T2-specifik katalogsemantik som kompletterar resursens gängse roll (en enskild servers egen capability-deklaration). Relationen mellan instans och specifikation är formell: tjänsteinstansens instantiates pekar på specifikationens kanoniska URL, och anslutningspunktens extension implements bär samma referens som sökningens nyckel.

Konformans: denna guide är mCSD-inspirerad, inte mCSD-konformant. mCSD är publicerad för FHIR R4; denna guide använder FHIR R5 och gör inga konformansanspråk mot mCSD. Återanvända mönster, avvikelser och T2-specifika tillägg dokumenteras i respektive artefakt och i Om.

Status

Detta är version 0.2.0 (ci-build) — kravbilderna för båda katalog-API:erna (Federationsmedlemskatalogens API, Tjänstekatalogens API) inklusive registrering (transaction med obligatorisk Provenance) och syndikering (SubscriptionTopic), sökparametern implements, formella profiler med terminologi, samt ett komplett exempelscenario som utgör referensrealiseringens testdata och valideras mot profilerna. Mot v1.0 återstår linjering mot HL7 Sveriges basprofiler för R5 — se Versionshistorik.

Preliminärt: paket-id och kanonisk URL är ännu inte förankrade i Ineras styrning och kan komma att ändras.

Läsanvisning

• Funktionellt: informationsmodellen, användningsfallen (federationssökning, tjänstesökning m.fl.), roller och mappningen mellan T2-begrepp och FHIR-resurser.
• Implementering: REST-interaktioner med exempelanrop, förväntade svar, säkerhetsmodellen och hur specifikationen testas.
• Artefakter: samtliga FHIR-artefakter (CapabilityStatements, extensions, kodverk, exempel).