Note: These instructions are only valid for EMR version 9.8 and CPS version 12.0. Later versions of those products should follow the steps here.
Background
When HTML encounter forms were first enabled on EMR 9.8 and CPS 12.0, they had the constraint that their HTML content had to live on the EMR’s JBOSS server. It was technically possible to access HTML encounter forms on other servers, but you had to do so indirectly. That indirect approach required that you first point the EMR to an HTML file living on your JBOSS server, and then that HTML could then use javascript to redirect the browser window to another server located elsewhere.
Blackbird employed this “redirect” approach to open the Blackbird problem search application, and AngleMD leverages this approach too.
We can leverage this process to quickly upgrade a practice from Blackbird to AngleMD by making a few edits to the redirect file on JBOSS.
Details
When the Blackbird problem search application was first installed, all EMR 9.8 and CPS 12.0 environments were given a file called BBS_redirect.html
which was copied to the <JBOSS_HTML_DIRECTORY>/EncounterForms/BBS_EFS
folder. QuickText macros in the EMR could then reference this file to open up Blackbird.
The contents of the original Blackbird BBS_redirect.html file looked something like this:
<!doctype html> <!-- COPYRIGHT 2015, BLACKBIRD SOLUTIONS, INC --> <html lang="en"> <head> <meta charset="utf-8"> <META HTTP-EQUIV="Pragma" CONTENT="no-cache"> <script type="text/javascript"> // EXAMPLE QUICK TEXT MACROS... // .... </script> <script src="http://content.blackbirdsolutions.com/javascript/emr_redirect/emr_redirect.js"></script> </head> <body onload="onBBSLoad();"> </body> </html>
What this HTML is doing is loading some javascript from the URL (in bold text above), and once that happens, the browser then calls the javascript function onBBSLoad(). This javascript function is what redirects the browser window to the URL of the Blackbird application.
By updating the text in this file, we can cause the AngleMD version of the problem search application to load instead of Blackbird. (Note: There are other approaches to opening AngleMD, but this is the easiest and requires no additional workflow changes by the providers, or clinical content changes within the EMR).
Note: Before making any edits to BBS_redirect.html, be sure to create a backup copy. That way you can restore things easily if you run into any problems.
Updating BBS_redirect.html to open AngleMD
<!doctype html> <!-- ANGLESEARCH, COPYRIGHT 2018, BY ANGLEMD, LLC --> <html lang="en"> <head> <meta charset="utf-8"> <META HTTP-EQUIV="Pragma" CONTENT="no-cache"> <script src="http://anglesearch.anglemdservices.com/redirect_js" type="text/javascript"></script> </head> <body onload="onUrlRedirect();"> </body> </html>
If you replace all of the code in BBS_redirect.html with the HTML code found above and save your file, the EMR should then immediately begin opening AngleSearch whenever you follow the workflow used at your site to open Blackbird (e.g. using the “.bbs” quicktext”). You will know you are in the AngleMD version, because the toolbar in the top of the AngleMD version is black with the AngleMD logo, rather than white with the Blackbird logo. If things don’t seem to be working properly, restore BBS_redirect.html with your back up copy (you did make a back up copy, right?), and contact AngleMD for assistance.
Note: the URL in bold above does not have a file extension associated with it (even though there was a file extension on the Blackbird version). The javascript function onBBSLoad() has also been renamed to onUrlRedirect(). If either the URL or the name of the JavaScript function are not copied exactly, the file may not load AngleSearch properly.