Publish assets to media platforms

For every Stage (media platform), you create one or multiple "Stage Handlers", which define the set of assets ("scope") and the metadata which gets published to the Stage at a time. For every Stage Handler, you can decide when and for how long the included assets should be published. You can also update the assets within a Stage Handler automatically on the Stage when they are changed in CELUM Content (e.g. if a new version is uploaded).

If you often publish Stage Handlers with the same properties (e.g. the same assets with different metadata or different assets to the same Stage account), you can use a "Stage Handler Master" as a template to set up multiple Stage Handlers with the same properties. The Stage Handler Master acts as a template for Stage Handlers, which can inherit properties from the Stage Handler Master.

The Backstage main view tab has the same layout as other main view tabs. However, instead of the navigation tree, the left side contains a list of all available Stages and existing Stage Handler Masters for each Stage. You can identify the Stage Handler Masters by their icon . The right side contains two tabs:

• Stage Handler: A list of available Stage Handlers within a selected Stage Handler Master or within the selected Stage. You can identify Stage Handlers by their icon.

• Settings: The configuration area for a selected Stage Handler or Stage Handler Master.

Normally, you start by creating a Stage Handler Master for a fresh Stage:

1. Click on the "New" button in the active menu. A dialog opens and you can choose the Stage which you want to create the handler for.

2. Click "Create new Stage Handler Master" to create a new Stage Handler Master.

   Alternatively, you can choose an existing Stage Handler Master to immediately create a new Stage Handler in it.

3. The "Settings" tab now shows a lot of fields to configure the Stage Handler Master. Required fields are marked by an asterisk (*). You can leave optional fields empty for now and fill them later for each individual Stage Handler. The first field set is independent of the Stage and always contains the same fields:

• Name: Enter the name of the Stage Handler Master

• Description: Enter an optional description.

• Trigger: Choose the publishing method for the Stage Handlers inside the Stage Handler Master. You can choose between manual or repeated automatic publishing.

  All other fields in the Stage Handler Master depend on the currently chosen Stage. Most fields have various input modes which allow you to connect field values to asset metadata.

4. Click "Save changes" to finish the configuration process. You can always change the Stage Handler Master's settings later.

5. After you saved the Stage Handler Master, you can choose to immediately create a Stage Handler in the master. Click "Yes" if you want to proceed.

Input modes

1. Click on the "New" button in the active menu. A dialog opens and you can choose the Stage which you want to create the handler for.

2. Choose an existing Stage Handler Master which you want to create the Stage Handler in.

3. The "Settings" tab now shows a lot of fields to configure the Stage Handler. Required fields are marked by an asterisk (*). The first field set is independent of the Stage and always contains the same fields:

• Name: Enter the name of the Stage Handler.

• Trigger: Choose the publishing method for the Stage Handler. You can choose between manual or repeated automatic publishing.

• Scope: Choose the parent nodes whose assets you want to publish. You can add multiple nodes of different types.

• Recursive: Check this box to publish all assets underneath the chosen nodes' structure, i.e. also assets in sub-nodes.

  All other fields in the Stage Handler depend on the currently chosen Stage. Most fields have various input modes which allow you to connect field values to asset metadata.

4. Save the changes. We also recommend that you test the connection to the Stage (e.g. the YouTube account used) with the "Test connection" button.

5. Next, you can start publishing the Stage Handler.

Input modes

Select a Stage Handler Master and subsequently a Stage Handler in the "Stage Handler" tab. You can then synchronize a Stage Handler from the list in order to publish or remove its assets:

• Automatically run all Stage Handlers within the selected Stage Handler Master with the "Sync all now" button. It depends on each handler's current status if the assets are uploaded to or removed from the Stage.

• Double-click a Stage Handler to open it and run it manually or schedule its publication. This opens the Stage Handler's overview. The overview shows the Stage Handler's name and information, as well as all included assets and their status:
  

To publish or update a Stage Handler and all its assets, turn the "Stage Handler" toggle button in the handler's title bar to the "on" position and click the "Sync now" button. The assets are uploaded to the Stage.

To withdraw a Stage Handler from publication, turn the "Stage Handler" toggle button back to the "off" position and click the "Sync now" button again. The assets are removed from the Stage.

To cancel a Stage Handler's synchronization, click "Cancel".

During each synchronization (either publication or removal of the assets), the Stage Handler's title bar shows the synchronization status of the handler and the asset list shows the synchronization status for each asset:

Icon	Meaning
	Shown for each asset in the "Sync Status" column if the publication or removal of the asset was not successful. In this case, an error message is also displayed in the "Error" column. Shown in the Stage Handler's title bar if the whole handler's synchronization could not be triggered, probably due to a configuration error in the settings.
	Shown for each asset in the "Sync Status" column if the publication or removal of the asset was successful. Shown in the Stage Handler's title bar if the whole handler was synchronized successfully (no errors occurred and all assets are synchronized).
	Shown in the Stage Handler's title bar if the handler was synchronized, but at least one asset was not synchronized successfully.
	Shown in the Stage Handler's title bar directly after you triggered the synchronization. The synchronization is queued but has not started yet.
	Shown for each asset in the "Sync Status" column while the publication or removal of the asset is running. Shown in the Stage Handler's title bar during synchronization of the handler.
	Shown in the Stage Handler's title bar if the synchronization was cancelled.
	Shown for each asset in the "Published" column if the asset was successfully published to the Stage.
	Shown for each asset in the "Published" column if the asset was successfully removed from the Stage.

 

Schedule a stage handler for publication

You can either enter a publication schedule whenever you turn a the "Stage Handler" toggle button of a Stage Handler "on" , or before any subsequent synchronizations with the "Schedule" button in the Stage Handler's title bar.

Whenever you turn a Stage Handler's "Stage Handler" button on or click the "Schedule" button, a dialog appears. Check the "Publication schedule" box in the dialog and choose a start and end date and time. During the chosen time period, the Stage Handler's assets will be published on the Stage. They will then be removed and the Stage Handler will be taken offline. You can choose just a start date, which means the assets will be published indefinitely (or until you take the handler offline) after that date, or just an end date, which means the assets will be published immediately, but taken offline automatically at the end date.

Outside of the "Backstage" main view tab, you can also see an asset's publication status (online or offline) in the asset's detail view when you navigate to the asset.

The "Public URLs" detail view tab shows you all public references of the selected asset. Public URLs are created by all CELUM Backstage connectors (MovingImage, MS Azure, Webserver and YouTube connector) as well as some other CELUM Content product extensions. Public URLs provide direct links to assets on distribution and media platforms like public web servers, Backstage Stages, or CDNs. The public URLs are organized by the provider (e.g. the different Stages) on the left, and by instance and URL type on the right. The screenshot shows the example of provider "YouTube" (a Backstage Stage) with two instances (Stage Handlers). Each instance delivers two public URLs with the "standard" and "mobile" type. Click on a public URL to open the link in a new browser tab.

The "Stages" detail view tab shows you a list of each Stage Handler which the selected asset is published with. For each Stage Handler, you can see if the asset is online or offline and if the last synchronization was successful or has failed. You can open the public URL or jump directly to the Backstage main view tab. Click "More details" to see statistics about the asset on the Stage.