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
<operation
id="publish-oaipmh"
description="Publish event to the OAI-PMH repository">
<configurations>
<configuration key="download-tags">oaipmh-download</configuration>
<configuration key="streaming-tags">oaipmh-streaming</configuration>
<configuration key="check-availability">true</configuration>
<configuration key="repository">default</configuration>
</configurations>
</operation>