Trillium - FQM API for user defined ETs with joins - UAT
User Acceptance Test Overview
This User Acceptance Test (UAT) is designed to validate the functionality implemented in https://folio-org.atlassian.net/browse/UXPROD-4863
This is a technical UAT that requires the use of APIs to test functionality.
The goal of this test is to ensure that creating custom entity types via API and using them in the Lists app meets users expectations. This UAT consists of the following functionality:
Tester Information
Basic details about the person conducting the test.Find relevant info about how record types can be joined
The Available Joins API is like a guide that tells you which types of records can be connected to each other.Create and update a custom entity
Create a custom entity that combines multiple sources of dataAccess custom entity via the Lists app
Test accessing and querying your custom entity in the Lists appExploratory Testing
Open-ended testing to uncover edge cases, usability issues, or unexpected behaviors.
User Acceptance Tests Details
Deadline: Friday, Jan 30, 2026
Recommended documentation:
UAT form: https://forms.gle/ozUwHcuyqqxAEP829
Questions about the UAT: @Kathleen Moore
Test environment:
URL: https://folio-etesting-snapshot-diku.ci.folio.org/
Login: diku_admin Password: admin
The
diku_adminaccount has the necessary permission already assigned. If you prefer to use a custom test user, ensure the user has the required permission as described in: https://folio-org.atlassian.net/wiki/spaces/FOLIOtips/pages/1514700828/User-defined+entities+with+joins+created+via+API+for+use+in+Lists+app#Required-permissions-per-action
User-defined custom entities only last on snapshot until the environment is rebuilt (daily). It’s recommended that you make a local copy of any custom ET definitions to make them easier to recreate
Postman collection with sample requests
The linked Postman collections contains example requests to the available joins endpoint for the Eureka snapshot environment. These can be used to test this endpoint on Eureka snapshot.
Environment: https://folio-etesting-snapshot-diku.ci.folio.org/
Note: in order to use this collection, you’ll need to get a valid token and include it in the header for the
x-okapi-token
