Inera Core Implementation Guide
0.2.0 - ci-build Sweden

Inera Core Implementation Guide - Local Development build (v0.2.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Concept Maps

Concept Maps

This page lists the ConceptMaps defined in this Implementation Guide for mapping between TKB services and FHIR resources.

ConceptMaps provide mappings between TKB domain information models and FHIR resource structures, demonstrating how Swedish national healthcare data from legacy TKB services can be represented using modern FHIR standards.

  • ConceptMap GetAccessLogsForPatient TKB to FHIR AuditEvent

    Mapping from GetAccessLogsForPatient TKB to FHIR AuditEvent. 4-group pattern: query params, AuditEvent, Provenance, unmapped. 32+ elements covering PDL access logs, who accessed what when.

  • ConceptMap GetActivities TKB to FHIR Procedure

    Complete mapping from GetActivities TKB service to FHIR Procedure resource

  • ConceptMap GetAlertInformation TKB to FHIR AllergyIntolerance/Flag

    Complete mapping from GetAlertInformation TKB service to FHIR AllergyIntolerance and Flag resources

  • ConceptMap GetBlocks TKB to FHIR Schedule

    Mapping from GetBlocks TKB to FHIR Schedule/Slot. 4-group pattern: query params, Schedule, Provenance, unmapped. 28+ elements covering appointment scheduling blocks, availability.

  • ConceptMap GetCareContacts TKB to FHIR Encounter

    Complete mapping from GetCareContacts TKB logical model to FHIR Encounter and Provenance resources

  • ConceptMap GetCareDocumentation TKB to FHIR DocumentReference/Composition

    Complete mapping from GetCareDocumentation TKB service to FHIR DocumentReference, Composition, and Provenance resources

  • ConceptMap GetCarePlan TKB to FHIR CarePlan

    Mapping from GetCarePlan TKB to FHIR CarePlan. 4-group pattern: query params, CarePlan, Provenance, unmapped. 42+ elements covering care plan activities, goals, participants.

  • ConceptMap GetDiagnosis TKB to FHIR Condition

    Complete mapping from GetDiagnosis TKB service to FHIR Condition and Provenance resources

  • ConceptMap GetFunctionalStatus TKB to FHIR Observation

    Mapping from GetFunctionalStatus TKB to FHIR Observation. 4-group pattern: query params, Observation, Provenance, unmapped. 30+ elements covering functional assessments, ADL, mobility.

  • ConceptMap GetImagingOutcome TKB to FHIR ImagingStudy

    Mapping from GetImagingOutcome TKB to FHIR ImagingStudy/DiagnosticReport. 4-group pattern: query params, ImagingStudy, Provenance, unmapped. 35+ elements covering radiology reports, DICOM series, modalities.

  • ConceptMap GetLaboratoryOrderOutcome TKB to FHIR DiagnosticReport

    Mapping from GetLaboratoryOrderOutcome TKB service to FHIR resources. Based on Excel-generated logical model with enhanced field descriptions.

    TKB Service: GetLaboratoryOrderOutcome v3.0 TKB Domain: clinicalprocess:healthcond:actoutcome v3.0 Logical Model: GetlaboratoryorderoutcomeResponseLM (from FSH-konvertering.xlsx) FHIR Resources: DiagnosticReport, Observation, Specimen Pattern: 4-group (query params, DiagnosticReport, Provenance, unmapped) Coverage: 40+ elements covering lab results, specimen, reference ranges

  • ConceptMap GetMaternityMedicalHistory TKB to FHIR Observation

    Mapping from GetMaternityMedicalHistory TKB to FHIR Observation/Condition/Procedure. 4-group pattern: query params, Observation, Provenance, unmapped. 45+ elements covering pregnancy, delivery, prenatal care.

  • ConceptMap GetMedicationHistory TKB to FHIR MedicationStatement

    Mapping from GetMedicationHistory TKB service to FHIR resources. Based on Excel-generated logical model with enhanced field descriptions.

    TKB Service: GetMedicationHistory v2.0
    TKB Domain: clinicalprocess:activityprescription:actoutcome v2.0 Logical Model: GetMedicationHistoryLM (from FSH-konvertering.xlsx) FHIR Resources: MedicationStatement, MedicationRequest, Medication

    Mapping Coverage: 50+ elements across medication data, prescriptions, dosage Pattern: 4-group approach (query params, MedicationStatement, Provenance, unmapped) Note: Dosage mappings are comprehensive but complex; prioritize prescription and medication product

  • ConceptMap GetObservations TKB to FHIR Observation

    Complete mapping from GetObservations TKB service to FHIR Observation and Provenance resources

  • ConceptMap GetPersonsForProfile TKB to FHIR Person

    Mapping from GetPersonsForProfile TKB to FHIR Person/RelatedPerson. 4-group pattern: query params, Person, Provenance, unmapped. 25+ elements covering person demographics, relationships.

  • ConceptMap GetReferralOutcome TKB to FHIR ServiceRequest

    Mapping from GetReferralOutcome TKB to FHIR ServiceRequest. 4-group pattern: query params, ServiceRequest, Provenance, unmapped. 38+ elements covering referrals, priority, reason, requester.

  • DocBook to FHIR Narrative XHTML Mapping

    Mapping between DocBook elements supported by 1177 Inkorg and FHIR Narrative.div XHTML.

    DocBook is the required format for 1177 Inkorg messages (AddMessage.Message.Text), but FHIR uses Narrative.div with a restricted XHTML subset (FHIR Narrative data type).

    Source: DocBook subset supported by 1177 Inkorg
    Target: FHIR Narrative XHTML (limited XHTML 1.0 Strict subset)

    FHIR Narrative Constraints:

    • Only specific XHTML tags allowed: div, span, p, h1-h6, a, ul, ol, li, dl, dt, dd, b, i, u, em, strong, table, etc.
    • All content must be in a single <div xmlns='http://www.w3.org/1999/xhtml'> root
    • No DocBook-specific elements (article, section, emphasis[@role]) in output
    • Custom styling via @class or @style attributes where needed

    Reference:

    • https://inera.atlassian.net/wiki/spaces/OIIK/pages/3590029598/Docbook-formatering+av+meddelande
    • https://inera.atlassian.net/wiki/spaces/OIIK/pages/3590619160/DocBook+exempel
    • http://hl7.org/fhir/R4/narrative.html#Narrative
  • Mapping Approach

    Each ConceptMap follows a consistent pattern:

    • Source: TKB domain logical model (representing the legacy service contract structure)
    • Target: FHIR resource (representing the modern standardized structure)
    • Mapping Elements: Detailed field-by-field mappings showing equivalence between TKB and FHIR

    For detailed guidance on the mapping strategy, see the Mapping Strategy page.