DFS 11.0 - Breaking Changes

With this version there are a set of breaking changes that must be considered when upgrading from a previous version.

Namespaces

The following namespaces has been removed:

  • DFS.Connect.Digizuite

  • DFS.ContentSearch

  • DFS.Digizuite

  • DFS.Services

Custom Indexes

The 2 custom indexes dfs_assets_master_index and dfs_assets_web_index has been removed. The assets will be indexed in Sitecoreā€™s default indexes Sitecore_master_index and Sitecore_web_index. You have the opportunity to create your own custom index.

Pipelines

All the pipelines around synchronization has been removed. New one has been added. If you hooked into one of our synchronization pipelines, then read about the new pipelines .

Configuration

All the .config files in App_Config\Include\damforsitecore has been reorganized. The most important config file DFS.Settings.config, contains the settings to Digizuite. You properly have a patch file where you overwrite these settings.

These settings have been removed.
DFS.AssetSiloSettings.Default.BaseAddress
DFS.AssetSiloSettings.Default.Username
DFS.AssetSiloSettings.Default.Password
DFS.AssetSiloSettings.Default.ConfigVersionId

The patch file should now as a minimum contain the following settings.
DFS.Digizuite.BaseAddress
DFS.Digizuite.MediaManagerUrl
DFS.Digizuite.ChannelFolderId

You can read more about the setting

Synchronization

The full synchronization that was a requirement before you could start using the connector, has been removed. It is no longer required to synchronize all assets into Sitecore before you can add assets to pages. Now the assets will be synchronized as they get used.
Itā€™s still possible to do a full synchronization. We have moved this feature to the Administration dashboard. The full sync is useful if you need to search for dynamic content on the website.

Asset template

The asset template at /sitecore/templates/DFS/Data/AssetĀ has changed.

Ā Field

Changed To

Deleted

OriginalAssetId

DerivedFrom

Ā 

IsPublic

Ā 

x

Published

Ā 

x

MetaDateStrings

DynamicMetadata

Ā 

MetaDataTreeItems

DynamicMetadata

Ā 

MetaDataComboValues

DynamicMetadata

Ā 

LastPublished

Ā 

x

CreatedDateTime

UploadDate

Ā 

ChangedDateTime

LastModified

Ā 

VideoLength

Duration

Ā 

VideoWidth

Width

Ā 

VideoHeight

Height

Ā 

VideoFps

Ā 

x

VideoRotation

Ā 

x

ImageHeight

Height

Ā 

ImageWidth

Width

Ā 

ImageDpi

Ā 

x

Html Templates (AssetTypeOutputRoot)

The asset html templates has been moved from

/sitecore/system/Modules/Digizuite/MetaDataRoot0/AssetTypeOutputRoot
To
/sitecore/system/Modules/Digizuite/Render Templates

Ā 

The Branches AssetTypeOutputRoot has been deleted at /sitecore/templates/Branches/DFS/AssetTypeOutputRoot

DAM Explorer replaced with a new UI

The Asset picker UI, DAM Explorer has been removed and replaced with a new UI. Now we load an embedded asset picker from Digizuite in an Iframe. Because of this, we have removed all the configuration items at /sitecore/system/Modules/Digizuite/MetaDataRoot0.

The Hook - Detect dam changes

The background process that ran every 1 minute which was looking for changes in Digizuite and updating the items in Sitecore, has been removed. You should use the Digizuite webhooks, listening for asset updates.

AssetMetadata

The AssetMetadata model has changed some of its properties.

Property

Changed To

Deleted

CreatedDateTime

UploadDate

Ā 

ChangedDateTime

LastModified

Ā 

LastPublishedDateTime

Ā 

x

Extension

FileExtension

Ā 

VideoLength

Duration

Ā 

VideoPreview

Ā 

x

VideoWidth

Width

Ā 

VideoHeight

Height

Ā 

VideoFps

Ā 

x

ImageWidth

Width

Ā 

ImageHeight

Height

Ā 

ImageDpi

Ā 

x

ThumbSmall

Ā 

x

Thumb

Ā 

x

Preview

Ā 

x

WebPreview

Ā 

x

RawUrl

Ā 

x

AllowReCrop

Ā 

x

AccessKey

Ā 

x

Video playback

The html template for video has changed. Now is uses the native video tag. We also change the video streaming url. Our media handler for serving images and documents can now also stream a video asset.