Creating a New Action

1) On the Toolbar, click the New option.

2) From the drop down, select Action.

3) Assign a name and visibility for your new Action.

4) Assign a Plugin Type and a Plugin. The Plugin Type is the Action Type that you wish to create. Once you have selected a Plugin Type, the Plugins available for this Plugin Type will be made available in the field below. Select your Plugin from the list.

5) Specify a Timeout by selecting the checkbox, and then entering a value. A Timeout value specifies how long a Job with this Action can run before it is deemed timed out. This is an optional field.

6) Assign a Run Rule Expression. A Run Rule value specifies the rules that govern when an Action can be run. This is an optional field that comprises some Script.

7) Select the checkbox next to the Timeout and Auto Retry fields if applicable.

8) Once you've created your Action, select the Configuration sub-tab in order to define the values that you wish to assign to your new Action.

8.) Enable your Action, by clicking the Enable option in the Action Details screen.

The properties that are specific to an Action are:

Action Type: The type of Action, for Example Transcode, Ingest or QC.

Timeout: This field sets the maximum time a Job can run this Action before the Job Scheduler sets the Job to Timed Out. This functionality is useful for warning Users of Ooyala Flex that a Job has been running longer than anticipated. This field is not mandatory.

Run Rule Expression: A Run-Rule Expression is used to define when an Action can be run and should be made visible in the Asset Toolbar. The value of this field is a Scripted expression that is run to identify whether it should be visible or not.

Plugin: The name of the API plugin that carries the functionality for this Action.

Undo Action: This points to an Action that reverses the current Action. For example for "Publish to YouTube", you might select an "Un-Publish from YouTube" Action if there is one. This approach means that when you have published an Asset to YouTube, Ooyala Flex knows what Action to offer you to reverse it. This field is not mandatory, in which case you will not be offered the opportunity to Un-Publish.

Redo Action: This points to the Action that repeats the current Action. For example for "Publish to YouTube", you might select a "Re-Publish to YouTube" Action if there is one. This approach means that when you have published an Asset to YouTube, Ooyala Flex knows what Action to offer you in order to repeat it. This field is not mandatory, in which case you will not be offered the opportunity to Re-publish.

Note: Although Actions are used by Ooyala Flex within Jobs and Workflows Definitions, they are typically only configured by Super Users.

Timeout

Actions support an optional Timeout field. If a Timeout is set, then when this Action is run as a Job, if the Job runs longer than the Timeout period, the Job will be marked as Timed Out. This state change will generate an Event but will continue running to completion. Timeout periods provide a very useful way of knowing if a Job has been running longer than expected.

You can select the Time Out period from the drop down.

Run Rules

A Run Rule is an expression that is evaluated in order to decide whether an Action can be run in a certain context. Every Action has a default Run Rule which can be overridden. Run Rules are extremely valuable if you only wish to make a certain Action available when it is in a certain state. For example you may only wish to make a Publish to YouTube Action available, if an Asset is not deleted.

Undo and Redo Actions

Some Action Types support the concept of being undone or redone. Clearly this functionality does not apply to all Action Types. For example, it would make no sense to redo a Delete Action. A good example of an Action Type that supports both Undo and Redo is the Publish Action. It makes sense that some Publish Actions should allow you to unpublish and republish your content if the need arises.

The Undo and Redo Actions can be referenced by a standard Action (i.e. a Publish Action), so that after an Action has been implemented, Ooyala Flex knows what undo and redo Actions are available to offer to the User.

This is an example of a Published asset. You can clearly see the Unpublish and Republish options are available.

Was this article helpful?