Difference between revisions of "Carecoordination Module Configuration"

From OpenEMR Project Wiki
(→‎Instructions for APT based Linux distributions: No need to manually add Node PPA to apt sources as this is done by the curl command)
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
= Purpose =
= Purpose =
This document shows how to configure OpenEMR's CCDA module as found in OpenEMR 4.2 and later.  
This document shows how to configure OpenEMR's CCDA module as found in OpenEMR 4.2 and later.  
Please look here for [[Use the Carecoordination module]].
Please look here for how to [[use the Carecoordination module]]. This document has not yet been updated for improvements and additional features in the Carecoordination module with OpenEMR 7.0. The module was again significantly updated with OpenEMR 7.0 Patch 2.


= Introduction/ Caveats =
= Introduction/ Caveats =
Line 117: Line 117:




13. Enter your Mirth settings: (not necessary with Open EMR 6 and onwards)
13. Mirth settings are not necessary with Open EMR 6 and onwards.


(left oval)
MirthIP:
Client ID:
Username:
Password:




Line 141: Line 132:
== Install Node.js ==
== Install Node.js ==


We will install Node.js version 16.x from upstream as version 16 is the maximum version tested to work with OpenEMR. Node modules are run local to the service's directory, so all support dependecies are installed there. After installation, the Node.js CCDA service should start on demand.
We will install <b>Node.js version 18.x</b> from upstream as the 18 series is the maximum version currently tested to work with OpenEMR. Node modules are run local to the service's directory, so all support dependencies are installed there. After installation, the Node.js CCDA service should start on demand.


=== Instructions for Debian 11, on a system that requires sudo ===
=== Instructions for APT based Linux distributions ===


<code>cd ~</code>
<code>cd ~</code>
Line 150: Line 141:
<code>sudo apt remove --purge nodejs npm</code>
<code>sudo apt remove --purge nodejs npm</code>


Get Node 16 from upstream:<br/>
Get Node 18 from upstream and add Node PPA to apt sources so as to keep Node 18.x up-to-date:<br/>
<code>curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -</code>
<code>curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -</code>
 
Add Node PPA to apt sources so as to keep Node 16.x up-to-date. Create <code>/etc/apt/sources.list.d/nodesource.list</code> and add the following:<br/>
<code>deb [signed-by=/usr/share/keyrings/nodesource.gpg] https://deb.nodesource.com/node_16.x bullseye main<br/>
deb-src [signed-by=/usr/share/keyrings/nodesource.gpg] https://deb.nodesource.com/node_16.x bullseye main</code>


Install nodejs:<br/>
Install nodejs:<br/>
<code>sudo apt install -y nodejs</code>
<code>sudo apt install -y nodejs npm</code>


You may also need development tools to build native addons:<br/>
You may also need development tools to build native addons:<br/>
<code>sudo apt install gcc g++ make</code>
<code>sudo apt install gcc g++ make</code>


== Install the CCDA service ==
== Install the CCDA service ==
Line 173: Line 158:


Select the default for all questions.
Select the default for all questions.
Shutdown running "node" processes by searching for them, finding their pid and killing them. Otherwise changes aren't included until node is restarted.


Install required dependencies [Editor's note: I do so without sudo (see https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=960289), though OpenEMR's ccdaservice README.md recommends running it with sudo):<br/>
Install required dependencies [Editor's note: I do so without sudo (see https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=960289), though OpenEMR's ccdaservice README.md recommends running it with sudo):<br/>
Line 204: Line 191:
= Updating =
= Updating =


After updates of OpenEMR or of nodejs (?), ensure the latest libraries are installed.
After updates of OpenEMR or of nodejs, ensure the latest libraries are installed.


Navigate to OpenEMR's ccdaservice directory.
Navigate to OpenEMR's ccdaservice directory.
Shutdown running "node" processes by searching for them, finding their pid and killing them. Otherwise changes aren't included until node is restarted.
(In some instances, it is also necessary to delete the <code>ccdaservice/node_modules</code> directory.)


Run the following:<br/>
Run the following:<br/>
Line 223: Line 214:
<code>node serveccda.js</code>
<code>node serveccda.js</code>


If it's already running then it will give the following error: "<code>Error: listen EADDRINUSE: address already in use 127.0.0.1:6661</code>"). In this case you'll have to kill the running process (<code>pkill nodejs</code> on Linux), then start it as above.
If it is already running then it will give the following error: "<code>Error: listen EADDRINUSE: address already in use 127.0.0.1:6661</code>"). In this case you'll have to kill the running process (<code>pkill nodejs</code> on Linux), then start it as above.


If the service starts OK at the command-line, then try a CCDA export in OpenEMR while it's running and look for messages displayed at the command-line.
If the service starts OK at the command-line, then try a CCDA export in OpenEMR while it is running and look for messages displayed at the command-line.

Latest revision as of 13:56, 8 September 2024

Purpose

This document shows how to configure OpenEMR's CCDA module as found in OpenEMR 4.2 and later. Please look here for how to use the Carecoordination module. This document has not yet been updated for improvements and additional features in the Carecoordination module with OpenEMR 7.0. The module was again significantly updated with OpenEMR 7.0 Patch 2.

Introduction/ Caveats

The Carecoordination module was initially contributed to OpenEMR by Z&H Healthcare.

An OpenEMR Administrator's user account is required for these activities.

Procedure

Enable the CCDA service

Enable the CCDA service in OpenEMR:
Admin → Globals → Connectors → Enable C-CDA Service: Care Coordination Only | Portal Only | Both

This service should automatically start on demand when required by OpenEMR.


Install/ configure modules

Ccda-LnavModules.png

1. In the main menu:

'Modules → Manage Modules'














2. Click the 'Unregistered' tab

For full sized image click pic and select 'Full resolution' link



3. Click the 'Registered' button on each of the modules that are a dependency of Carecoordination, one at a time.

Be sure to register 'Carecoordination' last.


As they're registered they appear on the 'Registered' tab so you'll go back to the 'Unregistered' tab to register each one.


4. Open 'Registered' tab (below)


5. Click the blue 'Install' button of each module, one at a time from top to bottom, installing Carecoordination module last.

Each button's blue 'Installed' caption will change to blue 'Enabled'



For full sized image click pic and select 'Full resolution' link


6. Click all modules' 'Enabled' buttons top to bottom



For full sized image click pic and select 'Full resolution' link


7. In the 'Carecoordination' item click on the gear-like config icon (far right circle below)



For full sized image click pic and select 'Full resolution' link


8. In the new panel click 'Access Control' tab (oval above left)

9. Click in checkboxes of 'Carecoordination' and 'Send to HIE', for the ACL roles that you wish to allow to use this module; here, Administrator and Clinicians (lower rectangle above)

10. In Left Nav menu: 'Modules → Manage Modules'

11. Under Registered tab, Carecoordination module click on the config gear icon (oval)


For full sized image click pic and select 'Full resolution' link


Ccda-014.png

12. Click 'Settings' tab (top rectangle)

Author:

Primary Care Provider:


13. Mirth settings are not necessary with Open EMR 6 and onwards.


14. Click 'SAVE'


The CCDA module is now configured.

When you log out of OpenEMR and then back in, the Carecoordination menu item will appear in the Modules menu.


Install Node.js

We will install Node.js version 18.x from upstream as the 18 series is the maximum version currently tested to work with OpenEMR. Node modules are run local to the service's directory, so all support dependencies are installed there. After installation, the Node.js CCDA service should start on demand.

Instructions for APT based Linux distributions

cd ~

Ensure a clean install and clean up:
sudo apt remove --purge nodejs npm

Get Node 18 from upstream and add Node PPA to apt sources so as to keep Node 18.x up-to-date:
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -

Install nodejs:
sudo apt install -y nodejs npm

You may also need development tools to build native addons:
sudo apt install gcc g++ make

Install the CCDA service

Navigate to OpenEMR's ccdaservice directory.

Initialize the project to create package.json, which will hold information about the app and which packages it depends on:
npm init

Select the default for all questions.

Shutdown running "node" processes by searching for them, finding their pid and killing them. Otherwise changes aren't included until node is restarted.

Install required dependencies [Editor's note: I do so without sudo (see https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=960289), though OpenEMR's ccdaservice README.md recommends running it with sudo):
npm install --production


Apache Configuration

So as to get Zend to work and the Carecoordination menu option not to give a 404 error, use "AllowOverride FileInfo" in the Apache config file.

NOTE: https://www.open-emr.org/wiki/index.php/Securing_OpenEMR#Apache says "Do not allow use of .htaccess files in Apache (ie. turn off the AllowOverride setting)."

Enable mod_rewrite:
sudo a2enmod rewrite

Restart Apache:
sudo systemctl restart apache2


Install PHP Modules

The following PHP modules are required:

  • XML / SimpleXML / xmlreader / xmlwriter / XSL - php-xml - DOM, SimpleXML, WDDX, XML, and XSL module for PHP
  • SOAP - php-soap
  • Sockets - php-net-socket - Network Socket Interface

For example on Debian run:
sudo apt install php-xml php-soap php-net-socket


Updating

After updates of OpenEMR or of nodejs, ensure the latest libraries are installed.

Navigate to OpenEMR's ccdaservice directory.

Shutdown running "node" processes by searching for them, finding their pid and killing them. Otherwise changes aren't included until node is restarted.

(In some instances, it is also necessary to delete the ccdaservice/node_modules directory.)

Run the following:
npm install --production


Troubleshooting

Manually run the CCDA service

Manually run the CCDA service from the command-line, where you'll more easily be able to see if it runs OK or throws an error.

Navigate to OpenEMR's ccdaservice top level directory.

In there run the CCDA service:
node serveccda.js

If it is already running then it will give the following error: "Error: listen EADDRINUSE: address already in use 127.0.0.1:6661"). In this case you'll have to kill the running process (pkill nodejs on Linux), then start it as above.

If the service starts OK at the command-line, then try a CCDA export in OpenEMR while it is running and look for messages displayed at the command-line.