SDC-Assemble

A Typescript reference implementation of the $assemble operation from the HL7 FHIR Structured Data Capture Specification and is designed for Modular Questionnaires.

Usage

You would need to implement the following interfaces:

InputParameters - Input parameters for the $assemble operation

{
    resourceType: 'Parameters'
    parameter: [ 
      {
        name: 'questionnaire',
        resource: YOUR_QUESTIONNAIRE_RESOURCE
      }
    ]
} 

FetchQuestionnaireCallback - A callback to fetch resources from your FHIR server

function fetchQuestionnaireCallback (canonicalUrl: string, requestConfig: any) {
  const { endpoint, token } = requestConfig;
  return axios.get(`${endpoint}/Questionnaire?url=${canonicalUrl}`, {
    method: 'GET',
    headers: { Accept: 'application/json+fhir; charset=utf-8', Authorization: `Bearer ${token}`, }
  });
};

Both of these interfaces are required to be implemented as arguments to the assemble() function.

Local development notes

It's recommended to run this library within a web app or a service if you're doing local development. This library compiles to both CommonJS and ES Modules, so there is no problems in using it across web frameworks and Node-based backends.

To compile the code, use npm run compile. To watch for changes, use npm run watch.

Note: Do not use tsc or tsc -w as it will only compile to ES Modules, which means it will not work with CommonJS-based implementations.

Sample implementation

We have used this module as a microservice in our forms server https://smartforms.csiro.au/api/fhir/Questionnaire/$assemble.

A sample implementation can be found here