CDR Tickets

Issue Number 5312
Summary Improve CDR administrative UI
Created 2023-12-18 03:41:55
Issue Type Improvement
Submitted By Kline, Bob (NIH/NCI) [C]
Assigned To Kline, Bob (NIH/NCI) [C]
Status Resolved
Resolved 2024-01-04 11:46:41
Resolution Fixed
Path /home/bkline/backups/jira/ocecdr/issue.372331
Description

Overview

A branch has been created to give the the CDR web site a facelift, using the USWDS framework, which is also used by the NCI web site and the EBMS. Improvements have been made to the menus, page appearance, and testing support. The results can be seen at https://nciws-d2019-v.nci.nih.gov.

Advantages

The benefits of this version include the following.

  • consistent navigation sidebar always available

  • report output in separate tabs, eliminating dependence on the Back button

  • common footer with frequently-used links

  • cleaner, more modern look and feel with familiar layout

  • flexible, centralized menu structure management

  • an automated test suite for all pages

  • more graceful error-handling

  • dashboard landing page for users with access to multiple menu groups

  • CDR document search box in the banner

Comment entered 2023-12-18 04:40:38 by Kline, Bob (NIH/NCI) [C]

Sample Pages

A few screenshots have been included to illustrate the new layout.

Landing page

For users with access to more than one menu group, the top banner contains a main menu for selecting one of those groups, along with a dashboard showing statistics for current CDR activity.

Navigation sidebar

The left portion of the page shows the available reports and utilities for the selected menu group, providing hierarchical context for the currently selected menu item.

Report layouts

Depending on a report's width and on whether it requires a form, there are several layouts available.

In-place report

One or two of the reports are compact enough and require no form for report options that they can be displayed directly, next to the left navigation sidebar.

Standard report layout

Most reports will need more space, and will be displayed in their own tab, without the left navigation sidebar.

Wide report layout

Some reports have enough columns that they require more space than is available within the layout's grid framework. These reports are given the width of the full browser window.

Plain layout reports

There are a number of reports which have so many columns that they need to be displayed without the standard USWDS framework. For reports which have too many columns to comfortably fit on a browser page, an Excel-only report is often the best option.

Custom report layouts

Some reports are really processing forms, and require non-standard table layouts.

Notification alert banners

Many of the places where a problem was encountered for a report request now show one ore more alert banners explaining the problem(s) above the re-displayed form, allowing the user to correct the errors directly instead of needing to navigate back to the original form.

The same banner system is used to replace the ugly and uninformative 502 - Web server received an invalid response while acting as a gateway or proxy server messages.

Comment entered 2023-12-27 11:54:05 by Kline, Bob (NIH/NCI) [C]

(re-entry of a comment which JIRA discarded)

A complete set of automated tests has been created for the new admin pages. There are ten groups of tests, each of which can be run separately or in combination (as can the individual tests themselves). There are 160 tests in all, some of which cover more than one page (there are 180 unique pages in the admin menus). A complete run of all the tests takes about an hour and 20 minutes. Currently all the tests pass. The test groups:

  • CitationTests

  • DeveloperTests

  • DrugTests

  • GeneralTests

  • GlossaryTests

  • ManagementTests

  • MediaTests

  • PublishingTests

  • SummaryTests

  • TerminologyTests

Comment entered 2024-10-30 15:36:39 by Kline, Bob (NIH/NCI) [C]

This has been installed on CDR DEV.

https://cdr-dev.cancer.gov

Comment entered 2024-10-31 08:08:29 by Kline, Bob (NIH/NCI) [C]

I've added a "Menus" link to the footer, which will let you see the hierarchies of the left nav menus. this might be the cheat sheet your staff needs for learning their way around. Hope this helps. 🙂

Comment entered 2024-10-31 10:06:08 by Kline, Bob (NIH/NCI) [C]

I just thought of another advantage of the new menu system for the updated UI. I can configure it so that we can modify the menus without a release, moving things around (or dropping them) as we need to.

Comment entered 2024-11-04 13:04:40 by Englisch, Volker (NIH/NCI) [C]

On the landing page there is the entry "Logged in users".  Does the number displayed indicate the number of users logged in including myself?

Comment entered 2024-11-04 13:52:01 by Kline, Bob (NIH/NCI) [C]

Yes. I believe it also includes the guest account. Perhaps I should eliminate that one from the count.

Attachments
File Name Posted User
form-error.png 2023-12-18 05:04:49 Kline, Bob (NIH/NCI) [C]
in-place-report.png 2023-12-18 03:48:06 Kline, Bob (NIH/NCI) [C]
landing-page.png 2023-12-18 03:35:18 Kline, Bob (NIH/NCI) [C]
navigation-sidebar.png 2023-12-18 03:50:09 Kline, Bob (NIH/NCI) [C]
report-basic-page.png 2023-12-18 03:49:11 Kline, Bob (NIH/NCI) [C]
report-container-width.png 2023-12-18 03:48:49 Kline, Bob (NIH/NCI) [C]
report-custom.png 2023-12-18 03:49:21 Kline, Bob (NIH/NCI) [C]
report-full-page-width.png 2023-12-18 03:48:58 Kline, Bob (NIH/NCI) [C]
script-not-found.png 2023-12-18 04:19:54 Kline, Bob (NIH/NCI) [C]

Elapsed: 0:00:00.001614