Difference between revisions of "Patient Privacy Module"

From OpenEMR Project Wiki
m (final tweakage)
(huh- found I had already created this page so am putting new stuff in it.)
 
Line 1: Line 1:


= Introduction =
= Introduction =
'''''>> all the content's here, am just tweaking the layout. <<'''''


This Patient Privacy module controls which patient records are accessible to which staff users.
This Patient Privacy module controls which patient records are accessible to which staff users.


Any user of any ACL role, whether provider or non- clinician, may be 'attached' to a patient so they may view and edit their record. Users who are not attached to a patient may not.
Any user of any ACL role, whether provider or non- clinician, may be 'attached' to a patient so they can see that patient’s record. It is not that the patient is assigned to a staff.


One thing to point out is that this Patient Privacy module can be tricky to configure if you are making relationships more complex than 'Supervisor → Provider(s) → Patient(s)'.  However, once properly configured it does provide near- absolute isolation of a patient’s PII from unauthorized viewers.


Keep in mind the direction of the relationship: the staff/ user is attached to the patient so they can see that patient’s record. It is not that the patient is assigned to a staff.
In this document OpenEMR’s 'Patient Finder' tool is used to show a user's access permissions. In actual use, any display in which patient's PII appears would be regulated by this module. For example, if the logged in user was not attached to a patient that patient's appointment would be visible to the user on the calendar but their record could not be opened.
 
 
In this document OpenEMR’s 'Patient Finder' tool is used to show a user's access permissions. In actual use, any display in which patient's PII appears would be regulated by this module. For example, if the logged in user was not attached to a patient that patient's appointment would be visible to the user on the calendar but their record could not be opened.




Line 20: Line 17:




This wiki page is the online version of the user docs that are distributed by MI-Squared when you contact us about installing the module. NOTE: at the time of this writing the Patient Privacy module is not included in the released versions of OpenEMR. Please contact us at helpdesk@mi-squared.com to discuss installing it on your OpenEMR instance.
This wiki page is the online version of the user docs that are distributed by MI-Squared when you contact us about installing the module. NOTE: at the time of this writing the Patient Privacy module is not included in the released versions of OpenEMR. Please contact us at <nowiki>helpdesk@mi-squared helpdesk@mi-squared</nowiki> to discuss installing it on your OpenEMR instance.




Line 28: Line 25:


== Register Module ==
== Register Module ==
1. On the main menu, click 'Modules/ Manage Modules' (cursor arrow below)


:1. On the main menu, click 'Modules/ Manage Modules' (cursor arrow below)
* the module name will be somewhere in the list.


:* the module name will be somewhere in the list.




Line 39: Line 36:




:2. Click the 'Register' button at the right
2. Click the 'Register' button at the right
 
* the 'registered' tab will open with the module on it (below).


:* the 'registered' tab will open with the module on it (below).




3. Click 'Install' button at right (cursor arrow)


:3. Click 'Install' button at right (cursor arrow)




Line 51: Line 49:




:4. 'Install' button changes to 'Enable'; click it.
4. 'Install' button changes to 'Enable'; click it.




[[Image:PtPrivWiki03.png|top]]




[[Image:PtPrivWiki03.png]]




:* The button changes to 'Disable', which indicates the module is enabled.
* The button changes to 'Disable', which indicates the module is enabled.




[[Image:PtPrivWiki04.png]]
[[Image:PtPrivWiki04.png]]


 
5. Log out and back in (not pictured)
# Log out and back in (not pictured)




Line 77: Line 74:


The Patient Privacy module has four different approaches by which to attach a user to a patient:
The Patient Privacy module has four different approaches by which to attach a user to a patient:
:1. From the patient list
:* From the patient list
:2. From provider pick list
:* From provider pick list
:3. From the user/ staff roster
:* From the user/ staff roster
:4. From the list of ACL roles
:* From the list of ACL roles
 


And the user may be attached in one of two relationships:
And the user may be attached in one of two relationships:
:1. Direct access
:* Direct access
:2. As supervisor to the attached user
:* As supervisor to the attached user


These will be illustrated below.


On the main menu click 'Administration' then the new menu item, 'Patient Privacy'
[[Image:PtPrivWiki05.png]]


These will be illustrated below.








'''''Note:''''' A staff who is not allowed to view patient records can still select them for tasks that do not expose PII. For example, they can create an appointment for a patient on the calendar. But if they try to open the patient's record, they get a 'Demographics not authorized' message.




== From Patient List ==


The 'Patients' tab is active by default.


:1. Select a patient


[[Image:PtPrivWiki06.png]]


[[Image:PtPrivWiki17.png]]






:* The Provider Access panel appears showing default tab: Direct Access


[[Image:PtPrivWiki07.png|right]]
To begin:  


On the main menu click 'Administration' then the new menu item, 'Patient Privacy'


[[Image:PtPrivWiki05.png]]








== From Patient List ==


Under the heading, ‘Patient Privacy Settings’ the 'Patients' tab is active by default.




1. Click on the line containing the Patient’s identifiers




[[Image:PtPrivWiki06.png]]






:2. Select user(s) to attach to this patient* You may 'Ctrl+ click' to attach multiple users




Line 135: Line 131:




* The Provider Access panel appears showing default tab: ‘Direct Access’


[[Image:PtPrivWiki07.png]]




Line 143: Line 141:




2. Select user(s) to attach to this patient
* You may 'Ctrl+ click' to attach multiple users
* All selected users will be able to see all information in this patient’s record




:3. Click 'Save Changes'




 
3. Click 'Save Changes'
 
 
::OR -- instead of Direct Access click tab: Access via Supervisor




Line 159: Line 156:




OR – if the provider(s) have already been attached to their patients you may optionally assign Supervisor access to the Providers’ patients:




4. Click tab: ‘Access via Supervisor’




The Provider dropdown list will contain all the users that were attached in the previous step.
* CAUTION: The Supervisor dropdown list has '''''the complete list''''' of users, still containing all the users that were attached in the previous step. '''''Be careful to not assign a user as their own supervisor!'''''




The Supervisor dropdown list has '''''the complete list''''' of users.






5. Select the Supervisor




'''''Be VERY careful when setting supervisors and attaching users to patients.'''''
6. Select Provider


'''''See final 'Caution!' section of this document for details'''''


7. Click ‘+ Attach Supervisor’




8. Click ‘Save Changes’




Note in this example below that Provider Virginia Apgar has two different supervisors
9. Repeat from step 6 above to attach the supervisor to each of the providers they supervise.
* '''The Supervisor will then be able to access all the patients assigned to any of the providers they supervise.'''




[[Image:PtPrivWiki09.png|right|top]]


:* This shows that Dr Apgar has 'Direct Access' to Hornsby's record as Provider.
:* However, oreilley is Apgar's supervisor over this patient, so he can see Hornsby, in addition to any patients oreilley may be attached to himself.
:* And norman dogsbody is also Apgar's supervisor in regards to Hornsby's treatment, so HE can see Hornsby, too, along with his own.


::'''''Be VERY careful when setting supervisors and attaching users to patients.'''''


::'''''See final 'Caution!' section of this document for details'''''


As a variation of this, see in this example below that Provider Virginia Apgar has two different supervisors




[[Image:PtPrivWiki09.png]]




* This shows that Dr Apgar has 'Direct Access' as Provider to pt Hornsby's record.
* However, O’Reilley is Apgar's supervisor over this patient, so he can see Hornsby, in addition to any patients oreilley may be attached to himself.
* And norman dogsbody is also Apgar's supervisor in regards to Hornsby's treatment, so HE can see Hornsby, too, along with his own.




 
AND SO-- with this Patient Privacy configuration, when Dr Apgar logs in, Hornsby is the only patient she can see.
 
 
 
 
 
 
 
AND SO-- when Dr Apgar logs in, Hornsby is the only pt she can see.




Line 216: Line 212:




1. Select a Provider from the list.


[[Image:PtPrivWiki11.png|right|top]]
[[Image:PtPrivWiki11.png]]




:1. Select a user from the list.








* it will show the provider's current list of patients they're attached to (below).


[[Image:PtPrivWiki12.png]]




::'''''* Note: this panel shows only the patients that have been added with this panel.'''''


::'''''If the user is attached to a patient via the 'User' or 'Roles' tabs that patient will not appear here. But they all will be kept in the provider’s list.'''''


:* it will show the provider's current list of patients they're attached to (below).




2. Click 'Attach Patient' (oval above)


3. Enter partial patient name and select when full name appears (yes, sorry, this is a confusing demo patient name...).




::'''''* Note: this panel shows only the patients that have been added with this panel.'''''
::'''''If the user is attached to a patient via the 'User' or 'Roles' tabs that patient will not appear here.'''''
[[Image:PtPrivWiki12.png]]


[[Image:PtPrivWiki13.png]]
[[Image:PtPrivWiki13.png]]
Line 250: Line 242:




:2. Click 'Attach Patient' (oval above)
:3. Enter partial patient name and select when full name appears (sorry, this is a confusingly unusual demo patient name...).
:4. Click 'Save changes' to save changes.
::* Panel now displays the attached provider's list of patients (below)


[[Image:PtPrivWiki14.png|top]]


4. Click 'Save changes' to save changes.
* Panel now displays the attached provider's list of patients (below)




[[Image:PtPrivWiki14.png]]








:5. Click 'Attach Patient' again to add another patient.


5. Return to step 2, Click 'Attach Patient' to add another patient.




== From the User tab ==
== From the User tab ==
[[Image:PtPrivWiki15.png|right|top]]
This tab lists all users (not only providers) in all the roles they are assigned in their OpemEMR user profile.
It allows attaching one user as supervisor to another user in each of their roles.






[[Image:PtPrivWiki15.png]]






This tab lists all users (not only providers) with each of the roles they are assigned in their OpenEMR user profile.


It is designed for attaching one user as supervisor to another user in each of their Access Control roles.


* '''Use this method only if you are sure it is what you want!'''








1. Click on the user's name (here, Virginia Apgar)


[[Image:PtPrivWiki16.png]]
[[Image:PtPrivWiki16.png]]
Line 326: Line 282:




Click on the user's name (here, Virginia Apgar, listed in the previous panel) then select the supervisor for them in that role.
2. Select the supervisor for her in that role.




3. Click ‘Save Changes’




:'''''Bug alert - attaching a user as supervisor of another user in one role will attach them in all roles of the other user'''''
:* Now, after all that: '''''Bug alert - attaching a user as supervisor of another user in one role will attach them in all roles of the other user'''''
:* In effect it merely attaches one user as Supervisor over another, the same as doing it in the ‘Patient’ tab.






:Note: A staff who is not allowed to view patient records can still select them for such tasks as do not expose PII. For e.g., they can create an appointment for a patient on the calendar. But if they try to open the patient's record, they get a 'Demographics not authorized' message.


[[Image:PtPrivWiki17.png|top]]
== From the Roles tab ==


The Roles tab allows an Administrator to exclude any one or many ACL roles from the Patient Privacy module's access controls. Which therefore gives members of those roles full access to all patients' records.




[[Image:PtPrivWiki18.png]]


::'''''Note: by default, the Administrator ACL role sees all patients no matter what Patient Privacy settings a patient has.'''''




Line 347: Line 307:




== From the Roles tab ==


The Roles tab allows an Administrator to exclude any one or many ACL roles from the module's access controls. Which therefore gives members of those roles full access to all patients' records.
1. Click the ‘Roles’ tab


2. Select (or multi-select with Ctrl+click) the ACL roles that will be excluded from Patient Privacy restrictions


::'''''Note: by default, the Administrator ACL role sees all patients no matter what Patient Privacy settings a patient has.'''''
3. Click 'Save'


'''Example:'''


[[Image:PtPrivWiki19.png]]


Let’s say the logged- in user Walter OReilley’s User Profile has him in the ‘Front Office’ ACL role.




[[Image:PtPrivWiki18.png]]
[[Image:PtPrivWiki_ACL_FrontOffice.png]]




That ‘Front Office’ role was selected in step 2 above.


Select (or multi-select with Ctrl+click) the ACL roles which will be excluded from Patient Privacy restrictions.


Click 'Save'
That makes him allowed to see all patients.




[[Image:PtPrivWiki19.png]]


Walter OReilley is in the Front Office ACL role, selected in the previous picture.


That allows him to see all patients.
BUT-- the User Profile of 'htuck' has him as a clinician.




[[Image:PtPrivWiki_ACL_Clinician.png]]


User 'htuck' is a clinician who is not attached to any patients or assigned as a supervisor to any user.
He is not attached to any patients or assigned as a supervisor to any user.


He can't see anything.
He can't see anything.
[[Image:PtPrivWiki20.png]]




[[Image:PtPrivWiki20.png]]


= Deactivate the Module =
= Deactivate the Module =


The Patient Privacy module may be inactivated at any time without affecting any PII.
The Patient Privacy module may be inactivated at any time without affecting any PII.
:1. The EMR Administrator simply goes back to Manage Modules (Main menu: Modules/ Manage Modules) screen
1. The EMR Administrator simply goes back to Manage Modules (Main menu: Modules/ Manage Modules) screen
:2. Clicks the 'Disable' button
2. Clicks the 'Disable' button...






[[Image:PtPrivWiki21.png|right|top]]
[[Image:PtPrivWiki21.png]]
:3. and it will be disabled.




3...and it will be disabled.




Line 401: Line 364:


[[Image:PtPrivWiki22.png]]
[[Image:PtPrivWiki22.png]]
:4. Log out of the EMR and back in again to finalize the deactivation and remove the Patient Privacy main menu item.
 
4.Log out of the EMR and back in again to finalize the deactivation and remove the Patient Privacy main menu item.






And... that poor user htuck who couldn't see any patients before, is back to full patient roster viewing capabilities.


[[Image:PtPrivWiki23.png|top]]
And... that poor user htuck who couldn't see any patients before, is back to full and complete patient roster viewing permissions.


[[Image:PtPrivWiki23.png]]




= Caution! =
= Caution! =


This module works purely with what it is given by the Administrator configuring the attachments. It has no logic checking so it is easy to set up conflicting access permissions.
This module works purely with what it is given by the Administrator configuring the attachments. It has no logic checking so it is easy to set up conflicting access relationships.
::* '''''This module will allow having user1 as supervisor to user2 on one patient, then user2 as supervisor to user1 for another patient.'''''
* '''''This module will allow making user1 the supervisor to user2 on one patient, then user2 as supervisor to user1 for another patient.'''''
::* '''''It will allow accidentally setting a user as their own supervisor'''''
* '''''It will allow accidentally setting a user as their own supervisor'''''
::* '''''It will allow very complex relationships between attached users, which may defeat the intended access barriers.'''''
* '''''It will allow very complex relationships between attached users, which may defeat the intended access barriers.'''''


:'''''Suggestion: diagram the user/ supervisor relationships before configuring them.'''''
'''''Suggestion: diagram the user/ supervisor relationships before configuring them.'''''

Latest revision as of 21:47, 25 October 2024

Introduction

This Patient Privacy module controls which patient records are accessible to which staff users.

Any user of any ACL role, whether provider or non- clinician, may be 'attached' to a patient so they can see that patient’s record. It is not that the patient is assigned to a staff.

One thing to point out is that this Patient Privacy module can be tricky to configure if you are making relationships more complex than 'Supervisor → Provider(s) → Patient(s)'. However, once properly configured it does provide near- absolute isolation of a patient’s PII from unauthorized viewers.

In this document OpenEMR’s 'Patient Finder' tool is used to show a user's access permissions. In actual use, any display in which patient's PII appears would be regulated by this module. For example, if the logged in user was not attached to a patient that patient's appointment would be visible to the user on the calendar but their record could not be opened.


If used, this module will affect the entire patient roster. It is best to make the configuration of this module part of the setup of a practice, and assigning a provider to a new patient a formal part of the new patient admitting process. However, if this module is being incorporated into an existing practice, once the supervision relationships are created (see below) it might be useful to have a user with Administrator ACL go through the practice calendar’s appointments for the next day and assign providers to each patient. But that’s just one idea how to implement it.


One handy thing: if the Patient Privacy module is ever disabled, it may be re-enabled again, and all the previous user attachment settings will return as they were at last use.


This wiki page is the online version of the user docs that are distributed by MI-Squared when you contact us about installing the module. NOTE: at the time of this writing the Patient Privacy module is not included in the released versions of OpenEMR. Please contact us at helpdesk@mi-squared helpdesk@mi-squared to discuss installing it on your OpenEMR instance.


Activate the Module

Once installed into your OpenEMR an Administrator- privileged user needs to register the module with the system to activate it.

Register Module

1. On the main menu, click 'Modules/ Manage Modules' (cursor arrow below)

  • the module name will be somewhere in the list.


PtPrivWiki01.png



2. Click the 'Register' button at the right

  • the 'registered' tab will open with the module on it (below).


3. Click 'Install' button at right (cursor arrow)


PtPrivWiki02.png


4. 'Install' button changes to 'Enable'; click it.



PtPrivWiki03.png


  • The button changes to 'Disable', which indicates the module is enabled.


PtPrivWiki04.png

5. Log out and back in (not pictured)



The module is registered.


Attach Users

The Patient Privacy module has four different approaches by which to attach a user to a patient:

  • From the patient list
  • From provider pick list
  • From the user/ staff roster
  • From the list of ACL roles


And the user may be attached in one of two relationships:

  • Direct access
  • As supervisor to the attached user


These will be illustrated below.



Note: A staff who is not allowed to view patient records can still select them for tasks that do not expose PII. For example, they can create an appointment for a patient on the calendar. But if they try to open the patient's record, they get a 'Demographics not authorized' message.




PtPrivWiki17.png



To begin:

On the main menu click 'Administration' then the new menu item, 'Patient Privacy'

PtPrivWiki05.png



From Patient List

Under the heading, ‘Patient Privacy Settings’ the 'Patients' tab is active by default.


1. Click on the line containing the Patient’s identifiers


PtPrivWiki06.png






  • The Provider Access panel appears showing default tab: ‘Direct Access’

PtPrivWiki07.png




2. Select user(s) to attach to this patient

  • You may 'Ctrl+ click' to attach multiple users
  • All selected users will be able to see all information in this patient’s record



3. Click 'Save Changes'


PtPrivWiki08.png



OR – if the provider(s) have already been attached to their patients you may optionally assign Supervisor access to the Providers’ patients:


4. Click tab: ‘Access via Supervisor’


  • CAUTION: The Supervisor dropdown list has the complete list of users, still containing all the users that were attached in the previous step. Be careful to not assign a user as their own supervisor!



5. Select the Supervisor


6. Select Provider


7. Click ‘+ Attach Supervisor’


8. Click ‘Save Changes’


9. Repeat from step 6 above to attach the supervisor to each of the providers they supervise.

  • The Supervisor will then be able to access all the patients assigned to any of the providers they supervise.



Be VERY careful when setting supervisors and attaching users to patients.
See final 'Caution!' section of this document for details

As a variation of this, see in this example below that Provider Virginia Apgar has two different supervisors


PtPrivWiki09.png


  • This shows that Dr Apgar has 'Direct Access' as Provider to pt Hornsby's record.
  • However, O’Reilley is Apgar's supervisor over this patient, so he can see Hornsby, in addition to any patients oreilley may be attached to himself.
  • And norman dogsbody is also Apgar's supervisor in regards to Hornsby's treatment, so HE can see Hornsby, too, along with his own.


AND SO-- with this Patient Privacy configuration, when Dr Apgar logs in, Hornsby is the only patient she can see.


PtPrivWiki10.png


From Provider Pick List

A slightly quicker method to attach users to patients is to use the provider pick list found on the initial User Patient Permissions tab. This would be a handy way to attach a provider to all their patients in one sitting.


1. Select a Provider from the list.

PtPrivWiki11.png




  • it will show the provider's current list of patients they're attached to (below).

PtPrivWiki12.png


* Note: this panel shows only the patients that have been added with this panel.
If the user is attached to a patient via the 'User' or 'Roles' tabs that patient will not appear here. But they all will be kept in the provider’s list.


2. Click 'Attach Patient' (oval above)

3. Enter partial patient name and select when full name appears (yes, sorry, this is a confusing demo patient name...).


PtPrivWiki13.png



4. Click 'Save changes' to save changes.

  • Panel now displays the attached provider's list of patients (below)


PtPrivWiki14.png



5. Return to step 2, Click 'Attach Patient' to add another patient.


From the User tab

PtPrivWiki15.png


This tab lists all users (not only providers) with each of the roles they are assigned in their OpenEMR user profile.

It is designed for attaching one user as supervisor to another user in each of their Access Control roles.

  • Use this method only if you are sure it is what you want!



1. Click on the user's name (here, Virginia Apgar)

PtPrivWiki16.png



2. Select the supervisor for her in that role.


3. Click ‘Save Changes’


  • Now, after all that: Bug alert - attaching a user as supervisor of another user in one role will attach them in all roles of the other user
  • In effect it merely attaches one user as Supervisor over another, the same as doing it in the ‘Patient’ tab.



From the Roles tab

The Roles tab allows an Administrator to exclude any one or many ACL roles from the Patient Privacy module's access controls. Which therefore gives members of those roles full access to all patients' records.


PtPrivWiki18.png

Note: by default, the Administrator ACL role sees all patients no matter what Patient Privacy settings a patient has.




1. Click the ‘Roles’ tab

2. Select (or multi-select with Ctrl+click) the ACL roles that will be excluded from Patient Privacy restrictions

3. Click 'Save'

Example:

PtPrivWiki19.png

Let’s say the logged- in user Walter OReilley’s User Profile has him in the ‘Front Office’ ACL role.


PtPrivWiki ACL FrontOffice.png


That ‘Front Office’ role was selected in step 2 above.


That makes him allowed to see all patients.



BUT-- the User Profile of 'htuck' has him as a clinician.


PtPrivWiki ACL Clinician.png

He is not attached to any patients or assigned as a supervisor to any user.

He can't see anything.

PtPrivWiki20.png


Deactivate the Module

The Patient Privacy module may be inactivated at any time without affecting any PII. 1. The EMR Administrator simply goes back to Manage Modules (Main menu: Modules/ Manage Modules) screen 2. Clicks the 'Disable' button...


PtPrivWiki21.png


3...and it will be disabled.




PtPrivWiki22.png

4.Log out of the EMR and back in again to finalize the deactivation and remove the Patient Privacy main menu item.



And... that poor user htuck who couldn't see any patients before, is back to full and complete patient roster viewing permissions.

PtPrivWiki23.png


Caution!

This module works purely with what it is given by the Administrator configuring the attachments. It has no logic checking so it is easy to set up conflicting access relationships.

  • This module will allow making user1 the supervisor to user2 on one patient, then user2 as supervisor to user1 for another patient.
  • It will allow accidentally setting a user as their own supervisor
  • It will allow very complex relationships between attached users, which may defeat the intended access barriers.

Suggestion: diagram the user/ supervisor relationships before configuring them.