Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
CenterStage Pro
Version 1.0 SP1
Administration Guide
EMC Corporation
Corporate Headquarters:
Hopkinton, MA 01748-9103
1-508-435-1000
www.EMC.com
Copyright © 2009 EMC Corporation. All rights reserved.
Published December 2009
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 ................................................................................................................................. 7
List of Tables
This guide is for administrators and business experts who configure platform and application
options, and who create CenterStage spaces and templates.
The procedures in this guide reference the following EMC documents, found on the Powerlink
website (http://Powerlink.EMC.com):
• CenterStage Overview Guide
• Documentum Administrator 6.5 User Guide
• Documentum Composer 6.5 User Guide
• Documentum Federated Search Services Administration Guide
• Documentum Federated Search Adapter Installation Guide
• Documentum Content Intelligence Services Administration Guide
Revision history
The following changes have been made to this document.
EMC Documentum CenterStage lets users create, edit, and collaborate on content in Documentum
repositories in your organization’s Documentum Enterprise Content Management System. Users run
CenterStage in web browsers, giving them access to repositories and content management functions.
CenterStage provides two clients: the CenterStage Essentials client provides basic content services;
the CenterStage Pro client provides basic content services plus administrative access, advanced
search, wikis, blogs, and RSS feeds.
After your organization has installed CenterStage on the EMC Documentum platform, administrators
must create users, set system-wide platform options, set system-wide CenterStage options, and create
the first CenterStage spaces so that users can begin working with content through CenterStage.
This chapter lists the tasks you must perform to set up CenterStage so that users can begin working
with content.
For a detailed introduction to CenterStage, see the CenterStage Overview Guide.
Administrative tasks
After your organization has installed CenterStage on the EMC Documentum platform, administer
CenterStage by performing the tasks listed in Table 1, page 9.
You set the Documentum platform options using Documentum Administrator (DA), which is installed
with CenterStage. DA provides a web-based interface to administer the Documentum Content Server
platform, Documentum repositories, and Documentum platform clients, such as CenterStage.
To perform the procedures in this chapter, you must have the URL and a username to sign in to
your organization’s DA installation.
To set Documentum platform options, do the following:
• Create a user in the repository, page 11
• Enable email notification for subscribed content, page 12
• Assign members who create users to the dce_user_manager role, page 13
• Assign members who create spaces to the dce_room_creator role, page 13
• Assign members who create space templates to the dmc_kw_manage_space_templates role,
page 14
Depending on your installation, administering CenterStage can involve additional tasks not described
in this guide. To set other platform options, see the Documentum Administrator 6.5 User Guide.
To create a user:
1. In Documentum Administrator, connect to the repository in which to create the user and navigate
to Administration > User Management > Users.
2. Select File > New > User.
Note: For instructions on entering additional user information, see the Documentum Administrator
6.5 User Guide.
4. To allow the user to receive email notifications when subscribed content changes, enter the
Email Address.
Note: For users to receive email notifications, you must also specify the SMTP server on the
Documentum platform, as described in Enable email notification for subscribed content, page 12.
5. Click OK.
To specify the SMTP server that sends email notifications to CenterStage users:
1. In Documentum Administrator, navigate to Administration > Basic Configuration > Content
Servers.
2. Select the Content Server and select View > Properties > Info.
3. In the SMTP Server field in the Info tab, type the name or IP address of the SMTP server that
provides mail services to the Content Server.
4. Click OK.
Federated search is available if your organization has enabled the connection with the Federated
Search Services (FS2) server. Federated search allows users to search external and internal sources at
the same time and display all results consistently. This section briefly describes the main steps to add
and configure external sources. For more information on FS2, see the Documentum Federated Search
Services Administration Guide, available within the CenterStage product on the Powerlink website.
You manage external sources using the Admin Center FS2 administration tool. Each external source
in CenterStage is an information source in Admin Center. An information source relies on an
adapter bundle (available as a *.jar file) and a specific configuration. Some information sources can
be available with a default configuration because they correspond to public information sources.
For example, the information sources Google, Wikipedia, OpenDirectory, and YahooDirectory are
already configured and available in CenterStage. Other information sources require configuration
before being available to users.
The following adapter bundles are available out-of-the-box with FS2:
• EMC Documentum ECM (Enterprise Content Management)
• EMC Documentum eRoom
• EMC Documentum ApplicationXtender
• EMC Documentum EmailXtender
• JDBC/ODBC
• Google Desktop Enterprise
• Windows Search
• OpenSearch
• FS2 Indexing for shared drives
The configuration of each adapter is described in the Documentum Federated Search Adapter Installation
Guide.
FS2 Admin Center can be accessed using a URL such as:
https://:<FS2_server_host>:<Admin_Center_port_number>/AdminCenter
where <FS2_server_host> is the name or the IP address of FS2 server,
and <Admin_Center_port_number> is set to 3003 by default.
Documentum Content Intelligence Services (CIS) extracts information for CenterStage Pro users to
select when they filter content lists to narrow the numbers of items displayed. CenterStage Pro
provides three filters, as described in Table 2, page 17. The CIS server analyzes CenterStage content
and metadata every 30 minutes to extract new or updated information. CIS refers to extracted values
as entities.
Documentum Retention Policy Services (RPS) automates retention and disposition of content
in accordance with configured policies. RPS is a WDK-based application, like Documentum
Administrator (DA), that runs in an application server.
If you have deployed RPS in your CenterStage environment, consult this chapter for RPS-specific
configuration information.
CenterStage provides inline viewers that display the first page of a document with a thumbnail.
Documentum Thumbnail Generator (TG) creates single-page thumbnails (300 x 300 pixels in size) for
images, PDF files, and Office documents. If you install Documentum Media Transformation Services
(MTS) or Documentum Advanced Document Transformation Services (ADTS), CenterStage can
provide full-screen, multi-page document and image viewing capabilities in addition to thumbnails.
The following tables show the image and document formats supported by the optional transformation
services:
BPM
WPD
RTF, TXT
PS
HTML
Administrators can configure MTS and ADTS to generate renditions of different formats and sizes.
For more information, see the Media Transformation Services Installation Guide and the Advanced
Document Transformation Services Installation Guide.
After deciding which Content Transformation Services product is best suited for your CenterStage
deployment, consult the appropriate section for configuration information:
• Advanced Document Transformation Services, page 22
• Media Transformation Services, page 27
• Thumbnail Generator, page 30
General troubleshooting guidance is outlined in CTS troubleshooting, page 34.
2. Select Show All Objects and Versions from the menu in the top right corner.
3. Check out these files:
• pdf_processing.xml
• register.xml
Now proceed to Register formats for renditions, page 23.
to
<Format source="<Add source format here>" target="<Add target format
here>"/>
For example, to enable thumbnails and storyboards for Microsoft Word documents, your tag
would look like the following:
<Format source="msw8" target="msw8"/>
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.
3. Save the file.
3. Save app.xml.
4. Restart the CenterStage application server to load the change.
To configure ADTS for large renditions, create a new profile and register the profile.
Note: This procedure is based on ADTS 6.5 SP1/SP2.
InnerProfileToken="doc_token_targetFormat" Literal="true"/>
</InnerProfile>
4. Add an inner profile for the Large Low Resolution Proxy to the <ProfileSequence> section,
just before the close tag, </ProfileSequence>. The example below uses the maximum
resolution of 1200 x 1200, but this value can be set to suit your environment.
<!-- This will enable large full screen renditions -->
<InnerProfile path="/System/Media Server/System Profiles/autoGenProxy_pdfstoryboard"
waitOnCompletion="false" useTargetFormat="true">
<InnerTokenMapping LocalProfileToken="jpeg_lres"
InnerProfileToken="doc_token_targetFormat" Literal="true"/>
<InnerTokenMapping LocalProfileToken="false"
InnerProfileToken="overwrite_rendition" Literal="true"/>
<InnerTokenMapping LocalProfileToken="1200"
InnerProfileToken="doc_token_width_proxy" Literal="true"/>
<InnerTokenMapping LocalProfileToken="1200"
InnerProfileToken="doc_token_height_proxy" Literal="true"/>
<InnerTokenMapping LocalProfileToken="Large Low Resolution Proxy"
InnerProfileToken="rendition_description" Literal="true"/>
</InnerProfile>
3. Change the values for doc_token_width and doc_token_height from 200 to 300 in the
following inner profiles:
...
<InnerProfile path="/System/Media Server/System Profiles/storyboard_pdfstoryboard"
waitOnCompletion="false" useTargetFormat="true">
<InnerTokenMapping LocalProfileToken="jpeg_story" InnerProfileToken=
"doc_token_targetFormat" Literal="true"/>
<InnerTokenMapping LocalProfileToken="200" InnerProfileToken=
"doc_token_width" Literal="true"/>
<InnerTokenMapping LocalProfileToken="200" InnerProfileToken=
"doc_token_height" Literal="true"/>
<InnerTokenMapping LocalProfileToken="-1" InnerProfileToken=
"doc_token_pageNumber" Literal="true"/>
</InnerProfile>
Complete configuration
Once you have completed all of the ADTS configuration, perform these tasks:
• In DA, check in the register.xml and pdf_processing.xml files as new versions.
• Restart the CTS service so that all configuration changes are captured.
3. Save app.xml.
4. Restart the CenterStage application server to load the change.
To configure MTS for large renditions, create a new profile and register the profile.
Note: This procedure is based on MTS 6.5 SP1/SP2.
<InnerTokenMapping LocalProfileToken="1200"
InnerProfileToken="doc_token_height_proxy" Literal="true"/>
<InnerTokenMapping LocalProfileToken="High Resolution Proxy"
InnerProfileToken="rendition_description" Literal="true"/>
</InnerProfile>
3. Change the value for doc_token_width and doc_token_height from 200 to 300 in the
following inner profile:
<InnerProfile path="/System/Media Server/System Profiles/storyboard_pdfstoryboard"
waitOnCompletion="false" useTargetFormat="true">
<InnerTokenMapping LocalProfileToken="jpeg_story" InnerProfileToken=
"doc_token_targetFormat" Literal="true"/>
<InnerTokenMapping LocalProfileToken="200" InnerProfileToken=
"doc_token_width" Literal="true"/>
<InnerTokenMapping LocalProfileToken="200" InnerProfileToken=
"doc_token_height" Literal="true"/>
<InnerTokenMapping LocalProfileToken="-1" InnerProfileToken=
"doc_token_pageNumber"
Literal="true"/>
</InnerProfile>
Complete configuration
Once you have completed all of the MTS configuration, perform these tasks:
• In DA, check in the register.xml and pdf_processing.xml files as new versions.
• Restart the CTS service so that all configuration changes are captured.
Thumbnail Generator
If your Enterprise installation uses Documentum Thumbnail Generator (TG) to support thumbnail
display in CenterStage, the following guidelines and notes apply:
• General notes, page 30
• Configure TG for multiple repositories, page 31
General notes
• The Adlib Web Express server component of the TG installation requires IIS to be on port 80.
If IIS is on a different port, you can temporarily set IIS to port 80 before installing TG. Once
TG is installed and you set IIS back to the non-80 port, you must configure Adlib to use the
non-standard port.
• If one or more of the Adlib or Documentum Content Transformation Services do not install (are
not visible in Windows Services Manager), install them manually.
b. Copy the two QueueProcessorContext sections and paste them to make another two
instances. Update the repository name wherever the string "docbase2_name_here" appears
in the following section:
<!-- Make a copy of the above two QueueProcessorContext section
for docbase2 -->
<!-- This is the entry for docbase2 to poll "dm_mediaserver" queue items -->
<QueueProcessorContext DocbaseName="docbase2_name_here">
<CTSServer AttributeName="queueItemName" AttributeValue="dm_mediaserver"/>
<CTSServer AttributeName="queueInterval" AttributeValue="10"/>
<CTSServer AttributeName="maxThreads" AttributeValue="10"/>
<!-- change the location of tempFileDir to match with the repository name -->
<CTSServer AttributeName="tempFileDir" AttributeValue=
"C:\Program~1\Docume~1\CTS/docbases/docbase2_name_here/config/temp_sessions"/>
<!-- change the mediaServerName to match with the repository name -->
<CTSServer AttributeName="mediaServerName" AttributeValue=
"HostName_docbase2_name_here_"/>
<CTSServer AttributeName="sysOpUserName" AttributeValue="dmadmin"/>
<CTSServer AttributeName="maxQueueItemsToSignOff" AttributeValue="5"/>
<CTSServer AttributeName="maxQueueItemAge" AttributeValue="1m"/>
<CTSServer AttributeName="processLocalContentOnly" AttributeValue=""/>
<CTSServer AttributeName="queueProcessor" AttributeValue=
"com.documentum.cts.impl.services.ctsserver.CTSQueueProcessor"/>
<CTSServer AttributeName="notifySuccessMessage" AttributeValue="Yes"/>
<CTSServer AttributeName="notifyFailureMessage" AttributeValue="Yes"/>
<CTSServer AttributeName="ctsRefreshQueueItemName" AttributeValue=
"cts_info_change"/>
<CTSServer AttributeName="ignoreKeywordName" AttributeValue=
"ignore_cts_processing"/>
<CTSServer AttributeName="thresholdForQueueItemsToSignOff" AttributeValue="2"/>
<CTSServer AttributeName="ignoreItemsToSignOffLimit" AttributeValue="NO"/>
<CTSServer AttributeName="markerInterval" AttributeValue="20"/>
<CTSServer AttributeName="track_cts_response" AttributeValue="NO"/>
<CTSServer AttributeName="networkLocationId" AttributeValue=""/>
<CTSServer AttributeName="allowBocsTransfer" AttributeValue=""/>
<CTSServer AttributeName="preferAcsTransfer" AttributeValue=""/>
<CTSServer AttributeName="allowSurrogateTransfer" AttributeValue=""/>
</QueueProcessorContext>
<QueueProcessorContext DocbaseName="docbase2">
<CTSServer AttributeName="queueItemName" AttributeValue=
"dm_autorender_win31"/>
<CTSServer AttributeName="queueInterval" AttributeValue="10"/>
<CTSServer AttributeName="maxThreads" AttributeValue="10"/>
<!-- change the location of tempFileDir to match with the repository name -->
<CTSServer AttributeName="tempFileDir" AttributeValue=
"C:\Program~1\Docume~1\CTS/docbases/docbase2_name_here/config/temp_sessions"/>
<!-- change the mediaServerName to match with the repository name -->
<CTSServer AttributeName="mediaServerName" AttributeValue=
"HostName_docbase2_name_here_"/>
<CTSServer AttributeName="sysOpUserName" AttributeValue="dmadmin"/>
<CTSServer AttributeName="maxQueueItemsToSignOff" AttributeValue="5"/>
<CTSServer AttributeName="maxQueueItemAge" AttributeValue="1m"/>
<CTSServer AttributeName="processLocalContentOnly" AttributeValue=""/>
<CTSServer AttributeName="queueProcessor" AttributeValue=
"com.documentum.cts.impl.services.ctsserver.CTSLegacyQueueProcessor"/>
<CTSServer AttributeName="legacyTaskProcessor" AttributeValue=
"com.documentum.cts.impl.services.task.legacycalls.LegacyCallProcessor"/>
<CTSServer AttributeName="aaesProfilePath" AttributeValue=
"/System/Media Server/Command Line Files/aes_legacy_calls.xml"/>
<CTSServer AttributeName="bgProfilePath" AttributeValue=
"/System/Media Server/Command Line Files/background_legacy_calls.xml"/>
<CTSServer AttributeName="customProfilePath" AttributeValue=
"/System/Media Server/Command Line Files/custom_legacy_calls.xml"/>
<CTSServer AttributeName="notifySuccessMessage" AttributeValue="Yes"/>
<CTSServer AttributeName="notifyFailureMessage" AttributeValue="Yes"/>
<CTSServer AttributeName="ctsRefreshQueueItemName" AttributeValue=
"cts_info_change"/>
<CTSServer AttributeName="ignoreKeywordName" AttributeValue=
"ignore_cts_processing"/>
<CTSServer AttributeName="thresholdForQueueItemsToSignOff" AttributeValue="2"/>
<CTSServer AttributeName="ignoreItemsToSignOffLimit" AttributeValue="NO"/>
<CTSServer AttributeName="markerInterval" AttributeValue="20"/>
<CTSServer AttributeName="track_cts_response" AttributeValue="NO"/>
</QueueProcessorContext>
c. Create an mspassword2.txt file with the repository password and place it at the location
indicated above.
d. Repeat Step b and Step c for any additional repositories.
e. Save your changes.
CTS troubleshooting
This section contains troubleshooting guidance relating to:
• Thumbnails not being generated, page 34
• Resolving CTS hanging issue, page 35
• Avoiding pop-up issues, page 35
This chapter describes the CenterStage configuration file and describes how to set CenterStage
application options that apply to all CenterStage users. You set system-wide options through
Documentum Administrator (DA), which is installed with CenterStage. DA runs in a web browser.
To access DA, you must have the URL of your organization’s DA installation and a username and
password.
This chapter describes the following:
• Customize the sign-in dialog box, page 37
• Notify users of preferred browsers, page 38
• Customize the product name, page 39
• Set languages, page 39
• Set the session length, page 40
• Set the frequency of subscription updates, page 40
• Allow users to install CenterStage plug-ins, page 41
• Disable entity extraction, page 42
• Improve search performance by customizing the format filter, page 43
b. Set the xml:lang attribute to the locale for which the disclaimer text applies.
c. Delete the comment <!-- put your disclaimer text here -->. In its place type
the disclaimer text.
d. To add a disclaimer for another language, paste a new copy of the <disclaimer> tag set and
repeat steps b and c.
6. Save app.xml.
3. To format the new alert/instruction, configure the kw.css file. Continuing the example for
Internet Explorer 6 users, add the following code to the end of the stylesheet:
.login-custom-help-panel-ie6,
.ext-ie6 .login-custom-help,
.ext-ie6 .login-custom-help-instr {
display: none;
}
.ext-ie6 .login-custom-help-panel-ie6 {
display: block;
color: #ff0000;
font: normal 10px tahoma;
}
• If you are using a JBOSS application server (used in single-server installation), modify kw.css
in one of the following locations:
— For a CenterStage Pro machine using JBOSS, modify kw.css
here: %documentum%\jboss4.2.0\server\DctmServer_
MethodServer\deploy\CenterStagePro.war\
js\kw\css\kw.css
— For a CenterStage Essentials machine using JBOSS, modify kw.
css here: %documentum%\jboss4.2.0\server\DctmServer_
MethodServer\deploy\CenterStage.war\
js\kw\css\kw.css
• If you are not using a JBOSS application server, perform the following steps to modify kw.css:
1. Stop the application server.
2. Delete the application server temp files.
3. Update kw.css in either CenterStage.war or CenterStagePro.war, as appropriate
(found here: js\kw\css\kw.css), and save it back in the WAR file, which is actually
a ZIP file.
4. Redeploy the modified WAR file.
5. Restart the application server.
Set languages
You can view the list of supported languages in your CenterStage installation, and you can add
languages to the list.
3. Save app.xml.
To set how long CenterStage waits before ending an inactive user’s session:
1. Open the CenterStage WAR file.
2. Open the local-dfs-runtime.properties file, located in the WEB-INF\classes directory.
3. Set the following option to the number of minutes before CenterStage signs out an inactive user.
Do so by replacing the value of 240 in this example with the appropriate number of minutes:
dfs.crs.cache_expiration_after_x_minutes=240
Job Description
CenterStage Email Notification This job is used when a user selects to receive change notices
every time a subscribed item is updated. This job sends a
separate email for every item changed. By default, this job runs
every 15 minutes.
Daily CenterStage Email This job is used when a user selects daily updates. By default,
Notification this job runs Sunday through Friday at 2 A.M., according to the
user’s local time. This is the default option for the end user.
Weekly CenterStage Email This job is used when a user selects weekly updates. By default,
Notification this job runs every Thursday at 2 A.M., according to user’s local
time.
Plug-in Description
UCF (Unified Client Facilities) This is available for both Mac and Windows operating systems.
content-transfer Java applet This plug-in provides UCF content transfer as an alternative to
HTTP content transfer. UCF content transfer lets users access
files from CenterStage as though from their own desktop.
CenterStage keeps track of the user’s downloaded files and
prevents accidental duplication of downloaded files.
The copy-and-paste ActiveX This allows Windows users to use the Windows clipboard with
control CenterStage.
3. Save app.xml.
To ignore a format:
1. In DA, open the DQL editor.
2. Run the following DQL query to get the list of available formats in the repository:
SELECT name, mime_type, description FROM dm_format WHERE NOT ANY
format_class='kw_ignore' ORDER BY name
To restore a format:
1. In DA, open the DQL editor.
2. Run the following DQL query:
UPDATE dm_format OBJECTS REMOVE format_class[0] where "name" = 'xyz'
where xyz is the format to ignore.
Index [0] is used if there was no value already set for the repeating attribute format_class.
Otherwise, check for the right index.
3. Restart the application server to clean the cache of the formats table.
The procedures to manage CenterStage spaces are found in CenterStage Help. This chapter lists
the commonly used tasks that administrators perform to manage spaces. For the procedures, see
CenterStage Help.
This chapter also provides overviews of CenterStage concepts related to space management. For
overviews of all CenterStage concepts, see the CenterStage Overview Guide.
This chapter provides the following:
• Common space management tasks, page 45
• Understanding the CenterStage containment hierarchy, page 46
• Understanding spaces, page 46
• Understanding users and permissions, page 47
• Understanding templates, page 50
• Activate templates
Understanding spaces
A space is a CenterStage location created for a specific goal. Members achieve the goal through
creating and sharing content and information. Each space has a set of policies that define such
parameters as security, versioning, and notification. A space can also be subject to retention policies
managed through the Retention Policy Administration client. A space’s membership is either open
to all the repository’s users or restricted to specific users by invitation only. Each space member is
assigned a user role that defines the user’s access to content and actions. Users with the appropriate
permissions can create new spaces within a repository and can save existing spaces as new space
templates.
Once users are logged in, they can navigate to spaces. Spaces open as tabbed panels in CenterStage
and can be either public or private, as described in Table 9, page 47.
Note: Super users can always access private spaces, even if they are not members of a space.
CenterStage permission level Documentum permission What you can do with this
level right
None (only for the space’s ACL) None Nothing; cannot see the object
Read Read Can:
• View an item (including
opening a file for viewing)
• Open a folder
• Create comments
(optionally, and can be
different for individual
ACLs)
Cannot:
• Create items
CenterStage permission
CenterStage role Public Space Private Space
Participant Edit Edit
Coordinator Edit (plus special coordinator Edit (plus special coordinator
rights*) rights*)
Content Owner Delete plus Change Ownership Delete plus Change Ownership
New custom roles Edit Edit
* Regardless of the Coordinator role’s permission level, it always has these extended permissions:
• Extended Delete
• DCTM Browse permission (to let the coordinator see an item, even if the role group is removed
from an item’s ACL)
• Change Owner
• Change Permissions
• Change Location
• Change State
• Change Folder Links
In addition, coordinators can always manage members and create/delete custom roles.
Understanding templates
CenterStage includes a starter set of templates which are described in Table 12, page 50.
This chapter describes how to deploy templates from a staging environment to the CenterStage
repository. Templates provide users a way to create new spaces and pages with pre-existing
components.
To deploy a template, you use Documentum Composer 6.5 SP2. Obtain the CenterStage reference
project (available with the CenterStage SDK on the EMC Developer Network website) and unzip the
CenterStage reference project in your Composer workspace. The instructions in this chapter assume
a knowledge of Documentum Composer; for more information, see the Documentum Composer 6.5
User Guide.
To deploy a template:
1. Use Documentum Composer to create a project that meets all of the following conditions:
• References the CenterStage reference project
• Contains the template
• Defines all the object types referenced in the template
2. Use Documentum Composer to select the template artifacts and any other artifacts from the
repository to import into the new project.
3. Perform the import.
Documentum Composer imports the template artifact under SysObjects.
4. Edit the install properties of each template to use the appropriate ACL (defined in the CenterStage
reference project) and install path (the default is the one that CenterStage expects).
Install the Composer project to one of the following locations in the target repository and assign
the specified ACL:
• For a space template, assign the dmc_kw_space_templates_acl ACL and install to /Templates /
Spaces.
• For a content template, assign the dmc_kw_content_templates_acl ACL and install to one of
the following:
— / Templates / Sections
— / Templates / Pages
5. In your workspace, the CenterStage.dar and your project DAR must be in the same
sub-directory.
6. Use Composer’s darinstaller.exe to deploy your project DAR to the new repository.
This appendix describes some best practices for creating a community of spaces to achieve a business
solution.
In this appendix, the term community means a group of spaces created for a common business
solution. This differs from the term’s meaning in the CenterStage interface, where My Community
means all the spaces on the CenterStage site.
The challenge
Scratch Bonnet Software International is stuck in a rut. Discrete business units are pursuing product
lines and marketing solutions that make a certain amount of sense when taken in isolation, but they
are creating conflict and redundancy when taken as a whole.
Donald Canard, an inhouse business expert, pulled together a cross-functional team including
engineers, technical writers, user support, and product management to address these issues.
These are the issues and opportunities facing Scratch Bonnet Software.
Issues Opportunities
The Challenge Cross-team collaboration is low. There is an air of mistrust between
working groups and little opportunity for interaction.
The Theme Pull various product groups together as a team to advance enterprise goals.
Issues Opportunities
The Objectives • Foster new ideas for cross-product collaboration
The setup
Donald creates a community for idea development and invites key people from within the
organization — those with expertise, with innovative strengths, and with authority to launch new
projects — and from without, including key customers and suppliers.
Donald works with the architects to assign areas of interest and expertise. Knowing that it is
important to keep the number of spaces and topics small at the outset, Donald suggests three
key initiatives on which to focus: Miguel Raton takes on rapid deployment, Horace Pferdkragen
volunteers to champion mobile applications, and Manfred Wunderhund signs up to tackle
cross-product efficiencies.
Donald defines the following roles and access rights for the Initiative spaces.
When inviting outsiders, Donald protects inhouse information by restricting access on all sensitive
documents and discussion threads. Consumers can read the public CenterStage information and
comment on it, but they cannot edit original information posted by internal sources.
Although Donald was the instigator of the Initiatives site, most successful communities have Space
coordinators, two or three managers who divide responsibilities and who have a vested interest in
making spaces successful. Donald asks Miguel, Horace, and Manfred to assume these roles.
Space coordinators do the following:
• Create spaces and templates
• Set rules and best practices
• Encourage participation and keep conversations on track
• Brainstorm and solicit new ideas for growth
• Update the site
• Answer technical questions
The Advocates and Builders in the community are Content providers who drive the community’s
conversations. They ask the questions that get people talking. Both they and the Architects can also
act as subject matter experts to provide authoritative voices on specific topics.
Each of the spaces will start with the same essential elements:
• An architect’s blog
• A discussion area
• A wiki for collaboration
• Collateral folders for static information
Rather than recreate the spaces for each initiative, Donald creates one generic space with these
elements, and saves it as a template named Initiative.
In the template, Donald creates the roles and sets permissions for each element in the space. These
settings are carried forward into each of the new spaces. The one change that Donald introduces into
the template is to set the permission for Consumers to None. Architects, Builders, and Advocates will
have the opportunity to create content and populate their discussions, wikis, blogs, and collateral
folders. When the space information reaches critical mass, the Architects change the permissions
setting for Consumers in their space to Read.
Create spaces
Based on the Initiative template, he and the Architects create four initial spaces: Rapid Deployment,
Mobile Applications, Cross-product Efficiency, and a Synergy space that consolidates common
themes and provides a feedback mechanism for the initiative spaces overall.
Create wikis
At the heart of each of the spaces is a wiki, where participants write, challenge, and defend proofs
of concept for products. Each wiki is allowed to grow “organically,” based on the interests and
contributions of the Architect, Advocates, and Builders.
Specific sections in each wiki have individuals who are responsible for maintaining the content.
Builders and Advocates take ownership of elements of the overall initiative, effectively becoming
architects in their own areas. Each member understands that the area is theirs to update and maintain,
and time and resources are allocated to ensure that the information is current.
Special attention is paid to the titles of the wiki pages, to make sure that they are meaningful and
give a clear indication of the page content. Page titles appear in a number of places, including lists of
new and updated files, and can generate a good deal of interest.
Donald cautions contributors to avoid posting questions in wikis: readers are more likely to respond
to a post with useful content and alternative ideas.
Create blogs
Horace, Miguel, and Manfred, as team leads, all have their own blogs where they are able to wax
philosophical about their product initiatives, goals, potential solutions, or anything else they feel will
be of interest to their collaborators.
They know their audience is composed of “clued-in” people who are familiar with the technologies in
play but not necessarily the details of the inner workings. It is important to define jargon the first
time the words appear on the blog, and potentially more than once. Liberal use of external links to
online references reduces redundancy.
All three leads understand the importance of continual updates to their respective blogs. While no
one should speak unless there is something useful to say, successful blogs are continually updated
with new information. For Miguel and Manfred, this translates into daily updates of about a
paragraph of material. Horace is more likely to update once or twice weekly, but with longer posts.
While the blogs are conversational in tone, everyone is well aware that the opinions they publish
can exert influence on others and create controversy. The personality of each of the architects comes
through, which helps to engage readers and get them to join in with equally conversational comments.
Create discussions
In the Synergy space, Donald and the Architects start the first few discussion threads, proposing
solutions to specific problems to get conversations started. They reply to each other’s proposals in a
sincere, productive, and provocative way. It is important not to sound forced or false when starting
discussions: potential contributors will shy away.
Content folders are used to organize static information in CenterStage. Each of the spaces has a folder
named Collateral that organizes background information for each of the initiatives. In the Collateral
folder are the folders White papers, Product specifications, and Product documentation.
In order to encourage participation and stimulate ideas, Donald, Miguel, Horace, and Manfred
upload complete, up-to-date, useful collateral information for their areas. By posting or linking the
latest and greatest versions of supporting documents, the new CenterStage implementation quickly
becomes the best “source of truth” for all participants. Having a “one-stop shop” where users can
find the answers they need will quickly make the site indispensable.
Next, Advocates and Builders are invited to augment the existing information, comment on blog
entries, and respond to discussion questions. They add relevant links within content to add value for
readers, including links to content in other spaces or to external sources.
The kickoff
When the team agrees that the site has sufficient content to generate interest and provide useful
information, the Architects change the permissions setting for Consumers from None to Read,
and the site is live.
Donald and the team invite members to join the spaces. As a way to get the conversation going, they
ask the new members to share their thoughts on the initial content. This gives the new members a
task that gets them involved in the site immediately, and results in some useful feedback as the
site gets rolling.
Donald, Miguel, Horace, and Manfred monitor the community over time to see which types of pages
best suit the users’ preferred ways to communicate. Pages that draw few hits are deleted.
Members use filters and advanced searches to find new subject matter experts and new relevant
information. Content contributors are encouraged to use tags as an alternative way of organizing
information, creating tag clouds of topics that appear most frequently.
Individuals maintain their areas of ownership, continually adding and updating information, but
also culling pages that are outdated or no longer part of the active project. Archiving and deleting
information that is no longer of interest to users improves performance, and helps to ensure that users
always get current data as a result of their searches.
Given that the point of the site is to generate interaction, the team leads are conscientious about
checking in with the community several times a day, reading the boards, and responding quickly to
keep the conversation lively and encourage participants to return frequently to follow the thread.
When someone posts new content that is of high interest, Donald or one of the Architects will send an
email with a link to the content, including new members or infrequent participants on the recipient
list, and ask for their feedback.
To measure community success, Donald uses tools such as CenterStage reporting services to run
reports on usage and activity within the community. He uses metrics such as levels of participation
and engagement, page views, and blog replies to gauge which areas are most effective and which
need more attention or should be removed. Measuring community success helps him to maximize
the return on investment.
The payoff
Over time, cultivation of the information and ideas allows the community to grow and change
according to business needs. As participants get comfortable with new ways of interacting, the
department or contributor who proposes a solution becomes less important than the collaborative
process that brings it to market. Data Darwinism allows the most productive threads to thrive and
grow, while less interesting discussions and wiki pages wither and die.
Donald is pleased to see the Architects, Builders, Advocates, and Consumers working together
as a single community, including several smaller communities-within-the-community, no longer
separated by job title, physical location, or functional area.
Comment
Purpose
Records a comment in a discussion, blog, wiki, folder, or in relation to a content file.
Description
Supertype: Richtext
Subtypes: None
Internal name: dmc_comment
Object type tag: 08
A comment object represents a single comment in a discussion.
Properties
Table 15, page 62 lists the properties defined for the type.
Discussion
Purpose
Contains one or more topics or topic subtypes.
Description
Supertype: Folder
Subtypes: None
Internal name: dmc_discussion
Object type tag: 0b
A discussion object serves as the container for topics relating to a particular discussion. Only objects
of type dm_topic or its subtypes may be linked to a discussion.
Properties
The discussion object type has no properties defined for the type. It inherits all its properties from its
supertype.
Room
Purpose
Provides an additional access management layer for SysObjects.
Description
Supertype: Folder
Subtypes: None
Internal name: dmc_room
Object type tag: 0b
A room is a special folder that provides additional, optional functionality to control access to the
objects in the folder when the objects are accessed through the room.
Properties
Table 16, page 64 lists the properties defined for the type.
[0]=Members
[1]=Owners
[2]=Contributors
[3]=Visitors
default_contrib_ integer S Default base object-level
permit permission for the contributor’s
group applied to objects governed
by this room.
default_contrib_ string(32) S Default extended permission for
xpermit the contributor’s group applied to
objects governed by this room.
default_owner_permit integer S Default base object-level
permission for the owner’s
group applied to objects governed
by this room.
Topic
Purpose
Used to manage a single discussion.
Description
Supertype: Folder
Subtypes: None
Internal name: dmc_topic
Object type tag: 0b
A topic object is used to manage a discussion thread—the set of comments about a single topic.
Properties
Table 17, page 66 lists the properties defined for the type.
Blog
Purpose
Used to manage weblog activities.
Description
Supertype: Folder
Subtypes: None
Internal name: dmc_kw_blog
Object type tag: 0b
A blog object is used to manage weblog activities. It is a specialized type of CenterStage section.
Properties
No non-inherited attributes.
Blog entry
Purpose
A special object type is used to store the individual entries that go into a blog archive.
Description
Supertype: Folder
Subtypes: None
Internal name: dmc_blog
Object type tag: 0b
A special object type that is used to store the individual entries that go into a blog archive.
Properties
No non-inherited attributes.
Preference set
Purpose
Used to manage CenterStage preferences.
Description
Supertype: dm_relation
Subtypes: None
Internal name: dmc_kw_preference_set
Object type tag: 0b
Used to manage CenterStage preferences.
Properties
Table 18, page 69 lists the properties defined for the type.
Purpose
Represents the home page of a CenterStage space.
Description
Supertype: Folder
Subtypes: None
Internal name: dmc_kw_space_home_page
Object type tag: 0b
Represents the home page of a CenterStage space.
Properties
No non-inherited attributes.
Template
Purpose
Defines a CenterStage template.
Description
Supertype: dm_sysobject
Subtypes: None
Internal name: dm_kw_template
Object type tag: 0b
Defines a CenterStage template.
Properties
Table 19, page 71 lists the properties defined for the type.
A managers, 55
Active X, configuring, 41 configuring
ADTS supported locales, 39
configuring for CenterStage, 22 users, 13
configuring full-screen preview, 24 content
enlarging thumbnails, 26 templates, 51
image support in CenterStage, 21 content analytics. See filters
registering formats for renditions, 23 Content Intelligence Services. See filters
using with CenterStage, 21 documentation, 7
Advanced Document Transformation content providers, defined, 55
Services. See ADTS Content Transformation Services. See CTS
app.xml CTS
settings in CIS, 42 configuring, 21
settings in DA, 24, 27, 37 to 40, 42 troubleshooting, 34
authentication, configuring, 40
D
B dce_room_creator role, 13
best practices for community building, 53 dce_user_manager role, 13
blog entry object type, 68 digests of changes, sending by email, 40
blog object type, 67 discussion object type, 63
blogs discussions
dmc_blog type, 68 dmc_comment type, 62
dmc_kw_blog type, 67 dmc_topic type, 66
dm_kw_template type, 71
dmc_blog type, 68
C dmc_comment type, 62
CenterStage dmc_discussion type, 63
case study, 53 dmc_kw_blog type, 67
hierarchy, 46 dmc_kw_manage_space_templates
object typesd, 61 role, 14
overview guide, 7 dmc_kw_preference_set type, 69
summary of administrative tasks, 9 dmc_kw_space_home_page type, 70
system configuration, 37 dmc_room type, 64
changing thumbnail size in ADTS, 26 dmc_topic type, 66
changing thumbnail size in MTS, 29 documentation, additional guides, 7
CIS. See filters Documentum Administrator
clipboard, enabling, 41 configuring CenterStage with, 11 to 12,
comment object type, 62 24, 27, 37 to 42
communities creating users, 11
guidelines, 53 disabling entity extraction, 42