Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

After installation of the NuGet package, it's time to setup the connection to you Digizuite DAM instance. Add the DAMIntegrationConfiguration to your startup class. The configuration should be added after the AddCms due to TinyMCE initialization. Here is an example. The paramaters will be delivered by Digizuite.

services.AddDigizuiteDAM(new Action<DAMIntegrationConfiguration>(configuration =>
{
  	configuration.Connection = new Digizuite.Models.DigizuiteConfiguration()
	{
  		BaseUrl = new Uri("https://[DAM url]"),                
        SystemUsername = "Episerver Editor",
        SystemPassword = "36b2a0e1d5d2a4bd45975951366ea26b"
  	};
    configuration.MediaManager = new MediaManagerElement()
    {
    	Url = "https://[MediaManager url]"
   	};
    configuration.MainSearchFolderId = 136;
}));

Demo environment

For testing the connector, you can use the demo environment. Be aware that this environment is controlled by Digizuite and willl be reset occasionally. Meaning content you upload will be delete.

ADD CONNECTION FROM DEMO DIGIZUITE, WHEN READY


DAMIntegrationConfiguration parameters


NameTypeRequiredDefaultDescription
DatabaseNamestringYes
The databaseName is the name of the database that you are running your Optimizely application in. We have experienced in some applications that it is not enougt to only add the name of the database, but it should have the hole connection string. You can get the connection string like this: 
_configuration.GetConnectionString("EPiServerDB")
ConnectionDigizuiteConfigurationYes
This object contains the connection parameters to the Digizuite DAM instance.
MediaManagerMediaManagerElementYes
The Url parameter has to be set. This is used for embedding the MediaManager into Optimizely.
MainSearchFolderIdintYes
This is the channel folder in Digizuite. Request the id from your Digizuite consultant.
RoleMappings
List<RoleMappingElement>
No
new RoleMappingElement()
{
	DigizuiteUser = new DigizuiteUser()
    {
    	Name = "Episerver Editor",
        Password = 36b2a0e1d5d2a4bd45975951366ea26b",
        IsSystemUser = true
    },
    EpiserverRoles = new List<string>() 
	{
		"DigizuiteEditor" 
	}                 
},
new RoleMappingElement()
{
	DigizuiteUser = new DigizuiteUser()
    {
    	Name = "Episerver User",
        Password = "292ad587521cc6c4c26e1c32991c2afd"                    
    },
    EpiserverRoles = new List<string>() 
	{
		"DigizuiteUser"
	}
}    
see DFO 4.0.0 - 14 Role mapping
FallbackIconMappings
List<IconMappingElement>
No

VideoPlaybackType
VideoPlaybackType
No
VideoPlaybackType.Streaming
The connector comes with 3 different option for video playback. You can read about the it at DFO 4.0.0 - 13 Video playback
VideoCdnBaseUrlstringNo

DigizuiteWebhookElement
DigizuiteWebhookElement
No
Listening for Digizuite asset update events. When someone make a change to an asset in Digizuite DAM and event is raised which your Optimizely instanc gets and all cached data about the asset will be cleared.
FullSearchBatchSizeintno200
ValidVideoExtensionsList<string>no"mp4", "m4v", "ogv", "webm"
DisableNotificationsboolnofalse
DefaultLanguageIdintno3
DefaultLanguageNamestringnoen
ForceDefaultLanguageboolnofalse
CacheCacheElementnoTimeOut = "10:00"

Child element: DigizuiteConfiguration

The connection is the most important child element. This is where the main connection setting pointing to the DAM is specified. Typically you will replace this with connections settings you have gotten from your own DAM Center.

NameTypeRequiredDefaultDescription
BaseUrlUriYes
Base url to the DAM Center
SystemUsernamestringYes
Sync user that the integration can use in the DAM Center
SystemPasswordstringYes
The hashed secret that the integrations sync user should use.

Child element: MediaManagerElement

The url is used for embedding the MediaManager into Optimizely in an IFrame.

NameTypeRequiredDefaultDescription
UrlstringYes
Base url to the MediaManager

Child element: RoleMappings

Since access rights can be set on individual assets in the DAM Center, you can use the list of roleMappings to map DAM Center roles to Episerver roles in order to ensure proper permissions for various editor groups. The default configuration of these elements should be sufficient in most cases.

NameTypeRequiredDefaultDescription
DigizuiteUserDigizuiteUserYes
The name of the role in Digizuite to map.
EpiserverRoles
List<string>
Yes
A list of Episerver roles that be given similar permissions to the Digizuite Role.

Child element: DigizuiteUser


NameTypeRequiredDefaultDescription
NamestringYes
Digizuite username
PasswordstringYes
Digizuite password in the format md5
IsSystemUserboolNofalseThe user with the highes rights in Digizuite should be set to true.

Child element: FallbackIconMappings

The FallbackIconMappings list is in order to ensure that for assets where a proper thumbnail cannot be shown, we can map the various file extensions to a fitting icon. Typically the default should be sufficient.

Each element in this list has the settings below:

NameTypeRequiredDefaultDescription
DocumentTypestringYes
The icon for the document type - for instance "video" for a video icon.
Extensions
List<string>
Yes
A list of file extensions to map for the above document type.

Child element: DigizuiteWebhookElement

The DigizuiteWebhookElement for seting up the connection between Digizuite DAM and your Optimizely instance. So you will recive update notification when assets change.

NameTypeRequiredDefaultDescription
SiteUrlstringYes
This is the url that Digizuite use to send the notification to. We will append the routing to the controller to the url. [siteUrl]/episerver/digizuite/DigizuiteWebhook/Update
GuidstringYes
This is the unique identifier for the endpoint in Digizuite DAM. Just generate a new guid. 
SubscriptionsList<int>No
 new List<int> { 1 }
A list of changeTypes. Possible values are: AssetChanged = 1, MetafieldChanged = 2, TreeValueChanged = 4, ComboValueChanged = 8
DeleteBlob
boolNoFalseBy default this is false. Enable this if each instance of a loadbalanced enviroment has its own local blob storage.

Child element: CacheElement

NameTypeRequiredDefaultDescription
TimeOutstringNo10.00Use in the Digizuite Content provider. When building IContent, then it will by dedault cached for 10 minutes.
ImageCDNCacheControlstringNo

CDNCacheControlstringNo


  • No labels