Amberfin transcoding Action Plug-in



Overview: This Action plug-in provides the ability to submit file transcoding job to a Amberfin server.

Saved Parameters Description

   
Name The name used to identify a saved Amberfin Transcoding configured instance.
Comments The comments of the Amberfin Transcoding template.
Amberfin Server Node The remote node name of the server which hosts the Amberfin Transcoding server.
Amberfin Server IP address (or hostname) The remote host name or remote IP of the server which hosts the Amberfin Transcoding server.
Amberfin API port (optional) The port number of remote server which hosts the Amberfin Transcoding server.
Operation Select from dropdown if the job is a repurpose or transcode.
Amberfin Templates A dropdown of Amberfin templates available on Amberfin server to repurpose and transcode files.
Template Id (hidden) Id of the Amberfin template selected.
Source file The absolute path to the file on the server's file system.
Target directory The absolute path to the directory on the server's file system.
Transcode XML The fully constructed XML with job details. This will stop Orchestrator from constructing its own XML.
Status Polling frequency How often progress will be reported. Default is 5 seconds.

Inputs Description

The list of inputs depends on the configuration of the AmberfinTranscoding action template.

All required parameters are available as inputs at runtime if not specified by the template. This plug-in does not support value overwrites: if a value is specified in the template it will not be available as input of the step at runtime.

Mandatory Inputs for Both Repurpose and Transcode Operations:
Input Description
Amberfin Server Node or Amberfin IP Address Either a remote node must be selected or a remote IP address must be provided.
Template ID A template ID is mandatory while submitting a job, thus a template must be selected from dropdown.
Source file The user must provide the absolute path to the source file on the remote server.

Mandatory Fields if Transcode Operation is Selected

   
Target directory The user must provide the absolute path to the directory on the remote server to perform the transcode operation.

Optional Inputs

Inpur Description
Name It is advisable that a name is entered to identify the template.
Comments Information about the template which will help identify the template.
Operation Selecting an operation from dropdown tells the plugin what to do. Defaults to repurpose when not chosen.
Amberfin API Port The port is optional as a default value is used if not specified.
Transcode XML The port is optional as a default value is used if not specified.
Status Polling frequency Specify if progress needs to be reported within a time other than default.

Outputs Description

Output Description
Input_file The input file path involved in the transcode operation
Output_file The output file obtained as a result of the transcode operation
Job_Id The ID of the job triggered by the transcode operation
Errors Errors reported by transcode server during transcode operation

Operating Instructions

This plug-in allows users to provide necessary inputs required for a Amberfin server to do a transcode job; see the mandatory inputs listed above.

An example of a transcode job is given below. Currently, only a single source file can be specified. Target (if specified) is used by the template setup on the Amberfin server to place the output file.

Transcode Job Example

1. Enter the remote node or remote server IP and port (example: 10.0.103.85 or transcode.lala.com).

2. Decide what operation is needed - Repurpose or Transcode.

3. Click Get Amberfin Templates. This provides a dropdown with templates from the provided Amberfin server.

4. Select a template from the dropdown. The template ID is submitted along with source file path to Amberfin server.

5. Provide the source file name (for example, /data/input/expendables.avi) and a target directory (for example, /data/output/. The Amberfin server takes these inputs and performs the job.