NHS e-referral Service

Size: px

Start display at page:

Download "NHS e-referral Service"

Toby Edwards
5 years ago
Views:

The Health and Social Care Information Centre is a

1 Extracting Advice and Guidance data Published July 2017 Copyright 2016 Health and Social Care Information Centre. The Health and Social Care Information Centre is a non-departmental body created by statute, also known as NHS Digital.

2 Contents Introduction 3 Where to find information? 3 Extracting information 3 1. Advice Requests Created 3 2. Advice Responses 3 3. Bookings How do I calculate the number of working days? 4 What else should I be aware of? 7 Copyright 2016 Health and Social Care Information Centre. 2

3 Introduction This guide has been developed for Information Analysts to extract Advice and Guidance information to support the requirements detailed within the NHS e-referral Service CQUIN (Commissioning for Quality and Innovation) - see section 7. A number of coding strings are detailed within this document which can be copied and pasted into a database that will provide a list of all e-referral Service requests made, and any subsequent response or bookings. Where to find information? The data required is held within the EbsX02 which can be downloaded from within NHS e- Referral Service from the Extracts tab. You must be logged into the e-referral Service as an Information Analyst to view this extract. Extracting information Open the Ebsx02 and import Ebsx02 into a database. 1. Advice Requests Created Create tables for action_cds by copying the following code: SELECT Ebsx02.UBRN_ID, Ebsx02.SPECIALTY_CD, Ebsx02.PRIORITY_CD, Ebsx02.REFERRING_ORG_ID, Ebsx02.PATIENT_ID, Ebsx02.ACTION_ID, DateValue(Mid([Ebsx02]![ACTION_DT_TM],7,2) & "-" & Mid([Ebsx02]![ACTION_DT_TM],5,2) & "-" & Left([Ebsx02]![ACTION_DT_TM],4)) AS Request_Date, TimeValue(Mid([Ebsx02]![ACTION_DT_TM],9,2) & ":" & Mid([Ebsx02]![ACTION_DT_TM],11,2) & ":" & Right([Ebsx02]![ACTION_DT_TM],2)) AS Request_Time, Ebsx02.ACTION_CD, Ebsx02.BUS_FUNCTION_CD, Ebsx02.ACTION_REASON_CD, Ebsx02.SERVICE_ID, Ebsx02.UBRN INTO Advice_Requests_Created FROM Ebsx02 WHERE (((Ebsx02.ACTION_CD)="1407")); 2. Advice Responses Create tables for action_cds by copying the following code: SELECT Ebsx02.UBRN_ID, Ebsx02.SPECIALTY_CD, Ebsx02.PRIORITY_CD, Ebsx02.REFERRING_ORG_ID, Ebsx02.PATIENT_ID, Ebsx02.ACTION_ID, DateValue(Mid([Ebsx02]![ACTION_DT_TM],7,2) & "-" & Mid([Ebsx02]![ACTION_DT_TM],5,2) & "-" & Left([Ebsx02]![ACTION_DT_TM],4)) AS Response_Date, TimeValue(Mid([Ebsx02]![ACTION_DT_TM],9,2) & ":" & Mid([Ebsx02]![ACTION_DT_TM],11,2) & ":" & Right([Ebsx02]![ACTION_DT_TM],2)) AS Response_Time, Ebsx02.ACTION_CD, Ebsx02.BUS_FUNCTION_CD, Copyright 2016 Health and Social Care Information Centre. 3

4 Ebsx02.ACTION_REASON_CD, Ebsx02.SERVICE_ID, Ebsx02.UBRN INTO Advice_Responses FROM Ebsx02 WHERE (((Ebsx02.ACTION_CD)="1408")); 3. Bookings Create tables for action_cds by copying the following code: SELECT Ebsx02.UBRN_ID, Ebsx02.SPECIALTY_CD, Ebsx02.PRIORITY_CD, Ebsx02.REFERRING_ORG_ID, Ebsx02.PATIENT_ID, Ebsx02.ACTION_ID, DateValue(Mid([Ebsx02]![ACTION_DT_TM],7,2) & "-" & Mid([Ebsx02]![ACTION_DT_TM],5,2) & "-" & Left([Ebsx02]![ACTION_DT_TM],4)) AS Booking_Date, TimeValue(Mid([Ebsx02]![ACTION_DT_TM],9,2) & ":" & Mid([Ebsx02]![ACTION_DT_TM],11,2) & ":" & Right([Ebsx02]![ACTION_DT_TM],2)) AS Booking_Time, Ebsx02.ACTION_CD, Ebsx02.BUS_FUNCTION_CD, Ebsx02.ACTION_REASON_CD, Ebsx02.SERVICE_ID, Ebsx02.UBRN INTO Bookings FROM Ebsx02 WHERE (((Ebsx02.ACTION_CD)="1412")); Create the following query to list the advice requests with any response and/ or bookings: SELECT Advice_Requests_Created.UBRN_ID, Advice_Requests_Created.Request_Date, Advice_Requests_Created.Request_Time, Advice_Requests_Created.ACTION_ID, Advice_Responses.Response_Date, Advice_Responses.Response_Time, Advice_Responses.ACTION_ID, Bookings.Booking_Date, Bookings.Booking_Time, Bookings.ACTION_ID, Bookings.SERVICE_ID, Bookings.SPECIALTY_CD FROM (Advice_Requests_Created LEFT JOIN Advice_Responses ON Advice_Requests_Created.UBRN_ID = Advice_Responses.UBRN_ID) LEFT JOIN Bookings ON Advice_Requests_Created.UBRN_ID = Bookings.UBRN_ID WHERE (((IIf([Advice_Responses]![ACTION_ID]<[Advice_Requests_Created]![ACTION_ID],"exclude","include"))="include")) ORDER BY Advice_Requests_Created.UBRN_ID, Advice_Requests_Created.ACTION_ID, Advice_Responses.ACTION_ID;- Note: The service_id and Specialty fields can be linked to Ebsx03 and Ebsx05 to get more information about the provider How do I calculate the number of working days? Using MS Excel To work out the number of working days between request, response and booking, export the results into excel and use the NETWORKDAYS function. Using Visual Basic Creating functions within Visual Basic will calculate the number of working days. How do I do this? Copyright 2016 Health and Social Care Information Centre. 4

5 Instead of running the query in section 3.3 above, create a table called holidays and in it include a Holiday column that stores the date on which each holiday occurs. Include one row for each holiday that occurs on a weekday. To create the user defined function: 1. On the Microsoft Office Ribbon, click Database Tools. 2. On the Macro tab, click Visual Basic. 3. On the Insert menu, click Module. 4. At the top of the module, type the following two lines, if they are not already there. Option Compare Database Option Explicit 5. Type or copy following the Workdays and Weekdays functions: Public Function Workdays(ByRef startdate As Date, _ ByRef enddate As Date, _ Optional ByRef strholidays As String = "Holidays" _ ) As Integer ' Returns the number of workdays between startdate ' and enddate inclusive. Workdays excludes weekends and ' holidays. Optionally, pass this function the name of a table ' or query as the third argument. If you don't the default ' is "Holidays". On Error GoTo Workdays_Error Dim nweekdays As Integer Dim nholidays As Integer Dim strwhere As String ' DateValue returns the date part only. startdate = DateValue(startDate) enddate = DateValue(endDate) nweekdays = Weekdays(startDate, enddate) If nweekdays = -1 Then Workdays = -1 GoTo Workdays_Exit End If strwhere = "[Holiday] >= #" & startdate _ & "# AND [Holiday] <= #" & enddate & "#" ' Count the number of holidays. nholidays = DCount(Expr:="[Holiday]", _ Domain:=strHolidays, _ Criteria:=strWhere) Workdays = nweekdays - nholidays Workdays_Exit: Exit Function Workdays_Error: Workdays = -1 MsgBox "Error " & Err.Number & ": " & Err.Description, _ Copyright 2016 Health and Social Care Information Centre. 5

6 vbcritical, "Workdays" Resume Workdays_Exit End Function Public Function Weekdays(ByRef startdate As Date, _ ByRef enddate As Date _ ) As Integer ' Returns the number of weekdays in the period from startdate ' to enddate inclusive. Returns -1 if an error occurs. ' If your weekend days do not include Saturday and Sunday and ' do not total two per week in number, this function will ' require modification. On Error GoTo Weekdays_Error ' The number of weekend days per week. Const ncnumberofweekenddays As Integer = 2 ' The number of days inclusive. Dim vardays As Variant ' The number of weekend days. Dim varweekenddays As Variant ' Temporary storage for datetime. Dim dtmx As Date ' If the end date is earlier, swap the dates. If enddate < startdate Then dtmx = startdate startdate = enddate enddate = dtmx End If ' Calculate the number of days inclusive (+ 1 is to add back startdate). vardays = DateDiff(Interval:="d", _ date1:=startdate, _ date2:=enddate) + 1 ' Calculate the number of weekend days. varweekenddays = (DateDiff(Interval:="ww", _ date1:=startdate, _ date2:=enddate) _ * ncnumberofweekenddays) _ + IIf(DatePart(Interval:="w", _ Date:=startDate) = vbsunday, 1, 0) _ + IIf(DatePart(Interval:="w", _ Date:=endDate) = vbsaturday, 1, 0) ' Calculate the number of weekdays. Weekdays = (vardays - varweekenddays) Weekdays_Exit: Copyright 2016 Health and Social Care Information Centre. 6

7 Exit Function Weekdays_Error: Weekdays = -1 MsgBox "Error " & Err.Number & ": " & Err.Description, _ vbcritical, "Weekdays" Resume Weekdays_Exit End Function 6. On the File menu, click Save. 7. Type a module name, such as Working Days, and then press ENTER. 8. On the Debug menu, click Compile. 9. On the File menu, click Close and Return to MS Access. Create the following query to calculate the number of working days between responses and requests, and bookings and responses: SELECT Advice_Requests_Created.UBRN_ID, Advice_Requests_Created.Request_Date, Advice_Requests_Created.Request_Time, Advice_Requests_Created.ACTION_ID, Advice_Responses.Response_Date, Advice_Responses.Response_Time, Advice_Responses.ACTION_ID, Bookings.Booking_Date, Bookings.Booking_Time, Bookings.ACTION_ID, Bookings.SERVICE_ID, Bookings.SPECIALTY_CD, IIf([Response_Date] Is Null,"-",Weekdays([Request_Date],[Response_Date])) AS [Working Days Between Request and Response], IIf([Booking_Date] Is Null Or [Response_Date] Is Null,"-",Weekdays([Response_Date],[Booking_Date])) AS [Working Days Between Response and Booking] FROM (Advice_Requests_Created LEFT JOIN Advice_Responses ON Advice_Requests_Created.UBRN_ID = Advice_Responses.UBRN_ID) LEFT JOIN Bookings ON Advice_Requests_Created.UBRN_ID = Bookings.UBRN_ID WHERE (((IIf([Advice_Responses]![ACTION_ID]<[Advice_Requests_Created]![ACTION_ID],"exclude","include"))="include")) ORDER BY Advice_Requests_Created.UBRN_ID, Advice_Requests_Created.ACTION_ID, Advice_Responses.ACTION_ID; Further guidance on Working Days and User Defined functions can be found here: What else should I be aware of? Please note that where multiple requests and responses have been sent or received, these are all linked to the same UBRN. The action_id should be used to determine the order in which the requests/ responses took place. Copyright 2016 Health and Social Care Information Centre. 7

NHS e-referral Service

NHS e-referral Service Translating Extracts Published June 2017 Copyright 2016 Health and Social Care Information Centre. The Health and Social Care Information Centre is a non-departmental body created by statute, also known