Oracle EMR
Overview
Oracle EMR integration lets you connect your Oracle Health electronic medical record system to Telemedicall.

You can use this integration to access patient medical information from Oracle directly inside Telemedicall. This helps you review patient records without switching between systems.
After connecting, you can:
- Search Oracle patients
- Connect Oracle patients to Telemedicall patients
- View medical information available through Oracle
- Access clinical records such as conditions and medications
How to Access Oracle EMR
Follow these steps to open Oracle EMR:
1. Go to the left sidebar and click Oracle EMR

2. You will see the Oracle EMR page
You can open the connection window in two ways:
Method 1
1. Go to the Oracle EMR page. If Oracle is not connected, the page shows Oracle is currently disconnected
2. Click Go to Settings in the middle of the page

Method 2
1. Go to the left sidebar and click Apps

2. Find Oracle EMR Connector in the list or search for it

3. Click Connect on the Oracle EMR Connector app

After either method, the connection window will open on your screen.
Steps
How to connect to Oracle EMR
1. Open the connection window

2. Copy the Public Key shown at the top of the window (use the copy icon) and add it to your Oracle / FHIR server settings

3. Enter an EMR Label — a name that helps you identify the connection, for example Oracle Main Clinic
4. Enter the Server Address — this is your Oracle server URL
5. Enter the Token — this is your Oracle access token
6. Enter the Tenant ID (Hospital ID) — your hospital or organization provides this ID
7. If you are connecting to an Oracle sandbox (test) server, tick Sandbox

8. Click Test Connection

After clicking:
- If the information is correct, you will see Connection test successful

- If the information is incorrect, you will see Connection test failed

9. If the test is successful, click Connect
After clicking Connect:
- Your Oracle account is linked
- You will return to the Oracle EMR page, ready to search patients
How to retry connection
1. If the test fails, click Try Again
2. Check the Server Address, Token, Tenant ID and the Sandbox option
3. Re-enter the correct values
4. Click Test Connection again
How to search for patients
The Oracle patient list is not displayed automatically. You search for the patients you need.
1. Go to the Oracle EMR page and click the search icon

2. Type the patient name. Until you enter at least 3 characters, the page shows Type at least 3 characters to search oracle patients

3. After 3 characters, the system searches Oracle records and the matching patients appear in the results list

How to view Oracle data for a patient
1. Search for the patient
2. Click the patient in the results list

3. The patient's Oracle medical information opens (see the image in the Overview)
You will be able to view medical information available through Oracle, including:
- Patient details (birthday, phone, address, MRN, primary care provider)
- Conditions
- Medications
- Other available clinical records, such as lab results
Use the back arrow at the top left to return to the list. The Connect link at the top right links this patient, as described below.
How to connect a patient
1. Search for a patient and click Connect in the Status column

2. The Telemedicall Patient List opens with your Telemedicall patients. Patients already linked to another EMR are shown in grey, with the linked patient in the Connected Patient (External EMR) column

3. Search by name, date of birth or ID number if needed, select a patient and click Connect

After connecting:
- The patient is linked and their Telemedicall name appears in the list
- The Connect button changes to Disconnect

How to disconnect a patient
1. Search for the connected patient
2. Click Disconnect in the Status column

3. A confirmation window appears. Click Disconnect to confirm

After disconnecting:
- The patient is unlinked from Oracle and shows Not Connected again
- You can reconnect the patient later if needed

How to disconnect Oracle EMR
1. Go to the left sidebar and click Apps
2. Find Oracle EMR Connector in the list or search for it
3. Hover over the Oracle EMR Connector app and click More Actions (⋮)

4. Click Disconnect

5. A disconnect confirmation window will appear. Click Disconnect to confirm

After disconnecting:
- The connection between Telemedicall and Oracle EMR will be removed
- Patient data from Oracle will no longer be available in Telemedicall
- You can reconnect again later if needed
Fields (Field Descriptions)
| Field | Description | What happens when you use it |
|---|---|---|
| Public Key | A URL generated by Telemedicall | You copy it to Oracle to allow secure connection |
| EMR Label | A name for this connection | Helps you identify the connection later |
| Server Address | Your Oracle server URL | Required to connect to Oracle |
| Token | Access token from Oracle | Required to authenticate connection |
| Tenant ID (Hospital ID) | Your hospital or organization ID | Required to access Oracle records |
| Sandbox | Marks the server as an Oracle sandbox (test) server | Tick it only when you connect to a sandbox |
| Test Connection | Button to verify connection | Checks if your details are correct |
| Connect | Button to confirm connection | Links Telemedicall to Oracle |
Behavior & Expected Outcome
- The Test Connection button stays disabled until the required fields are filled
- EMR Label, Server Address, Token and Tenant ID are required fields
- After a successful test, Connect becomes available
- The Oracle patient list does not display automatically
- You must search using at least 3 letters from the patient name
- Search results appear after entering valid text
- Clicking a patient opens their Oracle medical information
- Connected patients show their Telemedicall name
- The Connect button changes to Disconnect after linking
- Disconnecting a patient asks for confirmation
Common Errors + Fixes
| Issue | Cause | Fix |
|---|---|---|
| Test Connection button is disabled | Required fields are empty | Enter EMR Label, Server Address, Token and Tenant ID |
| Connection test failed | Incorrect server, token or tenant ID | Check values and try again |
| Unable to connect | Oracle settings not configured | Add the Public Key to your Oracle server |
| Patient not linking | No Telemedicall patient selected | Select a patient and connect |
| No patients found | Less than 3 characters entered | Enter at least 3 letters in search |
| No data for a patient | The patient has no records in Oracle | Check the patient in Oracle |