GGCE 2024.2 update
We are happy to announce the 2024.2 release of GGCE.
Please check the complete list of changes at:
- Announcement #334 (closed)
- Web https://gitlab.croptrust.org/grin-global/grin-global-ui/-/releases/v2024.2
- API https://gitlab.croptrust.org/grin-global/grin-global-server/-/releases/v2024.2
2024.2
allows you to Customize the logo bar background color and display a custom name for your GGCE, record seed moisture content, compare the number of inventories at different sites, and use the same attachment for multiple accessions and inventories. It also brings a new tool to assign storage location of inventories.
For the API, 2024.2
further improves SOAP endpoints for bulk data management with the Curator Tool.
An important change in 2024.2
is that only active OAuth clients can connect to GGCE API. GGCE will set all existing OAuth clients to be active since an inactive GGCE UI client would cause access problems. You can then use OAuth Clients in GGCE Admin Tools to enable/disable any client.
We updated the templating system for email messages. For that reason, a new default template must be installed. The archive copy of the original email template is stored under email.template.20240325
in Application Resources and it can be safely removed.
GGCE will ensure and update the default OAuth client configuration to match the settings in your ggce.yaml
file.
New features:
- Customize logo bar background color and display a custom name
- Capture seed moisture content
- Compare the number of inventories at different sites
- Show accession and inventory images on the main page
- Display errors when uploading MCPD to Genesys
- Display seed viability in the list of material for Distribution
- Sharing the same document between accessions and inventories
- A new tool to assign storage location of inventories
- Show
CropTraitObservationData
in accession, inventory and methods
API changes:
- Added endpoint for comparing the number of inventories across sites
- SOAP endpoints (i.e. the Curator Tool) use CRUD services then JPA repositories then entity manager to save and remove records. This makes CT more compatible with GGCE.
Database changes:
- Added fields for seed moisture content to
inventory_extra
- Added
availability_reason_code
toinventory
- Added
is_active
field tokpi_execution
- Added a unique constraint on
acl_sid.sid
Custom branding
It is important to know if you are accessing the production or test environment. You can specify a custom label and color of the main menu for each GGCE instance to allow your users to more easily differentiate between them.
Use yellow or orange color to warn users that they are accesing the test environment and display "Test" on all pages (next to the GGCE logo):
This can be configured in ggce-ui
section of the compose YAML file:
ggce-ui:
image: dockerhub.croptrust.org/grin-global/grin-global-ui/gg-ce-web:2024.2
environment:
# Name displayed on the entry page
- NAME=My genebank test environment
# Short name displayed next to the logo
- NAME_SHORT=Test
# Background color of the menu header
- MENU_COLOR=#ff6508
These configuration options are available in the Install Wizard:
Seed moisture content
Moisture content (MC) is commonly measured during the seed drying process and can be stored in GGCE as an extra attribute of each seed inventory. The MC is displayed in inventory grids and details pages, and filtering by MC is enabled.
In Curator Tool you can find this information in the *SeedInventoryExtra dataview.
Comparing sites
The Compare sites feature in the Inventory module allows you to figure out how many inventories of the same accession are at different sites. A common use case is the identification of accessions that are in long-term storage but not yet backed up at another site.
Compare sites allows you to pick two or more sites and filter for the number of inventories at each of them. The standard accession filters can also be applied to narrow down the search.
Example
List accessions for which there is at least one inventory at site A and no inventories at site B:
Site | From | To |
---|---|---|
Site A | 1 | |
Site B | 0 |
To narrow down the list to only fully curated Hordeum accessions you can use the Search function.
Uploading MCPD to Genesys
Genesys may reject incoming passport data if it does not fully comply with MCPD. The updated Upload progress dialog displays a list of accessions that could not be uploaded and the corresponding error message.
Note that GGCE will abort the uploading process when 10 errors are encountered.
Sharing the same document between accessions and inventories
GGCE allows for attaching documents and images to individual accession and inventories. In some cases the same attachment refers to multiple accessions and would need to be uploaded many times. Such multiple uploads are treated independently and each one takes up additional disk space. A common scenario is a collecting mission report that is associated with several accessions.
It is now possible to attach a document or image to one accession and then share the same document with other relevant accessions or inventories, referring to the same file. The file is removed from the repository only when the last remaining attachment is deleted from GGCE.
Assign storage location
Assign storage location is a new tool in the Inventory section that allows you to more conveniently assign location address to inventories.
It first asks the user to pick the site and the location (for example L1-L2-L3
) and displays all inventories at the selected location. The table displays columns: inventory number, quantity on hand and unit, and storageLocation1-4
.
Adding inventory to the selected location
"Add inventory" opens a dialog to scan the inventory barcode. If the scanned inventory is already in the table, it is ignored, otherwise, it is added to the end of the table, with storageLocation1-4
assigned to the currently selected location.
The grid shows the current location of the inventories and the new target location. The new locations are assigned by hitting the Save button.
When "Use location 4 for sorting" is enabled, storageLocation4
is calculated automatically and always uses three digits.
Reorder inventories
"Reorder inventories" is only available when the checkbox "Use location 4 for sorting" is ticked. It applies only to the inventories that are already at that location and are listed in the table.
This function allows you to set the order of inventories (storageLocation4
) by scanning inventory barcodes in order from first to last.