Ballerina FHIR R4 Packages

Package	Daily Build	Codecov
health.fhir.r4.aubase410
health.fhir.r4.carinbb200
health.fhirr4
health.fhir.r4.international401
health.fhir.r4.lkcore010
health.fhir.r4.parser
health.fhir.r4
health.fhir.r4.terminology
health.fhir.r4.uscore501
health.fhir.r4utils.ccdatofhir
health.fhir.r4utils.fhirpath
health.fhir.r4utils.patientmatching
health.fhir.r4.validator

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).

Building from the source

Setting up the prerequisites

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.
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.

ballerina-platform / module-ballerinax-health.fhir.r4

readme