Getting started with validator-wrapper

Overview

This project contains the CLI, Desktop GUI, and Standalone Validation Server for the FHIR Validator. A publicly hosted instance of the Web interface for this validator is available here: https://validator.fhir.org/

Repository

https://github.com/hapifhir/org.hl7.fhir.validator-wrapper/

Prerequisites

Java

Ensure you have at minimum, the Java 11 JDK installed on your system, and your JAVA_HOME environment variable pointed to the Java SDK. If you do not have the Java JDK installed, please follow the instructions here.

Git

You should clone the project locally using git.

git clone https://github.com/hapifhir/org.hl7.fhir.validator-wrapper.git

You will need a Git CLI or a Git Client installed. A general introduction to Git can be found here

IntelliJ Users

  1. Ensure you have the latest version of Intellij IDEA Community Edition installed. Check the current version on their downloads page.
  2. Follow these steps to import the cloned project:
    • From the main menu, select File -> Open...
    • In the browser dialog pick the org.hl7.fhir.validator-wrapper directory (the root of the project)
    • If prompted whether to Trust and Open Project 'org.hl7.fhir.validator-wrapper' select Trust Project
    • Select which window you would like to open the project in.

When the project first loads, it will attempt an initial build, and may take several minutes to complete. Once complete, the project should allow the building and running of tests in IntelliJ. To verify, in the Gradle side panel, right click on org.hl7.fhir.validator-wrapper -> Tasks -> build -> build and double click to initiate another build.

Apache NetBeans Users

  1. Follow the steps in the Intellij Users section above.

Eclipse Users

  1. Ensure you have the latest version of Eclipse installed. Check the current version on their downloads page.
  2. Run eclipse and select your Eclipse workspace.
  3. Follow these steps to import the cloned project:
    • From the main menu, select File -> Import...
    • Select Gradle -> Existing Gradle Project
    • Click Next
    • Under Project Root Directory, pick the org.hl7.fhir.validator-wrapper directory (the root of the project)
    • Leave all settings as default when prompted. Eclipse should automatically elect to use the gradle wrapper, which will provide the easiest development experience.
    • Click Finish

This should import the project, and you should be able to build and run of test in the Eclipse IDE. To verify, in the Project drop-down menu, select Clean.... In the Clean window, select the org.hl7.fhir.validator-wrapper project. Press Clean to run a full build.

Updated: