The 'Scene7 Adapter' functionality constructs URLs to access external asset data with the value extracted from the external identification attribute defined on the asset stub. A regular expression can be assigned to the 'CanHandle' properties in the sharedconfig.properties file to extract the value from the external identification attribute as needed. For details on the properties, refer to the Set the Configuration Properties section of the Initial Setup for an External DAM topic here.
The goal is to define the template in a way that makes the configuration scalable and capable of handling future requirements. The value template and the Regular Expression play an important role if multiple 'CanHandle' definitions are required. For more information, refer to the Regular Expression section of the Resource Materials online help here.
For example, the following template is used as the external identification value on DAM Assets:
<assetID>/<AssetRevision or timestamp>
The value is composed of two components: the ID of the asset as defined in the external system and a revision value for thumbnail caching. The components are separated by a forward slash (/).
On an asset, the value using the above template would be:
123-456-789/v1.0
For the 'CanHandle' property for external integration, the following Regular Expression is used to extract the ID and the version/timestamp from the above template in two groups. Then the URLs are composed to fetch assets from the external system.
^(.*?)/(.*?)$
The above expression extracts assetID and version/timestamp as groups 1 and 2, which can be used in URL compositions as $1 and $2, respectively.
Assuming the sharedconfig.properties setting is:
Scene7DownloadContentPlugin.CanHandle.ExternalLocation.thumbnail = http://mydam/assets/$1/Thumbnail/
A thumbnail URL for the example will be composed as:
http://mydam/assets/123-456-789/Thumbnail/