Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Class Diagram

Patient Consent & ContactOpt out

Display

Demographics appear Consent information appears in the Settings Sharing page of the patient's record.

Please seethe manual for more information.

Mappings

Profile

 

HL7 API

FHIR API

(Customer boxes support full CRUD)

Web

Custom REST API

Facade (STU3)

Aggregated (R4)

Summary of interactions

Read

QRY A19

/Patient

Create

Sharing

/

users

v1/

self

consents/

users/myCarers
/users/myPatients
/v1/users/[userId]

forPatient/[patientId]

Read

 

/Consent

Sharing

/v1/

users/self/patients
/v2-beta/users/byNationalId/[nationalId]/[nationalIdType]

Write

ADT A28
ADT A31

/Patient/$process-message

Profile
Add carer

/v1/users

consents/byPatient/[patientId]

Update

 

 

Sharing

/v1/consents/forPatient/[patientId]

Delete

Entity:

Patient - Extends: User

Middle Names

String

Any middle names of the patient.

PID-5.3

Patient.name

Profile page

 

Address Line 1

String

First line of the address.

PID-11.1

Patient.address

Profile page

 

Address Line 2

String

Second line of the address.

PID-11.2

Patient.address

Profile page

 

City

String

The nearest city or town.

PID-11.3

Patient.address

Profile page

 

State

String

The state.

PID-11.4

Patient.address

Profile page

 

Country

String

The country.

PID-11.6

Patient.address

Profile page

 

Postal Code

String

The postal code.

PID-11.5

Patient.address

Profile page

 

Date of Birth

Local Date

Date of birth.

PID-7.1

Patient.birthDate

Profile page

 

Death Timestamp

Timestamp

When the patient died.

PID-29.1

Patient.deceased

 

Gender

Enum

This is the administrative gender of the patient.

  • UNKNOWN

  • MALE

  • FEMALE

  • INDETERMINATE

PID-8.1

Patient.gender

Profile page

 

Language

Enum

The primary language of the patient.

PID-15.1
PID-15.4

 

Language dropdown shown in the footer of every page.

 

Time Zone

Enum

The patient's current preferred time zone. This will be used to localise times within the web interface.

 

 

Profile page

 

Skype ID

String

How to contact the patient on Skype.

 

 

Profile page

 

Phone

String

The phone number of the patient.

PID-13.1
PID-14.1

Patient.telecom

Profile page

 

Status

Enum

The status of the patient.

PID-30.1

 

 

Registered

Boolean

Whether or not the patient has registered with PKB. If a patient is registered, they have the ability to log into their account.

 

 

 

Sharing Disabled

Boolean

Whether or not the patient has requested Sharing Disabled.

 

sharing-disabled

 

Access Frozen

Boolean

Whether or not access to this medical record has been frozen.

 

 

 

Entered Timestamp

Timestamp

Flexibly used, depending on the type of data. It is broadly intended to capture the timestamp when the information was entered into the originating system.

MSH-7

 

 

Persisted Timestamp

Timestamp

The timestamp when the information was persisted in PKB.

 

 

 

Entity: Contact

Type

Enum

  • EMAIL_ADDRESS

PID-13.2
PID-14.2

Patient.telecom

Value

String

The value of the contact information.

PID-13.1
PID-13.4
PID-14.1
PID-14.4

Patient.telecom

Profile page

Is Primary

Boolean

Indicates whether this is primary. For example, if a patient has several email addresses, exactly one must be designated as primary, and that will be the one that receives notifications from PKB.

Profile page

Is Confirmed

Boolean

Indicates whether the contact has been confirmed. For example, a patient must confirm they have access to an email address by clicking a link before it is confirmed as belonging to them.

Profile page

Consent Record

Public ID String

An ID for this Consent Record.

 

Consent.id

Not shown.

 

Aggregated ID String

Consent Records that have been exposed in the Aggregated FHIR endpoint will have this additional ID populated.

Not shown.

Legacy ID String

An ID for this Consent Record.

Not shown.

id

General Health Granted Boolean

Whether or not the patient has granted access to the general health portion of their medical record.

 

Consent.except

Shown.

generalHealthConsentGranted

Mental Health Granted Boolean

Whether or not the patient has granted access to the mental health portion of their medical record.

 

Consent.except

Shown.

mentalHealthConsentGranted

Sexual Health Granted Boolean

Whether or not the patient has granted access to the sexual health portion of their medical record.

 

Consent.except

Shown.

sexualHealthConsentGranted

Social Care Granted Boolean

Whether or not the patient has granted access to the social care portion of their medical record.

 

Consent.except

Shown.

socialCareConsentGranted

Discharged Boolean

Indicates whether the actor is currently providing care to the patient.

 

Consent.status

When true, the relevant entries are shown in the Past sharing section.

A patient can “discharge” themselves from individual professionals or carers, but only a professional can discharge a patient from a team.

 

Professional Edit Only Boolean

Indicates whether this Consent Record has been locked. See the manual on Paediatric Records for more information.

Shown.

Added Timestamp

When the Consent Record was first recorded.

Not shown.

Updated Timestamp

When the Consent Record was last updated.

Not shown.

 

HL7 API

FHIR API

(Customer boxes support full CRUD)

Web

Custom REST API

Facade (STU3)

Aggregated (R4)

Summary of interactions

Create

Read

Update

Delete

Entity: Consent Reason - Extends: Data Point

Event Text String

General Health Consent Granted Boolean

General Health Reason Code Enum

  • MIGRATED

  • CREATED_ACCOUNT

  • REFERRAL

  • POWER_OF_ATTORNEY

  • COURT_ORDER

  • EXPLICIT_CONSENT

  • DISCHARGE

  • SAFEGUARDING

  • PATIENT_OPT_OUT

  • EXPIRED

Patients are not required to provide a reason.

Once provided, the value is not shown.

generalHealthConsentGrantedReason

General Health Reason Text String

Patients are not required to provide a reason.

Once provided, the value is not shown.

generalHealthConsentGrantedReasonText

Mental Health Consent Granted Boolean

Mental Health Reason Code Enum

As for General Health Reason Code.

Patients are not required to provide a reason.

Once provided, the value is not shown.

mentalHealthConsentGrantedReason

Mental Health Reason Text String

Patients are not required to provide a reason.

Once provided, the value is not shown.

mentalHealthConsentGrantedReasonText

Sexual Health Consent Granted Boolean

Sexual Health Reason Code Enum

As for General Health Reason Code.

Patients are not required to provide a reason.

Once provided, the value is not shown.

sexualHealthConsentGrantedReason

Sexual Health Reason Text String

Patients are not required to provide a reason.

Once provided, the value is not shown.

sexualHealthConsentGrantedReasonText

Social Care Consent Granted Boolean

Social Care Reason Code Enum

As for General Health Reason Code.

Patients are not required to provide a reason.

Once provided, the value is not shown.

socialCareConsentGrantedReason

Social Care Reason Text String

Patients are not required to provide a reason.

Once provided, the value is not shown.

socialCareConsentGrantedReasonText

Professional Edit Only Boolean

Professional Edit Only Reason Text String

 

HL7 API

FHIR API

(Customer boxes support full CRUD)

Web

Custom REST API

Facade (STU3)

Aggregated (R4)

Summary of interactions

Create

Sharing

Read

Sharing

Update

Sharing

Delete

Entity: Consent Expiry Decision

ID String

An ID for this Consent Expiry Decision.

Patient Age Criterion Number

The age in years to which this decision applies.

Expires Boolean

Entered By Ref: [[User.Legacy User ID]]

Entered Date Timestamp

Consent Deleted At Timestamp

Reason String

Justification for why this decision was made.

 

HL7 API

FHIR API

(Customer boxes support full CRUD)

Web

Custom REST API

Facade (STU3)

Aggregated (R4)

Summary of interactions

Create

/v1/consents/additional/forPatient/[id]

Read

/v1/consents/additional/forPatient/[id]

Update

/v1/consents/additional/forPatient/[id]

Delete

Entity: Additional Consent

Option Enum

  • CONTACT_BY_EMAIL

  • CONTACT_BY_SMS

  • CONTACT_BY_POST

  • CONTACT_FOR_RESEARCH

  • SAMPLE_STORAGE

Shown.

Granted Boolean

Whether or not the patient has granted this option.

Shown.

 

HL7 API

FHIR API

(Customer boxes support full CRUD)

Web

Custom REST API

Facade (STU3)

Aggregated (R4)

Summary of interactions

Create

Disable sharing

Read

Disable sharing

Update

Disable sharing

Delete

Entity: Patient Opt Out Record

Public ID String

An ID for this Consent Record.

Aggregated ID String

Consent Records that have been exposed in the Aggregated FHIR endpoint will have this additional ID populated.

Sharing Enabled Boolean

Indicates whether or not the patient has enabled sharing. If the patient has not opted out then a Patient Opt Out Record might not exist. A patient who has opted out might change their mind and choose to opt in again.

 

HL7 API

FHIR API

(Customer boxes support full CRUD)

Web

Custom REST API

Facade (STU3)

Aggregated (R4)

Summary of interactions

Create

Disable sharing

Read

Disable sharing

Update

Disable sharing

Delete

Entity: Patient Opt Out Documentation - Extends: Data Point

Sharing Enabled Boolean

See [[Patient Opt Out Record.Sharing Enabled]]