1. OceanMD
  2. Set Up Ocean
  3. TELUS PS Suite Integration Set-Up

TELUS PS Suite Integration Set-Up

<p>Learn how to set up your TELUS PS Suite EMR to connect and work properly with Ocean. First you will install the Ocean custom form, toolbar and attachment exporter, enabling quick access to Ocean patient forms and features, right from the chart. After that you will set up Ocean Cloud Connect to connect to the TELUS API. To learn more about Cloud Connect, please refer to "<a href="/hc/en-us/articles/360007319892">Introducing Ocean Cloud Connect</a>".</p> <p>Please Note: Before proceeding, you must have a signed contract with TELUS.</p>

Print Guide
Follow
  1. PS Suite: Download & Install the Ocean Custom Form, Toolbar and Attachment Exporter

    To start, you will need to download four PS Suite Custom Form (.cfm) files and import them into your PS Suite EMR.

    If you are setting up for the first time or downloading the latest version to update your instance, please follow the steps outlined below:

    1. Download the Ocean custom form, toolbar and attachment exporter files.

      • If the files do not appear as “.cfm”, right-click each of the links to and save them manually by selecting "Save As..." from the menu of options.

    2. Open the Edit Custom Forms window in PS Suite.

      • Log in to PS Suite and open the EMR (Records) window.
      • From the "Settings" menu, choose "Edit Custom Forms".

    3. Import the downloaded custom form files into PS Suite.

      • From the Edit Custom Forms window, select "File" and then "Import Form(s)".
      • Locate the .cfm files that were downloaded. (This will typically be in your computer's "Downloads" folder if you've downloaded the file recently.)
      • Select "Choose" and close the Custom Forms window.

    Note: Installing/updating the Ocean Toolbar, Custom Form and Attachment Exporter is an instance-wide process. You do not need to perform these steps on a per user basis. Once installed, the Ocean Custom Form, Toolbar and Attachment Exporter will be accessible to all users of the EMR.

    Updating the Ocean Toolbar, Custom Form and Attachment Exporter

    • If you are updating the Ocean Toolbar, Custom Form or Attachment Exporter, you may be prompted by a dialogue window, when importing your new .cfm files, that a form with the same identifier already exists in your system.

    • You are safe to proceed and select "Yes, Update Form." This will safely replace and overwrite the earlier version with the updated file that has been downloaded.

    • Once complete, please refresh or manually close and reopen any active patient charts. This will ensure charts are correctly using the updated version.

  2. PS Suite: Create a Reminder Trigger for the Ocean Toolbar

    To set your Ocean Toolbar to be visible and available to use for all your patients, you'll want to create a reminder for the Ocean Toolbar custom form.

    1. Open the Edit Reminders window in PS Suite.

      • Open the EMR (Records) window within PS Suite.
      • From the "Settings" menu, choose "Edit Reminders".

    2. Add a new reminder.

      • From the Edit Reminders window, select "Edit" and then "Add Reminder".
      • Give the reminder a descriptive name, such as "Ocean Toolbar".
      • Click "Add Line" to add criteria to the reminder.
      • From there, choose some criteria to specify when you would like the toolbar to show. If you simply want the toolbar to show for all users and for all patients, you can enter some criteria that is true for all patients, such as the patient’s age being less than 200. Alternatively, you can add additional criteria to make it show only for certain users or certain patient populations.
      • Click the “Show Custom Form or Stamp” radio button, then choose your toolbar custom form to show for this reminder from the dropdown menu.
      • Click "Done" to save the reminder and close the dialog box.
      • Open a patient chart to confirm that the toolbar is displayed under the CPP.

     

  3. PS Suite: Configure the Ocean Custom Form

    To link your Ocean custom form with your Ocean site number, you will need to configure the Settings on your Ocean custom form.

    To complete this step, you will need to be an admin on your Ocean site, and you will need your Ocean username, password, and site shared encryption key.

    To link your Ocean custom form with your Ocean site number, you will need to configure the Settings on your Ocean custom form.

    To complete this step, you will need to be an admin on your Ocean site, and you will need your Ocean username, password, and site shared encryption key.

    Configuring your Ocean form will connect Ocean and your EMR.

     

    1. Open the Ocean Settings menu from the Ocean custom form.

      • Open a patient chart (preferably a "dummy" or test chart, or an empty chart).
      • Click on the Ocean logo on the Ocean toolbar.
      • You will be prompted to create an Ocean user account (if you don’t already have one) or to sign in with your existing Ocean user account.
      • Click on the “Settings” button on the custom form.
      • Enter your Ocean username and password to authenticate yourself. The Ocean Settings dialog box will appear.

    2. Enter your Ocean account and site information.

      • Click “Ocean Site Number” to enter the site number provided to you by the Ocean administrator (accessible from the Admin Settings page in your Ocean Portal).
      • Click “Settings” on your Ocean custom form again and select “Shared Encryption Key” to enter your shared encryption key password. If you haven’t already set this in the Ocean Portal, you will be prompted to do so first. This key will be stored secretly within your EMR, thereby preventing anyone else (including CognisantMD) from accessing any patient data.
      • The other settings may be left as-is.
      • Click the “Remove” button on the Ocean custom form to delete the custom form from the chart.

     

  4. PS Suite: Enable Cloud Connect on Your Ocean Custom Form

    This will allow you to connect to the new TELUS API and take advantage of its accompanying features.

    This will allow you to connect to the new TELUS API and take advantage of its accompanying features.

     

    1. Access the advanced Ocean settings menu.

      • Open the Ocean custom form in PS Suite by clicking on the Ocean logo in the toolbar.
      • Confirm that your version is up-to-date (look for “v4.00” or later).
      • Click the “Settings” button on Ocean custom form and enter your Ocean credentials.
      • Select "Advanced..." from the Ocean settings menu.

    2. Activate Ocean Cloud Connect.

      • Select (or double-click) "Ocean/Cloud Connect Activated: N" to activate your Ocean Cloud Connect.

     

  5. PS Suite: Configure the Ocean Integration Module

    Configure your Cloud Connect integration using the EMR Instance ID and Secret credentials acquired from your EMR.

    Note: You will need to be an admin user in PS Suite to complete this step.

    Configure the Ocean Integration Module

    • Go to the dashboard, open the "Settings" menu, and this time, select "Preferences".
    • Enter your password to access the preferences dialog. Note that you will need administrative access to your PS Suite EMR to be able to access this dialog.
    • Select "Mobile" from the list of preferences options along the left. Note that you will only be able to access this area if you have your mobile TELUS API set up.
    • Under the Extension Application header located on the left-hand side of the page, select Integration Management.
    • Locate the Ocean by CognisantMD entry and click the purple "Configure" button.
  6. PS Suite: Set Up Ocean Cloud Connect

    In this step, you will sign into the Cloud Connect configuration and authenticate your integration with your EMR instance.

    Please refer to the article Setting Up Ocean Cloud Connect.

PS Suite: Download & Install the Ocean Custom Form, Toolbar and Attachment Exporter

To start, you will need to download four PS Suite Custom Form (.cfm) files and import them into your PS Suite EMR.

If you are setting up for the first time or downloading the latest version to update your instance, please follow the steps outlined below:

  1. Download the Ocean custom form, toolbar and attachment exporter files.

    • If the files do not appear as “.cfm”, right-click each of the links to and save them manually by selecting "Save As..." from the menu of options.

  2. Open the Edit Custom Forms window in PS Suite.

    • Log in to PS Suite and open the EMR (Records) window.
    • From the "Settings" menu, choose "Edit Custom Forms".

  3. Import the downloaded custom form files into PS Suite.

    • From the Edit Custom Forms window, select "File" and then "Import Form(s)".
    • Locate the .cfm files that were downloaded. (This will typically be in your computer's "Downloads" folder if you've downloaded the file recently.)
    • Select "Choose" and close the Custom Forms window.

Note: Installing/updating the Ocean Toolbar, Custom Form and Attachment Exporter is an instance-wide process. You do not need to perform these steps on a per user basis. Once installed, the Ocean Custom Form, Toolbar and Attachment Exporter will be accessible to all users of the EMR.

Updating the Ocean Toolbar, Custom Form and Attachment Exporter

  • If you are updating the Ocean Toolbar, Custom Form or Attachment Exporter, you may be prompted by a dialogue window, when importing your new .cfm files, that a form with the same identifier already exists in your system.

  • You are safe to proceed and select "Yes, Update Form." This will safely replace and overwrite the earlier version with the updated file that has been downloaded.

  • Once complete, please refresh or manually close and reopen any active patient charts. This will ensure charts are correctly using the updated version.

PS Suite: Create a Reminder Trigger for the Ocean Toolbar

To set your Ocean Toolbar to be visible and available to use for all your patients, you'll want to create a reminder for the Ocean Toolbar custom form.

  1. Open the Edit Reminders window in PS Suite.

    • Open the EMR (Records) window within PS Suite.
    • From the "Settings" menu, choose "Edit Reminders".

  2. Add a new reminder.

    • From the Edit Reminders window, select "Edit" and then "Add Reminder".
    • Give the reminder a descriptive name, such as "Ocean Toolbar".
    • Click "Add Line" to add criteria to the reminder.
    • From there, choose some criteria to specify when you would like the toolbar to show. If you simply want the toolbar to show for all users and for all patients, you can enter some criteria that is true for all patients, such as the patient’s age being less than 200. Alternatively, you can add additional criteria to make it show only for certain users or certain patient populations.
    • Click the “Show Custom Form or Stamp” radio button, then choose your toolbar custom form to show for this reminder from the dropdown menu.
    • Click "Done" to save the reminder and close the dialog box.
    • Open a patient chart to confirm that the toolbar is displayed under the CPP.

 

PS Suite: Configure the Ocean Custom Form

To link your Ocean custom form with your Ocean site number, you will need to configure the Settings on your Ocean custom form.

To complete this step, you will need to be an admin on your Ocean site, and you will need your Ocean username, password, and site shared encryption key.

To link your Ocean custom form with your Ocean site number, you will need to configure the Settings on your Ocean custom form.

To complete this step, you will need to be an admin on your Ocean site, and you will need your Ocean username, password, and site shared encryption key.

Configuring your Ocean form will connect Ocean and your EMR.

 

  1. Open the Ocean Settings menu from the Ocean custom form.

    • Open a patient chart (preferably a "dummy" or test chart, or an empty chart).
    • Click on the Ocean logo on the Ocean toolbar.
    • You will be prompted to create an Ocean user account (if you don’t already have one) or to sign in with your existing Ocean user account.
    • Click on the “Settings” button on the custom form.
    • Enter your Ocean username and password to authenticate yourself. The Ocean Settings dialog box will appear.

  2. Enter your Ocean account and site information.

    • Click “Ocean Site Number” to enter the site number provided to you by the Ocean administrator (accessible from the Admin Settings page in your Ocean Portal).
    • Click “Settings” on your Ocean custom form again and select “Shared Encryption Key” to enter your shared encryption key password. If you haven’t already set this in the Ocean Portal, you will be prompted to do so first. This key will be stored secretly within your EMR, thereby preventing anyone else (including CognisantMD) from accessing any patient data.
    • The other settings may be left as-is.
    • Click the “Remove” button on the Ocean custom form to delete the custom form from the chart.

 

PS Suite: Enable Cloud Connect on Your Ocean Custom Form

This will allow you to connect to the new TELUS API and take advantage of its accompanying features.

This will allow you to connect to the new TELUS API and take advantage of its accompanying features.

 

  1. Access the advanced Ocean settings menu.

    • Open the Ocean custom form in PS Suite by clicking on the Ocean logo in the toolbar.
    • Confirm that your version is up-to-date (look for “v4.00” or later).
    • Click the “Settings” button on Ocean custom form and enter your Ocean credentials.
    • Select "Advanced..." from the Ocean settings menu.

  2. Activate Ocean Cloud Connect.

    • Select (or double-click) "Ocean/Cloud Connect Activated: N" to activate your Ocean Cloud Connect.

 

PS Suite: Configure the Ocean Integration Module

Configure your Cloud Connect integration using the EMR Instance ID and Secret credentials acquired from your EMR.

Note: You will need to be an admin user in PS Suite to complete this step.

Configure the Ocean Integration Module

  • Go to the dashboard, open the "Settings" menu, and this time, select "Preferences".
  • Enter your password to access the preferences dialog. Note that you will need administrative access to your PS Suite EMR to be able to access this dialog.
  • Select "Mobile" from the list of preferences options along the left. Note that you will only be able to access this area if you have your mobile TELUS API set up.
  • Under the Extension Application header located on the left-hand side of the page, select Integration Management.
  • Locate the Ocean by CognisantMD entry and click the purple "Configure" button.