Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

.1 Add handler to web.config

DFS has its own handler for serving media files. To enable the handler:

  • Open your Sitecore's web.config file.
  • Before you start making changes, it is advised that you make a copy of the web.config file, so you always will have the ability to fully recover.
  • Navigate to the section "/configuration/system.webServer/handlers".
  • Now add the following handler, inside the handlers section.

    Code Block
    languagexml
    linenumberstrue
    <add name="MediaHandler" verb="GET" path="dfsmedia/*/*-*" type="DFS.Services.Handlers.MediaHandler"/>


  • Save the file and close it.

3.2 Setting up the connection to Digizuite™

Info

If you are upgrading from a previous version of DFS, then you can skip this section and continue with 3.2.2 Reverting silo item.

DFS synchronizes data from Digizuite™ DAM Center (DC) into Sitecore. Data is stored in a silo (item bucket)Before we can begin synchronizing, we have to fill out some config parameters telling Sitecore which DAM to fetch data from. There are 3 parameters in this file \App_Config\Include\damforsitecore\DFS.Settings.config. 

Code Block
languagexml
linenumberstrue
<setting name="DFS.AssetSiloSettings.Default.BaseAddress" value="{URL TO THE DAM SERVER}" />
<setting name="DFS.AssetSiloSettings.Default.Username" value="{USERNAME FOR THE USER TO BE USED WHEN SYNCHRONIZING BETWEEN SITECORE AND DAM}" />
<setting name="DFS.AssetSiloSettings.Default.Password" value="{PASSWORD FOR THE USER TO BE USED WHEN SYNCHRONIZING BETWEEN SITECORE AND DAM}" />

We do not recommend that you change these parameters in this file. Instead create a new config file where you patch the parameters (This is best practice). Here is an example of said patch config file. It is important that the file is loaded after DFS.Settings.config, otherwise the patch file won't have any effect. If you name the config file z.DFS.Settings.config and place it in the folder \App_Config\Include\damforsitecore\ you should be safe.

Code Block
languagexml
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/">
	<sitecore>
		<settings>
			<setting name="DFS.AssetSiloSettings.Default.BaseAddress">
				<patch:attribute name="value">https://dam.digizuite.dk/</patch:attribute>
			</setting>			
			<setting name="DFS.AssetSiloSettings.Default.Username">
				<patch:attribute name="value">DAM for Sitecore</patch:attribute>
			</setting>
			<setting name="DFS.AssetSiloSettings.Default.Password">
				<patch:attribute name="value">sitecore</patch:attribute>
			</setting>				
		</settings>
	</sitecore>
</configuration>
  • Edit the values in the file to match your site (use the below table):
VariableDescriptionDefaultExample
BaseAddressURL to your DC. It MUST end with a forward slashhttps://[yourdam]/https://dam.digizuite.dk/
UsernameUsername for the user to be used when synchronizing between Sitecore and your DAMDAM for SitecoreDAM for Sitecore
PasswordPassword for the user to be used when synchronizing between Sitecore and your DAMsitecoresitecore

Once the config file is in place, reload the site and continue to the next topic "Creating a silo in Sitecore".

3.2

.

2 Reverting silo item

If you are upgrading from a previous version, then you should have the Silo serialized to disk. Now it's time to revert the item back into your database with you preferred way of handling items like Unicore, TDS, or from the developer tab in Sitecore.

Table of Contents

Table of Contents

...