OSCAR & Ocean Set-Up: At A Glance

Before You Start

Please note that OSCAR EMR requires a server-side configuration to enable Ocean. Please ensure that your OSP vendor supports Ocean before getting started (for more details, refer to "3. Configure Your Server").

  1. Download & Install the Ocean eForm & Toolbar
    • To start, you will need to download 2 (.html and .js) files and upload them into your OSCAR EMR, from the Administration window.
  2. Create a Shortcut to the Ocean eForm on the Schedule
    • This will allow you to easily access the Ocean eForm and Ocean features directly from a patient's appointment in the appointment schedule.
  3. Configure Your Server
    • If your OSCAR OSP vendor has Ocean pre-configured, you can skip this step.
    • If your OSP vendor does not have Ocean pre-configured or you are using a locally-hosted instance OSCAR instance, you will need to ask your OSP vendor or your IT person to change your server-site configuration to enable Ocean.
  4. Link Your OSCAR EMR to Ocean
    • Once your IT personnel or OSP have completed making the server-side configuration change to enable Ocean, the final step is to link your Ocean account with your OSCAR EMR.

OSCAR: Download & Install the Ocean eForm & Toolbar

  1. Download the Ocean eForm and toolbar files.

    • To download the files below, right-click on the file link, select “Save Link As…”, and save them to a location that is easily accessible.
  2. Upload the Ocean eForm into OSCAR.

    • Log in to your OSCAR EMR and open the Administration window from the menu along the top of the page.
    • Expand the "Forms/eForms" section and select "Manage eForms".
    • Upload the eForm by selecting "Upload", "Choose File", and then locating the OscarCustomForm.html file that you just downloaded (usually in your computer's "Downloads" folder).
    • Fill in empty fields (eForm name and Additional Information). Once complete, select “Upload”.
    • The uploaded eForm should now exist in the eForm Library list below (in the same window).
  3. Upload the Ocean Toolbar into OSCAR.

    • Open the Administration window again.
    • Expand the eForms section again, but this time, select "Upload an Image".
    • Select "Choose File" and locate the oceanToolbar.js file that you just downloaded (usually in your computer's "Downloads" folder).
    • Click the Upload button.

OSCAR: Create a Shortcut to the Ocean eForm on the Schedule

  1. Display the Ocean shortcut on your OSCAR Schedule.

    • Open the Preferences screen by selecting it from the top toolbar.
    • In the “eForms to display on appointment screen” section, select the Ocean eForm.
    • Click "Update" to save your changes.
  2. View and test your shortcut.

    • A shortcut link to Ocean will now exist on each patient’s appointment in the Schedule.
    • Click the shortcut link. This should open up the Ocean eForm.

OSCAR: Configure Your Server

If you use an OSP If you have a locally hosted OSCAR instance

Check with your OSCAR OSP vendor to find out if they have Ocean pre-configured. If they do, you can skip this step.

If you are a client of Trimara or OSCAR Service, you can skip this step since Ocean support is preconfigured.

Note that Indivica does NOT support Ocean.

If your OSP vendor does not have Ocean pre-configured, ask them to complete the following steps for you.

Changing the Server-Site Configuration to Enable Ocean

  1. Navigate to your OSCAR web app installation’s custom JavaScript directory (e.g. cd /var/lib/tomcat6/webapps/js/custom)
  2. Create a directory for your custom Ocean integration JavaScript (e.g. Ocean).
  3. Copy your default cme.js (or your existing customized cme.js file) file to this new directory. See your Oscar properties file cme_js property to determine if it has been customized. If there is no cme_js property in the file, then default is being used.

    e.g. cp /var/lib/tomcat6/webapps/js/custom/default/cme.js /var/lib/tomcat6/webapps/js/custom/Ocean

    If the properties file already contains a cme_js property, then the custom JavaScript files will need to be integrated. Please contact CognisantMD support for assistance.

  4. Edit the Ocean/cme.js and add the following to the jQuery(document).ready function callback:

    jQuery.ajax({ url: "../eform/displayImage.do?imagefile=oceanToolbar.js", cache: true, dataType: "script" });init();

    This code must replace the init(); call at the end of the callback function. The init() call will be made once the Ocean Ajax call has completed.

    Note: This custom JavaScript directory will need to be preserved during OSCAR upgrades, so it should be backed up.

  5. Edit your Oscar properties file (e.g. /usr/share/tomcat6/Oscar12_1.properties) and add a line for the cme_js property:


    The value “Ocean” MUST match the custom JavaScript directory created above

OSCAR: Link Your OSCAR EMR to Ocean

  • Open your OSCAR EMR and click "Administration" to open the Administration Panel window.
  • From the Administration Panel window, click "Manage eForms" to open the eForm Library window.
  • Click the Ocean eForm. This will open the Ocean eForm window.
  • In the Ocean eForm window, click the Settings button, then click the Initial Configuration button.
  • You will be prompted to enter your Ocean account username and password. Once the requested information is entered, click the Next button.
  • You will now be prompted to enter your Ocean account site number and shared encryption key. Once the requested information is entered, click the Secure Sign In button.
  • Close the Ocean eForm and eForm Library windows.