Difference between revisions of "FHIR Server Setup"
(Created page with "==Installation== ===Tomcat=== Go to <syntaxhighlight lang="bash">tomcat/webapps/art-decor/WEB-INF/resources/config/properties-local.xml</syntaxhighlight> and add these lines...") |
|||
(13 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
+ | {{SeeNewDocs}} | ||
==Installation== | ==Installation== | ||
+ | |||
+ | {{AlertBox|This page is in anticipation of a stable release of the FHIR Server capabilities. At writing time, this is only available in the Dev channel. See [[ART installation packages]] for information on configuring channels}} | ||
+ | |||
===Tomcat=== | ===Tomcat=== | ||
Go to | Go to | ||
− | <syntaxhighlight lang="bash">tomcat/webapps/art-decor/WEB-INF/resources/config/properties-local.xml</syntaxhighlight> | + | <syntaxhighlight lang="bash"> |
+ | tomcat/webapps/art-decor/WEB-INF/resources/config/properties-local.xml | ||
+ | </syntaxhighlight> | ||
and add these lines: | and add these lines: | ||
<syntaxhighlight lang="xml"> | <syntaxhighlight lang="xml"> | ||
− | + | <property as="xs:anyURI" name="fhir.exist.url" value="http://localhost:8877/fhir"/> | |
− | + | <property as="xs:anyURI" name="fhir.external.exist.url" value="http://myserver:myport/fhir"/> | |
</syntaxhighlight> | </syntaxhighlight> | ||
Line 18: | Line 24: | ||
<syntaxhighlight lang="xml"> | <syntaxhighlight lang="xml"> | ||
− | + | <root pattern="/fhir" path="xmldb:exist:///db/apps/fhir/"/> | |
</syntaxhighlight> | </syntaxhighlight> | ||
− | Use the exist-db Dashboard to install one more more FHIR ''version'' | + | Use the exist-db Dashboard to install one more more FHIR ''version'' servers. Note: if you have the older "FHIR" without version installed: uninstall this first. [[File:dashboard-fhir-server.png|middle|750px]] |
===ART-DECOR Server=== | ===ART-DECOR Server=== | ||
Line 29: | Line 35: | ||
For any project that you want to ''FHIR Enable'', go to the project page for the project as author with decor-admin permissions, and add FHIR as RESTful Service. The + button is not active when there is no FHIR Server installed or if the FHIR URI is not configured. The only thing that a project-admin can configure is the version(s) he wants to activate. The rest is readonly. [[File:fhir-settings-project.png|700px]] | For any project that you want to ''FHIR Enable'', go to the project page for the project as author with decor-admin permissions, and add FHIR as RESTful Service. The + button is not active when there is no FHIR Server installed or if the FHIR URI is not configured. The only thing that a project-admin can configure is the version(s) he wants to activate. The rest is readonly. [[File:fhir-settings-project.png|700px]] | ||
− | {{ | + | {{NoteBox|When the server admin uninstalls a FHIR Server version the project references to it do not go away.}} |
One of the consequences of FHIR enabling a project is that valueSet renderings receive FHIR related links. | One of the consequences of FHIR enabling a project is that valueSet renderings receive FHIR related links. | ||
[[File:valueSet-html-rendering-with-fhir.png|400px]] | [[File:valueSet-html-rendering-with-fhir.png|400px]] | ||
+ | |||
+ | === FHIR URI's === | ||
+ | After setting up the FHIR server, resources can be retrieved from the locations described in: [[FHIR_URIs | FHIR URI's]] |
Latest revision as of 19:51, 9 November 2022
This is documentation for ART-DECOR Release 2 and tends to be out-dated. Please visit our new documentation site at docs.art-decor.org
Contents
Installation
This page is in anticipation of a stable release of the FHIR Server capabilities. At writing time, this is only available in the Dev channel. See ART installation packages for information on configuring channels |
Tomcat
Go to
tomcat/webapps/art-decor/WEB-INF/resources/config/properties-local.xml
and add these lines:
<property as="xs:anyURI" name="fhir.exist.url" value="http://localhost:8877/fhir"/>
<property as="xs:anyURI" name="fhir.external.exist.url" value="http://myserver:myport/fhir"/>
eXist-db
Go to
exist-db/webapp/WEB-INF/controller-config.xml
and add this line:
<root pattern="/fhir" path="xmldb:exist:///db/apps/fhir/"/>
Use the exist-db Dashboard to install one more more FHIR version servers. Note: if you have the older "FHIR" without version installed: uninstall this first.
ART-DECOR Server
Log in using a dba account and go to the art-decor/art-settings page. Enter the FHIR Server URL appropriate for your server. Normally this comes down to http://myhostname/fhir/. Note the final slash as with all URLs configured here. See ART_maintenance_manual#FHIR_endpoint_prefix for more detail.
ART-DECOR Project
For any project that you want to FHIR Enable, go to the project page for the project as author with decor-admin permissions, and add FHIR as RESTful Service. The + button is not active when there is no FHIR Server installed or if the FHIR URI is not configured. The only thing that a project-admin can configure is the version(s) he wants to activate. The rest is readonly.
One of the consequences of FHIR enabling a project is that valueSet renderings receive FHIR related links.
FHIR URI's
After setting up the FHIR server, resources can be retrieved from the locations described in: FHIR URI's