After installation of the NuGet package, it's time to setup the connection to you Digizuite DAM instance. You have 2 options to add the settings. Eather through code in the startup class or in a json settings file.
...
| Code Block | ||
|---|---|---|
| ||
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;
configuration.PollyResilienceElement = new PollyResilienceElement()
{
ExceptionsAllowedBeforeBreaking = 10,
DurationOfBreak = 20,
TimeoutRequest = 20
};
})); |
Option 2 - Json settings
...
| Code Block |
|---|
{
"DigizuiteDamSettings": {
"Connection": {
"BaseUrl": "https://[DAM url]",
"SystemUsername": "DFO System",
"SystemPassword": "P74nR658TEhh"
},
"MediaManager": {
"Url": "https://[MediaManager url]"
},
"MainSearchFolderId": 126,
"PollyResilienceElement": {
"ExceptionsAllowedBeforeBreaking": 10,
"DurationOfBreak": 20,
"TimeoutRequest": 20
}
}
} |
Add the DAMIntegrationConfiguration to your startup class. The configuration should be added after the AddCms due to TinyMCE initialization.
...
Name | Type | Required | Default | Description |
|---|---|---|---|---|
Connection | DigizuiteConfiguration | Yes | This object contains the connection parameters to the Digizuite DAM instance. | |
MediaManager | MediaManagerElement | Yes | The Url parameter has to be set. This is used for embedding the MediaManager into Optimizely. | |
MainSearchFolderId | int | Yes | This is the channel folder in Digizuite. Request the id from your Digizuite consultant. | |
DatabaseName | string | No | configuration["ConnectionStrings:EPiServerDB"] | This module requires access to the database for Resilience. The value must be a connection string to the database. By default it will use the Episerver DB connection string. |
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 |
VideoCdnBaseUrl | string | No | ||
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. | |
FullSearchBatchSize | int | no | 200 | |
ValidVideoExtensions | List<string> | no | "mp4", "m4v", "ogv", "webm" | |
DisableNotifications | bool | no | false | |
DefaultLanguageId | int | no | 3 | |
DefaultLanguageName | string | no | en | |
ForceDefaultLanguage | bool | no | false | |
Cache | CacheElement | no | TimeOut = "10:00" | |
AssetInUseGuid | Guid | no | This is a metafield in Digizutite thats gets updated every time an asset is added or removed from a page. | |
MediaElements | MediaElement | no | ||
IndividualUserLogin | bool | no | true | If true the user will have to login with a username and password. When access Digizuite asset browser. |
RoleMappings | List<RoleMappingElement> | no | ||
PollyResilienceElement | PollyResilienceElement | no | Setting for resilience strategy. |
Child element: RoleMappingElement
...
Name | Type | Required | Default | Description |
|---|---|---|---|---|
DefaultImageFormat | MediaElement | YesNo | { MediaFormatId = 2, Extension = "jpg", PropertyName= "Preview" } | The default image quality format used, if no valid quality has been set. |
DefaultVideoFormat | MediaElement | YesNo | { MediaFormatId = 10079, Extension = "mp4" } | The default video format used, if no valid quality has been set. |
...
Name | Type | Required | Default | Description |
|---|---|---|---|---|
SiteUrl | string | Yes | 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 | |
Guid | string | Yes | This is the unique identifier for the endpoint in Digizuite DAM. Just generate a new guid. | |
Subscriptions | List<int> | No | new List<int> { 1 } | A list of changeTypes. Possible values are: AssetChanged = 1, MetafieldChanged = 2, TreeValueChanged = 4, ComboValueChanged = 8 |
DeleteBlob | bool | No | False | By default this is false. Enable this if each instance of a loadbalanced enviroment has its own local blob storage. |
Child element: CacheElement
Name | Type | Required | Default | Description |
|---|---|---|---|---|
TimeOut | string | No | 10.00 | Use in the Digizuite Content provider. When building IContent, then it will by dedault cached for 10 minutes. |
ImageCDNCacheControl | string | No | ||
CDNCacheControl | string | No |
Child element: PollyResilienceElement
Name | Type | Required | Default | Description |
|---|---|---|---|---|
ExceptionsAllowedBeforeBreaking | int | No | 1 | The number of exceptions that are allowed before opening the circuit. |
DurationOfBreak | int | No | 20 | The duration the circuit will stay open before resetting. The value is in seconds. |
TimeoutRequest | int | No | 20 | Time to wait for a asynchronously delegate to complete. |