Release Notes 17.3

2024-03-29

User Interface

  • Redesigned User Interface - Features include:
    • Project Navigation - The project and folder navigation menus have been redesigned as a single-column scrollable list. A small screen version allows the dropdown to render on tablets and other small windows. For administrators, a button is shown that leads to the folder management area. (docs)
    • Current Folder Link - The current folder link takes you back to the default view of the current folder or project. (docs)
    • Page Admin Mode - When Page Admin Mode is turned on, administrators see the controller menus for tabs and web parts and the dropdowns for adding new web parts. These are hidden when Page Admin Mode is turned off. Page Admin Mode is turned off by default. (docs)
    • Impersonation - When impersonating, administrators see a large button in the upper right that clearly indicates that they are in impersonation mode. (docs)
    • Frameless Web Parts - Web parts can be rendered without the web part title, the surrounding border, and the top banner. (docs)
    • Grid Interface - Improvements include: (1) a new look and feel, (2) removal of the "paperclip" icons so filters and sorts are automatically opt-ed in when saving a custom view, and (3) menu filtering when saved views exceed 10 items. (docs)
    • Issues Tracker Enhancements - Search by issue id or keyword in a unified search box. Improved field layout when inserting and updating issues. The button bar has been redesigned in grid view, providing easier access to the most important functions. (docs)
    • Paging Redesign - On data grids, control paging by clicking the row count information directly. This replaces the Paging menu, which has been removed. (docs)
  • We are interested in your feedback on the new user interface. On your server deployment, select > Give UI Feedback, and tell us what you think.

Visualizations

  • Line Plots - Line plots display a series of data points connected by lines across the X-axis. While similar to Time Charts, the X-axis does not need to be time-based. (docs)

Reporting

  • Share R Reports - R reports can be shared with individual users so that they can save and modify a copy. (docs)
  • Metadata for R Reports - Module-based R reports support static thumbnail images, icons, and a "created" date can be specified. (docs)

Collaboration

  • Markdown - Support for Markdown syntax has been added to wiki pages and messages. (docs)
  • Delete Branch of Wiki Pages - When deleting a parent wiki page, you can optionally delete all children pages (and grandchildren recursively). (docs)
  • Enhanced File Root Options - Create file web parts that expose a specific subdirectory under the file root. Expose an alternative WebDav root that displays a simplified, file-sharing oriented directory tree. (docs | docs)

Compliance

  • Electronic Signatures - Sign a data grid snapshot, and specify a reason for signing. Signed documents are listed in the Signed Snapshots table. (docs)
  • Write Audit Logs to File System - Some or all of the audit log can be written to the filesystem. (docs)
  • Exclude Columns with PHI Level - Mark individual columns with a PHI level (Not PHI, Limited PHI, Full PHI, or Restricted). Exclude columns of a particular level and higher during study publishing and folder export. This replaces the "Protected" field property; existing fields that are marked as "Protected" will be mapped to "Limited PHI".(docs)

Security

  • LabKey Server as a CAS Identity Provider - Use LabKey Server as an enterprise identity provider that leverages the CAS single-sign-on authentication protocol, to which other LabKey Servers can delegate authentication. (docs)
  • See Absolute File Paths Role - A new role allows granting of permission to see absolute file paths from within the file browser. (docs)
  • Adjust Impersonation - When impersonating roles, you can switch between roles without exiting impersonation. Select > Adjust Impersonation. (docs)

System Integration

  • File Watcher - Set up a file watcher to automatically load new files into the data processing pipeline for import and analysis into LabKey Server. (docs)
  • REDCap - REDCap integration has been updated and enhanced, including:
    • Data import from REDCap 7.0.
    • New user interface makes it easier to configure connections and data export from REDCap servers. (docs)
    • Support for repeating instruments within a REDCap event. (docs)

Instrument Data

  • (Flow Cytometry) Bulk Editing FCS Keywords - Edit keywords and values, either individually or in bulk. You can also add new keywords and values to the existing set of keywords. (docs)
  • (Panorama) Improved View of Annotation Data - Annotation data is now parsed from Skyline documents and available for querying and visualization. (docs)

Natural Language Pipeline and Document Abstraction

  • Group Cases by Identifier - Tag cases with an identifier. Useful for grouping, sorting, and assignment. (docs)
  • Batch Case Assignment - Assign or reassign abstraction and review tasks to multiple documents simultaneously. (docs)
  • Multiple Review Steps - Send completed abstraction batches for additional review cycles when necessary. (docs)
  • Directly Import Abstraction Results - Given correctly formatted JSON and text files for documents to be abstracted, import them directly bypassing the NLP engine. (docs)
  • Select Multiple Values for Fields - Fields can support the selection of multiple values from dropdowns menus, such as multiple preparation actions or diagnoses. (docs)

Biologics

  • Documentation - The documentation for LabKey Biologics is now publicly available. (docs)

Development

Adjudication

  • Improved Email Notifications - Administrators can manually send reminder notifications for adjudications in progress; notifications can also be configured to be sent daily automatically. (docs)

Operations

Potential Backwards Compatibility Issues

  • Schema Change for QCState - The table QCState has been moved from the study schema to the core schema. While the QCState table is no longer shown in the schema browser in the study module, for backwards compatibility is will still be resolved there in custom SQL queries.
  • Changes to @files Behavior - In releases 17.2 and previous, files written directly to the server's file system in the root directory for a given container were automatically moved into the @files subdirectory (this was added years ago to help installations migrate to the new file layout on disk). Beginning with release 17.3, the server does not move the files. To determine if your 17.2 or older installation is relying on the automatic copy behavior, check the log file at <CATALINA_HOME>/logs/labkey-file-copy.log. If there are no recent entries, you will be unaffected. See the related issue: Issue #32121

Error Reporting

  • Error Codes - Beginning with release 17.3, when you see an error message or an exception is raised, the message and log file will include an error code. Report this error code when reporting an issue or asking a question on the support forums. (docs)

- Denotes Premium Edition functionality.