Enabling Discovery (CPP-024)

CPP-IdentifierCPP-024
CPP-LabelEnabling Discovery
AuthorBertrand Caron
ContributorsMattias Levlin
EvaluatorsMatthew Addis, Felix Burger, Maria Benauer
Change historyComments
Version 1.0.0 - 2025-08-29Milestone version
Version 1.1.0 - 2026-03-27Migration to XML
Version 1.2.0 - 2026-05-18Reassigned step numbers based on new numbering rules.

1. Description of the CPP

The TDA provides catalogue services to its consumers to help them identify Objects that they may be interested in.

Inputs and outputs

Input(s)
Data
Optional Derivatives useful for the consumer to identify the content and scope of the Object
Metadata
Digital Archive Database
Documentation/guidance
Query scenarios
Metadata mapping specifications
Output(s)
Metadata
Catalogue service
Process execution report

Definition and scope

Enabling Discovery covers the extraction of the subset of Metadata from the digital archive database to enable consumers to identify which Objects they may be interested in. In OAIS, this subset is called "Descriptive Information".

Discovery relies on CPP-018 (Community Watch) to study consumers’ needs regarding searches and elaborate query scenarios. Query scenarios are use cases where the consumers identify a subset of the TDA holdings’ that addresses their needs. Discovery is in charge of providing Metadata, query and retrieval features that support these query scenarios in an efficient way. If the TDA wants its Objects to be discoverable in third-party catalogues (e.g. federated catalogues, portals etc.), it must perform this process for each service in order to ensure that Metadata and derivatives conform to the specifications of the third-party catalogue(s).

If the TDA provides direct access to its holdings for end users, then it may also generate a PID (e.g. a DOI) for each accessible Object so that it is referencable and locatable using third-party discovery services. However, this CPP only focuses on the generation of Metadata that is subsequently used for discovery (rather than the discovery process and the use of discovery services such as portals and catalogues). The details of registering PIDs, publishing Metadata and/or data with third-party catalogues and discovery services, as well as the access to Objects via PID resolution and TDA services are beyond the scope of this CPP.

Enabling Discovery is also in charge of verifying the legal status of Metadata based on rights assessment as issued by CPP-020 (Rights Management). Metadata access might indeed need to be restricted, so Discovery must ensure it disseminates these only to authorised users.

In addition to Metadata, discovery might provide derivative copies (e.g. thumbnails, textual transcription, redacted copy, etc.) that would help consumers in identifying the content and scope of the relevant Objects. Indeed, access to the preservation copies or to a sufficiently complete derivative is often limited to the TDA’s precinct.

Process description

Trigger event(s)

Trigger EventCPP-identifier
New Object or new Object version ingestedCPP-029 (Ingest), CPP-021 (AIP Versioning)

Step-by-step description

NoSupplierInputStepsOutputCustomer
 sequence
1CPP-018 (Community Watch)Query scenariosSelect the relevant Metadata (and possibly data) useful to the consumerSubset of Metadata to be exposed in the catalogue
2CPP-018 (Community Watch)Query scenariosSelect the syntax or serialisations useful to the consumerSyntax of Metadata to be exposed in the catalogue
3New AIP or AIP versionExtraction: Extract the required subset of Metadata from the new AIP or AIP versionExtracted discovery Metadata
Subset of Metadata to be exposed in the catalogue
Syntax of Metadata to be exposed in the catalogue
4Extracted discovery MetadataMapping & transformation: Map and transform the Metadata according to the required format of the discovery catalogueTransformed discovery Metadata
5Transformed discovery MetadataValidation: Validate the resulting subset of Metadata against the target catalogue's schemaValidation successful: Validated discovery Metadata (step 4)
Validation failed: Log the error and flag the record for review. The record must not proceed to the discovery catalogue until corrected
6Validated discovery MetadataCheck rights status of discovery MetadataValidated discovery Metadata with cleared rights
CPP-020 (Rights Management)Rights statement
7Validated discovery Metadata with cleared rightsAdd discovery Metadata for the Object(s) to the catalogue service. The catalogue service may be provided by the TDA, by a third-party (e.g. a federated catalogue), or by a combination of the two.Entry in catalogue service
8Validated discovery Metadata with cleared rightsOptional: If the TDA requires a PID (e.g. DOI), because the Object or Metadata about the Object will be publicly accessible (e.g. open access), the TDA may request a PID from an appropriate registration agency. The TDA may also add the PID to the Metadata in the catalogue service.PID
9CPP-025 (Enabling Access)
CPP-028 (Creation of Derivatives)
DIP or DerivativesOptional: The TDA may provide versions of its Objects for inclusion in the catalogue service (for example, thumbnails, preview versions, redacted documents etc.). These are added to the catalogue entry for the Object.Entry in catalogue service
6Query scenariosVerification: Using the defined query scenarions, perform a test query to confirm that the new or updated Object is discoverable in the catalogue service.Verification successful: Verification confirmation in the process execution reportCPP-013 (Object Management Reporting)
Catalogue serviceVerification failed: If the Object is not found, log the failure as an incident to investigate the ingest and indexing chain

Rationale(s) and worst case(s)

RationaleImpact of inaction or failure of the process
If the TDA is providing access to its holdings to consumers, ensuring query services that suit the consumers’ needs is mandatory.If the catalogue service does not allow query scenarios useful to the consumers, discoverability and usage of the TDA holdings is compromised.

2. Dependencies and relationships with other CPPs

Dependencies

CPP-IDCPP-TitleRelationship description
CPP-005Identifier ManagementEnabling Discovery should make use of PIDs.
CPP-009Metadata ExtractionSome Metadata provided to the consumer must have been extracted from the Files.
CPP-016Metadata Ingest and ManagementEnabling Discovery relies on a correct metadata management process. In particular, Metadata created by and within the TDA is of particular interest to the consumer in order to understand preservation actions that could have affected the Object
CPP-018Community WatchThe TDA must have identified the needs of its designated community in order to enable queries that support the community's defined query scenarios.

Other relations

RelationCPP-IDCPP-TitleRelationship description
Affinity withCPP-025Enabling AccessThe distinction between Enabling Discovery and Enabling Access may be blurred as derivative copies may be indexed and searched in the same way as Metadata. In addition, these derivative copies may be sufficient to address some consumers’ needs. Nevertheless, the distinction is still useful as giving access to the original data is often governed by specific legal constraints, and requires specific hardware and software tools.

4. Reference implementations

Use cases

ePADD Discovery module

Institutional background
InstitutionStanford University's Special Collections & University Archives, USA, US
Hyperlinkhttps://www.epaddproject.org/using-epadd/discovery-module

Discovery module for Stanford’s email collections: https://epadd-discovery.stanford.edu/epadd/collections
Description
Problem statementEmail collections are born-digital material that need and allow specific usages and access. On the other hand, they raise privacy issues that force memory organisations to give access to these collections only in the organisation’s precinct. Consumers therefore need to identify the scope and content of the collection through remote queries before planning an on-site visit.
Proposed solutionBeyond the mails’ Metadata, the full text was indexed and is searchable, though not entirely readable - when accessing the mail, the full text is redacted, only the searched term and email Metadata are displayed. Access to the mails’ collections is possible only in the organisation’s precinct.

etsin.fairdata.fi (CSC): Open discovery for datasets with varied access conditions

Institutional background
InstitutionCSC - IT Center for Science, Finland, FI
HyperlinkMain Discovery Service: https://etsin.fairdata.fi/

Example 1 (Direct Access via use-copy): FIRE Profile 3 https://etsin.fairdata.fi/dataset/5ab685f0-d515-41fa-877b-641589606405

Example 2 (Mediated Access): Drive-tested topsoil https://etsin.fairdata.fi/dataset/f59349c4-ac60-4305-8a9b-9ccc33a3f6fa
Description
Problem statementA TDA can host datasets with a wide variety of access conditions. Some may be open for immediate download (e.g. via a use copy), while others may require human-mediated access (even if their ultimate license is open). The challenge for a discovery service is to represent a) these different states, b) providing access pathways for each dataset without compromising the specific rights management and c) providing access policies defined by the data owner.The Finnish discovery portal etsin.fairdata.fi (CSC) hosts Metadata for both active research data outside of the AIP context and for formally preserved assets ( AIPs). The first challenge is to provide a clear and reliable method for users to discover only the preserved assets (with associated AIPs); and second, to represent the specific access conditions for each of those preserved AIPs.
Proposed solutionThe Fairdata services solve this by addressing the discovery of preserved assets by providing a specific, filterable view of its catalogue. The URL parameter ?data_catalog__title=Fairdata+PAS+datasets in https://etsin.fairdata.fi/ creates a dedicated view within Etsin that exclusively lists datasets corresponding to verified AIPs in the long-term Digital Preservation Service (the filter is also selectable via the Etsin user interface).Within this view where only datasets with an associated AIP are visible, the system handles varied access policies, as defined by the data owners. It can enforce a spectrum of access conditions>Example 1 (Direct Access): For some AIPs, a "use copy" is made available for immediate download. Etsin provides a direct link to this copy while also linking to the canonical AIP record (which is not available via Etsin), separating simple use from the formal preservation record.Example 2 (Mediated Access): For other AIPs, access is controlled. Etsin displays a record that might offer a link to a "preview dataset" but withholds the full data. It then provides explicit instructions on the required procedure, such as "To get this dataset, please contact [email address]." Example 3 (Fully Mediated Access): The system can also handle cases where no preview or data is available, and the only option for a user is to follow the human-mediated contact instructions provided in the Metadata.These examples demonstrate how a discovery service can provide a dedicated view for preserved AIPs (CPP-024) while interpreting and enforcing a range of different access rules—from fully open to fully mediated—as defined by rights and access policies (CPP-020) and taken into account during the access process (CPP-025).

Publicly available documentation

InstitutionOrganisation typeLanguageHyperlink
TIB – Leibniz Information Centre for Science and Technology and University Library, DENational library
Non-commercial digital preservation service
Research infrastructure
Research performing organisation
Englishhttps://wiki.tib.eu/confluence/spaces/lza/pages/93608951/Metadata
(Internal use:)
English https://knowledge.exlibrisgroup.com/Rosetta/Training/Rosetta_Essentials/Data_Management/7.1_Searching_the_Rosetta_Permanent_Repository
(also see)
Englishhttps://www.tib.eu/en/
(External Use: TIB Portal:)
Englishhttps://av.tib.eu/
(TIB AV Portal:)
Englishhttps://gvk.k10plus.de/LNG=EN
(Library union catalogue k10plus:)