DFS 8.0.2 - 8 Appendix
- Mathias Mattson (MHM)
- Martin Ulisse
9.1 How to use another user than admin to manage silo synchronization
If using an already existing user as the one who can create/sync silos other than admin / b, then enable autoCreateDigizuiteMember. Once the DFS module is installed and configured:
- Login to Sitecore
- Go to User Manager
- Edit the user and add these 2 roles to the user
- Sitecore\DFS
- Sitecore\ Digizuite DAM for Sitecore Administrators
- Log out and then log in with the user again. Now the user will automatically be created in the Digizuiteā¢ DAM Center (DC) and should be able to create/synchronize silos.
9.2 Access key cache
By default, the access key from DC is cached for 5 min. The setting can be changed in DFS.settings.config.
<setting name="DFS.Connect.LogonCache.TimeToLiveInSeconds" value="300" />
The DC also has a configuration about how long an access key lives. By default, it is 24 hours. It is important that the Digizuite access key period is greater than the Sitecore access key cache period.
9.3 How to configure which metadata to show in the asset preview area (Dam Explorer and Asset browser)
It is configuable which metadata that is showing in the asset preview area. It can show standard data about the asset, like width, height, file size etc. It can also show custom made metadata that is bound to the asset. The custom made metadata is configured in the DC. Remember that the custom made metadata can only be used in the module, if they are synchronized into Sitecore.
The configuration is located in this file: /App_Config/Include/damforsitecore/DFS.Settings.config under the section <DFS.AssetPreview.Metadata>.
This is the default configuration:
<DFS.AssetPreview.Metadata> <metadata dictionaryKey="description" field="Description" type="note" /> <metadata dictionaryKey="filesize" field="FileSizeAbbreviated" /> <metadata dictionaryKey="width" field="ImageWidth" append=" px" /> <metadata dictionaryKey="height" field="ImageHeight" append=" px" /> <metadata dictionaryKey="videowidth" field="VideoWidth" append=" px" /> <metadata dictionaryKey="videoheight" field="VideoHeight" append=" px" /> <metadata dictionaryKey="duration" field="VideoLength" /> <metadata dictionaryKey="typename" field="AssetTypeName" /> <metadata dictionaryKey="importedby" field="ImportedBy" /> <metadata dictionaryKey="importeddate" field="CreatedDateTime" type="datetime" /> </DFS.AssetPreview.Metadata>
Valid xml attributes for the metadata tag are: dictionaryKey, field, type, append and metafieldId.
You can't have both field and metafieldId in the same metadate tag, only one of them.
Name | Description |
---|---|
dictionaryKey | This is the key pointing into a dictionary located in the core database. |
field | These are the standard values about an asset, like width, height, file size etc. The valid list fields are: AssetId, AssertName, AssetTypeId, AssetTypeName, Filesize, FilesizeAbbreviated, ImportedBy, CreatedDateTime, ChangedDataTime, Extension, VideoLength, VideoWidth, VideoHeight, |
type | At this current implementation we haveĀ 3 valid types:
|
append | Will append to the value, ex. width we appendĀ " px", will look like this 244 px. |
metafieldId | These are the custom metadata, defined in DAM. The custom metadata can be found under this location in the master database. To determine the type, by the DatatypeId. |
9.4 Define which fields free text search in (DAM Explorer and Asset Browser)
By default the freetext search in the DAM Explorer and the Asset Browser searches in the following fields:Ā assetid, name, description, extension, importedby, assettypename. These cannot be removed from the search. You can, however, add more fields to the freetext search.
The configuration is located in this file: /App_Config/Include/damforsitecore/DFS.Settings.config under the section <DFS.AssetSearchableMetadata>.
To add custom metadata fields, you insert this tag: <metadata dataTypeId="" fieldId=""/>, the fieldId is the Item ID and the dataTypeId can be found on the metafield item.
The custom metafields can be found under this location in the master database. /sitecore/system/Modules/Digizuite/MetaDataRoot/MetaGroupRoot. Each item has a field called dataTypeId.
By default the <DFS.AssetSearchableMetadata>Ā section is empty.
Here's an example with one extra field:
<DFS.AssetSearchableMetadata> <metadata dataTypeId="60" fieldId="{D87A8D4A-89E8-70D4-9036-DDA294C6B8D2}"/> </DFS.AssetSearchableMetadata>
In order to see the changes, you have to rebuild the index (dfs_assets_master_index).
9.5 Video player (JQuery 2.1.4 conflicts)
The default configuration uses a custom video player called FlowPlayer. This is provided by Digizuite. It uses JQuery 2.1.4 which sometimes conflicts with existing Sitecore sites. To disable this, you leave the following tag blank:
<setting name="DFS.EmbedPlayerScriptInclude"> <patch:attribute name="value"></patch:attribute> </setting>
This can fallback to the default HTML5 player, however, then JQuery isn't used.
9.6 Auto synchronization of assets
DFS has a pipeline that synchronizes assets automatically. On larger Sitecore instances this synchronization sometimes misses some assets due to workload on the server.
If you start experiencing this, then you canĀ tweaking the following parameter:
<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/"> <sitecore> <settings> <setting name="DFS.AssetSiloSettings.Default.OverlapOnSiloSync" value="2" /> </settings> </sitecore> </configuration>
This parameter adds an overlap for the automatic silo synchronization. This means that the period where the the timer (hook) asks for changes in the DC is extended by that value. In that way, assets that may have been missed in the first run, will be synchronized in the next. The value is in minutes.
Table of Contents