Ballerina FHIR R4 Packages

The Ballerina FHIR R4 packages include FHIR R4 data types, FHIR resource types as specified in commonly used Implementation Guides (IGs), parsers and serializers for FHIR resources, FHIR service type as well as miscellaneous utilities for creating, accessing, and manipulating FHIR resources.

Note: This package only supports FHIR JSON payload format only. FHIR XML payload support will be added soon.

For more information, go to the module(s).

• health.fhir.r4
• health.fhir.r4.uscore
• health.fhir.r4.aubase
• health.fhirr4

Building from the source

Setting up the prerequisites

1. Download and install Java SE Development Kit (JDK) version 11. You can install either OpenJDK or Oracle.

   Note: Set the JAVA_HOME environment variable to the path name of the directory into which you installed JDK.

2. Download and install Ballerina Swan Lake.

Building the source

Execute the commands below to build from the source.

• To build the package (eg - to build the uscore package):

  bal pack ./uscore501

• To build the FHIR service:

  • Navigate to fhirr4 and run the following command

  mvn clean install

• Use the following to run with tests

  mvn clean install -PrunBalTest

• Use the following to run tests with Graalvm native image

  mvn clean install -PrunGraalVMTest

• To publish fhirservice packages, navigate to the fhirr4/ballerina/target/classes/fhirservice directory and run the Ballerina push command

  • To the Ballerina central

  bal push

  • To the local repository

  bal push --repository=local

  Note: FHIR service uses some Ballerina language Java dependencies available as Github packages. To access them during the build, it requires an access token from Github with the scope read:packages. Hence add the below server config to your Maven's settings.xml file located under <M2_Home>/confs/ directory.

    <servers>
      . . .
  
      <server>
          <id>ballerina-language-repo</id>
          <username>Github_user_name</username>
          <password>Github_personal_access_token</password>
      </server>
    <servers>

Contributing to Ballerina

As an open source project, Ballerina welcomes contributions from the community.

For more information, go to the contribution guidelines.

Code of conduct

All the contributors are encouraged to read the Ballerina Code of Conduct.

Useful links

• Discuss the code changes of the Ballerina project in ballerina-dev@googlegroups.com.
• Chat live with us via our Discord server.
• Post all technical questions on Stack Overflow with the #ballerina tag.