Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

When defining a new format, the following parameters must can be set:

  • Name: A unique name of the format.

  • Description: An optional, more elaborate description of the format. This is visible to users when downloading a rendition that uses the format. It can, e.g., be used to describe which use cases the format is intended for.

  • Format type: The type of the format.

  • Immediately generated for: The asset types for which renditions of the format should be generated immediately when an asset’s file is uploaded or replaced. See below for more information.Mapped media formats:

  • In previous versions, the transcode system worked with a concept of media formats, similar to the new format concept. This parameter can be used when migrating from the old transcode system to the new transcode systemFormat purpose: Indicates if the format should be used e.g. for thumbnails, large thumbnails, video previews, etc..

  • Channel filter: Limits the visibility of the format based on channels. More details can be found here

  • Asset type filter: Limits the visibility of the format based on asset type. More details can be found here.

...

  • Download replace mask: Controls the file name when downloading renditions of the format.

...

Depending on the chosen format type, a number of different parameters will appear. Most parameters should be self-explanatory. However, a short description of some of the key features can be found here.

Generation

Renditions of assets can be either generated on-demand or pre-generated.

...

Note that renditions of a specific format can not be generated for all input file types. For instance, renditions of video or audio formats can not be generated for image assets such as png, jpeg, and webp since it does not make sense to create a video or an audio file from an image. However, renditions of image formats can be generated for most common input file types. Thus, even though a limited set of output formats are available, a wide range of input formats are supported.

Format visibility

The visibility of a format can be controlled via download qualities and format filters.

Download qualities

One use-case for defining a format is to make it easy for users to download renditions of assets in this format. However, by default, a format is not visible in the download dialog in the Media Manager. The visibility of formats in the download dialog can be controlled from the general settings page in the Media Manager, where it can be configured for individual user groups.

...

Note that the configured download renditions formats only affect the visibility of formats in the download dialog and does not affect security. Thus, a user is able to request a rendition of a format that is not visible to the user, as long as the user has access to the asset.

Format filters

A format can be defined with a channel filter and/or an asset type filter.

...

A format is only visible for an asset if the asset passes both the channel filter and the asset type filter.

  • Channel filter:

    • A format is visible for an asset if the asset is published to at least one of the specified channel folders. A format is also visible for an asset if the asset is published to at least one sub channel folder of one of the specified channel folders.

    • If no channel folders are specified, no visibility filtering is applied based on channel folders.

  • Asset type filter:

    • A format is only visible for an asset if the asset has one of the specified asset types.

    • If no asset types are specified, no visibility filtering is applied based on asset types.

Note that the configured format filters only affects which formats the backend indicates can be streamed and downloaded for assets. Consequently, if a user has read access to an asset, the user can request renditions of all formats that can be generated for this asset, independent of whether the asset passes all format filters.

Custom renditions

In addition to the formats defined on the system administration page, it is possible to allow users to request custom renditions of formats that the users define on-the-fly. This can be done via the “Custom rendition” button in the download dialog shown above or by calling the endpoint <api-url>/DigizuiteCore/LegacyService/api/renditions/<asset-id>/custom.

...

Custom renditions are always generated on-demand. However, if the exact requested rendition has already been generated, it is reused. Custom renditions are automatically cleaned up if they have not been downloaded in a while. By default, custom renditions are cleaned up after 30 days. This can be configured from the general settings page in the Media Manager. Only custom renditions are cleaned up.

...

Deletion

It is possible to manually trigger the deletion of renditions. This can be done via the automation step “Delete asset renditions”. Note that the automation step only deletes a rendition if it is available. Consequently, renditions that are in the process of being generated are not deleted.