Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
3.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, which by default will be here: C:\Inetpub\wwwroot\yoursite\Website.
Before you start making changes, it is advised that you make a copy of
thethe web.config file, so you always will have the
ability toability to fully recover.
Navigate to the section "/configuration/system.webServer/handlers".
Now add the following handler, inside the handlers section.
Code Block language xml linenumberstrue <add name="MediaHandler" verb="GET" path="dfsmedia/*/*-*" type="DFS.Services.Handlers.MediaHandler"/>
Save the file and close it.
Note |
---|
In you are running Sitecore 9.3 or newer, then you probably will have problems playing video assets in the content editor or the Dam for Sitecore Explorer. Please read this DFS 10.4.0 - Video playback failed because of Content Security Policy (CSP) |
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)e 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 4 5 parameters in this file \App_Config\Include\damforsitecore\DFS.Settings.config.
Code Block | ||||
---|---|---|---|---|
| ||||
<setting name="DFS.AssetSiloSettings.Default.BaseAddress" value="{URL TO THE DAM SERVER}" /> <setting name="DFS.AssetSiloSettings.Default.MediaManagerUrl" value="{URL TO MEDIA MANAGER}" /> <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}" /> <setting name="DFS.AssetSiloSettings.Default.ConfigVersionIdSearchFolderId" value="{THE CONFIGVERIONID USED IN DAMSEARCH FOLDERID}" /> |
We do not recommend that you change these 4 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 | ||||
---|---|---|---|---|
| ||||
<?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/<dk</patch:attribute> </setting> <setting name="DFS.AssetSiloSettings.Default.MediaManagerUrl"> <patch:attribute name="value">https://mm.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> <setting name="DFS.AssetSiloSettings.Default.ConfigVersionIdSearchFolderId"> <patch:attribute name="value">!/5/<>137</patch:attribute> </setting> </settings> </sitecore> </configuration> |
Edit the values in the file to match your site (use the below table):
Variable | Description | Default | Example |
---|---|---|---|
BaseAddress | URL to your DC. It MUST NOT end with a forward slash. | https:// |
dam.digizuite.dk | |||
MediaManagerUrl | https:// |
mm.digizuite.dk |
Username | Username for the user to be used when synchronizing between Sitecore and your DAM. | DAM for Sitecore | DAM for Sitecore |
Password | Password for the user to be used when synchronizing between Sitecore and your DAM. | sitecore | sitecore |
SearchFolderId | This is the channel folderId from Digizuite. | 137 |
Once the config file is in place, reload the site and continue to the next topic "Creating a silo in Sitecore".
3.2.1 Creating a silo in Sitecore
You now need to create a new silo in Sitecore. This has to be done to synchronize the content of your DAM and your Sitecore.
Do the following steps:
Be logged as a user who is admin or member of the role sitecore\Digizuite DAM for Sitecore Administrators
Go to the Content Editor
Expand Sitecore Media Library
Right click on Digizuite and click Insert → Asset silo
Add a name to the silo. Normally, you'd name the silo something that relates to your DC. By default, this will be the title of your silo. Everyone will be able to see this title.
Note title Important note about the silo item It is very important that the silo item is serialized to disk and controlled by your preferred item manager like Unicore or TDS. Every team member working on the solution should have the same starting point. For more info read this DFS 10.4.0 - 8 Calculated itemIds
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.
3.2.3 Considerations about silo item language(s)
The silo can be synchronized in multiple language (see guide DFS 10.4.0 - Setup multiple languages) or you can leave the silo only synchronized in one language and still be able to add content in other languages, see this guide DFS 10.4.0 - Optimize your DFS silo by limiting it to only one language. By default, DAM for Sitecore uses language fallback (not Sitecore's language fallback), which is set to "en".
Table of Contents
Table of Contents |
---|
Info |
---|