Translation of HL7 code systems

[danka74]

Consider translation of the HL7 code systems into Swedish for the systems used in the national base profiles.

In practice, providing code system supplements with additional designations.

Coordination with https://github.com/HL7Sweden/basprofiler-r4/issues/74

[vadi2]

I have experience doing translations and can help set this up. https://crowdin.com is a really nice platform that can expedite this kind of work.

[vadi2]

HL7 Germany and HL7 Austria are tackling translations and publication of supplements: https://chat.fhir.org/#narrow/stream/179202-terminology/topic/german.20translations.20for.20HL7.20CodeSystems and ran into the fact that UTG does not have a process for dealing with this kind of content officially: https://jira.hl7.org/browse/UP-549

They mentioned that any support in this area is welcome. Should we comment on this as HL7 Sweden to add a +1 ?

[danka74]

Scope of translation includes:

Directly used

CodeSystems

• http://terminology.hl7.org/CodeSystem/v3-EntityNamePartQualifierR2 only code #CL "Call me" is used
• http://terminology.hl7.org/CodeSystem/v2-0203 only codes #XX "Organisation identifier" and #PRN "Provider identifier" are used
• https://terminology.hl7.org/5.1.0/CodeSystem-v3-MaritalStatus.html codes #M, #D, #W, #U are used
• http://terminology.hl7.org/CodeSystem/v3-ActCode code #DEMO "all demographic information sensitivity"

[danka74]

I did check the NLL translations, see e.g. event-timing and the translation is done by providing display values in value sets.

Another way of providing translations is to create CodeSystem supplements with the additional designations, see e.g. the German base profiles' marital-status translation. Also see the Spanish translations here.

[danka74]

Möte 2024-05-27

• Ska vi översätta enskilda ValueSet eller skapa CodeSystem supplements? Tills motsatsen är bevisad, CodeSystem supplements
• Återanvända befintliga översättningar där de finns, fråga Samordningen efter fler källor.

[danka74]

I did an initial experiment with translating some code systems: https://github.com/danka74/hl7.fhir.r4.sv according to the process described here: https://build.fhir.org/ig/FHIR/ig-guidance/languages.html#creating-a-language-pack

Not sure how this compares to creating CodeSystem supplements with additional designations (in FSH).

[annarossander]

checked translations in VGR for these:

• http://terminology.hl7.org/CodeSystem/v3-EntityNamePartQualifierR2 not translated

• http://terminology.hl7.org/CodeSystem/v2-0203 not translated

• https://terminology.hl7.org/5.1.0/CodeSystem-v3-MaritalStatus.html https://vgrinformatik.se/kodtjanst/kodverk/metadata-och-kodtext/250/ VGR uses codes from Skatteverket. other terms than showed in meeting:

• http://terminology.hl7.org/CodeSystem/v3-ActCode not translated

[annarossander]

Jag återrapporterade från vårt möte till vår regionala grupp och fick lite motfrågor om vilka kodverk vi ska översätta och vilka vi i stället borde mappa, och hålla mappningen centralt någonstans. Tex just MaritalStatus kanske vore bättre att mappa mot Skatteverket, som är masterdatakälla i Sverige, och omvandla till FHIR när vi delar data med någon utanför Sverige.

[annarossander]

diskussion om ovan: danmark och finland verkar inte ha översatt MaritalStatus. MarialStatus är Extensible så vi får inte använda SKVs koder.

att göra:

• granska de översättningar som är gjorda för de fyra kodverken ovan https://build.fhir.org/ig/danka74/hl7.fhir.r4.sv/
• inventera vilka ytterligare kodverk som ska översättas. tex alla som är Required eller Exetensible i basprofilerna.
• fundera på frågan om SKVs kodverk till nästa möte. Nästa möte bokat 26/6 kl 15

[vadi2]

Useful context for handling translations in FHIR: https://github.com/FHIR/fhir-test-cases/blob/master/tx/languages.md and https://chat.fhir.org/#narrow/stream/179202-terminology/topic/CodeSystem.20supplement.20use.20cases

[annarossander]

möte 14/8 Daniel, Mattias, Anna

• gör CodeSystemSupplement till att börja med. Ev lägger vi det också som display i ValueSet.compose sen. Kanske.

• vi fokuserar på själva översättningarna nu. (ej publiceringsformer) Siktar på att göra alla kodverk i basprofilnerna som är Required eller Extensible, se inventering i kommenter nedan från Daniel. Daniel gör filer för dessa som vi kan jobba i på Daniels GitHub, de ska flyttas till HL7.se github sen.

• vad gäller martial status så är den extensible så vi gör ett kodverk som innehåller motsvarande SKVs kodverk med samma termer, och gör en mappning mellan det och SKVs kodverk.

• det finns ytterligare kodverk som ligger i datatyperna (lådorna). vi tex namntyper. vi får inventera dessa framöver.

nästa möte: imorgon 14.30

[danka74]

Identifierade CodeSystems:

• http://hl7.org/fhir/R4/valueset-identifier-use.html
• http://hl7.org/fhir/R4/valueset-identifier-type.html
• http://hl7.org/fhir/R4/valueset-administrative-gender.html
• http://hl7.org/fhir/R4/valueset-address-use.html
• http://hl7.org/fhir/R4/valueset-address-type.html
• http://hl7.org/fhir/R4/valueset-link-type.html
• http://hl7.org/fhir/R4/valueset-security-labels.html
• http://hl7.org/fhir/R4/valueset-patient-contactrelationship.html
• http://hl7.org/fhir/R4/valueset-languages.html
• marital status
• http://hl7.org/fhir/R4/valueset-days-of-week.html
• http://hl7.org/fhir/R4/valueset-contactentity-type.html

[annarossander]

tre återkommande fel i QA-report för översättningarna:

1. When HL7 is publishing a resource, the owning committee must be stated using the http://hl7.org/fhir/StructureDefinition/structuredefinition-wg extension ::: resursen CodeSystem är ej baserad på StructureDefinition. Är det fel i valideringen? Vi kan hur som inte stoppa in en extension i po-filen. Och det är inte HL7 som gör denna. kanske något fel i hl7.fhir.r4.sv.xml?

2. CodeSystems SHOULD NOT have a stated value for the caseSensitive element when they are a supplement ::: vi har letat efter var det läggs till i koden för Publisher men hittar inte.

3. Code systems published by HL7 SHALL conform to the ShareableCodeSystem profile, which says that the element CodeSystem.experimental is mandatory, but it is not present ::: vi har letat efter var det läggs till i koden för Publisher men hittar inte.

Daniel lägger issue om alla ovan.

[annarossander]

möte Daniel och Anna:

• felsökt och felanmält QA enligt post ovan
• kompletterat översättningsriktlinjer (https://github.com/danka74/hl7.fhir.r4.sv/blob/main/input/pagecontent/translation-princples.md)
• översatt de sista i listan vi sammanställt: CodeSystem-v2-0131 "contactRole2" - översatt lämpliga termer. CodeSystem-v2-0203 "IdentifierType" - ej översatt något ytterligare i denna då jag inte tror de är tillämpliga i Sverige. CodeSystem-v3 "EntityNamePartQualifierR2" - översatt några få. innehåller dels flera koder som ej används i Sverige, dels namn på läkemedel. behövs dessa?

CodeSystem-v2-0203 "IdentifierType" och CodeSystem-v3 "EntityNamePartQualifierR2 har även titel och beskrivning av kodverket i översättningsfilen (fast på olika sätt). Vill vi ha det i de andra också?

[danka74]

Lade till 3 nya kodverksöversättningar:

• ContactPointSystem
• ContactPointUse
• NameUse

Översättningen är väldigt inspirerad av Address-ditona

[annarossander]

snyggt! Annat med litet 'a' i ContactPointSystem?