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 11 Next »

We do not recommend that you access raw fields on the item directly, we recommend to use our api to retrieve metadata.
The api will return a well define model of type AssetMetadata which contains the following properties and methods:

Property name

Type

Description

Name

String

The title of the asset.

Description

String

The description of the asset.

AssetId

Int

This is a unique id coming from the DAM Center.

AssetTypeId

Int

This is a unique id, representing what kind of type the asset is. Ex. images equals 4 and video equals 1 etc. This id can be mapped to an item in this location:system/modules/Digizuite/[silo id]/AssetTypeRoot

AssetTypeName

String

The name of the asset type.

AssetSiloIdStringThe Sitecore itemId of the silo this asset is part of.
AssetSiloNameStringThe Sitecore item name of the silo this asset is part of.

ImportedBy

String

The name of the user who uploaded the asset.

CreatedDateTime

DateTime

The upload date.

ChangedDateTimeDateTimeThe change date.
FilesizeLongThe file size of the original file in bytes.
FilesizeabreviatedStringA more readable version of the file size ex. 606.34 KB
ExtensionStringThe extension of the original file.

VideoLength

String

Is the asset being of type video, this is the length of the video.

VideoWidthIntThe width of the original file.
VideoHeightIntThe height of the original file.
VideoFpsFloatThe frames per seconds of the original file.
ImageWidthIntThe width of the original file.
ImageHeightIntThe height of the original file.
ImageDpiIntThe dpi of the original file.

DynamicMetadata

IDictionary<string, string>

This dictionary will contain all the dynamic metafield from the DAM Center. The key is the MetafieldId of the metafield. All metafields can be found either in DAM Center or at this location in Sitecore:system/modules/Digizuite/[silo id]/MetaGroupRoot.

Method name

Description

Ex. of return value

GetMediaUrl()

Returns the media URL for the source file.

/media/512ffeba519249ff866095d7a25846ec/1-source

GetMediaUrl(string mediaFormatId, int resizeWidth = 0, int resizeHeight = 0, bool keepAspectRatio = true, bool allowUpScale = false))Returns a media URL for the specified quality (mediaFormatId). You have the opportunity resize the image. By default the keepAspectRation is true and allowUpScale is false./media/512ffeba519249ff866095d7a25846ec/1-50044/resize/100x0/options/keepaspectratio

GetDownloadUrl()

Returns the download URL for the source file.

/media/512ffeba519249ff866095d7a25846ec/1-source/options/download

GetDownloadUrl(string mediaFormatId)Returns the download URL for the specified quality (mediaFormatId)./media/512ffeba519249ff866095d7a25846ec/1-50044/options/download

GetDigizuiteStreamingUrl(string mediaFormatId)


This is a unique id coming from the DAM Center.








3.5.1 How to retrieve metadata for the field type Asset


AssetField assetField = Sitecore.Context.Item.Fields["Asset"]; 
var name = assetField.AssetMetadata.Name; 
var htmlRender = assetField.RenderAsset();


AssetlinkField assetLinkField = Sitecore.Context.Item.Fields["AssetLink"]; 
var name = assetLinkField.AssetMetadata.Name; 
var htmlRenderLink = assetLinkField.RenderAsset();

3.5.3 How to retrieve metadata for the field type AssetList


AssetlistField assetList = Sitecore.Context.Item.Fields["AssetList"];
if (assetList != null)
{
	foreach (var asset in assetList.Assets)
		{
		// To request the rendering html for the asset you call the
		// RenderAsset method. It returns an RenderFieldResult object
		var renderResultItem = asset.RenderAsset(); 
		var title = asset.AssetMetadata.Name;
		var id = asset.AssetMetadata.AssetId;
		var assetTypeId = asset.AssetMetadata.AssetTypeId;
		var assetTypeName = asset.AssetMetadata.AssetTypeName; 


		// Get dynamic metadata
		var someDynamicMetadata = asset.AssetMetadata["50343"];
	}
}

3.5.4 Update asset metadata not supported from code

Updating an items metadata is not supported from code. Use the editor in the DAM Explorer or Asset browser.

  • No labels