Configure OAI-PMH connections

You can add multiple connections to harvest metadata from providers who use the Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH). After you add OAI-PMH connections, you can share the metadata to collection sites.

You can use one of the following methods to include thumbnail images:

  • A URL of an image
  • A URL that uses an identifier code from a Dublin Core (DC) field in your object metadata.
    Example: example.com/cover?id=##header.identifier##/image
  • A field in your DC metadata that contains a URL to the repository image.
    Example: ##metadata.dc.relation##

  • After you add your OAI-PMI connections, you must contact Support to schedule your harvest and updates. We recommend that you harvest metadata every week.

  • If a repository or an element isn’t found, Vega uses the default cover.

  1. From the Settings menu, select OAI-PMH list page.
  2. On the OAI-PMH connections configuration page, select + OAI CONFIGURATION.
  3. On the Edit Connection page, in the OAI Repository Name box, enter the name of the OAI repository.
  4. In the OAI Base URL box, enter the OAI base URL of the provider.
  5. In the Thumbnail URL box, enter the URL or leave the box empty:

    6. If you want to use And you want to Do this

    The default cover for all the harvested items

    The default cover includes the title, author, and format.

    		 —

    Leave the box empty.
    A single image for all harvested materials —

    Enter the URL of the image.

    Example:

    example.com/logo.jpg
    A URL that includes a DC metadata property reference between ## characters Use the first element value from a metadata DC field

    Enter metadata.dc.identifier between the hashtags.

    Example:

    example.com/cover?id=
    ##metadata.dc.identifier##/image?size=MD
    Use the value from the header identifier element

    Enter header.identifier between the hashtags.

    Example:

    example.com/cover?id=
    ##header.identifier##/image?size=MD
    Use the value from the metadata DC identifier element that has a specific attribute type

    Enter metadata.dc.identifier[@_type=<value>] between the hashtags.

    Example:

    example.com/cover?id=
    ##metadata.dc.identifier
    [@type=dcterms:uuid]##/image?size=MD
    A single metadata property reference between ## characters —

    Enter the URL with the metadata property reference between the hashtags.

    Example:

    ##metadata.dc.relation##

    This assumes that the provided property contains the full cover URL.

  6. Select SYNC COLLECTION DETAILS.
    Vega checks to see if the repository contains collection sets and supported metadata types. If it does, Vega displays a list of names.
  7. From the Metadata prefix list, select oai_dc.
  8. In the List of Collections section, select the collections you want to ingest.
    • If you don’t select any collections, Vega harvests all materials including materials that have no collection.
    • If you select all collections, Vega harvests materials that belong to the selected collections, but doesn’t include materials that have no collection.
  9. Select Save.
  1. In the upper-right corner, select Settings Settings icon..
  2. Select Library defaults.
  3. Select OAI PMH Content Management.
  4. Select Edit Sharing.
  5. (Optional) Do the following:

    6. If you want to search by Enter a name in the
    Site name
    • Search by site name box.
    Connection name
    • Search by connection name box.

  6. For each site that you want to share metadata to, select Shared for the repository you want to share.
  7. Select Save.