The LabKey Biologics application supports collaboration among multiple teams or projects by using LabKey containers (folders) to hold and selectively share data. This topic covers considerations for designing your system.
Options for Sharing Biologics Data
Biologics runs in the context of a
LabKey project or folder container. Each container can have unique permissions assignments and data, supporting a secure and isolated workspace. If desired, many resources, including assay designs and sample type definitions, can also be
shared across multiple containers. Further, within a LabKey project of type "Biologics", an administrator can add folders which allow data partitioning.
The Biologics administrator should determine the configuration that best represents the organization.
Example Scenarios:
1. You might have two groups doing distinct work with no need to share data or compare results. These two groups could each use a separate Biologics container (LabKey project or folder) and keep all resources within it. Permissions are assigned uniquely within each container, with no built-in interaction between the data in each.
2. If two groups needed to use the same assay designs or sample types, but would not otherwise share or compare the actual data, those definitions could be placed in the
Shared project, with all collection and analysis in containers (LabKey projects or folders) for the two groups as in option 1. Note that in this scenario, samples created of those shared types would have the same naming pattern and if you used a
container-specific prefix, it would not be applied to the samples of the shared type.
3. If multiple groups need to share and compare data, and also keep clear which data came from which group originally, you could apply a
container prefix in each group's folder so that all data would be consistently identified. In this scenario, each container would need its own sample type definitions so that the naming patterns would propagate the prefix into the created samples.
4. For more integrated sharing, configure Biologics in a top level LabKey project, then add one or more subfolders, all also of folder type "Biologics". Bioregistry and Sample definitions can be shared among the Folders and permissions controlled independently. Learn about this option in the
next section.
5. Storage systems (freezers, etc.) can be shared among folders with different permissions. Users will only be able to see details for the stored samples to which they have been granted access. Learn more about shared storage in the Sample Manager documentation:
Manage Multiple Biologics Folders
When using Biologics in a top-level LabKey Server container, administrators have the option to manage multiple Biologics Folders directly from within the admin interface. Note that this is not supported when the top level Biologics container is a folder or subfolder in LabKey Server.
To manage Folders, select
> Folders. You can customize types of data and specific storage systems available per Folder. Learn more in the Sample Manager documentation here:
When in use, you'll see Folders listed on the left side of the main menu. Select the desired Folder, then click the item of interest on the menu or the links for its dashboard or settings. You will see the contents of the application 'scoped' to the selected Folder. Selecting the top-level container (aka the "home") will show all data the user can access across all Folders to which they have been granted "Read" permissions.
Cross-Folder Actions
When multiple Biologics Folders are in use, the notes about cross-folder actions are the same as for Sample Manager, where Registry Sources are called Sources. Learn more in this topic:
Restricted Visibility of Inaccessible Data
When a user has access to a subset of folders, there can be situations where this user will be restricted from seeing data from other folders, including identifiers such as Sample IDs that might contain restricted details. In detail pages, listing pages, and grids, entities a user does not have access to will show "unavailable" in the display instead of a name or rowid. Learn more in this topic:
ID/Name Settings
Select
> Application Settings and scroll down to the
ID/Name Settings section to control several options related to naming of entities in the application.
Force Usage of Naming Patterns for Consistency
To maintain consistent naming, particularly when using container-specific naming prefixes, you may want to restrict users from entering their own names for entities. Learn more here:
Apply Naming Prefix
You can apply a container-specific naming prefix that will be added to naming patterns to assist integration of data from multiple locations while maintaining a clear association with the original source of that data.
This prefix is typically short, 2-3 characters long, but will not be limited. Prefixes must be unique site-wide, and should be recognizable to your users. Before setting one, make sure you understand what will happen to the naming patterns and names of existing entities in your application.
- The prefix will be applied to names created with naming patterns for all Sample Types and Registry Source Types in the container.
- New samples and entities created after the addition of the prefix will have names that include the prefix.
- Existing samples and entities created prior to the addition of the prefix will not be renamed and thus will not have the prefix (or might have a different previously-applied prefix).
- Sample aliquots are typically created and named including the name of the sample they are aliquoted from. This could mean that after the prefix is applied, new aliquots may or may not include the prefix, depending on whether the originating sample was created before or after the prefix was applied. Learn more about aliquot naming here: Aliquot Naming Patterns.
To set a container prefix:
- Select > Application Settings.
- Scroll down to the ID/Name Settings section.
- Enter the prefix to use. You will see a preview of what a name generated with the Naming Pattern with the prefix applied might look like using a representative example, Blood-${GenId}:
- Click Apply Prefix to apply it.
- This action will change the Naming Pattern for all new and existing Sample Types and Registry Source Types. No existing IDs/Names will be affected. Are you sure you want to apply the prefix?
- Click Yes, Save and Apply Prefix to continue.
Naming Pattern Elements/Tokens
The
sampleCount and
rootSampleCount tokens are used in Naming Patterns across the application.
Learn more about these naming pattern tokens in this topic:
Shared Data Structures (Sample Types, Registry Source Types, Assays, and Storage)
Sample Types, Registry Source Types, Assays, and Storage Systems are defined in the home folder and available in subfolders, provided an administrator
has not 'hidden' them. Administrators can edit these shared data structures from the home any folder, but the changes will be made at the home level, applying to all folders.
In addition, any Sample Types, Registry Source Types, and Assay definitions defined in the
/Shared project will be available for use in LabKey Biologics. You will see them listed on the menu and dashboards alongside local definitions.
From within the Biologics application, users editing (or deleting) a shared definition will see a banner indicating that changes will affect other folders. The same message is applied when editing a data structure from a folder within the Biologics application.
Note that when you are viewing a grid for any Registry Source Type, the container filter defaults to "Current". You can change the container filter using the
grid customizer if you want to show all Registry Sources in "CurrentPlusProjectAndShared" or similar.
Related Topics
