MedNet interface implementation guide
0.15.0 - CI Build

MedNet interface implementation guide - Local Development build (v0.15.0). See the Directory of published versions

Home Page

Official URL: https://mednet.swiss/fhir/ImplementationGuide/swiss.mednet.fhir Version: 0.15.0
Active as of 2022-07-15 Computable Name: MedNetInterface

Copyright/Legal: novcom AG

Introduction

This implementation guides describes the bundle that can be used to transfer patient information to MedNet, providing an optimized pre-filling of all forms.

The file to provide is based on FHIR architecture. The following image shows the structure of a Bundle file.

Bundle Schema

For the implementation we recommend to start by taking a look at the Bundle detailed example and at the composition Profile.

The Bundle detailed example includes many comments to simplify the understanding of each Field.

If you need more detailed informations about the different Elements, you can also take a look at each single profile.

We recommend to use the "MedNet supported fields" view to have a complete overview of the object

Snapshot Screenshot

This mustSupport view shows all fields supported by Mednet, if the profile you provide contains more informations or fields, mednet will simply ignore them

Compatibility with HL7 Fhir and Fhir.ch standard profiles

In order to show only the relevant informations on this IG, we created in some cases our own profiles based on, or copy of fhir.ch profiles. If your System already support some of those profiles, you should be able to reuse them

More details are available under compatibility

Don't hesitate to contact use if some useful improvements are needed

File encoding

All produced json files must be encoded using UTF-8 as defined in the ietf specifications

How to call MedNet with the bundle File

MedNet is a Rich-Client installed locally but they are different way to deliver the bundle to Mednet.

Calling the binary with parameters

On Windows

"C:\MedNet\app\MedNet.exe" -openformview -patientinfo:"<bundle.json>"

<bundle.json> is the full path to the json file

On Mac

open -n -a /Applications/MedNet.app --args -openformview -patientinfo:"<bundle.json>"

<bundle.json> is the full path to the json file

Using a protocol handler

You simply have to open following url:

mednet://openFormView/?patientinfo=<bundle.json>

<bundle.json> is the path from which the bundle can be downloaded.

It can be an url on a remote Server:

mednet://openFormView/?patientinfo=http://remote.url.com/bundle.json

Or it can be a local path

mednet://openFormView/?patientinfo=file:c:/temp/bundle.json

How to check validity of a produced json

HL7 provides a java FHIR validation tool you should find informations about it on https://confluence.hl7.org/display/FHIR/Using+the+FHIR+Validator.

Download the latest validator version

With following command line the validator will check the file my-patientOverview-bundle.json and write a report into the validation.html file

java -Duser.language=en -jar validator_cli.jar my-patientOverview-bundle.json -version 4.0 -ig https://mednet.swiss/fhir -html-output validation.html

If you get the following error message in the report, it can be ignored:

"Multiple profiles found for contained resource. This is not supported at this time" can be ignored

Copyright

Profile and Bundle definition

The profiles and bundle definitions described under this implementation guide are property of novcom AG. The use of those profiles is restricted to projects linked to novcom products interconnections

SNOMED

This artefact includes content from SNOMED Clinical Terms® (SNOMED CT®) which is copyright of the International Health Terminology Standards Development Organisation (IHTSDO). Implementers of these artefacts must have the appropriate SNOMED CT Affiliate license - for more information contact http://www.snomed.org/snomed-ct/get-snomed or info@snomed.org.

LOINC

This artefact includes content from LOINC®. This content LOINC® is copyright © 1995 Regenstrief Institute, Inc. and the LOINC Committee, and available at no cost under the license at http://loinc.org/terms-of-use.