Articles in this section

See more

Analytics Endpoint 'residents_followup_outstanding' Metric Pool

  • Updated

Returns a list of patients with outstanding followups - see Analytics Follow-up and Related Terminology for the definition of what a Patient with Outstanding Follow-up means

The metrics are calculated when residents_followup_outstanding is included in the metric_pool list for Analytics Endpoin. They are calculated per partition, via an invoked procedure ss_residents_followup_outstanding_metrics_for_partition.

Definitions are impacted by which residents are in the permissions of the license, user and site. Patient and mode are considered null. Currently, these metrics consider the start date metric to be null, and take into consideration all allowed data before the end date - so the date partition is (null, end date)

The logged-in user must have at least patient.read_only permission to view these metrics.

Metrics

Metric Key

Definition

Example

outstanding_followup_table

A JSON list of outstanding_followups objects (see definition below).

Each item in the list represents one Patient with Outstanding Follow-Up.

The list is ordered by:

  • highest pain_level

  • oldest assessment_date

  • first_name

  • last_name

  • birth_date

 
[
  {"last_name": "Testing", 
  "birth_date": "1940-01-02", 
  "first_name": "10-R11", 
  "pain_level": "severe", 
  "pain_score": 7, 
  "resident_id": "efc693a4-60f7-4962-ab6d-328cb021ec2c", 
  "assessment_date": "2022-02-24T01:04:41.927+00:00", 
  "assessment_mode": "nrs", 
  "days_outstanding": 4
  }, 
  ...
]

all_followups

The number of outstanding_followup_table records

16

mild_followups

The number of outstanding_followup_table records with pain_level = mild

11

moderate_followup

The number of outstanding_followup_table records with pain_level = moderate

4

severe_followups

The number of outstanding_followup_table records with pain_level = severe

NB: mild_followups + moderate_followup + severe_followups = all_followups

1

outstanding_followups Object

The outstanding_followups object has the following fields:

Field

Contents

Example

1

resident_id

patient uuid

4e14b432-a6fd-4407-88c4-1f59dd5ddb05

2

first_name

patient first_name

Nichole

3

last_name

patient last_name

Sanchez

4

birth_date

patient birth_date

1902-05-05

5

pain_level

last_assessment assessment_pain_level

mild

6

pain_score

last_assessment assessment_pain_score

7

7

assessment_mode

last assessment assessment_mode

2018-08-07T03:24:36.602+00:00

8

assessment_date

last assessment assessment_date

painchek

9

days_outstanding

the number of days since the last assessment till the end date

1301

Example

{
  "outstanding_followup_table": [
    {
    "last_name": "Testing", 
    "birth_date": "1940-01-02", 
    "first_name": "10-R11", 
    "pain_level": "severe", 
    "pain_score": 7, 
    "resident_id": "efc693a4-60f7-4962-ab6d-328cb021ec2c", 
    "assessment_date": "2022-02-24T01:04:41.927+00:00", 
    "assessment_mode": "nrs", 
    "days_outstanding": 4
    }, 
    {
    "last_name": "Iphone12", 
    "birth_date": "1945-12-17", 
    "first_name": "Test", 
    "pain_level": "moderate", 
    "pain_score": 12, 
    "resident_id": "cec0887f-4033-4e39-ae70-192033f0f3d2", 
    "assessment_date": "2021-02-06T00:52:38.978+00:00", 
    "assessment_mode": "painchek", 
    "days_outstanding": 387
    },
    ...
  ]
  "all_followups": 16
  "mild_followups": 11,
  "moderate_followup": 4,
  "severe_followups": 1
}

Related articles