DC 5.6 Configuring downloaded files' names

Owned by Rasmus Hjelmberg Duemose Hansen
Oct 18, 2021
1 min read

In DC pre-5.2.0 the only downloaded file names, which could be configured as the original file, i.e. media format ID 0. This has been altered in DC 5.2.0 so that all downloaded files' names will adhere to the digizuite configuration.

In addition to the above, a new digizuite configuration has been added in DC 5.2.0: "DOWNLOAD_NAME_REPLACE_MASK". If it is set to anything, this value is used to define any downloaded files' names. If a value has not been configured, then the older digizuite configuration values are used.

The name is determined by replacing known names in the string. These values are 

  • [%AssetTitle%]: Replaced by the asset's Title meta field value
  • [%AssetId%]: Replaced by the asset's asset ID
  • [%ItemId%]: Replaced by the asset's item ID
  • [%MediaFormatId%]: Replaced by the media format ID, that's currently being downloaded
  • [%OriginalFileName%]: Replaced by the asset's original filename
  • [%MetafieldId_XXX%]: Replaced by the value set for this asset for this meta field. The XXX is the metadata field's ID. This only works for string metadata fields. (If you assign a metadata field which is iterated - only the first entry in the list will be extracted)

An example of a configured value is "[%AssetTitle%] - [%OriginalFileName%] - [%MediaFormatId%]", which will result in the file name "my new title - ferrari 3d mock - 50033.jpg". Only the known names will be replaced, i.e. "[%AssetTitle%] - company name - [%MediaFormatId%]" will result in the file name "my new title - company name - 50033.jpg".