Versions Compared

Key

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

...

You might also want to simply expose a field to Episerver Optimizely that's already in Digizuite - maybe it could be useful for advanced editors to see which camera the picture is taken with? Or perhaps even search for it?

Luckily it's pretty easy to extend the integration with additional meta-data fields. However, a fair word of warning - you should be careful when modifying the DAM Center settings and if you are in doubt contact Digizuite to get assistance to customize it to your needs. But for now, let's walk through how it's done!

Modifying the DAM Center Search

To add custom meta data fields to the integration we'll have to modify the primary search used by the Integration, called "GetEpiserverAssets". To do that, we have to go to the DAM center, navigate to System Tools | ConfigManager, select the Episerver integration from the tree and modify the Default.

...

Now, we have navigated to the Searches tab and selected the GetEpiserverAssets search. You'll notice a new panel coming in from the right for that specific search. This is where the parameters are defined. By default "Input" parameters are selected, and the following example is based on adding a new input parameter - but the process is identical, should you wish to add an output parameter.

Input vs Output parameters

Input parameters are the filters sent into the search search from the integration. They are typically added to filter on certain properties in custom queries. You can learn how to setup custom asset queries in Episerver in Optimizely here: DFO 3.0.0 - 5 Querying Assets

Output parameters are additional data fields that you want to map to Episerver Optimizely properties on your assets content models in EpiserverOptimizely . Even though it's called "Output" that's purely in relation to the search. If they are properly mapped up to Episerver Optimizely properties in the model and the permissions are correctly set, they will function as read/write parameters allowing Episervers Optimizely's editors to change their contents. It's important to note that since all Digizuite assets are coming from Digizuite, the only way to add properties to the corresponding Episerver Optimizely content objects that will be persistent, is to make sure they are mapped to an Output parameter here. You can read more about how to map the content models here: DFO 3.0.0 - 2 Modelling Asset Content Types.

In this example we will continue adding an input parameter.

Selecting and adding the parameter

Now, we basically just click the "Add" button in top of the search and a dialog shows up. Here, we first have to pick the "metafield group", and then the specific field in that group. For this example, I'll pretend that I want to do editorial searches filtering on which make of camera is used, so I'll select the "Exif" metafield group and the metadata field "Make". When done, we click "Create".

...

You should also remember to ensure that the "ID" of the above field corresponds to what you want to use in the Episerver Optimizely integration - both for input and output parameters. In this case it's fine with "Make".

...