What is Media Transformation Services?

What is Media Transformation Services?
EMC® Documentum®
Media Transformation Services
Version 6
Administration Guide
P/N 300-005-306
EMC Corporation
Corporate Headquarters:
Hopkinton, MA 01748-9103
1-508-435-1000
www.EMC.com
Copyright © 1994 - 2007 EMC Corporation. All rights reserved.
Published August 2007
EMC believes the information in this publication is accurate as of its publication date. The information is subject to change
without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED AS IS. EMC CORPORATION MAKES NO REPRESENTATIONS
OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY
DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.
For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com.
All other trademarks used herein are the property of their respective owners.
Table of Contents
Preface
Chapter 1
Chapter 2
...........................................................................................................................
.............................................
What is Content Transformation Services? ....................................................
Content Transformation Services scalability .............................................
What is Media Transformation Services? ......................................................
Media Transformation Services components .............................................
Media Transformation Services environment ........................................
Media Transformation Server ..............................................................
Documentum Foundation Classes .......................................................
Media Transformation Services plug-ins ..............................................
Add-on Transformation Services .........................................................
Audio/Video Transformation Services ..............................................
Medical Imaging Transformation Services ........................................
How Media Transformation Services works .................................................
Integration with Content Server...............................................................
Storing objects ........................................................................................
Media Object data model ....................................................................
What Media Transformation Services does ...................................................
Automated transformations ....................................................................
Checking in files .................................................................................
Extracting media properties ................................................................
Generating thumbnails .......................................................................
Generating storyboards.......................................................................
Generating low-resolution renditions ...................................................
Extracting IPTC headers......................................................................
User transformations ..............................................................................
User transformation profiles ................................................................
Multiple renditions .............................................................................
Features of Media Transformation Services ..................................................
Media Transformation Services capabilities ..................................................
Supported transformations by source and target formats ..............................
Media Transformation Services Overview
Conguring Media Transformation Services .........................................
Configuring Media Transformation Services through
Documentum Administrator .......................................................................
Starting and stopping the CTS Administration Agent ...............................
Accessing the configuration screen in Documentum Administrator ............
Adding or removing repositories serviced by Media
Transformation Services ..............................................................................
Defining file formats and DOS extensions ....................................................
Configuring the pixel threshold for Adobe Graphics Server ...........................
Configuring the Image 3 plug-in ..................................................................
ICC profiles ............................................................................................
EMC Documentum Media Transformation Services Version 6 Administration Guide
9
11
11
12
13
13
13
14
14
15
16
16
17
17
18
19
19
20
21
24
24
25
25
26
26
27
28
28
29
30
32
35
35
36
37
37
38
40
40
40
3
Table of Contents
Chapter 3
Chapter 4
4
COM Server parameters ..........................................................................
Pixel cache parameters ............................................................................
41
41
Configuring Inbox notifications ...................................................................
42
Administering Media Transformation Services ......................................
Administering Media Transformation Services through
Documentum Administrator .......................................................................
Starting and stopping the CTS Administration Agent ...............................
Starting and stopping Media Transformation Services ...................................
Managing multiple servers ..........................................................................
Changing the CTS Service user after installation ...........................................
Changing the CTS administrator password ..................................................
45
45
46
47
47
48
48
Configuring the queue marker mechanism to manage queue item
sign-off ......................................................................................................
Working with the CTS Activity Template in Documentum Process
Builder.......................................................................................................
Making the CTS Activity Template available to users ................................
Making transformation profiles available for use with the
template ................................................................................................
Transformation profiles with no parameters .........................................
Using the CTS Activity Template .............................................................
50
51
51
Using the CTS Reporting Tool .....................................................................
Enabling and disabling the CTS Reporting Tool ........................................
Viewing the CTS Reporting Tool report ....................................................
Managing the transformation queue ............................................................
Viewing transformation requests in the queue ..........................................
Changing a queue item’s priority .............................................................
Viewing details of a queue item ...............................................................
Deleting a pending queue item ................................................................
Configuring additional queue management fields.....................................
Removing a queue management field ......................................................
52
52
53
54
55
55
56
57
57
58
Working with Proles ............................................................................
Understanding profiles ...............................................................................
Locating profiles .....................................................................................
System profiles .......................................................................................
Register profile ...................................................................................
ImportExtractProperties profile ...........................................................
Thumbnail profile ...............................................................................
AutoGenProxy profile .........................................................................
PowerpointRegistration profile ............................................................
User profiles ...........................................................................................
Enabling a user prole in Webtop or DAM ...........................................
Chaining and sequencing profiles ........................................................
Command-line files ................................................................................
Media Transformation Services DTD........................................................
Sample profile ........................................................................................
59
60
60
61
61
63
64
65
66
66
67
67
68
68
71
Predefined Media Transformation Services transformation profiles ................
Standard Media Transformation Services profiles .....................................
Predefined Audio/Video Transformation Services profiles ........................
Predefined Medical Imaging Transformation Services profiles ...................
Adding and modifying transformation profiles ............................................
Building and modifying profiles with Profile Editor ..................................
Editing a profile..................................................................................
72
72
74
75
76
76
77
48
49
50
EMC Documentum Media Transformation Services Version 6 Administration Guide
Table of Contents
Chapter 5
Chapter 6
Building a new profile.........................................................................
Building a chain profile .......................................................................
Building a parallel profile ....................................................................
Creating a profile manually using command-line files ...............................
Manually modifying a profile using command-line files ............................
Example profile modification ..............................................................
Adding new formats to profiles manually ....................................................
Reusing profiles..........................................................................................
Creating chain profiles manually .............................................................
Creating parallel profiles manually ..........................................................
78
79
81
83
86
87
88
90
90
92
Using DQL in profiles .................................................................................
The dql attribute value syntax .................................................................
DQL guidelines ......................................................................................
DQL query examples ..............................................................................
Querying the r_object_id attribute ...........................................................
93
94
94
94
95
.................................................................
Adding copyright properties .......................................................................
Adding text ................................................................................................
Adjusting contrast ....................................................................................
Adjusting levels ........................................................................................
Applying a watermark ..............................................................................
Changing layer color.................................................................................
Changing ICC color profile .......................................................................
Changing resolution .................................................................................
Converting an image ................................................................................
Embedding metadata ................................................................................
Extracting properties ................................................................................
Flipping an image .....................................................................................
Changing layer text ..................................................................................
Resizing an image.....................................................................................
Rotating an image.....................................................................................
Setting canvas size ....................................................................................
Trimming an image ..................................................................................
97
Performing Transformations
98
99
101
102
103
105
106
108
109
110
112
113
114
116
118
119
121
Troubleshooting ..................................................................................
Queue items are not generating .................................................................
Error events and log files ...........................................................................
123
123
123
A transformation request fails ...................................................................
A profile error occurs ................................................................................
Media Transformation Server cannot add a rendition to a
particular format ......................................................................................
Media Transformation Server cannot log in to the repository .......................
Media Transformation Server fails to start the PowerPoint plug-ins..............
124
125
126
126
127
Content Transformation Services fails to function .......................................
127
EMC Documentum Media Transformation Services Version 6 Administration Guide
5
Table of Contents
List of Figures
14
Figure 3.
Typical Media Transformation Services installation ...........................................
The position of Media Transformation Server in the Documentum
product stack .............................................................................................
Media Object data model ................................................................................
Figure 4.
Figure 5.
The registration process ..................................................................................
The transformation process .............................................................................
23
28
Figure 1.
Figure 2.
6
18
20
EMC Documentum Media Transformation Services Version 6 Administration Guide
Table of Contents
List of Tables
Table 1.
Table 2.
Table 3.
Sample extracted media properties ..................................................................
Features of Media Transformation Services ......................................................
Media Transformation Services supported capabilities ......................................
24
29
31
Table 4.
Table 5.
Table 6.
Table 7.
Table 8.
Table 9.
Table 10.
Supported transformations with Media Transformation Services .......................
File format attributes ......................................................................................
Documentum format mapping ........................................................................
Pixel cache parameters for Image 3 plug-in.......................................................
Inbox notification settings ...............................................................................
Standard Media Transformation Services transformation profiles ......................
Standard Audio/Video Transformation Services profiles ...................................
32
38
39
41
42
73
74
EMC Documentum Media Transformation Services Version 6 Administration Guide
7
Table of Contents
8
EMC Documentum Media Transformation Services Version 6 Administration Guide
Preface
This guide provides step-by-step procedures for configuring and administering Documentum Media
Transformation Services. This manual also includes information about modifying plug-ins to extend
the functionality of Media Transformation Services.
This manual assumes that Media Transformation Services is successfully installed. For information on
installing Media Transformation Services, refer to the Media Transformation Services Installation Guide.
You can find additional information about Media Transformation Services in the following documents:
•
Media Transformation Services Release Notes, which includes important notes on installation and
administration issues, requirements, and limitations. This document also references some bugs.
•
Media Transformation Services Installation Guide, which describes how to install Media
Transformation Services.
•
Audio/Video Transformation Services Installation and Release Notes, which includes installation and
release note information for the Audio/Video plug-in, an add-on for Media Transformation
Server, which includes audio and video plug-ins.
•
Medical Imaging Transformation Services Installation and Release Notes, which includes installation
and release note information for Medical Imaging Transformation Services, an add-on for Media
Transformation Server.
•
Transformation Services SDK Developer’s Guide, which explains how to use the plug-in SDK to create
and configure your own plug-ins for Media Transformation Services. Contact your account
representative for availability of the Transformation Services SDK Developer’s Guide.
See the appropriate Documentum product documentation for information on related Documentum
products.
Intended audience
This manual is intended for the person who is responsible for configuring and
administering Media Transformation Services, generally known as the system operator
or system administrator.
It is assumed that the system operator has a basic understanding of the Windows
operating system.
Chapter 5, Performing Transformations provides procedural information for users of
this software.
EMC Documentum Media Transformation Services Version 6 Administration Guide
9
Preface
Revision history
The following changes have been made to this document.
Revision history
10
Revision date
Description
August 2007
Initial publication for version 6 product release.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Chapter 1
Media Transformation Services
Overview
This chapter provides an overview of Media Transformation Services. It includes the following
sections:
•
What is Content Transformation Services?, page 11 is a brief overview of Content Transformation
Services and the set of products that the term is commonly used to describe. Media
Transformation Services is a product within the Content Transformation Services suite.
•
What is Media Transformation Services?, page 13 is an introduction to Media Transformation
Services with a general description of its major components.
•
What Media Transformation Services does, page 20 provides an overview of Media
Transformation Services and describes how Media Transformation Services integrates with
Content Server and other Documentum products.
•
How Media Transformation Services works, page 17 provides a brief explanation of how Media
Transformation Services works with your Documentum installation, and describes how Media
Transformation Services integrates with Content Server.
•
Describes the functionality available with the core Media Transformation Services product, as
well as those available with add-on products.
•
Media Transformation Services capabilities, page 30 lists the supported capabilities of Media
Transformation Services by file type.
•
Supported transformations by source and target formats, page 32 includes a table of supported
transformations by source and target formats.
What is Content Transformation Services?
Content Transformation Services (CTS) is a suite of Documentum server products that
perform transformations and analysis on repository content. CTS includes these main
products:
•
Advanced Document Transformation Services (ADTS)
EMC Documentum Media Transformation Services Version 6 Administration Guide
11
Media Transformation Services Overview
•
Document Transformation Services (DTS)
•
Media Transformation Services (MTS)
•
XML Transformation Services (XTS)
Additional components are available for some of these products. For example, Media
Transformation Services may have additional transformation services installed, such
as Audio/Video Transformation Services (AVTS) or Medical Imaging Transformation
Services (MITS). These components supplement the features already provided by the
base product, according to your organization’s requirements.
Content Transformation Services scalability
Content Transformation Services (CTS) products allow for a high level of scalability.
All CTS products run under the same Windows Service on the CTS host. This means
that stopping or starting the CTS service stops or starts all the CTS products on that
host. For example, if your CTS host contains Document Transformation Services and
Media Transformation Services, stopping the CTS Windows Service stops both of those
products.
Each CTS product can be configured for multiple repositories. If you have one installation
of a product on a host, that installation can be configured against different repositories.
CTS scalability also allows for several instances of Content Transformation Services
products on different hosts to be configured for the same repository. This means that
your installation can take either of two forms: one with identical plug-in capabilities,
or one with different plug-in capabilities.
The ability for each instance of Media Transformation Server to handle different plug-ins
means that you can have each instance dedicated to a specific type of transformation. For
example, you might have a dedicated Media Transformation Server for transformations
to PDF, and a dedicated Media Transformation Server for transformations to HTML.
In this case, each instance has different plug-ins, but all instances point to the same
repository.
The other benefit of having identical Media Transformation Services installations is that a
hardware failure in one instance will not stop all installations from processing queue
items. In cases where each instance of Media Transformation Services has different
plug-in capabilities, each server accepts only those items from the processing queue that
it is capable of handling.
To enable this functionality, Content Transformation Services has format awareness.
Format awareness is the ability for a Content Transformation Services product to
recognize which file formats it is capable of processing. Items that cannot be processed
successfully will be removed from the queue automatically. For example, if several
transformation requests are made for JPEG files, but the product does not support
12
EMC Documentum Media Transformation Services Version 6 Administration Guide
Media Transformation Services Overview
JPEGs, the system will remove those items from the queue. A check for unprocessed
items is performed periodically.
What is Media Transformation Services?
Media Transformation Services (MTS) is server software that integrates with Content
Server to perform analysis and transformation activities for media file formats.
Thumbnail, storyboard, and low-resolution renditions are generated automatically.
Media transformations can be triggered automatically by certain events, such as when an
object is versioned, or as requested by users.
The Media Transformation Services software package includes the following major
components:
•
Media Transformation Server
•
Audio/Video Transformation Services (optional; not included with purchase of
Media Transformation Services)
•
Medical Imaging Transformation Services (optional; not included with purchase of
Media Transformation Services)
•
Thumbnail Server
•
Streaming Server Integration (optional; Streaming Server is a third party product
that is not included with purchase of Media Transformation Services)
Media Transformation Services components
Media Transformation Services is an added component to your basic Documentum
installation that includes Content Server and defined repositories with file stores. The
Media Transformation Services software is integrated with Content Server to process
both static and streaming media automatically.
Media Transformation Services environment
Figure 1, page 14 shows a typical Media Transformation Services installation on the
Documentum platform.
EMC Documentum Media Transformation Services Version 6 Administration Guide
13
Media Transformation Services Overview
Figure 1. Typical Media Transformation Services installation
Media Transformation Server
Media Transformation Services is integrated with Documentum Content Server to
process, store, and manage files within the Documentum schema. When users import
files or request file transformations, the Content Server stores those register and request
objects in a queue. The Media Transformation Server will poll that queue intermittently,
looking for register and request objects. The file is then passed to the appropriate media
plug-in for processing.
When the processing is complete, the Media Transformation Server updates the original
objects with new renditions or creates the new objects, as requested. The objects are
saved to the repository and the requests are removed from the queue. The objects are
then ready for use.
Users browse metadata for the objects and view thumbnails and low-resolution
renditions in a Media Transformation Services enabled client application, such as Digital
Asset Manager or Web Publisher.
Documentum Foundation Classes
The Documentum Foundation Classes (DFC) are a set of Java classes that provide
access to Content Server functionality. Web-based applications, such as Digital Asset
14
EMC Documentum Media Transformation Services Version 6 Administration Guide
Media Transformation Services Overview
Manager and Web Publisher, make calls directly to the DFC or indirectly through the
Web Development Kit (WDK).
DFC must be installed on the Media Transformation Services host, and is included with
the installer. During installation, the Media Transformation Services installer checks for
an existing DFC on the host. The following scenarios are possible:
•
If DFC does not exist on the host, the installer installs the correct version.
•
If an older version of DFC exists on the host, it is replaced by the
version included with the installer. Refer to the relevant version of the
Documentum System Migration Guide available on the Download Center at
https://emc.subscribenet.com/control/dctm/index for more information on migration
issues. Follow the Documentum Foundation > Documentation for Documentum 6
link.
Any applications that were dependent upon the older version of the DFC will have
to be upgraded as well. For more information on the DFC and its effect on other
applications, refer to your specific Documentum application documentation.
•
If a version of DFC exists and it is newer than that which is included with the
installer, it will be refreshed.
Media Transformation Services plug-ins
The Media Transformation Server plug-ins identify and extract media-specific properties,
such as height, width, color mode, and compression, and generate thumbnails and
low-resolution renditions of objects. The plug-ins also enable the transformation of media
files from one format to another (for example, from TIFF to JPEG) and provide users with
the ability to perform transformations such as resizing, flipping, or rotating an image.
The standard Media Transformation Services plug-ins are as follows:
•
AlterCast — processes images and other file formats. Generates thumbnails,
generates low-resolution renditions, extracts properties, and enables editing such as
flip, addText, and rotate.
•
PowerPoint — generates thumbnails, low-resolution renditions, storyboards, and
slide objects for PowerPoint files.
•
Image 1 — processes images and other file formats. Generates thumbnails, generates
low-resolution renditions, extracts properties, and performs transformations such as
resize and transformTo.
•
Image 2 — processes images and other file formats. Generates thumbnails, generates
low-resolution renditions, extracts properties, and performs transformations such
as resize.
EMC Documentum Media Transformation Services Version 6 Administration Guide
15
Media Transformation Services Overview
•
Image 3 — processes images and other file formats. Generates thumbnails, generates
low-resolution renditions, and extracts properties of large image files. This plug-in
also generates thumbnails, generates low-resolution renditions, extracts properties,
and creates storyboards for PDF files.
•
PDF Storyboard — generates thumbnails, low-resolution renditions, and storyboards
for PDF files.
•
XMP — extracts metadata from image and document (PDF) formats.
During an installation of Media Transformation Services, all standard plug-ins are
installed.
There are also some prerequisites for some of the standard plug-ins. For example,
the PowerPoint plug-in requires that Microsoft PowerPoint is installed on the Media
Transformation Server host. In order to process PDF files, the Image 3 plug-in requires
Ghostscript. For more information on specific versions supported with Media
Transformation Services and installation prerequisites, see the Media Transformation
Services Installation Guide.
Plug-ins are extensible. You can configure plug-in types and formats, and you
can add new plug-ins to the system to support new file formats as required. For
information about creating and adding new plug-ins, see the Media Transformation
Services Administration Guide, the Content Transformation Services SDK Development Guide,
or contact your Documentum account or support representative.
Add-on Transformation Services
A number of transformation products can be added to a Media Transformation Services
installation. These add-on transformation services are discussed below.
Audio/Video Transformation Services
Audio/Video Transformation Services is an optional product that must be purchased
separately.
The add-on Audio/Video Transformation Service component contains the following
plug-ins:
•
AVI Video plug-in (AVI)
•
Telestream plug-in (TLS)
These plug-ins include transformation profiles for audio and video files. Telestream
FlipFactory must be installed on the Media Transformation Server host if you wish to use
the Telestream plug-in.
16
EMC Documentum Media Transformation Services Version 6 Administration Guide
Media Transformation Services Overview
For more information on Audio/Video Transformation Services, contact your account
representative or see the Audio/Video Transformation Services Installation and Release Notes.
Medical Imaging Transformation Services
Medical Imaging Transformation Services is an optional product that must be purchased
separately.
The add-on Medical Imaging Transformation Service component contains the following
plug-ins:
•
Medical Imaging plug-in (DICOM)
•
AVI Video plug-in (AVI)
The Medical Imaging plug-in enables supported Documentum clients to extract
properties and perform transformations of images. Medical Imaging Transformation
Services can also create thumbnails and storyboards for medical imaging files. With a
proper profile it can create JPEG images of any size from the medical imaging file, not
just the default thumbnail and storyboard sizes. It is also possible to create an AVI file
using the JPEG storyboard frames of medical imaging images.
For more information on Medical Imaging Transformation Services, contact your account
representative or see the Medical Imaging Transformation Services Installation and Release
Notes.
How Media Transformation Services works
Media Transformation Services is integrated with Documentum Content Server to
process, store, and manage files within the Documentum schema (see Integration with
Content Server, page 18). When a user registers a file in the repository (checks it in), the
Content Server stores the register request (dmi_queue_item object) in a queue. The
Media Transformation Server examines the queue, retrieves the objects, and sends the
objects to the appropriate plug-ins for processing (see Automated transformations,
page 21). The Media Transformation Services plug-ins extract media properties and
generate thumbnails, low-resolution renditions, storyboards, if applicable, and perform
transformations, if requested.
When plug-in processing is complete, the Media Transformation Server updates the
original objects, adding attributes and alternate renditions if necessary. The objects are
saved to the repository and the request is removed from the queue (see Storing objects,
page 19). The files are then ready for use. Users browse metadata for the files and view
thumbnails and low-resolution renditions in a client application.
EMC Documentum Media Transformation Services Version 6 Administration Guide
17
Media Transformation Services Overview
Integration with Content Server
Media Transformation Services integrates with Content Server, the core of the
Documentum architecture, to process, store, and reuse objects. When files are checked in
to the repository, Content Server recognizes their formats. Content Server recognizes
supported Media Transformation Services formats through the richmedia_enabled
attribute of the dm_format object, which identifies files as they are checked in to the
repository.
The richmedia_enabled attribute is set to 1 (TRUE) for all formats supported by the
Media Transformation Services plug-ins.
Content Server automatically queues requests (dmi_queue_item objects) to the
dm_mediaserver queue for Media Transformation Server. Media Transformation Server
examines the queue, and when it finds applicable request objects in the queue, Media
Transformation Server retrieves the items and proceeds with processing by executing the
appropriate plug-in for the media format.
Because Media Transformation Server connects to Content Server, Media Transformation
Services is available to all applications and clients that are built on top of the
Documentum Foundation Classes (DFC), as shown in Figure 2, page 18.
Figure 2. The position of Media Transformation Server in the Documentum product stack
Applications on the Documentum platform determine whether Media Transformation
Services is installed on the system by examining the value of a global flag, the
richmedia_enabled attribute of the dm_repository_config object. The global flag attribute,
richmedia_enabled, is set to TRUE automatically the first time Media Transformation
Services is started. Applications will test this object, dm_repository_config, when a user
logs in to a repository. When an application detects the flag, it recognizes that Media
Transformation Services is installed and the system is able to process files.
18
EMC Documentum Media Transformation Services Version 6 Administration Guide
Media Transformation Services Overview
The Content Server stores thumbnails in a special file store that is shared with the
Thumbnail Server, a server that uses Java servlets to manage thumbnail representations
and HTTP technology to accelerate the display of thumbnail images in Web client
applications.
For more information on Thumbnail Server, see the Thumbnail Server Installation,
Configuration, and Release Notes.
With Streaming Server integration, when a streaming media object is checked into the
repository, the Content Server recognizes that the object is in a streaming format and
figures out how the object should be processed and where it should be stored. The
Content Server stores the streaming media in a separate file store from which the media
can be streamed directly to the client.
For more information on Streaming Server integration, see the Audio/Video Transformation
Services Installation and Release Notes, or consult your Streaming Server documentation.
Storing objects
The following section describes where and how Documentum objects are stored.
Storage rules are generally controlled by the Content Server. All objects have multiple
content objects that are each stored in databases on the repository. For more information
on object storage, see the Content Server Administration Guide.
Media Object data model
The information in Figure 3, page 20 demonstrates how thumbnails, low-resolution
renditions, media properties, and transformations are stored in the repository for objects.
Each box represents an object in the repository. The parent, Media Object, can have each
of the renditions specified in the boxes. Each rendition has its own media properties
stored in the repository. For example, a JPEG thumbnail rendition of the object will have
the media properties cont_attr_name and cont_attr_value associated with it.
EMC Documentum Media Transformation Services Version 6 Administration Guide
19
Media Transformation Services Overview
Figure 3. Media Object data model
What Media Transformation Services does
This section describes the major functions of Media Transformation Services.
When a user requests processing on a file, Content Server works with the Media
Transformation Server to complete the request. Content Server maintains the job queue
for Media Transformation Server, which contains transformation requests. When objects
are checked in to the repository, Content Server detects the file format and type, and
automatically queues a request for Media Transformation Server to process the object.
Media Transformation Server polls the queue intermittently for queue items.
Each item in the queue has a priority. Media Transformation Server handles requests on
a priority-based, first-come-first-served basis. For example, when a media file is checked
in, the thumbnail request is handled at normal priority. An urgent request, perhaps for a
transformation for which the user is waiting, can be submitted at high priority, which
causes the request to be handled before any lower priority request. A batch check-in of
many files can be set to a lower priority to avoid hampering the performance of more
20
EMC Documentum Media Transformation Services Version 6 Administration Guide
Media Transformation Services Overview
urgent media operations. When requests have equal priority, Media Transformation
Server first handles the request that was submitted first.
Media Transformation Services must be configured to log in to a repository to perform
any action. For more information on configuring Media Transformation Services for a
repository, see the Media Transformation Services Installation Guide.
Note that transformations take place either as part of the registration process (described
in Automated transformations, page 21) or as requested by users (described in User
transformations, page 27).
Automated transformations
Transforming is the act of changing a file in some way to create a new file.
The process of adding files to the repository is called registration. When files are
imported or checked in, default transformations are created automatically. When
the plug-ins are finished processing the object, Media Transformation Services saves
the original object back to the repository, along with the media properties and new
renditions, which can be used by other Documentum components.
Media Transformation Server plays an intricate role in processing files. With Media
Transformation Services installed, Media Transformation Server automatically intercepts
media objects as they are checked in to the repository and sends them to their appropriate
plug-in for processing. Plug-ins identify and extract media-specific properties, generate
thumbnails and low-resolution renditions, and generate storyboards (if applicable).
The overall process of registering a file in Media Transformation Services (depicted in
Figure 4, page 23) is as follows:
1.
The user imports or checks in a file to the repository.
2.
The Content Server creates a dmi_queue_item object of the event type
dm_register_asset, which is added to the Media Transformation Services register
queue. Only content that is rich media enabled is passed to the queue.
3.
The Media Transformation Server checks the queue regularly; the default is
every 10 seconds. When it finds queue items, it signs off a certain number
(the default is 10 items). Both of these parameters are configurable through
Documentum Administrator (see Configuring Media Transformation Services
through Documentum Administrator, page 35 for more information).
4.
The Media Transformation Server starts processing the items using the register
profile. It will not remove an item from the queue until the transformation is
complete or has failed.
EMC Documentum Media Transformation Services Version 6 Administration Guide
21
Media Transformation Services Overview
5.
The Media Transformation Server loads the transformation profile specified by the
inner profile path in the register profile.
6.
Media Transformation Server polls the plug-ins in the order specified by the
transformation profile.
7.
The server finds a plug-in to accept the transformation. If more than one plug-in can
handle the transformation, the plug-ins are invoked in the order specified by the
transformation profile.
8.
The Media Transformation Server uses the command-line file to perform the
transformation with the relevant plug-in.
9.
Media Transformation Server updates the object in the repository, storing the
thumbnails and low-resolution renditions (by using an API call) and storing media
properties as attributes for each rendition (in the attributes content_attr_name and
content_attr_value of dmr_content objects). It removes the dmi_queue item object
from the queue.
10. The new rendition is available in the client application.
22
EMC Documentum Media Transformation Services Version 6 Administration Guide
Media Transformation Services Overview
Figure 4. The registration process
The automatic transformation processes performed by Media Transformation Services
are described in more detail in the following sections:
•
Checking in files, page 24
•
Extracting media properties, page 24
•
Generating thumbnails, page 25
•
Generating storyboards, page 25
•
Generating low-resolution renditions, page 26
•
Extracting IPTC headers, page 26
For more information about the storage of files, see Storing objects, page 19.
EMC Documentum Media Transformation Services Version 6 Administration Guide
23
Media Transformation Services Overview
Checking in les
When a user checks in a file and the richmedia_enabled attribute is set to TRUE, Content
Server queues a REGISTER_ASSET apply call for Media Transformation Server. Media
Transformation Server polls the queue intermittently. When the Media Transformation
Server retrieves a registration request, it invokes the appropriate plug-ins for processing.
Processing occurs automatically, in the background.
Extracting media properties
Media Transformation Services provides a full range of plug-ins to support
industry-standard file types, including image, video, and audio. Plug-ins recognize files
and automatically extract media-specific properties, such as image height and width,
bit rate, and audio sampling frequency.
During registration, Media Transformation Server first generates media properties
for the high-resolution object. It then stores the properties for the object in two new
repeating attributes of dmr_content objects: content_attr_name and content_attr_value.
Media properties are added to the object’s indexed metadata (as a string value) and saved
back to the repository. This provides the framework for client applications to expose
media properties as part of an object’s searchable metadata set. Media Transformation
Server does the same for each rendition (thumbnail, low-resolution, and transcoded
renditions). Media properties are stored as attributes of each rendition, not of the object.
A sample of media properties extracted for video, image, and audio files can be found
in Table 1, page 24.
Table 1. Sample extracted media properties
24
Video
Image
Audio
Frame width
Width
Sample width
Bit rate
JPEG quality
Sample rate
Frame rate
Compression
Number of samples
Format
Format
Format
Number of frames
GIF interleave
Number of frames
Frame height
Color mode
Number of channels
Duration
Height
Duration
EMC Documentum Media Transformation Services Version 6 Administration Guide
Media Transformation Services Overview
Generating thumbnails
A thumbnail is an image that is used to represent an object in client applications.
Thumbnails provide a visual cue for browsing media and enable users to identify
objects quickly.
Media Transformation Server automatically generates a thumbnail for each object by
passing the object to the appropriate plug-in. The plug-in extracts the object’s properties
and creates a new object by transforming the original object into a predefined thumbnail
format (for example, a JPEG that is 100 x 100 pixels). Media Transformation Server
sends the thumbnail back to Content Server as a rendition of the original object. The
thumbnail’s media properties are saved as attributes of that rendition.
Content Server stores thumbnails in a special file store that is shared with the Thumbnail
Server, a dedicated server that delivers thumbnails directly to the browser. For more
information about the Thumbnail Server, refer to the Thumbnail Server Installation,
Configuration, and Release Notes.
Generating storyboards
Storyboards are low-resolution — and low-bandwidth — representations of video
or multi-page objects, displayed as a sequence of thumbnails. For example, in an
application such as Digital Asset Manager, video storyboards will display a frame
for perhaps every ten seconds of the video. Depending upon your Documentum
configuration and whether you have integrated a Streaming Server, selecting a frame
of some video storyboards will play the video in its related application, starting from
the selected frame. Selecting a frame of all other video format storyboards will play
the video in its related application, starting from the beginning of the video. For more
information on which video formats are supported with a Streaming Server, see the
Audio/Video Transformation Services Installation and Release Notes.
For objects such as PowerPoint presentations, the storyboard contains a thumbnail of
each slide in the presentation. Selecting one frame of an object’s storyboard will display
that frame in its related application as a JPEG image.
Each frame of the storyboard is a JPEG image. For some video storyboards, each frame
may include timecode information. The timecode is stored as a property of each JPEG
image content object in the storyboard.
Storyboards are generated automatically during registration (import or check in) of
objects. Media Transformation Services detects files that require storyboard generation
and routes them to their appropriate plug-in for storyboard generation.
Storyboards are stored as renditions and are added to the dm_document of the
original object. Each JPEG image that makes up a storyboard is stored in an
EMC Documentum Media Transformation Services Version 6 Administration Guide
25
Media Transformation Services Overview
administrator-specified location. For more information on storage of objects, see the
Content Server Administration Guide.
Generating low-resolution renditions
Low-resolution renditions are used to represent high-resolution objects. Low-resolution
renditions are used by the client applications when a user wants to preview a
high-resolution media file. Due to its smaller file size, a low-resolution rendition can be
displayed more quickly than a file in its original format.
Media Transformation Server automatically generates low-resolution renditions for
supported files upon registration. This includes all image files, some Microsoft file
formats, HTML files, and some video files. When the object is checked in, Media
Transformation Server automatically invokes the appropriate plug-in to generate
the rendition according to a predefined profile. For example, Media Transformation
Server might generate a full-sized JPEG representation of the image, reduce it to a
predetermined width and height, and save it back to the repository as a low-resolution
rendition of the original object. Its media properties are stored as attributes of the
rendition. Low resolution renditions are stored in a location that is determined by the
Content Server.
Documentum supports storage of multiple renditions of the same file format for each
object. For example, you can create two JPEG renditions of an image, using two different
transformation profiles. Perhaps one JPEG rendition is a horizontal flip, while the other
is a vertical flip. The only requirement when creating multiple renditions of the same
format is that there be some unique identifier for each rendition, such as a unique file
name or a unique description.
Extracting IPTC headers
An IPTC header is a form of embedded metadata stored within an image (added to an
image through an application such as Adobe Photoshop). It is the standard, defined
by the International Press and Telecommunications Council (IPTC), for use in images
that are passed over news wires. IPTC headers can contain a variety of details and
descriptive information, including copyright information, photo credits, caption text,
and shot locations.
Media Transformation Services supports a special transformation for extracting IPTC
headers. Media Transformation Server can extract IPTC header information from image
files (PSD, PNG, GIF, and JPEG formats) and store the information as an XML rendition
of the media object. The extraction is modeled as a transformation of the object based
on an IPTC profile.
26
EMC Documentum Media Transformation Services Version 6 Administration Guide
Media Transformation Services Overview
Once the header information is available in an XML format (and is part of the image
record in the repository), the information in the XML file can be used by applications.
For example, the copyright and photo credit can be published to the web site when
the image is used.
To view the IPTC headers for an image, you must view an image’s renditions page, and
open the XML rendition that contains the header information.
User transformations
User requests are processed similarly to register requests. The main exception is that
processing is not automatic. A user must invoke a request for transformation. For an
explanation of how register requests are processed, refer to Automated transformations,
page 21.
The success of a transformation depends on the lock status of the object. If the object
is locked during the transformation, the operation fails.
The transformation process (depicted in Figure 5, page 28) is as follows:
1.
The application gets a list of available profiles and their required parameters by
reading special system objects in the repository.
2.
The user requests a transcode for any rendition of a object by selecting a profile and
entering parameters (if the profile requires parameters).
3.
The application creates a transformation (TRANSCODE_CONTENT) apply call.
4.
Content Server creates a queue object that requests the transformation. The request
contains the profile ID, any parameter values required for a given operation (for
example, height and width or angle of rotation), and the source and target formats.
5.
Media Transformation Server polls the queue, finds objects for transformation, and
matches the requested profile and source format to a particular plug-in.
6.
Media Transformation Server locates the XML command-line file for the profile,
substitutes parameters as required, and invokes the plug-in to perform the
transformation according to the selected profile and parameters.
The transformation occurs in the background.
7.
When the transformation is complete, Media Transformation Server sends the
transformed media back to Content Server and updates the original object with the
new rendition and its associated media properties, which are stored as attributes
of the rendition. If the object already has a rendition of the same format, the new
rendition replaces the previous one, unless it is given a unique identifier.
EMC Documentum Media Transformation Services Version 6 Administration Guide
27
Media Transformation Services Overview
8.
Media Transformation Server removes the transformation request item from the
queue.
Figure 5. The transformation process
User transformation proles
Media Transformation Services provides a set of predefined profiles for most common
operations and allows users to extend profiles and create new profiles to meet
their specific requirements. The following are examples of some profiles a Media
Transformation Services administrator might create:
•
Create small JPEG could resize an image to fit within 200 x 500 pixels and save it as
a JPEG rendition.
•
Resize H x W JPEG could resize an image to a specified height and width and save it
as a JPEG rendition
•
Add text layer could add a predefined text layer to an image and save it as a GIF
rendition.
User profiles, page 66 provides detailed information about these profiles.
Multiple renditions
For most file formats, users have the option of saving the transformation result as either
a rendition of the original object, or as a new object. A rendition is a representation or
28
EMC Documentum Media Transformation Services Version 6 Administration Guide
Media Transformation Services Overview
copy of a file, containing the same content as the original, but in a different file format. A
new object is an entirely separate, individual object, that is designated as a relation to
the original object.
Renditions of the same format will be replaced if they do not have a unique identifier. If
a unique name or description for a rendition is not specified during transformation, and
you choose not to replace the current rendition, the rendition’s name will be appended to
make it unique. For example, the digit 1 may be added to the end of the rendition’s name.
Features of Media Transformation Services
The following are the features that Media Transformation Services offers. Additional
features and capabilities are available with optional add-on transformation services.
Table 2. Features of Media Transformation Services
Feature
Comments
Integrates with entire Documentum product
suite and is backwards compatible.
Runs as a Windows Service and intelligently
handles exceptions raised by native applications.
Generates thumbnail, storyboard, and
low-resolution renditions of some imported
files, and can regenerate those renditions on
command.
See Media Transformation Services
capabilities, page 30 for details.
Offers image manipulation features.
Transforms common image formats into a
variety of other formats (including PDF).
Includes single and multi-page
TIFF to PDF. See Supported
transformations by source and
target formats, page 32 for details.
Controls transformation parameters such
as page size, layout, and security for PDF
transformations.
Creates new renditions.
Transforms a document as part of a business
workflow process using the CTS Activity
Template.
CTS Activity Template is included.
See Working with the CTS Activity
Template in Documentum Process
Builder, page 49 for details.
Creates new related objects by transformation.
EMC Documentum Media Transformation Services Version 6 Administration Guide
29
Media Transformation Services Overview
Feature
Comments
Allows for automated transformations.
For example, perform a saved
transformation upon versioning an
object.
Enables the transformation UI through a Web
client.
Extracts file properties and maps them to
Documentum attributes.
Embeds Documentum attributes into file
properties.
Creates PDF storyboards.
Creates PowerPoint storyboards.
Performs PowerPoint assembly.
Integrates with Thumbnail Server.
See Thumbnail Server Installation,
Configuration, and Release Notes for
version 6.0.
Integrates with Streaming Servers.
See Audio/Video Transformation
Services Installation and Release Notes.
Provides XMP roundtrip support.
Offers add-on transformation services
(optional).
Audio/Video Transformation
Services and Medical Imaging
Transformation Services are
available. See their respective
Installation and Release Notes
for more information about these
components and their requirements.
Media Transformation Services capabilities
Media Transformation Services is able to generate a number of renditions for a file upon
import. It is also able to extract a variety of properties and perform other actions on
files, either upon import or through user interaction. The following table details those
out of the box capabilities.
30
EMC Documentum Media Transformation Services Version 6 Administration Guide
Media Transformation Services Overview
Table 3. Media Transformation Services supported capabilities
Input
format
Create
thumbnail
Create
storyboard
Create
low-resolution
rendition
Extract
properties
Write
XMP to
content
Extract
XMP
from
content
√
√
Resize
Edit
properties
Image formats
AI (ver
10)
√
√
BMP
√
√
√
DNG
√
√
√
EPS
√
√
√
FPX
√
√
√
GIF
√
√
√
√
√
√
√
JPEG
√
√
√
√
√
√
√
JPEG2000
√
√
√
PGM
√
√
√
PNG
√
√
√
PNM
√
√
√
√
PPM
√
√
√
√
PSD
√
√
√
√
√
√
√
SVG
√
√
√
√
√
√
√
TIFF
√
√
√
√
√
√
√
WBMP
√
√
√
√
√
√
√
√
√
√
√
√
√
√
√
Document formats
HTML
√
PDF
√
√
√
√
POT
√
√
√
√
PPT
√
√
√
√
EMC Documentum Media Transformation Services Version 6 Administration Guide
√
31
Media Transformation Services Overview
Supported transformations by source and
target formats
Depending on your installation, Media Transformation Services can perform the
following transformations.
Table 4. Supported transformations with Media Transformation Services
32
Source format
Target formats
AI (version 10)
BMP, GIF, JPEG, PNG, PNM, PPM, PSD, TIFF, WBMP
BMP
BMP, GIF, JPEG, PGM, PNG, PNM, PPM, TIFF, WBMP
DNG
BMP, GIF, JPEG, JPEG2000, PCX, PICT, PNG, SCITEX, SGI,
SVG, TGA, TIFF
EPS
GIF, JPEG, PDF, PNG, PSD, TIFF
FPX
BMP, GIF, JPEG, PGM, PNG, PNM, PPM, TIFF, WBMP
GIF
BMP, GIF, JPEG, PDF, PGM, PNM, PNM, PPM, PSD, TIFF,
WBMP
JPEG
BMP, GIF, JPEG, PDF, PGM, PNG, PNM, PPM, PSD, TIFF,
WBMP
JPEG2000
BMP, GIF, JPEG, JPEG2000, PCX, PICT, PNG, SCITEX, SGI,
SVG, TGA, TIFF
PDF
EPS, GIF, JPEG, PNG, PSD, TIFF
PGM
BMP, GIF, JPEG, PGM, PNG, PNM, PPM, TIFF, WBMP
PNG
BMP, GIF, JPEG, PGM, PNG, PNM, PPM, PSD, TIFF, WBMP
PNM
BMP, GIF, JPEG, PGM, PNG, PNM, PPM, TIFF, WBMP
PPM
BMP, GIF, JPEG, PGM, PNG, PNM, PPM, TIFF, WBMP
PSD
GIF, JPEG, PDF, PNG, PSD, TIFF
SVG
GIF, JPEG, PNG, PSD, SVG, TIFF
EMC Documentum Media Transformation Services Version 6 Administration Guide
Media Transformation Services Overview
Source format
Target formats
TIFF
BMP, GIF, JPEG, PDF, PGM, PNG, PNM, PPM, PSD, TIFF,
WBMP
WBMP
BMP, GIF, JPEG, PGM, PNG, PNM, PPM, TIFF, WBMP
EMC Documentum Media Transformation Services Version 6 Administration Guide
33
Media Transformation Services Overview
34
EMC Documentum Media Transformation Services Version 6 Administration Guide
Chapter 2
Conguring Media Transformation
Services
This chapter contains instructions for configuring Media Transformation Services. Most configuration
tasks are performed through Documentum Administrator.
The following sections are included in this chapter:
•
Configuring Media Transformation Services through Documentum Administrator, page 35
•
Adding or removing repositories serviced by Media Transformation Services, page 37
•
Configuring the pixel threshold for Adobe Graphics Server, page 40
•
Configuring the Image 3 plug-in, page 40
•
Configuring Inbox notifications, page 42
Conguring Media Transformation Services
through Documentum Administrator
Many configuration tasks for Media Transformation Services can now be done
through the CTS Administration component of Documentum Administrator. You
must have access to Documentum Administrator and the repositories to which Media
Transformation Services is configured.
The CTS Administration component appears in Documentum Administrator if at least
one instance is installed and configured on a repository to which it is connected. This
check is done through executing the DQL/DFC call to find the presence of at least one
cts_instance_info object in the repository.
The following Media Transformation Services configuration tasks can be performed
through Documentum Administrator client, in the CTS Administration Node:
EMC Documentum Media Transformation Services Version 6 Administration Guide
35
Conguring Media Transformation Services
•
Change the system operator user. The system operator is the name of the user who
receives messages from an instance of Media Transformation Services.
If Media Transformation Server fails to process a particular item, it queues an event
(dm_mediaserver_error) to the Inbox of the repository user who is defined as the
Media Transformation Server system operator (sysOpUser). The event appears as an
error message in the sysOpUser’s Inbox.
•
Change the user for repository login.
•
Change the polling interval. The polling interval is the amount of time in seconds
that the instance will wait between polls.
When document processing (transformation) is requested, Content Server
creates queue items and appends them to the dm_mediaserver queue or
dm_autorender_win31 queue, depending on the type of request. Media
Transformation Server uses a queue polling mechanism to look for items in the
queue that it has to process. When Media Transformation Server finds items in any
of these queues, it proceeds with processing
•
Change the logging level. The logging level value controls how much information
will be recorded in the CTS log files, which Media Transformation Services uses. Log
files can be used to troubleshoot the system.
•
Change the system notification setting. The notification setting controls whether
success notifications should be sent to each individual user requesting a
transformation through a CTS product.
•
Change the maximum number of queue items. This value controls how many items
the Media Transformation Services instance adds for processing each time it polls
the queue.
•
Change the queue item expiry. This value controls the amount of time an item will
be sitting on a queue before being deleted from the queue.
The Documentum Administrator User Guide provides more information about these
configuration tasks.
Starting and stopping the CTS Administration Agent
In order to use the Content Transformation Services Administration component in
Documentum Administrator, it is necessary to have the CTS Admin Agent running on
the CTS host machine. The Admin Agent can be controlled either from the Windows
Start menu or by running a batch file.
To start/stop the CTS Admin Agent through the Start menu:
1.
36
Log in to the Media Transformation Services host.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Conguring Media Transformation Services
2.
Go to the Windows Services utility located at Start > Settings > Control Panel >
Administrative Tools > Services.
3.
Select Documentum CTS Admin Agent.
4.
To start the Admin Agent, click Start.
To stop the Admin Agent, click Stop.
To start/stop the CTS Admin Agent by running the batch le:
1.
Log in to the Media Transformation Services host.
2.
Navigate to C:\Program Files\Documentum\CTS\Admin Agent\bin.
3.
To start the Admin Agent, run the startup.bat file.
To stop the Admin Agent, run the shutdown.bat file.
Accessing the conguration screen in Documentum
Administrator
You can perform the tasks outlined in Configuring Media Transformation Services
through Documentum Administrator, page 35 through the configuration screen in
Documentum Administrator. Ensure that the CTS Admin Agent is running.
To access the conguration screen:
1.
Log in to Documentum Administrator.
2.
Select the Content Transformation Services node under Administration.
3.
Select the CTS instance you would like to configure.
4.
Select Tools > Content Transformation Services > Configure.
Consult the Documentum Administrator User Guide for information about configuration
tasks.
Adding or removing repositories serviced by
Media Transformation Services
During installation, Media Transformation Services is configured to communicate with
single or multiple repositories. You can add or remove a repository by running the
Media Transformation Services Configurator (accessible through the Windows menu
at Start > Programs > Documentum > Media Transformation Services Instance Add
EMC Documentum Media Transformation Services Version 6 Administration Guide
37
Conguring Media Transformation Services
or Remove). For information on the Configurator and how to run it, see the Media
Transformation Services Installation Guide.
Note: You must have SuperUser privileges for a repository in order to add or remove
support for Media Transformation Services.
Dening le formats and DOS extensions
You must define file formats and DOS file extension pairs in the repository for all source
document types that you want Media Transformation Services to recognize. In addition,
if the DOS file extension differs from the Documentum format name, you must update
the FormatMapperService.xml config file.
To add a le format using Documentum Administrator:
1.
Start Documentum Administrator and connect to the repository to which you want
to add the new file format.
2.
Under Repository Management, click Formats.
The Formats page appears.
3.
Click New.
The Create New Format Object page appears.
4.
Enter the general attributes for the format, as listed in Table 5, page 38.
Table 5. File format attributes
Field
Value
Name
Name of the format object
Description
Description of the format
Default File Extension
Examples of valid file extensions are:
• bmp for bitmap images
• eps for Encapsulated PostScript
• gif for GIF images
38
COM Class ID
Component Object Model (COM) registry ID for the
format
MIME Type
The Multimedia Internet Mail Extension (MIME)
designation for the content type
EMC Documentum Media Transformation Services Version 6 Administration Guide
Conguring Media Transformation Services
Field
Value
Windows Application
Name of an application to launch when users select
a document in the format represented by the format
object
Is Hidden
Used by client applications
Macintosh Creator*
Information used internally for managing Macintosh
resource files
Macintosh Type*
Information used internally for managing Macintosh
resource files
*The Macintosh Creator and Type values are necessary for users to access files in this
format from Macintosh clients.
5.
If the format is indexable, define the indexing options.
a.
Select Can Be Indexed.
b. To index with a filter, click Index with Filter and select the filter from the list box.
By default, all formats installed with the Content Server use the universal filter.
c.
To index with a rendition, select Index with Rendition and select the rendition
format from the list box.
This is the format in which the document will be indexed if its original format is
not used for indexing. If you are indexing the PDF text rendition of documents
in this format, set this to pdftext.
6.
Click Create.
A confirmation page appears. You can create a new template for this format by
clicking Create New Template for this Format.
The following procedure is required only if the DOS file format differs from the
Documentum format name in Content Server. Table 6, page 39 lists some examples of the
format mapping used in Documentum systems. Use these format names in DQL.
Table 6. Documentum format mapping
Format
Documentum name
Bitmap image (BMP)
bmp
Encapsulated PostScript (EPS)
eps
GIF image
gif
JPEG image
jpg
TIFF image
tif
EMC Documentum Media Transformation Services Version 6 Administration Guide
39
Conguring Media Transformation Services
To update the FormatMapperService cong le:
1.
Navigate to %CTS_HOME%\config.
2.
Open the FormatMapperService.xml file in a text editor.
3.
Add the format to the <CTSHandlerList> section, using the following syntax:
<FormatMapper CTSFormat="<dos extension>" DocumentumFormat=
"<format name in Content Server>"/>
For example, the entry for JPEG files is:
<FormatMapper CTSFormat="jpeg" DocumentumFormat="jpg"/>
4.
Save and close the FormatMapperService.xml file.
Conguring the pixel threshold for Adobe
Graphics Server
The Adobe Graphics Server plug-in is best used for smaller files. Larger JPEG images
and compressed JPEG images may produce problems during transformation. To
optimize transformation performance of these files, a configuration option is available
for the Adobe Graphics Server plug-in called JPEG Pixel Threshold. This field contains
the maximum area in pixels (that is, pixel width x pixel height) that a JPEG can be for it
to be processed by the Adobe Graphics Server plug-in. Any JPEG that has a pixel area
larger than this threshold will not be processed by the Adobe Graphics Server plug-in,
but will be passed on to the next plug-in in the chain that can handle JPEG images.
Conguring the Image 3 plug-in
The ImageMagick plug-in has some extra options — over and above the standard
configuration options for plug-ins — that can be configured through the plug-in’s
configuration file.
ICC proles
The ICC profiles section of the configuration file holds a list of individual ICC profiles.
You can specify one ICC profile per colorspace. An ICC profile is specified in an
ICC_PROFILE_INFO XML tag:
<ICC_PROFILE_INFO profile_token="doc_token_cmyk_profile" colorspace="CMYK">
C:\Program Files\Documentum\CTS\AlterCast\required\color\USWebCoatedSWOP.icc
</ICC_PROFILE_INFO>
40
EMC Documentum Media Transformation Services Version 6 Administration Guide
Conguring Media Transformation Services
The value of the XML element is the fully qualified path to the ICC profile. The attributes
are as follows:
•
profile_token – the token in the profile that will be substituted with the path of the
ICC profile.
•
colorspace – the colorspace of this profile.
Two ICC profiles will be used in conjunction to perform color conversions when doing
transformations.
The ImageMagick plug-in is configured out-of-the-box with a CMYK and RGB profile
which will be used to convert CMYK images to RGB when creating thumbnails and
low-resolution JPEGs.
COM Server parameters
There are two configurable parameters relating to the COM Server:
•
Process name
This is the name of the COM Server that performs the work based on the
ImageMagick library. It should always be IMW_COMServer.exe.
•
Pool size
The value of this configuration parameter is the maximum number of ImageMagick
COM servers that can be running at one time.
Pixel cache parameters
A number of parameters can be configured for the pixel cache in the Image 3 plug-in.
Table 7. Pixel cache parameters for Image 3 plug-in
Parameter name
Function
Memory size
Sets the maximum amount
of memory in megabytes
to allocate for the pixel
cache from the heap. When
this limit is exceeded, the
image pixels are cached to
memory-mapped disk.
EMC Documentum Media Transformation Services Version 6 Administration Guide
XML attribute
doc_token_limit_
memory
41
Conguring Media Transformation Services
Parameter name
Function
XML attribute
Memory map size
Sets the maximum amount
of memory map in
megabytes to allocate
for the pixel cache. When
this limit is exceeded, the
image pixels are cached to
disk.
Area size
Sets the maximum width
x height of an image that
can reside in the pixel
cache memory. Images
that exceed the area limit
are cached to disk.
doc_token_limit_map
doc_token_limit_area
Conguring Inbox notications
When transformation requests fail, the Media Transformation Server sends notifications
to the Inbox of the repository user. By default, success notifications are not sent.
However, these default behaviors can be configured using the procedures in this section.
The behavior of success and failure notifications differs slightly. While success
notifications can be suppressed for all users, failure notifications are sent to admin users
regardless of the setting. Table 8, page 42 outlines these behaviors.
Table 8. Inbox notication settings
Notification
Setting
User(s) notified
Success
Yes
Regular user
No
none
Yes
Regular user and admin user
No
Admin user
Failure
To modify the conguration of success notications:
42
1.
Navigate to %CTS_HOME%\config.
2.
Open the CTSServerService.xml file in a text editor.
3.
To turn on notifications for successful transformations, you need to set the
notifySuccessMessage parameter to the following:
EMC Documentum Media Transformation Services Version 6 Administration Guide
Conguring Media Transformation Services
<CTSServer AttributeName="notifySuccessMessage" AttributeValue="YES"/>
To turn off notifications for successful transformations, you need to set the
notifySuccessMessage parameter to the following:
<CTSServer AttributeName="notifySuccessMessage" AttributeValue="NO"/>
Note: There are two <QueueProcessorContext> tags for each repository that is
configured. You must modify the notifySuccessMessage parameter within each
<QueueProcessorContext> tag.
4.
Save and close the CTSServerService.xml file.
To modify the conguration of failure notications:
1.
Navigate to %CTS_HOME%\config.
2.
Open the CTSServerService.xml file in a text editor.
3.
To turn on notifications for failure transformations, you need to set the
notifySuccessMessage parameter to the following:
<CTSServer AttributeName="notifyFailureMessage" AttributeValue="YES"/>
To turn off notifications for failure transformations, you need to set the
notifySuccessMessage parameter to the following:
<CTSServer AttributeName="notifyFailureMessage" AttributeValue="NO"/>
Note: There are two <QueueProcessorContext> tags for each repository that is
configured. You must modify the notifySuccessMessage parameter within each
<QueueProcessorContext> tag.
4.
Save and close the CTSServerService.xml file.
EMC Documentum Media Transformation Services Version 6 Administration Guide
43
Conguring Media Transformation Services
44
EMC Documentum Media Transformation Services Version 6 Administration Guide
Chapter 3
Administering Media Transformation
Services
This chapter contains information about Media Transformation Services administration options. Most
administration tasks are performed through Documentum Administrator.
The following sections are included in this chapter:
•
Administering Media Transformation Services through Documentum Administrator, page 45
•
Starting and stopping Media Transformation Services, page 47
•
Managing multiple servers, page 47
•
Changing the CTS Service user after installation, page 48
•
Changing the CTS administrator password, page 48
•
Configuring the queue marker mechanism to manage queue item sign-off, page 48
•
Working with the CTS Activity Template in Documentum Process Builder, page 49
•
Using the CTS Reporting Tool, page 52
•
Managing the transformation queue, page 54
Administering Media Transformation Services
through Documentum Administrator
Some administration tasks for Media Transformation Services can now be done through
the Content Transformation Services Administration component of Documentum
Administrator. The CTS Administration component appears in Documentum
Administrator if at least one instance is installed and configured on a repository to which
it is connected. This check is done through executing the DQL/DFC call to find the
presence of at least one cts_instance_info object in the repository.
The following Media Transformation Services administration tasks can be performed
through Documentum Administrator:
EMC Documentum Media Transformation Services Version 6 Administration Guide
45
Administering Media Transformation Services
•
Change your password. This task can be done through Documentum Administrator.
Alternatively this task can be done using the setPassword utility. Note that the
system administrator must also change the password on the server. See 3.5 Changing
the CTS administrator password.
•
View log files. Log files are created for each plug-in. The contents and detail
level of each log file depend on the log file setting you have chosen for the Media
Transformation Services instance.
•
View details of an instance. Details include each CTS product that is configured for a
repository, the version number of each product, the name of the host machine for
each product, its current status (running or stopped), the time it was last started, the
number of queued items for the instance, and the number of items processed by
the instance.
•
Control a CTS instance. This includes starting, stopping, and refreshing an instance.
Note that performing any of these actions will apply to all CTS products running
on the host. This is because all CTS products on a host use the same CTS Windows
service. Starting and stopping CTS Windows service can also be done manually, on
the host machine. See Starting and stopping Media Transformation Services, page 47.
The Documentum Administrator User Guide provides more information about these
administration tasks.
Starting and stopping the CTS Administration Agent
In order to use the Content Transformation Services Administration component in
Documentum Administrator, it is necessary to have the CTS Admin Agent running on
the CTS host machine. The Admin Agent can be controlled either from the Windows
Start menu or by running a batch file.
To start/stop the CTS Admin Agent through the Start menu:
1.
Log in to the Media Transformation Services host.
2.
Go to the Windows Services utility located at Start > Settings > Control Panel >
Administrative Tools > Services.
3.
Select Documentum CTS Admin Agent.
4.
To start the Admin Agent, click Start.
To stop the Admin Agent, click Stop.
To start/stop the CTS Admin Agent by running the batch le:
46
1.
Log in to the Media Transformation Services host.
2.
Navigate to C:\Program Files\Documentum\CTS\Admin Agent\bin.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Administering Media Transformation Services
3.
To start the Admin Agent, run the startup.bat file.
To stop the Admin Agent, run the shutdown.bat file.
Starting and stopping Media Transformation
Services
When you restart the Media Transformation Services host, Media Transformation
Services will start automatically. You may also start and stop Media Transformation
Services manually, using the following procedure. This may be necessary after modifying
a transformation profile, for example.
To start/stop Media Transformation Services:
1.
Log in to the Media Transformation Services host.
2.
Go to the Windows services utility located at Start > Settings > Control Panel >
Administrative Tools > Services.
3.
Select Documentum Content Transformation Services.
4.
To start Media Transformation Services, click Start.
To stop Media Transformation Services, click Stop.
Note: A background service, called Documentum Content Transformation Monitor
Services, restarts Media Transformation Services if it stops unexpectedly. Since the
monitor is set to run automatically by default, you will not typically need to access
it. It is located under Windows Services.
Managing multiple servers
The standard installation for Media Transformation Services consists of one repository
with one server. Additional servers can be added to an active repository to enhance its
performance. Load balancing can optimize performance by spreading transformation
requests between multiple servers.
Load balancing can be achieved by adjusting settings in the CTSserverservice.xml file,
in the cts\config folder. By default, CTS products are equipped with a standard load
balancing strategy.
The ideal load balancing strategy depends upon your environment and the specific
servers in use. Contact your Documentum consulting representative for load balancing
guidance.
EMC Documentum Media Transformation Services Version 6 Administration Guide
47
Administering Media Transformation Services
Changing the CTS Service user after installation
In certain situations, it may be desirable to change the CTS Service user account after
Media Transformation Services has been installed and configured. This may be necessary
for security reasons, for example.
It is not necessary to uninstall and reinstall Media Transformation Services to make
this change. Simply ensure that the new user has full COM access permissions for the
rendering software (Microsoft PowerPoint and AFPL Ghostscript) being used by Media
Transformation Services.
Changing the CTS administrator password
You can change the CTS administrator’s password by running the setPassword utility.
The password also must be changed on Content Server.
To change the administrator’s password:
1.
Stop Content Transformation Services.
2.
Change the password on the Content Server.
3.
Open a command prompt window.
4.
Enter the following command:
> cd %CTS%\docbase\<repository name>\CTSServerScript\bin
> setPassword <new_password>
5.
Restart Content Transformation Services.
Note: It is also possible to change the password in Documentum Administrator instead
of running the setPassword utility ( and Step 4 above). You must still perform the other
steps in this procedure.
Conguring the queue marker mechanism to
manage queue item sign-off
This procedure applies only if you have different CTS products polling the same
repository but installed on separate hosts.
48
EMC Documentum Media Transformation Services Version 6 Administration Guide
Administering Media Transformation Services
The queue marker mechanism analyzes queue items and marks those that can be
executed by the CTS instance, preventing items from being prematurely expired by a
CTS instance that cannot handle them. The marker tasks run with their own sessions.
This functionality is controlled by two elements in the CTSServerService config file:
•
ignoreItemsToSignOffLimit
This element is used to create the marking job when CTS starts up. If the value is set
to "YES", the marker thread will be created. By default, the value is set to "NO", and
there is no marking mechanism.
•
markerInterval
This element sets the wait period between consecutive queue marking jobs.
The expiration period and marking interval should be tuned based on each system
configuration. On a system with similar CTS products polling the same queue, the
marker mechanism is not required and thus the default setting is appropriate. However,
if there are different CTS products running against a repository, one CTS instance might
expire items (because it cannot handle them) when the instance that could handle them
is busy. In this case, the marking mechanism should be turned on for those instances that
could process the items.
Working with the CTS Activity Template in
Documentum Process Builder
The CTS Activity Template allows users to add a content transformation as part of a
workflow process. With this version of Media Transformation Services the CTS Activity
Template is available for use with Documentum Process Builder.
Any user profile for Media Transformation Services can be used with the CTS Activity
Template. However, keep in mind that if a profile contains user-defined parameters,
these parameters cannot be exposed within the workflow. See Making transformation
profiles available for use with the template , page 50 for details about choosing profiles
and making them available for use with the activity template.
The following section outlines the procedures required to use the activity template. It
is meant to supplement — not replace — the information in the Documentum Process
Builder documentation set. You should be familiar with the Documentum Process
Builder application and have access to the Documentum Process Builder Installation Guide,
Documentum Process Builder User Guide, and Documentum Process Builder Release Notes.
EMC Documentum Media Transformation Services Version 6 Administration Guide
49
Administering Media Transformation Services
Making the CTS Activity Template available to users
Users can begin using the CTS Activity Template after:
•
All installation procedures (as described in the Media Transformation Services
Installation Guide) are complete.
•
The system administrator has given CTS users access to Documentum Process
Builder (consult the Documentum Process Builder User Guide for details).
•
The users have set their Preferences to display the CTS palette in Documentum
Process Builder (see below).
To display the CTS palette in Documentum Process Builder:
1.
Launch Documentum Process Builder.
2.
Select File > Preferences.
The Preferences dialog box appears. The list box on the left displays the available
activity palettes, and the list box on the right displays the palettes currently being
displayed in Documentum Process Builder.
Note: Preferences are saved separately for each user. The list of palettes may differ if
you log in as a different user.
3.
To display the CTS palette in Documentum Process Builder, highlight its name in
the left list box and click Add.
The name moves to the right list box.
The CTS palette and template are now available to use with a business process.
Note: The preferences you set apply to your user ID only; each user can set different
preferences.
Making transformation proles available for use with
the template
In Media Transformation Services, only System Profiles are available for CTS Activity
Template:
•
50
Link the profiles from /System/Media Server/System Profiles to the
/System/CTSActivity folder in the repository. Any changes made to the profiles in the
Media Server folder are automatically reflected in the /System/CTSActivity folder.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Administering Media Transformation Services
Transformation proles with no parameters
There are profiles that do not include user-defined parameters that are suitable for
linking, for example, transformTo_direct. You will find them in the /System/Media
Server/System Profiles folder.
Using the CTS Activity Template
This section describes the CTS Activity Template and the special workflow parameters
associated with it.
In Documentum Process Builder, activities are the tasks that comprise the workflow.
Most of the configuration of the workflow relates to configuring its activities. You
configure activities using the Activity Inspector.
The Activity Inspector has several tabs, each corresponding to one aspect of activity
configuration. When you select the CTS Activity Template, the following tabs are
available:
•
The Properties tab sets the priority for automatic activities and lets you provide
instructions for manual performers.
•
The Performer tab enables you to select who performs the activity and what actions
the performers have available to them.
•
The Trigger tab settings determine when the activity starts.
•
The Timers tab sets warning timers to take action if an activity does not start or is not
completed within a designated amount of time.
•
The Notification tab specifies whether to notify the workflow supervisor when
certain system events occur.
•
The Display tab controls how the activity appears in the visual display of the process
template.
•
The CTS Parameters tab enables you to select a transformation and set the options
relating to the transformation.
The Documentum Process Builder User Guide describes all of these tabs – with the exception
of the CTS Parameters tab – in the "Working with Activities” chapter. The following
procedure describes how to add a transformation to a business process using the CTS
Parameters tab in the Activity Inspector.
To add a document transformation to a business process:
1.
In the Activity Inspector, select the CTS Parameters tab.
2.
Choose a transformation profile from the Profile Name list box.
3.
Select the output format for the transformation from the Target Format list box.
EMC Documentum Media Transformation Services Version 6 Administration Guide
51
Administering Media Transformation Services
4.
Enter a rendition description, if desired.
5.
Set this transformation as the default proxy, if desired, by choosing the Yes option.
6.
Save this transformation, if desired, by choosing the Yes option.
Consult the Documentum Process Builder User Guide for further instructions on how to
use the workflow feature.
Using the CTS Reporting Tool
The CTS Reporting Tool provides detailed information about transformation type,
volume and error events. Data such as CTS product performance, plug-in usage,
and requests by users assists in monitoring and analyzing transformation usage and
can assist with load balancing strategies. Reporting can be logged for a configurable
time frame and then rolled over to be archived. The resulting information is retained
in the repository and is viewable as a CSV formatted file (a report format using
comma-separated values) through Digital Asset Manager (DAM). Users can view their
own CTS reporting data. Administrators have access to all data.
Usage tracking is configured in Documentum Administrator. The CTS Reporting Tool
reports on the number of requests in a given time frame according to the following
options:
•
Number of successful transformations
•
Number of requests that could not be handled
•
Cumulative error report
•
Number of errors per format and per specific transformation request
•
Cumulative total file sizes of input and output per given time frame
•
Total requests per specific user
Enabling and disabling the CTS Reporting Tool
The CTS Reporting Tool is turned off by default. Usage tracking can be switched on or off.
To enable/disable the CTS Reporting Tool:
52
1.
Login to Documentum Administrator.
2.
In the tree pane, select Transformation Services>CTS Reporting Configuration
3.
Select the following:
EMC Documentum Media Transformation Services Version 6 Administration Guide
Administering Media Transformation Services
4.
5.
•
Reporting Configuration (ON/OFF) check box, to select whether the data is
collected or not.
•
Purging Configuration (ON/OFF) option, to delete any data collected.
•
Archiving Configuration (ON/OFF) option, to select whether data should be
archived.
If you have enabled Reporting Configuration and Archiving Configuration, provide
the information for the following fields.
•
(Number of days) Archiving Interval to set how often the report should be
archived — everyday, every two days, and so on.
•
(Size of transformation request table) Archiving DataSize, to set the number of
transformations that should be recorded at a time before the data is archived
and for the compilation to start again.
•
(Archiving monitor interval in seconds) Archiving Monitor Interval, to set the length
of time in seconds the report should be updated.
Click OK.
Viewing the CTS Reporting Tool report
When the CTS Reporting Tool is enabled, the following information is recorded for each
transformation request:
•
The object id of the source document
•
The object id of the queue item
•
The user name who sends the requests
•
The format of the source document SOURCE_FORMAT = "source_format"
•
The format of target TARGET_FORMAT = "target_format"
•
The transformation type, it could be either user created or auto/import
•
The profile name used for the transformation request
•
The target object type, it could be rendition or related object
•
The parameters send in the request
•
The queue item added time
•
The queue item signed off time
•
The transformation completed time
•
The source file size
•
The target file size
•
The status, it could be SUCCESS, FAILED, or UNHANDLED
•
The CTS instance doing the transformation
EMC Documentum Media Transformation Services Version 6 Administration Guide
53
Administering Media Transformation Services
•
Any message resulting from a transformation execution.
To view the CTS Reporting Tool report:
1.
In DAM, go to Tools>Transformation report>View
2.
The CTS Transformation Report page displays. Enter the information for the
following fields:
•
Report name
•
Start date
•
End date
3.
Click OK.
4.
The Select Folder screen appears. Select the destination folder to save the retrieved
report. Click OK. A CSV report opens with the requested information.
Managing the transformation queue
The Queue Management feature provides a mechanism for monitoring and
administrating transformation request queues. This feature allows users to view or
delete their own pending transformation requests. Administrators can manage the
queues for all users and change the priority of transformation requests when required.
The Queue Management feature is accessed through the Transformation node in Media
Transformation Services via Digital Asset Manager (DAM).
Administrators can manage the queue by deleting items or changing the priority
of items. Users can view their own transformation requests and delete their own
transformation requests, but cannot change a queue item priority.
54
•
Viewing transformation requests in the queue, page 55
•
Changing a queue item’s priority, page 55
•
Viewing details of a queue item, page 56
•
Deleting a pending queue item, page 57
•
Configuring additional queue management fields, page 57
•
Removing a queue management field, page 58
EMC Documentum Media Transformation Services Version 6 Administration Guide
Administering Media Transformation Services
Viewing transformation requests in the queue
Users can monitor the status of their transformation requests by viewing the queue. If a
user is dissatisfied with the priority level of their transformation request(s), they can ask
their administrator to change an item’s priority on their behalf.
To view transformation requests in the queue:
1.
Login to DAM.
2.
In the tree view on the left side of the screen, select the Transformations node.
Click on the Transformations link. The right pane will refresh with a list of current
queue items.
Transformation requests are displayed in priority order. The priority level of an item
is indicated as follows:
3.
4.
•
denotes a high priority item
•
denotes a medium priority item.
•
denotes a low priority item.
For administrators only: Choose the items to view by selecting an option from
the Show list box in the top right corner:
•
Show All displays all users transformation requests.
•
Show Mine displays only your transformation requests.
To sort transformation requests in ascending or descending order, click the header
field on each of the columns.
Changing a queue item’s priority
Administrators can change the priority of an item in the queue.
To change a queue item’s priority:
1.
Login to DAM.
2.
In the tree view in the left pane, select the Transformations node. Go to the
transformation queue by selecting the Transformations node. The transformation
queue appears in the main pane.
3.
Find the target item in the queue.
4.
Select the item, and right-click with your mouse.
5.
Choose View from the context menu.
EMC Documentum Media Transformation Services Version 6 Administration Guide
55
Administering Media Transformation Services
The transformation details of this item are displayed.
6.
Change the numeric value in the Priority box. The highest priority is 10. The higher
the numeric value, the higher the priority level. When the priority level is changed,
the queue position of the object will change automatically.
7.
Click OK. The page returns to the list the transformation queue. Confirm that the
queue position has changed. The color code of the priority item should change to
a higher priority. See Viewing transformation requests in the queue, page 55 for
queue item priority level color codes.
Viewing details of a queue item
When a pending item is in the queue, the following transformation details are available
depending on which fields are configured:
•
Description gives the name of the transformation being performed, such as Rotate.
•
Parameters lists any user-defined parameters for this transformation, if applicable.
For a transformation such as Rotate, for example, the angle of rotation would be
a parameter.
•
From gives the name of the user who requested the transformation.
•
Received is the date and time the transformation was requested.
•
Source is the source (or input) file name being transformed.
•
Priority is given to a queue item with the highest numeric value.
•
Target is the target (or output) file name for the transformation. If the request is to
create a rendition, the Target field will show "None".
•
Queue position gives the specific order number of this item in the queue.
To view details of a queue item:
1.
Login to DAM.
2.
In the tree view in the left pane, select the Transformations node. Go to the
transformation queue by selecting the Transformations node. The transformation
queue appears in the main pane.
3.
Find the target item in the queue.
4.
Select the item, and right-click with your mouse.
5.
Choose View from the context menu.
The transformation details of this item are displayed.
56
EMC Documentum Media Transformation Services Version 6 Administration Guide
Administering Media Transformation Services
Deleting a pending queue item
Administrators can delete any items in the queue. Users can only delete their own
queue items. The deletion is not immediate for users. Items are marked, then polled
and then deleted.
To delete a pending queue item:
1.
Go to the transformation queue by selecting the Transformations node.
The transformation queue appears in the main pane.
2.
Find the item(s) to delete from the queue.
To find items quickly, you can configure the display as follows:
3.
•
Sort alphabetically by document name by clicking the header on the Document
column.
•
Sort the requests alphabetically by user name by clicking the header on the
Sent by column.
•
Toggle between all users’ transformation requests or your own transformations
using the Show list box.
Select the item(s), and right-click with your mouse.
Note: You can select a range of items using the Shift key, or select multiple items
using the Ctrl key.
4.
Choose Delete from the context menu.
A delete confirmation page appears for each file you selected.
5.
Select OK to confirm a deletion, or click Cancel to abort a deletion request.
If the queue item is pending, it will be deleted and removed from the transformation
queue. If the queue item is being processed, an error will show saying "Transformation
request is being processed, can’t delete."
Conguring additional queue management elds
Users can customize the queue management fields by adding additional columns.
To congure additional queue management elds:
1.
Login to DAM.
2.
Go to the Transformation node.
The right pane shows the default column fields.
3.
Click on the Column Preferences button.
EMC Documentum Media Transformation Services Version 6 Administration Guide
57
Administering Media Transformation Services
The screen will refresh and show the Preferences: Display Settings on the left and
the default column setting on the right.
4.
Select an additional item from the left list "Select attributes to display". Click the
button to add to the right list "Selected attributes to display as column". The right list
shows the new attribute added. Click OK.
The list view appears.
5.
Verify that the list view has the additional columns.
Removing a queue management eld
Users can customize the column fields by removing select columns.
To remove a queue management eld:
1.
Login to DAM.
2.
Go to the Transformation node.
The right pane shows the default column fields.
3.
Click on the Column Preferences button.
The screen will refresh and show the Preferences: Display Settings on the left and
the default column setting on the right.
4.
Select an item from the right list "Selected attributes to display as column". Click
button to move it to the left list "Select attributes to display". The right list shows
the new attribute removed. Click OK.
The list view appears.
5.
58
Verify that the list view has one less column.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Chapter 4
Working with Proles
Media Transformation Services is shipped with a set of predefined profiles and command-line
files for most common transformation and image editing tasks. Transformation profiles package
transformations for the client application and provide a simple method for an application to access
plug-ins. Profiles are XML files that an application passes to Media Transformation Services when
requesting a specific functionality.
There are two types of transformation profiles:
•
System profiles are invoked silently through registration (import or check in) of files. These
profiles are not exposed to users.
•
User profiles are exposed to the user through WDK applications such as Digital Asset Manager
(DAM) or Web Publisher.
Both types of transformation profiles are related to specific command-line files, and can be modified
as required. Additional profiles can also be created for both system and user profiles.
When you extend or modify command-line files, you must also create new Media Transformation
Services profile definitions. The definitions must be based on the Media Transformation Services
document type definition (DTD).
This chapter contains the following sections:
•
Understanding profiles, page 60 provides an overview of transformation profiles.
•
Locating profiles, page 60 describes the components of transformation profiles, and explains
where the components are stored in the repository.
•
Predefined Media Transformation Services transformation profiles, page 72 provides a list of the
profiles that are shipped with Media Transformation Services. It also lists the predefined profiles
available with Audio/Video Transformation Services.
•
Adding and modifying transformation profiles, page 76 provides procedures for modifying the
predefined profiles or adding new profiles.
•
Reusing profiles, page 90 explains how to reuse profiles using the chaining or sequencing
methods, and gives an example of a profile modification.
•
Using DQL in profiles, page 93 explains how to use DQL to supply default profile parameters.
EMC Documentum Media Transformation Services Version 6 Administration Guide
59
Working with Proles
For more information on transformation functionality and transformation profiles, see User
transformation profiles, page 28 and
Understanding proles
Before attempting to customize or reuse profiles manually, it is important to understand
how transformation profiles and command-line files work together. This section
includes:
•
Locating profiles, page 60 discusses where the various profiles are stored in the
repository.
•
System profiles, page 61 describes the transformation profiles that invoked on import
or check in.
•
User profiles, page 66 provides an overview of transformation profiles that are
exposed to users.
•
Command-line files, page 68 describes the relationship between plug-ins and their
command-line files in the transformation process.
•
Media Transformation Services DTD, page 68 provides the ProfileSchema.dtd file.
•
Sample profile, page 71 provides an example of a profile definition for rotating an
image.
For more information about transformation profiles and command line files, see User
transformation profiles, page 28. For information on how to customize or reuse profiles
using the Profile Editor, see .
Locating proles
Media Transformation Services transformation profiles are divided into three types. For
each repository that is configured for Media Transformation Services, there are three
folders that contain transformation profiles and command-line files.
The following is an indication of where transformation profile components are stored in
the repository:
•
/System/Media Transformation Server/Profiles
Stores profiles as dm_media_profile objects. These are the user profiles that are
exposed by the client application, such as Digital Asset Manager. New profiles that
you create for manual use within the Documentum application are added here.
60
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
•
/System/Media Transformation Server/System Profiles
Stores profiles as dm_media_profile objects. These are the system profiles that are
only used internally by Media Transformation Services and are not exposed through
the client application. These profiles can be reused in new profiles, but must be
referenced by an absolute path from the repository.
•
/System/Media Transformation Server/Command Line Profiles
Stores command-line files as dm_sysobject objects.
System proles
These profiles are only used internally by Content Transformation Services products and
are not exposed through the client application. You can customize these profiles and
also use them to create new profiles, but the new profiles must be referenced by an
absolute path from the repository.
System profiles are dm_media_profile objects stored in the repository at /System/Media
Server/System Profiles.
Media Transformation Services includes a multitude of system profiles. Only those
profiles explicitly referenced in the register profile are invoked on import.
The following system profiles are discussed in this section:
•
Register profile, page 61
•
ImportExtractProperties profile, page 63
•
Thumbnail profile, page 64
•
AutoGenProxy profile, page 65
•
PowerpointRegistration profile, page 66
Register prole
The register profile is the most commonly used profile. It is unlike any other system
profile, because it does not actually contribute to the transformation process. It directs
the Media Transformation Server to the appropriate system transformation profile, such
as extractXMP, pdf_processing, or thumbnail.
Whenever Media Transformation Server receives queue items, it accesses the register
profile. The register profile provides the following information to the server:
EMC Documentum Media Transformation Services Version 6 Administration Guide
61
Working with Proles
•
The <Formats> section contains all the formats supported by Media Transformation
Services to generate default renditions. Source and target formats are the same in
the register profile. This is because processing does not start from this profile; the
source is passed to the next profile.
•
The <InnerProfile> path in register.xml specifies which transformation profile the
server should load. If you want to enable additional default renditions to Media
Transformation Services, you must add an <InnerProfile> tag to the register profile
for these additional capabilities.
The ProfileSequence section of register.xml contains the <InnerProfile> entries:
<ProfileSequence>
<InnerProfile path="/System/Media Server/System Profiles/thumbnail"
waitOnCompletion="false">
<InnerToken Mapping LocalProfileToken="jpeg_th"
InnerProfileToken="doc_token_targetFormat" Literal="true"/>
</InnerProfile>
<InnerProfile path="/System/Media Server/System Profiles/autoGenProxy"
waitOnCompletion="false">
<InnerToken Mapping LocalProfileToken="jpeg_lres"
InnerProfileToken="doc_token_targetFormat" Literal="true"/>
<InnerToken Mapping LocalProfileToken="jpeg_lres"
InnerProfileToken="default_proxy_format" Literal="true"/>
</InnerProfile>
<InnerProfile path="/System/Media Server/System Profiles/
importExtractProperties" waitOnCompletion="false">
</InnerProfile>
<InnerProfile path="/System/Media Server/System Profiles/
powerpointRegistration" waitOnCompletion="false">
...
</InnerProfile>
<!-- This will generate thumbnail, proxy and storyboards for pdf formats -->
<InnerProfile path="/System/Media Server/System Profiles/pdf_processing"
waitOnCompletion="true" useTargetFormat="true">
</InnerProfile>
<InnerProfile path="/System/Media Server/System Profiles/extractXMP"
waitOnCompletion="false">
<InnerTokenMapping LocalProfileToken="xml"
InnerProfileToken="doc_token_targetFormat" Literal="true"/>
</InnerProfile>
</ProfileSequence>
</Profile>
62
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
ImportExtractProperties prole
The importExtractProperties profile extracts rich media properties, such as color mode,
format, height, width, compression, color space, reduction algorithm, number of colors,
optimization, format, and copyright.
This is the only system profile that uses <ProfileChain>, which invokes the extract_props
profiles for various plug-ins. Each plug-in plays a unique role in extracting the properties
from the content.
All of the formats specified in <Formats> will go through each profile in the profile chain,
in the order specified. The extracted properties are sent to the Content Server.
The importExtractProperties.xml file is shown below:
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE Profile SYSTEM "ProfileSchema.dtd">
<Profile name="importExtractProperties" label="Property Extraction for
Import" description="Profile for extracting properties on import">
<Formats>
...
<Format source="bmp" target="bmp"/>
<Format source="gif" target="gif"/>
<Format source="jpeg" target="jpeg"/>
...
</Formats>
<MediaEnabled category="MTS"/>
<MediaEnabled category="System"/>
<Transcodings>
<Transcode name="importExtractProperties" label="Property Extraction for
Import">
</Transcodes>
</Transcodings>
<ProfileChain>
<InnerProfile path='/System/Media
irw_extract_props'/>
<InnerProfile path='/System/Media
altercast_extract_props'/>
<InnerProfile path='/System/Media
img_extract_props'/>
<InnerProfile path='/System/Media
avi_extract_props'/>
<InnerProfile path='/System/Media
imw_extract_props'/>
<InnerProfile path='/System/Media
ppt_extract_props'/>
</ProfileChain>
</Profile>
Server/System Profiles/
Server/System Profiles/
Server/System Profiles/
Server/System Profiles/
Server/System Profiles/
Server/System Profiles/
EMC Documentum Media Transformation Services Version 6 Administration Guide
63
Working with Proles
Thumbnail prole
The system profile for thumbnails defines the thumbnail creation functionality. It polls
several plug-in command-line files when thumbnail requests are received. By default, a
thumbnail request is processed in the following order:
•
thumbnail_irw.xml
•
thumbnail_ac.xml
•
thumbnail_avi.xml
•
thumbnail_pdf.xml
•
thumbnail_ppt.xml
•
thumbnail_img.xml
•
thumbnail_imw.xml
A request will proceed to the next plug-in only if the current one does not support
thumbnail generation for the format. This sequence can be modified in the thumbnail
system profile file.
Thumbnail properties are specified in the command-line files. These properties can be
modified, as shown below.
To modify the thumbnail size specied by a plug-in:
1.
Check out the thumbnail command-line file from the Command Line Files folder
in the repository.
For example, to modify the Altercast plug-in for thumbnails, check out the
thumbnail_ac.xml file.
2.
Open the file in an XML or text editor.
3.
Modify the image size tag as required. For the Altercast plug-in, this tag appears as
follows:
<imageSize width="100" height="100"/>
Note: If you specify only width, proportions are constrained by the width. If you
specify only height, proportions are constrained by the height.
To maintain the aspect size of the original, add the constrainProperties tag. This tag
is optional. It should follow this syntax:
<imageSize constrainProportions="true" width="120" height="120"/>
4.
Save the file back to the Command Line Files folder.
Note: Verify that the file name includes the .xml extension. After check-in, the file
name should appear as thumbnail_ac.xml, not thumbnail_ac.
64
5.
Restart the Media Transformation Server.
6.
Check the CTS error log file to ensure the profile was loaded without any errors.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
7.
Test the modified profile to ensure thumbnails are being created properly.
AutoGenProxy prole
This system profile creates the default low-resolution JPEG renditions. Each imported
file will have one low-resolution rendition created.
The process is similar to that of thumbnail creation. When content is imported, the
autoGenProxy profile file polls several plug-in command-line files. By default, a
low-resolution JPEG request is processed in the following order:
•
autoGenProxy_irw.xml
•
autoGenProxy_ac.xml
•
autoGenProxy_avi.xml
•
autoGenProxy_ppt.xml
•
autoGenProxy_img.xml
•
autoGenProxy_imw.xml
A request will proceed to the next plug-in only if the current one does not support
low-resolution JPEG generation for the format. This sequence can be modified in the
autoGenProxy system profile file.
Low-resolution JPEG properties are specified in the command-line files. These properties
can be modified, as shown below.
To modify the low-resolution JPEG size specied by a plug-in:
1.
Check out the autoGenProxy command-line file from the Command Line Files folder
in the repository.
For example, to modify the Altercast plug-in for low-resolution renditions, check out
the autoGenProxy_ac.xml file.
2.
Open the file in an XML or text editor.
3.
Modify the image size tag as required. For the Altercast plug-in, this tag appears as
follows:
<imageSize width="300" height="300"/>
Note: If you specify only width, proportions are constrained by the width. If you
specify only height, proportions are constrained by the height.
To maintain the aspect size of the original, add the constrainProperties tag. This tag
is optional. It should follow this syntax:
<imageSize constrainProportions="true" width="320" height="320"/>
4.
Save the file back to the Command Line Files folder.
EMC Documentum Media Transformation Services Version 6 Administration Guide
65
Working with Proles
Note: Verify that the file name includes the .xml extension. After check-in, the file
name should appear as autoGenProxy_ac.xml, not autoGenProxy_ac.
5.
Restart the Media Transformation Server.
6.
Check the CTS error log file to ensure the profile was loaded without any errors.
7.
Test the modified profile to ensure low-resolution renditions are being created
properly.
PowerpointRegistration prole
The powerpointRegistration profile is similar to the register profile in terms of its role.
However, the powerpointRegistration profile handles only PowerPoint content. To make
use of this profile, ensure that the currently certified version of PowerPoint (as specified
in the Media Transformation Services Release Notes) is installed on the server host.
The PowerPoint plug-in creates thumbnails, storyboards, low-resolution images, and
low-resolution storyboards in JPEG format. You can modify the height and width of
these renditions in the command-line file.
Note: This profile ties in to the DAM PowerPoint assembly feature. Therefore, use
caution when making any modifications.
User proles
Transformation profiles package media transformations for the client application, and
provide a simple method for an application to access plug-ins.
Media Transformation Services predefined profiles cover most of the common media
transformations, such as resize, flip, and rotate. For a complete list of predefined profiles,
refer to Predefined Media Transformation Services transformation profiles, page 72.
Media Transformation Services also enables system administrators to modify existing
profiles or create new profiles. For more information, see Adding and modifying
transformation profiles, page 76.
Transformation profiles can be parameterized. When the user invokes a parameterized
profile, the user is prompted for the parameters required by the profile. For example,
a resize profile might include height and width parameters or percentage parameters.
The profile and its parameters are passed as a request to Media Transformation Services,
which maps the request to the appropriate plug-in and performs the transformation.
The parameters required by a profile can be assigned validation rules, where the
application validates the values entered by the user. The validation rules can check the
unit of measure, format, or similar metrics to avoid processing incorrect values.
66
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
Enabling a user prole in Webtop or DAM
When creating new user profiles, ensure that the following tags are present in the
profile file:
•
<MediaEnabled category="Public"/>
The profile must be Public in order to be visible.
•
<MediaEnabled category="MTS"/>
This tag ensures that the profile is visible with MTS-type profiles.
Chaining and sequencing proles
Media Transformation Services allows you to reference other profiles when you create
your own profiles. Essentially, you can automate a series of transformations, rather than
requiring users to request each transformation separately.
You can reuse profiles by two methods: chaining and sequencing.
•
Chaining profiles invoke each profile within them in stages. Transformations
occur one at a time, and the result of one transformation is required for the next
transformation. The result of a chaining profile would be one output file.
•
Sequencing profiles specify a list of profiles that are executed one after another. For
each profile in the profile sequence, you can specify whether the next profile should
wait on the successful completion of the previous task. If there is no specification,
profiles can be executed as soon the tasks threads are available to process them. This
means that each profile does not have to be complete before the next profile starts.
The result of sequencing profiles is one output file for each profile in the sequence.
Sequencing is the most common method of reusing profiles.
Once chained or sequenced transformations are created, they will appear as
transformation options in the user interface. For example, if you chained a resize
profile and a transform profile, the name and description you specified for this new
transformation option would appear in the WDK application along with the other
transformation profiles.
For more information on reusing transformation profiles, see Adding and modifying
transformation profiles, page 76 and Reusing profiles, page 90.
EMC Documentum Media Transformation Services Version 6 Administration Guide
67
Working with Proles
Command-line les
Command-line files are stored in the repository as XML files that can be used by the
plug-ins as needed. When the target plug-in is identified, Media Transformation Server
translates the parameterized profile into a command-line file for the plug-in.
The command-line file contains detailed instructions for the plug-in. It may also contain
additional parameters that are not user-selectable. For example, a profile could be
written to create a thumbnail that always produces JPEG output. The resulting file
format and many of its attributes (such as JPEG quality and color mode) could be
controlled at the command level. Command-line files are specific to each plug-in, since
the capabilities of plug-ins vary.
Each profile contains the profile name, a label (the text that displays in the client
application), a description, required attributes, and supported source/target dm_format
objects. For example, a resize profile could contain the attributes width and height and
any number of supported source and target formats, as in the following examples:
format source = tiff
target = tiff
format source = tiff
target = jpeg
format source = tiff
target = gif
format source = gif
target = gif
format source = gif
target = bmp
Profiles for which all parameters are defined contain only the name, label, description,
and supported source and target formats. Each profile is linked to an actual XML
command-line file for a given transformation.
Command-line files do not need to be created for profiles that reuse other profiles. A
lightweight profile that serves only to chain or sequence other profiles has no need for
CommandFilePath entries. Since the DTD does not require their presence, no change
is required in order to exclude them. If present, these entries will be ignored, as only
the atomic profiles require them.
To see a sample profile, refer to Sample profile, page 71.
Media Transformation Services DTD
Media Transformation Services profiles are written in XML. An external document type
definition (DTD) reference (ProfileSchema.dtd) defines the legal structure of profile files.
All profile files must conform to the Media Transformation Services DTD.
As defined by the DTD, all XML files consist of:
68
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
•
elements
•
attributes
•
entities
The Media Transformation Services DTD file is shown below.
<!ELEMENT Profile (Formats, Types*, MediaEnabled*, Transcodings,
(CommandFilePath* | ProfileChain* | ProfileSequence*))>
<!-- Profile attributes -->
<!ATTLIST Profile
name CDATA #REQUIRED
label CDATA #REQUIRED
related_objects_only (true | false) "false"
notify_result (true | false) "false"
operation (transform | extractProperties) "transform"
taskImpl CDATA "com.documentum.cts.impl.services.task.CTSTask"
description CDATA #IMPLIED>
<!ELEMENT MediaEnabled (#PCDATA)>
<!ATTLIST MediaEnabled category CDATA #REQUIRED>
<!ELEMENT Formats (Format+)>
<!ELEMENT Format (#PCDATA)>
<!-- Format attributes -->
<!ATTLIST Format
source CDATA #REQUIRED
target CDATA #REQUIRED>
<!ELEMENT Types (Type*)>
<!ELEMENT Type (#PCDATA)>
<!--Format attributes -->
<!ATTLIST Type
name CDATA #REQUIRED>
<!ELEMENT Transcodings (Transcode*)>
<!ELEMENT Transcode (Parameter*)>
<!-- Transcode attributes -->
<!ATTLIST Transcode
name CDATA #REQUIRED
label CDATA #REQUIRED>
<!ELEMENT Parameter (ValueList | ValueRange | (Value*) | (TupleElement+) |
(ContentObject+)), depends-on-param?)>
<!ELEMENT ValueList (Value+)>
<!ELEMENT Value (#PCDATA)>
<!-- Value attributes -->
<!ATTLIST Value
label CDATA #REQUIRED>
<!ELEMENT ValueRange (MinValue, MaxValue)>
EMC Documentum Media Transformation Services Version 6 Administration Guide
69
Working with Proles
<!ELEMENT MinValue (#PCDATA)>
<!ELEMENT MaxValue (#PCDATA)>
<!ELEMENT depends-on-param (Value+)>
<!ATTLIST depends-on-param
param-name CDATA #REQUIRED
action (hide | maintain_proportion) #REQUIRED>
<!-- Parameter attributes -->
<!ATTLIST Parameter
name CDATA #REQUIRED
label CDATA #REQUIRED
description CDATA #IMPLIED
controltype ( list | range | text | text-block | color-picker | object |
listbox) #REQUIRED
datatype ( string | integer | float | hex | tupleSequence | content)
#REQUIRED
dql CDATA # IMPLIED
default CDATA #IMPLIED
isRequired (true|false)"true" >
<!ELEMENT ContentObject (#PCDATA)>
<!ATTLIST TupleElement
label CDATA #REQUIRED
name CDATA #REQUIRED
datatype ( string | integer | hex | date ) #REQUIRED>
<!-- The remaining elements are for server-side use only. They should NOT be
parsed by application other than Media Transformation Services. -->
<!ELEMENT CommandFilePath (#PCDATA)>
<!-- CommandFilePath attributes -->
<!ATTLIST CommandFilePath
mptype CDATA #REQUIRED>
<!ELEMENT ProfileChain (InnerProfile+)>
<!ELEMENT InnerProfile (InnerTokenMapping*)>
<!-- waitOnCompletion will be ignored of the parent element of InnerProfile is
ProfileChain. It is intended for use only with ProfileSequence -->
<!-- InnerProfile attributes -->
<!ATTLIST InnerProfile
path CDATA #REQUIRED
waitOnCompletion (true | false) "true"
useTargetFormat (true | false) "true"
innerProfileId CDATA #IMPLIED>
<!ELEMENT InnerTokenMapping (#PCDATA)>
<!-- InnerTokenMapping attributes -->
<!ATTLIST InnerTokenMapping
LocalProfileToken CDATA #REQUIRED
InnerProfileToken CDATA #REQUIRED
Literal (true | false) "false"
>
<!ELEMENT ProfileSequence (InnerProfile+)>
70
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
Sample prole
The following is a sample of a Media Transformation Services profile definition for
rotating an image. This profile points to the command-line file rotate.xml which specifies
the execution commands for the Adobe Graphic Services (AlterCast) plug-in.
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE Profile SYSTEM "ProfileSchema.dtd">
<Profile name="rotate" label="Rotate" description=
"Rotate image by specifying angle of rotation">
<Formats>
<Format
<Format
<Format
<Format
<Format
<Format
source="photoshop3"
source="photoshop3"
source="photoshop3"
source="photoshop3"
source="photoshop3"
source="photoshop3"
target="photoshop7"/>
target="jpeg"/>
target="gif"/>
target="png"/>
target="tiff"/>
target="jpeg_lres"/>
<Format
<Format
<Format
<Format
<Format
<Format
source="photoshop5"
source="photoshop5"
source="photoshop5"
source="photoshop5"
source="photoshop5"
source="photoshop5"
target="photoshop7"/>
target="jpeg"/>
target="gif"/>
target="png"/>
target="tiff"/>
target="jpeg_lres"/>
<Format source="photoshop6" target="photoshop7"/>
<Format source="photoshop6" target="jpeg"/>
<Format source="photoshop6" target="gif"/>
<Format source="photoshop6" target="png"/>
<Format source="photoshop6" target="tiff"/>
<Format source="photoshop6" target="jpeg_lres"/>
<Format source="photoshop7" target="photoshop7"/>
<Format source="photoshop7" target="jpeg"/>
<Format source="photoshop7" target="gif"/>
<Format source="photoshop7" target="png"/>
<Format source="photoshop7" target="tiff"/>
<Format source="photoshop7" target="jpeg_lres"/>
<Format
<Format
<Format
<Format
<Format
<Format
source="jpeg"
source="jpeg"
source="jpeg"
source="jpeg"
source="jpeg"
source="jpeg"
<Format
<Format
<Format
<Format
<Format
<Format
source="gif"
source="gif"
source="gif"
source="gif"
source="gif"
source="gif"
target="photoshop7"/>
target="jpeg"/>
target="gif"/>
target="png"/>
target="tiff"/>
target="jpeg_lres"/>
target="photoshop7"/>
target="jpeg"/>
target="gif"/>
target="png"/>
target="tiff"/>
target="jpeg_lres"/>
EMC Documentum Media Transformation Services Version 6 Administration Guide
71
Working with Proles
<Format
<Format
<Format
<Format
<Format
<Format
source="png"
source="png"
source="png"
source="png"
source="png"
source="png"
target="photoshop7"/>
target="jpeg"/>
target="gif"/>
target="png"/>
target="tiff"/>
target="jpeg_lres"/>
<Format
<Format
<Format
<Format
<Format
<Format
source="jpeg_lres"
source="jpeg_lres"
source="jpeg_lres"
source="jpeg_lres"
source="jpeg_lres"
source="jpeg_lres"
target="photoshop7"/>
target="jpeg"/>
target="gif"/>
target="png"/>
target="tiff"/>
target="jpeg_lres"/>
</Formats>
<MediaEnabled category="MTS"/>
<MediaEnabled category="Public"/>
<Transcodings>
<Transcode name="rotate" label="Rotate image">
<Parameter name="doc_token_angle" label="Angle Of Rotation"
controltype="range" datatype="float">
<ValueRange>
<MinValue>-359.99</MinValue>
<MaxValue>+359.99</MaxValue>
</ValueRange>
</Parameter>
</Transcode>
</Transcodings>
<CommandFilePath mptype="Altercast">
/System/Media Transformation Server/Command Line Files/rotate.xml
</CommandFilePath>
</Profile>
Predened Media Transformation Services
transformation proles
Media Transformation Services includes a number of standard user profiles. However,
some profiles are dependent on the installation of third-party software.
Standard Media Transformation Services proles
Media Transformation Services is shipped with a number of predefined user profiles.
These profiles are detailed in Table 9, page 73.
72
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
Multiple plug-ins are required for some transformations in order to deal with different
source files. For example, resizing a Photoshop file invokes the Image 1 plug-in, whereas
a TIFF file is resized using the Image 2 plug-in.
Table 9. Standard Media Transformation Services transformation proles
Transformation profile
Action
Plug-in name
Add Text
Adds text to an image.
AlterCast
Adjust Contrast
Automatically adjusts
contrast of an image.
AlterCast
Apply Watermark To
Image
Applies a specified image
as a watermark to an
image.
Auto Levels
Automatically adjusts
levels in an image.
AlterCast
Set Canvas Size
Set canvas size by cropping
or expanding the canvas to
meet specified dimensions.
AlterCast
Change the ICC Color
Profile
Specify the ICC Color
Profile for images.
AlterCast
Change Resolution
Change the DPI for images.
AlterCast
Change Layer Color
Changes the color of a
specified Photoshop layer.
AlterCast
Add Copyright Properties
Embeds copyright
information as metadata.
AlterCast
Embed Metadata
Embeds metadata from
object in image properties.
AlterCast
Extract Properties
Adds image properties to
object metadata.
AlterCast, XMP
Flip an Image
Flips image horizontally or
vertically.
AlterCast
Change Layer Text
Changes the text of a
specified Photoshop layer.
AlterCast
Resize Image
Resizes an image with a
specified height and/or
width.
AlterCast, AVI, Image 1,
Image 2, PowerPoint
EMC Documentum Media Transformation Services Version 6 Administration Guide
73
Working with Proles
Transformation profile
Action
Plug-in name
Resize Image – Preserve
Aspect Ratio
Resizes image while
preserving the proportion
of height and width.
AlterCast, AVI, Image 1,
Image 2, PowerPoint
Rotate an Image
Rotates an image by
specifying angle of
rotation.
AlterCast
Convert EPS to PDF
Converts a file from EPS to
PDF.
AlterCast
Convert PDF to EPS Format
Converts PDF to EPS
format.
AlterCast
Convert Image Format
Converts an image from
one format to another
specified image format.
AlterCast, AVI, Image 1,
Image 2, PowerPoint
Convert Images to PDF
Converts images to PDF.
AlterCast
Trim Image Border
Removes pixels from the
edges of an image based on
color.
AlterCast
Textual Watermark
Adds watermark to
document.
AlterCast
Predened Audio/Video Transformation Services
proles
There are a number of Media Transformation Services user profiles that are dependent
upon your installation and use of Audio/Video Transformation Services. These profiles
are detailed in Table 10, page 74. All of these profiles invoke the Telestream plug-in.
Table 10. Standard Audio/Video Transformation Services proles
74
Transformation profile
Action
to_avi
Converts video to AVI format with user
defined video codec, and uncompressed
AVI audio stream (audio codec).
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
Transformation profile
Action
to_DV_Stream
Converts video to DV stream, the format
used by all DV camcorders. The format
can be transferred directly to a camcorder
over a Firewire (IEEE1394) connection.
to_mpeg1_layer3
Converts audio to MP3 (MPEG 1) or
extracts audio from video to MP3 (MPEG
1).
to_mpeg2_layer3
Converts audio to MP3 (MPEG 2) or
extracts audio from video to MP3 (MPEG
2).
to_QuickTime_DVStd
Converts video to QuickTime in DV
Standard Definition quality suitable
for editing and for use in multimedia
applications.
to_QuickTime_Streaming
Converts video to QuickTime in streaming
format.
to_real
Convert Video to RealNetworks with
RealAudio audio codec.
to_wav
Converts audio to WAVE or extracts audio
from video to WAVE.
to_wma
Converts audio to WMA or extracts audio
from video to WMA.
to_wmv
Converts audio to WMV or extracts audio
from video to WMV.
Predened Medical Imaging Transformation Services
proles
All of the transformation profiles available with Medical Imaging Transformation
Services are system profiles. There are no predefined user profiles for Medical Imaging
Transformation Services. Consult the Medical Imaging Transformation Services Installation
and Release Notes for more information.
EMC Documentum Media Transformation Services Version 6 Administration Guide
75
Working with Proles
Adding and modifying transformation proles
Media Transformation Services includes a set of predefined transformation profiles that
perform most common media transformations (such as resize, flip, and rotate), as well
as profiles that perform more complex transformations.
System administrators can modify the predefined profiles or add new profiles manually
or using the Profile Editor utility. You can change image output size or combine multiple
operations into one profile, to create a one-step transformation. You can write a profile to
perform almost any kind of transformation on media files.
This section includes the following tasks:
•
Building and modifying profiles with Profile Editor, page 76
•
Creating a profile manually using command-line files, page 83
•
Manually modifying a profile using command-line files, page 86
Media Transformation Services profiles are written in XML and conform to the Media
Transformation Services document type definition (DTD). Profiles are mapped to
XML command-line files which are plug-in specific, meaning for every profile, there
is one command-line file. For example, for the Adobe Graphics Server plug-in, a
Media Transformation Services profile must be mapped to an Adobe Graphics Server
command-line file to perform a transformation specific to Adobe Graphics Server.
All transformation profiles can be found in the System cabinet of your repository. This
is also where you add new profiles. Use an application such as Documentum Desktop
Client or Documentum Administrator to see the three folders in the repository for Media
Transformation Server profiles. Locating profiles, page 60 describes the profile folders
and their locations.
Building and modifying proles with Prole Editor
The Profile Editor assists with editing or building new profiles. New or existing profiles
can be customized by editing default values and adding or removing formats. Users can
select multiple profiles to create chained or parallel profiles that automate a series of
transformations. Both user and system profiles can be handled with the Profile Editor.
You can also add or remove profiles, to and from the original selection, rearrange the
order of profiles, and configure the desired behavior for a profile with the Profile Editor.
Note: Multi-language support is not available with Profile Editor for Version 6.0. See
Media Transformation Services Release Notes for further information.
This section contains the following procedures:
•
76
Editing a profile, page 77
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
•
Building a new profile, page 78
•
Building a chain profile, page 79
•
Building a parallel profile, page 81
The following procedure describes how to edit a profile in a repository using the Profile
Editor
Editing a prole
The following procedure describes how to edit a profile to update or customize it.
To edit a prole:
1.
Log in to Digital Asset Manager (DAM) as the Administrator.
2.
From the DAM browser tree, select Administration->CTS->Profiles node.
3.
The list of public profiles appears by default (Show public). In the drop down menu,
in the top right hand corner of the pane, select Show public and system to change
the view to all profiles. A list of profiles appears.
4.
Select a profile from the list that you would like to update.
5.
Select Tools>Edit Profile (or select the profile, right-click, and select Edit).
The Info tab displays.
6.
On the Info tab, edit the name, label, and description of the profile, if required.
•
Click Webtop Enabled, if required.
•
Click Browse to edit the folder destination, if required.
•
Click System if you wish to hide the profile, if required.
Click Next. The Formats tab displays.
7.
The Formats tab contains all the formats supported by Media Transformation
Services to generate default renditions for that profile.
Select the profile’s new source and target format from the list provided.
•
If required, click Add to include additional source and target formats from the
Format Selector.
•
Select new source and target from the Source Format and Target Format list
boxes. Click OK.
•
To remove a format from the Formats tab, click Remove. Click OK.
Click Next. The Parameters tab appears listing the available parameters for the
edited profile.
8.
Select the parameter(s) desired.
•
Click Configure, to configure the profile parameter, if required.
EMC Documentum Media Transformation Services Version 6 Administration Guide
77
Working with Proles
•
Enter the field values. Click OK. The Parameters tab refreshes.
•
Select the edited parameter.
Click Next. The Summary screen appears.
9.
The Summary screen confirms the elements that were selected and defined in the
previous screens.
Click Finish to validate and save the new profile.
10. The Profiles page is displayed. Verify that the edited profile appears on the Profiles
page.
11. All profile changes require that you stop and restart the Content Transformation
Services service (see Starting and stopping Media Transformation Services, page 47)
on the Media Transformation Services host.
Building a new prole
The following procedure describes how to build a new profile using an existing profile.
To build a new prole:
1.
Log in to Digital Asset Manager (DAM) as the Administrator.
2.
From the DAM browser tree, select Administration->CTS->Profiles node.
3.
The list of public profiles appears by default (Show public). In the drop down menu,
in the top right hand corner of the pane, select Show public and system to change
the view to all profiles. A list of profiles appears.
4.
From the list, select the existing profile with which you will build the new profile.
Select Tools->Build Profile.
The Info tab will display.
5.
On the Info tab, edit the name, label, and description of the profile, if required.
•
Click Webtop Enabled, if required.
•
Click Browse to edit the folder destination, if required.
•
Click System if you wish to hide the profile, if required.
Click Next. The Formats tab appears.
6.
The Formats tab contains all the formats supported by Media Transformation
Services to generate default renditions for that profile.
Select the profile’s new source and target format from the list provided.
•
78
If required, click Add to include additional source and target formats from the
Format Selector.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
•
Select new source and targets from the Source Format and Target Format list
boxes. Click OK.
•
To remove a format from the Formats tab, click Remove. Click OK.
Click Next. The Parameters tab appears.
7.
The Parameters tab lists the available parameters for the edited profile. Select the
parameter(s) desired.
•
Click Configure, to configure the profile parameter, if required.
•
Enter the field values.
•
Click OK. The Parameters tab refreshes.
•
Select the adjusted parameter.
Click Next. The Summary screen appears.
8.
The Summary screen confirms the elements that were selected and defined in the
previous screens.
Click Finish to validate and save the new profile.
9.
The Profiles page is displayed. Verify that the new profile appears on the Profiles
page.
10. All profile changes require that you stop and restart the Content Transformation
Services service (see Starting and stopping Media Transformation Services, page 47)
on the Media Transformation Services host.
Building a chain prole
Chaining profiles invoke each profile within them in stages. Transformations also occur
one at a time, one transformation is required for the next transformation. The result of a
chaining profile would be the output of the last profile in the chain. A chained profile
creates one output file.
The following procedure describes how to create a chained transformation according to
your specific requirements.
To build a chain prole:
1.
Log in to Digital Asset Manager (DAM) as the Administrator.
2.
From the DAM browser tree, select Administration->CTS->Profiles node.
3.
The list of public profiles appears by default (Show public). In the drop down menu,
in the top right hand corner of the pane, select Show public and system to change
the view to all profiles. A list of profiles appears.
EMC Documentum Media Transformation Services Version 6 Administration Guide
79
Working with Proles
4.
From the list, select the profiles with which you will build the new profile. Select
Tools->Build Profile>Chain.
5.
The Info tab will display.
•
Enter the generic name, label, and description of the new profile.
•
Click Webtop Enabled, if required.
•
Click Browse to edit the folder destination, if required.
•
Click System if you wish to hide the profile, if required.
Click Next. The Inner Profiles — Selection tab displays.
6.
The Inner Profile — Selection pane will display. This tab allows users to add,
remove, rearrange the desired inner profiles.
•
Select the inner profile(s) that you require from the Available Profiles drop down
list. Use the directional arrow, to move the selection(s) to the Selected Profiles
list box. The right list shows the new product(s) added. OR
•
Select the inner profile(s) from the Selected Profiles list. Use the directional
arrow, to move the selection(s) to the Available Profiles lists. The right list shows
the new product(s) added.
•
Use the up and down directional arrow to rearrange the Selected Profiles list to
create the desired sequence in the chain profile.
Click Next. The Inner Profile — Details pane displays.
7.
The Inner Profile — Details pane details the profiles selected for the chain profile. To
configure a path:
•
Select a path
•
Select Configure to configure an inner profile path, if required.
•
Select the desired output format from the list box.
•
Wait on completion is disabled for chained profiles.
•
Click OK.
•
Repeat Step 7 for each path you would like to configure.
Click Next. The Formats tab displays.
8.
80
The Formats tab contains all the formats supported by Media Transformation
Services to generate default renditions for that profile. Select the profile’s new source
and target format from the list provided.
•
click Add to edit the format, if required. The Format Selector screen appears.
•
Select an additional source and target pair from the Source Format and Target
Format list boxes.
•
Click OK. The Formats Page displays.
•
To remove a format from the Formats tab, select the Source and Target pair,
and click Remove.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
Click Next. The Parameters tab appears. listing the available parameters for the
chain profile.
9.
The Parameters tab appears lists the available parameters for the chain profile.
•
To configure a parameter, select the profile and parameter label.
•
Click Configure. The Configure pane displays.
•
Click Default Settings to select default values from the Default Values list box.
•
Select Hidden to hide the profile.
•
Click OK. The Parameter tab refreshes with the new information.
•
Repeat Step 9 until you have configured all the profile paths that you require.
Click Next.
10. The Summary page is displayed. This screen confirms the elements of the chained
profile.
Click Finish to validate and save the new profile.
11. The Profiles page is displayed. Verify that the new profile appears on the Profiles
page.
12. All profile changes require that you stop and restart the Content Transformation
Services service (see Starting and stopping Media Transformation Services, page 47)
on the Media Transformation Services host.
Building a parallel prole
The following procedure describes how to create a parallel transformation according to
your specific requirements.
Parallel profiles specify a list of profiles that are executed one after another or at the same
time. For each profile in the parallel profile, you can specify whether the next profile
should wait on the successful completion of the previous task. If there is no specification,
profiles can be executed as soon the tasks threads are available to process them. Each
profile does not have to be complete before the next profile starts. The result of parallel
profiles is one output file for each profile within the parallel profile.
To build a parallel prole:
1.
Log in to Digital Asset Manager (DAM) as the Administrator.
2.
From the DAM browser tree, select Administration->CTS->Profiles node.
3.
The list of public profiles appears by default (Show public). In the drop down menu,
in the top right hand corner of the pane, select Show public and system to change
the view to all profiles. A list of profiles appears.
EMC Documentum Media Transformation Services Version 6 Administration Guide
81
Working with Proles
4.
From the list, select the profiles with which you will build the new profile. Select
Tools->Build Profile>Parallel.
The Info tab will display.
•
Enter the generic name, label, and description of the new profile.
•
Click Webtop Enabled, if required.
•
Click Browse to edit the folder destination, if required.
•
Click System if you wish to hide the profile, if required.
Click Next. The Inner Profiles — Selection tab displays.
5.
The Inner Profile — Selection pane will display. This tab allows users to add,
remove, rearrange the desired inner profiles.
•
Select the inner profile(s) that you require from the Available Profiles drop down
list. Use the directional arrow, to move the selection(s) to the Selected Profiles
list box. The right list shows the new product(s) added. OR
•
Select the inner profile(s) from the Selected Profiles list. Use the directional
arrow, to move the selection(s) to the Available Profiles lists. The right list shows
the new product(s) added.
•
Use the up and down directional arrow to rearrange the Selected Profiles list to
create the desired sequence in the chain profile.
Click Next. The Inner Profile — Details pane displays.
6.
The Inner Profile — Details pane details the profiles selected for the parallel profile.
To configure a path:
•
Select a path
•
Select Configure to configure an inner profile path, if required.
•
Select the desired output format from the list box.
•
Click OK.
•
Repeat for each path you would like to configure.
Click Next. The Formats tab displays.
7.
The Formats tab contains all the formats supported by Media Transformation
Services to generate default renditions for that profile. Select the profile’s new source
and target format from the list provided.
•
click Add to edit the format, if required. The Format Selector screen appears.
•
Select an additional source and target pair from the Source Format and Target
Format list boxes.
•
Click OK. The Formats Page displays.
•
To remove a format from the Formats tab, select the Source and Target pair,
and click Remove.
Click Next. The Parameters tab appears. listing the available parameters for the
chain profile.
82
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
8.
The Parameters tab appears lists the available parameters for the chain profile.
•
To configure a parameter, select the profile and parameter label.
•
Click Configure. The Configure pane displays.
•
Click Default Settings to select default values from the Default Values list box.
•
Select Hidden to hide the profile.
•
Click OK. The Parameter tab refreshes with the new information.
•
Repeat step 8 until you have configured all the profile paths that you require.
Click Next.
9.
The Summary page is displayed. This screen confirms the elements of the parallel
profile.
Click Finish to validate and save the new profile.
10. The Profiles page is displayed. Verify that the new profile appears on the Profiles
page.
11. All profile changes require that you stop and restart the Content Transformation
Services service (see Starting and stopping Media Transformation Services, page 47)
on the Media Transformation Services host.
Creating a prole manually using command-line les
To create new transformation profiles using command-line files, you first need a
good understanding of which plug-ins support which types of transformations.
This will allow you to write profiles and command-line files specific to the libraries
provided by that plug-in vendor. For example, to create a profile that converts a TIFF
image to a Photoshop PSD file, you should know that this transformation can be
handled by the Adobe Graphics Server plug-in. You can then write a command-line
file following Adobe Graphics Server’s documentation (found at C:\Program
Files\Documentum\CTS\AlterCast\documentation) and create a new Media
Transformation Services profile that points to the Adobe Graphics Server command-line
file.
Note: Adobe Graphics Server was formerly known as AlterCast. The name AlterCast
still appears in the product and throughout the Adobe Graphics Server documentation.
These terms are interchangeable.
The majority of Media Transformation Services transformations are performed by the
Adobe Graphics Server plug-in. See Table 9, page 73 for a listing of transformations
and their related plug-ins.
EMC Documentum Media Transformation Services Version 6 Administration Guide
83
Working with Proles
To create a custom command-line prole manually:
1.
Create a custom command-line profile to specify the properties of the transformation.
It is easiest to export an existing command-line file from the repository, and
modifying it as required.
For transformations performed by the Adobe Graphics Server plug-in, refer to the
Adobe Graphics Server Command Reference document to obtain detailed explanations of
various commands that you can send to the AlterCast plug-in.
For example, you could customize the watermark profile to apply the company logo
to GIF files. You want to center the logo on the layer without resizing; the align
and scalePolicy parameters have been modified accordingly. The command-line
file would appear as follows:
<?xml version="1.0" encoding="UTF-8"?>
<commands>
<loadContent source="file:///doc_token_contentFilePath" out="thesource"/>
<loadContent source="sourceFile"/>
<addLayer type="pixel" position="above" name="Green"/>
<replacePixels target="/psd/layer[@name='Green']" source="thesource"
align="center" constrainProportions="true" scalePolicy="doNotScale"/>
<TYPE1>
<set target="/psd/optimizationSettings">
<optimizationSettings>
<doc_token_targetFormat/>
</optimizationSettings>
</set>
<saveOptimized name="imagefile" appendExtension="true"/>
</TYPE1>
<TYPE2>
<convertTo type="doc_token_targetFormat"/>
<saveContent name="outputimage" appendExtension="true"/>
</TYPE2>
<imageInfo/>
<saveContent name="image_info.xml"/>
</commands>
2.
Save the command-line profile with a unique name. In this example, the file is
given the name watermark_logo_C.xml. Import the profile to the /System/Media
Server/Command Line Profiles folder. When importing, accept the default XML
application.
3.
Create a custom profile to point to the command-line file created in Step 1. If you
modified an existing command-line profile, export and modify the corresponding
profile file.
Continuing the example of a custom watermark profile, the profile file would reflect
the changes indicated in bold text:
<?xml version=”1.0” encoding=”UTF-8”?>
<Profile name=”watermark_logo” label=”Apply Watermark Logo”
description=”Apply a Logo as a watermark” related_objects_only=”false”
notify_result=”false” operation=”transform”
84
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
taskImpl=”com.documentum.cts.impl.services.tasks.CTSTask”>
<Formats>
<Format source=”gif” target="gif"/>
</Formats>
<MediaEnabled category="MTS"/>
<MediaEnabled category="Public"/>
<Transcodings>
<Transcode name="watermark" label="Apply Watermark">
<Parameter name="doc_token_contentObjectID" label="Content Object"
controltype="object" datatype="content" isRequired="true">
<ContentObject/>
</Parameter>
</Transcode>
</Transcodings>
<CommandFilePath mptype="Altercast">
/System/Media Transformation Server/Command Line Files/watermark_logo_C.xml
</CommandFilePath>
</Profile>
4.
Save the modified profile file, using the same file name as the modified command-line
profile. Import the file to the /System/Media Server/Profiles folder. When importing
this file, remove the XML extension and change the type from dm_document to
dm_media_profile. Click Next. Accept the default XML.
If the new profile is a user transformation, proceed to Step 7. When creating a
transformation that is invoked automatically (on import or check in), proceed to
Step 5.
5.
Update the register profile (register.xml) to include the custom profile created
in Step 3.
Caution: Any modification of this profile must be done with care. The
register.xml file is integral to all transformations, and could cause all Media
Transformation Services processing to fail if improperly modified.
Using the example of the watermark logo, ensure that the desired format source and
target parameter is present in the file. Add the InnerProfile parameter for this profile,
which includes the path to the watermark graphic.
<?xml version=”1.0” encoding=”UTF-8” standalone="no"?>
<!DOCTYPE Profile SYSTEM "ProfileSchema.dtd">
<Profile name="register" label="Register Profile" description="Profile
for registering media" related_objects_only="false">
<Formats>
...
<Format source="gif" target="gif"/>
...
</Formats>
<MediaEnabled category="MTS"/>
<MediaEnabled category="System"/>
<Transcodings>
<Transcode name="register" label="register"/>
</Transcodings>
<ProfileSequence>
EMC Documentum Media Transformation Services Version 6 Administration Guide
85
Working with Proles
<InnerProfile path="/System/Media Server/Profiles/watermark_logo_C"
waitOnCompletion="true" useTargetFormat="true">
<InnerTokenMapping LocalProfileToken="C:\Images\CTS\logo.gif"
InnerProfileToken="doc_token_contentFilePath" Literal="true"/>
</InnerProfile>
...
</ProfileSequence>
</Profile>
Note: Source and target formats are the same in the register profile. This is because
processing does not start from this profile; the source is passed to the next profile.
6.
Save the register.xml file in the /System/Media Transformation Server/System
Profiles folder. Do not change the file name.
7.
If the new profile relates to the Adobe Graphics Server plug-in, you can test the
profile before importing it to Media Transformation Services. This test ensures that
the syntax and results are valid.
Test the commands using a utility called runxml.bat, located in C:\Program
Files\Documentum\CTS\AlterCast\samples.bin.
8.
Stop and restart Media Transformation Services (see Starting and stopping Media
Transformation Services, page 47).
Media Transformation Server automatically creates a dm_media_profile object
named for the new profile and destroys the dm_document named for the profile in
the /System/Media Server/Profiles folder. This will hide the document by linking it
with the dm_media_profile object.
9.
Check the CTS error log to verify that the new profile was loaded successfully.
For example, if a profile named watermark_logo_C is successfully imported, the
following lines appear in the log file:
10:14:43,437 INFO [ Thread-5] CTSProfileManagerImpl Successfully updated the profile cache for : watermark_logo_C ...
10:28:12,984 INFO [ Thread-5] CTSProfileManagerImpl Updating the profile : register
10:28:12,984 INFO [ Thread-5] CTSProfileManagerImpl Inner profile : /System/Media Server/Profiles/watermark_logo_C ...
Manually modifying a prole using command-line les
This section describes how to modify a transformation profile using command-line files.
You can modify a profile if the current profile is unsuitable for your needs. Modifying a
profile will customize it your specifications.
Media Transformation Server updates all dm_media_profile objects on startup. It
removes all repeating SOURCE and TARGET attributes and resets them. Therefore,
86
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
when a user modifies a dm_media_profile object, Media Transformation Server
automatically updates the object when the server restarts.
The following procedure describes how to modify a profile in a repository. Note
that when modifying an existing profile, it is not necessary to change anything in the
corresponding command-line profile or register profile.
To modify an existing transformation prole manually:
1.
Log in to the repository using an appropriate application (such as Digital Asset
Manager).
2.
Checkout or export the ProfileSchema.dtd file.
If you export the file, you only need to do so the first time you modify a profile.
3.
Check out and edit the profile (from \System\Media Server\Profiles) you want to
modify.
Note: If these files are not immediately visible, select Show All Objects and
Versions from the Show list box.
4.
Check in the profile.
5.
Stop and restart the Media Transformation Server service.
Example prole modication
Media Transformation Services allows for a great deal of flexibility through the
modification of profiles. For example, you might want to suppress the generation of
thumbnails for images of GIF format. This can easily be accomplished by checking out
the profile \System\Media Transformation Server\System Profiles\thumbnail and
removing the line:
<Format source="gif" target="jpeg_th"/>
The thumbnail profile is one of the profiles included in the sequence profile register
(located in \System\Media Transformation Server\System Profiles). The register profile
is invoked for all imported files of richmedia_enabled format.
It is also possible to suppress all thumbnail generation, regardless of format. The way to
do this is to modify the register profile by removing the section:
<InnerProfile path="/System/Media Transformation Server/System Profiles/
thumbnail" waitOnCompletion="false">
<InnerTokenMapping LocalProfileToken="jpeg_th" InnerProfileToken=
"doc_token_targetFormat" Literal="true"/>
</InnerProfile>
This modification removes the entire thumbnail profile from the register sequence and
it will no longer be invoked during the register process.
EMC Documentum Media Transformation Services Version 6 Administration Guide
87
Working with Proles
Note: After modified profiles are checked in to the repository, Media Transformation
Services must be restarted in order for the changes to come into effect.
Adding new formats to proles manually
You can add new formats to your profiles manually. For example, you can add a
different image format to the profiles if it is not already configured. However, you must
ensure that the relevant plug-in can handle the format you are adding. Consult the
Content Transformation Services Profile Modification Guide for detailed information about
plug-in capabilities, and the profiles that are handled by the plug-ins.
Adding new formats to profiles is a two-step procedure:
1.
Create the format in Documentum Administrator or in DQL.
See Using DQL in profiles, page 93 for more information about Document Query
Language (DQL).
Note: The format needs to be rich-media enabled only if files of this format are being
processed on import. Otherwise, the format should not be rich-media enabled.
2.
Add the format to Transformation Services.
To add your new format, follow the procedures in this section.
To create a new format using Documentum Administrator:
1.
In the left-hand pane, click Formats.
2.
Click File > New > Format.
3.
Enter the following information:
Name
Description
Default File Extension
Macintosh Creator
Macintosh Type
Can Be Indexed
Rich Media Enabled
Asset Class
4.
Click OK to save the new format.
To create a new format using DQL:
1.
88
Log on to a DQL editor and run the following DQL statements:
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
1. CREATE "dm_format" OBJECT SET "name"='<Enter format name>',
SET "description" = 'A Custom tiff format for
testing',
SET "can_index" = 0,
SET "topic_transform" = 0,
SET "mac_creator" = '<Enter value>',
SET "dos_extension" = '<Enter value>',
SET "is_hidden" = 0,
SET "mime_type" = '<Enter value>',
SET "icon_index" = 0,
SET "richmedia_enabled" = 1,
SET "asset_class" = 'Image'
2. UPDATE dm_format OBJECT SET mac_type = '<Enter value>'
WHERE name='<Enter value>'
Note: If files of this format are not being processed on import, the value for
"richmedia_enabled” should be set to 0.
Now that you have created the new format, enter a default storage location for the
format. See the Media Transformation Services Administration Guide for further information.
Follow the next procedure to add the format to Transformation Services.
To add the format to Transformation Services:
1.
Check out the relevant profile from the System Profiles or Profiles folder in the
repository.
Note: Depending on your scenario, choose whether system and/or user profiles
require modification. Consider the following:
2.
•
If files having this format already exist in the repository, you may need to modify
user profiles only.
•
If files having this format will be imported to the repository, modify the register
profile to accept the format. Other system profiles (such as thumbnail or
storyboard profiles) may need to be modified, as well.
Add the new format to the <Formats> section, following the proper syntax for the
profile.
For example, the proper syntax for addLayer.xml is:
<Format source="<new format name>" target="photoshop7"/>
3.
Save the profile.
4.
Check in the modified profiles.
Note: To check in the profiles, you must export the ProfileSchema.dtd to the same
folder from which you checked out the profiles. The ProfileSchema.dtd is also
located in the System/Media Server/System Profiles folder.
5.
Stop the CTS service.
6.
Map the CTS format to the repository format:
EMC Documentum Media Transformation Services Version 6 Administration Guide
89
Working with Proles
a.
Open %CTS_HOME%\config\FormatMapperService.xml file.
b. Add a new FormatMapper entry to the CTSCustomConfig section:
CTSFormat="<Plug-in format>" DocumentumFormat="<new format
name>"/>
c.
Save the file.
7.
Restart the repository.
8.
Start the CTS Windows service.
9.
Check the CTS log to ensure all profiles are loaded.
Media Transformation Services will now handle the new format.
Reusing proles
Chain and parallel profiles enable the execution of profiles in a sequence, without the
need for users to create complex command-line files. Command-line files are expressed
in the language of the native media processing technology, and are not consistent across
these technologies. As a result, these files are difficult to work with. In comparison, the
chaining of lightweight profiles is simpler due to their unified semantics.
For example, instead of trying to write a complex command-line file for Adobe Graphics
Server to flip and then rotate an image, along with writing a corresponding lightweight
profile, it is much simpler to write a chain or parallel profile that reuses the flip and rotate
profiles that come with Media Transformation Services. The following are examples of
each type of profile reuse (chain and parallel). For creating chain and parallel profiles
using the Profile Editor, see .
Creating chain proles manually
The following is an example of a profile created using the chaining technique. This
profile will flip the input media, and then take that output and rotate it. The result of the
rotate will then be stored in the repository. The user specifies the direction of the flip,
and the angle of the rotation which is mapped to the InnerProfile’s tokens.
The result of this profile is one new output file that is derived from the one original input
file, after the two profiles have been executed.
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE Profile SYSTEM "ProfileSchema.dtd">
<Profile name="flipANDrotate" label="Flip And Rotate" description=
"Profile for flipping and then rotating an image" related_objects_only=
"false">
<Formats>
90
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
<Format
<Format
<Format
<Format
<Format
source="photoshop6"
source="photoshop6"
source="photoshop6"
source="photoshop6"
source="photoshop6"
<Format
<Format
<Format
<Format
<Format
source="jpeg"
source="jpeg"
source="jpeg"
source="jpeg"
source="jpeg"
<Format
<Format
<Format
<Format
<Format
source="gif"
source="gif"
source="gif"
source="gif"
source="gif"
target="photoshop6"/>
target="jpeg"/>
target="gif"/>
target="png"/>
target="tiff"/>
target="photoshop6"/>
target="jpeg"/>
target="gif"/>
target="png"/>
target="tiff"/>
target="photoshop6"/>
target="jpeg"/>
target="gif"/>
target="png"/>
target="tiff"/>
<Format source="png" target="photoshop6"/>
<Format source="png" target="jpeg"/>
<Format source="png" target="gif"/>
<Format source="png" target="png"/>
<Format source="png" target="tiff"/>
</Formats>
<MediaEnabled category="MTS"/>
<MediaEnabled category="Public"/>
<Transcodings>
<Transcode name="flipAndRotate" label="Flip and Rotate Image">
<Parameter name="doc_token_flip_direction" label=
"Direction of Flip" controltype="list" datatype="string">
<ValueList>
<Value label="Vertical">vertical</Value>
<Value label="Horizontal">horizontal</Value>
</ValueList>
</Parameter>
<Parameter name="doc_token_rotation_angle" label="Angle of rotation"
controltype="range" datatype="integer">
<ValueRange >
<MinValue >-359</MinValue>
<MaxValue >+359</MaxValue>
</ValueRange >
</Parameter>
</Transcode>
</Transcodings>
<ProfileChain>
<InnerProfile path="/System/Media Transformation Server/Profiles/
flip">
<InnerTokenMapping LocalProfileToken="gif" InnerProfileToken=
"target_format"
Literal="true"/>
<InnerTokenMapping LocalProfileToken="vertical" InnerProfileToken=
"doc_token_direction"
Literal="false"/>
</InnerProfile>
<InnerProfile path="/System/Media Transformation Server/Profiles/
rotate">
<InnerTokenMapping LocalProfileToken="60" InnerProfileToken=
EMC Documentum Media Transformation Services Version 6 Administration Guide
91
Working with Proles
"doc_token_angle"
Literal="false"/>
</InnerProfile>
</ProfileChain>
</Profile>
Creating parallel proles manually
The following is an example of a parallel profile created using the sequencing technique.
This profile will flip the input media, and then store the output in the repository. It will
also rotate the input media and store that in GIF format. This profile was written so that
the output of the rotate will always be in a GIF format. The user specifies the direction of
the flip and the angle of the rotation which is mapped to the InnerProfile’s tokens.
The result of this profile is two new output files from the one original input file.
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE Profile SYSTEM "ProfileSchema.dtd">
<Profile name="flipTHENrotate" label="Flip THEN Rotate" description=
"Profile for flipping and then rotating an image" related_objects_only=
"false">
<Formats>
<Format source="photoshop6" target="photoshop6"/>
<Format source="photoshop6" target="jpeg"/>
<Format source="photoshop6" target="gif"/>
<Format source="photoshop6" target="png"/>
<Format source="photoshop6" target="tiff"/>
<Format
<Format
<Format
<Format
<Format
source="jpeg"
source="jpeg"
source="jpeg"
source="jpeg"
source="jpeg"
<Format
<Format
<Format
<Format
<Format
source="gif"
source="gif"
source="gif"
source="gif"
source="gif"
target="photoshop6"/>
target="jpeg"/>
target="gif"/>
target="png"/>
target="tiff"/>
target="photoshop6"/>
target="jpeg"/>
target="gif"/>
target="png"/>
target="tiff"/>
<Format source="png" target="photoshop6"/>
<Format source="png" target="jpeg"/>
<Format source="png" target="gif"/>
<Format source="png" target="png"/>
<Format source="png" target="tiff"/>
</Formats>
<MediaEnabled category="MTS"/>
<MediaEnabled category="Public"/>
<Transcodings>
<Transcode name="flipTHENrotate" label="Flip then Rotate Image">
<Parameter name="doc_token_flip_direction" label=
92
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
"Direction of Flip"
controltype="list" datatype="string">
<ValueList>
<Value label="Vertical">vertical</Value>
<Value label="Horizontal">horizontal</Value>
</ValueList>
</Parameter>
<Parameter name="doc_token_rotation_angle" label=
"Angle of rotation" controltype="range" datatype="integer">
<ValueRange >
<MinValue >-359</MinValue>
<MaxValue >+359</MaxValue>
</ValueRange >
</Parameter>
</Transcode>
</Transcodings>
<ProfileSequence>
<InnerProfile path='/System/Media Transformation Server/Profiles/flip'
waitOnCompletion='false'>
<InnerTokenMapping LocalProfileToken='doc_token_flip_direction'
InnerProfileToken='doc_token_direction'/>
<InnerTokenMapping LocalProfileToken='This is a flipped image.'
InnerProfileToken='target_page_modifier' Literal='true'/>
</InnerProfile>
<InnerProfile path='/System/Media Transformation Server/Profiles/rotate'>
<InnerTokenMapping LocalProfileToken='doc_token_rotation_angle'
InnerProfileToken='doc_token_angle'/>
<InnerTokenMapping LocalProfileToken='gif' InnerProfileToken=
'doc_token_targetFormat' Literal='true'/>
<!-- I could hard code the angle of rotation if I wished here
as well and remove the parameter from above
<InnerTokenMapping LocalProfileToken='90' InnerProfileToken=
'doc_token_angle' Literal='true'/>
-->
</InnerProfile>
</ProfileSequence>
</Profile>
Using DQL in proles
Document Query Language (DQL) can be specified for all Media Transformation
Services profile files. Through DQL, default profile parameters can be supplied. For
example, header text can be pre-populated with the client’s name. This text will appear
on the Transformation Details screen (of a WDK-based application such as DAM or
Webtop) when a user performs an Add header and/or footer transformation.
The DQL is presented as an attribute of the Parameter node of profiles (named dql). This
section discusses:
•
The dql attribute value syntax, page 94
•
DQL guidelines, page 94
EMC Documentum Media Transformation Services Version 6 Administration Guide
93
Working with Proles
•
DQL query examples, page 94
•
Querying the r_object_id attribute, page 95
The dql attribute value syntax
The syntax for the dql profile parameter attribute value does not differ from a regular
DQL statement. It supports the following tokens (placeholders) which are recognized
by the system:
•
[sysobject_id_token]: placeholder for a Sys Object ID (the r_object_id attribute for
dm_sysobject)
•
[format_token]: placeholder for the rendition’s format (string)
•
[page_token]: placeholder for the page attribute of dmr_content (integer)
•
[page_modifier_token]: placeholder for the page_modifier attribute of dmr_content
(string)
These tokens are replaced at runtime with the actual values taken from the source sys
object that is used to execute the profile, before executing the actual query.
DQL guidelines
Consider the following guidelines when supplying DQL for profiles:
•
The system does not try to correct a wrong query. It always assumes the query is
correctly supplied in profile. The system replaces the contained placeholders with
runtime values, and then executes it against the repository.
•
Upon executing the query, the system will just consider the first row returned in
the result set. If the query is set to return multiple records, just the first one will
be considered.
•
All the attribute values returned will be formatted accordingly, based on the attribute
type (such as date, string, or Boolean).
DQL query examples
Complex queries can be created with DQL. Queries can include all four supported
tokens, as many times as they are needed.
The following examples illustrate how to supply the DQL for the dql profile parameter
attribute:
94
EMC Documentum Media Transformation Services Version 6 Administration Guide
Working with Proles
<Parameter name=”doc_token_text” label=”New Text” controltype=”text”
datatype=”string” dql=”SELECT object_name from dm_document WHERE
r_object_id = [sysobject_id_token]”>
<Value label=”text”/>
</Parameter>
<Parameter name=”doc_token_text” label=”New Text” controltype=”text”
datatype=”string” dql=”SELECT 'Name:' as label, object_name from
dm_document WHERE r_object_id = [sysobject_id_token]”>
<Value label=”text”/>
</Parameter>
<Parameter name=”doc_token_text” label=”New Text” controltype=”text”
datatype=”string” dql=”SELECT 'Modified:' as label, r_modify_date from
dm_document WHERE r_object_id = [sysobject_id_token]”>
<Value label=”text”/>
</Parameter>
The following query can be used for getting the current lifecycle state for a sys object,
as string:
<Parameter name=”doc_token_text” label=”New Text” controltype=”text”
datatype=”string” dql=”SELECT state_name FROM dm_policy a, dm_sysobject b
WHERE a.r_object_id = b.r_policy_id AND a.i_state_no = b.r_current_state
AND b.r_object_id = [sysobject_id_token] ENABLE(row_based)”>
<Value label=”text”/>
</Parameter>
For getting information that is pertinent to the user who executes the profile, the user
keyword can be used in query:
<Parameter name=”doc_token_text” label=”New Text” controltype=”text”
datatype=”string” dql=”SELECT user_name, user_address FROM dm_user
WHERE user_name = USER”>
<Value label=”text”/>
</Parameter>
Querying the r_object_id attribute
Having the r_object_id attribute as part of the SELECT clause of the query will not result
in having the actual Object ID value supplied as part of the default parameter value. This
attribute sometimes has a special (system) role in query (for example, properly returning
the repeating attributes in a single row). The system cannot process its real purpose at
runtime, and therefore will not consider it when building the profile parameter default
value.
In order to have the Object ID value supplied as part of the profile default parameter
value, syntax must be provided that will use the [sysobject_id_token] placeholder on the
query’s SELECT clause, as follows:
<Parameter name=”doc_token_text” label=”New Text” controltype=”text”
datatype=”string” dql=”SELECT [sysobject_id_token] as objectid from
dm_document WHERE r_object_id = [sysobject_id_token]”>
EMC Documentum Media Transformation Services Version 6 Administration Guide
95
Working with Proles
<Value label=”text”/>
</Parameter>
96
EMC Documentum Media Transformation Services Version 6 Administration Guide
Chapter 5
Performing Transformations
Documentum Media Transformation Services allows users to transform media files from one format
to another. In addition to performing format transformations, users can change properties of an
image and create a new rendition of the image. Examples of properties that can be changed include
width, height, color mode, and compression, using a parameterized, profile-based process. This
chapter provides basic procedural information for performing these transformations.
Individual transformation requests are defined by transformation profiles. A transformation profile
is associated with a command-line file that is used by Media Transformation Server to invoke the
appropriate plug-in. For more information about transformation profiles, see Chapter 4, Working
with Profiles.
As with all Content Transformation Services products, the capabilities of Media Transformation
Services are accessed through a Documentum client application such as Digital Asset Manager
or Web Publisher. To perform these transformations, log in to the repository serviced by Media
Transformation Services.
Note: The procedures provided in this chapter relate to the Digital Asset Manager interface.
Depending on the client application you are using, there might be slight variations in the menu
options or interface labels available to you.
There are numerous types of transformations available with the core Media Transformation Services
application. These transformations are explained in the following sections:
•
Adding copyright properties, page 98
•
Adding text, page 99
•
Adjusting contrast, page 101
•
Adjusting levels, page 102
•
Applying a watermark, page 103
•
Changing layer color, page 105
•
Changing ICC color profile, page 106
•
Changing resolution, page 108
•
Converting an image, page 109
•
Embedding metadata, page 110
EMC Documentum Media Transformation Services Version 6 Administration Guide
97
Performing Transformations
•
Extracting properties, page 112
•
Flipping an image, page 113
•
Changing layer text, page 114
•
Resizing an image, page 116
•
Rotating an image, page 118
•
Setting canvas size, page 119
•
Trimming an image, page 121
Note: The transformation options presented to the user depend on two factors:
•
Which Content Transformation Services products are installed on the host. If other transformation
applications are installed, there are more options available than those listed above.
•
The type of source document chosen for transformation. Not all options are available for every
transformation. For example, if a user is transforming a GIF file, the Color Overlay option is not
available. Color Overlay is available for Photoshop (PSD) files only.
Transformations available with Audio/Video Transformation Services are described in the Audio/Video
Transformation Services Installation and Release Notes; see the Medical Imaging Transformation Services
Installation and Release Notes for transformations specific to Medical Imaging Transformation Services.
Transformations to create new renditions occur on one item at a time and requests are processed
asynchronously, meaning that new renditions may not be available immediately. You receive a
notification in your Inbox when a transformation is completed or if a transformation fails.
Adding copyright properties
Copyright information can be added as a property of an image. This transformation
adds the copyright information to the image’s properties; this information does not
appear on the image. To add copyright information which does appear on the image,
see Adding text, page 99.
To add copyright properties to an image:
1.
Navigate to the file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Add Copyright Properties option. Click Next.
The Transformation Details tab appears.
98
4.
Select the output format from the Select Output list box.
5.
Enter the copyright information, and click Next.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Performing Transformations
The Save As screen appears.
6.
Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object, will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
7.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
8.
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click the Edit link by Permission Set if you wish to change permission
parameters. Click OK.
•
Click the Edit link by Lifecycle if you wish to change document lifecycle
information. Click OK.
•
Click the New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
9.
The transformation request is immediately sent to the appropriate queue for
processing.
Adding text
The Add Text transformation creates a new layer for applying text to an image. For
example, you can add copyright information to appear on the image. Users can specify
the color, font size, and alignment of the text.
EMC Documentum Media Transformation Services Version 6 Administration Guide
99
Performing Transformations
To add text to an image:
1.
Navigate to the file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Add Text option. Click Next.
The Transformation Details tab appears.
4.
Select the output format from the Format Output list box.
5.
Assign a unique name in the Layer Name box.
6.
In the Text Area box, input the text to be applied to the image.
7.
Click on
8.
Input the desired font size in the Text Size box.
9.
Specify the alignment of the text by setting the horizontal and vertical base positions.
Click Next.
to choose the text color.
The Save As screen appears.
10. Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
11. If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
12. If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
100
•
Select the object type from the Object Type list box.
•
Click Edit by Permission Set if you wish to change permission parameters. Click
OK.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Performing Transformations
•
Click Edit by Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
13. The transformation request is immediately sent to the appropriate queue for
processing.
Adjusting contrast
The Adjust Contrast option automatically adjusts the contrast of an image. This
transformation is designed for photographic or continuous-tone images; it does not
improve the appearance of flat-color images. The pixel value range of the bottom layer is
narrowed slightly.
To adjust the contrast:
1.
Navigate to the file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select the Adjust Contrast option. Click Next.
The Transformation Details tab appears.
4.
Select the output format from the list box. Click Next.
The Save As screen appears.
5.
Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
6.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
EMC Documentum Media Transformation Services Version 6 Administration Guide
101
Performing Transformations
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
7.
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit by Permission Set if you wish to change permission parameters. Click
OK.
•
Click Edit by Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
8.
The transformation request is immediately sent to the appropriate queue for
processing.
Adjusting levels
The Auto Levels transformation provides an automatic contrast adjustment to images
with an average distribution of pixel values, or images with an overall color cast.
To automatically adjust levels in an image:
1.
Navigate to the file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Auto Levels option. Click Next.
The Transformation Details tab appears.
4.
Select the output format from the list box. Click Next.
The Save As screen appears.
102
EMC Documentum Media Transformation Services Version 6 Administration Guide
Performing Transformations
5.
Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
6.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
7.
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit next to Permission Set if you wish to change permission parameters.
Click OK.
•
Click Edit next to Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
8.
The transformation request is immediately sent to the appropriate queue for
processing.
Applying a watermark
An image can be applied as a watermark during transformation by choosing the Apply
Watermark transformation.
When you apply a watermark, Media Transformation Services adds a layer to the image
for overlaying the watermark. By default, the watermark is left-aligned.
EMC Documentum Media Transformation Services Version 6 Administration Guide
103
Performing Transformations
To apply a watermark to an image:
1.
Navigate to the file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Apply Watermark to Image option. Click Next.
The Transformation Details tab appears.
4.
Select the output format from the list box.
5.
Click the Select link to browse for a file to apply as the watermark. After choosing
the file, click Next.
The Transformation Details tab appears confirming your selection.
6.
Click Next. The Save As screen appears.
7.
Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
8.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
9.
104
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit next to Permission Set if you wish to change permission parameters.
Click OK.
•
Click Edit next to Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Performing Transformations
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
10. The transformation request is immediately sent to the appropriate queue for
processing.
Changing layer color
The Color Overlay option allows the user to change the color within an existing
layer. This option is available for Photoshop (PSD) source files only. You can use this
transformation to change the color in a pixel layer or a text layer.
To change the layer color of a PSD le:
1.
Navigate to the Photoshop file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Change Layer Color option. Click Next.
The Transformation Details tab appears.
4.
Select the output format from the list box.
5.
Enter the name of the pixel layer or text layer being changed. You must specify the
layer name as it appears in the Photoshop source file. If an incorrect layer name is
entered, the transformation fails.
6.
Click on
to choose the layer color. Click Next.
The Save As screen appears.
7.
Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
8.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
EMC Documentum Media Transformation Services Version 6 Administration Guide
105
Performing Transformations
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
9.
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit next to Permission Set if you wish to change permission parameters.
Click OK.
•
Click Edit next to Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
10. The transformation request is immediately sent to the appropriate queue for
processing.
Changing ICC color prole
ICC (International Color Consortium) profiles help to ensure correct color reproduction
when images are viewed or printed. ICC profiles are an intregal part of color
management. By assigning a color profile to an image, each device that handles the
image — whether it is a camera, monitor, printer, or scanner — recognizes the profile,
and displays colors according to the settings in the profile. This ensures that all devices
show colors consistently.
For example, if you match the image’s color mode to your monitor’s color mode, you can
accurately soft proof images prior to printing. You can set the color mode on a Windows
machine at Control Panel > Display > Settings > Advanced > Color Management.
To adjust the color profile of a source file, choose the Change the ICC Color Profile
transformation.
To change the ICC color prole of an image:
1.
106
Navigate to the file that you want to transform to create a new rendition.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Performing Transformations
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Change the ICC Color Profile option. Click Next.
The Transformation Details tab appears.
4.
Select the output format from the Format Output list box.
5.
Select the color output from the ICC Color Profile list box. Click Next.
The Save As screen appears.
6.
Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
7.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
8.
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit next to Permission Set if you wish to change permission parameters.
Click OK.
•
Click Edit next to Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
EMC Documentum Media Transformation Services Version 6 Administration Guide
107
Performing Transformations
9.
The transformation request is immediately sent to the appropriate queue for
processing.
Changing resolution
To change the number of pixels displayed per unit, choose the Change Resolution
option. The default setting for this option is 72 dpi.
The default setting is suitable for on-screen viewing. Most monitors can only display
72 to 90 pixels per inch, so a higher resolution would serve no purpose. Reducing the
resolution to 72 dpi reduces the file size without affecting the display of the image.
However, if you are changing the resolution of images to be printed, a higher resolution
is recommended. In this case, see Adding and modifying transformation profiles, page
76 to either modify the setting in the changeResolution profile, or create a new profile
specifically for images to be printed.
To change the resolution of an image:
1.
Navigate to the file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Change Resolution option. Click Next.
The Transformation Details tab appears.
4.
Select the output format from the list box.
5.
Specify the image resolution in dots per inch (dpi). Click Next.
The Save As screen appears.
6.
Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
7.
108
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Performing Transformations
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
8.
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit next to Permission Set if you wish to change permission parameters.
Click OK.
•
Click Edit next to Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
9.
The transformation request is immediately sent to the appropriate queue for
processing.
Converting an image
Users can transform an image from one format to another using the Convert Format
option. Many different formats are available, as listed in Table 4, page 32.
To convert an image to a different le format:
1.
Navigate to the file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Convert Image Format option (to convert to a different image format other
than PDF) or select Convert to PDF. Click Next
The Transformation Details tab appears. (If you selected Convert to PDF, there are
no additional format options available and the Save As screen appears. Proceed
to Step 5).
4.
Select the output format from the list box. Click Next.
The Save As screen appears.
EMC Documentum Media Transformation Services Version 6 Administration Guide
109
Performing Transformations
5.
Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
6.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
7.
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit next to Permission Set if you wish to change permission parameters.
Click OK.
•
Click Edit next to Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
8.
The transformation request is immediately sent to the appropriate queue for
processing.
Embedding metadata
Users can embed object properties or attributes to the content using the Embed
Properties option. Object attributes such as title, author, subject, and keywords can
be embedded. To add copyright information to the metadata, see Adding copyright
properties, page 98.
110
EMC Documentum Media Transformation Services Version 6 Administration Guide
Performing Transformations
The file format does not change during this transformation.
To embed metadata in an image le:
1.
Navigate to the file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Embed Metadata option. Click Next.
The Save As screen appears.
4.
Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
5.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
6.
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit next to Permission Set if you wish to change permission parameters.
Click OK.
•
Click Edit next to Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
EMC Documentum Media Transformation Services Version 6 Administration Guide
111
Performing Transformations
7.
The transformation request is immediately sent to the appropriate queue for
processing.
Extracting properties
The Extract Properties option writes content properties or attributes to object properties.
Content attributes such as samples per pixel, color space, resolution, and creator can
be extracted.
The file format does not change during this transformation.
To extract metadata in an image le:
1.
Navigate to the file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select the Extract Properties option. Click Next.
The Save As screen appears.
4.
Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
5.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
6.
112
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit next to Permission Set if you wish to change permission parameters.
Click OK.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Performing Transformations
•
Click Edit next to Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
7.
The transformation request is immediately sent to the appropriate queue for
processing.
Flipping an image
Images can be flipped horizontally or vertically. A horizontal flip produces a mirror
image; a vertical flip places the top of the image at the bottom, and vice versa.
The file format can also be converted during this transformation.
To ip an image:
1.
Navigate to the file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Flip an Image option. Click Next.
The Transformation Details screen appears.
4.
Select the output format from the list box.
5.
Specify the flip direction. Click Next.
The Save As screen appears.
6.
Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
7.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
EMC Documentum Media Transformation Services Version 6 Administration Guide
113
Performing Transformations
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
8.
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit next to Permission Set if you wish to change permission parameters.
Click OK.
•
Click Edit next to Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
9.
The transformation request is immediately sent to the appropriate queue for
processing.
Changing layer text
The Change Layer Text option allows the user to change the text in a specific Photoshop
(PSD) layer. This option is available for PSD source files only.
The file format can also be converted during this transformation.
To replace text in a PSD le:
1.
Navigate to the Photoshop file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Change Layer Text option. Click Next
The Transformation Details screen appears.
114
EMC Documentum Media Transformation Services Version 6 Administration Guide
Performing Transformations
4.
Select the output format from the list box.
5.
Enter the name of the layer being changed. You must specify the text layer name as
it appears in the Photoshop source file.
If you specify a layer name that doesn’t exist in the source file, the transformation
fails. If you specify a pixel layer, this transformation will add text to the layer.
6.
Enter the new text to appear on the layer. Click Next.
The Save As screen appears.
7.
Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
8.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
9.
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit next to Permission Set if you wish to change permission parameters.
Click OK.
•
Click Edit next to Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
10. The transformation request is immediately sent to the appropriate queue for
processing.
EMC Documentum Media Transformation Services Version 6 Administration Guide
115
Performing Transformations
Resizing an image
There are two ways to resize an image. The Resize Image transformation allows the user
to specify a new height and/or width for the image, whereas Resize Image - Preserve
Aspect Ratio resizes the image while maintaining the proportion of width to height.
The file format can also be converted during this transformation.
To perform a basic resize transformation:
1.
Navigate to the file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Resize Image option. Click Next.
The Transformation Details screen appears.
4.
Select the output format from the list box.
5.
Specify the image width and height (in pixels). Click Next. .
The Save As screen appears.
6.
Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
7.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
8.
116
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit next to Permission Set if you wish to change permission parameters.
Click OK.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Performing Transformations
•
Click Edit next to Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
9.
The transformation request is immediately sent to the appropriate queue for
processing.
To perform a resize transformation while preserving the aspect ratio:
1.
Navigate to the file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Resize Image - Preserve Aspect Ratio option. Click Next
The Transformation Details screen appears.
4.
Select the output format from the list box.
5.
Specify the image width and height (in pixels). Users are required to specify both
parameters (width and height options are provided), but the proportion will be
maintained based on the specified width. Click Next. .
The Save As screen appears.
6.
Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
7.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
EMC Documentum Media Transformation Services Version 6 Administration Guide
117
Performing Transformations
Click Finish.
8.
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit next to Permission Set if you wish to change permission parameters.
Click OK.
•
Click Edit next to Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
9.
The transformation request is immediately sent to the appropriate queue for
processing.
Rotating an image
The Rotate an Image option allows users to specify an angle of rotation, from –359.99
to +359.99 degrees.
The file format can also be converted during this transformation.
To rotate an image:
1.
Navigate to the file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Rotate an Image option. Click Next.
The Transformation Details screen appears.
4.
Select the output format from the list box.
5.
Specify the angle of rotation. A negative (-) value rotates the image counter-clockwise,
while a positive (+) value rotates the image clockwise. Click Next. .
The Save As screen appears.
6.
118
Select one of the following:
EMC Documentum Media Transformation Services Version 6 Administration Guide
Performing Transformations
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
7.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
8.
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit next to Permission Set if you wish to change permission parameters.
Click OK.
•
Click Edit next to Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
9.
The transformation request is immediately sent to the appropriate queue for
processing.
Setting canvas size
You can specify a particular canvas size with the Set Canvas Size option. The canvas is
cropped or expanded to meet the specified dimensions.
The file format can also be converted during this transformation.
EMC Documentum Media Transformation Services Version 6 Administration Guide
119
Performing Transformations
To adjust the canvas size of an image:
1.
Navigate to the file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Set Canvas Size option. Click Next.
The Transformation Details screen appears.
4.
Select the output format from the list box.
5.
Specify the horizontal and vertical alignment of the existing image.
6.
Specify the width and height (in pixels) of the new canvas size. Click Next.
The Save As screen appears.
7.
Select one of the following:
•
Create a New Rendition
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
8.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
9.
120
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit next to Permission Set if you wish to change permission parameters.
Click OK.
•
Click Edit next to Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Performing Transformations
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
10. The transformation request is immediately sent to the appropriate queue for
processing.
Trimming an image
The Trim option removes pixels from the edges of an image, based on color. The area to
be trimmed must be of constant color. This transformation can be used to remove the
white margin from a printed page, for example.
The file format can also be converted during this transformation.
To trim the size of an image:
1.
Navigate to the file that you want to transform to create a new rendition.
2.
Select the file, then select Tools > Transform > More Formats
The Select Transformation tab appears displaying the selected file and the available
transformations for the selected file.
3.
Select Trim Image Border option. Click Next.
The Transformation Details screen appears.
4.
Select the output format from the list box.
5.
Select the Based On attribute. This attribute determines the pixel color to trim. The
following options are available:
6.
•
Transparency: Trims transparent pixels.
•
Top Left: Trims pixels that are the same color as the top left corner.
•
Top Right: Trims pixels that are the same color as the top right corner.
•
Bottom Left: Trims pixels that are the same color as the bottom left corner.
•
Bottom Right: Trims pixels that are the same color as the bottom right corner.
Choose which sides(s) of the image to crop. Select True from the list box to trim
pixels from that side. Click Next.
The Save As screen appears.
7.
Select one of the following:
•
Create a New Rendition
EMC Documentum Media Transformation Services Version 6 Administration Guide
121
Performing Transformations
•
Create a New Object
Selecting Create a New Object will allow you to use this object in its own
workflow, create a translation of it, apply its own permission, and so on.
8.
If you selected Create a New Rendition, the Rendition Definition screen appears.
Enter a description of the rendition in the Rendition Description field.
•
Click Save Transformation if you wish to perform this transformation every time
the parent object is versioned.
•
Click Set As Default Preview, if you wish to set this rendition as the default
preview rendition.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish.
9.
If you selected Create a New Object, the New Object Definition screen appears. Enter
a title of the new object in the Title field. Perform any of the following as required:
•
Select the object type from the Object Type list box.
•
Click Edit next to Permission Set if you wish to change permission parameters.
Click OK.
•
Click Edit next to Lifecycle if you wish to change document lifecycle information.
Click OK.
•
Click New Location option to change and log the new file location. Click OK.
•
Click Save Transformation if you wish to apply this transformation every time
the parent object is versioned.
Note: A format must be richmedia_enabled to allow for transformation whenever it
is versioned.
Click Finish
10. The transformation request is immediately sent to the appropriate queue for
processing.
122
EMC Documentum Media Transformation Services Version 6 Administration Guide
Chapter 6
Troubleshooting
This chapter provides troubleshooting information for errors encountered from various elements of
Media Transformation Services. Also see Media Transformation Services Release Notes, which contain
additional information regarding limitations, technical notes, usability, and known bugs.
This section contains troubleshooting guidance relating to:
•
Queue items are not generating, page 123
•
Error events and log files, page 123
•
A transformation request fails, page 124
•
A profile error occurs, page 125
•
Media Transformation Server cannot add a rendition to a particular format, page 126
•
Media Transformation Server cannot log in to the repository, page 126
•
Media Transformation Server fails to start the PowerPoint plug-ins, page 127
•
Content Transformation Services fails to function, page 127
Queue items are not generating
If after configuring Media Transformation Services, queue items are not generating,
restart the repository.
Error events and log les
Any time Media Transformation Server fails to process a particular item, it queues
an event (dm_mediaserver_error) to the Inbox of the repository user defined as the
system operator in the Media Transformation Server configuration file. The first step in
troubleshooting Media Transformation Server is to check the system operator’s Inbox for
any messages that might explain the error.
EMC Documentum Media Transformation Services Version 6 Administration Guide
123
Troubleshooting
Additionally, review the CTS_Log.txt log file. This log file contains errors and exceptions
that are specific to the Media Transformation Server. The default location of the log file
on the Media Transformation Server host, is in the following directory:
%CTS_HOME%\logs
Plug-in error exceptions are sent to individual log files that are specific to each plug-in.
These plug-in log files allow you to quickly troubleshoot exceptions that are specific
to each plug-in. For example, errors relating to the IMG plug-in are found in the
IMG_Plug-in_Log.txt log file.
The plug-in log files are located in the %CTS_HOME%\logs directory on
the Media Transformation Server host. The Adobe Graphics Server log file,
AlterCast_log_<number>.txt, is located in the same location.
Note: If separate logging is enabled, log files will be in the %CTS_
HOME%\docbases\<docbase name>\config\logs folder. Otherwise, they are in the
main logs directory at %CTS_HOME%\logs.
A transformation request fails
Occasionally, a transformation request may fail to process, or may process incorrectly.
Typically, an examination of any error messages will indicate the problem.
The following actions can be performed to determine the cause of a transformation
request failure.
To troubleshoot the failure of a transformation request:
1.
Check that the object of the transformation request is not locked. If the object is
locked during the transformation, the operation fails.
2.
Check for error messages in the system operator’s Inbox indicating that the source
file may not adhere to system specifications. For example, the file may be corrupted,
or compression or other similar features (such as codec) of the file may not be
supported by Media Transformation Services.
3.
Check that disk space and memory on the Media Transformation Server host, and
the Content Server host, is sufficient to handle the requested file transformation.
4.
Restart the Media Transformation Server host and attempt the transformation again.
Restarting the Media Transformation Server will not affect the Media Transformation
Services queue.
124
EMC Documentum Media Transformation Services Version 6 Administration Guide
Troubleshooting
A prole error occurs
Errors related to profiles may occur. For example, if a profile was edited and updated
manually, there may be issues with the XML file.
There are a number of ways to determine the cause of a profile error.
To identify the cause of a prole-related error:
1.
Check the Inbox of the Media Transformation Server system operator for error
messages. Error messages here may indicate the cause of the error.
2.
Check the CTS_log.txt file log file or the main Documentum log file, log4j.log, for
exceptions.
3.
If you suspect the profile itself to be the cause of the error, use Digital Asset Manager
or Documentum Administrator to make sure you have three folders in the repository
for Media Transformation Server profiles:
•
/System/Media Server/Profiles
•
/System/Media Server/System Profiles
•
/System/Media Server/Command Line Profiles
These folders should be created when you install Media Transformation Services.
Make sure the profile is in the correct folder. For more information on where profiles
are stored, see Chapter 4, Working with Profiles.
4.
Make sure that the command-line file referenced by the profile (dm_media_profile
object) exists in the appropriate folder (above) and that the name in the profile is
identical to the actual file name. For example, if a dm_media_profile object resize
contains the following link to its command-line file:
/System/Media Server/Command Line Profiles/resize.xml
make sure the command-line file used by the resize object is called resize.xml.
5.
Make sure the ProfileSchema.dtd is stored in the repository folder:
/System/Media Server/Profiles
6.
If a new user profile is not appearing in the WDK application, but the log file
indicates that the profile was successfully imported, ensure that the following tags
appear in the profile file (typically after the <Formats> section):
<MediaEnabled category="MTS"/>
<MediaEnabled category="Public"/>
7.
Restart the Media Transformation Server.
EMC Documentum Media Transformation Services Version 6 Administration Guide
125
Troubleshooting
Media Transformation Server cannot add a
rendition to a particular format
If Media Transformation Server cannot add a rendition to a particular format, first check
the Inbox of the Media Transformation Server system operator for error messages, and
then check the CTS_log.txt file. Look for a detailed message that describes the problem.
For example, the message "Object with id=...does not exist” would indicate that the
object was deleted from the repository before the Media Transformation Server could
add a rendition to it.
Media Transformation Server cannot log in to
the repository
Media Transformation Server connects to the repository using a repository SuperUser
account. If Media Transformation Server cannot log in to the repository, ensure that a
valid repository SuperUser is identified for Media Transformation Server to use.
To identify the cause of Media Transformation Server not logging in to
the repository:
1.
Make sure that the repository is running.
2.
Check your network connections.
3.
Check that the Connection Broker is running.
4.
Check that the dfc.properties file points to the Connection Broker that recognizes
your repository.
5.
Log in to the Media Transformation Server host as an administrator.
6.
Open the Media Transformation Server service directory, located in the directory:
%CTS_HOME%\config
7.
Open the SessionService.xml file in any text or XML editor.
8.
Check the values of the MediaServerName attributes userName and passwordFile of
the Media Transformation Server element.
<CTSServer AttributeName="userName" AttributeValue="<admin_user"/>
<CTSServer AttributeName="passwordFile" AttributeValue="C:\PROGRA~1\DOCUME~1\CTS\docb
9.
126
Make sure you have configured the SessionService.xml file to the proper user in
the repository who has SuperUser access. If necessary, check with the repository
administrator to verify user name and password information.
EMC Documentum Media Transformation Services Version 6 Administration Guide
Troubleshooting
For more information on the repository user name and password, see Configuring
Media Transformation Services through Documentum Administrator, page 35.
10. Save and close the SessionService.xml file.
11. Restart the Media Transformation Server and/or the repository.
Media Transformation Server fails to start the
PowerPoint plug-ins
If the Media Transformation Server fails to start the PowerPoint plug-ins, the following
error message appears:
•
PowerPoint: "Unable to instantiate PowerPoint MPI: Can’t co-create object”
This error may occur if your computer has insufficient Component Object Model
(COM) access permissions, or the COM Default Impersonation Level is set improperly.
COM is a Microsoft-developed software architecture that allows for the creation of
component-based applications.
To configure your COM access settings, see the Technical Note in the Media Transformation
Services Release Notes.
Content Transformation Services fails to
function
Content Transformation Services fails to function and you receive an error message when
attempting transformations. The error may occur if the Global Registry does not have
a Content Transformation Services product (Rich_Media_Services and Transformation
docapps) configured against it. The Global Registry is a common repository where
commonly used docapps are installed.
Ensure Rich_Media_Services and Transformation docapps are run against the Global
Registry repository. See instructions in the Media Transformation Services Installation Guide.
EMC Documentum Media Transformation Services Version 6 Administration Guide
127
Troubleshooting
128
EMC Documentum Media Transformation Services Version 6 Administration Guide
Index
A
adding
files to repository, 21
format to Transformation Services, 89
new formats to profiles, 88
text to an image, 99
transformation profiles, 76, 83
watermark, 103
adjusting
contrast, 101
levels, 102
Admin password
changing, 48
Adobe Graphics Server, configuring, 40
Adobe Photoshop, see Photoshop
AlterCast, see Adobe Graphics Server
apply calls
register_asset, 24
transcode_content, 27
applying a watermark, 103
architecture, 13
aspect ratio, preserving, 117
attributes
content_attr_name, 24
content_attr_value, 24
embedding, 110
extracting, 112
richmedia_enabled, 18, 24
audio plug-ins, 16
auto levels, 102
B
batch files, 36, 46
C
Can Be Indexed setting, 39
canvas size, changing, 119
capabilities of MTS, 30
changing
canvas size, 119
color overlay, 105
color profile, 106
image height/width, 116
notification setting, 36
resolution, 108
checkin of files, 24
color overlay, 105
color profile, changing, 106
COM Class ID for format, 38
command-line files, 60, 125
storing, 68
configuration through Documentum
Administrator
accessing the configuration screen, 37
configuring
repository, 37
using the Configurator, 37
configuring Media Transformation
Server, 35
changing login user name, 36
changing the logging level, 36
changing the maximum number of
queue items, 36
changing the notification setting, 36
changing the polling interval, 36
changing the queue item expiry, 36
changing the repository, 37
changing the system operator, 36
Configurator, 37
configuring, queue marker, 48
Content Server
integration with Media
Transformation Services, 18
integration with Streaming Server, 19
queue, 18
storage of low-resolution
renditions, 26
storage rules, 19
storing register requests, 17
EMC Documentum Media Transformation Services Version 6 Administration Guide
129
Index
Content Transformation Monitor
Services, 47
Content Transformation Services
description, 11
error message, 127
extending, 16
fails to function, 127
format awareness, 12
queue, 12
scalability, 12
content_attr_name attribute, 24
content_attr_value attribute, 24
contrast, adjusting, 101
converting
image format, 109
copyright metadata, adding, 98
Create New Template command, 39
creating
new related objects, 28
new renditions, 28
transformation profiles, 76
cropping an image, 121
CTS Activity Template
document transformation, 51
Documentum Process Builder, 49
transformation profiles, 50
users, 50
workflow parameters, 51
working with, 49
CTS Admin Agent, 36, 46
CTS Reporting Tool, 52
disable, 52
enable, 52
viewing reports, 53
CTS Service
changing user, 48
D
DAM
modifying transformation profiles, 77
to 79, 81
MTS enabled, 14
using DFC, 14
data model of media objects, 19
details of a CTS instance, viewing, 46
DFC, 18
about, 14
installing, 15
migrating, 15
130
DICOM plug-in, 17
Digital Asset Manager, see DAM
dm_document object, 25
dm_format object, 18
dm_media_profile object, 86
dm_mediaserver queue, 18
dm_mediaserver_error, 123
dm_register_asset, 21
dm_repository_config object, 18
dmi_queue_item object, 17, 21
dmr_content object, 24
Documentum Administrator
accessing the configuration screen, 37
administrative tasks, 45
configuration tasks, 35
Create New Format Object page, 38
defining file formats, 38
Documentum Foundation Classes, see
DFC
DOS extensions, 38
DQL
guidelines, 94
in profiles, 93
query examples, 94
r_object_id attribute, 95
syntax, 94
tips, 94
DTD, 68
E
embedding metadata, 110
errors, 123 to 126
log files, 46
receiving, 36
with plug-ins, 124
events, dm_mediaserver_error, 36, 123
extracting
media properties, 24
metadata, 112
F
features of MTS, 29
file formats, 38
filename extensions, 38
files
checkin, 24
storage, 17
FlipFactory, 16
EMC Documentum Media Transformation Services Version 6 Administration Guide
Index
flipping an image, 113
format_token, 94
formats
changing, 109
creating templates, 39
input, 30, 32
output, 32
formats, file, 38
G
generating
low-resolution renditions, 26
storyboards, 25
thumbnails, 25
Global Registry
CTS product, 127
H
horizontal flip, 113
I
ICC profile, changing, 106
Inbox notifications, 36, 123 to 124
changing in DA, 36
configuring, 42
Index
with Filter setting, 39
with Rendition setting, 39
input formats, 32
installation of plug-ins, 16
instance details, viewing, 46
International Color Consortium, see ICC
profile
IPTC Headers, 26
J
JPEG images, handling large, 40
L
levels, adjusting, 102
load balancing, 47
log files, 124
viewing, 46
log in, 126
logging level, changing, 36
login user, identifying, 36
low-resolution renditions, 14
generating, 26
storing, 26
supported file formats, 26
M
Macintosh Creator format setting, 39
Macintosh Type format setting, 39
media objects data model, 19
media properties
examples of, 24
extracting, 24
storing, 24
Media Transformation Server, 123 to 124
configuring, 35
queue, 20
Media Transformation Services
architecture, 13
components, 13
Configurator, 37
environment, 13
error message, 123
functional overview, 17
functions of, 20
general description, 13
global flag, 18
integration with Content Server, 18
integration with Streaming
Servers, 13
processing, 20 to 21
queue, 17 to 18
refreshing, 46
repository configuration, 21
request priority, 20
starting, 46 to 47
stopping, 46 to 47
Media Transformation Services
Configurator, 37
Media_Server_Log.txt, 124
Medical Imaging Transformation
Services, 17
metadata, 24
copyright, 98
embedding, 110
extracting, 112
migration of DFC, 15
MIME
type, 38
modifying
EMC Documentum Media Transformation Services Version 6 Administration Guide
131
Index
system profiles, 76
modifying profiles, 76, 86
monitor services, 47
multiple servers, 47
N
notifications
changing in DA, 36
configuring, 42
O
objects
dm_document, 25
dm_format, 18
dm_media_profile, 86
dm_repository_config, 18
dmi_queue_item, 17
dmr_content, 24
storing, 19
transforming, 97
output formats, 32
P
page_modifier_token, 94
page_token, 94
password
changing, 48
password, changing in Documentum
Administrator, 46
Photoshop
changing color in a layer, 105
replacing text in a layer, 114
pixel threshold, 40
placeholders, 94
play from frame video, 25
plug-ins
Audio/Video Transformation
Services, 16
description, 15
errors, 124
extending, 16
installation of, 16
Medical Imaging Transformation
Services, 17
prerequisites, 16
processing, 17, 21, 24
role in Media Transformation
Server, 14
132
standard, 15
using command-line files, 68
polling interval, changing, 36
PowerPoint objects, 25
preserving aspect ratio, 117
processing files, 21
Profile Editor
build profile, 78 to 79, 81
chain profile, 78 to 79, 81
chaining, 76
modifying profiles, 76, 78 to 79, 81
sequence profile, 78 to 79, 81
sequencing, 76
specialized profile, 78 to 79, 81
profiles, 60, 71, 125
adding, 76, 83
adding new formats to, 88
chaining, 67
description of, 66
IPTC Headers, 26
modifying, 76, 86
parameters, 66
reusing, 67
sequencing, 67
storage location, 76
user, enabling, 67
using DQL, 93
ProfileSchema.dtd, 68
properties
embedding, 110
extracting, 112
Q
queue
description of, 20
for Media Transformation Services, 17
to 18
object, 14
polling interval, 20
priority, 20
removing unsupported formats
from, 12
queue items
changing the expiry, 36
changing the maximum number
allowed, 36
not generating, 123
queue manager
error message, 123
EMC Documentum Media Transformation Services Version 6 Administration Guide
Index
queue marker, manage queue item, 48
queue, managing, 54
R
r_object_id, 95
refreshing Media Transformation
Services, 46
register request, 14
object, 17
register_asset apply call, 24
registration
description, 21
extracting media properties, 24
generating low-resolution
renditions, 26
generating storyboards, 25
generating thumbnails, 25
registry ID for format, 38
renditions, 126
low-resolution, 26
multiple, 26, 28
performing, 14
storage of, 26
storyboard, 25
thumbnail, 25
replacing text, 114
repository, 126
adding, 37
adding a transformation profile to, 83
changing, 37
configuration with Media
Transformation Services, 21
removing, 37
resizing an image, 116
resolution changing, 108
richmedia_enabled attribute, 18, 24
rotating an image, 118
S
sample DTD, 68
sample profile, 71
scalability of Content Transformation
Services, 12
servers, multiple, 47
settings
Can Be Indexed, 39
Default File Extension, 38
Index with Filter, 39
Index with Rendition, 39
MIME type, 38
source documents, 38
source formats, 32
spinning, see rotating an image
starting Media Transformation
Services, 46 to 47
stopping Media Transformation
Services, 46 to 47
storing
objects, 19
rules, 19
storyboards
generating, 25
play from frame, 25
timecode, 25
Streaming Server, 19
integration, 13
sysobject_id_token, 94
system architecture, 13
system operator user, identifying, 36
system profiles, modifying, 76
T
target formats, 32
Telestream FlipFactory, 16
text
adding, 99
replacing, 114
Thumbnail Server
storing thumbnails, 19, 25
thumbnails
generating, 14, 25
storing, 19, 25
timecodes, video, 25
tokens, 94
transcode_content apply call, 27
transformation
description, 97
extraction of IPTC Headers, 26
overview, 27
performing, 27
process, 27
profiles, 28, 66
Transformation node, 54
transformation profiles, 60, 125
adding, 76, 83
chaining, 67
command-line files, 60, 68
EMC Documentum Media Transformation Services Version 6 Administration Guide
133
Index
description of, 66
IPTC Headers, 26
modifying, 70, 86
parameters, 66
reusing, 67
sequencing, 67
storage location, 76
transformation queue, 54
Transformation queue
changing queue priority, 55
configuring queue management
fields, 57
deleting queue item, 57
removing queue management
field, 58
viewing details of queue item, 56
viewing transformations, 55
transformation request, 14
Transformation Services
Audio/Video, 16
transformation services, additional, 16
transformations, 124
list of available, 97
supported, 32
transformations, performing, 14
transforming image format, 109
134
trimming an image, 121
troubleshooting, 123 to 127
with log files, 46
U
user profiles, enabling, 67
users, changing
for CTS Service, 48
for repository login, 36
system operator, 36
V
vertical flip, 113
video
objects, play from frame, 25
plug-ins, 16
W
watermark, applying, 103
WDK, relation to Media Transformation
Services, 15
Web Development Kit, see WDK
Web Publisher, MTS enabled, 14
EMC Documentum Media Transformation Services Version 6 Administration Guide
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement