Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added FK organisation mapping

...

  1. The customers provide mapping as MS Excel files to the Systematic AO team, which then triggers the relationship being created.
    The customer provides organisation relationship file(s) containing mappings between KOMBIT STS Organization identifiers and SOR identifiers. This input is provided to an operation in the eHealth system by SRE. The operation will then process the file line-by-line and establish the relevant related-to relationships in the FHIR Organization resources.

  2. FUT Infrastructure automatically creates the relationship during import from FK Organisation if the SOR code is available in FK Organisation.
    The Municipalities FK Organisation administrator registers the SOR kode in the FK Organisation system (as address of type SOR ID), and the FUT infrastructure will automatically create the relationship during import.

...

...

Data mapping from FK Organisation objects to FHIR Organization of profile https://docs.ehealth.sundhed.dk/latest-released/ig/StructureDefinition-ehealth-organization.html :

The

...

following table explains how each of the attributes on the FHIR resource is mapped from the FK Organisation data model

ehealth-organization element

FK Organisation Source

Comment

id

Generated by FHIR server

meta.*

Generated by FHIR server

implicitRules

N/A

language

N/A

text

N/A

contained

N/A

extension

N/A

relatedTo

Adresse resources with Rolle 'SOR-ID'

A relation to corresponding FHIR Organisations with the given SOR Id is established.

Adresse resources with Rolle 'SOR-ID' a relationship to the related SOR organization is reflected in the Organization.relatedTo element.

modifierExtension

N/A

identifier[0].use

Always set to official

identifier[0].type

Not used

identifier[0].system

For FK Organisation always https://www.kombit.dk/sts/organisation

...

The OrganisationEnhed identifier is stored as an Organization.identifier with system 'https://www.kombit.dk/sts/organisation'.

...

The CVR Number defined on the Virksomhed is copied to all children in the organizational tree.

...

identifier[0].value

If Organisation
//element(*,tns:ListResponseType)/org:ListOutput/org:FiltreretOejebliksbillede/org:ObjektType/sd:UUIDIdentifikator
If OrganisationEnhed
tns:ListResponse/orgenhed:ListOutput/orgenhed:FiltreretOejebliksbillede/orgenhed:ObjektType/sd:UUIDIdentifikator

identifier[0].period.start

If Organisation
//element(*,tns:ListResponseType)/org:ListOutput/org:FiltreretOejebliksbillede/org:Registrering/org:TilstandListe/orgfaelles:Gyldighed/sd:Virkning/sd:FraTidspunkt
If OrganisationEnhed
tns:ListResponse/orgenhed:ListOutput/orgenhed:FiltreretOejebliksbillede/orgenhed:Registrering/orgenhed:TilstandListe/orgfaelles:Gyldighed/sd:Virkning/sd:FraTidspunkt

identifier[0].period.end

if Organisation
//element(*,tns:ListResponseType)/org:ListOutput/org:FiltreretOejebliksbillede/org:Registrering/org:TilstandListe/orgfaelles:Gyldighed/sd:Virkning/sd:TilTidspunkt
If OrganisationEnhed
tns:ListResponse/orgenhed:ListOutput/orgenhed:FiltreretOejebliksbillede/orgenhed:Registrering/orgenhed:TilstandListe/orgfaelles:Gyldighed/sd:Virkning/sd:TilTidspunkt

identifier[0].assigner

Not used

type

Organisation or OrganisationEnhed 

See https://docs.ehealth.sundhed.dk/latest-released/ig/CodeSystem-ehealth-oio-organization-type.html

active

If Organisation
//element(*,tns:ListResponseType)/org:ListOutput/org:FiltreretOejebliksbillede/org:Registrering/org:TilstandListe/orgfaelles:Gyldighed/orgfaelles:GyldighedStatusKode
If OrganisationEnhed
tns:ListResponse/orgenhed:ListOutput/orgenhed:FiltreretOejebliksbillede/orgenhed:Registrering/orgenhed:TilstandListe/orgfaelles:Gyldighed/orgfaelles:GyldighedStatusKode

Has to be Aktiv for active to be true.

If value is “Inaktiv”, then active is set to false.

name

Organisation
//element(*,tns:ListResponseType)/org:ListOutput/org:FiltreretOejebliksbillede/org:Registrering/org:AttributListe/org:Egenskab/sd:OrganisationNavn
OrganisationEnhed
tns:ListResponse/orgenhed:ListOutput/orgenhed:FiltreretOejebliksbillede/orgenhed:Registrering/orgenhed:AttributListe/orgenhed:Egenskab/sd:EnhedNavn

alias

Concatenation of 'name' from the top of the tree down to and including the current entity.

partOf

OrganisationEnhed.Overordnet
Target:  tns:ListResponse/orgenhed:ListOutput/orgenhed:FiltreretOejebliksbillede/orgenhed:Registrering/orgenhed:RelationListe/sd:Overordnet/sd:ReferenceID/sd:UUIDIdentifikator (translated to a FHIR Organization reference)

.. or if Overordnet isn't set:

OrganisationEnhed.Tilhoerer
Target: tns:ListResponse/orgenhed:ListOutput/orgenhed:FiltreretOejebliksbillede/orgenhed:Registrering/orgenhed:RelationListe/sd:Tilhoerer/sd:ReferenceID/sd:UUIDIdentifikator (translated to a FHIR Organization reference)

Relationships defined in the organization trees from FK Organisation are reflected in the Organization.partOf element

...

.

FHIR id for the parent organization according to the OIO hierarchy.

address[0]

The first found entry in ../x:Registrering/x:RelationListe/x:Adresser with the Rolle = 'Postadresse' is mapped to a FHIR Address.

Address: Adresse resources with Rolle '

...

Postadresse' are stored as Organization.address.

address[0].use

Always "work"

In case of a STS ORG Adresse

address[0].type

Always "postal"

In case of a STS ORG Adresse

address[0].text

From Adresse service

../x:Registrering/x:AttributListe/x:Egenskab/x:AdresseTekst

In case of a STS ORG Adresse

address[0].period.start

From Organisation|OrganisationEnhed service

../x:Registrering/x:RelationList/x:Adresser/x:Virkning/x:FraTidspunkt/x:TidsstempelDatoTid

In case of a STS ORG Adresse

address[0].period.end

From Organisation|OrganisationEnhed service

../x:Registrering/x:RelationList/x:Adresser/x:Virkning/x:TilTidspunkt/x:TidsstempelDatoTid

In case of a STS ORG Adresse

address[0].use

Always "work"

In case of a DAR address

address[0].type

Always "postal"

In case of a DAR address

address[0].line

adresse.adgangsadresse.vejstykke.navn adresse.adgangsadresse.husnr[, adresse.etage adresse.dør]

In case of a DAR address

address[0].city

adresse.adgangsadresse.postnummer.navn

In case of a DAR address

address[0].postalCode

adresse.adgangsadresse.postnummer.nr

In case of a DAR address

address[0].country

Always "DK"

In case of a DAR address

address[0].regionCode

adresse.adgangsadresse.region.kode

In case of a DAR address

address[0].municipalityCode

adresse.adgangsadresse.kommune.kode

In case of a DAR address

telecom[0]

The first found entries in ../x:Registrering/x:RelationListe/x:Adresser for each of the 'Telefon' and 'Email' roles is mapped to a FHIR telecom.

Telecom: Adresse resources with Rolle 'Email' or 'Telefon' are stored as ContactPoints under the organization.telecom element.

telecom[0].use

Always "work"

telecom[0].system

"phone" or "email" depending on the Rolle

telecom[0].

...

Address: Adresse resources with Rolle 'Postadresse' are stored as Organization.address.

...

value

From Adresse service

../x:Registrering/x:AttributListe/x:Egenskab/x:AdresseTekst

telecom[0].period.start

From Organisation|OrganisationEnhed service

../x:Registrering/x:RelationList/x:Adresser/x:Virkning/x:FraTidspunkt/x:TidsstempelDatoTid

telecom[0].period.end

From Organisation|OrganisationEnhed service

../x:Registrering/x:RelationList/x:Adresser/x:Virkning/x:FraTidspunkt/x:TidsstempelDatoTid

contact

Not set by import

source

STS-ORG for an organisation imported from STS-ORG

cvrNumber

tns:ListResponse/virksomhed:ListOutput/virksomhed:FiltreretOejebliksbillede/virksomhed:Registrering/virksomhed:AttributListe/virksomhed:Egenskab/stsBrugervendtNoegleTekst.
 

The CVR Number defined on the Virksomhed is copied to all children in the organizational tree.

This CVR number is taken from the Organisation-associated Virksomheds object and applied to all Organisation and OrganisationEnhed in the tree.

The top-level Organisation in a hierarchy is accessed with the "tilhører" relation in an OrganisationEnhed

regionCode

Not available in FK Org.

This information does not exist for address in OIO Organisation (Adresse).

RegionCode for addresses is read from DAR:  adresse.adgangsadresse.region.kode

municipalityCode

Not available in FK Org.

This information does not exist for address in OIO Organisation (Adresse).

Municipality code for addresses is read from DAR: adresse.adgangsadresse.kommune.kode

providerIdentifier

Not available in FK Org.

specialty

Not available in FK Org.

Note

In case the resolution of the Address and telecom fails, it is logged and processing continues. This leaves the Address and telecom unchanged.

Establish the relationship between the FHIR Organization and the SOR-imported counterpart

...

The customer provides organisation relationship file(s) containing mappings between KOMBIT STS Organization identifiers and SOR identifiers. The Systematic operation team will make the eHealth then process the file line-by-line and establish the relevant related-to relationships in the FHIR Organization resources.

...