Settings > OAI-PMH
This section of the documentation contains links to external sites. Please be advised that these sites are not maintained by the FOLIO Documentation Group and may be aligned with a different FOLIO release.
The OAI-PMH section of the Settings app is where you configure the behavior of FOLIO’s OAI-PMH feed. Learn more about the OAI-PMH Specification at the Open Archives website.
FOLIO currently supports three metadata formats:
- marc21
- oai_dc
- marc21_withholdings
This list can be viewed by using the ListMetadataFormats verb.
Capabilities and Capability Sets
Each setting within OAI-PMH has its own capability or capability set associated with it. If a user has one of the below assigned to their user record, they will be able to view and interact with that particular setting. You can assign capabilities via user roles.
| Permission (OKAPI) | Resource (EUREKA) | Type | Action | Description |
|---|---|---|---|---|
| Settings (oai-pmh): display list of settings pages | Settings Oai-Pmh Enabled | settings | view | This allows the user to view the OAI-PMH settings pages. |
| Settings (OAI-PMH): Can view | UI-Oai-Pmh Settings | settings | view | This allows the user to view all the OAI-PMH settings, but “Save” button is disabled. |
| Settings (OAI-PMH): Can view and edit settings | UI-Oai-Pmh Settings | settings | edit | This allows the user to view and edit the OAI-PMH settings. |
| Settings (OAI-PMH): Can view logs | UI-Oai-Pmh Settings Logs | settings | view | This allows the user to view Settings > OAI-PMH > Logs. |
Settings > OAI-PMH > General
General settings to configure how the Identify verb responses.
Enable OAI service
Checkbox to globally enable or disable OAI services.
Repository name
Sets the content in the respositoryName XML element of the Identify response.
Base URL
Sets the content in the baseURL XML element of the Identify response. This value also appears in the content of the response XML element of the ListRecords verb.
Time granularity
Sets the content in the granularity XML element of the Identify response.
Administrator email(s)
Sets the content in the adminEmail XML element of the Identify response.
Settings > OAI-PMH > Technical
Max records per response
Number of records to return per page of response.
Enable validation
Defines if the response content should be validated against XSD schemas.
Formatted output
Determines if the marshalled XML data is line feeds and indentation.
Settings > OAI-PMH > Behavior
Deleted records support
One of:
- No - Indicates that no information about deleted records is presented.
- Persistent - Records with MARC Leader 05 equal to ’d', ’s' or ‘x’ will be listed as deleted in OAI-PMH ListRecords responses.
- Transient - Same behavior as Persistent, but without a guarantee that deleted records will be kept indefinitely in FOLIO.
See https://issues.folio.org/browse/MODOAIPMH-108 for more details of the implementation.
Setting value appears in deletedRecord XML element of Identify response.
Suppressed records processing
One of:
- Transfer suppressed records with discovery flag value - Adds a MARC subfield $t = 1 to FOLIO’s 999 field (for Instances), 852 field (for Holdings) or 952 field (for Items).
- Skip suppressed from discovery records - Instances marked ‘Suppress from Discovery’ are not included in the OAI-PMH response.
OAI-PMH errors processing
One of:
- Associate with HTTP status 200 - Error messages are returned with an HTTP 200 response code.
- Associate with HTTP error statuses - Error messages are returned with an appropriate HTTP error code.
Record source
One of:
- Source records storage - MARC instance records are harvested from SRS.
- Inventory - Instance records are harvested from inventory only, and all OAI-PMH records are generated on-the-fly as part of the harvesting.
- Source records storage and inventory - All instance records with a metadata source of MARC are retrieved from source record storage. Instance records with a metadata source are retrieved from inventory and OAI-PMH records are generated on-the-fly for those inventory-only records as part of the harvest.
Settings > OAI-PMH > Logs
The logs page displays a list of completed harvests and is kept for 30 days. If a harvest contains a record or records that cannot be handled, a “Download” link will appear in the rightmost column of the logs. Clicking this link will download a spreadsheet where errors are listed with the UUID of the affected instance and an error message.
Field mappings for ListRecords response
In order for Discovery services and OPACs to allow for filtering, aggregating and searching based on location and call number information, the OAI-PMH server in FOLIO needs to be able to supply this information as part of the feed.
Mapping from Inventory records to MARC fields as part of the feed can be found on the FOLIO wiki
Last modified July 24, 2025