DFS 10.4.0 - Breaking Changes

Owned by Martin Ulisse
Last updated: Oct 21, 2024
2 min read

With 10.4 there are a set of breaking changes that must be considered on new install and/or update.
In this version we have shifted over to use the new search api in Digizuite. The following sections has been affected by this release.

Html templates

The standard HTML template for video and Audio has changed for the fields:

  • Rich Text Editor Media

  • Asset Field Type

  • Content Editor Asset

In the previous version it was loading a videoplayer from Digizuite in an IFrame. Now it is using the native videoplayer tag <video />. You can read more about the new videoplayback here DFS 10.4.0 - 11 Video playback

Configuration in Digizuite

  • Editor qualities
    These settings has been moved from ConfigManager to DFS.Settings.config.

  • Crop aspects
    These settings has been moved from ConfigManager to Media Manager under Portal config manager as crop presets.

Background asset update

The background agent that runs every 1 minute asking Digizuite for changes, has been changed slightly. Before both assets and metafield configurations was updated. Now we only update assets.

The cleanup pipeline has been disabled by default. If you run against a DAM 6.x, then the cleanup pipeline wont work. The only way to cleanup asset items, is by running a full synchronization of assets.

Asset security

All asset that will be synchronnized into Sitecore from Digizuite will get the same access rules. With the shift to the new Digizuite asset search API, access roles wont be exposted by the api for security reasons. You can read more about how the access roles are applyed to the items DFS 10.4.0 - Security.

Default formats

In the previous version the default qualities was configured in Digizuite under ConfigManager. Now it has moved to Media Manager → Service Configuration → Asset Streamer Settings: Format.

Digizuite connection

We have added 2 more settings for connection to Digizuite. DFS.AssetSiloSettings.Default.MediaManagerUrl and DFS.AssetSiloSettings.Default.SearchFolderId. The property DFS.AssetSiloSettings.Default.ConfigVersionId has been deprecaded. You can read more about he new setting here DFS 10.4.0 - 3 Setting up Sitecore.

Template changes

The template Format {6757DFDD-5978-445A-B36D-EA7A319A9D42} at /sitecore/templates/DFS/Settings/Format, has been update with 3 new fields.
ValidExtensions, FormatType and Purpose.

Videoplayback

Video streaming has been changed so it no longer are streamed directly from Digizuite, but from our mediahandler within SItecore. You can read more about the mediahandler here DFS 10.4.0 - 9 Serving media.

Administration dashboard

On the main page we have removed the insights that compared the number of assets in Digizuite, Sitecore DB and master index.