Update Documentum Assets in Package

The Update Documentum Assets in Package Template Building Block retrieves the correct rendition of an asset from Documentum when content is published from the Content Manager (otherwise you publish the thumbnail image that SDL Tridion stores internally).

The Update Documentum Assets in Package Template Building Block has one parameter:

Rendition name
The Rendition name is an optional parameter for overriding the default rendition specified in the DocumentumConnector.config. You can override the default in each Compound Template where you use the Update Documentum Assets in Package Template Building Block.
You can also override it again in a Dreamweaver Template by calling the GetFromDctm function.
Template tasks
The template performs the following tasks:
  1. Loops through every binary currently in the package.
  2. Identifies the items that are based on the Multimedia Schema called Documentum asset specified in the DocumentumConnector.config file or in a package item called dctm_SchemaId.
  3. If the item is based on this Schema:
    • determines the Object ID by reading the metadata fields of the Multimedia ComponentMC. The Object ID field can be called dctm_ObjectId or dctm_ChronicleId
    • throws a NullReferenceException if the Object ID cannot be determined from the metadata.
  4. Invokes the Documentum Connector Web service to retrieve the binary using the rendition specified. You can specify the rendition in the Template's parameters, in the package (in an item called dctm_RenditionNameToReturn), or in the DocumentumConnector.config file.
  5. Replaces the item in the package with the rendition/binary retrieved from Documentum.
  6. Parses the current Output item searching for Rich Text Field output; images added to RTF contain @width and @height attributes based on the thumbnails stored in Content Manager (which can result in the image being published with an incorrect width and height).
  7. If @width and @height attributes are found, the template compares these with the actual dimensions of the thumbnail:
    • if the dimensions match, the attributes are replaced with the actual height and width of the binary coming from Documentum.
    • If the dimensions do not match, a content editor changed the dimensions therefore the template will not change the RTF output.