Publish OAI-PMH Workflow Operation
ID: publish-oaipmh
Description
The publish OAI-PMH operation exposes your media's metadata in a OAI-PMH repository for harvesting by OAI-PMH aware applications.
Parameter Table
| Configuration Keys | Description |
|---|---|
| download-flavors | Distribute any mediapackage elements with one of these (comma separated) flavors to download |
| download-tags | Distribute any mediapackage elements with one of these (comma separated) tags to download |
| streaming-flavors | Distribute any mediapackage elements with one of these (comma separated) flavors to streaming |
| streaming-tags | Distribute any mediapackage elements with one of these (comma separated) tags to streaming |
| check-availability | Check if the distributed download artifact is available at its URL (default: true) |
| repository | The name of the OAI-PMH repository where the media should be published to |
| external-template | The optional URL template for URL the OAI-PMH publication element |
| external-channel | The optional channel name for the OAI-PMH publication element |
| external-mime-type | The optional mime type for the OAI-PMH publication element |
Note: The all or none of the configuration keys external-template, external-channel and external-mime-type must to
be set.
Customizing the OAI-PMH Publication Element
If the configuration keys external-template, external-channel and external-mime-type are not set, the publication
element will use the following default values:
| Field | Default Value |
|---|---|
| url | prop.org.opencastproject.oaipmh.server.hosturl + org.opencastproject.oaipmh.mountpoint + repository |
| mime type | "text/xml" |
| channel name | "oaipmh-" + repository |
Note that org.opencastproject.oaipmh.server.hosturl is defined in
etc/org.opencastproject.organization-mh_default_org.cfg and org.opencastproject.oaipmh.mountpoint is defined in
custom.properties and defaults to /oaipmh.
Example:
http://localhost:8080/oaipmh/default
The OAI-PMH publication element can be customized by setting the configuration keys external-template,
external-channel and external-mime-type.
The URL of the publication element can be set by using external-template. The following variables can be used in the
template:
| Variable Name | Description |
|---|---|
| event | ID of the event being published |
| series | ID of the series being published |
Example:
https://www.externalURL.com/watch.html?series={series}&id={event}
The configuration key external-mime-type is used to set the mime type of the content return when accessing the
URL of the publication element.
The configuration key 'external-channel' is used to set the name of the publication channel.
Operation Example
- id: publish-oaipmh
description: Publish event to the OAI-PMH repository
configurations:
- download-tags: oaipmh-download
- streaming-tags: oaipmh-streaming
- check-availability: true
- repository: default