sdc-qrf

Set of utils packaged in npm package to render forms for SDC Questionnaire/Questionnaire Response.

Sdc-qrf uses in fhir-emr project. Also we're using aidbox-sdc as backed for fhir-emr.

npm i sdc-qrf

P.S. the package was allocated from https://github.com/beda-software/sdc-ide with commits history

Translation

The FHIR ↔ FCE converter supports the translation primitive extension on fields such as Questionnaire.title and Questionnaire.item.text.

By default, toFirstClassExtension(questionnaire) keeps translation extensions in FHIR format (they stay under extension and are not promoted to FCE translation fields). Pass withTranslations: true as the second argument to convert them:

import { toFirstClassExtension } from 'sdc-qrf';

// Default: translation extensions stay in FHIR format
const fceWithoutTranslations = toFirstClassExtension(questionnaire);

// Opt in: convert translation extensions to FCE `translation` fields
const fceWithTranslations = toFirstClassExtension(questionnaire, true);

FHIR

item:
    - linkId: chief-complaint
      type: string
      text: Chief complaint
      _text:
          extension:
              - url: http://hl7.org/fhir/StructureDefinition/translation
                extension:
                    - url: lang
                      valueCode: de
                    - url: content
                      valueString: Hauptbeschwerde
              - url: http://hl7.org/fhir/StructureDefinition/translation
                extension:
                    - url: lang
                      valueCode: fr
                    - url: content
                      valueString: Motif de consultation

FCE (toFirstClassExtension(questionnaire, true) / fromFirstClassExtension)

item:
    - linkId: chief-complaint
      type: string
      text: Chief complaint
      _text:
          translation:
              - lang: de
                content: Hauptbeschwerde
              - lang: fr
                content: Motif de consultation

translateQuestionnaire

To bake a single language into a FHIR Questionnaire before converting to FCE (resolves matching translations, keeps translation extensions, and stashes the original value):

import { toFirstClassExtension, translateQuestionnaire } from 'sdc-qrf';

const fceQuestionnaire = toFirstClassExtension(translateQuestionnaire(questionnaire, 'fr'), true);

translateQuestionnaire(questionnaire, 'fr') produces:

language: fr
item:
    - linkId: chief-complaint
      type: string
      text: Motif de consultation
      _text:
          extension:
              - url: http://hl7.org/fhir/StructureDefinition/translation
                extension:
                    - url: lang
                      valueCode: de
                    - url: content
                      valueString: Hauptbeschwerde
              - url: http://hl7.org/fhir/StructureDefinition/translation
                extension:
                    - url: lang
                      valueCode: fr
                    - url: content
                      valueString: Motif de consultation
              - url: http://hl7.org/fhir/StructureDefinition/translation
                extension:
                    - url: lang
                      valueCode: en
                    - url: content
                      valueString: Chief complaint

Before replacing a value, the original is stored as a translation extension using Questionnaire.language (or en if missing). If at least one translation is applied, Questionnaire.language is set to the requested language. If the requested language is missing, the original value and all translation extensions are left unchanged.