Select Version Workflow Operation

ID: select-version

Description

The select-version operation replaces the current media package in the running workflow with a previous version from the asset manager. This operation should be one of the first operations in a workflow e.g. before ingest-download.

This operation is useful in situations where we want to run a workflow using an older version of the media package from the asset manager, such as rolling back, retrieving discarded media previously archived, etc.

There are currently two ways of specifying which version to select, which are mutually exclusive:

• A version number
• A combination of source-flavors and no-tag (see below).

How to find the desired version of the media package?

There isn't currently an easy way to list all the versions of a media package. If you have access to the database, you can query it with:

    select version, archival_date, mediapackage_xml
        from oc_assets_snapshot
        where mediapackage_id = “A_MEDIA_PAGKAGE_ID”;

where:

• version: version number
• archival_date: date and time the media package was saved to the Asset Manager
• mediapackage_xml: media package in xml format

Parameter Table

configuration key	description	example
version	Which version number to select from the asset manager	0
source-flavors	The flavors where to check for non-existence of the tags passed in no_tags	presenter/delivery
no-tags	Tags that need to be absent in the elements with source-flavors flavor	aTag

Examples

Example 1

Select version 0 of the media package from the asset manager:

<operation id="select-version"
           description="Select version 0 of media package to use in current workflow">
    <configurations>
        <configuration key="version">0</configuration>
    </configurations>
</operation>

Example 2

Select the latest version where delivery media do not have the tags hls-presenter-mp4 and hls-presentation-mp4:

<operation id="select-version"
           description="Select version with no hls tags in delivery media to use in current workflow">
    <configurations>
        <configuration key="source-flavors">presenter/delivery,presentation/delivery</configuration>
        <configuration key="no-tags">hls-presenter-mp4,hls-presentation-mp4</configuration>
    </configurations>
</operation>