Import

These plugins enable you to import objects into Ooyala Flex.

Import

Asset Folder Import Action

Properties:

Table 1.
Field Value Explanation
Icon Plugin icon
Sub-type Import Sub-type of this Plugin
Classification I/O Classification of this Plugin
Deployment Internal Whether the plugin is deployed inside Ooyala Flex or within another product
Supports Configuration Whether this Plugin supports configuration
Supports Scripting Whether configuration supports Scripting
Scripting Context job, asset, event * What Ooyala Flex Objects can be referenced from within the Scripting context. * Note the Event Object is only visible in the context of an Action running in an Event Handler.
Undo Action   The Action required to undo this Action
Redo Action   The Action required to redo this Action
Timeout   Whether or not to select a timeout
Auto retry   Whether or not to select an automatic retry
Compatibility 5.x What versions of Ooyala Flex this Plugin works for
Lifecycle Stable Maturity of this Plugin (Experimental, Unstable or Stable)

 

Configuration:

Table 2.
Field Field Type Mandatory Multiplicity Description
Source Folder complex 1 Details of the asset to import

Source VFS Location

complex 1 The Virtual File System location of the root folder

Protocol

single option   Protocol for accessing the location

Hostname

string   Hostname for accessing the location (mandatory except for file, s3, google or dropbox protocols)

Port

string   Port for accessing the location (mandatory except for file, s3, google or dropbox protocols) (#)

Path

string   Path for accessing the location (absolute path starting with / except for ftp, sftp, ftps which are relative to the User's home directory)

Username

string   Username for authentication (not required for file protocol)

Password

password   Password for authentication (not required for file, s3, google or dropbox protocols)

Key

string   Key for authentication (only applicable to s3, google and dropbox protocols)

Secret

string   Secret for authentication (only applicable to s3, google and dropbox protocols)

Token

string   Token for authentication (only applicable to google and dropbox protocols)

Bucket

string   Only applicable to S3 protocol

Private Key File

file   Only applicable for SFTP certificate authentication

Source Resource

single option   The Source Resource for the root folder.
Allowed File Extension string 1..* If specified, only files with this extension will be processed.
Update Assets boolean   If a file last modified date is later than the asset creation date, re-extract the technical metadata.
Asset Group Details complex 1 If specified, an asset group will be created. All imported assets will be added to this group.

Group Name

string   The asset group will be created with the specified name.

Variant

complex 1 Specify the Variant and optionally the Metadata Definition to set on the asset group. If not specified, a default will be used if it has been configured.

Variant

string   The Variant to use for the group. This must be a valid configured Variant name.

Metadata Definition

single option   The Metadata Definition to use.

Variable Name

string   If specified, the asset group will be stored as a variable with this name.

 

Multi Asset Import

This plugin supports the import of multiple Assets.

Properties:

Table 3.
Field Value Explanation
Icon Plugin icon
Sub-type Import Sub-type of this Plugin
Classification I/O Classification of this Plugin
Deployment Internal Whether the plugin is deployed inside Ooyala Flex or within another product
Supports Configuration Whether this Plugin supports configuration
Supports Scripting Whether configuration supports Scripting
Scripting Context job, asset, event * What Ooyala Flex Objects can be referenced from within the Scripting context. * Note the Event Object is only visible in the context of an Action running in an Event Handler.
Undo Action   The Action required to undo this Action
Redo Action   The Action required to redo this Action
Timeout   Whether or not to select a timeout
Auto retry   Whether or not to select an automatic retry
Compatibility 5.x What versions of Ooyala Flex this Plugin works for
Lifecycle Stable Maturity of this Plugin (Experimental, Unstable or Stable)

 

Configuration:

Table 4.
Field Field Type Mandatory Multiplicity Description
Source File complex 1..* Details of the source file to import. If not specified no media file will be imported to the asset.
  • Source File Path
string   Location of the media file to import.
  • Original Filename
string   The value to set as the original filename of the imported media file. If not specified, this will be the file name.
  • Copy File
complex 0..1 Copy the file to a new location. If not specified the media file will be ingested in place. One of either the target resource or folder can be specified.

Target Resource

Resource (Folder)   The Folder Resource for the imported media file to be copied to.

Target Folder Path

string   The target folder path for the imported media file to be copied to.
Asset Details complex   Descriptive details for the asset.
  • Title
string   The title of the asset.
  • Description
string   Optional description for the asset
  • Placeholder Asset Type
single-option 0..1 The Placeholder Asset Type to create if no source file is specified
  • Creation Context
single-option   The creation context to set on the asset.
Variant complex 0..1 Specify the Variant and optionally the Metadata Definition to set on the asset. If not specified, a default will be used if it has been configured.
  • Variant
string   The Variant to set. This must be a valid configured Variant name.
  • Metadata
complex 0..1 Specify a Metadata Definition to set. If not specified, a default will be used if it has been configured.

Metadata Definition

Metadata Definition 0..1 The Metadata Definition to set.

Source XML

complex 0..1 Set the metadata based on details stored in an XML file. If not specified a default metadata instance will be created.

Source XML Path

string   Location of the source XML file to read.

XSLT

file 0..1 Optional XSLT to apply to source XML. If not defined then XML is expected to be in Ooyala FlexMetadata XML form.
Keyframe complex 0..* Keyframe to set on the asset. This will be used only if the imported asset is a media file. If an image file it will be ignored.
  • Source Keyframe Path
string   Location of the source keyframe to import.
  • Title
string   Optional title for the keyframe.
  • Keyframe Description
string   Optional description for the keyframe.
  • Timecode
string 0..1 Optional timecode for the keyframe. If defined the keyframe is imported as an extracted keyframe, otherwise it is imported as an uploaded keyframe.
  • Master
boolean   Whether the keyframe should be set as master. If multiple keyframes are configured as master, the last to be imported will be set as master for the asset.
Asset Relationships complex   Relationships to define against existing Assets in the system.
  • Child
complex 0..1 Add a parent-child relationship.

Parent Asset

complex   Specify the parent asset.

Parent Asset

asset 0..1 Select the parent file asset to use.

Parent Asset ID

string 0..1 Specify the parent file asset ID or use an expression.

Reference Name

string   Optional reference name to set on the parent-child relationship.
  • Member
complex 0..* Add a group-member relationship.

Parent Group Asset

complex   Specify the parent group.

Group Asset

asset 0..1 Select the parent group asset to use.

Group Asset ID

string 0..1 Specify the parent group asset ID or use an expression.
  • Membership Name
string   Optional membership name to set on the group-member relationship.
Workflow Variable Name string 0..1 Specify the Workflow variable name to use to store the created Asset. If this is not specified, the Asset will not be set as a Workflow variable.
Store Asset in Context     Stores the created Asset in the context

 

Attachment Import

Supports the import of an attachment file and association with an existing Object inside Ooyala Flex.

Properties:

Table 5.
Field Value Explanation
Icon Plugin icon
Sub-type Import Sub-type of this Plugin
Classification I/O Classification of this Plugin
Deployment Internal Whether the plugin is deployed inside Ooyala Flex or within another product
Supports Configuration Whether this Plugin supports configuration
Scripting Context job, asset, event * What Ooyala Flex Objects can be referenced from within the Scripting context. * Note the Event Object is only visible in the context of an Action running in an Event Handler.
Scripting Context User, Asset What Ooyala Flex Objects can be referenced from within the Scripting context
Undo Action   The Action required to undo this Action
Redo Action   The Action required to redo this Action
Timeout   Whether or not to select a timeout
Auto retry   Whether or not to select an automatic retry
Compatibility 5.x What versions of Ooyala Flex this Plugin works for
Lifecycle Stable Maturity of this Plugin (Experimental, Unstable or Stable)

Configuration:

Table 6.
Field Field Type Mandatory Multiplicity Description
Object ID string 0..1 The ID of the Object the file should be attached to. If not specified - the current Object will be used.
VFS Location Complex   Location of the attachment
Protocol Resource   Protocol for accessing the location
Hostname String   Hostname for accessing the location (mandatory except for file, s3, google or dropbox protocols)
Port String   Port for accessing the location (mandatory except for file, s3, google or dropbox protocols) (#)
Path String   Path for accessing the location (absolute path starting with / except for ftp, sftp, ftps which are relative to the User's home directory)
Username String   Username for authentication (not required for file protocol)
Password String   Password for authentication (not required for file, s3, google or dropbox protocols)
Key String   Key for authentication (only applicable to s3, google and dropbox protocols)
Secret String   Secret for authentication (only applicable to s3, google and dropbox protocols)
Token String   Token for authentication (only applicable to google and dropbox protocols)
Bucket String   Only applicable to S3 protocol
Private Key File File   Only applicable for SFTP certificate authentication
Attachment Name String 0..1 Name for the uploaded attachment.
Attachment Description     Description for the attachment.

Was this article helpful?