User Views

From TMS Support Wiki
Revision as of 15:05, 24 June 2024 by Shieldstromme (talk | contribs) (→‎Troubleshooting)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

User views, sometimes known as homepages, are how users and pharmacies can view and interact with the live prescription data flowing through PTS and are the primary viewpoint into your system data. Whether it be the pharmacy homepages, the ward views, outpatient collection status screen or the mobile app; all are customised user views.

This page discusses how user views are created. See the User Views & Homepages page for more information on user views.

Accessing the setup page

Like many of the different PTS utilities, setup is found in the left-hand side bar.

Hover over the sidebar with the mouse cursor and the side bar will expand. Select Setup to reveal a drop-down list of the various setup pages you have permission to access.

To choose a setup page click on its name in the list to be taken to the setup page.

PTS 5 is the most user configurable version of our Prescription Tracking System to date. As a result parts of this Wiki assumes that the reader has permission to access the elements of the system in question. If you don't see specific items and utilities where they are supposed to be you may not have permission to access them.

Adding new user views

To create a new user view access the actions menu by clicking on the actions menu icon at the top right of the page, then from the actions menu click the New User View button.

Click OK when you're done. The process then continues in the user view popup.

Editing existing user views

To edit an existing user view, select the user view you wish to amend by clicking on its entry in the list to load the user view popup.

User view setup in older versions of PTS

The user views tab in PTS 5.0.0.0 - PTS 5.0.5.0. This screenshot is via the roles popup on the roles setup page, but the tab looks and works the same in the user setup page.

In older versions of PTS, user views did not have their own setup page, and were instead created directly on the Users and Roles setup pages. This is in contrast to later versions where user views have their own setup page and are created, edited and assigned centrally from there.

No matter where the user view is created from the process is broadly the same.

From the Roles setup page

This is ideal for designing a user view that should be used by a wide number of users, such as internal views for all pharmacy staff.

From the Roles setup page, click on the applicable role in the list, and then from the role popup, click on the User Views tab.

Click the edit button EditButton.png next to a user view to modify it, click the delete button MinusButton.png to remove it, or click the add button PlusButton.png to create a new one.

From the Users setup page

For creating or amending user views for an individual user.

From the Users setup page, click on the applicable user in the list, and then from the user popup, click on the User Views tab.

Click the edit button EditButton.png next to a user view to modify it, click the delete button MinusButton.png to remove it, or click the add button PlusButton.png to create a new one.

User view popup

Whether creating a new user view or editing an existing one, and no matter which version of PTS you're using, the process plays out in the same way in the user view popup.

Details tab

The details tab in the user view popup.
An example of the on-screen scanner type of user view.
An example of the dispensary display type of user view.
An example of the outpatient display type of user view.
An example of the report(s) view type of user view.
  • Description
    The name of the user view.
  • Default
    If a user view is marked as the default view, then it will be the view that is initially displayed when the user logs in to PTS.
  • Index
    Specify the position on the menu that the user view appears, allowing you to re-order them.
  • Refresh Interval
    The maximum amount of time between user view refreshes. PTS 5 is a real time application and for the most part any relevant activity will be reflected immediately on the user view. However if there is no such activity, the user view will refresh according to this setting in order for certain important fields such as turnaround times, progress bars and reports to be kept up to date. There should never be any need for this to be under 60 seconds.
  • Progress bar style
    The options for this setting are as follows (be advised "RAG" refers to "red, amber, green"):
    1. RAG progress bar
      A progress bar fills up from left to right as the prescription approaches its target time according to the prescription type. The bar starts green and turns amber as it approaches the target and finally turns red if the prescription misses its target.
    2. RAG solid background
      Uses the same red, amber and green colours as the RAG progress bar, however the background is solid and not a growing progress bar. This is sometimes a necessary alternative for accessibility reasons.
    3. Activity progress bar
      A progress bar fills up from left to right as the prescription approaches its target time according to the prescription type. The bar takes the colour of the colour assigned to the activity, with a border that uses the familiar RAG colours from the first two options.
    4. Activity solid background
      Uses the same colour scheme as the activity progress bar, however the background is solid and not a growing progress bar. This is sometimes a necessary alternative for accessibility reasons.
  • Show Related Batches
    Relates to Aseptics.
  • Show Prescription Id’s
    Whether prescription IDs are shown on the user view. Ticket numbers will still be displayed. For the most part it is best to leave this setting turned on.
  • Show RX / Item Stats
    Applies to Dispensary Display type user views and determines whether prescription and item statistics appear at the top of the user view.
  • Display Average Wait
    Applies to Outpatient Display type user views and determines whether the current average wait time is displayed at the top of the user view.
  • Reports
    Applies to Report type user views and determines which reports are displayed.
  • Type of View
    Depending on the primary purpose of the user view you can select the most appropriate Type from the following options:
    1. Standard View
      The standard type of user view as broadly described on the User Views & Homepages page.
    2. On-screen scanner
      A compact version of the standard view where groups are collapsed by default. You can perform the various prescription actions (such as recording the next activity or a note) directly from the list without having to open a separate prescription details popup. Ideal for small screen devices, views that encompass a lot of data, or for when the primary purpose is to quickly perform prescription actions on-screen.
    3. Dispensary Display
      This view is designed to be displayed on a dedicated large screen in the dispensary. This gives staff an opportunity to manage the dispensary at a glance. The optional summary statistics shows the number of prescriptions that are on target, approaching and exceeding their target time. See Launching Display Screens for a technical guide on how to display the screen automatically.
    4. Outpatient Display
      Sometimes known as the "Argos screen", this view is designed to be displayed on a dedicated screen in the outpatients waiting area, or in fact anywhere where your patients may be waiting. By definition it typically shows outpatient prescriptions but it can show any type of prescription just like the other types of user view. In addition, video and messages can be displayed on this screen. See Launching Display Screens for a technical guide on how to display the screen automatically.
    5. Delivery Display
      This view is designed to be displayed on a dedicated screen for the benefit of your porters and is intended to display prescriptions as they go through the delivery process.
    6. Report(s) View
      This view is designed to display live versions of your reports. By designing reports as a user view you can rapidly generate and view any reports that need to be produced on a regular basis, or that provide a useful overview of your dispensary status.
    7. Mobile App Screen
      This type of view is used when the user logs in via the PTS mobile app for iOS and Android. Views of any other type are not displayed on the mobile app.
    8. Delivery Manifests
      Delivery Manifests are not actually a specific type of user view - rather they are the way that Mobile App views are made available as optional printable manifests when accessed via the main PTS application. Note in earlier versions of PTS, the user view must be grouped by bag, and the bags must have a bag "type" specified in the Bags setup page to work properly (failure to do so may result in a "cannot find table 0" error).

Filters tab

The filters tab is where you define which prescriptions are returned and displayed by the user view.

The filters tab. This example is being configured to return prescriptions for the default dispensary, with incomplete or suspended status, that were booked in within the last thirty days.


Filter sets

Each user view is comprised of one or more filter sets. This is where you can define the characteristics that a prescription must meet to be displayed by the user view, or to put it another way, how you filter out any prescriptions that you do not want displayed in the user view.

Prescriptions must match all of the filter criteria within a filter set to be selected by that filter set. By adding more filters to the filter set you continually reduce the sample of prescriptions and can focus the data to the specific requirements of the user view.

Adding and removing filters

Adding a filter. There are many different filter types to choose from.
Having chosen a filter to add, you will then be prompted to enter the desired value for the filter. In this example a ward filter has been chosen and the user is prompted to select which wards should be included.

Click the Add button PlusButton.png to add a new filter. You will then be able to choose the filter you want to add from a popup.

The available filters are as follows:

  • % of delivery target
  • % of target
  • Activity
  • Bag
  • Bagged
  • Cancellation recorded date
  • Cancellation recorded?
  • Cancellations
  • Cancelled
  • Cancelled by
  • Collected
  • Collected by
  • Collected day of week
  • Collected time
  • Collection note recorded date
  • Collection note recorded?
  • Collection notes
  • Completed
  • Completed by
  • Completed day of week
  • Completed time
  • Current ward
  • Delivered
  • Delivered by
  • Delivered day of week
  • Delivered time
  • Delivery note recorded date
  • Delivery note recorded?
  • Delivery notes
  • Dispensary
  • Drugs
  • Duration (mins) from time collected to time delivered
  • Duration (mins) from time completed to time collected
  • Duration (mins) from time requested to time started
  • Duration (mins) from time started to time completed
  • Error recorded date
  • Error recorded?
  • Errors
  • Hospital No.
  • NHS No.
  • No. of Items
  • No. of Items Dispensed
  • Normal note recorded date
  • Normal note recorded?
  • Normal notes
  • Notes text contains
  • Orig. ward
  • Patient D.O.B.
  • Patient Gender
  • Patient Name
  • Prescription ID
  • Prescription type
  • Printer
  • RAG status
  • Requested
  • Requested day of week
  • Requested time
  • Started
  • Started by
  • Started day of week
  • Started time
  • Status
  • Suspend Duration (mins)
  • Suspension recorded date
  • Suspension recorded?
  • Suspensions
  • System note recorded date
  • System note recorded?
  • System notes
  • Target comp. time
  • Target del. time
  • Ticket no.
  • Ward Group

After choosing the filter from the list you will then be prompted to input the desired value/s for that filter. For example, selecting the Ward filter will have you select the appropriate wards from a list, and choosing Started will have you enter a date range ("Started" referring to the date and time a prescription was started).

To remove an existing filter, click the delete button MinusButton.png that appears next to it.

Multiple filter sets

Completed filter sets based on the outpatient screen example described in this section.

As discussed you can add many filters as you like to a filter set. By adding more filters to a filter set you add more criteria that a prescription must meet to be displayed and therefore refine the data further and (in all likelihood) make the sample smaller with each additional filter.

However there are occasions where you would want a user view to combine multiple sets of data. A particularly good example is an outpatients display screen; it goes without saying you probably want to include incomplete or waiting for collection prescriptions, but you may also want to include prescriptions that were suspended or cancelled recently (e.g. up to 45 minutes ago) to give patients a chance to notice the change to their prescription. In addition, as many Trusts do not manually record collection, they may prefer to display completed prescriptions for a certain amount of time before letting them disappear from the screen naturally. These ideas conflict with each other as they rely on different uses of the Status filter, yet we would like them all to appear on the same user view.

To achieve this you should make use of additional filter sets. When multiple filter sets are employed, a prescription can meet the criteria of any of the filter sets to be considered a match and be displayed in the user view.

To add a new filter set, click the AddFilterSetButton.png button.

A new, blank filter set will be added which you can then build using the same tools. Filter sets operate independently of each other and a prescription need only match the criteria of one filter set to be returned by the user view.

For the technically minded, imagine that the individual filters are conditioned with an AND, which are parenthesised to form the filter set, and then combined with any other filter sets with an OR.

Troubleshooting

It is easy to misunderstand when and when not to use multiple filter sets.

To summarise the above, each additional filter within a single filter set reduces the sample size. By adding an additional filter set you can include a secondary, completely unrelated sample that might otherwise be mutually exclusive to the first. A prescription need only match the criteria of one of the filter sets to be returned by the user view.

A common mistake we see is to apply a date/time filter in a filter set where you are also trying to return prescriptions that don't match it due to the current status of the prescription, such as using a Completed time range in the same filter set as a Status = Incomplete filter. As incomplete prescriptions by definition do not have a completed time, they are entirely filtered out. As these criteria are in conflict with each other, they can and should be configured as different filter sets in the user view.

Similarly, if you applied a Status = Pending filter (to return pending prescriptions), but also a Started time filter, this would exclude all of the Pending prescription for the simple reason that pending prescriptions have not yet been started at all. In this example, the user probably wanted to use a Requested filter for the date/time range, rather than Started, or they could use two filter sets to return prescriptions that were either Started within a certain time frame, or Requested within a certain time frame.

Sorting tab

The sorting tab. This example will group by prescription type in alphabetical order, and then within those groups sort the prescriptions in order of those most near their target time.

Sorting a user view allows you to determine the order in which the prescriptions will appear on the user view. You can choose the field that is to be used for sorting and whether the sort is in ascending or descending order. You can add additional sorting parameters (i.e. secondary and tertiary sorts) and the order of priority.

Click the add button PlusButton.png to create a new sort and click the delete button MinusButton.png to remove an existing one.

Grouping

When adding a new sort you'll be given the option to group the results by the field you are sorting on. As you would expect, enabling this option will group your results by the selected parameter. On a standard user view it's quite common to group by prescription type, which would organise the home page into groups of the various prescription types currently in progress.

The user view can only be grouped by one parameter.

Grouping user views not only organises the prescriptions but crucially allows the user to select and therefore perform certain on-screen actions on the group as a whole (such as the actions for selected prescriptions accessible from the user view actions menu) by clicking the tick box in the groups header to select all of its prescriptions. This requires the user to have the ENDOFDAY permission, so named as it is invariably used to clear down groups of prescriptions at the end of the working day.

Grouping and the mobile app

Grouping user views is borderline essential when setting up a view for the mobile app on account of the aforementioned ability to action groups as a whole. As your porters or delivery staff will surely be working with prescriptions placed into bags or organised by ward, for example, it's important to group their user views in the same way so as to allow them to collect and deliver the bag or ward as a whole. If you don't do this they will be presented with a list of individual prescriptions to collect and deliver one by one.

Allocated roles tab

Allocating the user view to a role.

In newer versions of PTS, you can specify which roles are assigned the user view in the "Allocated roles" tab.

Click the add button PlusButton.png to allocate the view to additional roles, or click the delete button MinusButton.png next to a role to remove the view from the role.

When allocating the view to new roles you can specify whether to also allocate the view to existing users of that role, and/or whether the view should be the default view for that role.

Allocated users tab

In newer versions of PTS, you can specify which individuals are assigned the user view in the "Allocated users" tab.

Click the add button PlusButton.png to allocate the view to additional users, or click the delete button MinusButton.png next to a user to remove the view from the user.

When allocating the view to new users you can specify whether the view should be the default view for that user.