{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Prerequisite for this guide, you must install the package ","type":"text"},{"text":"DAM for Sitecore JSS-11.1.zip","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"paragraph","content":[{"text":"The connector comes with a fieldserializer for each of the 3 custom field types: asset, assetlink and assetlist. The config can be found in the file App_Config\\Include\\damforsitecore\\DFS.JSS.Digizuite.config.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n \n \n \n \n \n \n Asset\n \n \n \n \n Assetlink\n \n \n \n \n Assetlist\n \n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Using the Sitecore Layout Services ","type":"text"},{"text":"/sitecore/api/layout/render/[config]?item=[path]&sc_lang=[language]&sc_apikey=[key]","type":"text","marks":[{"type":"code"}]},{"text":". The json output for each of the 3 fieldserializers can be configured. The configuration can be found in the file App_Config\\Include\\damforsitecore\\DFS.Settings.config. The default config looks like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n \n \n \n \n ","type":"text"}]},{"type":"paragraph","content":[{"text":"This is an example of the out for the fieldtype asset.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":" \"DFS Medie\": {\n \"value\": {\n \"assetTypeId\": 4,\n \"title\": \"Butterfly\",\n \"src\": \"/dfsmedia/baeefe6b74df44be8a2bccfb2c57af8e/114-50036/butterfly\",\n \"src_download\": \"/dfsmedia/baeefe6b74df44be8a2bccfb2c57af8e/114-50036/options/download/butterfly\"\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"The section ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" can contain 2 different types tags ","type":"text"},{"text":"property ","type":"text","marks":[{"type":"code"}]},{"text":"and ","type":"text"},{"text":"quality","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Property tag","type":"text"}]},{"type":"paragraph","content":[{"text":"These are all the metadata describing the asset.","type":"text"},{"type":"hardBreak"},{"text":"The following attributes are avaible","type":"text"},{"text":":","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"outputName","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"This is the property name of the json output.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"propertyName","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The properties that can be used are the one fra the ","type":"text"},{"text":"AssetMetadata","type":"text","marks":[{"type":"code"}]},{"text":" object ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://digizuite.atlassian.net/wiki/spaces/DD/pages/3796174277"}},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"Use the name from the Property Name column. If you want to use some of the dynamic metadata, then insert the guid og the metafield. The avaible metafield guids can be found in the Administration dashboard under the menu “Show settings” ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://digizuite.atlassian.net/wiki/spaces/DD/pages/3796176473"}},{"text":". Look for the property DynamicMetadata. If you dont see the metafield you want, then it could be that the user to synchronize data between Digizuite and Sitecore does not have read access to the metafield. Please contact Digizuite for futher help.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"delimiter","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"This is used for properties with multiple values. The default delimiter is semicolon.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Quality tag","type":"text"}]},{"type":"paragraph","content":[{"text":"These are the link to the media, can be the source file og the asset or any variant. Can be requested as a download url also.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following attributes are avaible","type":"text"},{"text":":","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"outputName","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"This is the property name of the json output.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"qualityId","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"This is the rendition id of an asset also known as the mediaFormatId. If you want to request the source of the asset, the type source or -1. If you down add this attribute, then the quality that the content editor selected will be used.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"download","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"If you want the url to be a donload url, then set this to true.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is a list of different usecases and how the configurations should look like.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"I want to get the title of the asset","type":"text"},{"type":"hardBreak"},{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"I want to get the Photograph metafield from my Digizuite which has the guid ","type":"text"},{"text":"baeefe6b-74df-44be-8a2b-ccfb2c57af8e","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"I want to get all the folders that the asset is part of. But i want the delimiter to be #","type":"text"},{"type":"hardBreak"},{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"I want to get the media url with the rendition the content editor selected","type":"text"},{"type":"hardBreak"},{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"I want to get the media url with a specific rendition from my Digizuite DAM. The rendition is called Small JPG and has mediaFormatId 50036","type":"text"},{"type":"hardBreak"},{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"I want to get the media url for the source of the asset","type":"text"},{"type":"hardBreak"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"I want to get the media url with a specific rendition from my Digizuite DAM and make it a download link. The rendition is called Small JPG and has mediaFormatId 50036","type":"text"},{"type":"hardBreak"},{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Crops","type":"text"}]},{"type":"paragraph","content":[{"text":"If an asset has crops, then it is posible to get a list of the crops in the json respons. You simply add a property called Crops like this.","type":"text"},{"type":"hardBreak"},{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The json output would look like this.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"\"DFS Medie\": {\n \"value\": {\n \"assetTypeId\": 4,\n \"title\": \"Butterfly\",\n \"crops\": [\n {\n \"assetTypeId\": 4,\n \"title\": \"Butterfly\",\n \"crops\": \"\",\n \"src\": \"/dfsmedia/baeefe6b74df44be8a2bccfb2c57af8e/119-50036/butterfly\",\n \"src_download\": \"/dfsmedia/baeefe6b74df44be8a2bccfb2c57af8e/119-50036/options/download/butterfly\",\n \"cropname\": \"Widescreen\"\n },\n {\n \"assetTypeId\": 4,\n \"title\": \"Butterfly\",\n \"crops\": \"\",\n \"src\": \"/dfsmedia/baeefe6b74df44be8a2bccfb2c57af8e/120-50036/butterfly\",\n \"src_download\": \"/dfsmedia/baeefe6b74df44be8a2bccfb2c57af8e/120-50036/options/download/butterfly\",\n \"cropname\": \"Banner\"\n }\n ],\n \"src\": \"/dfsmedia/baeefe6b74df44be8a2bccfb2c57af8e/114-50036/butterfly\",\n \"src_download\": \"/dfsmedia/baeefe6b74df44be8a2bccfb2c57af8e/114-50036/options/download/butterfly\"\n }\n}","type":"text"}]}],"version":1}