Валидация FHIR-ресурсов

с помощью утилиты org.hl7.fhir.validator.jar


Для валидации FHIR-ресурсов на соответствие профилям можно воспользоваться утилитой org.hl7.fhir.validator.jar. Утилита не поддерживает JSON-формат, поэтому ресурсы и профили должны быть в формате XML.

Для начала необходимо скачать себе jar-архив с программой. На странице загрузок сайта спецификации FHIR кликните по ссылке Validator Pack. Разархивируйте zip-архив в подходящую папку. В эту же папку скачайте архив со схемами.

Содержимое архива

Удостоверьтесь в том, что Java установлена.

Проверка версии Java

Запустите cmd из стартового меню или сочетанием клавиш Win+R.

Смените каталог на тот, где находится файл org.hl7.fhir.validator.jar, и запустите его командой

java -jar org.hl7.fhir.validator.jar
Смена каталога и запуск программы

Программа выдаст руководство по использованию.


Утилита для валидации FHIR-ресурсов.
Программа позволяет валидировать FHIR-ресурс или бандл (bundle; связка ресурсов).
Сначала выполняется проверка на соответствие схемам и Schematron, потом дополнительные проверки.
JSON в настоящее время не поддерживается.
Использование:
java -jar org.hl7.fhir.validator.jar [source] (-defn [definitions]) (-profile [profile]) (-output [output]) (-noxslt)
где
* [source] — это имя файла или URL ресурса или бандла, который необходимо провалидировать
* [definitions] — это имя файла или URL архива со схемами (например validation.zip, предлагающийся сразу вместе с программой). Значение по умолчанию: validation.zip
* [profile] — необязательный параметр — имя файла или URL профиля, на соответствие которому будет проверяться ресурс или бандл. Если этот параметр не указан, ресурс будет проверяться на соответствие базовой спецификации с использованием определений, указанных в параметре -defn
* [output] — необязательный параметр —имя файла для вывода результатов (OperationOutcome). По умолчанию результаты валидации выводятся в консоль.
* -noxslt — означает не запускать schematron (их желательно запускать, но они требуют xslt2).

Если нужно просто провалидировать ресурс на соответствие базовой спецификации FHIR, используется следующая командой:

java -jar org.hl7.fhir.validator.jar file-with-fhir-resource.xml -defn validation.zip

Если нужно провалидировать ресурс на соответствие некоторому профилю (structure definition), добавляется параметр:

java -jar org.hl7.fhir.validator.jar file-with-fhir-resource.xml -defn validation.zip -profile file-with-structure-definition.xml

Валидация на соответствие профилям с использованием слайсинга (slicing) на данный момент этим инструментом не поддерживается.


Ссылки:

Валидация FHIR-ресурсов на соответствие профилям

Очень симпатичный валидатор FHIR-ресурсов от Furore (но не поддерживает последнюю версию FHIR, где Profile переименовали в StructureDefinition)

Презентация FHIR Profiling tutorial от Ewout Kramer

Презентация Authoring Profiles in FHIR от Ewout Kramer

Profile Making for Work Groups Using FHIR от Lloyd McKenzie (требуется регистрация на сайте HL7)

Forge — программа для создания профилей от Furore

Описание ресурса StructureDefinition

Описание ресурса Bundle

Подробнее про операцию $validate

Страничка со всеми Furore FHIR Tools

Michel Rutten Authoring Profiles

Introduction to FHIR profiles (Ewout Kramer)

Advanced FHIR Profiling (Ewout Kramer)