The components of MDMI message transformations have been provided here on GitHub as well as staged online for immediate use. To examine message transformations for yourself, we suggest these:
- Postman - a popular tool for API development. A standalone application available at https://www.postman.com/
- Swagger - another tool for developing and testing REST APIs. Swagger is a hosted application running on the same server as the MDMI Transformation Engine.
To get the full set of files for this exercise, download this project to your system. Use the dropdown button labeled "Code" at the top right of this pane. Click the dropdown and select your preferred means of downloading. Your choices will include:
- Opening with GitHub Desktop (only if you have it installed)
- Download ZIP. (Unzip the file after download.)
- Using the Git download command line using the URL provided - https://github.com/MDMI/mdix-transformation-connectathon33
A set of API requests is provided for ease of use. From within Postman, click the Import button at the top of the left pane and select the file Connectathon33.postman_collection.json from the root of the directory that was downloaded. It will create a "collection" named Connectathon33. This provides three requests:
- GET Get
- POST CDAtoFHIR
- POST FHIR2CDA
The POST requests are used for message transformation. For example, to transform a CDA message, click on GET CDAtoFHIR from the left pane.
In the right pane, click on Body as shown.
From there click the Select Files button and enter your message file.
Sample files are provided in the download at YOUR_DOWNLOAD_DIRECTORY \mdix-transformation-connectathon33-main\src\test\resources. The subidrectory names there refer to the source file format - cda, and fhir.
For example, to transform a CDA message to FHIR, select the POST CDAtoFHIR request from the left pane of Postman. In the Body tab select a file from the cda subdirectory.
You can also use your own source files. Just be certain that your files conform to the format being used.
Note: FHIR permits a number of file structures. If using your own FHIR source message, please first view the sample that has been provided and adjust yours to match it.
At this point you can run by clicking the Send button in the upper right of the window. The resultant message will appear at the bottom of the right pane.
An online Swagger implementation is available allowing you to see the structure of the API. Instructions for its use are here. You can go directly to the site at this URL:
http://mdmi-demo.mdixinc.net:8282/swagger-ui/index.html
When running locally, a Swagger implementation is accessed at http://localhost:5000/swagger-ui/index.html?url=/v3/api-docs&validatorUrl=#/mdmi-engine/transformation