ExifTool - Metadata mapping
Synchronize metadata between image files and asset properties.
Overview
Users can restore edited metadata into (additional) storage items. ExifTool functionality (Extract and write file meta data) can be used in context with the censhare Client application and monitored folders on the server. When files are imported or exported with other tools (e.g. XSLT commands, content export, etc.), metadata mapping exists from within XSLT.
This enables users to download images from the Online Channel with the latest metadata updates. Other use cases include the sending of images via e-mail or download link. Make ExifTool calls using the all enhanced censhare.api-Interface
ExifTool extensions in the API
Reading file meta data of the specified file and return the result as XML
CODE<cs:command name="com.censhare.api.exiftool.read" returning=":resultVariable"> <cs:param name="source" select="$source"/> </cs:command>
@param source references to a file
@return Result of ExifTool as XML
Write the specified parameters (using string syntax of ExifTool) to the given source file and save in specified target file
CODE<cs:command name="com.censhare.api.exiftool.write"> <cs:param name="source" select="$source"/> <cs:param name="dest" select="$dest"/> <cs:param name="parameters" select="$parameters"/> </cs:command>
@param source references to a file
@param dest references to the target file
@param parameters results in a string containing all tag parameters (result of the XSLT 'getExifToolWriteParameters')
@return nothing
Update the source asset based on the passed parameters (ExifTool readout) and the JavaScript mapping file
CODE<cs:command name="com.censhare.api.exiftool.updateAssetFromExifToolResult" returning=":resultVariable"> <cs:param name="source" select="$source"/> <cs:param name="file-metadata" select="$parameters"/> <cs:param name="javascript" select="$javascript"/> </cs:command>
@param source stands for the asset
@param file-metadata the ExifTool readout
@param optional file reference to JavaScript mapping or Default under "censhare-Server/app/modules/asset/metadata-mapping.js" if not defined. The JavaScript modifies the given asset with the XML data read by ExifTool
@return changed asset XML
Get ExifTool write parameters using given JavaScript of given source asset
CODE<cs:command name="com.censhare.api.exiftool.getExifToolWriteParameters" returning=":resultVariable"> <cs:param name="source" select="$source"/> <cs:param name="storageitem" select="$storageitem"/> <cs:param name="javascript" select="$source"/> </cs:command>
@param source stands for the asset
@param storageitem is the storage item XML of the given asset
@param optional file reference to the JavaScript mapping or default under "censhare-Server/app/modules/asset/metadata-mapping.js" if not defined. The JavaScript produces the write syntax for ExifTool for a given asset
@return ExifTool write parameters as a string