OSCAR: Configuring the REST API for Better Ocean Reliability

If you are experiencing troubles with Ocean (e.g. notes are not appearing patients' charts) and you have been a long-time Ocean user, you will want to switch to the REST API for a more reliable Ocean experience. You can do this by following the steps outlined below.

  • Log in to your OSCAR EMR.
  • Click on the Ocean shortcut on one of your patient's appointments to open up the Ocean eForm.
  • Click on the "Settings" button on the Ocean eForm.
  • Select "Advanced Settings".
  • Select "Configure REST API".
  • Click the checkbox to use the REST API for your Ocean custom eForm. Save your changes.

Your OSCAR-Ocean integration should now work reliably, as expected.

OSCAR: Printing or Downloading an Individual Ocean Note

You may find that you want to print or download an individual Ocean note from OSCAR. You can easily do this by following the steps outlined below.

  • Open the Encounter screen for your patient.
  • Find the note that you wish to print or download. Click on the little printer icon at the top right corner of the note.
  • The printer icon will turn green once selected. From there, you can select the main printer icon at the bottom of all the notes.
  • From the main print dialog, select "Selected" and then "Print".
  • From here, you can use the print function as usual, either sending it to your printer to print or selecting "Print to PDF" to download the note as a PDF file.

OSCAR: When Adding the Ocean Custom eForm Turns the Schedule Grey

This is caused by an obscure OSCAR bug.

To fix this issue:

  • Enter the "Preferences" window in OSCAR.
  • Find the "Length of link and form names to display on appointment screen" field.
  • This sets the number of letters shown for each eForm name on the schedule screen and blows up the screen (for some reason) when it's zero. Change the number to at least 1 (2 is usually a good number here) and the schedule should go back to normal.
  • Click "Update" when set to ensure that your changes are saved.

OSCAR: Why does my patient have no Ocean reference number on their Encounter Screen?

In order to generate and obtain the Ocean patient reference number needed for a patient to complete their forms on a tablet, the patient must be first uploaded into Ocean. Patients are uploaded into Ocean from OSCAR by loading the Ocean eForm for that patient.

You can load the Ocean eForm for a patient in OSCAR from the Appointment Schedule or the Encounter screen.

Appointment Schedule Encounter Screen
  • Click on the Ocean shortcut located on a patient's appointment on the OSCAR Schedule.
  • This will open up the Ocean eForm in a new tab or window, uploading the patient into Ocean and generating a patient reference number for the patient.

OSCAR: Mapping Answers from an Ocean eForm to an OSCAR Measurement

  1. Locate your measurement type in your OSCAR EMR.


    Locating Vitals

    • Ocean can collect responses from a patient via eForm and populate Vitals in OSCAR. Simply navigate to the vitals in a test patient and copy the value under the Type column and proceed to the next step.

    Locating a Custom Measurement

    • Log in to your OSCAR EMR and open the Administration panel.
    • Expand the "System Management" section (in the menu on the left) and select "Customize Measurements".
    • To view existing measurements, click Edit Measurement Group. Select the measurement group you would like to investigate from the dropdown menu and click Modify Measurement Types. Here, you can view your existing measurements, add or remove measurements from this group. Copy the name of the measurement and proceed to the next step.
    • To add a new measurement, click "Add Measurement Type". Copy the name in the "Type" field and proceed to the next step.
  2. Tag your measurement in your Ocean eForm.

    • When you are building your eForms, if you "tag" a caption by surrounding a single word with "@" and ":" then the value will be available for mapping using EMR field mapping. Ensure this word matches your measurement from step 1.

    Ensure your tagged field also contains a $$ variable after the colon to capture the value of your form item or formula defined in the "Scripting and More" tab. The complete tagged field syntax should be structured like so: @taggedField: $$

    • An example can be found in the screenshot to the right or in the note generated by this standard CAGE questionnaire.
    • CAGE Questionnaire
    • Note: The value of the tagged field in the Ocean note is passed directly to the OSCAR measurement. In other words, if OSCAR expects "Yes" or "No" and the note contains Y or N, it won't work. Therefore, the note has to produce exactly what OSCAR expects for the measurement.
  3. Map your OSCAR measurement in the Ocean Portal.

    • Log in to the Ocean Portal. Click "Menu" and select "Admin".
    • From the Admin Settings page, click "EMR Field Mapping" and add a row.
    • The "Tagged Field" should match the note that you tagged in your Ocean eForm (i.e. the caption you surrounded with "@"" and ":" in your Ocean eForm).
    • The "EMR Field" should be all capital letters and should exactly match the measurement type in OSCAR (see screenshot to the right).
    • Make sure to save your changes in the Ocean Portal before leaving that "EMR Field Mapping" page.
    • Now, if a patient completes the CAGE questionnaire, the CAGE value in the measurement will then be set in the "Measurements" section of their Encounter screen in OSCAR.