The new TELUS API integration allows Ocean to read and update values for patients within the EMR, without requiring the user to open the patient's chart. Although this API provides some great new functionality for Ocean users (such as automated kiosk check-in), it has some limitations that require workarounds, outlined below.
Unfortunately, some important data elements in the API are not currently accessible to Ocean (see tablet below). As a result, these fields cannot be pulled from the EMR and displayed on the tablet (or an Ocean eForm), nor can they be updated by Ocean when a patient changes it.
The ability to update some of these fields is important for certain Ocean workflows, such as when a patient updates their demographic on a kiosk or when a patient fills out a form that is mapped to a PS Suite custom form (e.g. perinatal questionnaire).
Fortunately, enhanced functionality of the Ocean Toolbar has been developed to work around this limitation. The Ocean Toolbar can set these missing values automatically for users, but only once the patient's chart is opened.
Mechanism of Action for the Ocean Toolbar to Detect and Update PS Suite Fields
When Ocean sees a field update request for one of the fields that the API does not support, it places it in a special "Ocean Temporary Note". This note contains the value of the field in a structured format. Once the chart has been opened, the Ocean Toolbar will detect and interpret this temporary note and proceed to automatically set the field value in PS Suite directly.
In the case of a custom form that should be populated based on answer to an Ocean eForm, the Ocean Toolbar will detect that a custom form or other form is desired, automatically inserting the custom form into the chart and populating its values.
Some other fields, such as surname, are not updated automatically for safety reasons. However, the Ocean Toolbar can instead automatically send a message ("yellow sticky") to the administrative team to request the field update.
Summary of TELUS API Field Limitations
|EMR Field||Accessible to Ocean||Updatable by Ocean||Comments|
|Surname||Y||using Ocean Toolbar|
|First Name||Y||using Ocean Toolbar|
|Health number province||Y||using Ocean Toolbar|
|Health number||Y||using Ocean Toolbar|
|Health number version code||Y||using Ocean Toolbar|
|Health number expiry date||Y||using Ocean Toolbar|
|Health number eligibility code||N||using Ocean Toolbar|
|Preferred method of contact||N||using Ocean Toolbar|
|Next of kin / Emergency contact||N||using Ocean Toolbar|
|Emergency contact relationship||N||using Ocean Toolbar|
|Emergency contact is POA||N||using Ocean Toolbar|
Note: The demographic fields not listed above (phone number etc.) are generally fully supported.
|Custom forms||N||using Ocean Toolbar|
|PS Suite messages / tasks / "yellow stickies"||N||N|
|CPP Field: FH||Y||N|
|CPP Field: PROB||Y||N|
|CPP Field: HPH||Y||N|
|CPP Field: RX||Y||N|
|CPP Field: ALLR||Y||N|
|CPP Field: IMMU||Y||N|
|CPP Field: PERS||Y||N|
|CPP Field: REMIND||N||N|
CPP Field: RISK
|Y||using Ocean Toolbar||Recreational drug use cannot be updated directly in the "RISK" CPP field.|
|Balance owing ($)||N||N||Status of the patient's private billing balance, as indicated by the green "$" in the appointment schedule (e.g. an overdue private payment). Since the API does not provide access to any billing-related information for patients, Ocean cannot access this value.|
|Custom vitals (e.g. @MyVital: 123)||N||Y|
|Core vitals (e.g. BP)||N||Y|