Ooyala Flex 5.5.0 Release Notes 2017-05-01

Components/Updates required

  • Master
  • Publish
  • Transfer
  • Index
  • Job Nodes
  • Reviewer

Known Issues

  • Forms: When referencing an object within a metadata schema, the lookup is not displaying any values. This will be fixed in 5.5.1.
  • Web Transfer: Files with same name can not be uploaded in a different group. This will be fixed in 5.5.1.

What's New

Metadata Designer: Thesaurus

A thesaurus tool has been added to the Metadata Designer. The thesaurus enables you to create a comprehensive list of terms with relational mapping, and then associate those terms with metadata fields elsewhere in Ooyala Flex, for example: in MAM, Reviewer, or Web Transfer.  You can then reference the thesaurus when you are filling out metadata fields in Ooyala Flex.

The thesaurus tool gives you the ability to:

  • Create thesauri
  • Manage individual thesaurus properties (name, description, permissions)
  • Add / remove terms
  • Manage the relationships between terms

The tool can be used to create reflexive relationships between terms. The relationships that can be created between terms are as follows:

  • Related Term: When one term is closely related to another term. Examples:
    • You could create hierarchical relationships such as the word “t-shirt” to be a related term for “clothing”.
    • You could also create a relationship between terms that are similar, such as “chair” and “chairman”.
  • Use: When you want a specific term to replace the user entered term. For example: “outwear” could replace “clothing”.
  • Used For: When you want to suggest a specific term instead of the user entered term. For example: “outwear” could be used instead of “clothing”.
  • Broader Term: When one term is related to another particular term, but also has a wider meaning. For example: you might want the word “jacket” to be used as a broader term for “blazer”, “overcoat”, and “parka”.
  • Narrower Term: When one term is related to another particular term, but also has a more specific meaning. For example: you might want the word “blazer” to be a narrower term for “jacket”.

The thesaurus can be accessed from two field types. These are:

  • Text fields
  • Textareas



You can access workspaces that you have the permission to see in MAM. With the added workspace functionality, you are able to:

  • View and edit the properties for a workspace directly in MAM.
  • View and edit the metadata associated with a workspace.
  • Comment against a workspace.
  • View the members that are in a workspace.

Bulk Metadata

You can now apply metadata to multiple assets simultaneously in MAM.


You now have the ability to create review sessions for image assets in Reviewer. The changes to Reviewer in relation to this include:

  • The addition of a new Start Image Review plugin, which enables you to start a new image review.
  • The addition of a new Stop Image Review plugin, which enables you to complete an image review.
  • New UI to accommodate image review sessions. This includes the ability to annotate against an image, and leave a regional comment.

Web Transfer

  • UI Update: The Web Transfer module has had a complete UI redesign, making it more aesthetically pleasing, and easier to use.
  • Bulk Uploads: The ability to perform bulk uploads has been added. You are now able to select multiple files and upload them to Ooyala Flex with a group context. Workflows can be processed independently per asset, with the addition of group processing such as a singular notification on successful import.
  • Bulk Metadata: The ability to apply common metadata across multiple assets during a bulk upload has been added.


Workflow Group Endpoints

New endpoints have been added which enable users to create and edit workflow groups. These have been created in order to accommodate the new bulk upload functionality in Web Transfer.

Resource Endpoint Method
workflows: workflows/groups Post
workflows: workflows/groups/{groupId} Get / Put

Keyframe ID Raw Endpoint

An endpoint has been added that enables users to retrieve a stream of bytes.

Resource Endpoint Method
assets: assets/{assetId}/keyframes/{keyframeId}/raw Get

New Parameters

  • A New matrix parameter accountId has been added to quotas, which enables users to create quotas using an account ID.
  • A new query parameter signedURL has been added to the GET request for assets. This query parameter returns a link to an asset stored in s3. This link enables you to download a file stored in s3 without needing to log in.

Azure Blob Storage

The following plugins have a new option in the Protocol field, in order to accommodate Azure Blob Storage.

A new Azure Blob Storage option (AZBS) in the Protocol drop down in the configuration section has been added for the following plugins:


  • Archive
  • Copy
  • Create Proxy
  • Delete
  • Delete archive ("External Resource" which can be configured with AZBS)Export (in export you need to provide Target Location which is a VFS URL, so here you can provide AZBS storage location url)
  • Import
  • Move
  • Publish
  • Transcode
  • Rename
  • Restore
  • Restore Archive. ("External Resource" which can be configured with AZBS)


  • Storage
  • External (outbound/div archive)
  • QC
  • Transcode
  • Workflow
  • CDN Storage
  • All Quota plugins including:
    • Transfer Bytes Over Time
    • Storage Bytes
    • Maximum Bandwidth
    • Processes


New Categories

Two New Categories have been created in relation to the changes to Reviewer. These are:

  • Start Session

  • Stop Session

Start Image Review

A plugin has been added, which allows users to open an image asset review session. This falls under the Start Session category.

Start Video Review

The “Open Asset Review Session” plugin has been renamed to “Start Video Session”. This falls under the Start Session category.

Stop Image Review

A plugin has been added, which allows users to close an image asset review session. This falls under the Stop Review category

Stop Video Review

The “Close Asset Review Session” plugin has been renamed “Stop Video Review”. This falls under the Stop Review category.

Note: All old open and close review session plugins have been deprecated in 5.5.0 onwards. From now on, Start Image, Stop Image, Start Video, and Stop Video review plugins should be used instead.

Ooyala Flex Publish

Ooyala Flex Query Language

A query Language has been added in Ooyala Flex Publish. This query Language enables you to carry out structured searches across your published assets. The query language includes a series of operators which help you carry out searches. These are as follows:

  Operators Description
Logical Operators AND OR ! Logical operators are used to search for multiple terms simultaneously.


  • You can search for two different terms using the OR operator such as: movie OR  film.
  • You can search for multiple terms using the AND operator such as: movie AND film.
Quotes "" Quotes are used to search for an exact word or phrase. You wrap the word or phrase in quotation marks.

Example: description="city"

Comparison Operators >= <= < > Equal or greater, equal or lesser, lesser and greater operators are supported.
Boosting ^ You can boost a term using a caret (cursor) symbol.

Example: description^5=city. In this example all the assets which have the word city in the description field will be more relevant in the search.
Brackets () Brackets are used to differentiate an exact match and when you want to search for a field which may contain some of our terms we use them between brackets.

Example: description=(European City) In this example you are searching objects where the description contains European and City but not necessarily an exact match.
Free Text Search   This is when you enter a word or phrase without applying any of the above syntax.

Example: you could simply search for the word city.

Publish API

  • Search Assets: An API has been added, which gives you the ability to search for assets using the publish API. You can do this using the Ooyala Flex Query Language. Example: http://<publish-url>/public/api/assets/search
  • Reindex: An API has been added, which enables you to perform a reindex on Elastic Search. Example: http://<publish-url>/api/accounts/{accountId}/elastic/reindex


Service Version Required Instructions
flex-admin-app 2.0.303  
flex-authentication-service 7.2.166  
flex-authorisation-service 2.0.170  
flex-dataagreggation-service 1.2.230  
flex-divarchive-service 2.1.216  
flex-events-service 2.1.145  
flex-fastobject-service 3.2.193  
flex-forms-service 0.0.43  
flex-imageproxy-service 3.2.164  
flex-indexelastic-service 5.7.165  
flex-mam-app 4.2.364  
flex-metadatadesigner-app 2.1.489  
flex-metadatamerge-service    2.2.201  
flex-outboundtransfer-service 2.0.119  
flex-publish-service 9.3.203  
flex-reviewer-app 3.0.250  
flex-searchelastic-service 4.2.248  
flex-streamprocessor-service 1.1.75  
flex-tag-service 1.0.471  
flex-thesaurus-service 0.0.654  
flex-webtransfer-app 7.0.218  
flex-workflowdesigner-app 7.0.110