Instances, Holdings, Items - Cross-tenant query expectations (ECS)
The expected behaviors documented on this page are specific to the Lists app (and FQM) when querying Instance, Holdings, and Item records within in an ECS environment. The behavior is dependent on what context you’re querying from - whether your active affiliation is the Central tenant, or if your active affiliation is a Member tenant. To make it easier to distinguish the context at a glance, the table header color indicates the active affiliation: blue indicates the active affiliation is the Central tenant, and gray indicates the active affiliation is a member tenant.
General background:
https://folio-org.atlassian.net/wiki/spaces/FOLIOtips/pages/599916623/Lists+App+Cross-tenant+Queries#Definitions for definitions and an overview of cross-tenant queries.
https://folio-org.atlassian.net/wiki/spaces/FOLIOtips/pages/599916623/Lists+App+Cross-tenant+Queries#Permissions for details on how permissions/affiliations work
Instance records -
Querying Instance records when active affiliation is Central tenant
Assume the user has required affiliations and permissions
Record type | Included in results? |
|---|---|
Instance in active affiliation (Central):
| Yes |
Instance in non-active affiliation (Member):
| Yes |
Querying Instance records when active affiliation is a Member tenant
Assume the user has required affiliations and permissions
Record type | Included in results? |
|---|---|
Instance in active affiliation (Member)
| True |
Instance in non-active affiliation (Central)
| True |
Instance in non-active affiliation (other Member or Central)
| False |
Holdings records
Querying Holdings records when active affiliation is Central tenant
Assume the user has required affiliations and permissions
Record type | Included in results? |
|---|---|
Holdings in active affiliation (Central):
| True |
Holdings in non-active affiliation (Member):
| True |
Querying Holdings records when active affiliation is a Member tenant
Assume the user has required affiliations and permissions
Record type | Included in results? |
|---|---|
Holdings in active affiliation (Member):
| True |
Holdings in non-active affiliation (other Member or Central):
| False |
Item records
Querying Item records when active affiliation is Central tenant
Assume the user has required affiliations and permissions
Record type | Included in results? |
|---|---|
Item in active affiliation (Central):
| True |
Items in non-active affiliation (Member):
| True |
Querying Item records when active affiliation is a Member tenant
Assume the user has required affiliations and permissions
Record type | Included in results? |
|---|---|
Item in active affiliation (Member):
| True |
Item in non-active affiliation (other Member or Central):
| False |