Page Comparison

DAM for Sitecore is constructed using pipelines, and it is possible to hook into the pipelines.

Note: Be aware that if you do change the pipelines, you are changing how DAM for Sitecore is supposed to work out of the box, and this may result in undesirable side effects.

The pipelines are defined in the .config files found in this folder: \ App_Config \→ Include \damforsitecore→ damforsitecore → DFS.Pipelines.config

Below are descriptions of the most important pipelines used in the module.

App_Config/Include/damforsitecore/DFS.SettingsPipelines.config

Pipeline

Description

PipelineArgs

DFS.GetAssetFieldValue

This pipeline will return rendering html for an asset item.

First it will get the html template, determined by the media type and the fieldId (HtmlForAssetType). The html templates are located at:
Sitecore → System → Modules → Digizuite → MedaDataRoot → AssetTypeOutputRoot.
The different processors will replace the stampvalue in the html template.
The property FieldValue of GetAssetFieldValueArgs will contain the rendering html.

List of processors

DFS.

ContentSearch

Client.Services.Pipelines.GetAssetFieldValue.GetAssetTypeOutput
DFS.Client.Services.Pipelines.GetAssetFieldValue.ReplaceTagsWithSelectedValues
DFS.Client.Services.Pipelines.GetAssetFieldValue.ReplaceTagsWithAccessValues
DFS.Client.Services.Pipelines.GetAssetFieldValue.ReplaceTagsWithConfigValues
DFS.Client.Services.Pipelines.GetAssetFieldValue.

ReplaceTagsWithAssetItemFieldValues

AppendTagsWithParameterValues
DFS.

ContentSearch

Client.Services.Pipelines.GetAssetFieldValue.ReplaceTagsWithAssetIndexValues
DFS.

Pipelines

Client.

GetAssetFieldValue

Services.

RemoveEmptyAttributesDFS.

Pipelines.GetAssetFieldValue.

AppendTagsWithParameterValues

RemoveEmptyAttributes
DFS.

ContentSearch

Client.

Pipelines.GetAssetFieldValue.AppendSeoDFS.

Services.Pipelines.GetAssetFieldValue.SplitFieldValueIntoResult

Code Block

language	c#

var renderArgs = new GetAssetFieldValueArgs
{
	AssetItemId = new ID(this.AssetItemId),
	ContextLanguage = Context.Language,
	FieldId = DFS.Fields.HtmlForAssetType.FieldAssetMedia,
	Quality = this.Quality
};

...

Pipeline	Description	PipelineArgs
DFS.Services.DFSMedia	This pipeline will return the media stream either from the cache or from Digizuite DAM.

First we check security

On ContentManagement server, we synchronize the asset if it does not exists in the asset silo.
Fetch the asset from the asset silo.
If the media is in the cache we return that.
The media was not in the cache, fetch the media from Digizuite DAM.
We resize the image, if resizing parameters was added.
Store the media in the cache.
Resolve download filename.

List of processors

DFS.Client.Services.Pipelines.DFSMedia.

CheckSecurity

SynchronizeAsset (Only In Role: ContentManagement)
DFS.Client.Services.Pipelines.DFSMedia.

GetMediaFromCache

LoadAssetEntity
DFS.Client.Services.Pipelines.DFSMedia.

GetMediaPrerequisites

GetMediaFromCache
DFS.Client.Services.Pipelines.DFSMedia.GetMediaFromDigizuite
DFS.Client.Services.Pipelines.DFSMedia.ResizeImage
DFS.Client.Services.Pipelines.DFSMedia.SaveToCache
DFS.Client.Services.Pipelines.DFSMedia.

ResolveDownloadFilename

ResolveFilename

Code Block

language	c#

var arguments = new DFSMediaPipelineArgs
{
	Request = mediaRequest,
    Result = new MediaResult()
};

Pipeline

Description

PipelineArgs

DFS.DigizuiteUpdateNotification

This pipeline will run every time Digizuite sends asset updates.

Fetch the asset(s) from Digizuite.
Save the assets as items in Sitecore.
If the requested assets are not found in Digizuite and they exists as items in Sitecore, then we delete the items, because they nolonger are available to the Sitecore channel.
Clear local cache, both data cache and cached images.
Send a clear cache to all CD servers.

List of processors

DFS.Connect.Pipelines.SyncAssets.FetchAssets
DFS.Connect.Pipelines.SyncAssets.SaveItems
DFS.Connect.Pipelines.SyncAssets.DeleteItems
DFS.Client.Services.Pipelines.Cache.ClearLocalCache
DFS.Client.Services.Pipelines.Cache.ClearRemoteCache

Code Block

language	c#

var syncAssetsArgs = new SyncAssetsArgs
{
    FacetList = new List<FacetField>
    {
        new FacetField()
        {
            facetMode = "QueryOnly",
            recursive = true,
            searchKey = "assetId",
            values = assetIds
        },
        new FacetField()
        {
            recursive = false,
            searchKey = "derivedFrom",
            operation = "Or",
            facetMode = "QueryOnly"
        }
    },
    Count = assetIds.Count,
    Language = DfsLanguage.GetLanguage(language),
    AssetIds = BaseIds
};

Synchronization

Pipeline

Description

PipelineArgs

DFS.SyncAsset

This pipeline is triggered when you insert Digizuite assets into on of the DAM for Sitecore custom fields.

First it tests if the requested asset is allready synchronized and exists in the asset silo. If the forceUpdate is true, then we skip this check.
Fetch the asset from Digizuite.
Save the asset in /sitecore/media library/Digizuite/Assets.

List of processors

DFS.Connect.Pipelines.SyncAsset.ItemExists
DFS.Connect.Pipelines.SyncAsset.FetchAsset
DFS.Connect.Pipelines.SyncAsset.SaveItem

Code Block

language	c#

var arguments = new SyncAssetArgs
{
    AssetId = aid,
    Language = DfsLanguage.GetLanguage(language),
    ForceUpdate = true
};

Pipeline

Description

PipelineArgs

DFS.SyncAssets

This pipeline is used in Administration DAM for Sitecore. Under the menu Broken links and Synchronization.

Fetch a list of assets from Digizuite.
Save the assets in /sitecore/media library/Digizuite/Assets.

List of processors

DFS.Connect.Pipelines.SyncAssets.FetchAssets
DFS.Connect.Pipelines.SyncAssets.SaveItems

Code Block

language	c#

var arguments = new SyncAssetsArgs
{
    FacetList = new List<FacetField>
    {
        new FacetField()
        {
            facetMode = "QueryOnly",
            recursive = true,
            searchKey = "assetId",
            values = assetIds
        }
    },
    Count = assetIds.Count,
    Language = DfsLanguage.GetLanguage(language)
}

Pipeline

Description

PipelineArgs

DFS.BatchSync

This pipeline is used in Administration DAM for Sitecore. Under the menu Synchronization. This pipeline is used to synchronize a large number of assets. It will run in a Sitecore job.

This will call the pipeline DFS.BatchSyncAssets with a batch of 50 assets ( the batch number is configuable).
Once all assets are done synchronizing we will rebuild the Sitecore index sitecore_master_index.

List of processors

DFS.Connect.Pipelines.BatchSyncAssets.BatchSyncAssets
DFS.Connect.Pipelines.BatchSyncAssets.RebuildIndex (<IndexName>sitecore_master_index</IndexName>)

Code Block

language	c#

var arguments = new SyncAssetsArgs
{
    FacetList = facetList,
    Language = language,
    Count = 1,
    Job = Job
}

Pipeline

Description

PipelineArgs

DFS.BatchSyncAssets

This pipeline is triggered by the pipeline DFS.BatchSync.

Fetch a list of assets from Digizuite.
Save the assets in /sitecore/media library/Digizuite/Assets, with the following disables around: SecurityDisabler, DatabaseCacheDisabler, EventDisabler and BulkUpdateContext to optimize the creation of alot of items in Sitecore.

List of processors

DFS.Connect.Pipelines.SyncAssets.FetchAssets
DFS.Connect.Pipelines.SyncAssets.SaveItemsWithDisablers

Code Block

language	c#

var arguments = new SyncAssetsArgs
{
    Count = batchLSize,
    Skip = x * batchLSize,
    FacetList = args.FacetList,
    Language = DfsLanguage.GetLanguage(args.Language)
}

Versions Compared

Old Version 2

New Version Current

Key

Synchronization