Download PDF

Workflow Templates specify how media is processed when streamed live and recorded, uploaded through the Ensemble Video web interface, or ingested through a Watch Directory. This is referred to as a Workflow Template because it specifies details such as media server root directory information, live streaming application, and other details necessary to create Media Workflows for the Libraries in your Organizations.

There are four different Workflow Templates you can define for the Organizations in your Ensemble Video Institution.

  1. Upload Directory – for when media content is uploaded and transcoded.
  2. Watch Directory – for ingesting content from media server directories.
  3. Live Stream – for creating live streams where the user controls when streams are recorded.
  4. Live Capture – for creating live streams where all streams are automatically recorded.

A Workflow Template for an Organization specifies important details for how media is streamed, processed and ingested including:

  • Wowza Server Engine application URL for live streaming
  • Storage path that define where uploaded or recorded content will be stored and streamed.
  • Server path for Watch Directory Workflows that define where Ensemble Video will monitor for new content addition
  • Player URL for streaming or progressive download of uploaded, recorded, or Watch Directory content
  • Transcoding preset (encoding recipe) for uploaded and recorded media.

In most cases, Organizational Workflow Templates will be created when the Organization is defined (see Prior section on Organizations).  However, you can still add new Media Workflows for any of your existing Organizations, and when you do you can access a Template dropdown menu which will pull in any Institutional Workflow Templates defined by your Ensemble Video System Administrator for your Institution. The Workflow details will be automatically inserted for whatever Institutional Template you choose.

When creating new Media Workflow Templates, you can use the Auto Create checkbox to specify that any New Library will be created with a Media Workflow based on that Workflow Template.  You can also use the Default checkbox to identify which Upload Workflow will be the Default for new Libraries when Upload Media Workflows are automatically created.

Organization Administrators can also choose any Workflow Template you assign to their Organization when manually adding a new Workflow to an existing Library, so that appropriate details will be filled in automatically (so Organization Administrators won’t need to manually enter this information).

Media Workflow Template

Media Workflow Templates define essential technical information that enable your users to upload media into their Media Libraries using the Add/Edit Wizard.

The storage Path and HTTP/RTMP Path URL define root paths for the media server and the player URL for Library Media Workflows. For storage Path, you can specify a local directory or UNC path. If using a UNC path, you need to provide username, password, and authentication domain.

When creating an Upload Directory Workflow Template for an Organization, you can check the Auto Create checkbox, so that whenever an Organization Administrator creates a new Library within the Organization an Upload Workflow based on the template will be automatically created. The other attributes of the Template, such as the Transcode To setting, upload Maximum Size limits, and so forth, are also automatically inserted whenever the Template is used to create a new Library Media Workflow. The Default checkbox determines which Upload Media Workflow will be the default, if multiple Upload Media Workflows are auto-created.

Accessing Workflow Templates

Click Administration in the navigation pane, click Institution, and click Workflow Templates.

Screenshot of Workflow Templates

In the image above, we have six typical workflow templates already set up. Click the Action selector for a workflow to Edit or Delete it, or click +Add to create a new one. Starting in version 4.2, you can click Action then Clone to create a new Workflow Template based on a previous template.

Upload Workflow Template – Details

Screenshot of the Upload Workflow Template

Institution This dropdown menu shows the name of your Institution (Note: Ensemble Video System Administrators can choose other Institutions)
Template If your System Administrator has created one or more Workflow Templates for your Institution, you will be able to select them here. When you do, many of the details of the form will be automatically inserted, saving you from having to manually specify these values.
Organization The Organization within your Institution that this Workflow Template will apply to.
Name A name for the Workflow. This should be an easily recognizable name; it will show up when you go to look at the list of all the Workflow Templates for all the Organizations in your Institution.
Path This is the storage path where uploaded/transcoded content will be stored. This can be a local path such as “e:\streaming” or it can be a UNC path such as \\streamingserver\streamingpath.
HTTP/RTMP Path This is the streaming path for the content that is uploaded/transcoded.
Subdirectory This specifies the sub-directory that will be automatically created when your Organization Administrator(s) create a new Library for Auto-Create Workflows, or for when they manually create a new Media Workflow for a Library using the Media Workflow control. In this subdirectory, you can use variables to automatically create the Library folder where content will be stored:

  • {{{Library}}} – The new subdirectory folder will be based on the Library name with all special characters removed (the default).
  • {{{Username}}} – The new subdirectory folder will use the username of the logged-in user.
  • {{{Firstname}}} and {{{Lastname}}} – You can use Lastname alone, or put these two together to create a folder name such as “TimSmith”.
User The username for authentication, if you specified a UNC storage path.
Password The password for authentication, if you specified a UNC storage path.
Domain The domain for authentication, if you specified a UNC storage path.
Transcode To Encoding recipe for uploaded content.
Maximum Size Maximum size for uploaded files (defaults to 20 GB).
Default This is used to specify which Upload Media Workflow will be the default in a Library, when you’ve specified that more than one Workflow Template will be auto-created when an Organization Administrator creates a new Library.
Auto Create Check this if you want a Media Workflow based on this Template to be automatically created when a new Library is created within the Organization.
Secure Streaming High content security option used only when Secure Token Passing to the Flash-based Flowplayer is configured on the Wowza Streaming Engine.  This is rarely used as it disables playback on iOS and Android devices, playback can only occur on desktop PCs and Macintosh computers via Flash player.
Restricted Streaming Only used when Wowza Streaming Engine restricted streaming module is configured. This option enables you to limit the number of concurrent viewers for on-demand video assets.
Enabled This checkbox simply activates or de-actives the Workflow Template. When this is not checked the Workflow Template cannot be used to Auto Create Workflows and cannot be access by Organization Administrators to create new Media Workflows.
Watch Directory Workflow Template

The Watch Directory Workflow Template is similar to an Upload Template. It includes a File Filter dropdown menu that determines how the Ensemble Video processes files that are added to a Watch Directory. Watch Directories can be configured to ingest audio-video files, XML files, image galleries, or attachments. For more details see the Ensemble Video Watch Directory Guide at http://support.ensemblevideo.com.

The storage Path and HTTP/RTMP Path URL define root paths for the media server and media URL. For storage Path you can specify a local directory or UNC path. If you use a UNC path you need to provide username, password, and authentication domain.

When creating a Watch Directory Workflow Template you can check the Auto Create checkbox so that whenever an Organization Administrator creates a new Library within the Organization a Watch Directory based on the template will be automatically created. By Default the {{Library}} specification for Subdirectory will auto-create a media server folder based on Library name. Alternatively, you can insert {{Username}}, {Lastname}} and {{Firstname}} variables. This is particularly useful for integrations with external capture technologies such as Crestron CaptureHD and Techsmith Relay. For more on how to integrate these tools with Ensemble Video see the Ensemble Video System Administrator Guide.

Live Stream and Live Capture Workflow Templates

The Live Stream and Live Capture Workflow Templates are used to create workflows for libraries within an Organization where users will be able to create and manage live streams, and these Workflows will dictate how recordings are created and processed. The technical details of these workflows are typically available as an Institution Workflow Template, so you will be able pull in a Template when creating a new Live Stream or Live Capture workflow, for your Organizations, where the technical details will be automatically inserted into the new Workfl0w Template. If that is not the case, contact your Ensemble Video System Administrator.

The Live Stream Workflow Template is used to create workflows for libraries within an Organization where users will be able to create and manage live streams and control when live streams are recorded.

The Live Capture Workflow Template is used to create workflows for libraries within an Organization where users will be able to create and manage live streams, and where ALL streams will be automatically recorded.

Note: You can only define one Live Stream and one Live Capture Template Workflow for an Organization.
When creating a Live Stream or Live Capture Workflow Template for an Organization, you can check the Auto Create checkbox, so that whenever an Organization Administrator creates a new Library within the Organization a Workflow based on the template will be automatically created.

For more on creating and recording live streams using Live Stream and Live Capture workflows, see the Ensemble Video Content Administrator Guide.

Screenshot of the Live Workflow Template

Live Stream and Live Capture Workflow Template – Details
Institution This dropdown menu shows the name of your Institution (Note: Ensemble Video System Administrators can choose other Institutions)
Organization The Organization within your Institution that this Workflow Template will apply to.
Name A name for the Workflow. This should be an easily recognizable name; it will show up when you go to look at the list of all the Workflow Templates for all the Organizations in your Institution.
Live App. RTMP URL This is the Wowza live streaming application URL (server name and live streaming application) where live encoders will send encoded streams.
CDN RTMP Path The CDN RTMP Path is used when the integrated CDN streaming capability has been procured and configured. The CDN service uses a third party Content Delivery Network provider that maintains a global high speed network that is provisioned to support highly scalable streaming and efficient global distribution of Wowza Media video streams. CDN streaming does incur additional cost.  For more details contact us at support@ensemblevideo.com.
Wowza Admin URL Wowza server and port for API calls using Admin credentials (e.g., http://test.ensemblevideo.com:8086).
Wowza Admin Username Username of Wowza Admin for Wowza server API calls.
Wowza Admin Password Password of Wowza Admin for Wowza server API calls.
VOD Path This is the storage path where uploaded/transcoded content will be stored. This can be a local path such as “e:\streaming” or it can be a UNC path such as \\streamingserver\streamingpath.
VOD HTTP/RTMP Path This is the streaming path for the content that is uploaded/transcoded.
Subdirectory This specifies the sub-directory that will be automatically created when your Organization Administrator(s) create a new Library for Auto-Create Workflows, or for when they manually create a new Media Workflow for a Library using the Media Workflow control. In this subdirectory, you can use variables to automatically create the Library folder where content will be stored:

  • {{{Library}}} – The new subdirectory folder will be based on the Library name with all special characters removed (the default).
  • {{{Username}}} – The new subdirectory folder will use the username of the logged-in user.
  • {{{Firstname}}} and {{{Lastname}}} – You can use Lastname alone, or put these two together to create a folder name such as “TimSmith”.
User The username for authentication, if you specified a UNC storage path.
Password The password for authentication, if you specified a UNC storage path.
Domain The domain for authentication, if you specified a UNC storage path.
Transcode To Encoding recipe for uploaded content.
Maximum Size Maximum size for uploaded files (defaults to 20 GB).
Auto Create Check this if you want a Media Workflow based on this Template to be automatically created when a new Library is created within the Organization.