Tag-By-DC-Term Workflow Operation

ID: tag-by-dcterm

Description

With the tag-by-dcterm opweation it's possible to select various media package elements and then modify their tag set and / or set their flavor according to whether a Dublin Core term in a catalog has a specific value.

So for example it's possible to pick elements like the Dublin Core catalogs that have been added to the media package at the beginning of the workflow and tag them, so they can be picked up by operations later on or even an application that harvests the mediapackage from a publication channel.

In combination with configure-by-dcterm operation workflows can be controlled by the metadata contained within the Dublin core catalogs.

Parameter Table

Tags and flavors can be used in combination.

configuration keys	example	description	default value
source-tags	"engage,-publish"	Tag any media package elements with one of these (comma separated) tags. If a source-tag starts with a '-', media package elements with this tag will be excluded.	EMPTY
source-flavors	"presentation/trimmed"	Tag any media package elements with one of these (comma separated) flavors.	EMPTY
dccatalog	"episode" or "series"	the subtype of catalog in which to search for dcterm	EMPTY
dccatalog-type	"dublincore"	the type of catalog in which to search for dcterm	"dublincore"
dcterm	"{http://purl.org/dc/terms/}creator"	the XML Expanded Name, consists of a namespace and the name of the Dublin Core term which to check	EMPTY
match-value	"Joe Bloggs"	the Dublin Core term value to check for	EMPTY
default-value"	"Anon"	the implied value if the dublincore term is not present in the catalog	EMPTY
target-tags	"tagged,+engage" / "-engaged,+tagged"	Apply these (comma separated) tags to any media package elements. If a target-tag starts with a '-', it will be removed from preexisting tags, if a target-tag starts with a '+', it will be added to preexisting tags. If there is no prefix, all preexisting tags are removed and replaced by the target-tags.	EMPTY
target-flavor	"presentation/tagged"	Apply these flavor to any media package elements	EMPTY
copy	"true" or "false"	Indicates if matching elements will be cloned before tagging is applied or whether tagging is applied to the original element. Set to "true" to create a copy first, "false" otherwise.	FALSE

Note: see tag operation for further explanation of the source/target-flavor/tags

dccatalog

The flavor subtype of Dublin Core catalog in which to look for the dcterm. This will usually be episode or series.

dccatalog-type

The flavor type of Dublin Core catalog in which to look for the dcterm. This will usually be dublincore. Will default to 'dublincore'.

dcterm

The expanded name is a pair consisting of a namespace name and a local name. The local name is the name of the Dublin Core term to look for in the dccatalog and the namespace name is the name of the namespace it belongs to. The Dublin Core term could be one of the terms set by Opencast or an additional term adding to the catalog.

match-value

The value of the dcterm which to match against. The comparison is case sensitive.

default-value

If default-value is used when the dcterm is not found in the catalog. If not specified the operation will treat the match as false and not tag anything. If default-value is specified the operation will compare the match-value to the default-value and apply the tags if they match. This allows an implied value to be explicitly and clearly defined. For example if you have mediapackages that were created before additional metadata was added to the episode catalog you may want to imply that the audience term has a value of all-enrolled.

Operation Example

  - id: tag-by-dcterm
    description: Tagging media package elements according to dcterm
    configurations:
      - source-flavors: dublincore/*,security/*
      - dccatalog: episode
      - dcterm: "{http://purl.org/dc/terms/}audience"
      - match-value: learning-difficulties
      - default-value: all-enrolled
      - target-tags: +publishBeforeEditing