extend support for printable elements

alexlipovka · alexlipovka · commit e5448c73b304 · 2026-06-18T00:07:58.000+04:00
diff --git a/src/converter/__tests__/resources/questionnaire_fce/printable_header.json b/src/converter/__tests__/resources/questionnaire_fce/printable_header.json
@@ -4,11 +4,24 @@
     "meta": {
         "profile": ["https://emr-core.beda.software/StructureDefinition/fhir-emr-questionnaire"]
     },
-    "printableHeader": {
-        "contentType": "application/pdf",
-        "data": "base64-encoded-pdf-data",
-        "url": "https://example.com/printable-header.pdf"
-    },
+    "printableHeader": [
+        {
+            "valueAttachment": {
+                "contentType": "application/pdf",
+                "data": "base64-encoded-pdf-data",
+                "url": "https://example.com/printable-header.pdf"
+            }
+        },
+        {
+            "valueExpression": {
+                "language": "text/fhirpath",
+                "expression": "%Patient.name.given[0] + ' ' + %Patient.name.family"
+            }
+        },
+        {
+            "valueString": "Patient Name"
+        }
+    ],
     "item": [
         {
             "linkId": "title",
diff --git a/src/converter/__tests__/resources/questionnaire_fhir/printable_header.json b/src/converter/__tests__/resources/questionnaire_fhir/printable_header.json
@@ -12,6 +12,17 @@
                 "data": "base64-encoded-pdf-data",
                 "url": "https://example.com/printable-header.pdf"
             }
+        },
+        {
+            "url": "https://emr-core.beda.software/StructureDefinition/printable-header",
+            "valueExpression": {
+                "language": "text/fhirpath",
+                "expression": "%Patient.name.given[0] + ' ' + %Patient.name.family"
+            }
+        },
+        {
+            "url": "https://emr-core.beda.software/StructureDefinition/printable-header",
+            "valueString": "Patient Name"
         }
     ],
     "item": [
diff --git a/src/converter/fceToFhir/questionnaire/processExtensions.ts b/src/converter/fceToFhir/questionnaire/processExtensions.ts
@@ -1,6 +1,20 @@
-import { FCEQuestionnaire } from '../../../fce.types';
+import { FCEPrintableElement, FCEQuestionnaire } from '../../../fce.types';
 import { Extension as FHIRExtension, Questionnaire as FHIRQuestionnaire } from 'fhir/r4b';
 
+function processPrintableElements(url: string, elements: FCEPrintableElement[]): FHIRExtension[] {
+    return elements.map((element) => {
+        if ('valueAttachment' in element) {
+            return { url, valueAttachment: element.valueAttachment };
+        }
+
+        if ('valueExpression' in element) {
+            return { url, valueExpression: element.valueExpression };
+        }
+
+        return { url, valueString: (element as { valueString: string }).valueString };
+    });
+}
+
 export function processExtensions(questionnaire: FCEQuestionnaire): FHIRQuestionnaire {
     const {
         launchContext,
@@ -11,8 +25,11 @@ export function processExtensions(questionnaire: FCEQuestionnaire): FHIRQuestion
         assembleContext,
         itemPopulationContext,
         variable,
+        printableCover,
         printableHeader,
+        printableHeaderFirstPage,
         printableFooter,
+        printableFooterLastPage,
         ...fhirQuestionnaire
     } = questionnaire;
 
@@ -119,18 +136,49 @@ export function processExtensions(questionnaire: FCEQuestionnaire): FHIRQuestion
         );
     }
 
+    if (printableCover) {
+        extensions = extensions.concat(
+            processPrintableElements(
+                'https://emr-core.beda.software/StructureDefinition/printable-cover',
+                printableCover,
+            ),
+        );
+    }
+
     if (printableHeader) {
-        extensions.push({
-            url: 'https://emr-core.beda.software/StructureDefinition/printable-header',
-            valueAttachment: printableHeader,
-        });
+        extensions = extensions.concat(
+            processPrintableElements(
+                'https://emr-core.beda.software/StructureDefinition/printable-header',
+                printableHeader,
+            ),
+        );
+    }
+
+    if (printableHeaderFirstPage) {
+        extensions = extensions.concat(
+            processPrintableElements(
+                'https://emr-core.beda.software/StructureDefinition/printable-header-first-page',
+                printableHeaderFirstPage,
+            ),
+        );
     }
 
     if (printableFooter) {
-        extensions.push({
-            url: 'https://emr-core.beda.software/StructureDefinition/printable-footer',
-            valueAttachment: printableFooter,
-        });
+        extensions = extensions.concat(
+            processPrintableElements(
+                'https://emr-core.beda.software/StructureDefinition/printable-footer',
+                printableFooter,
+            ),
+        );
+    }
+
+    if (printableFooterLastPage) {
+        extensions = extensions.concat(
+            processPrintableElements(
+                'https://emr-core.beda.software/StructureDefinition/printable-footer-last-page',
+                printableFooterLastPage,
+            ),
+        );
     }
 
     if (extensions.length) {
diff --git a/src/converter/fhirToFce/questionnaire/processExtensions.ts b/src/converter/fhirToFce/questionnaire/processExtensions.ts
@@ -1,4 +1,5 @@
-import { Questionnaire as FHIRQuestionnaire, Expression as FHIRExpression, Attachment } from 'fhir/r4b';
+import { Questionnaire as FHIRQuestionnaire, Expression as FHIRExpression } from 'fhir/r4b';
+import { FCEPrintableElement } from '../../../fce.types';
 
 export function processExtensions(fhirQuestionnaire: FHIRQuestionnaire): {
     launchContext?: any[];
@@ -9,8 +10,11 @@ export function processExtensions(fhirQuestionnaire: FHIRQuestionnaire): {
     assembleContext?: string[];
     itemPopulationContext?: FHIRExpression;
     variable?: FHIRExpression[];
-    printableHeader?: Attachment;
-    printableFooter?: Attachment;
+    printableCover?: FCEPrintableElement[];
+    printableHeader?: FCEPrintableElement[];
+    printableHeaderFirstPage?: FCEPrintableElement[];
+    printableFooter?: FCEPrintableElement[];
+    printableFooterLastPage?: FCEPrintableElement[];
 } {
     const launchContext = processLaunchContext(fhirQuestionnaire);
     const mapping = processMapping(fhirQuestionnaire);
@@ -20,8 +24,26 @@ export function processExtensions(fhirQuestionnaire: FHIRQuestionnaire): {
     const assembleContext = processAssembleContext(fhirQuestionnaire);
     const itemPopulationContext = processItemPopulationContext(fhirQuestionnaire);
     const variable = processVariable(fhirQuestionnaire);
-    const printableHeader = processPrintableHeader(fhirQuestionnaire);
-    const printableFooter = processPrintableFooter(fhirQuestionnaire);
+    const printableCover = processPrintableElements(
+        fhirQuestionnaire,
+        'https://emr-core.beda.software/StructureDefinition/printable-cover',
+    );
+    const printableHeader = processPrintableElements(
+        fhirQuestionnaire,
+        'https://emr-core.beda.software/StructureDefinition/printable-header',
+    );
+    const printableHeaderFirstPage = processPrintableElements(
+        fhirQuestionnaire,
+        'https://emr-core.beda.software/StructureDefinition/printable-header-first-page',
+    );
+    const printableFooter = processPrintableElements(
+        fhirQuestionnaire,
+        'https://emr-core.beda.software/StructureDefinition/printable-footer',
+    );
+    const printableFooterLastPage = processPrintableElements(
+        fhirQuestionnaire,
+        'https://emr-core.beda.software/StructureDefinition/printable-footer-last-page',
+    );
 
     return {
         launchContext: launchContext?.length ? launchContext : undefined,
@@ -32,8 +54,11 @@ export function processExtensions(fhirQuestionnaire: FHIRQuestionnaire): {
         assembleContext: assembleContext.length ? assembleContext : undefined,
         itemPopulationContext: itemPopulationContext ? itemPopulationContext : undefined,
         variable: variable?.length ? variable : undefined,
-        printableHeader: printableHeader ? printableHeader : undefined,
-        printableFooter: printableFooter ? printableFooter : undefined,
+        printableCover: printableCover?.length ? printableCover : undefined,
+        printableHeader: printableHeader?.length ? printableHeader : undefined,
+        printableHeaderFirstPage: printableHeaderFirstPage?.length ? printableHeaderFirstPage : undefined,
+        printableFooter: printableFooter?.length ? printableFooter : undefined,
+        printableFooterLastPage: printableFooterLastPage?.length ? printableFooterLastPage : undefined,
     };
 }
 
@@ -163,26 +188,26 @@ function processVariable(fhirQuestionnaire: FHIRQuestionnaire): FHIRExpression[]
     return extensions.map((ext) => ext.valueExpression!);
 }
 
-function processPrintableHeader(fhirQuestionnaire: FHIRQuestionnaire): Attachment | undefined {
-    const extension = fhirQuestionnaire.extension?.find(
-        (ext) => ext.url === 'https://emr-core.beda.software/StructureDefinition/printable-header',
-    );
-
-    if (!extension) {
+function processPrintableElements(
+    fhirQuestionnaire: FHIRQuestionnaire,
+    extensionUrl: string,
+): FCEPrintableElement[] | undefined {
+    const extensions = fhirQuestionnaire.extension?.filter((ext) => ext.url === extensionUrl);
+    if (!extensions?.length) {
         return undefined;
     }
 
-    return extension.valueAttachment;
-}
-
-function processPrintableFooter(fhirQuestionnaire: FHIRQuestionnaire): Attachment | undefined {
-    const extension = fhirQuestionnaire.extension?.find(
-        (ext) => ext.url === 'https://emr-core.beda.software/StructureDefinition/printable-footer',
-    );
+    const elements: FCEPrintableElement[] = [];
 
-    if (!extension) {
-        return undefined;
+    for (const ext of extensions) {
+        if (ext.valueAttachment) {
+            elements.push({ valueAttachment: ext.valueAttachment });
+        } else if (ext.valueExpression) {
+            elements.push({ valueExpression: ext.valueExpression });
+        } else if (ext.valueString !== undefined) {
+            elements.push({ valueString: ext.valueString });
+        }
     }
 
-    return extension.valueAttachment;
+    return elements.length ? elements : undefined;
 }
diff --git a/src/fce.types.ts b/src/fce.types.ts
@@ -32,10 +32,16 @@ export interface FCEQuestionnaire extends Questionnaire {
     /** NOTE: from extension http://hl7.org/fhir/StructureDefinition/variable */
     /** Variable specifying a logic to generate a variable for use in subsequent logic. The name of the variable will be added to FHIRPath's context when processing descendants of the element that contains this extension. */
     variable?: Expression[];
+    /** NOTE: from extension https://emr-core.beda.software/StructureDefinition/printable-cover */
+    printableCover?: FCEPrintableElement[];
     /** NOTE: from extension https://emr-core.beda.software/StructureDefinition/printable-header */
-    printableHeader?: Attachment;
+    printableHeader?: FCEPrintableElement[];
+    /** NOTE: from extension https://emr-core.beda.software/StructureDefinition/printable-header-first-page */
+    printableHeaderFirstPage?: FCEPrintableElement[];
     /** NOTE: from extension https://emr-core.beda.software/StructureDefinition/printable-footer */
-    printableFooter?: Attachment;
+    printableFooter?: FCEPrintableElement[];
+    /** NOTE: from extension https://emr-core.beda.software/StructureDefinition/printable-footer-last-page */
+    printableFooterLastPage?: FCEPrintableElement[];
     /** NOTE: from extension http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-targetStructureMap */
     targetStructureMap?: string[];
 }
@@ -216,3 +222,17 @@ export interface FCEQuestionnaireMappingReference {
 export interface FCEQuestionnaireMappingExpression {
     valueExpression: Expression;
 }
+
+export interface FCEPrintableAttachmentElement {
+    valueAttachment: Attachment;
+}
+export interface FCEPrintableExpressionElement {
+    valueExpression: Expression;
+}
+export interface FCEPrintableStringElement {
+    valueString: string;
+}
+export type FCEPrintableElement =
+    | FCEPrintableAttachmentElement
+    | FCEPrintableExpressionElement
+    | FCEPrintableStringElement;
