You are on page 1of 1807

EMC® Documentum®

Web Development Kit and Webtop


Version 6.5

Reference Guide
P/N 300­007­233 A01

EMC Corporation
Corporate Headquarters:
Hopkinton, MA 01748‑9103
1‑508‑435‑1000
www.EMC.com
Copyright © 2002 ‑ 2008 EMC Corporation. All rights reserved.
Published July 2008
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 ................................................................................................................................ 11
Chapter 1 Controls Reference ..................................................................................... 13
Common control attributes ........................................................................... 13
Event attributes ............................................................................................ 15
Action attributes ........................................................................................... 15
Dynamic action attribute values .................................................................... 16
Runtime tag attribute override ...................................................................... 17
Actions ............................................................................................................ 18
Attributes ........................................................................................................ 36
Client browser detection ................................................................................... 61
Collaboration ................................................................................................... 64
Context ............................................................................................................ 95
Data display ..................................................................................................... 96
Data validation ............................................................................................... 136
Date/time ....................................................................................................... 160
Deprecated controls ........................................................................................ 168
Drag and drop................................................................................................ 168
Explorer ......................................................................................................... 172
Framework .................................................................................................... 172
Generating client and server events ................................................................. 174
Grouping user interface elements .................................................................... 178
HTML ........................................................................................................... 189
Document Image Services ............................................................................... 227
Including components .................................................................................... 238
Including other pages ..................................................................................... 239
Internal use only............................................................................................. 242
Links ............................................................................................................. 243
Media and transformation ............................................................................... 249
Menu grouping .............................................................................................. 253
Navigational aids ........................................................................................... 261
Object and file selection .................................................................................. 270
Output formatting .......................................................................................... 275
Passing arguments .......................................................................................... 288
Passwords ...................................................................................................... 290
Preferences..................................................................................................... 292
Repositories ................................................................................................... 301
Search ............................................................................................................ 315

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 3
Table of Contents

Text display and input .................................................................................... 348


Trees .............................................................................................................. 355
User feedback................................................................................................. 361
Virtual documents .......................................................................................... 368
Web Workflow Manager ................................................................................. 372
Workflow ....................................................................................................... 373
xForms .......................................................................................................... 379

Chapter 2 Actions Reference ..................................................................................... 381


Overview ....................................................................................................... 381
Common elements .......................................................................................... 381
failoverenabled........................................................................................... 381
invocation .................................................................................................. 381
reverse‑precondition ................................................................................... 382
Application connectors ................................................................................... 382
Application management ................................................................................ 387
Attributes ...................................................................................................... 394
Cabinets and folders ....................................................................................... 411
Categories ...................................................................................................... 415
Clipboard operations ...................................................................................... 416
Collaboration ................................................................................................. 424
Creating objects .............................................................................................. 461
Data export .................................................................................................... 462
Document Imaging Services ............................................................................ 463
Downloading and uploading content ............................................................... 465
Emailing links to objects.................................................................................. 504
Formats ......................................................................................................... 508
General user interface ..................................................................................... 509
Jobs ............................................................................................................... 512
Lifecycles ....................................................................................................... 515
Locating objects .............................................................................................. 520
Media and transformation ............................................................................... 527
Navigational aids ........................................................................................... 532
Notifications .................................................................................................. 534
Physical Records Manager .............................................................................. 537
Preferences..................................................................................................... 541
Presets ........................................................................................................... 544
Records Manager............................................................................................ 554
Relationships between objects ......................................................................... 559
Renditions...................................................................................................... 561
Replicas and References .................................................................................. 569
Repository ..................................................................................................... 570
Search ............................................................................................................ 573
Security ......................................................................................................... 601

4 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Table of Contents

Subscriptions ................................................................................................. 619


Testing ........................................................................................................... 622
User feedback................................................................................................. 630
Users, groups, and roles .................................................................................. 631
Virtual documents .......................................................................................... 658
Workflows ..................................................................................................... 693
Work queue management ............................................................................... 758
XForms .......................................................................................................... 804

Chapter 3 Components Reference ............................................................................. 809


Overview ....................................................................................................... 809
Common elements .......................................................................................... 809
actiontable ................................................................................................. 809
allversionsvisible ........................................................................................ 809
asynchronous ............................................................................................. 809
attributes ................................................................................................... 810
autogettaskdefault ...................................................................................... 810
base_type ................................................................................................... 810
bindingcomponentversion .......................................................................... 810
breadcrumbiconwellmode........................................................................... 810
cabinets...................................................................................................... 811
category ..................................................................................................... 811
clientevent ................................................................................................. 811
columns (for data columns) ......................................................................... 811
columns (for streamline view) ..................................................................... 811
columns_list ............................................................................................... 812
columns_all_saved_searches ....................................................................... 812
columns_my_saved_searches ...................................................................... 813
columns_saved_search ................................................................................ 813
comments .................................................................................................. 814
commitorder .............................................................................................. 814
containerselectable ..................................................................................... 814
contenttypepanelvisible .............................................................................. 815
cost_attribute_conditions ............................................................................ 815
default_binding_filter_values ...................................................................... 815
default_type ............................................................................................... 815
defaultaccounts .......................................................................................... 816
defaultsources ............................................................................................ 816
defaultview ................................................................................................ 816
displayresultspath ...................................................................................... 817
docbase‑type‑mappings .............................................................................. 817
document‑docbase‑base‑type ...................................................................... 817
document‑docbase‑type .............................................................................. 817
document_filter .......................................................................................... 817
dragdrop ................................................................................................... 818
duration_attribute_conditions ..................................................................... 818
enableShowAll ........................................................................................... 819
entrypage................................................................................................... 819
failoverenabled........................................................................................... 819
filenamefiltervisible .................................................................................... 819
filter .......................................................................................................... 820
flatlist ........................................................................................................ 820
folder‑docbase‑type .................................................................................... 820
folder_filter ................................................................................................ 820
formsavefolderpath .................................................................................... 820

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 5
Table of Contents

header ....................................................................................................... 821


help‑entries ................................................................................................ 821
helppath .................................................................................................... 821
hideEvents ................................................................................................. 821
highlight_matching_terms .......................................................................... 822
homeURL .................................................................................................. 822
homecabinet ............................................................................................... 822
iconwell_icon ............................................................................................. 822
inbox ......................................................................................................... 822
includetypes............................................................................................... 822
includeunlisted .......................................................................................... 823
init‑controls................................................................................................ 823
isIgnorePrefRenditions ............................................................................... 823
locator ....................................................................................................... 824
lockInstance ............................................................................................... 824
map ........................................................................................................... 824
maxidletime ............................................................................................... 824
menugrouptarget ....................................................................................... 824
modifiedwithindays ................................................................................... 825
multidocbasesupport .................................................................................. 825
myobjects ................................................................................................... 825
navigationlinks........................................................................................... 825
newcomponentname .................................................................................. 825
nodes ......................................................................................................... 825
nomaclsupport ........................................................................................... 826
nondocbasecolumns ................................................................................... 826
numberedtabs ............................................................................................ 827
objectfilters ................................................................................................ 827
pageTitle .................................................................................................... 827
permissionsservice ..................................................................................... 828
preferencedisplaygroups ............................................................................. 828
preferences................................................................................................. 828
preserve‑file‑extension ................................................................................ 829
preset_item ................................................................................................ 830
preset_item_definition ................................................................................ 831
preset_scope_definitions ............................................................................. 831
privatecabinet_visible ................................................................................. 831
privatecabinetvisible ................................................................................... 832
privategroupvisible .................................................................................... 832
readOnly.................................................................................................... 832
savedetailsreport ........................................................................................ 832
search_types .............................................................................................. 832
searchtypes ................................................................................................ 833
selectedattribute ......................................................................................... 833
serveroptionenabled ................................................................................... 834
service ....................................................................................................... 834
setrepositoryfromobjectid ........................................................................... 834
showattachmentinfo ................................................................................... 834
showautogettask ........................................................................................ 834
showbreadcrumb ....................................................................................... 835
showfilters ................................................................................................. 835
showfolderpath .......................................................................................... 835
showfolders ............................................................................................... 835
showheaderforsinglepackage ...................................................................... 835
showjobstatus ............................................................................................ 835
showoptions............................................................................................... 836
showpagesastabs ........................................................................................ 836
showusertimeandcost ................................................................................. 836
skipVersionCheck ....................................................................................... 836

6 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Table of Contents

startComp .................................................................................................. 836


startQueryString ......................................................................................... 836
subscriptions .............................................................................................. 837
taskmgractionname .................................................................................... 837
taskmanagerid ........................................................................................... 837
transformation ........................................................................................... 837
type ........................................................................................................... 837
ucfrequired ................................................................................................ 838
updatereplicasource ................................................................................... 838
useronly..................................................................................................... 838
useroptions ................................................................................................ 838
views ......................................................................................................... 839
windowparams .......................................................................................... 840
workflowstatusactionname ......................................................................... 841
workqueuegroupvisible .............................................................................. 841
Actions .......................................................................................................... 841
Administration ............................................................................................... 842
Application connectors ................................................................................... 844
Application management ................................................................................ 880
Attributes ...................................................................................................... 910
Cabinets and folders ....................................................................................... 947
Categories ...................................................................................................... 958
Clipboard operations ...................................................................................... 976
Collaboration ................................................................................................. 979
Creating objects ............................................................................................ 1059
Data import and export ................................................................................. 1064
Displaying lists of objects .............................................................................. 1067
Displaying lists of objects associated with an object......................................... 1095
Document Imaging Services .......................................................................... 1098
Downloading and uploading content ............................................................. 1107
Emailing object links ..................................................................................... 1172
Formats ....................................................................................................... 1178
General user interface ................................................................................... 1183
Helpers ........................................................................................................ 1203
Home Cabinet .............................................................................................. 1205
Inbox ........................................................................................................... 1216
Jobs ............................................................................................................. 1220
Lifecycles ..................................................................................................... 1224
Locating objects ............................................................................................ 1235
Media and transformation ............................................................................. 1236
Menus ......................................................................................................... 1247
Message archives .......................................................................................... 1249
My Files ....................................................................................................... 1250
Physical Records Manager ............................................................................ 1258
Preferences................................................................................................... 1266
Presets ......................................................................................................... 1282
Records Manager.......................................................................................... 1308

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 7
Table of Contents

Relationships between objects ....................................................................... 1341


Renditions.................................................................................................... 1345
Repository ................................................................................................... 1347
Retention Policy Services............................................................................... 1352
Search .......................................................................................................... 1354
Security ....................................................................................................... 1396
Subscriptions ............................................................................................... 1418
Task manager ............................................................................................... 1429
Testing ......................................................................................................... 1431
Trees ............................................................................................................ 1476
User feedback............................................................................................... 1482
Users, groups, and roles ................................................................................ 1496
Virtual document assemblies ......................................................................... 1534
Virtual documents ........................................................................................ 1542
Workflow reporting ...................................................................................... 1567
Workflows ................................................................................................... 1599
Work queue management ............................................................................. 1690
XForms ........................................................................................................ 1754

Appendix A Version 6.0: New Controls, Actions, and Components ............................ 1771
Controls ....................................................................................................... 1771
Actions ........................................................................................................ 1772
Components................................................................................................. 1774

Appendix B Version 6.0 SP1: New Controls, Actions, and Components .................... 1779
Controls ....................................................................................................... 1779
Actions ........................................................................................................ 1779
Components................................................................................................. 1779

Appendix C Version 6.5: New Controls, Actions, and Components ............................ 1781
Controls ....................................................................................................... 1781
Actions ........................................................................................................ 1781
Components................................................................................................. 1781

Appendix D Removed and Deprecated Controls, Actions, and Components ............. 1785
Removed in 6.0 ............................................................................................. 1785
columns_drilldown ...................................................................................... 1787
Removed in 6.5 ............................................................................................. 1788
Controls ................................................................................................... 1788
Actions .................................................................................................... 1788
Components............................................................................................. 1788

8 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Table of Contents

List of Figures

Figure 1. In‑progress real‑time search monitoring ............................................................. 1384


Figure 2. Completed real‑time search monitoring ............................................................. 1385

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 9
Table of Contents

List of Tables

Table 1. Common control attributes ................................................................................... 13


Table 2. Event attributes .................................................................................................... 15
Table 3. Common action control attributes .......................................................................... 16
Table 4. Rich text configuration elements ............................................................................ 78
Table 5. Rich text configuration elements ............................................................................ 83
Table 6. Rich text editor configuration elements (<editor>) ................................................... 84
Table 7. Row selection settings ......................................................................................... 105
Table 8. Valid Mask Characters ........................................................................................ 147
Table 9. Global date input control configuration elements.................................................. 162
Table 10. Global datetime control configuration elements .................................................... 166
Table 11. Global datetime control configuration elements .................................................... 168
Table 12. Image Viewer Control Parameters ....................................................................... 234

10 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Preface

This reference manual is part of the documentation set for the Documentum Web Development Kit
(WDK) and Webtop. Other materials related to WDK are:
• Web Development Kit Development Guide
• Webtop Development Guide
• Web Development Kit and Applications Tutorial
• Javadocs for WDK, Webtop, and Documentum Foundation Classes (DFC)
The Documentum developer Web site, developer.documentum.com, provides sample code, tips, white
papers, and a wealth of information to assist you in developing Documentum‑enabled applications.
This guide is intended for two tasks:
• Configuration
Changes to XML files or modifications of JSP pages to configure controls on the page. Does not
require a developer license.
• Customization
Extending WDK classes or modifying the JSP pages to include new functionality. Requires
a developer license.

Revision history
The following changes have been made to this document:

Revision Date Description


July 2008 Initial release for Documentum 6.5.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 11
Preface

12 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Chapter 1
Controls Reference
Overview
Controls are grouped according to how they are used.
The configurable attributes for WDK controls are documented in this section. Control attributes are
configured in the JSP page. For examples of the usage and configuration of the individual WDK, see the
JSP pages in the WDK and WDK client products such as Webtop and Web Publisher. For information
about controls specific to a WDK client product, see the development guide for that product.
The following topics describe attributes that are common to groups of controls:
• Common control attributes, page 13
• Event attributes, page 15
• Action attributes, page 15
• Dynamic action attribute values, page 16
• Runtime tag attribute override, page 17

Portlet component controls are documented in WDK for Portlets Development Guide.

Common control attributes


The following attributes are defined by the ControlTag class and can be set on any control. Some of
these attributes may not be used by the tag classes in the rendering of the control, however. For the
exact list of all attributes that are supported by a tag class, see the tag library.
Event attributes such as runatclient, onchange, onselect, or onclick, are documented in Event
attributes, page 15.
The table below describes attributes that are common to most controls. If a common attribute requires
a value for a particular control, that requirement is noted in the control description.

Table 1. Common control attributes

Attribute Description
cssclass Sets the CSS class that is applied to the control.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 13
Controls Reference

Attribute Description
enabled Sets whether the control is enabled.
focus True to allow the control to accept focus.
id ID for the control. The ID is generated by the
framework. You can also set the ID in the JSP
page.
label Contains a string value or <nlsid> element that
maps to a string label that is displayed in the
user interface.
name Sets the name for the control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

nlsid NLS lookup key. The string corresponding to the


NLS ID is substituted for another attribute in the
control. See the individual control descriptions
for the attribute whose value is substituted by
nlsid.
style A CSS rule enclosed in quotation marks, for
example:
style=ʺ{COLOR: darkmagenta; TEXT‑
DECORATION: underline}ʺ
tooltip String displayed when you place the mouse
pointer over this control.
tooltipnlsid NLS key to use when looking up a localized
tooltip string.
tooltipdatafield Datafield that overrides the value of tooltip and
tooltipnlsid.
visible (Boolean) Whether the control is rendered as
visible (True) or hidden (False). Some controls
do not implement visibility.

14 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Controls Reference

Event attributes
Many controls accept user input. The user input is submitted by a control event. The value of the event
attribute corresponds to the name of an event handler. The event is generally handled in the calling
component class unless the control has the runatclient attribute set to true. To find the exact event
attributes that are supported by a control, consult the tag library descriptor (*.tld file) for that control.

Table 2. Event attributes

Attribute Description
onchange Event fired when the use changes the control.
The onchange event handler cannot run on the
client (that is, the runatclient attribute cannot
be true). The onchange event is not handled
immediately. It is handled on the server only
when the form is submitted (for example, by an
onclick event). Some controls do not implement
an onchange event.
onselect Event fired when the user selects the control,
such as an option in a list. This event is handled
immediately on the server (when the runatclient
attribute is false) or on the client (when the
runatclient attribute is true). Some controls do
not implement an onselect event.
runatclient Specifies that the event should run on the client
(True) or the server (False). The onchange event
cannot run on the client. Some controls do not
implement a runatclient attribute.
onclick Event fired when the user clicks the control, such
a button. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true). Some controls do not implement an
onclick event.

Action attributes
The following attributes are common to most Documentum‑enabled action controls. For the full list of
attributes that are valid for a control, see the tag library descriptor that contains the control definition.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 15
Controls Reference

Table 3. Common action control attributes

Attribute Description
action ID of the action to be launched by the control.
This value matches the action id attribute in the
action definition.
showifinvalid Indicates whether, when the configuration
service cannot resolve the action definition:
• (True) the control is displayed as disabled
(grayed out).
• (False) the control is not displayed.

Default is false. A value of true overrides a


visible attribute that is set to false.

To hide all invalid actions in the application, set


the value of <hideinvalidactions> to true in your
custom app.xml file.

showifdisabled Whether, when one or more of the action


preconditions returns false:
• (True) the control is displayed as disabled
(grayed out).
• (False) the control is not displayed.

disabledstyle Entire CSS‑syntax style sheet rule (enclosed in


quotes) to apply to the disabled control.
disabledclass CSS class to apply to the disabled control.
oncomplete Event to be fired when an associated action has
completed. This attribute cannot be used when
the dynamic attribute is set to any value other
than false.

Dynamic action attribute values


The dynamic attribute is used to specify when the action should be launched based on
the conditions of other controls on the page. The JSP page must include the JavaScript file
/wdk/include/dynamicAction.js. The dynamic attribute can have one of the following values:

16 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Controls Reference

Attribute Description
singleselect The action can apply to only one selection or
object.
multiselect The action can apply to more than one selection
or object (only in classic view or objectlist).
generic The action can be launched regardless of
selections by the user. The selections are
essentially ignored.
genericnoselect The action cannot be launched if any items on
the page are selected.
false (Default) The action is not dynamic.

Note: Dynamic action controls do not support the oncomplete attribute.

Runtime tag attribute override


Some attribute values can be overridden by another attribute. This allows the source of a value to
come from the JSP page, a localized set of strings, a datafield, or a value based on user context. For
example, the datafield attribute is commonly used to override a label or value attribute.
The tag value that will be displayed is evaluated at run time. If more than one of the following
attributes are available for a control, the hierarchy of overrides is as follows:
• value or label attribute sets the value
• nlsid overrides the value
• datafield overrides the value and nlsid
• contextvalue overrides the datafield, nlsid, and value

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 17
actionbutton

Actions

actionbutton

Purpose
Generates a button that has an associated action.

Attributes

action (Required) ID of the action to be launched by


this control.
align (Optional) Deprecated in 6.0.6.0: This attribute is
ignored.Pre‑6.0: (Image label only) Alignment of
the label text.
cssclass (Optional) CSS class that is applied to this
control.
datafield (Optional) Overrides the label value with a value
from a data source.
disabledclass (Optional) Deprecated in 6.0. CSS class to apply
to the disabled control.
disabledstyle (Optional) Deprecated in 6.0. Entire CSS‑syntax
style sheet rule (enclosed in quotes) to apply to
the disabled control..
dynamic (Optional) Specifies when the action is to be
launched based on the conditions of other
controls on the JSP. Only false can be specified
for this attribute, if an event is specified for the
oncomplete attribute. See .
height (Optional) Height of the image.
hotkeyid (Optional) Value of a <hotkey> id attribute in the
hotkeys configuration file (hotkeys.xml, located
in /webcomponent/config) that references the
keyboard shortcut command string for this
control.

18 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
actionbutton

id (Optional) ID for this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
imagefolder (Optional) Deprecated in 6.0.6.0: Sets the folder
that the button graphics are stored in. If the
graphics are not found in this folder or this
attribute is not specified, then an HTML button is
rendered.Pre‑6.0: Sets the folder that the button
graphics are stored in. If graphics are not found
in this folder, an HTML button will be drawn.
label (Optional) Button label text (string value or
<nlsid> element).
name (Optional) Name for this control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label value (that is, it overrides the datafield
and label attributes).
oncomplete (Optional) Event to be fired when an associated
action has completed. This attribute cannot be
used when the dynamic attribute is set to any
value other than false.
oncompleteclient (Optional) For internal use only.
showifdisabled (Optional) Whether, when one or more of the
action preconditions returns false: (True) this
control is displayed as disabled (grayed out).
(False) this control is not displayed.
showifinvalid (Optional) Indicates whether, when the
configuration service cannot resolve the action
definition: (True) this control is displayed as
disabled (grayed out). (False) this control is
not displayed. Default is false. A value of true
overrides a visible attribute that is set to false.To
hide all invalid actions in the application, set the
value of <hideinvalidactions> to true in your
custom app.xml file.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 19
actionbutton

style (Optional) CSS rule (enclosed in quotation


marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute. Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipdatafield (Optional) Datafield that overrides the value of
tooltip and tooltipnlsid.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
visible (Optional) (Boolean) Whether the control is
rendered as visible (True) or hidden (False).
width (Optional) Width of the image.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

20 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
actionbuttonlist

Usage
The button is not shown if the action cannot be resolved. The button is displayed as disabled if the
action cannot be executed. Use the <argument> tag to set context.
In pre‑6.0, by default, this control rendered the <input type=button> HTML tag; if the imagefolder
attribute was specified, then the <table>...<td>xxxLABELxxx</td>...</table> HTML tags were rendered;
if the src attribute was specified then the <img src=...> HTML tag was rendered.
In 6.0, by default this control renders the <button> tag; using the imagefolder attribute and its
associated attributes (disabledstyle, disabledclass, align) are deprecated. Also, specifying the src
attribute renders the <button><img src=...>...</button> HTML tags.

actionbuttonlist

Purpose
Generates a type‑based list of action buttons. The actions that will be displayed are configured in the
<actionlist> tag of action configuration files (dm_typename_action.xml).

Attributes

cssclass (Optional) CSS class to apply to this control.


datafield (Optional) Overrides the scope field. For
example, it can be used to display only a certain
type of object in the actionlist on a per row basis
in a datagrid.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
listid (Optional) ID of the actionlist to use.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
oncomplete (Optional) Event to be fired when an associated
action has completed. This attribute cannot be
used when the dynamic attribute is set to any
value other than false.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 21
actionimage

separatorhtml (Optional) HTML string to be displayed between


each action control (for formatting purposes).
style (Optional) CSS rule (enclosed in quotation marks,
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) to apply to
this control.

visible (Optional) (Boolean) Whether the control is


rendered as visible (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

actionimage

Purpose
Generates an image that launches an action when selected.

Attributes

action (Required) ID of the action to be launched by


this control.
alttext (Optional) Text to display when holding the
mouse pointer over this control.
border (Optional) Border in pixels around the image.
Default is 0 (zero) pixels (that is, no border).
cssclass (Optional) CSS class to apply to this control.

22 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
actionimage

datafield (Optional) Overrides the label value with a value


from a data source; overrides the URL defined in
src attribute.
datafielddisabled (Optional) Overrides srcdisabled value.
dynamic (Optional) Specifies when the action is to be
launched based on the conditions of other
controls on the JSP. Only false can be specified
for this attribute, if an event is specified for the
oncomplete attribute. See .
height (Optional) (Image action buttons only) Height
of the button.
hotkeyid (Optional) Value of a <hotkey> id attribute in the
hotkeys configuration file (hotkeys.xml, located
in /webcomponent/config) that references the
keyboard shortcut command string for this
control.
hspace (Optional) Horizontal margin (white space
padding to the left and right) around the image.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) String value or <nlsid> element
(which maps to a string label) to be rendered in
addition to the image.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the datafield and label values.
oncomplete (Optional) Event to be fired when an associated
action has completed. This attribute cannot be
used when the dynamic attribute is set to any
value other than false.
oncompleteclient (Optional) For internal use only.
showifdisabled (Optional) Whether, when one or more of the
action preconditions returns false: (True) this
control is displayed as disabled (grayed out).
(False) this control is not displayed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 23
actionimage

showifinvalid (Optional) Indicates whether, when the


configuration service cannot resolve the action
definition: (True) this control is displayed as
disabled (grayed out). (False) this control is
not displayed. Default is false. A value of true
overrides a visible attribute that is set to false.To
hide all invalid actions in the application, set the
value of <hideinvalidactions> to true in your
custom app.xml file.
showimage (Optional) Whether to display the icon (True) or
not (False). Default is True.
showlabel (Optional) Whether to display a label (True) or
not (False). Default is False.
src (Optional) URL to the image.
srcdisabled (Optional) Image to be used when the action is
disabled.
style (Optional) CSS rule (enclosed in quotation marks,
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) to apply to
this control.
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String to display when you place the
mouse pointer over this control.
tooltipdatafield (Optional) Datafield that overrides the value of
tooltip and tooltipnlsid.

24 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
actionlink

tooltipnlsid (Optional) NLS key to use when looking up a


localized tooltip string.
visible (Optional) (Boolean) Whether the control is
rendered as visible (True) or hidden (False).
vspace (Optional) Vertical margin (white space padding
to the top and bottom) around the image.
width (Optional) (Image action buttons only) Width of
the button.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

actionlink

Purpose
Generates an HTML link that has an associated action. The link is not shown if the action cannot be
resolved. The link is shown as disabled if the action cannot be executed. Use the <argument> tag to
set context.

Attributes

action (Required) ID of the action to be launched by


this control.
alttext (Optional) Text to display when holding the
mouse pointer over this control.
border (Optional) Border in pixels around the image.
Default is 0 (zero) pixels (that is, no border).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 25
actionlink

cssclass (Optional) CSS class that is applied to this


control.
datafield (Optional) Overrides label or NLS value with
string from a data source.
datafielddisabled (Optional) Overrides srcdisabled value.
dynamic (Optional) Specifies when the action is to be
launched based on the conditions of other
controls on the JSP. Only false can be specified
for this attribute, if an event is specified for the
oncomplete attribute. See .
height (Optional) (Image action buttons only) Height
of the button.
hotkeyid (Optional) Value of a <hotkey> id attribute in the
hotkeys configuration file (hotkeys.xml, located
in /webcomponent/config) that references the
keyboard shortcut command string for this
control.
hspace (Optional) Horizontal margin (white space
padding to the left and right) around the image.
id (Optional) ID for the control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Contains a string value or <nlsid>
element that maps to a string label that is
displayed in the user interface.
linkspacer (Optional) Width (in pixels) to display as space
between dynamic links. Space is collapsed when
this control is not visible.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label value.
oncomplete (Optional) Event to be fired when an associated
action has completed. This attribute cannot be
used when the dynamic attribute is set to any
value other than false.
oncompleteclient (Optional) For internal use only.

26 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
actionlink

showifdisabled (Optional) Whether, when one or more of the


action preconditions returns false: (True) this
control is displayed as disabled (grayed out).
(False) this control is not displayed.
showifinvalid (Optional) Indicates whether, when the
configuration service cannot resolve the action
definition: (True) this control is displayed as
disabled (grayed out). (False) this control is
not displayed. Default is false. A value of true
overrides a visible attribute that is set to false.To
hide all invalid actions in the application, set the
value of <hideinvalidactions> to true in your
custom app.xml file.
showimage (Optional) Whether an image is displayed with
the link (True) or not (False). Default is False.
showlabel (Optional) Whether the label is displayed (true)
or not (false). Default is True.
src (Optional) URL to the image.
srcdisabled (Optional) Image to be displayed when the
action is disabled.
style (Optional) CSS rule (enclosed in quotation marks,
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) that is
applied to this control.
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 27
actionlinklist

tooltipdatafield (Optional) Datafield that overrides the value of


tooltip and tooltipnlsid.
tooltipnlsid (Optional) NLS lookup key to use when looking
up a localized tooltip string.
visible (Optional) (Boolean) Whether the control is
rendered as visible (True) or hidden (False).
vspace (Optional) Vertical margin (white space padding
to the top and bottom) around the image.
width (Optional) (Image action buttons only) Sets the
width of the button.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

actionlinklist

Purpose
Generates a list of action controls based on object type. The actions that are displayed are configured in
the <actionlist> element of action configuration files (dm_typename_action.xml). You can use more than
one actionlinklist control with the same scope in a JSP page, provided the listid attribute has a different
value. This allows you to display different actions for the same object type on different screens.

Attributes

columns (Optional) Number of columns in which to


display the list in a table.
cssclass (Optional) CSS class to apply to this control.

28 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
actionlinklist

datafield (Optional) Overrides the scope field. For


example, it can be used to display only a certain
type of object in the actionlist on a per row basis
in a datagrid.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
listid (Optional) ID of the actionlist to use. The ID
of the list to use within the scope. If it is not
specified, then the value of ʺdefault is used.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
oncomplete (Optional) Event to be fired when an associated
action has completed. This attribute cannot be
used when the dynamic attribute is set to any
value other than false.
separatorhtml (Optional) HTML string to be displayed between
each action control (for formatting purposes).
showimages (Optional) False to override images set in a
component XML definition.
showlabels (Optional) False to override labels set in
component XML definition.
style (Optional) CSS rule (enclosed in quotation marks,
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) applied to
this control.
visible (Optional) (Boolean) Whether the control is
rendered as visible (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 29
actionmenuitem

actionmenuitem

Purpose
Generates a menu item that launches an action.

Attributes

action (Required) ID of the action to be launched by


this control.
cssclass (Optional) CSS class that is applied to this
control.
datafield (Optional) Overrides menu item string or nlsid
from a data source.
dynamic (Optional) Specifies when the action is to be
launched based on the conditions of other
controls on the JSP. Only false can be specified
for this attribute, if an event is specified for the
oncomplete attribute. See .
hotkeyid (Optional) Value of a <hotkey> id attribute in the
hotkeys configuration file (hotkeys.xml, located
in /webcomponent/config) that references the
keyboard shortcut command string for this
control.
id (Optional) ID of the control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
imageicon (Optional) URL to an image to be displayed as
a menu item.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the value attribute value.

30 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
actionmenuitem

oncomplete (Optional) Event to be fired when an associated


action has completed. This attribute cannot be
used when the dynamic attribute is set to any
value other than false.
oncompleteclient (Optional) For internal use only.
showifdisabled (Optional) Whether, when one or more of the
action preconditions returns false: (True) this
control is displayed as disabled (grayed out).
(False) this control is not displayed.
showifinvalid (Optional) Indicates whether, when the
configuration service cannot resolve the action
definition: (True) this control is displayed as
disabled (grayed out). (False) this control is
not displayed. Default is false. A value of true
overrides a visible attribute that is set to false.To
hide all invalid actions in the application, set the
value of <hideinvalidactions> to true in your
custom app.xml file.
style (Optional) CSS rule (enclosed in quotation marks,
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) that is
applied to this control.
value (Optional) Menu item string.
visible (Optional) (Boolean) Whether the control is
rendered as visible (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
Menu items do not pass arguments. Arguments are passed to the menu action through an
actionmultiselect control. This tag is also used to pass arguments to an action that does not have a
selected object, such as import. An action may use only some of the arguments in the actionmultiselect
tag, because it contains arguments for all possible multiselect actions on the page. Arguments can

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 31
actionmultiselect

also be passed within an actionmultiselectcheckbox tag, but those arguments will not be passed to
genericnoselect actions, that is, actions that ignore selected objects.
Note: You can pass arguments through the actionmultiselectcheckbox control even when row selection
is enabled and checkboxes are not used.

actionmultiselect

Purpose
Supports multiple selection with an associated action. Contains action controls with the dynamic
attribute, such as actionmultiselectcheckbox or actionlink. The action on multiply selected items is
specified by either the contained action control or by an actionmenuitem control. The actionmultiselect
control passes nested arguments (in <argument> tags) to the control that performs the action. Multiple
selection is supported only in classic or objectlist view.

Attributes

id (Optional) ID of the control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
selectionargs (Optional) Comma‑separated list of arguments
used to uniquely identify selected items.
selectiongroupargs (Optional) Comma‑separated list of arguments
used to uniquely identify an item’s group.
Actions are disabled when the selected item’s
selectiongroup attribute(s) do not share the same
value.

Description
Since
5.x

32 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
actionmultiselectcheckall

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
Use the optional selectionargs attribute to identify each selected item in the datagrid. This will
ensure that the same items are selected when a component returns. The following example from
searchresultslist.jsp adds arguments for a selection group, which ensures that the action cannot be
performed unless the multiple objects that are selected share the same repository:
<dmfx:actionmultiselect name="multi" selectionargs="
objectId,<%=SearchInfo.ENTRYID_PARAM%>,<%=SearchInfo.
QUERYID_PARAM%>" selectiongroupargs="
<%=SearchResultSet.ATTR_DOCBASE_ID%>">
<dmfx:argument name='objectId' contextvalue='objectId'/>
...
</dmfx:actionmultiselect>

actionmultiselectcheckall

Purpose
Generates a checkbox that checks all objects in a list. When checked, an action can be performed on all
objects. In accessibility mode, this control generates a link to a global actions page, which displays
actions that do not require a selected object.

Attributes

cssclass (Optional) CSS class to apply to this control.


name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 33
actionmultiselectcheckbox

style (Optional) CSS rule (enclosed in quotation marks,


for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) to apply to
this control.
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

actionmultiselectcheckbox

Purpose
Generates a checkbox that has one or more associated actions. Must be contained within an
<actionmultiselect> tag in a datagrid header. All action controls on the page with the dynamic value
set to multiselect are associated with the checkbox. In accessibility mode, this control generates a
link to an actions page for the object.

34 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
actionmultiselectcheckbox

Attributes

cssclass (Optional) CSS class to apply to this control.


name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
style (Optional) CSS rule (enclosed in quotation marks,
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) to apply to
this control.
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
value (Optional) (Boolean) Checkbox is checked (True);
checkbox is unchecked (False). Default is false.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 35
docbaseattribute

Attributes

docbaseattribute

Purpose
Displays the label and value of an object specified in the associated <docbaseobject> tag. This control
generates the following controls: docbaseattributevalue (which validates against the data dictionary),
docbaseattributelabel, and some HTML table tags. This control is used within a table or within a
component class.

Attributes

attribute (Optional) Name of an object attribute.


col1 (Optional) HTML to be rendered between label
and value. Default is </td><td>. For example:
col1=ʺ</td><td><b>:</b></td><td>ʺ
col2 (Optional) HTML to be rendered between col1
and the value. Default is an empty cell: </td><td>
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Overrides attribute value.
docbaseattributevalueassistance (Optional) Name of the docbaseattributeval‑
ueassistance control in which a list of value is
specified.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
lines (Optional) Number of lines to display for an
attribute. Use the lines and the size attributes
to display the attribute.

36 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseattribute

name (Optional) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.
object (Required) Name of associated docbaseobject
control on the JSP. For example,
<dmfx:docbaseobject name=ʺobjʺ/> sets
the object and <dmfx:docbaseattribute
object=ʺobjʺ attribute=ʺobject_nameʺ...> sets the
attribute for that object.
post (Optional) HTML to render after this control.
Default = </td></tr> (closes the row).
pre (Optional) HTML to render before this control.
Default = <tr><td> (opens the row).
readonly (Optional) Whether this control is read‑only
(True) or read‑write (False). This attribute does
not override or change the status of the object
attribute value in the repository; it only applies
to the rendering of the object attribute in the user
interface. You use the attributes component’s
readOnly parameter to override this attribute’s
value of false.
required (Optional) Whether the attribute is required
(True) or not (False).
showobjectidasname (Optional) Whether to to display the name of the
object (False) or override it with the object ID
(True) . Default is true. You can use a formatter
in a docbaseobject configuration file to override
this value.
size (Optional) Size of this control.
style (Optional) CSS rule (enclosed in quotation marks,
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) to apply to
this control.
validate (Optional) Whether to enable data dictionary
validation (True) or disable it (False). Default is
true.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 37
docbaseattributedelegate

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
To format the attributes that are displayed by this control, wrap the control in a formatter control.
For example, you can format a boolean value with booleanformatter, a date with datevalueformatter.
Other formatters include htmlsafetextformatter, numberformatter, stringlengthformatter,
multilinestringlengthformatter, docformatvalueformatter, docsizevalueformatter,
folderexclusionformatter, rankvalueformatter, and vdmbindingruleformatter.
If you wish to generate a list of attributes from the data dictionary rather than using individual
attribute controls, use a docbaseattributelist control.
If you need to do custom (not data dictionary) validation for the attribute, do not use this control. Use
the repositoryattributevalue tag with docbaseattributelabel. The docbaseattributevalue tag performs
data dictionary validation and accepts other validators.
If you need value assistance for the attribute, provide a name for your value assistance set as follows:
<dmfx:docbaseattribute object="obj" attribute="keywords"
docbaseattributevalueassistance="my_resultset"
size="48" cssclass="defaultLabelStyle"/>

The values for the value assistance list are provided by docbaseattributevalueassistance value tags,
either in the JSP page or in the component class. See docbaseattributevalueassistancevalue, page
51 for details.

docbaseattributedelegate

Purpose
Displays, in a datagrid, pseudoattributes and attributes for which there is a docbaseobjectconfiguration
file. If there is no custom configuration, this control works the same as the docbaseattribute control.

38 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseattributedelegate

Attributes

attribute (Optional) Name of the object attribute to


display.
col1 (Optional) HTML to be rendered between
the label and value. Default = </td><td>. For
example: col1=ʺ</td><td><b>:</b></td><td>ʺ
col2 (Optional) HTML to be rendered between the
HTML generated by the col1 attribute and the
value. Default = an empty cell: </td><td>
cssclass (Optional) the CSS class to apply to this control.
datafield (Optional) Name of the datafield to override the
attribute value.
docbaseattributevalueassistance (Optional) Name of the docbaseattributeval‑
ueassistance control in which a list of value is
specified.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
lines (Optional) Specifies the number of lines to
display for an attribute. Use the lines and the
size attributes to display the attribute.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
object (Required) Name of associated docbaseobject
control on the JSP. For example,
<dmfx:docbaseobject name=ʺobjʺ/> sets
the object and <dmfx:docbaseattribute
object=ʺobjʺ attribute=ʺobject_nameʺ...> sets the
attribute for that object.
post (Optional) HTML to render after this control.
Default = </td></tr> (that is, closes the row).
pre (Optional) HTML to render before this control.
Default = <tr><td> (that is, opens the row).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 39
docbaseattributedelegate

readonly (Optional) Whether this control is read‑only


(True) or read‑write (False). This attribute does
not override or change the status of the object
attribute value in the repository; it only applies
to the rendering of the object attribute in the user
interface. You use the attributes component’s
readOnly parameter to override this attribute’s
value of false.
required (Optional) Whether the attribute is required
(True) or optional (False)
showobjectidasname (Optional) Whether to to display the name of the
object (False) or override it with the object ID
(True) . Default is true. You can use a formatter
in a docbaseobject configuration file to override
this value.
size (Optional) Size of this control.
style (Optional) CSS rule (enclosed in quotation marks,
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) to apply to
this control.
validate (Optional) (Boolean) Indicates whether to
validate the control (True) or not (False). Default
is true.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
To format the attributes that are displayed by this control, wrap the control in a formatter control.
For example, you can format a boolean value with booleanformatter, a date with datevalueformatter.
Other formatters include htmlsafetextformatter, numberformatter, stringlengthformatter,
multilinestringlengthformatter, docformatvalueformatter, docsizevalueformatter,
folderexclusionformatter, rankvalueformatter, and vdmbindingruleformatter.

40 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseattributelabel

If you need to do custom (not data dictionary) validation for the attribute, do not use this control. Use
the repositoryattributevalue tag with docbaseattributelabel. The docbaseattributevalue tag performs
data dictionary validation and accepts other validators.
If you need value assistance for the attribute, provide a name for your value assistance set as follows:
<dmfx:docbaseattribute object="obj" attribute="keywords"
docbaseattributevalueassistance="my_resultset"
size="48" cssclass="defaultLabelStyle"/>

The values for the value assistance list are provided by docbaseattributevalueassistance value tags,
either in the JSP page or in the component class. See docbaseattributevalueassistancevalue, page
51for details.

docbaseattributelabel

Purpose
Displays the label for an attribute of an object specified in the associated <docbaseobject> tag.

Attributes

attribute (Optional) Name of the object attribute for which


to display a label.
datafield (Optional) Overrides the attribute value.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
object (Required) Name of associated docbaseobject
control.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 41
docbaseattributelist

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

docbaseattributelist

Purpose
Displays all visible attributes of the Documentum object specified as the associated docbaseobject
control. Attributes are rendered by category as defined in the data dictionary or configuration file.
Each attribute is generated as a docbaseattribute control instance that encapsulates data dictionary
information.

Attributes

attrconfigid (Required) Configuration ID to identify which


control definition file to use. Must correspond to
the value for id in <attributelist id=ʺattributesʺ>
in the corresponding control definition file.
categorypost (Optional) HTML string to render after each
category. Scripts are not supported. Default is
</th></td></tr> (taht is, closes the row).
categorypre (Optional) HTML string to render before each
category. Scripts are not supported. Default
is <tr><td colspan=\3\><hr></td></tr><tr><th
align=\left\>
col1 (Optional) HTML string to render between the
label and value. Scripts are not supported.
Default is </th><td><b>:</b></td><td>
col2 (Optional) HTML string to render between the
value and validator. Scripts are not supported.
Default is </td><td>

42 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseattributelist

cssclass (Optional) CSS class to apply to this control.


id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
inlinerefresh (Optional) Determines whether to perform an
inline refresh (true) or full page refresh (false)
when user clicks on the Show More/Hide More
(image or link) to display or hide the secondary
docbase attribute list. Default is true. You must
also set both the pre attribute and the separator
attributes to their defaults.

Since: 6.5
morelinkpost (Optional) HTML string to render after the Show
More link. Scripts are not supported. Default is
</td></tr>
morelinkpre (Optional) HTML string to render before the
Show More link. Scripts are not supported.
Default is <tr><td colspan=\4\>
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed. 6.0: Changed
from Required to Optional.
object (Required) Name of associated docbaseobject
control on the JSP page.
post (Optional) HTML string to render after each
docbaseattribute control. Scripts are not
supported. Default is </td></tr> (closes the row)
pre (Optional) HTML string to render before
each docbasattribute control. Scripts are not
supported. Default is <tr><th align=\right\>
readonly (Optional) Whether this control is read‑only
(True) or read‑write (False). This attribute does
not override or change the status of the object
attribute value in the repository; it only applies
to the rendering of the object attribute in the user
interface. You use the attributes component’s
readOnly parameter to override this attribute’s
value of false.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 43
docbaseattributelist

separator (Optional) HTML to render as a separator


between attributes. Default = <tr><td colspan =
\3\><hr></td></tr>. Valid for 5.2 repositories
only.
showcategorynames (Optional) Whether to display category names in
the user interface (True) or not (False). If there is
only one category or the component definition’s
<showpagesastabs> element content is true, the
category name is not displayed.
showobjectidasname (Optional) Whether to to display the name of the
object (False) or override it with the object ID
(True) . Default is true. You can use a formatter
in a docbaseobject configuration file to override
this value.
size (Optional) Size (in pixels) of this control.
style (Optional) CSS rule (enclosed in quotation marks,
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) to apply to
this control.
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
visiblecategory (Optional) Comma‑separated string that specifies
the categories to display. Default is null (that is,
all categories are displayed).

44 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseattributeproxy

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
A single docbaseattributelist control in the JSP eliminates the need for a separate docbaseattribute
control for each attribute to be listed. Attributes are displayed in categories, and categories are
displayed in the user interface as tabs. You can configure the attributes that are displayed in categories
using the data dictionary or an attributelist Configuration file. You can display a different set of
attributes for each component that displays attributes and for any context that is defined by a qualifier
in your application, for example, checkin, checkin by administrator, checkin of a custom type.
To set a different docbaseattributelist configuration in your behavior class depending on business
rules, for example, to display a particular attribute only when a business condition is met, put two or
more docbaseattributelist controls within a panel control on the page. Show or hide each panel using
the panel setVisible method to use the proper attribute list, for example:
Panel attrlst1 = (Panel) getControl(ATTRLST1PANEL, Panel.class);
attrlst1.setVisible(true);
Panel attrlst2 = (Panel) getControl(ATTRLST2PANEL, Panel.class);
attrlst1.setVisible(false);

Docbaseattributelist controls are configured in a configuration file. For more information on


configuring attributelist controls, see ʺdocbaseattributelist in Web Development Kit Development Guide.

docbaseattributeproxy

Purpose
Used to represent any control that is associated with a docbaseobject.

Attributes

attribute (Required) Attribute to represent.


controltorepresent (Required) Name of the input control to
represent.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 45
docbaseattributeseparator

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
object (Required) Name of the docbaseobject tag on
the JSP page. In the following example, the
object being validated is named ʺobj, so the
value of the object parameter for this validator
would be ʺobj:<dmfx:docbaseobject name=ʺobjʺ
configid=ʺattributesʺ/>

Description
Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
This control is used only to validate attributes that are listed as ignored attributes in a
docbaseattributelist configuration. For example, the list of available formats is displayed by the
datadropdownlist control named ʺformatListʺ in the Webtop import JSP page, and the user’s selection
should be validated against object constraints for the selected object type. The format attribute is listed
in the <ignore_attributes> element of import_docbaseattributelist.xml. In order for the selection to be
validated, use the validator to validate the control on the JSP page, similar to the following:
<dmf:docbaseattributeproxy
name="docbaseattributeproxy_attr1"
object="docbaseObj" controltovalidate="
formatlist" attribute="a_content_type"/>

docbaseattributeseparator

Purpose
Generates a separator. This control is rendered by the docbaseattributelist control.

46 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseattributevalue

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
separator (Optional) HTML to render as a separator
between attributes. Default = <tr><td colspan =
\3\><hr></td></tr>.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

docbaseattributevalue

Purpose
Displays the value of an object that is specified in the associated <docbaseobject> tag.

Attributes

attribute (Optional) Name of the object attribute for which


to display its value.
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Overrides attribute value.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 47
docbaseattributevalue

docbaseattributevalueassistance (Optional) Name of the docbaseattributeval‑


ueassistance control in which a list of value is
specified.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
lines (Optional) Number of lines to display for an
attribute value. Use the lines and the size
attributes to display the value returned for an
attribute.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
object (Required) Name of the associated docbaseobject
control.
readonly (Optional) Whether this control is read‑only
(True) or read‑write (False). This attribute does
not override or change the status of the object
attribute value in the repository; it only applies
to the rendering of the object attribute in the user
interface. You use the attributes component’s
readOnly parameter to override this attribute’s
value of false.
required (Optional) Whether a value is required in the
user interface (True) or not (False). Does not
override data dictionary enforcement.
showobjectidasname (Optional) Whether to to display the name of the
object (False) or override it with the object ID
(True) . Default is true. You can use a formatter
in a docbaseobject configuration file to override
this value.
size (Optional) Size of this control.
style (Optional) CSS rule (enclosed in quotation marks,
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) to apply to
this control.

48 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseattributevalue

tabindex (Optional) Value (a whole number from 0 to


32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
validate (Optional) Whether to enable data dictionary
validation (True) or disable it (False). Default is
true.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
Use this tag and a docbaseattributelabel tag, if you need to use a custom validator for your attribute
value. This tag generates a docbaseattributevalidator control, so it will be automatically validated
against data dictionary constraints that have been set up for the attribute.
For information on using the docbaseattributevalueassistance attribute to set up non‑data dictionary
value assistance, see docbaseattribute, page 36.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 49
docbaseattributevalueassistance

docbaseattributevalueassistance

Purpose
Displays an open‑ended or closed set of values for value assistance. The attribute must not have
value assistance set up in the DocApp.

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
islistcomplete (Optional) Whether the user can add values to
the set of values (False) or not (True).
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
Specify the name of your list as the value of the docbaseattributevalueassistance attribute on the
docbaseattribute control. In the following example, the value assistance list is named my_resultset:
<dmfx:docbaseattribute object="obj" attribute="keywords"
docbaseattributevalueassistance="my_resultset"
size="48" cssclass="defaultLabelStyle"/>

Add the docbaseattributevalueassistance control. The values are specified by


docbaseattributevalueassistancevalue tags or by the component class. See
docbaseattributevalueassistancevalue, page 51for an example of providing values in the
component class. Values in the JSP page are shown in the following example. If the values are to be
provided by the component class, the docbaseattributevalueassistance control must be empty.

50 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseattributevalueassistancevalue

<dmfx:docbaseattributevalueassistance name="my_resultset"
islistcomplete="false">
<dmfx:docbaseattributevalueassistancevalue
label="Value A" value="valA"/>
<dmfx:docbaseattributevalueassistancevalue
label="Value B" value="valB"/>
</dmfx:docbaseattributevalueassistance>

docbaseattributevalueassistancevalue

Purpose
Displays a value for a non‑data dictionary list of values for an attribute. The attribute must not have
data dictionary value assistance set up.

Attributes

datafield (Optional) Name of the datafield that provides


the value for the attribute.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Label for the value.
labeldatafield (Optional) Name of the datafield that provides a
label for the value. Overrides the label and nlsid
attributes.
locale (Optional) Locale for which the value is valid.
If no locale attribute is specified, the value is
displayed for all locales.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label attribute value.
value (Optional) Valid value for the attribute.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 51
docbaseattributevalueassistancevalue

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
Specify the name of your value assistance list as the value of the docbaseattributevalueassistance
attribute on the docbaseattribute control. In the following example, the value assistance list is named
my_resultset:
<dmfx:docbaseattribute object="obj" attribute="keywords"
docbaseattributevalueassistance="my_resultset"
size="48" cssclass="defaultLabelStyle"/>

Add the docbaseattributevalueassistance control. The values are specified by


docbaseattributevalueassistancevalue tags or by the component class. Values in the JSP page are
shown in the following example.
<dmfx:docbaseattributevalueassistance name="my_resultset"
islistcomplete="false">
<dmfx:docbaseattributevalueassistancevalue
label="Value A" value="valA"/>
<dmfx:docbaseattributevalueassistancevalue
label="Value B" value="valB"/>
</dmfx:docbaseattributevalueassistance>

If the values are to be provided by the component class, the docbaseattributevalueassistance control
must be empty, for example:
<dmfx:docbaseattributevalueassistance name="my_resultset"
islistcomplete="false">
</dmfx:docbaseattributevalueassistance>

The values are set in the component class similar to the following example:
DocbaseAttributeValueAssistance attributeVA =
(DocbaseAttributeValueAssistance) getControl(
"my_resultset", DocbaseAttributeValueAssistance.class);
attributeVA.setMutable(true);

DocbaseAttributeValueAssistanceValue attributeVAValue =
new DocbaseAttributeValueAssistanceValue();
attributeVAValue.setLabel("Value A");
attributeVAValue.setValue("valA");
attributeVA.addValue(attributeVAValue);

DocbaseAttributeValueAssistanceValue attributeVAValue2 =
new DocbaseAttributeValueAssistanceValue();

52 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbasemultiobjects

attributeVAValue2.setLabel("Value B");
attributeVAValue2.setValue("valB");
attributeVA.addValue(attributeVAValue2);

docbasemultiobjects

Purpose
Retrieves information about multiple, selected objects and refreshes the dependent value assistance
cache.

Attributes

configid (Required) ID of a repositoryobject


configuration file whose root element is
<docbaseobjectconfiguration>. Default is
attributes.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
objectids (Optional) IDs of the selected objects.
validate (Optional) (Boolean) Whether to validate the
control (True) or not (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 53
docbaseobject

docbaseobject

Purpose
Hidden control that specifies a Documentum object. Reference this control in docbaseattribute,
docbaseattributevalue, and docbaseattributelist controls to display attributes of the object. Validation
and data dictionary values are read for the object type. If you specify the type attribute.

Attributes

configid (Optional) ID of a repositoryobject


configuration file whose root element is
<docbaseobjectconfiguration>.
datafield (Optional) Overrides the objectid attribute value.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
istype (Optional) Indicates that the object should be
used as a type object, valid only if src or datafield
is specified. If src returns a list of object IDs, you
must set istype to false.
lifecycleid (Optional) ID of a lifecycle, if a lifecycle type is
specified or istype equals true.
lifecyclestate (Optional) Name of a lifecycle if a lifecycle type
is specified or istype equals true.
modifyonversion (Optional) True, if the object will be checked
in. This will allow a user to modify attributes
during checkout.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
objectid (Optional) Documentum object ID.
src (Optional) DQL query to get the object.
type (Optional) Name of an object type. Specify this
attribute only if the object is used as a type object.
validate (Optional) (Boolean) Indicates whether to
validate the control (True) or not (False).

54 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseobject

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
You can modify how certain attributes or attribute types are displayed by using a formatter class.
You can modify how the attribute is saved by using a value handler class. These classes are used to
display or handle data in a docbaseattribute, docbaseattributevalue, or docbaseattributelist control.
You can modify which control is used to render an attribute by specifying a tag class that extends
DocbaseAttributeValueTag. You can add configuration elements that are used by the formatter,
handler, or tag class.
Note: Docbaseobject configuration files are read only for docbaseobject controls on a JSP page.
Custom rendering is not performed in a listing view such as the doclist component in which multiple
objects are displayed.
Custom formatters, handlers, and custom tag classes for objects must be registered in a docbaseobject
configuration file whose root element is <docbaseobjectconfiguration>. A JSP page references this
configuration by setting the configid attribute of <dmfx:docbaseobject> to the same value as the id of
the <docbaseobjectconfiguration> element. If this attribute is not specified on the docbaseobject tag,
the default configuration is used. This default configuration has an id of ʺattributes and is found in
/webcomponent/config/library/docbaseobjectconfiguration_dm_sysobject.xml.
The DocbaseObject methods setType() and setObjectId() cannot be used together. An
IllegalArgumentException will be thrown.
To get all of the docbaseattributevalue controls that use a particular docbaseobject in the page, use
code in similar to the following your component class:
DocbaseObject docbaseObj = (DocbaseObject) getControl("obj",
DocbaseObject.class);
FindValidAttributeValue v = new FindValidAttributeValue(
docbaseObj.getName());
this.visitDepthFirst(v);
Iterator it = v.getAttributeValues();
while (it.hasNext() == true)
{
DocbaseAttributeValue value = (DocbaseAttributeValue) it.
next();
System.out.println(value.getAttribute() + ":" + value.
getValue());
}

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 55
multiobjectsdocbaseattribute

multiobjectsdocbaseattribute

Purpose
Displays the label and value of an attribute by creating the MultiObjectsDocbaseAttributeLabel and
MultiObjectsDocbaseAttributeValue controls.

Attributes

attribute (Optional) Name of the attribute to display.


col1 (Optional) HTML string to render between the
label and value. Scripts are not supported.
Default = </th><td><b>:</b></td><td>
col2 (Optional) HTML string to render between the
value and validator. Scripts are not supported.
Default = </td><td>
cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
lines (Optional) Number of lines to display for an
attribute. Use the lines and the size attributes to
display this attribute.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
objects (Required) Name of the DocbaseMultiObjects
control to associate with this control.
post (Optional) HTML string to render after each
docbaseattribute control. Scripts are not
supported. Default = </td></tr> (closes the row).
pre (Optional) HTML string to render before
each docbasattribute control. Scripts are not
supported. Default = <tr><th align=\right\>.

56 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
multiobjectsdocbaseattributelabel

readonly (Optional) Whether this control is read‑only


(True) or read‑write (False). This attribute does
not override or change the status of the object
attribute value in the repository; it only applies
to the rendering of the object attribute in the user
interface. You use the attributes component’s
readOnly parameter to override this attribute’s
value of false.
required (Optional) Whether the attribute is required.
style (Optional) CSS rule enclosed in quotation marks;
for example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
validate (Optional) (Boolean) Whether to validate the
control (True) or not (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

multiobjectsdocbaseattributelabel

Purpose
Displays the label of a common attribute for multiple, selected objects.

Attributes

attribute (Optional) Name of the attribute of the label to


display.
cssclass (Optional) CSS class to apply to this control.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 57
multiobjectsdocbaseattributelist

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
objects (Required) Name of the DocbaseMultiObjects
control to associate with this control..
style (Optional) CSS rule enclosed in quotation marks;
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

multiobjectsdocbaseattributelist

Purpose
Displays all visible attributes of the selected objects associated with the DocbaseMultiObjects control.

Attributes

attrconfigid (Required) Configuration ID to identify the


control definition file to use. Must correspond to
the value for id in <attributelist id=ʺattributesʺ>
in the corresponding control definition file.
col1 (Optional) HTML string to render between the
label and value. Scripts are not supported.
Default = </th><td><b>:</b></td><td>

58 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
multiobjectsdocbaseattributelist

col2 (Optional) HTML string to render between the


value and validator. Scripts are not supported.
Default = </td><td>
cssclass (Optional) CSS class to apply to this control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
objects (Required) Name of the DocbaseMultiObjects
control to associate with this control.
post (Optional) HTML string to render after each
docbaseattribute control. Scripts are not
supported. Default = </td></tr> (closes the row).
pre (Optional) HTML string to render before
each docbasattribute control. Scripts are not
supported. Default = <tr><th align=\right\>.
separator (Optional) HTML to render as a separator
between attributes. Default = <tr><td colspan =
\3\><hr></td></tr>. Valid for 5.2 repositories
only.
showcategorynames (Optional) Whether to display category names in
the user interface (True) or not (False). If there is
only one category or the component definition’s
<showpagesastabs> element content is true, the
category name is not displayed.
style (Optional) CSS rule enclosed in quotation marks;
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺSince 6.0.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 59
multiobjectsdocbaseattributevalue

multiobjectsdocbaseattributevalue

Purpose
Displays the value of a common attribute for multiple, selected objects.

Attributes

attribute (Optional) Name of the attribute of the value to


display.
cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
hidden (Optional) (Boolean) Whether this control is
hidden (True) or not (False). Default is False.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
lines (Optional) Number of lines to display for an
attribute. Use the lines and the size attributes to
display this attribute.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
objects (Required) Name of the DocbaseMultiObjects
control to associate with this control.
readonly (Optional) Whether this control is read‑only
(True) or read‑write (False). This attribute does
not override or change the status of the object
attribute value in the repository; it only applies
to the rendering of the object attribute in the user
interface. You use the attributes component’s
readOnly parameter to override this attribute’s
value of false.
required (Optional) Whether the attribute is required
(True) or optional (False).

60 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
browserrequirements

style (Optional) CSS rule enclosed in quotation marks;


for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
validate (Optional) (Boolean) Whether to validate the
control (True) or not (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Client browser detection

browserrequirements

Purpose
Looks up the supported IE and Netscape versions as defined in the <browserrequirements> element
of app.xml. If the browser is not supported, is on an unsupported platform, or has no JVM, an error
message is displayed.

Attributes
None.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 61
checkjvmapplet

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

checkjvmapplet

Purpose
Generates an applet that checks the client browser JVM and offers the option of installing the Sun VM
if it is not installed. This control is used by applications or components that must use the Sun VM.
The applet is used by the Web Workflow Manager component.

Attributes

align (Optional) Horizontal alignment of applet text.


Possible values are the same as those for the
HTML IMG tag: left, right, top, texttop, middle,
absmiddle, baseline, bottom, absbottom.
alt (Optional) Text to be displayed when the
browser understands the applet tag, but cannot
run Java applets.
height (Required) Applet height in the browser. 0 to
hide the applet.
hspace (Optional) Horizontal space between applet and
surrounding text.
id (Optional) ID for this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
successhandler (Optional) Server‑side event handler that handles
the applet return.
vspace (Optional) Vertical space between applet and
surrounding text.
width (Required) Applet width in the browser.

62 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
macclientdetect

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

macclientdetect

Purpose
Places a Macintosh client detector applet on the page. The applet detects the browser version number
and stores the OS name in the session.

Attributes
None.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
The tag class has a public static method, MacClientDetector.getMacOsName(), that makes the Mac
OS version available. This method returns one of three values: MacClientDetector.MAC_OSX,
MacClientDetector.MAC_OS9, or null (the client is not Mac).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 63
attachmenticon

Collaboration

attachmenticon

Purpose
Displays an icon that indicates whether an attachment exists for this event or not.

Attributes

alttext (Optional) Alternate text to be displayed as a


tooltip and when the icon image fails to load.
datafield (Optional) Overrides the value of src attribute
with a URL from a data source.
height (Optional) Height of this control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Overrides the alttext and nlsid
attribute values.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the alttext attribute value.
onclick (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute is
true). When onclick is used, the image is turned
into a link.
runatclient (Optional) Specifies that the onclick event is to
run on the client (True) or the server (False).

64 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
actionattachmenticon

src (Optional) URL to the icon image on the server.


Can be a path on the server or in the repository, for
example: src=ʺ/webtop/component/getcontent?
objectId=0900303980005172ʺ The repository icon
may affect performance.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of this control.

Description
Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
This control is used within the datagrid control and is displayed as a preference column that can be
turned on or off.

actionattachmenticon

Purpose
Displays the attachment icon. The datatable summary view component use this control to display the
attachment icon if the row has an attachment associated with it.

Since
6.5

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 65
bannerbox

bannerbox

Purpose
Generates a box containing the Documentum Collaborative Services room banner. (Contains a
roombanner tag on the JSP page.)

Attributes

name (Optional) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

commentimage

Purpose
Render a comment Edit, Replyor Delete button.

Attributes

alttext (Optional) Text to display when holding the


mouse pointer over this control.
border (Optional) Border (in pixels) around the image.
Default is 0 (zero) pixels (that is, no border).

66 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
commentimage

datafield (Optional) Overrides label or nlsid with data


from a data source.
height (Optional) (Image buttons only) Height of the
button.
hspace (Optional) Horizontal margin (white space
padding to the left and right) around the image.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Value stored in the control and
displayed as text on the button.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label value.
onclick (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
runatclient (Optional) Specifies that the event is to run on
the client (True) or the server (False).
src (Optional) Image to be used for the button.
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 67
commentrow

type (Required) Edit mode: edit, reply, or delete.


visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).
vspace (Optional) Vertical margin (white space padding
to the top and bottom) around the image.
width (Optional) (Image buttons only) Specifies the
width of the button.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
The control takes two arguments that are passed in using argument controls. The control must be
contained within the commentrow control. Use the argument list to pass values to the onclick event.
<dmfx:topic name="<%=TopicPageView.CONTROL_TOPIC%>">
<dmfx:comment name="comment_row" cssclass="defaultCommentStyle"
indentamount="32"> . . .
...
</dmfx:comment>
</dmfx:topic>

commentrow

Purpose
Renders the individual comments for a topic. Must be contained within a topic control.

68 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datatablefield

Attributes

cssclass (Optional) CSS class to be used for previously


read comments.
indentamount (Optional) Indent amount (in pixels) for child
comments. Default is 32.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipdatafield (Optional) Datafield that overrides the value of
tooltip and tooltipnlsid.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
unreadstyle (Optional) CSS style to be used for unread com‑
ments. Default is defaultUnreadCommentStyle.

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

datatablefield

Purpose
Renders fields in a data table.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 69
datatablefield

Attributes

datafield (Optional) Overrides the visible attribute value.


id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
mode (Optional) Whether the datafield attribute value
is a string or boolean. Default is string. If this
attribute value is string and the datafield value’s
string length is greater than 0, then the datafield
attribute value is true. If this attribute value is
boolean and the datafield attribute value is 1, T,
or true, then the datafield attribute value is true.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
reversevisible (Optional) Whether the visible attribute is the
boolean complement of the datafield attribute
value (True) or not (False). Default is false. For
example, when this attribute is set to true and
the datafield value (in boolean mode) is true,
then the visible attribute value is false.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description
Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

70 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datatablefieldPanel

datatablefieldPanel

Purpose
Determines the set of controls to be rendered for each datatablefield, page 69 control.

Attributes

fields (Optional) List of fields that correspond to object


attribute names. This list is overridden by a list
of columns in the component definition.
hascustomattr (Optional) Whether the fields contain custom
attributes and the fields are used within a
datasortlink tag (True) or not (False). Setting this
attribute to true ensures that the link is displayed
correctly for sorting.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
labels (Optional) Comma‑separated string of fields to
be displayed as labels. The values are overridden
by labels set on columns in the component
definition.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsids (Optional) Comma‑separated string of NLS IDs
to display. The values are overridden by labels
set on columns in the component definition.

Description

Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 71
governedicon

governedicon

Purpose
Generates an icon indicating governance. Requires Documentum Collaborative Services enabled
for the repository.

Attributes

action (Required) ID of the action to be launched by


this control.
alttext (Optional) Text to display when holding the
mouse pointer over this control.
border (Optional) Border (in pixels) around the image.
Default is 0 (zero) pixels (that is, no border).
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Overrides label or NLS value with
string from a data source.
datafielddisabled (Optional) Overrides srcdisabled value.
dynamic (Optional) Specifies when the action is to be
launched based on the conditions of other
controls on the JSP. Only false can be specified
for this attribute, if an event is specified for the
oncomplete attribute. See .
height (Optional) Height of the button.
hspace (Optional) Horizontal margin (white space
padding to the left and right) around the image.
id (Optional) ID of this control.
label (Optional) Link text.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label value.

72 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
governedicon

oncomplete (Optional) Event to be fired when an associated


action has completed. This attribute cannot be
used when the dynamic attribute is set to any
value other than false.
showifdisabled (Optional) Whether, when one or more of the
action preconditions returns false: (True) this
control is displayed as disabled (grayed out).
(False) this control is not displayed.
showifinvalid (Optional) Indicates whether, when the
configuration service cannot resolve the action
definition: (True) this control is displayed as
disabled (grayed out). (False) this control is
not displayed. Default is false. A value of true
overrides a visible attribute that is set to false.To
hide all invalid actions in the application, set the
value of <hideinvalidactions> to true in your
custom app.xml file.
showimage (Optional) Whether to display the icon (True) or
not (False).
showlabel (Optional) Whether to display a label (True) or
not (False).
src (Optional) URL to the image.
srcdisabled (Optional) Image to display when the action is
disabled
style (Optional) CSS rule (enclosed in quotation marks,
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) to apply to
this control.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipdatafield (Optional) Datafield that overrides the value of
tooltip and tooltipnlsid.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 73
messageimportanceformatter

vspace (Optional) Vertical margin (white space padding


to the top and bottom) around the image.
width (Optional) (Image action buttons only) Width of
the button.

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

messageimportanceformatter

Purpose
Displays a string or icon for the message_importance attribute value of a dm_message_archive object.

Attributes

hinlsid (Optional) NLS lookup key. The string (or icon)


corresponding to the NLS ID is substituted for a
high importance value.
lownlsid (Optional) NLS lookup key. The string (or icon)
corresponding to the NLS ID is substituted for a
low importance value.
normalnlsid (Optional) NLS lookup key. The string (or icon)
corresponding to the NLS ID is substituted for a
normal importance value.

74 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
msgattachmenticon

Description
Since
6.0

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

msgattachmenticon

Purpose
Icon that indicates whether a dm_message_archive object has attachments or not.

Attributes
None.

Description

Since
6.0

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

recurrexceptionicon

Purpose
Displays an icon that indicates the kind of event (standalone exceptions or recurring events with
exceptions).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 75
recurrexceptionicon

Attributes

alttext (Optional) Alternate text to be displayed as a


tooltip and when the icon image fails to load.
datafield (Optional) Overrides the value of src attribute
with a URL from a data source.
height (Optional) Height of this control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Overrides the alttext and nlsid
attribute values.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the alttext attribute value.
onclick (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute is
true). When onclick is used, the image is turned
into a link.
runatclient (Optional) Specifies that the onclick event is to
run on the client (True) or the server (False).
src (Optional) URL to the icon image on the server.
Can be a path on the server or in the repository, for
example: src=ʺ/webtop/component/getcontent?
objectId=0900303980005172ʺ The repository icon
may affect performance.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of this control.

76 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
richtextdisplay

Description
Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
This control is used within the datagrid control and is displayed as a preference column that can be
turned on or off.

richtextdisplay

Purpose
Displays rich text attributes as read‑only. Requires Documentum Collaborative Services on the
Content Server.

Attributes

datafield (Optional) Name of pseudo‑attribute to be


displayed; for example, content_value.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 77
richtextdisplay

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
You can configure the behavior of the rich text display control by extending the control configuration
file /wdk/config/richtext.xml, which defines the following elements:

Table 4. Rich text configuration elements

<inputfilter> Remove the comments from this element to use


the RichTextInputFilter class, which processes
images and links that are entered by the user.
<outputfilter> Remove the comments from this element to use
the RichTextOutputFilter class, which processes
image URLs for display in IE and Mozilla.
<html_input> Contains elements that govern HTML input.
<allowed_tags> Contains all HTML tags that are allowed within
rich text input. Must include start and closing
tag, for example, <td></td>.
<allowed_attributes> Contains all attributes that are allowed within
HTML tags. Attributes are represented as
though they were HTML tags, for example,
<href></href>.
<allowed_protocols> Contains protocols that are permitted in links
within rich text. For example, to prevent ftp
URLs, remove <ftp></ftp> from the list.
<invalid_stylesheet_constructs> Contains stylesheet constructs that are not
permitted, such as those that contain external
links. For example:
<div style=ʺbackground: url(
http://www.somewebsite.com/image/
someimage.jpg);>
</div>

78 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
richtextdocbaseattribute

richtextdocbaseattribute

Purpose
Displays the label and value of a rich text pseudoattribute of an object specified in the associated
docbaseobject control. tag. Pseudo attributes are described in the object type’s docbaseattributelist
xml file. The richtextdocbaseattribute control is only valid in the property sheet context. This control
generates the following controls: richtextdocbaseattributevalue, richtextdocbaseattributelabel, and
some HTML table tags. Requires Documentum Collaborative Services on the Content Server.

Attributes

attribute (Optional) Pseudo‑attribute name.


id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
object (Required) Name of associated docbaseobject
control on the JSP. For example,
<dmfx:docbaseobject name=ʺobjʺ/> sets
the object and <dmfx:docbaseattribute
object=ʺobjʺ attribute=ʺobject_nameʺ...> sets the
attribute for that object.

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 79
richtextdocbaseattributelabel

richtextdocbaseattributelabel

Purpose
Displays the label of a rich text pseudoattribute of an object specified in the associated docbaseobject
tag. Pseudo attributes are described in type’s docbaseattributelist xml file, so this tag is only valid in
the property sheet context. Requires Documentum Collaborative Services on the Content Server.

Attributes

attribute (Optional) Pseudo‑attribute name.


datafield (Optional) Name of the datafield that provides
the label for the attribute.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
object (Required) Name of associated docbaseobject
control.
object (Required) Name of associated docbaseobject
control.

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

80 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
richtextdocbaseattributevalue

richtextdocbaseattributevalue

Purpose
Displays the value of a rich text pseudoattribute of an object specified in the associated docbaseobject
tag. Pseudo attributes are described in type’s docbaseattributelist xml file, so this tag is only valid in
the property sheet context. Requires Documentum Collaborative Services on the Content Server.

Attributes

attribute (Optional) Pseudo‑attribute name.


id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
object (Required) Name of associated docbaseobject
control.
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 81
richtexteditor

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

richtexteditor

Purpose
Generates a rich text editing add‑in. Requires Documentum Collaborative Services on the Content
Server.

Attributes

hasCharFormatting (Optional) (Boolean) Whether the character


formatting buttons are included in the toolbar
(bold, italic, underline, text color, highlight color)
(True) or not (False). Default is true.
hasClipboard (Optional) (Boolean) Whether the clipboard
button is included in the toolbar (True) or not
(False). Default is true.
hasFonts (Optional) (Boolean) Whether the font and
font‑size menus are included in the RTE toolbar
(True) or not (False).
hasImages (Optional) (Boolean) Whether the image button
is included in the toolbar (True) or not (False).
Default is true.
hasLinks (Optional) (Boolean) Whether the link button
is included in the toolbar (True) or not (False).
Default is true.

82 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
richtexteditor

hasParaFormatting (Optional) (Boolean) Whether the paragraph


formatting buttons are included in the toolbar
(alignment, bullet list, numbered list, indent,
outdent) (True) or not (False). Default is true.
hasSpellcheck (Optional) (Boolean) Whether the spell check
button is included in the toolbar (True) or not
(False). (Windows only) Default is true.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
tooltipnlsid (Optional)
value (Optional) Text (in HTML format) that is being
edited. Can be inherited from StringInputContol
or re‑implemented in the RTE control class if it
does not extend StringInputControl.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
You can configure the behavior of the rich text editor by extending the control configuration file
/wdk/config/richtext.xml, which defines the following elements:

Table 5. Rich text configuration elements

<inputfilter> Remove the comments from this element to use


the RichTextInputFilter class, which processes
images and links that are entered by the user
<outputfilter> Remove the comments from this element to use
the RichTextOutputFilter class, which processes
image URLs for display in IE and Mozilla

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 83
richtexteditor

<html_input> Contains elements that govern HTML input


<allowed_tags> Contains all HTML tags that are allowed within
rich text input. Must include start and closing
tag, for example, <td></td>.
<allowed_attributes> Contains all attributes that are allowed within
HTML tags. Attributes are represented as
though they were HTML tags, for example,
<href></href>.
<allowed_protocols> Contains protocols that are permitted in links
within rich text. For example, to prevent ftp
URLs, remove <ftp></ftp> from the list.
<invalid_stylesheet_constructs> Contains stylesheet constructs that are not
permitted, such as those that contain external
links. For example:
<div style=ʺbackground: url(
http://www.somewebsite.com/image/
someimage.jpg);>
</div>

Elements that configure the rich text editor are described in the table below. If no minimum version is
provided, the browser will not be allowed to use the rich text editor.

Table 6. Rich text editor configuration elements (<editor>)

<ieminversion> Minimum version of IE supported by editor


<mozillaminversion> Minimum version of Mozilla supported by editor
<netscapeminversion> Minimum version of Netscape supported by
editor
<safariminversion> Minimum version of Safari supported by editor
<iemaxversion> Maximum version of IE supported by editor
<mozillamaxversion> Maximum version of Mozilla supported by
editor
<netscapemaxversion> Maximum version of Netscape supported by
editor
<safarimaxversion> Maximum version of Safari supported by editor

84 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
richtextpanel

richtextpanel

Purpose
Surrounds the rich text editor and the rest of the HTML, such as the field name, so it will not be
generated if rich text is not enabled. Rich text editing or display requires Documentum Collaborative
Services on the Content Server.

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
To display an editable rich text attribute, add a richtextpanel similar to the following example (table
tags place this panel within a larger table in the component):
<dmfx:richtextpanel>
<tr>
<td scope="row" width="10%" align="right">
<b><dmf:label nlsid="MSG_DESCRIPTION_COLON"/><b></b>
</td>
<td width="90%" align="left">
<dmfx:richtexteditor name='<%=DocList.
FOLDER_DESCRIPTION%>' hasImages='true'/>
</td>
</tr>
</dmfx:richtextpanel>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 85
roombanner

roombanner

Purpose
Generates a room banner. Requires Documentum Collaborative Services to be enabled for the
repository.

Attributes

height (Optional) Height (in pixels) of the banner.


name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
objectid (Optional) ID of a governed folder containing
the room banner.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

showtopicdocbaseattribute

Purpose
Displays the label and value of a rich text pseudoattribute of an object specified in the associated
docbaseobject control. tag. Pseudo attributes are described in the object type’s docbaseattributelist
xml file. The richtextdocbaseattribute control is only valid in the property sheet context. This control
generates the following controls: richtextdocbaseattributevalue, richtextdocbaseattributelabel, and
some HTML table tags. Requires Documentum Collaborative Services on the Content Server.

86 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
showtopicdocbaseattributelabel

Attributes

attribute (Optional) Pseudo‑attribute name.


id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
object (Required) Name of associated docbaseobject
control on the JSP. For example,
<dmfx:docbaseobject name=ʺobjʺ/> sets
the object and <dmfx:docbaseattribute
object=ʺobjʺ attribute=ʺobject_nameʺ...> sets the
attribute for that object.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

showtopicdocbaseattributelabel

Purpose
Displays the label of show topic pseudoattribute of an object specified in the associated docbaseobject
tag. Pseudo attributes are described in type’s docbaseattributelist xml file, so this tag is only valid in
the property sheet context.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 87
showtopicdocbaseattributevalue

Attributes

attribute (Optional) Pseudo‑attribute name.


datafield (Optional) Datafield that provides the label for
the attribute.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
object (Required) Name of associated docbaseobject
control.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

showtopicdocbaseattributevalue

Purpose
Displays the value of a show topic pseudoattribute of an object specified in the associated
docbaseobject tag. Pseudo attributes are described in type’s docbaseattributelist xml file, so this
tag is only valid in the property sheet context.

88 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
showtopicdocbaseattributevalue

Attributes

attribute (Optional) Pseudo‑attribute name.


id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
object (Required) Name of associated docbaseobject
control.
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 89
topic

topic

Purpose
Displays the threaded list of comments found for an object’s topic. The control should contain the
comment control.

Attributes

name (Optional) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
The control data is set at runtime from a component by setting its dataprovider with a TopicResultSet
of data that makes up the topic. For example:
public void setTopicControl(
ITopic topic, String[] attributes)
{
topicData = new TopicResultSet(attributes, topic);
Topic topicControl = (Topic)getControl(
CONTROL_TOPIC, Topic.class);
DataProvider dataProvider = topicControl.getDataProvider(

dataProvider.setScrollableResultSet(topicData);
}

90 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
topicpanel

topicpanel

Purpose
Hides a topic for repositories that do not have Documentum Collaborative Services enabled

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
To display a panel of topics, add the topicpanel and collaboration component similar to the following
example:
<dmfx:topicpanel>
<dmfx:componentinclude name='showtopic' component='
embeddedtopic'>
<dmfx:argument name="objectId" contextvalue='objectId'/>
</dmfx:componentinclude>
</dmfx:topicpanel>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 91
topicstatus

topicstatus

Purpose
Generates an action icon that indicates the status of a discussion topic. A topic may be read, unread,
or nonexistent. If an indicator icon is present, then clicking it will bring user to the page containing
the topic. The control is used within the datagrid control and appears as a preference column that
can be turned on or off.

Attributes

action (Required) ID of the action to be launched by


this control.
alttext (Optional) Text to display when holding the
mouse pointer over this control.
border (Optional) Border in pixels around the image.
Default is 0 (zero) pixels (that is, no border).
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Overrides the label value with a value
from a data source. Overrides the URL defined
in src attribute
datafielddisabled (Optional) Overrides srcdisabled value.
dynamic (Optional) Specifies when the action is to be
launched based on the conditions of other
controls on the JSP. Only false can be specified
for this attribute, if an event is specified for the
oncomplete attribute. See .
height (Optional) Height of the image.
hspace (Optional) Horizontal margin (white space
padding to the left and right) around the image.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) String value or <nlsid> element
(which maps to a string label) to be rendered in
addition to the image.

92 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
topicstatus

name (Optional) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the datafield and label values.
oncomplete (Optional) Event to be fired when an associated
action has completed. This attribute cannot be
used when the dynamic attribute is set to any
value other than false.
showifdisabled (Optional) Whether, when one or more of the
action preconditions returns false: (True) this
control is displayed as disabled (grayed out).
(False) this control is not displayed.
showifinvalid (Optional) Indicates whether, when the
configuration service cannot resolve the action
definition: (True) this control is displayed as
disabled (grayed out). (False) this control is
not displayed. Default is false. A value of true
overrides a visible attribute that is set to false.To
hide all invalid actions in the application, set the
value of <hideinvalidactions> to true in your
custom app.xml file.
showimage (Optional) Whether to display the icon (True) or
not (False).
showlabel (Optional) Whether to display a label (True) or
not (False).
src (Optional) URL to the image.
srcdisabled (Optional) Image to be displayed when the
action is disabled.
style (Optional) CSS rule (enclosed in quotation marks,
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) to apply to
this control.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 93
topicstatus

tabindex (Optional) Value (a whole number from 0 to


32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipdatafield (Optional) Datafield that overrides the value of
tooltip and tooltipnlsid.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).
vspace (Optional) Vertical margin (white space padding
to the top and bottom) around the image.
width (Optional) Width of the image .

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

94 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
hidden

Context

hidden

Purpose
Generates a hidden control at the bottom of the page that stores serialized context information.

Attributes

datafield (Optional) Overrides value with data from a data


source.
encrypt (Optional) Whether data that is passed in the
hidden control cannot (True) or can (False) be
viewed by the browser ʺView Sourceʺ option.
This property can be used on named controls
only. Default is true.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
onchange (Optional) Event that is fired when this control is
changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted (for example, by
an onclick event). The onchange event handler
cannot run on the client (that is, the runatclient
attribute cannot be true).
value (Optional) Value stored in the control.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 95
celllist

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Data display

celllist

Purpose
Used within a table row (<tr>) or <dmf:datagridrow> tag to wrap a list of celltemplate tags. The cell
templates will output columns of data dynamically.

Attributes

fields (Optional) List of fields that correspond to object


attribute names. This list is overridden by a list
of columns in the component definition.
hascustomattr (Optional) Whether the celllist fields contain
custom attributes and the celllist tag is used
within a datasortlink tag (True) or not (False).
Setting this attribute to true ensures that the link
is displayed correctly for sorting.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
labels (Optional) Comma‑separated string of fields to
be displayed as labels. The values are overridden
by labels set on columns in the component
definition.

96 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
celltemplate

name (Optional) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.
nlsids (Optional) Comma‑separated string of NLS IDs
to display. The values are overridden by labels
set on columns in the component definition.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
If you specify columns in the component definition, they will override the fields that are specified
To set the celllist fields programmatically, call the CellList method setFields() during
onControlInitialized.

celltemplate

Purpose
Within a cell list tag, specifies a template output for a single column of data. The data that is rendered
is supplied by the fields attribute. Template values are supplied by a field name, such as object_name,
object type, such as double, or generic (matches everything).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 97
celltemplate

Attributes

field (Optional) Name of a field corresponding to


an object attribute name. If this attribute is
specified, the type attribute cannot be used.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
type (Optional) Object type. If this attribute is
specified, the field attribute cannot be used. If
neither field nor type attributes are set, then the
cell is generic. The number type matches either
an int or double datatype returned from DFC.
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
Use within a <dmf:celllist> tag. The fields for the template can be supplied as the value of the
fields attribute on the JSP page or programmatically from the component configuration using the
ComponentColumnDescriptorList object. WDK components that have a <columns> element in the
component XML definition get the list of fields from the configuration. (They get the columns from
ComponentColumnDescriptor.)
Fields, labels, and nlsids that are configured in the component definition file override tag attributes
in the JSP page.
You can configure dynamic sets of data for display using <dmf:celllist:> and <dmf:celltemplate>. If you
are displaying the data in columns, you can use a combination of celllist and celltemplate controls
within a table header row or within <dmf:datagridrow> to provide column headers, sorting, and
columns of data. See Web Development Kit Development Guidefor details.

98 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
columnpanel

columnpanel

Purpose
Wraps a set of column controls in a table row to allow display or hiding of column data.

Attributes

columnname (Required) Name of this column. All column


panels in a single row should use unique names.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
visible (Optional) (Boolean) Whether the control is
rendered as visible (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

datacolumnbeginswith

Purpose
Enables displaying all column values that start with a user‑entered string.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 99
datacolumnbeginswith

Attributes

autocompleteenabled (Optional) (Boolean) Enables (True) or disables


(False) autocompletion on the control. Default
is True.
autocompleteid (Optional) Key used to store the autocomplete
list in the user preferences. You can set the same
ID on two text controls, for example, if they share
the same set of suggestions. If the control does
not have an ID specified, the ID is generated
using this syntax: formid_controlid. formid is
the form id attribute and controlid is the text
control name. For docbaseattribute controls that
render a text control, an ID is generated using the
attribute name; for example, ʺkeyword or ʺtitle.
casesensitive (Optional)
column (Optional) Column name to which to bind. If this
control is within a celltemplate tag, you can use
the datafield attribute instead.
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) A value of CURRENT retrieves the
value from the data source.
defaultonenter (Optional) Whether pressing the Enter key calls
the JavaScript handleKeyPress() function (True)
or not (False). Must be used with a button (on
the same page) that has its default attribute
set to true. The button event is fired when the
user presses the Enter key in the defaultonenter
control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
maxautocompletesuggestionsize (Optional) Number of matching suggestions to
display to the user. Default is 10.

100 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datacolumnbeginswith

name (Required) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed. Required to
bind to a filter item.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the initial search value (for example, Starts With).
onchange (Optional) Event fired when this control’s value
is changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted.
onclick (Optional)
prompt (Optional)
runatclient (Optional) Whether the onchange event is to run
on the client (True) or the server (False).
size (Optional) Size of this control.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional)
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional)

Description

Since
6.0

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 101
datagrid

Usage
To format the value in this control, enclose it in a formatter control.

datagrid

Purpose
Displays results of a query or recordset as a table, generating opening and closing <table> tags.

Attributes

bordersize (Optional) Size of the datagrid border.


cellpadding (Optional) Space between cell contents and cell
border.
cellspacing (Optional) Spacing between the cells in the grid.
cssclass (Optional) CSS class to apply to this control.
fixedheaders (Optional) Boolean: Whether the datagrid header
rows are to scroll with the body rows (False) or
not (True). Default is false. To set this attribute
value for all datagrid controls in your application,
set the following element value in the app.xml
file: <desktopui<.<datagrid>.<fixedheaders>.
This element’s default value is true.Since 6.0.
height (Optional) Height of the datagrid.Since 6.0:
When you specify a value for this attribute,
scroll bars are generated for the contents of the
datagrid that extend beyond the specified value.
If you do not specify a value for this attribute on a
datagrid control, the grid takes up the remaining
height in the frame. Remaining elements on
the page should be placed within the footer
(anywhere between the end of datagridRow tag
and the end of datagrid tag).
id (Optional) ID if this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.

102 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datagrid

name (Required) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.
paged (Optional) Whether paging is turned on (True) or
off (False). All data is returned when paging is
turned off. Default is false.
pagesize (Optional) Number of result items on a page
when paging is turned on.
preservesort (Optional) Whether the datagrid preserves (True)
the current sort settings between data refresh
events or not (False). Default is false.
query (Optional) DQL query passed to the data
provider; for example:select group_name,
r_modify_date from dm_group where
group_name like ’a%’
recordcachecount (Optional) Overrides the default number of
records retrieved by the query and sets the
number of records to be fetched.
rendertable (Optional) Whether to suppress (False) or render
(True) <table> tags by the datagrid control. When
the data rows are rendered within separate
panes within a paneset control, set this value to
false and insert <table> tags manually within the
pane control. Default is true.
rowselection (Optional) Boolean: Enables (True) or disables
(False) mouse or keyboard row selection
(selecting one or more objects) and right‑click
context menus. Default is True. The app.xml
file’s desktopui/datagrid/rowselection element
must be set to true to enable this attribute.
sortcolumn (Optional) Name of column on which to sort.
sortdir (Optional) Sort direction: ascending (0) or
descending (1). Default is 0.
sortmode (Optional) Initial sort mode: text (0),
case‑insensitive text (1), or numeric (2). Default
is 1.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 103
datagrid

style (Optional) CSS rule (enclosed in quotation marks,


for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) to apply to
this control.
width (Optional) Width of the datagrid.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
This control can contain datagridrow, nodatarow, row, or HTML table row (<tr>) tags. The data can
be paged by adding a datapaging control and sorted by adding a datasortimage or datasortlink
control into the grid control. To support row selection this control must be placed outside any HTML
table tags.
To generate scroll bars when the contents of the datagrid extend beyond datagrid’s height, specify a
value in the height attribute.

Examples

Row selection

Since 6.0.
To disable row selection for an individual datagrid row, set the rowselection attribute to false in
the datagrid tag on the JSP page, for example:
<dmf:datagrid ..rowselection="false">

Table 7, page 105 describes the interaction between the global row selection flag in app.xml and
the datagrid attribute.

104 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datagridRow

Table 7. Row selection settings

app.xml dmf:datagrid Result


<rowselection> rowselection
false true or false Checkboxes rendered, no
mouse/keyboard row selection
or context menus on any
datagrid
true true No checkboxes rendered, row
selection and context menus
enabled for the datagrid
true attribute not specified No checkboxes rendered, row
(for example, migrated selection and context menus
customizations) enabled for the datagrid
true false Checkboxes rendered, no
mouse/keyboard row selection
or context menus on current
datagrid

With row selection enabled in app.xml, contained checkboxes within a datagrid on the JSP page are
rendered with a CSS rule of display:none. Rows can then be selected by mouse events or keyboard
combinations. Link and action controls inside selectable rows are disabled. To migrate links and action
controls within a datagrid row, move them to a context menu or a datagridrowevent tag.

datagridRow

Purpose
Generates rows of data inside a datagrid. Generates <tr> opening and closing tags within the <table>
tags generated by datagrid. Can contain <td>, <columnpanel>. Displays the contents of its databound
controls for all rows of data that are available or that are shown per page.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 105
datagridRow

Attributes

align (Optional) Horizontal alignment of the cell.


altclass (Optional) Class for alternating lines
(if required); for example: altclass=
’databoundExampleDatagridRowAlt’
altstyle (Optional) CSS rule for alternating lines (if
required); for example: <dmf:datagridRow
style=’{BACKGROUND‑COLOR: white}’
altstyle=’{BACKGROUND‑COLOR: red}’>
columns (Optional) Number of columns in which to
display the data. If this value is greater than
zero, then the datagrid formats the data in the
specified number of columns.
cssclass (Optional) CSS class to apply to this control.
height (Optional) Height of the datagrid.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tooltip (Optional) String that displays as a title for each
row.
tooltipdatafield (Optional) NLSID element that displays as a title
for each row.
tooltipnlsid (Optional) Datafield that displays as a title for
each row.
valign (Optional) Vertical alignment of the cell.
width (Optional) Width of the datagrid.

106 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datagridRowBreak

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
The number of rows displayed depends on data set size and paging options set on the parent datagrid
tag.
When the accessibility option is turned on in the user preferences, the datagridrow tag generates a title
for the row based on the tooltip. This allows reader programs to navigate the generated rows of data.
Use only one datagridRow tag within a datagrid.

datagridRowBreak

Purpose
Specifies a break in a DatagridRow control.

Attributes

align (Optional) Alignment of cells in the row (left,


right, center, justify, or char)
altclass (Optional) Sets the class for alternating
lines if required; for example: altclass=
’databoundExampleDatagridRowAlt’
altstyle (Optional) CSS rule for alternating lines,if
required; for example: <dmf:datagridRow
style=’{BACKGROUND‑COLOR: white}’
altstyle=’{BACKGROUND‑COLOR: red}’>
bgcolor (Optional) Background color for the cells in the
row.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 107
datagridRowBreak

char (Optional) Specifies a single character within a


text fragment to act as an axis for alignment. The
default value for this attribute is the decimal
point character in HTML documents for the
current language as set by the lang attribute
(for example, the period (.) in English and the
comma (,) in French).
charoff (Optional) Specifies the offset to the first
occurrence of the alignment character on each
line. If a line does not include the alignment
character, it will be horizontally shifted to end at
the alignment position.
cssclass (Optional) Sets the cascading style sheet class
that is used to format the control.
dir (Optional) Specifies the direction for the text as
left‑to‑right (LTR) or right‑to‑left (RTL).
height (Optional) Not used.
id (Optional) ID for the control. The ID is generated
by the framework. You can also set the ID in the
JSP.
lang (Optional) Language code, used to assist
third‑party software (such as, spelling and
grammar checkers).
style (Optional) A cascading style sheet rule enclosed
in quotation marks; for example: style=ʺ{COLOR:
darkmagenta; TEXT‑DECORATION: underline}ʺ
title (Optional) Title attribute for the row.
valign (Optional) Vertical alignment setting for cells in
the row.

Description
Since
6.0

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

108 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datagridRowEvent

datagridRowEvent

Purpose
Specifies the event for which to register and the event handler in a DatagridRow control.

Attributes

action (Optional) ID of the action to be launched by this


control.
eventhandler (Optional) Name of the handler for the event.
eventname (Required) Name of the event for which to
register.
runatclient (Optional) Specifies for the event to run on the
client (True) or the server (False).

Description
Since
6.0

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
This control is disabled when its parent datagrid control’s rowselection attribute is true.

datagridRowModifier

Purpose
Hides or disables contained controls when its parent datagrid’s rowselection attribute is true.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 109
datagridRowTd

Attributes

skipbody (Optional)

Description
Since
6.0

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

datagridRowTd

Purpose
Data cells in a datagrid control. Outputs <td> HTML tags with a marker class.

Attributes

abbr (Optional) HTML abbr attribute.


align (Optional) HTML align attribute.
axis (Optional) HTML axis attribute.
bgcolor (Optional) HTML bgcolor attribute.
char (Optional) HTML char attribute.
charoff (Optional) HTML charoff attribute.
colspan (Optional) HTML colspan attribute.
cssclass (Optional) CSS class to apply to this control.
dir (Optional) HTML dir attribute.
headers (Optional) HTML headers attribute.
height (Optional) HTML height attribute.

110 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datagridTh

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
lang (Optional) HTML lang attribute.
nowrap (Optional) HTML nowrap attribute.
rowspan (Optional) HTML rowspan attribute.
scope (Optional) HTML scope attribute.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
title (Optional) HTML title attribute.
valign (Optional) HTML valign attribute.
width (Optional) HTML width attribute.

Description

Since
6.0

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
Place inside of a datagridRow control in a datagrid control. At runtime, if the number of data columns
does not match the number of column head cells, an error is generated.

datagridTh

Purpose
Column heads in a datagrid control. Outputs <th> HTML tags with a marker class and <div> HTML
tags that constrain each cell’s content.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 111
datagridTh

Attributes

abbr (Optional) HTML abbr attribute.


align (Optional) HTML align attribute.
axis (Optional) HTML axis attribute.
bgcolor (Optional) HTML bgcolor attribute.
char (Optional) HTML char attribute.
charoff (Optional) HTML charoff attribute.
cssclass (Optional) CSS class to apply to this control.
dir (Optional) HTML dir attribute.
headers (Optional) HTML headers attribute.
height (Optional) HTML height attribute.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
lang (Optional) HTML lang attribute.
nowrap (Optional) HTML nowrap attribute.
resizable (Optional) Boolean: Whether to enable the ability
to resize the column head (True) or not (False).
Default is false. Since 6.0.
rowspan (Optional) HTML rowspan attribute.
scope (Optional) HTML scope attribute.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
title (Optional) HTML title attribute.
valign (Optional) HTML valign attribute.
width (Optional) HTML width attribute.

Description

Since
6.0

112 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
dataoptionlist

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
Place this control inside of a datagrid control in the first <tr> element.

dataoptionlist

Purpose
Iterator that renders options as a HTML form option elements. Renders all of the data from the
enclosing datadropdownlist or datalistbox.

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 113
datapagesize

datapagesize

Purpose
Generates a page size control that allows the user to select the number of items in a page.

Attributes

cssclass (Optional) CSS class to apply to this control.


enabled (Optional) Whether this control is enabled (True)
or disabled (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
onselect (Optional) Event fired when the user selects
a page size value. This event is handled
immediately on the server (when the runatclient
attribute is false) or on the client (when the
runatclient attribute is true).
pagesizevalues (Optional) Comma‑separated list of integer
page‑size values for the user to select.
preference (Optional) Default value for the preferred
data page size (which the user can
override). The value can be read from a
configuration file, such as /custom/app.xml,
as the content of a dot‑separated path
of elements in the file. For example,
preference=’application.display.streamline’
would be read from the following app.xml
element path:<application>... <display>
<streamline>10</streamline> </display>
</application>
runatclient (Optional) Specifies that the onselect event is to
run on the client (True) or the server (False).

114 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datapagesize

showdisplayinginfo (Optional) Whether to show the total item count


(True) or not (False)
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control. For
example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
Cache size for the number of objects returned by a query is configurable in Databound.properties,
in /WEB‑INF/classes/com/documentum/web/form/control. Paging is configured on a JSP page that
contains a datagrid. You can limit the choices for page sizes by setting the pagesizevalues of the

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 115
datapaging

datapagesize JSP tag. You can set a default value for page size as the value of the preference attribute
on the datapagesize tag.

datapaging

Purpose
Generates navigation links for a paged datagrid. Must be used within the datagrid control. Links will
be rendered only when multiple pages of data are returned from the query.

Attributes

cssclass (Optional) CSS class to apply to this control.


gotopageclass (Optional) CSS class to apply to the optional
gotopage text box.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
showdisplayinginfo (Optional) Whether to show the displaying X of
Y items text (True) or not (False).
showfirstandlast (Optional) Whether to show the first and last
page links (True) or not (False).
showgotopage (Optional) Whether to show the optional
go‑to‑page text box (True) or not (False). Setting
this attribute to true, enables the user to jump to
any page in the dataset by entering a page value
in the text box.
showimages (Optional) Whether images (True) instead of text
links (False) are displayed. The images must be
placed in: /wdk/ theme_folder /images/paging.
If the images are not found, text links are
displayed. Default is true.

116 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datasortimage

style (Optional) CSS rule (enclosed in quotation marks,


for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) to apply to
this control.
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

datasortimage

Purpose
Generates a datasortimage control within the datagrid control. Provides an image that launches
a sort of the dataset.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 117
datasortimage

Attributes

column (Optional) Column name to which to bind. If this


control is within a celltemplate tag., you can use
the datafield attribute instead.
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Overrides the label and nlsid with
data from the current celltemplate match. A
value of CURRENT retrieves the value from the
data source.
forwardicon (Optional) URL to the forward sort icon.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
image (Required) Image file name. The path to the
image is resolved by the branding service.
mode (Optional) Sort mode: text (0), case‑insensitive
text (1), or numeric (2).
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
onclick (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
reverseicon (Optional) URL to the reverse sort icon.
reversesort (Optional) Initial sort order of the displayed
column: reverse (True), normal (False). Default
is false.
runatclient (Optional) Specifies that the onclick event is to
run on the client (True) or the server (False).
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ

118 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datasortlink

tabindex (Optional) Value (a whole number from 0 to


32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

datasortlink

Purpose
Generates a datasortlink control within the datagrid control. Provides a column header sort link that
allows the user to sort the results by column name.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 119
datasortlink

Attributes

column (Optional) Column name to which to bind. If this


control is within a celltemplate tag, you can use
the datafield attribute instead.
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Overrides the label and nlsid with
data from the current template match. A value
of CURRENT retrieves the value from the data
source.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
forwardicon (Optional) URL to the forward sort icon.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Label for the data sort link.
mode (Optional) Sort mode: text (0), case‑insensitive
text (1), or numeric (2).
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label value.
onclick (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
reverseicon (Optional) URL to the reverse sort icon.
reversesort (Optional) Initial sort order of the displayed
column: reverse (True), normal (False). Default
is false.
runatclient (Optional) Specifies that the onclick event is to
run on the client (True) or the server (False).

120 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datasortlink

style (Optional) CSS rule (enclosed in quotation


marks) to apply to this control. For
example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
If the datasortlink contains a celllist tag whose contents are resolved at runtime, make sure that the
celllist tag properly reflects the type of datafield providing the link. For example, if the datafield maps
to a custom attribute, set the hascustomattr attribute on the celllist tag to true.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 121
datatablecelllist

datatablecelllist

Purpose
Used by datatable listing pages. Extends the celllist, page 96 control.

Since
6.5

datatablefieldpanel

Purpose
Determines the set of controls to be rendered for each datatablefield, page 69 control.

Attributes

fields (Optional) List of fields that correspond to object


attribute names. This list is overridden by a list
of columns in the component definition.
hascustomattr (Optional) Whether the fields contain custom
attributes and the field is used within a
datasortlink tag (True) or not (False). Setting this
attribute to true ensures that the link is displayed
correctly for sorting.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
labels (Optional) Comma‑separated string of fields to
be displayed as labels. The values are overridden
by labels set on columns in the component
definition.

122 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datatablePagefieldpanel

name (Optional) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.
nlsids (Optional) Comma‑separated string of NLS IDs
to display. The values are overridden by labels
set on columns in the component definition.

Description
Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

datatablePagefieldpanel

Purpose
Initializes, shows, or hides the different controls required to configure datatable fields. The values in
this control are based on the dmc_datatable_schema associated with a table.

Since
6.5

datatablerowattributelist

Purpose
Lists attributes in a datatable row.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 123
datatablerowattributelist

Attributes

attrconfigid (Required) A configuration ID to identify which


control definition file should be used. Must
correspond to the value for id in &lt;attributelist
id=ʺattributesʺ&gt; in the corresponding control
definition file.
categorypost (Optional) pecifies an HTML string to render
after each category. Scripts are not supported.
Default = </th></td></tr> (closes the row)
categorypre (Optional) Specifies an HTML string to
render before each category. Scripts
are not supported. Default = <tr><td
colspan=\ʺ3\ʺ><hr></td></tr><tr><th
align=\ʺleft\ʺ>;
col1 (Optional) Specifies an HTML string
to render between the label and value.
Scripts are not supported. Default ==
</th><td><b></b>&amp;nbsp;</td><td>
col2 (Optional) Specifies an HTML string to render
between the value and validator. Scripts are not
supported. Default == </td><td>
cssclass (Optional) Sets the cascading style sheet class
that is used to format the control.
id (Optional) ID for the control. The ID is generated
by the framework. You can also set the ID in the
JSP.
morelinkpost (Optional) Specifies an HTML string to render
after the Show More link. Scripts are not
supported. Default == </td></tr>
morelinkpre (Optional) Specifies an HTML string to render
before the Show More link. Scripts are not
supported. Default == <tr><td colspan=\ʺ4\ʺ>
name (Optional) Sets the name for the control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.
object (Required) Name of associated docbaseobject
control on the JSP page.

124 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datatablerowattributelist

post (Optional) Specifies an HTML string to render


after each docbaseattribute control. Scripts are
not supported. Default == </td></tr> (closes the
row)
pre (Optional) Specifies an HTML string to
render before each docbasattribute control.
Scripts are not supported. Default == <tr><th
align=\ʺright\ʺ>
readonly (Optional) Set to true to display attributes
as read‑only. This setting does not override
or change the status of the attributes in the
repository; it only applies to the rendering of
the attribute inthe UI. The value of readonly
== ʺfalseʺ can be overridden by the attributes
component readOnly parameter.
separator (Optional) Specifies HTML to render as a
separator between attributes. Default == <tr><td
colspan = \ʺ3\ʺ><hr></td></tr>. Valid for 5.2
repositories only.
showcategorynames (Optional) Set to true to display category names
in the UI. Category name is not shown if there is
only one category or if <showpagesastabs> in the
component definition equals true.

showobjectidasname (Optional) Set to true to display the object


ID as the name of the object. This value
can be overridden by a formatter in a
docbaseobjectConfiguration file. Default == true.
size (Optional) Sets the size of the control in pixels.
style (Optional) A cascading style sheet rule enclosed
in quotation marks; for example: style=ʺ{COLOR:
darkmagenta; TEXT‑DECORATION:
underline}ʺ.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 125
duedate

tabindex (Optional) Value (a whole number from 0 to


32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
visiblecategory (Optional) Comma‑separated string that specifies
the categories that are visible. Default == null (all
categories are visible)

Description
Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

duedate

Purpose

Since
6.5

126 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
listbox

listbox

Purpose
Holds option objects or a single dataoptionlist control holding a databound option.

Attributes

cssclass (Optional) CSS class to apply to this control.


enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False).
height (Optional) Vertical length of the drop down list
control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
multiselect (Optional) Whether to enable (True) or disable
(False) multiple selection in the listbox.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
onchange (Optional) Event that is fired when this control is
changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted. The onchange event
handler cannot run on the client (that is, the
runatclient attribute cannot be true).
onselect (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true). The form is not submitted until the
onselect event is fired.
runatclient (Optional) Specifies that the onselect event is to
run on the client (True) or the server (False).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 127
listbox

size (Optional) Number of rows of selectable data


visible in the listbox (scrollbars are used if more
rows are available).
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control. For
example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
value (Optional) The selected value.
visible (Optional) (Boolean) Whether the control is
rendered as visible (True) or hidden (False).
width (Optional) Horizontal length of the drop down
list control.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

128 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
multiselector

Usage
The multiselect attribute is only available if you retrieve the value in client‑side JavaScript.
Multiple selections are not passed to the component, because no server event is fired. For an
example of a client‑side implementation that retrieves multiple selections in the listbox, refer to
searchsources_preferences.jsp and changesearchsources.jsp.

multiselector

Purpose
Displays two lists. User can select items from a list and order the selected items. Items are moved
between the unselected and selected list with Add and Remove buttons. Items are ordered on the
selected items list with Up and Down buttons.

Attributes

buttoncssclass (Optional) CSS class to apply to button


appearance.
buttoncssstyle (Optional) CSS rule to apply to button
appearance.
buttonheight (Optional) Height (in pixels) of the button.
buttonimagefolder (Optional) Location of the image folder, if
buttons are used to display items.
buttonwidth (Optional) Width (in pixels) of the button.
disabledclass (Optional) CSS class to apply to the disabled
control.
disabledstyle (Optional) Entire CSS‑syntax style sheet rule
(enclosed in quotes) to apply to the disabled
control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 129
multiselector

items (Optional) Serialized list of items to display in


the available items listbox. The list must be a
String array with value and label pairs (value
must occur in the first position).
itemslabel (Optional) Label for the available items list.
itemsnlsid (Optional) NLS string for the available items list
label.
listboxcssclass (Optional) CSS class to apply to listboxes.
listboxcssstyle (Optional) CSS rule to apply to listboxes.
listboxwidth (Optional) Width (in pixels) of listboxes. Default
is 200.
multiselect (Optional) Whether to enable (True) or disable
(False) selection of multiple items for Add or
Remove. If a move operation is chosen, only the
first selection is moved. Default is false.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
orderingenabled (Optional) Whether to enable (True) or disable
(False) Up and Down buttons, which change the
order of the list. Default is true.
selecteditems (Optional) Serialized list of items to appear in the
selected items listbox.
selecteditemslabel (Optional) Label for the selected items list.
selecteditemsnlsid (Optional) NLS string for the selected items list
label.
size (Optional) Size of the listboxes. Default is 10.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

130 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
multiselector

Usage
The component can retrieve a list of selected items from the control by calling getSelectedItems() on
the control. The buttons trigger client side events so that the client doesn’t have to make a round trip
to the server every time a button is selected. When a trip to the server is made the control will update
its data on the server side via a hidden field that keeps an updated item list.
The List object that holds items has the following features:
• Each element in a List represents one item.
• The element can be a String, which is a value with no label.
• The element can be an array of one String
• A serialized list of items can be an array of one string (value) or two strings (value and label).
If you supply the lists of available and selected columns in the JSP page, then the list must be
serialized to a string before passing it in to the control. (You can create the serialized string from an
ArrayList using the MultiSelectorUtil class static method encodeItemList(). If you supply a list in
your component class, pass it in as ArrayList.
In the following example from the VisibleRepositoryPreferences class, the class gets the controls
on the JSP page, calls methods that get the ArrayList for each control, and initializes the items and
selected items lists:
public void onInit(ArgumentList args)
{
super.onInit(args);
...
MultiSelector mltRepositories = (MultiSelector)getControl(
REPOSITORY_SELECTOR, MultiSelector.class);
mltRepositories.setSize("10");

//Get selected connection broker and port


DataDropDownList docbrokerControl = (DataDropDownList) getControl(
CONTROL_DOCBROKER,DataDropDownList.class);
Label docbrokerPortNumberControl = (Label) getControl(
CONTROL_DOCBROKER_PORT,Label.class);

//Get all repositories for this connection broker


ArrayList arrDocbases = getInvisibleRepositories(
docbrokerControl.getValue(), docbrokerPortNumberControl.
getLabel());
//Write the list to the available repositories list
mltRepositories.setItems(arrDocbases);

//Get previously selected repositories, set to selected items list


mltRepositories.setSelectedItems(getVisibleRepositories());
}

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 131
nodataRow

nodataRow

Purpose
Supplies a row of static data that will be automatically displayed if the enclosing datagrid returns no
data rows from the query. Must be contained within the datagrid control. You must provide <td>
tags and content within the opening and closing nodatarow tags.

Attributes

align (Optional) Horizontal alignment of the cells.


cssclass (Optional) CSS class to apply to this control.
height (Optional) Height of the row.
id (Optional) ID for this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
style (Optional) CSS rule (enclosed in quotation marks,
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) to apply to
this control.
valign (Optional) Vertical alignment of the cells.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

132 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
row

row

Purpose
Generates a static header or footer HTML table row inside the data grid control. Adds the static data
row above or below the dynamic datagridrows. Can be used in place of <tr>. Use only in pages where
your component needs to access controls in the row.

Attributes

align (Optional) Horizontal alignment of the cells.


cssclass (Optional) CSS class to apply to this control.
height (Optional) Height of the row
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.

name (Optional) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.
style (Optional) CSS rule (enclosed in quotation marks,
for example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ) to apply to
this control.
valign (Optional) Vertical alignment of the cells.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 133
showhide

showhide

Purpose
Enables a user to show and hide object attributes.

Attributes

enabled (Optional) Whether this control is enabled (True)


or disabled (False).
hidenlsid (Optional) NLS key for the localized Hidden
label string.
hidetooltipnlsid (Optional) NLS key for the localized Hide tooltip
string.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
imagehidecssclass (Optional) Sets the cascading style sheet
class that is used to format the Hide image.
Default is the disclosureTriangleOpen CSS
class, which is defined in the wdk\theme\
documentum\css\webforms.css file.
imageshowcssclass (Optional) Sets the cascading style sheet
class that is used to format the Show image.
Default is the disclosureTriangleClosed CSS
class, which is defined in the wdk\theme\
documentum\css\webforms.css file.
imagestyle (Optional) CSS rule for the Show/Hide images.
For example: style="(COLOR: darkmagenta)”.
The CSS rule must be enclosed in quotation
marks.

inlinerefresh (Optional) To perform an inline (True) or full


page (False) refresh on this control and on its
associated panel (specified in the panelname
attribute) when the user clicks on it. Default is
true.

134 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
showhide

labelcssclass (Optional) Sets the cascading style sheet class


used to format the Show/Hide label. Default is
showMoreHideMoreLink, which is defined in the
wdk\theme\ documentum\css\webforms.css
file.
labelstyle (Optional) A cascading style sheet rule (enclosed
in quotation marks) for the Show/Hide label;
for example: style="{COLOR: darkmagenta;
TEXT­DECORATION: underline}"
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
panelname (Required) Name of the panel to show or hide as
specified by the show attribute.
show (Optional) To show (True) or hide (False) the
content of its associated panel (specified by the
panelname attribute). Default is false.
shownlsid (Optional) NLS key for the localized Show label
string.
showtooltipnlsid (Optional) NLS key for the localized Show
tooltip string.
tabindex (Optional) Sets the tab index.
visible (Optional) (Boolean) Whether the control is
rendered as visible (True) or hidden (False).

Description

Since
6.5

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 135
trafficlighticon

trafficlighticon

Purpose
Represents an icon for a traffic light datatable field.

Since
6.5

Data validation

absolutefilepathvalidator

Purpose
Validates a string file path using DFC utilities.

Attributes

controltovalidate (Required) Name of the control to validate.


cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
errormessage (Optional) Error message displayed when
validation fails.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

136 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
comparevalidator

nlsid (Optional) NLS lookup key. The string


corresponding to the NLS ID is substituted for
the errormessage attribute value.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

comparevalidator

Purpose
Validates an input control by comparing its value to a specified value or to another input control.

Attributes

comparecontrol (Optional) Name of the input control that


contains the value with which to compare the
current value. Overrides the comparevalue
attribute.
comparevalue (Optional) Value to compare with the current
value.
controltovalidate (Required) The control to validate.
cssclass (Optional) CSS class to apply to this control.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 137
comparevalidator

enabled (Optional) Whether this control is enabled (True)


or disabled (False).
errormessage (Optional) Error message to display when
validation returns false.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the errormessage attribute value.
operator (Optional) Comparison operator. Valid
values are: equal, notequal, greaterthan,
greaterthanequal, lessthan, lessthanequal.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
type (Optional) Datatype of the value. Valid values
are: string, integer.
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

138 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datetimevalidator

datetimevalidator

Purpose
Verifies that the date input for a control matches a valid pattern, such as ʺmm dd yyyyʺ, or ʺmm dd
yyyy hh:mi:ssʺ. This validator does not need to be used on datetime controls, because the input
control displays only valid choices for the user.

Attributes

controltovalidate (Required) Name of the control to validate.


cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
errormessage (Optional) Error message displayed when
validation fails.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the errormessage attribute value.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description
Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 139
datevalidator

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

datevalidator

Purpose
Verifies that the dateinput control value is a valid date for the user’s locale. This validator does not
need to be used on dateinput controls, because the input control displays only valid choices for the
user. The name and controltovalidate attributes are required. This control cannot be used to validate
any control other than dateinput.

Attributes

controltovalidate (Required) Name of the control to validate


cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
errormessage (Optional) Error message to display when
validation fails.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the errormessage attribute value.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

140 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseattributevalidator

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

docbaseattributevalidator

Purpose
Renders several validators for attributes: inputmaskvalidator, multivaluesinputmaskvalidator,
requiredfieldvalidator, and varequiredfieldvalidator. This validator (and its included validators) is
generated by the docbaseattributevalue control, so that validation is performed automatically on
attributes.

Attributes

controltovalidate (Required) Name of the input control to validate.


enabled (Optional) Whether this control is enabled (True)
or disabled (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 141
docbasemultiobjectsvalidator

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
If you use a docbaseattributevalue control to render an attribute value, you do not need to use this
validator.

docbasemultiobjectsvalidator

Purpose
Validates changes to all attributes that are common between multiple, selected objects.

Attributes

controltovalidate (Required) Name of the input control to validate.


header (Optional) Summary header message.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the header attribute value.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description

Since
5.x

142 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseobjectattributevalidator

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

docbaseobjectattributevalidator

Purpose
Validator used to validate any control that is associated with a docbaseobject. Deprecated as of version
6. See docbaseattributeproxy, page 45.

Attributes

attribute (Required) Attribute against which the control’s


selected value is to be validated.
controltovalidate (Required) Name of the input control to validate.
cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
errormessage (Optional) Message displayed when validation
fails.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the errormessage attribute value.
object (Required) Name of the docbaseobject tag on
the JSP page. In the following example, the
object being validated is named ʺobj, so the
value of the object parameter for this validator
would be ʺobj:<dmfx:docbaseobject name=ʺobjʺ
configid=ʺattributesʺ/>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 143
docbaseobjectvalidator

style (Optional) CSS rule (enclosed in quotation


marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
This control is used only to validate attributes that are listed as ignored attributes in a
docbaseattributelist configuration. For example, the list of available formats is displayed by the
datadropdownlist control named ʺformatListʺ in the Webtop import JSP page, and the user’s selection
should be validated against object constraints for the selected object type. The format attribute is listed
in the <ignore_attributes> element of import_docbaseattributelist.xml. In order for the selection to be
validated, use the validator to validate the control on the JSP page, similar to the following:
<dmf:docbaseobjectattributevalidator
name="docbaseobjectvalidator_attr1"
object="docbaseObj" controltovalidate="
formatlist" attribute="a_content_type"/>

docbaseobjectvalidator

Purpose
Validates all modified attribute control values against all rules that have been set up in the Content
server. Renders a list of error messages for all failed validators. This validator is embedded in the
docbaseobject control, so validation is performed automatically on attributes that have been modified
by the user.

144 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseobjectvalidator

Attributes

controltovalidate (Required) Input control name to validate


cssclass (Optional) Sets the CSS class that is applied to
this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
header (Optional) Header for error message.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is the error message
for validation failure.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 145
inputmaskvalidator

inputmaskvalidator

Purpose
Validates a control’s input values based on an input mask.

Attributes

controltovalidate (Required) Name of the control to validate.


cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
errormessage (Optional) Error message to display when
validation fails.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
inputmask (Optional) Pattern of valid ASCII characters that
the user can enter. This control verifies that the
length of the input string is the same number of
characters specified in this attribute.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the errormessage attribute value.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
validatechangeonly (Optional) Since: 6.0.Indicates whether to
validate only when the control changes. True, to
validate only when the control changes; False
(default), otherwise.
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

146 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
inputmaskvalidator

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage

An input mask is a pattern of mask characters and literals. A mask character specifies the kind of
character allowed at that position in the pattern. A literal is an ASCII character that must appear in
the pattern at that position. To convert a mask character to a literal, precede the mask character
with a double backslash (\\) .

Table 8. Valid Mask Characters

Character Meaning
# Numeric (0‑9)

A Alphanumeric (0‑9, a‑z, A‑Z)

& Any ASCII character

? Alphabetic (a‑z, A‑Z)

U Alphabetic, and converts to uppercase

L Alphabetic, and converts to lowercase

Masks

This table shows a mask in the first column, an example of valid user input in the second column, and
a description of the mask in the last column. The last mask example limits the number of characters
to thirteen.

Mask User Input Description


##/##/#### 12/25/1999 Date
##:## UU 12:35 AM Time
###­##­#### 123­45­6789 US social security number (SSN)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 147
multiobjectsdocbaseattributevalidator

Mask User Input Description


(###)###­#### (999)555­1212 US phone number
#####­#### 12345­6789 US zip code
????????????? John Name (limited to thirteen characters)

multiobjectsdocbaseattributevalidator

Purpose
Renders a valildator corresponding to the type of the common attribute of the selected, multiple objects.

Attributes

controltovalidate (Required) Name of the input control to validate.


id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

148 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
multivaluesinputmaskvalidator

multivaluesinputmaskvalidator

Purpose
Validates multiple values in a label using an input mask.

Attributes

controltovalidate (Required) Name of the control to validate


cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
errormessage (Optional) Error message displayed when
validation fails.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
inputmask (Optional) Pattern of valid ASCII characters that
the user can enter. This control verifies that the
length of the input string is the same number of
characters specified in this attribute. For more
information, see .
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the errormessage attribute value.
separator (Optional) Character to separate input values.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 149
multivaluesrequiredfieldvalidator

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

multivaluesrequiredfieldvalidator

Purpose
Validates that all of the required values in a list box have been set

Attributes

controltovalidate (Required) Name of the control to validate.


cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
errormessage (Optional) Error message to display when
validation returns false.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
indicator (Optional) String to display next to a required
field. If this attribute is empty (that is, indicator
= ʺʺ), an asterisk (*) is displayed. Default is an
asterisk (*).
indicatorcssclass (Optional) Class in a stylesheet to apply to the
indicator.
indicatornlsid (Optional) NLSID that resolves to a string to
display as a required field indicator.
indicatorstyle (Optional) CSS style rule to apply to the
indicator.

150 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
quotevalidator

name (Required) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the errormessage attribute value.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

quotevalidator

Purpose
Tests the string contents of an input control for single ( ’ ) or double quotation marks ( ʺ ). Returns
true, if the string does not contain a quotation mark or the string is empty; returns false, if the string
contains a quotation mark.

Attributes

controltovalidate (Optional) Name of the control to validate.


cssclass (Optional) CSS class to apply to this control.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 151
quotevalidator

enabled (Optional) Whether this control is enabled (True)


or disabled (False).
errormessage (Optional) The error message to display when
validation fails.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
ignore (Optional) Whether to ignore a single quote
or double quotes in the string. Valid values:
singlequote, doublequote, or an empty string
(default). For example, if you want to test for
double quotes only, set the value of this attribute
to singlequote. An empty string means that
neither double quotes nor single quotes are
ignored.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the errormessage attribute value.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

152 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
rangevalidator

rangevalidator

Purpose
Validates an input control by ensuring that its value is within a specified range.

Attributes

controltovalidate (Required) Control to validate.


cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
errormessage (Optional) Error message to display when
validation returns false.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
maxvalue (Optional) The range’s maximum value.
maxvaluecontrol (Optional) Input control containing the range’s
maximum value.
minvalue (Optional) The range’s minimum value.
minvaluecontrol (Optional) Input control containing the range’s
minimum value.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the errormessage attribute value.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 153
regexpvalidator

type (Optional) Datatype of the value. Valid values


are: string, integer, double.
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

regexpvalidator

Purpose
Verifies that the input control value matches the specified Apache regular expression pattern. For
information about Apache expression syntax, see the Apache Web site.

Attributes

controltovalidate (Required) Control to validate.


cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
errormessage (Optional) Error message to display when
validation returns false.
expression (Required) Regular expression to match.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.

154 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
requiredfieldvalidator

name (Required) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the errormessage attribute value.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

requiredfieldvalidator

Purpose
Validates an input control by ensuring that its value has been set.

Attributes

controltovalidate (Required) Control to validate.


cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 155
requiredfieldvalidator

errormessage (Optional) Error message to display when


validation returns false.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
indicator (Optional) String to display next to a required
field. If this attribute is empty (that is, indicator
= ʺʺ), an asterisk (*) is displayed. Default is an
asterisk (*).
indicatorcssclass (Optional) Class in a stylesheet to apply to the
indicator.
indicatornlsid (Optional) NLSID that resolves to a string to
display as a required field indicator.
indicatorstyle (Optional) CSS style rule to apply to the
indicator.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the errormessage attribute value.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

156 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
symbolicversionlabelvalidator

symbolicversionlabelvalidator

Purpose
Ensures that the symbolic version label entered by the user is not an implicit version label.

Attributes

controltovalidate (Required) Name of the control to validate.


cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is the error message
for validation failure.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 157
utf8stringlengthvalidator

utf8stringlengthvalidator

Purpose
Verifies that the string in its UTF8 representation does not exceed the field limit, to prevent data loss
when accented or double‑byte characters are entered. Converts the user input string value to its
corresponding UTF‑8 byte array before comparing it with the specified maximum byte length value.

Attributes

controltovalidate (Required) Control to validate.


cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
errormessage (Optional) Error message to display when
validation returns false.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
maxbytelength (Required) Maximum length (in byles) of the
UTF‑8 byte array corresponding to the user input
string.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the errormessage attribute value.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

158 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
validationsummary

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
This validator can be used to replace the regexpvalidator to validate that string character length
confirms to the field size constraint in the data dictionary. For multi‑byte and accented characters, the
regexpvalidator cannot do this validation and can result in data loss.
For example, the checkin page allows the user to enter a version label that, according to the data
dictionary, must be no longer than 32 single‑byte characters. This validator will not allow a version
label that exceeds 32 bytes.

validationsummary

Purpose
Displays a summary list of failed validation messages for all validated input controls.

Attributes

cssclass (Optional) CSS class to apply to this control.


header (Optional) Summary header message.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID for the summary
header message string.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control. For
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 159
dateinput

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Date/time

dateinput

Purpose
Generates a date input control. The order (day and month) will be determined by the user’s locale.
The months and days will be listed as integers and their labels are looked up in the localization
bundle form.control.DateInputNlsProp.

Attributes

cssclass (Optional) CSS class to apply to this control.


dateformat (Optional) Format of the date displayed in
the user interface. Valid values are: short (for
example, 1/2/02), medium (for example, 2 Jan,
2002), long (for example, 2 January, 2002).
dateselector (Optional) Date selection user interface item.
Valid values are: fields (dropdown fields),
calendar (a popup calendar). Default is calendar.
day (Optional) Default day to display. Default is 1.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
fromyear (Optional) Year to begin the available date range.
Default is 1997.

160 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
dateinput

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
month (Optional) Default month to display. Default is 1.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
onselect (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
runatclient (Optional) Specifies for the onselect event to run
on the client (True) or the server (False).
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
toyear (Optional) Year to end the available date range.
Default = 2005.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 161
dateinput

visible (Optional) (Boolean) Whether the control is


displayed (True) or hidden (False).
width (Optional) Width (in pixels) of the control.
Default is 200.
year (Optional) Default year to display. By default,
the fromyear attribute value is displayed.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
In addition to the configuration available on individual date controls, global date input display can be
configured by extending /wdk/config/datetimecontrol_config.xml. The following table describes date
input control configuration in this file:0

Table 9. Global date input control configuration elements

<dateinput> Configures all instances of dateinput


tag including those generated by the
docbaseattributelist control. Can be
overridden on an individual tag. Contains
<default‑year‑from>, <default‑year‑to>, and
<default_type>.
.<default‑year‑from> Sets the default beginning year in the date input
dropdown list
.<default‑year‑to> Sets the default end year in the date input
dropdown list

Editable attributes are rendered as dateinput controls. To configure the rendered control, set the
beginning and end year in the <dateproperties> element of /wdk/app.xml.
When you want to set a date programmatically in your component class, clear the dateinput control by
calling clear(), which clears day, month, and year. For example:
private void resetDateInputControl(DateInput date)
{
if (date != null)

162 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datetime

{
date.clear();
}
}

datetime

Purpose
Generates a date/time control that allows the user to select month, day, year, hour, minute, and second.
The date and time labels are looked up in the localization bundle form.control.DateTimeNlsProp.

Attributes

cssclass (Optional) CSS class to apply to this control.


datafield (Optional) Overrides all of the date and time
values with data from a data source.
dateformat (Optional) Format of the date displayed in
the user interface. Valid values are: short (for
example, 1/2/02), medium (for example, 2 Jan,
2002), long (for example, 2 January, 2002).
dateselector (Optional) Date selection user interface item.
Valid values are: fields (dropdown fields),
calendar (a popup calendar). Default is calendar.
day (Optional) Default day to display. Default is 1.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
fromtime (Optional) Time to begin a range when the
timeselector value is list; for example: hh:mm:ss
fromyear (Optional) Year to begin the available date range.
Default is 1997.
hour (Optional) Default hour to display. Default is
the current time.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 163
datetime

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
minute (Optional) Default minute to display. Default is
the current time.
month (Optional) Default month to display. Default is 1.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
onselect (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
runatclient (Optional) Specifies for the onselect event to run
on the client (True) or the server (False).
second (Optional) Default second to display. Default is
the current time.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.

164 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datetime

timeformat (Optional) Specifies how the time is formatted


in the user interface and the control value (in
locale‑specific format). Valid values: short (for
example, rendered as 2:40 PM in English locale),
medium (for example, 2:40:23 PM), long (for
example, 2.40:23 PM PST)
timeselector (Optional) Time selection user interface item.
Valid values are: fields (Default) Dropdown lists
that display hour, minute, and day. Increments
are set by the value of the timestep attribute. list
Single dropdown list of discrete times displayed
as the values for timeformat, fromtime, totime,
and timestep. text Text box that accepts text
input of any kind.
timestep (Optional) Iincrement (in seconds) between
times that are displayed when the timeselector
attribute value is list or fields. If the timeselector
value is fields and the timestep value is a
multiple of 60 or 3600, the seconds and minutes
fields are not hidden. Default is 1800.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
totime (Optional) Time to end a range when the
timeselector attribute value is list; for example,
hh:mm:ss.
toyear (Optional) Year to end the available date range.
Default is 2005.
visible (Optional) (Boolean) Whether the control is
rendered as visible (True) or hidden (False).
width (Optional) Width (in pixels) of the control.
Default is 200.
year (Optional) Default year to display. By default,
the fromyear attribute value is displayed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 165
datetime

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
In addition to the configuration available on individual date controls, global date display can be
configured by extending /wdk/config/datetimecontrol_config.xml. The following table describes
datetime control configuration in this file:

Table 10. Global datetime control configuration elements

<datetime> Sets the default date format type for all


instances of the datetime control, including
those generated by docbaseattributelist control.
Overridden by the dateformat and timeformat
attributes on the datetime control.
.<default_type> Specifies the type of Java DateFormat to apply
(examples in parentheses). Valid values: short
(12.13.52 or 3:30 pm) medium (Jan 12, 1952 3:30
pm) long (January 12, 1952 3:30:32 pm) full
(Tuesday, April 12, 1952 AD 3:30:42 pm PST)

When you want to set a date and time programmatically in your component class, clear the datetime
control by calling clear(), which clears day, month, and year. For example:
private void resetDateTimeControl(DateTime dt)
{
if (dt != null)
{
dt.clear();
}
}

Not all fields must be set for the control to be valid. The following table shows the state of each
field and whether the combined state returns true for isValid(), isValidDate(), isValidTime(), and the
value that will be displayed:

Yr/Mo/ Hour Min Sec isValid isValid isValid Value


Day Date Time
not set F F F blank

166 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datevalueformatter

Yr/Mo/ Hour Min Sec isValid isValid isValid Value


Day Date Time
all set null set set F T F blank
all set null null set F T F blank
all set set null set F T F blank
all set null null null T T F date,00:
00:00
all set set null null T T T date, hr:
00:00
all set set set null T T T date, hr:
min:00
all set set set set T T T date, hr:
min:sec

datevalueformatter

Purpose
Datevalueformatter control. Wraps a raw date value in milliseconds since 1970 and replaces the value
with a formatted date value.

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
type (Optional) Format of the date to display. Maps
to the Java DateFormat types; such as ʺshort,
ʺmedium, ʺlong, ʺfull.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 167
dragdrop

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage

Table 11. Global datetime control configuration elements

<datevalueformatter> Sets the default date format for all instances of


the datevalueformatter control. Overridden by
the type attribute on the datevalueformatter
control.
.<default_type> Specifies the type of Java DateFormat to apply
(examples in parentheses). Valid values: short
(12.13.52 or 3:30 pm) medium (Jan 12, 1952 3:30
pm) long (January 12, 1952 3:30:32 pm) full
(Tuesday, April 12, 1952 AD 3:30:42 pm PST)

Deprecated controls

Drag and drop

dragdrop

Purpose
Indicates that one or more dragdropregion tags, or controls that implement drag and drop interfaces,
are defined on the page

168 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
dragdropregion

Attributes
None.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
To support drag and drop on the page, add the dragdrop tag to the page and a dragdropregion tag
that contains controls to support a drag or drop (or both) operation. If you have a browsertree in your
page, you do not need a dragdrop region tag: the browsertree control has an ondrop attribute.
For more information about drag and drop, see Web Development Kit Development Guide.

dragdropregion

Purpose
Specifies that the contained control or controls support drag and/or drop operations. The specific
operations are named in the control attributes.

Attributes

cssclass (Optional) CSS class to apply to this control.


datafield (Optional) Overrides label or NLS value with
string from a data source
dragenabled (Optional) Whether dragging the control is
supported (True) or not (False).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 169
dragdropregion

dragenableddatafield (Optional) Alternative method of specifying


whether the control supports dragging. The
value of the attribute is used as a key to retrieve
whether dragging of the control is supported.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
enableddroppositions (Optional) Drop positions that are supported by
the control. Valid values is a comma separated
combination of above, below, and over.
enableddroppositionsdatafield (Optional) Alternative method of specifying the
type of drop positions that is supported. The
value of the attribute is used as a key to retrieve
the action drop positions.
focus (Optional) Whether this control accepts focus
(True) or not (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
isbackground (Optional) Whether the dragdrop region is the
page background (True) or not (False).
label (Optional) Label for dragdrop region.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label attribute value.
ondrop (Optional) Specifies the name of a method that
handles the ondrop event. You must enter a value
here and set a value for enableddroppositions to
enable drop operations.
ondropdatafield (Optional) Alternative method of specifying the
name of the drop handler function. The value
of the attribute is used as a key to retrieve the
actual drop handler function
runatclient (Optional) Whether the ondrop event is to run
on the client (True) or the server (False).

170 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
dragdropregion

style (Optional) CSS rule (enclosed in quotation


marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipdatafield (Optional) Datafield that overrides the value of
tooltip and tooltipnlsid.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
visible (Optional) (Boolean) Whether the control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
To support drag and drop on the page, add the dragdrop tag to the page and a dragdropregion tag
that contains controls to support a drag or drop (or both) operation. If you have a browsertree in your
page, you do not need a dragdrop region tag: the browsertree control has an ondrop attribute.
To enable drop operations, set an ondrop event handler for the ondrop attribute and specific one or
more supported drop positions for the enableddroppositions attribute. To enabled drag operations, set
the dragenabled attribute to true. You can enable both operations for a region.
Following are some examples of drag and drop regions:
• label in clipboard.jsp
dragenabled=’true’
• datagrid in /rooms/doclist_body.jsp
enableddroppositions=ʺ<%=IDropTarget.DROP_POSITION_OVER%>ʺ
ondrop=’onDrop’
Note: This dragdropregion tag contains another nested dragdropregion tag that enabled drag
• link in vdmlist_streamline.jsp
ondrop=’onDrop’ enableddroppositions=’above,over,below’ dragenabled=’true’

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 171
form

For more information about drag and drop, see Web Development Kit Development Guide.

Explorer

Framework

form

Purpose
Generates an HTML form on a Web page.

Attributes

enctype (Optional) Form data encoding type.


Valid values are: multipart/form‑data |
application/x‑www‑form‑urlencoded |
text/plain. Set to ʺmultipart/form‑data on pages
that upload file content such as check in, import
and import rendition.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
keepfresh (Optional) Whether to keep the form refreshed
(True) or not (False). If the browser loads the
form without sending a request back to the server
(for example, when the user hits the Back button)
a server post‑back event is generated to render
the component again. If the component is within
a container, the container URL is refreshed.

172 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
webform

name (Optional) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.
onkeepfresh (Optional) JavaScript (client‑side) event handler
for the keepfresh event that is triggered when
the user hits the Back button. In the Form class
implementation, this method provides a URL for
the refresh event. Your handler can override this
implementation.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

webform

Purpose
Outermost tag containing all other taglib tags on a page. This represents the entire HTML page.
Generates included JavaScript file references.

Attributes

formclass (Optional) Java class containing the event


handler functions that are called when events
are fired. If the JSP page is in a component, do
not specify this attribute, because the component
class handles events.
nlsbundle (Optional) NLS bundle that is used by all the
controls in the form. If the JSP page is in a

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 173
fireclientevent

component, the component class specifies the


nlsbundle attribute value.
nlsclass (Optional) Java NLS class that is used by all
the controls in this form. If the JSP page is in a
component, the component class specifies the
nlsclass attribute value.
validation (Optional) Whether to prevent (False) validation
of controls on the form or not (True). Default is
true. Only set to false when in development.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Generating client and server events

fireclientevent

Purpose
Fires a client JavaScript event when the JSP page is loaded. Can contain one or more <dmf:argument>
controls to pass values to the event handler. Used by the application integrations framework.

Attributes

enabled (Optional) Whether this control is enabled (True)


or disabled (False).
event (Required) Name of an event handler on the
client.

174 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
firepresubmitclientevent

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
includeargname (Optional) Whether to pass event argument
names and values to the handler (True) or only
the value to the handler (False). Default is false.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

firepresubmitclientevent

Purpose
Fires a client JavaScript event before submitting the control event to the server. Can contain one
or more <dmf:argument> controls to pass values to the event handler. Used by the application
integrations framework.

Attributes

controlid (Optional) Name of the control for which to fire


the event. The event is fired for any control
onclick event. If this attribute’s value is not
specified (default), then the client event is fired
before form submission.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 175
postserverevent

event (Required) Name of an event handler on the


client. If a controlid is specified, the event fires
only for the named control.
id (Optional) ID for this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
includeargname (Optional) Whether to pass event argument
names and values to the handler (True) or only
the value to the handler (False). Default is false.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

postserverevent

Purpose
Renders a postServerEvent() JavaScript call to a method in a class on the J2EE application server.
This tag is used within a JavaScript function.

Attributes

clientsidehandlermethod (Optional) (WDK for Portlets only) Name of the


client side JavaScript handler function.
controlid (Optional) ID of the control that fires the event.

176 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
postserverevent

eventargname (Optional) Name of an argument to be passed


to the method specified in the handlermethod
attribute. The argument value to be passed is
specified in the eventargvalue attribute.
eventargname2 (Optional) Name of an argument to be passed
to the method specified in the handlermethod
attribute. The argument value to be passed is
specified in the eventargvalue2 attribute.
eventargname3 (Optional) Name of an argument to be passed
to the method specified in the handlermethod
attribute. The argument value to be passed is
specified in the eventargvalue3 attribute.
eventargname4 (Optional) Name of an argument to be passed
to the method specified in the handlermethod
attribute. The argument value to be passed is
specified in the eventargvalue4 attribute.
eventargvalue (Optional) Value of an argument to be passed
to the method specified in the handlermethod
attribute. The argument name is specified in the
eventargname attribute.
eventargvalue2 (Optional) Value of an argument to be passed
to the method specified in the handlermethod
attribute. The argument name is specified in the
eventargname2 attribute.
eventargvalue3 (Optional) Value of an argument to be passed
to the method specified in the handlermethod
attribute. The argument name is specified in the
eventargname3 attribute.
eventargvalue4 (Optional) Value of an argument to be passed
to the method specified in the handlermethod
attribute. The argument name is specified in the
eventargname4 attribute.
formid (Optional) ID of the current form, for example,
’<%=form.getElementName()%>’
handlerid (Optional) ID of the control that handles the
event.
handlermethod (Optional) Server method to be called. Required
for standalone Web application; optional for
WDK for Portlets.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 177
clientenvpanel

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
The following example from advsearchex.jsp renders a JavaScript function call to postServerEvent(),
which in turns calls the event handler executeSavedSearch() in the AdvSearchEx class. The class
containing the event handler must be imported in the JSP page::
<%@ page import="com.documentum.webcomponent.library.advsearch.AdvSearchEx" %>
...
function executeSavedSearch()
{
<dmf:postserverevent formid='<%=strPostToForm%>' handlerid='
<%=advsearch.getElementName()%>' handlermethod='
executeSavedSearch'/>
}

Grouping user interface elements

clientenvpanel

Purpose
Generates a panel that is displayed or hidden depending on the client environment. For example,
the WDK login JSP page has one panel for the Application Connectors environment and another one
for the non‑connector environment.

178 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
clientenvpanel

Attributes

environment (Optional) String that specifies the client


environment, which is specified in the
application/environment/clientenv element of
the app.xml.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
reversevisible (Optional) Whether the panel is visible (False) or
the reverse of the current visibility state (True) of
the environment specified by the environment
attribute. You can usually set this attribute to
true to hide the panel. Default is false.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
Your application can display different content depending on whether the client is using a Application
Connector within a Microsoft Office application. For example, the WDK login page contains two login
buttons. The button for the non‑connector environment specifies a server‑side event handler as follows:
<dmfx:clientenvpanel environment="appintg" reversevisible="
true">
<dmf:button ...onclick="onLogin"/>
</dmfx:clientenvpanel>

The button for the connector environment specifies an event handler on the client opens a browser
window for the application connector:
<dmfx:clientenvpanel environment="appintg">
<script>
function onLogin()
{
try

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 179
pane

{
window.external.AppIntgProcessEvent("event=OnLogin");
}
...
postServerEvent(null, null, null, "onLogin");
}
</script>
</dmfx:clientenvpanel>
...
<dmfx:clientenvpanel environment="appintg">
<dmf:button ...onclick="onLogin" runatclient="true"/>
</dmfx:clientenvpanel>

pane

Purpose
Pane control contained within a paneset control. Displays content that can be fixed or scrolled. For
information about general scrollable paneset design, see Web Development Kit Development Guide.

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Required) Name for this control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.
overflow (Optional) Whether to generate a scroll bar
(auto) or clip excessive content (hidden), if the
content exceeds the scrolling area. Default is
auto. Specify hidden for fixed panes, such as
headers and footers.
printable (Optional)

180 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
panel

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

panel

Purpose
Panel control that wraps a group of controls as a mechanism for hiding or displaying the group.

Attributes

datafield (Optional) Overrides the visible attribute value.


id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
mode (Optional) Whether the datafield attribute value
is a string or boolean. Default is string. If this
attribute value is string and the datafield value’s
string length is greater than 0, then the datafield
attribute value is true. If this attribute value is
boolean and the datafield attribute value is 1, T,
or true, then the datafield attribute value is true.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 181
panel

renderifinvisible (Optional) True: render the panel content and


hide it even if the panel’s visible attribute is set
to ʺfalseʺ. False: do not render the panel content
when the visible attribute is set to ʺfalseʺ. Default
is ʺfalseʺ.

This feature supports inline refresh functionality


for panel content. For inline refresh to work
when the panel is in a table, the cssclass attribute
of the HTML elements, which are enclosed by
the panel, must be set to the panel name.

Since: 6.5
reversevisible (Optional) Whether the visible attribute is the
boolean complement of the datafield attribute
value (True) or not (False). Default is false. For
example, when this attribute is set to true and
the datafield value (in boolean mode) is true,
then the visible attribute value is false.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
Panels can be used to display or hide elements within the JSP. For example, the newnotepage
component hides a panel in onInit():
Panel panel = (Panel) getControl("optionspanel", Panel.class);
panel.setVisible(false);

The panel is then displayed in onClickShowHideOptions(), which is called when the user clicks the
Show/Hide options checkbox:
Panel panel = (Panel) getControl("optionspanel", Panel.class);
if (m_bShowOptions == true)
{

182 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
paneset

panel.setVisible(true);
linkShowHideOptions.setLabel(getString("MSG_HIDE_OPTIONS"));
}
else
{
panel.setVisible(false);
linkShowHideOptions.setLabel(getString("MSG_SHOW_OPTIONS"));
}

The options panel and link that makes it visible are coded in the JSP page is as follows:
<table border="0" cellpadding="2" cellspacing="0" width="100%">
<% /* Options */ %>
<tr>
<td colspan="2" nowrap>
<dmf:link name="showhideoptions" nlsid="
MSG_SHOW_OPTIONS" onclick="onClickShowHideOptions"/>
</td>
</tr>
<dmf:panel name="optionspanel">
<tr>
<td>
<dmf:checkbox name="subscribe" nlsid="
MSG_SUBSCRIBE_TO_CABINET"/>
</td></tr></dmf:panel></table>

paneset

Purpose
Contains pane controls to allow scrolling, so that buttons stay in view and content within a pane is
scrolled. One outermost paneset to a JSP page, which can contain nested panesets. For information
about general scrollable paneset design, see Web Development Kit Development Guide.

Attributes

bottompadding (Optional) Bottom padding (in pixels) of the


paneset control. Applies only to the outermost
paneset control in a page.
cols (Optional) Width for the contained panes;
for example, cols=’110, *, 40’. The asterisk
(*) indicates that the middle pane uses the

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 183
paneset

remaining browser space. You must specify


either rows or columns, but not both.
cssclass (Optional) CSS class to apply to this control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
leftpadding (Optional) Left padding (in pixels) of the paneset
control. Only valid for the outermost paneset
control in a page.
minheight (Optional) Minimum height (in pixels) of the
paneset control. Only valid for the outermost
paneset control in a page.
minwidth (Optional) Minimum width (in pixels) of the
paneset control. Only valid for the outermost
paneset control in a page.
name (Required) Name for this control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.
rightpadding (Optional) Right padding (in pixels) of the
paneset control. Only valid for the outermost
paneset control in a page.
rows (Optional) Height (in pixels) for the contained
panes; for example, rows=’110, *, 40’. The
asterisk (*) indicates that the middle pane uses
the remaining browser space. You must specify
either rows or columns, but not both.
toppadding (Optional) Top padding (in pixels) of the paneset
control. Only valid for the outermost paneset
control in a page.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

184 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
tab

Usage
Controls on the JSP page that are outside the dmf:paneset control may not be visible.
If you are displaying data from a datagrid in multiple panes, set the rendertable attribute to false so
that the datagrid does not render <table> markup. Instead, manually add <table> start and close tags
within your <dmf:pane> tags.
You can globally configure all paneset controls in your application by extending the paneset
configuration file /wdk/config/panesetcontrol_config.xml. The following attributes can be
globally configured for the outermost paneset and the inner panesets independently: toppadding,
bottompadding, leftpadding, and rightpadding.

tab

Purpose
Generates a tab control within a tabbar control.

Attributes

datafield (Optional) Overrides value and NLS ID with


data from a data source.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
height (Optional) Height of the tab and overrides the
tabheight property in the tabbar control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the value attribute value.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 185
tabbar

onchange (Optional) Event that is fired after the user


changes the tab. This event is not handled
immediately. It is handled on the server only
when the form is submitted. The onchange event
handler cannot run on the client (that is, the
runatclient attribute cannot be true).
onclick (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
runatclient (Optional) Whether the onclick event is to run on
the client (True) or the server (False).
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
value (Optional) Text that is displayed on the tab.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of the tab and overrides the
tabwidth property in tabbar.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

tabbar

Purpose
Generates a tab bar control (non‑graphical).

186 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
tabbar

Attributes

align (Optional) Alignment of the text on all of the


tabs. Valid values are: left, right, center. Default
is center.
cssclass (Optional) CSS class to apply to this control.
disabledclass (Optional) CSS class to apply to the text of
disabled tabs.
disabledstyle (Optional) Entire CSS‑syntax style sheet rule
(enclosed in quotes) to apply to the text of the
disabled control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
imagefolder (Optional) Folder in which the tab bar graphics
are stored. If the graphics are not found in this
folder, a non‑graphical tab bar is displayed.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
normalclass (Optional) Class to apply to text of normal tabs.
normalstyle (Optional) Style to apply to text of normal tabs.
onchange (Optional) Event fired when a user selects a
tab. This event is not handled immediately. It
is handled on the server only when the form is
submitted.
onclick (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
runatclient (Optional) Whether the onclick event is to run on
the client (True) or the server (False).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 187
tabbar

scrollable (Optional) Whether to enable scrolling through


tabs if all tabs are not visible within the
browser page (True) or not (False). Default is
false. Supported only when the tabposition
attribute value is top (for both graphical and
non‑graphical tab bars). Container must define
a width (paneset, table). Scrolling arrow images
(chevrons) can be placed in tabbar image folder
for a theme.
selectedclass (Optional) Class to apply to text of selected tabs.
selectedstyle (Optional) Style to apply to text of selected tabs.
showtabs (Optional) Whether to display tabs (True) or
non‑clickable, non‑graphic roadmap for use in
wizard containers only (False). Default is true. If
this attribute is set to false, the values of these
attributes are ignored for rendering: tabposition,
imagefolder, and onclick.
tabheight (Optional) Height of all the tabs. Default is 10.
Use the height property on a tab to override this
attribute.
tabposition (Optional) Position of the tabs on the page. Valid
values are: top, bottom, left, right. Default is top.
tabwidth (Optional) Width of all the tabs. Default is 60.
Use the width property on a tab to override this
attribute.
value (Optional) Text displayed on the selected tab.
Sets the name of the initial tab.
visible (Optional) (Boolean) Whether this control is
rendered as visible (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

188 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
body

Usage
You can add scolling arrows (chevrons) to a theme. The images must be in the folder
/theme_name/images/tabbar/top where theme_name is the name of your theme. The images must have
the following names: backward_enabled.gif, backward_disabled.gif, forward_enabled.gif, and
forward_disabled.gif.
Note: To have a scrollable tabbar, the containing HTML element must have a fixed width. For
example, the containing table cells in Webtop’s tabbar.jsp set fixed widths as follows:
<td align="left" valign="bottom" nowrap="">
<dmf:tabbar name="<%=TabBar.CONTROL_TABBAR%>"...>
</dmf:tabbar>
</td>
<td ...width="1%">
<!­­ label here ­­>
</td>

The Webtop streamline view has its own set of images. The images must be in the folder
/theme_name/imagesstreamline/tabbar/top where theme_nameis the name of your theme. The images
must have the following names: backward_enabled.gif, backward_disabled.gif, forward_enabled.gif,
and forward_disabled.gif.

HTML

body

Purpose
Generates an HTML <body> tag.

Attributes

alink (Optional) HTML alink attribute.


background (Optional) HTML background attribute.
bgcolor (Optional) HTML bgcolor attribute.
bottommargin (Optional) Distance (in pixels) between the body
text and browser window bottom margin.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 189
body

cssclass (Optional) CSS class that is applied to this


control.
dir (Optional) HTML dir attribute.
height (Optional) HTML height attribute.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
lang (Optional) HTML lang attribute.
leftmargin (Optional) Distance (in pixels) between the body
text and browser window left margin.
link (Optional) HTML link attribute.
marginheight (Optional) HTML marginheight attribute.
marginwidth (Optional) HTML marginwidth attribute.
onload (Optional) JavaScript event handler for the
HTML body onload event.
onunload (Optional) JavaScript event handler for the
HTML body onunload event.
rightmargin (Optional) Distance (in pixels) between the body
text and browser window right margin.
showdialogevent (Optional) Whether to allow the page to be
rendered in an Application Connector dialog
window (True) or not (False).
sizepreference (Optional) Whether to save the user’s resize
preference for an Application Connector dialog
window (True) or not (False). Default is true.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
text (Optional) HTML text attribute.
title (Optional) HTML title attribute.
titlenlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the title attribute value.
topmargin (Optional) Distance (in pixels) between the body
text and browser window top margin.

190 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
button

vlink (Optional) HTML vlink attribute.


width (Optional) HTML width attribute.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

button

Purpose
Generates an HTML button.

Attributes

accessible (Optional) Deprecated in 6.0.Whether accessible


mode is on (True) or off (False). (Only used with
the imagefolder attribute)
align (Optional) Deprecated in 6.0.6.0: This attribute is
ignored.Pre‑6.0: (Image label only) Alignment of
the label text.
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Overrides label or nlsid with data
from a data source.
default (Optional) Whether this button is the default
button on the page (True) or not (False). Must
be used with a text control or another control
that has the defaultonenter attribute set to true.
When the user presses the Enter key, the default
button event is fired.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 191
button

disabledclass (Optional) Deprecated in 6.0. CSS class to apply


to the disabled control.
disabledstyle (Optional) Deprecated in 6.0. Entire CSS‑syntax
style sheet rule (enclosed in quotes) to apply to
the disabled control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
height (Optional) Height of the image.
hotkeyid (Optional) Value of a <hotkey> id attribute in the
hotkeys configuration file (hotkeys.xml, located
in /webcomponent/config) that references the
keyboard shortcut command string for this
control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
imagefolder (Optional) Deprecated in 6.0.6.0: Sets the folder
that the button graphics are stored in. If the
graphics are not found in this folder or this
attribute is not specified, then an HTML button is
rendered.Pre‑6.0: Sets the folder that the button
graphics are stored in. If graphics are not found
in this folder, an HTML button will be drawn.
label (Optional) Value stored in the control and
displayed as text on the button.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label attribute value.
onchange (Optional) Event fired when this control is
changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted. The onchange event
handler cannot run on the client (that is, the
runatclient attribute cannot be true).

192 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
button

onclick (Required) Event fired when the user clicks this


control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
runatclient (Optional) Whether the event is to run on the
client (True) or the server (False).
src (Optional) Image to be used for the button.
srcdisabled (Optional) Image to be used when the button is
disabled.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipdatafield (Optional) Datafield that overrides the value of
tooltip and tooltipnlsid.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of the image.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 193
checkbox

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
In pre‑6.0, by default, this control rendered the <input type=button> HTML tag; if the imagefolder
attribute was specified, then the <table>...<td>xxxLABELxxx</td>...</table> HTML tags were rendered;
if the src attribute was specified then the <img src=...> HTML tag was rendered.
In 6.0, by default this control renders the <button> tag; using the imagefolder attribute and its
associated attributes (disabledstyle, disabledclass, align, accessible) are deprecated. Also, specifying
the src attribute renders the <button><img src=...>...</button> HTML tags.

checkbox

Purpose
Generates an HTML checkbox form control.

Attributes

cssclass (Optional) CSS class to apply to this control.


datafield (Optional) Overrides value with data from a data
source
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Text label for the checkbox.

194 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
checkbox

labelalign (Optional) Alignment of the checkbox label.


Valid values are: left, right
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label attribute value.
onchange (Optional) Event fired when this control is
changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted. The onchange event
handler cannot run on the client (that is, the
runatclient attribute cannot be true).
onclick (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
runatclient (Optional) Whether the onclick event is to run on
the client (True) or the server (False).
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 195
datadropdownlist

tooltip (Optional) String displayed when you place the


mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
value (Optional) Whether the control is checked (True)
or unchecked False). Default is false.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
The checkbox supports the onclick event for which you must implement your own server side event
handler. Checkbox also supports an onchange event that is fired when the form is resubmitted.

datadropdownlist

Purpose
Generates an HTML drop down list control. Holds option tags or a single dataoptionlist control
that contains a databound option tag.

196 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datadropdownlist

Attributes

autocompleteenabled (Optional) (Boolean) Enables (True) or disables


(False) autocompletion on the control. Default
is True.
autocompleteid (Optional) Key that is used to store the
autocomplete list in the user preferences.
You can set the same ID on two text controls,
for example, if they share the same set of
suggestions. If the control has no ID specified,
the ID will be generated based on the form id
and text control name, in the form consisting of
formid_controlid. For docbaseattribute controls
that render a text control, an ID is generated
using the attribute name, for example, keyword
or title.
cssclass (Optional) CSS class to apply to this control.
editable (Optional) Whether the user can type in a value
(True) or not (False).

Not available: since 6.5


enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether to accept focus (True) or not
(False).
id (Optional) ID ofthis control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
maxautocompletesuggestionsize (Optional) Number of matching suggestions to
display to the user. Default is 10.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
onchange (Optional) Event fired when this control’s value
is changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted. The onchange event
handler cannot run on the client (that is, the
runatclient attribute cannot be true).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 197
datadropdownlist

onselect (Optional) Event fired when the user clicks this


control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true). The form is not submitted until the
onselect event is fired.
query (Optional) Displays query or recordset as a
drop down list. Use dataoptionlist tag within
datadropdownlist for databound values. Use the
option tag within datadropdownlist for static
output. The DQL query that is passed to the data
provider has the following form: query=ʺselect
r_object_id, user_name from dm_user where
user_name like ’a%’ ʺ
runatclient (Optional) Specifies that the onselect event is to
run on the client (True) or the server (False).
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
value (Optional) The selected value.

198 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datalistbox

visible (Optional) (Boolean) Whether this control is


rendered as visible (True) or hidden (False).
width (Optional) Horizontal length of the drop down
list control.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

datalistbox

Purpose
Generates an HTML list box control. Use the dataoptionlist tag within dataoptionlist for databound
values. Use the option tag within dataoptionlist for static output.

Attributes

cssclass (Optional) CSS class to apply to this control.


enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) To accept focus (True) or not (False).
height (Optional) Vertical length of the drop down list
control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 199
datalistbox

onchange (Optional) Event fired when this control’s value


is changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted. The onchange event
handler cannot run on the client (that is, the
runatclient attribute cannot be true).
onselect (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true). The form is not submitted until the
onselect event is fired.
query (Optional) DQL query to retrieve data for a
dataoptionlist control, for example: query=ʺselect
r_object_id, user_name from dm_userʺ
runatclient (Optional) Specifies that the onselect event is to
run on the client (True) or the server (False).
size (Optional) Number of rows of selectable data
visible in the listbox. Scrollbars are used if more
rows are available.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.

200 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
div

tooltipnlsid (Optional) NLS key to use when looking up a


localized tooltip string.
value (Optional) The selected value.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Horizontal length of the drop down
list control.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

div

Purpose
Generates HTML <div> open and close tags.

Attributes

align (Optional) HTML align attribute.


cssclass (Optional) CSS class to apply to this control.
datafld (Optional) HTML datafld attribute.
dataformatas (Optional) HTML dataformatas attribute.
datasrc (Optional) HTML datasrc attribute.
dir (Optional) HTML dir attribute.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 201
dropdownlist

lang (Optional) HTML lang attribute.


style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
title (Optional) HTML title attribute.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

dropdownlist

Purpose
Generates an HTML drop‑down list control. Contains option tags or a single dataoptionlist control
that contains a databound option tag.

Attributes

autocompleteenabled (Optional) (Boolean) Enables (True) or disables


(False) autocompletion on the control. Default
is True.
autocompleteid (Optional) Key that is used to store the
autocomplete list in the user preferences.
You can set the same ID on two text controls,
for example, if they share the same set of
suggestions. If the control has no ID specified,
the ID will be generated based on the form id
and text control name, in the form consisting of
formid_controlid. For docbaseattribute controls

202 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
dropdownlist

that render a text control, an ID is generated


using the attribute name, for example, keyword
or title.
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Overrides the value attribute with
data from a data source.Since 6.0.
editable (Optional) Whether the user can type in a value
(True) or not (False).
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether to accept focus (True) or not
(False).
forceselection (Optional) Whether it is required (True) or
optional (False) for the user to select an entry
from the dropdown box. If true is specified, no
item is selected initially. If false is specified, the
first item in the list is selected initially.
height (Optional) Vertical length of the drop down list
control
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
maxautocompletesuggestionsize (Optional) Number of matching suggestions to
display to the user. Default is 10.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
onchange (Optional) Event fired when this control’s value
is changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted. The onchange event
handler cannot run on the client (that is, the
runatclient attribute cannot be true).
onselect (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true). The form is not submitted until the
onselect event is fired.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 203
dropdownlist

runatclient (Optional) Specifies whether the onselect event


is to run on the client (True) or the server (False).
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
value (Optional) The selected value.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Horizontal length of the drop down
list control

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

204 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
dropdownorlabel

Usage
Options in the list can be set programmatically using the method addOption(). For example:
DropDownList dropdown = (DropDownList) get Control (
DOCBASE, DropDownList.class);
Option option1 = new Option();
option1.set Value(value1);
option1.set Label (value1);
dropdown.addOption(option1);

The onchange event does not submit the form, so you cannot use the onchange event to update other
lists or controls on the JSP page. If you need to update another control, handle the onselect event in
your component class with a method that does nothing, and handle the onchange event with a method
that performs the control update. For example:
public void onSelectTypeFilter(DropDownList control, ArgumentList args)
{
String strMode = control.getValue();
// Control update logic here
updateControls();
}

When the dropdown list is rendered for a required attribute value with value assistance, forceselection
is set to true and the default value is selected. If the required attribute does not have a default value,
no item will be selected and the user will be forced to select an item.

dropdownorlabel

Purpose
Displays a label if there is only one value to display; otherwise displays a drop‑down list.

Attributes

enabled (Optional) Whether this control is enabled (True)


or disabled (False).
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 205
frame

onchange (Optional) Event fired when this control’s value


is changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted.
runatclient (Optional) Specifies that the onclick event is to
run on the client (True) or the server (False).

Description
Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

frame

Purpose
Generates HTML <frame> tags.

Attributes

cssclass (Optional) CSS class to apply to this control.


frameborder (Optional) Whether to display a frame border
(True) or not (False)
marginheight (Optional) Height (in pixels) between the frame
and browser window margin.
marginwidth (Optional) Width (in pixels) of the spacing
between the frame and browser window margin.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

206 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
frameset

nlsid (Optional) NLS lookup key. The string


corresponding to the NLS ID is substituted for
the title attribute value.
noresize (Optional) Whether to make the frame resizeable
(False) or not (True).
scrolling (Optional) Whether to display scroll bars for the
frame (True) or not (False).
src (Optional) Source of the frame content. Can be
URL to component, HTML page, or JSP page
(HTML or JSP path must be relative to application
root). For example: src=’/component/toolbar’ or
src=’/webtop/classic/workarea.jsp’
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
title (Optional) Title to display for the frame.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

frameset

Purpose
Generates HTML <frameset> tags.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 207
frameset

Attributes

border (Optional) Border (in pixels) around the image,


if the frameborder attribute is set to true. Default
is 0 (zero) pixels (that is, no border).
cols (Optional) Width (in pixels) of each column.
Cannot be used with the rows attribute. Use an
asterisk (*) to specify that the width is determined
by the browser. For example: rows=ʺ24,*ʺ
cssclass (Optional) CSS class to apply to this control.
frameborder (Optional) Whether to display a frame border
(True) or not (False).
framespacing (Optional) Width (in pixels) of the spacing
between frames.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Sets the name for this control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.
onload (Optional) Event to be fired in the frameset
onload event.
onunload (Optional) Event to be fired in the frameset
onunload event.
rows (Optional) Height (in pixels) of each row. Cannot
be used with the cols attribute. Use an asterisk
(*) to specify that the height is determined by the
browser. For example: rows=ʺ24,*ʺ
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ

Description

Since
5.x

208 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
head

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

head

Purpose
Generates HTML <head> open and close tags.

Attributes
None.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

helpimage

Purpose
Renders an image that launches context‑sensitive help.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 209
helpimage

Attributes

alttext (Optional) Text to display when holding the


mouse pointer over this control.
border (Optional) Border (in pixels) around the image.
Default is 0 (zero) pixels (that is, no border).
datafield (Optional) Overrides the value of the src attribute
with a URL from a data source.
height (Optional) Height of this control.
hspace (Optional) Horizontal margin (white space
padding to the left and right) around the image.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Overrides the alttext and nlsid
attribute values.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label attribute value.
onclick (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
runatclient (Optional) Specifies that the onclick event is to
run on the client (True) or the server (False).
src (Optional) URL to the image on the server. Can
be a path on the server or in the repository, for
example:src=ʺ/webtop/component/getcontent?
objectId=0900303980005172ʺThe repository icon
may affect performance.

210 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
html

tabindex (Optional) Value (a whole number from 0 to


32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
vspace (Optional) Vertical margin (white space padding
to the top and bottom) around the image.
width (Optional) Width of this control.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

html

Purpose
Generates HTML <html> open and close tags.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 211
iconwell

Attributes

doctype (Optional) Whether the W3C//DTD HTML 4.01


doctype (strict) or the W3C//DTD HTML 4.01
Transitional doctype (empty string) is used.
Default is an empty string.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

iconwell

Purpose
Generates an HTML icon well that displays icons either horizontally or vertically and associates an
onclick event with the icon. This control replaces the component tabs in the 5.2.x locator components.
Each component that uses an iconwell control must configure it in the component definition.

Attributes

align (Optional) Horizontal alignment (the HTML


align attribute for the TD element).
border (Optional) Border (in pixels) around the image,
if it is a link. Default is 0 (zero) pixels (that is,
no border).
cssclass (Optional) CSS class to apply to this control.
disabledbgimage (Optional) Overrides the image specified for the
disabled icon background in the component
definition.

212 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
iconwell

enabled (Optional) Whether this control is enabled (True)


or disabled (False).
highlightedbgimage (Optional) Overrides the image specified for the
highlighted icon background in the component
definition.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
normalbgimage (Optional) Overrides the image specified for
the normal icon background in the component
definition.
onclick (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute is
true). When onclick is used, the image is turned
into a link.
renderorientation (Optional) Whether the well of icons is oriented
vertically (vertical) or horizontally (horizontal).
Default is horizontal.
runatclient (Optional) Whether the onclick event is to run on
the client (True) or the server (False).
selectedbgimage (Optional) Overrides the image specified for
the selected icon background in the component
definition.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 213
iconwell

Usage
The iconwell control can be used to render a group of icons that launch actions or components. The
set of icons is configured in the definition file for the component that includes an iconwell tag. This
allows you to have a different set of icons for each component. The iconwell configuration elements
are described below:
<component>
...
1 <iconwell>
<iconwellicon>
2<id>component_or_action_id</id>
3<icon>path_to_icon</icon>
4<label>string_or_nlsid_element</label>
5<tooltip>string_or_nlsid_element</tooltip>
</iconwellicon>
6<normalbgimage>path_to_background_image</normalbgimage>
7<disabledbgimage>path_to_disabled_background_image</disabledbgimage>
8<selectedbgimage>path_to_selected_background_image</selectedbgimage>
9<highlightedbgimage>path_to_highlighted_background_image</highlightedbgimage>
10<defaultid>component_or_action_id</defaultid>
</component>

The locator and locatorcontainer classes, Locator and LocatorContainer respectively,


add a configuration value that can be read by locator components. Add the element
<breadcrumbiconwellmode> and set the value to true to display the component name instead of the
repository name as the breadcrumb in a locator.

1 Contains configuration for the component icons


2 ID of an action or component that will be launched by the icon. This value must match the value of
the action or component ID in its XML definition.
3 Path within a theme directory to the icon. For example, a path of /icons/perspective/inbox32.gif
would map to a file at /root_directory/custom/theme/mytheme/icons/perspective\inbox32.gif. See
Web Development Kit Development Guidefor information on how themes are located.
4 Specifies a string value or <nlsid> element whose key represents a label for the icon
5 Specifies a string value or <nlsid> element whose key represents a tooltip for the icon
6 Path within a theme directory to the image that supplies the background for icons in the normal
(unselected and enabled) state
7 Path within a theme directory to the image that supplies the background for icons in the disabled
state (action not valid for user or context)
8 Path within a theme directory to the image that supplies the background for icons in the selected
state
9 Path within a theme directory to the image that supplies the background for icons in the highlighted
state (mouseover)
10 ID of an action or component that will initially selected when the iconwell is rendered (default
action or component)

214 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
image

image

Purpose
Generates an HTML image tag (<img>).

Attributes

alttext (Optional) Alternate text to be displayed as a


tooltip and when the image fails to load.
border (Optional) Border (in pixels) around the image,
if it is a link. Default is 0 (zero) pixels (that is,
no border).
cssclass (Optional) A cascading style sheet rule enclosed
in quotation marks; for example: style=ʺvisibility:
hiddenʺ
datafield (Optional) Overrides the value of src attribute
with a URL from a data source.
height (Optional) Height of the image control.
hspace (Optional) Horizontal margin (white space
padding to the left and right) around the image.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Overrides the alttext and nlsid
attribute values.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the alttext attribute value.
onclick (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute is
true). When onclick is used, the image is turned
into a link.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 215
image

runatclient (Optional) Specifies that the onclick event is to


run on the client (True) or the server (False).
src (Optional) URL to the image on the server. Can
be a path on the server or in the repository, for
example: src=ʺ/webtop/component/getcontent?
objectId=0900303980005172ʺ. The repository icon
may affect performance.
style (Optional) Sets the cascading style sheet class
that is used to format this control.
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
vspace (Optional) Vertical margin (white space padding
to the top and bottom) around the image.
width (Optional) Width of the image control.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

216 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
option

option

Purpose
Contains a single static name/value pair entry. Use this tag inside a dropdownlist, listbox,
datadropdownlist, or datalistbox control. The name attribute is required. The value can be set on
the tag, or it can be passed in from a result set.

Attributes

datafield (Optional) Overrides value with data from a data


source.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Text to display to the user in the drop
down list or list box.
labeldatafield (Optional) Overrides label with data from a data
source.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label attribute value.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
value (Optional) Value that is displayed in a drop
down list or list box.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 217
radio

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

radio

Purpose
Generates an HTML radio element.

Attributes

cssclass (Optional) Sets the CSS class that is applied to


this control.
datafield (Optional) Overrides value with data from a data
source
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
group (Required) Group of radio buttons of which the
radio button is a member. Only one radio button
in the group can be selected at any one time.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Label text for the radio button.
labelalign (Optional) Alignment of the radio button label.
Uses HTML text alignment attributes.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

218 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
radio

nlsid (Optional) NLS lookup key. The string


corresponding to the NLS ID is substituted for
the value attribute value.
onchange (Optional) Event fired when this control’s value
is changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted. The onchange event
handler cannot run on the client (that is, the
runatclient attribute cannot be true).
onclick (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
runatclient (Optional) Whether the onclick event is to run on
the client (True) or the server (False).
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 219
span

value (Optional) Whether the radio element is


displayed as selected (True) or deselected (False).
visible (Optional) (Boolean) Whether this control is
rendered as visible (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
The user can select only one radio widget in the group. To check which radio has been selected by the
user in your component class, check the state of each radio, similar to the following:
if (((Radio)getControl("ctrl1", Radio.class)).getValue())
{
// do something for ctrl1
}
else if (((Radio)getControl("ctrl2", Radio.class)).getValue())
{
// do something for ctrl2
}

span

Purpose
Generates HTML <span> open and close tags.

Attributes

cssclass (Optional) CSS class to apply to this control.


datafld (Optional) HTML datafld attribute.

220 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
table

dataformatas (Optional) HTML dataformatas attribute.


datasrc (Optional) HTML datasrc attribute.
dir (Optional) HTML dir attribute.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
lang (Optional) HTML lang attribute.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
title (Optional) HTML title attribute.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

table

Purpose
Generates HTML <table> open and close tags.

Attributes

align (Optional) HTML align attribute.


bgcolor (Optional) HTML bgcolor attribute.
border (Optional) HTML border attribute.
cellpadding (Optional) HTML cellpadding attribute.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 221
td

cellspacing (Optional) HTML cellspacing attribute.


cssclass (Optional) CSS class that is applied to this
control.
datapagesize (Optional) HTML dir attribute.
dir (Optional) HTML dir attribute.
frame (Optional) HTML frame attribute.
id (Optional) ID for this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
lang (Optional) HTML lang attribute.
rules (Optional) HTML rules attribute.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
summary (Optional) HTML summary attribute.
title (Optional) HTML title attribute.
width (Optional) HTML width attribute.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

td

Purpose
Generates HTML <td> (table cell) open and close tags.

222 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
td

Attributes

abbr (Optional) HTML abbr attribute.


align (Optional) HTML align attribute.
axis (Optional) HTML axis attribute.
bgcolor (Optional) HTML bgcolor attribute.
char (Optional) HTML char attribute.
charoff (Optional) HTML charoff attribute.
colspan (Optional) HTML colspan attribute.
cssclass (Optional) CSS class to apply to this control.
dir (Optional) HTML dir attribute.
headers (Optional) HTML headers attribute.
height (Optional) HTML height attribute.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
lang (Optional) HTML lang attribute.
nowrap (Optional) HTML nowrap attribute.
rowspan (Optional) HTML rowspan attribute.
scope (Optional) HTML scope attribute.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
title (Optional) HTML title attribute.
valign (Optional) HTML valign attribute.
width (Optional) HTML width attribute.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 223
th

th

Purpose
Generates HTML <th> (table head) open and close tags.

Attributes

abbr (Optional) HTML abbr attribute.


align (Optional) HTML align attribute.
axis (Optional) HTML axis attribute.
bgcolor (Optional) HTML bgcolor attribute.
char (Optional) HTML char attribute.
charoff (Optional) HTML charoff attribute.
colspan (Optional) HTML colspan attribute.
cssclass (Optional) CSS class to apply to this control.
dir (Optional) HTML dir attribute.
headers (Optional) HTML headers attribute.
height (Optional) HTML height attribute.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
lang (Optional) HTML lang attribute.
nowrap (Optional) HTML nowrap attribute.
rowspan (Optional) HTML rowspan attribute.
scope (Optional) HTML scope attribute.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
title (Optional) HTML title attribute.
valign (Optional) HTML valign attribute.
width (Optional) HTML width attribute.

224 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
title

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

title

Purpose
Generates HTML <title> open and close tags.

Attributes
None.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

tr

Purpose
Generates HTML <tr> (table row) open and close tags.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 225
tr

Attributes

align (Optional) HTML align attribute.


bgcolor (Optional) HTML bgcolor attribute.
char (Optional) HTML char attribute.
charoff (Optional) HTML charoff attribute.
cssclass (Optional) CSS class to apply to this control.
dir (Optional) HTML dir attribute.
height (Optional)
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
lang (Optional) HTML lang attribute.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
title (Optional) HTML title attribute.
valign (Optional) HTML valign attribute.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

226 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
pagenav

Document Image Services

pagenav

Purpose
For internal use only.

Attributes

actiontype (Optional) For internal use only.


controlid (Optional) For internal use only.
controltype (Optional) For internal use only.
id (Optional) For internal use only.
name (Optional) For internal use only.
onclick (Optional) For internal use only.
value (Optional) For internal use only.

Description
Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 227
param

param

Purpose
For internal use only.

Attributes

name (Optional) For internal use only.


value (Optional) For internal use only.

Description
Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

viewercontrol

Purpose
The Image Viewer Control is a wrapper WDK control that must be associated with an Image Viewer
provider, such as Daeja ViewOne Pro or Adobe Acrobat Reader.

Attributes

activeXClsid (Optional) For to do: Need description.


activeXDownloadUrl (Optional) For to do: Need description.
activeXMayscript (Optional) For to do: Need description.
activeXScriptable (Optional) For to do: Need description.

228 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
viewercontrol

align (Optional) For to do: Need description.


alt (Optional) For to do: Need description.
archive (Optional) For to do: Need description.
code (Optional) For to do: Need description.
codebase (Optional) For to do: Need description.
height (Optional) For to do: Need description.
hspace (Optional) For to do: Need description.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
mayscript (Optional) For to do: Need description.
name (Optional) Name for this control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.
object (Optional) For to do: Need description.
objectId (Optional) For to do: Need description.
provider (Optional) For to do: Need description.
vspace (Optional) For to do: Need description.
width (Optional) For to do: Need description.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
To associate the control with an Image Viewer provider, you only need to map its APIs and parameters
appropriately. The Daeja ViewOne Pro Viewer is provided as a reference implementation. The Image
Viewer Control is a WDK control as defined below.
<dmimg:viewercontrol
Provider=ProviderName
height=nnnwidth=nnnhspace=nnnvspace=nnn>
<dmimg:param name=name1 value=value1/>
<dmimg:param name=name2 value=value2/>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 229
viewercontrol

...
</dmimg:viewercontrol>

The Image Viewer Control can be embedded into a WDK form in a JSP page as:
<%@page contentType="text/html"%>
<%@ taglib uri="/WEB­INF/tlds/dmform_1_0.tld" prefix="dmf" %>
<%@ taglib uri="/WEB­INF/tlds/dmimaging_1_0.tld" prefix="dmimg" %>
<dmf:html>
<dmf:head>
<dmf:webform/>
<dmf:title>Documentum Image Viewer/dmf:title>
</dmf:head>
<dmf:body>
<dmf:form>
<dmimg:viewercontrol
Provider=Daeja
name="viewONE" id="viewONE"
width="1024" height="800"
hspace="0" vspace="0" align="middle">
objectId=xxxxxx
<dmimg:param name="demo" value="document"/>
...
</dmimg:viewercontrol>
</dmf:form>
</dmf:body>
</dmf:html>

Depending on the object type of the viewer and the kind of the browser used, the control will render
the viewer into appropriate HTML tags at runtime. The browser and platform requirements on the
client side depend on the chosen viewer. The Control will be rendered into different HTML tags
depending on the viewer provider. In the case of an applet, it will be rendered into:
<applet id=viewer1codebase=xxx.xxx.xxx>
<param name=name1value=value1/>
<param name=name2value=value2/>
...
</applet>

If the viewer provider is an ActiveX plug‑in such as Adobe Acrobat Reader, it will be rendered into:
<object id=viewer2 >
<param name=codebase value=xxx.xxx.xxx>
<param name=name1value=value1>
<param name=name2value=value2>
...
</object>

Other tag attributes are standard attributes for the control such as id, name, height, width, codebase,
archive, etc.
Multiple Image Viewer controls with different types can be embedded in the same page or component.
You should also be able to swap the viewers for different document types based on your configuration.

230 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
viewercontrol

To support this scenario, besides the tag, the specific Image Viewer Provider should add the
Javascript function mappings during configuration time and the file should be included in the HTML
<Javascript>. The functions may look like:
<Script language=Javascript1.2>
Function {providername}_ nextpage( viewerid ){
// call Image Viewer Provider specific functions
}
Function {providername}_prevpage( viewerid ){
}
Function {providername}_goto( viewerid ){
}
...
</Script>

The {providername}in the function is used so that more than two different image viewers can be
embedded in one JSP page. Here is a list of third‑party viewers:

Provider Control Type Name in WDK Control


Brava, by IGC ActiveX only; applet is no Brava
longer supported
ViewOne Pro, by Daeja Applet Daeja
Acrobat Reader, by Adobe ActiveX AcrobatReader

To map the viewer provider Javascript functions to the Image Viewer Framework during configuration,
it is convenient to have a schema for mapping the functions. The following is one of the suggested
XML formats and the detail can be updated after the implementation:
<?xml version="1.0"?>
<mapping>
<function name=nextpage>
<param name=controlId/>
<param name=page />
<providerinfo name=Daeja function=Daeja_nextpage />
<providerinfo name=Brava function=Brava_nextpage />
</function>
<!­­ repeat other functions ­­>
...
</mapping>

Since the Image Viewer WDK control is a standard WDK control, which is essentially derived from
Control and ControlTag classes, it comes with a number of common properties that enable JSP
configuration of the controls to utilize the WDK infrastructure:
• cssclassis used in the branding framework
• nlsidand tooltipnlsidare used in the locale framework
• datafieldand tooltipdatafieldare used in the databinding framework
• enabledand visibleare used in the action framework

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 231
viewercontrol

Other common properties include:


• style
• id
• name
• onchange
• focus
• tooltippandrunatclient

The <dmimg:param />tag is used to specify parameters used by the customized control depending
on what provider is chosen. This parameter will be rendered into a different html parameter tag
depending on whether the control is an applet or an object and which browser is being used.
The Image Viewer Control should have its own control type and be available to use in the Forms
Builder. The control will show as a black box at design time but the properties should be configurable
through the Forms Builder. Those properties will show as parameters of the control at runtime.
The Image Viewer Control will provide the following interfaces:
• The configuration parameters or attributes for the control itself. This includes parameters such
as archive, code, ObjectId, cabbase, viewer provider name, width, and height. These parameters
can be set through Forms Builder or at design time when the WDK form is embedded in a WDK
component through <init­controls>.
• The entries for setting up the server side handlers such as configuration service, document or page
service, annotation service, and document/page manipulation service. It should also include
the server side error notification handler. The service information can be preconfigured at the
application level such as app.xml because it is shared by all the Image Viewer Controls regardless
of the image viewer provider chosen.
• The common Javascript APIs included (but not limited to) are:
— OpenDoc(), CloseDoc()
— NextPage(), PrevPage()
— FirstPage(), LastPage()
— GotoPage()
— ToggleAnnotation()
— SaveAnnotation()
Within each function call, it will call viewer‑specific functions depending on the viewer
provider chosen. The definition of those functions can be preconfigured or mapped through the
configuration administrator.
To add a new viewer provider to the WDK application:

1. Set up the viewer‑related attributes, such as the viewer file path containing JAR, OCX, and any
related files.

232 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
viewercontrol

2. Provide the viewer Javascript API function mapping file. For example, the Daeja.js file contains
all the necessary function mappings needed for Document Image Services if using the Daeja
ViewOne Pro viewer.
To associate the control with an Image Viewer provider in a WDK form, you only need to:

1. Specify the provider name, e.g., Daeja or Brava.


2. Provide any custom parameters the viewer needs. The framework will provide some parameters
by default. Due to the diversity of the viewers, the new parameters must be added during
implementation when it is necessary.
To configure the provider‑specific attributes, which include codebase, main Java class name, archive,
code, cabbase, etc., the following code sample shows the proposed XML format. All the attributes can
be specified in a configuration XML file for all the viewer providers.
<IvfConfiguration>
<ViewerProviders>
<ViewerProvider name=Daeja>
<param>
<name>codebase</name>
<value>mycodebase path</value>
<description>xxxx</description>
</param>
<!­other parameters­>
</ViewerProvider>
<ViewerProvider name="Brava">
... ...
</ViewerProvider>
</ViewerProviders>
</IvfConfiguration>

The Image Viewer Control will retrieve the information to populate the control at runtime. Those
parameters can always be overwritten by providing customized values in <viewercontrol>. For more
details on the Image Viewer Control parameters, see .
As with other WDK controls, the Image Viewer Control can be associated with a viewer component
in the typical manner. There are some default configuration setting that can be set through the
<init­controls>configuration element, as shown in the following code sample:
<component id=...>
...
<init­controls>
<control name=myimageviewer
type=com.documentum.imaging.control.ImageViewerControl>
<init­property>
<property­name>Provider</property­name>
<property­value>Daeja</property­value>
</init­property>
</control>
... ...
</init­controls>
</component>

To use the Image Viewer Control tag, the following configuration tasks need to be completed:

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 233
viewercontrol

1. Copy the file dmimaging_1_0.tldto the folder: {WDKApp}|WEB­INF|tlds|.


2. Copy the imaging library dmimg.jarto the folder: {WDKApp}|WEB­INF|tlds|.
3. Configure the supported document formats through the viewer component configuration XML, as
shown in the following code sample:
<config version=1.0>
<scope type=dm_document>
<component id=viewercomponent extends=...>
<pages>
... ...
</pages>
<formats>
<format>tiff</format>
<format>bmp</format>
<format>gif</format>
<format>PDF</format>
<format>crtext</format>
<format>text</format>
<format>jpeg</format>
</formats>
</component>
</config>

Other configuration settings for the component should be set by following the existing WDK standard.
The Image Viewer Control parameters are defined in the ivf_config.xml file, as follows:

Table 12. Image Viewer Control Parameters

Parameter Value Description


_EnableThumbnails viewmode For Daeja, use viewmode, but
can also indicate position
choices for thumbnails
such as thumbsleft, right,
or top. For Brava, just use
_EnableThumbnails with a
value of True or False. One
mapping is sufficient.
_filename filename For Daeja, use filename.
_ObjectId filename ObjectId will be converted
to filename if the _filename
parameter does not exist.
Otherwise, there is no effect.
_BaseURL baseUrl This is not needed by Daeja,
but it is used internally in the
control class.
_ReadOnly ReadOnly For Daeja, use helpURL.

234 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
xformsdatasortlink

Parameter Value Description


_ImageSaveHandler ImageSavePost Save with type=image or
type=annotation. Daeja uses
imageSavePost.
_ConfigHandler ConfigHandler Retrieves the settings in XML
format, but none of the viewers
support it.
_EventHandler eventhandler For Daeja, use eventhandler.
_EventFilter eventInterest Returns interested events only.
Daeja uses eventInterest.
_AnnotationEncoding annotationEncoding Daeja uses UTF8.
_EnableAnnotation annotate Daeja uses annotate.
_EnableAnnotationEdit annotateEdit Daeja uses annotate.
_EnableCache ACMEnabled Daeja uses ACMEnabled.
_CachePath cachePath Daeja uses cachePath.
_BackgroundColor backcolor Daeja uses backcolor.
_EnablePrinting defaultprintdoc Daeja uses defaultprintdoc.
_EnableMagnifier externalMagnifier Daeja uses externalMagnifier.
_HelpURL helpURL Daeja uses helpURL.

xformsdatasortlink

Purpose
For internal use only.

Attributes

column (Optional) For internal use only.


cssclass (Optional) For internal use only.
datafield (Optional) For internal use only.
enabled (Optional)For internal use only.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 235
xformslistvalueformatter

forwardicon (Optional) For internal use only.


icon (Optional)For internal use only.
id (Optional) For internal use only.
label (Optional) For internal use only.
mode (Optional) For internal use only.
name (Required) For internal use only.
nlsid (Optional) For internal use only.
onclick (Optional) For internal use only.
reverseicon (Optional) For internal use only.
reversesort (Optional) For internal use only.
runatclient (Optional) For internal use only.
style (Optional) For internal use only.
visible (Optional) For internal use only.

Description

Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

xformslistvalueformatter

Purpose
For internal use only.

236 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
viewerframework

Attributes

datafield (Optional) For internal use only.


id (Optional) For internal use only.
name (Optional) For internal use only.

Description
Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

viewerframework

Purpose
For internal use only.

Since
6.5

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 237
componentinclude

Including components

componentinclude

Purpose
Includes a component within a form. If the component to be included is a container, you must use
containerinclude instead of componentinclude.

Attributes

component (Required) ID of component to include.


id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
page (Optional) Name of the component start page.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

238 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
containerinclude

containerinclude

Purpose
Used in a container JSP as a placeholder for the contained components. The contained components are
specified in the container XML definition file.

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Including other pages

forminclude

Purpose
Includes the contents of another form at the point of the tag insertion.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 239
fragment

Attributes

formclass (Required) Java class containing the event


handler functions called when events are fired in
the included JSP page.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsbundle (Optional) NLS bundle used by all the controls
in the included form.
nlsclass (Optional) Java NLS class used by all the controls
in the included form.
src (Required) JSP file to be included.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

fragment

Purpose
Includes a fragment of a JSP page in the current page. The actual fragment that is dispatched at
runtime is dependent on the client environment (clientenv).

240 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
fragment

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
src (Optional) Absolute or relative path to the
fragment: Absolute path Use an absolute
path to always include the same fragment
regardless of runtime context. An absolute path
begins with ʺ/, such as src=/wdk/fragments/
modal/ModalContainerStart.jsp. Relative path
Use a relative path to dispatch a fragment
based on runtime context. For example,
src=modal/ModalContainerStart.jsp.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
The user’s clientenv context and the fragment bundle lookup mechanism that is used for runtime
dispatching are described in detail in Web Development Kit Development Guide.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 241
tagpooldetector

Internal use only

tagpooldetector

Purpose
For internal use only.

Attributes

value (Required) For internal use only.

Description
Since
6.0

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

webcontainerrequirements

Purpose
For internal use only.

Attributes
None.

242 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
componenturl

Description
Since
6.0

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Links

componenturl

Purpose
Component navigation URL (link). Use the argument tag to pass arguments and set the context.

Attributes

component (Required) Target component to be displayed.


cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) String to display as the link.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
page (Optional) Component page to display.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 243
inlinewebform

target (Optional) Name of the target frame.


visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

inlinewebform

Purpose
Forces the JSP engine to buffer the output stream for webform controls and clear the buffer before a
jump or nest to another component. This tag is required for portlets. Error messages are forwarded to
the portal’s registered error handler.

Attributes
None.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
A wrapper JSP page, /wdk/inlinewebform.jsp, contains the <dmf:inlinewebform> tag, which redirects
to the actual target URL. The wrapper page is called by the <dmf:form> tag for portal environments.

244 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
link

You do not need to add this tag to every JSP pages that is used in your portal application. The wrapper
page will be called transparently for all pages containing a <dmf:form tag> in an application uses a
portal environment.

link

Purpose
Generates a hyperlink to an event handler.

Attributes

cssclass (Optional) CSS class to apply to this control.


datafield (Optional) Overrides the label and nlsid
attributes with a string from a data source.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False).
hotkeyid (Optional) Value of a <hotkey> id attribute in the
hotkeys configuration file (hotkeys.xml, located
in /webcomponent/config) that references the
keyboard shortcut command string for this
control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Label for the link.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label attribute value.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 245
link

onclick (Required) Event fired when the user clicks this


control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
runatclient (Optional) Whether the onclick event is to run on
the client (True) or the server (False).
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipdatafield (Optional) Datafield that overrides the values of
the tooltip and tooltipnlsid attributes.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description

Since
5.x

246 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
open

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

open

Purpose
Opens a URL with the specified URL and optional event. Can be an external HTML page.

Attributes

cssclass (Optional) CSS class to apply to this control.


datafield (Optional) Overrides the label attribute to display
a label for the link. For example: uridatafield=
’<%=SearchResultSet.ATTR_URL%>’
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) String or NLSID to display as a label.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label attribute value.
options (Optional) HTML options for the new browser
window.
sendcontext (Optional) Whether to add context to the URI
(True) or not (False). For external targets, set this
attribute to false.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 247
open

style (Optional) CSS rule (enclosed in quotation


marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
target (Optional) Target window. Default is _wdkChild.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipdatafield (Optional) Datafield that overrides the values of
the tooltip and tooltipnlsid attributes.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
uri (Optional) URI for the new window. This
URI can be supplied by a component class
or externalized to the component definition.
For example: uri;’http://localhost:8080/wdk/
component/inboxdrilldown’
uridatafield (Optional) Datafield that supplies the URI;
overrides the uri attribute.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

248 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
colorpicker

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Media and transformation

colorpicker

Purpose
Displays a colored bar that allows user to select a color value from 216 colors. The colorpicker GIF is
located in images/color/colorpicker.gif. This control’s attributes are set by the Media Transformation
Services component transformationdetails. The component has settings for the colorpicker control
attributes that override the defaults shown below.

Attributes

colorvalue (Optional) Initial RGB color value before


selection; for example, 76fa34. Default = null
cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
height (Optional) Height of the colorpicker display.
Default is 20 pixels.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 249
thumbnail

numberofrows (Optional) Number of rows in the colorpicker.


Default is 12.
runatclient (Optional) Whether the event is to run on the
client (True) or the server (False).
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of the colorpicker display.
Default is 100 pixels.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

thumbnail

Purpose
Displays a small (maximum 100x100 pixel) thumbnail image generated and stored on the thumbnail
server, which is integrated with a Content Server.

250 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
thumbnail

Attributes

alttext (Optional) Text to display when holding the


mouse pointer over this control.
border (Optional) Border (in pixels) around the image,
if it is a link. Default is 0 (zero) pixels (that is,
no border).
datafield (Optional) Overrides the objectid attribute with
data from a data source.
height (Optional) Height of the image control.
hspace (Optional) Horizontal margin (white space
padding to the left and right) around the image.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Overrides the alttext attribute.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the alttext attribute value.
objectid (Optional) ID of the object for which to find the
thumbnail image.
onclick (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute is
true). When onclick is used, the image is turned
into a link.
runatclient (Optional) Whether the onclick event is to run on
the client (True) or the server (False).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 251
transformationparameter

tabindex (Optional) Value (a whole number from 0 to


32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
vspace (Optional) Vertical margin (white space padding
to the top and bottom) around the image.
width (Optional) Width of the image control.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

transformationparameter

Purpose
Displays parameters for media profiles (dm_media_profile type) such as ike font size, color, width,
and height. Media profiles are located in /System/Media Server in repositories that have installed
Media Transformation Services.

252 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
menu

Attributes

name (Optional) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
The control data is set at runtime from a component by setting its dataprovider with a TopicResultSet
of data that makes up the topic. For example:
public void setTopicControl(
ITopic topic, String[] attributes)
{
topicData = new TopicResultSet(attributes, topic);
Topic topicControl = (Topic)getControl(
CONTROL_TOPIC, Topic.class);
DataProvider dataProvider = topicControl.getDataProvider(

dataProvider.setScrollableResultSet(topicData);
}

Menu grouping

menu

Purpose
Generates a JavaScript menu or sub‑menu. This tag must be contained within a menugroup tag. Menus
can also be generated from <actionlist> elements within an action configuration file for an object type.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 253
menu

Attributes

accessible (Optional) Whether to enable (True) or disable


(False) accessible mode. Menus are not displayed
in accessible mode.
configid (Optional) Will be deleted soon. Was to support
configurable menus.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
height (Optional) Height of this control. This value is
ignored for graphic menus.
horizontal (Optional) Whether menu items are horizontal
(True) or vertical (False). If this attribute value is
empty or invalid, then the left.gif, right.gif and
bg.gif label graphics are displayed or, if they are
not found, a normal label is displayed instead of
an image label. Default is false.Since 6.0.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the value attribute value.
value (Optional) Menu title.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of the control. Default is the
length of the value attribute’s string.

Description

Since
5.x

254 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
menuconfig

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

menuconfig

Purpose
Displays a menu defined in a menu configuration file (an XML file that contains a
config/scope/menuconfig element structure).

Attributes

id (Required) ID of the config/scope/menuconfig


element to display.

Description

Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

menugroup

Purpose
Specifies the visual appearance of nested menu tags.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 255
menugroup

Attributes

accessible (Optional) Whether to enable (True) or disable


(False) accessible mode. Menus are not displayed
in accessible mode.
cssclass (Optional) CSS class to apply to this control.
imagefolder (Optional) Folder in which the label graphics
are stored. If left.gif, right.gif and bg.gif are not
found, a normal label is displayed instead of an
image label.
menubarclass (Optional) Class that defines the normal style of
a menu bar (menu button). The default class is
named menubar.
menubardisabledclass (Optional) Class that defines the style used when
the menu is disabled.
menubarhighlightclass (Optional) Class that defines the highlighted
menu bar.
menuclass (Optional) Class that defines the normal style of
a popup menu. The default class is named menu.
menudisabledclass (Optional) Class that defines the style used when
the menu is disabled.
menuhighlightclass (Optional) Class that defines the highlight style
of the selected menu item. The default class is
named menuHighlight.
menuseparatorclass (Optional) Class that defines the separator style.
The BACKGROUND‑COLOR specifies the
separator color.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
render (Optional) Kind of HTML element to render.
Valid value is: button. A value of button causes
the menu bar to be rendered as an HTML button.
If this attribute’s value is invalid, the default
behavior is applied. Default is .Since 6.0.
target (Optional) Name of the frame in which the
popup is to be displayed. By default, the popup
is displayed in the same frame.

256 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
menugroupactionmap

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

menugroupactionmap

Purpose
Used by components in the Application Connectors (appintg) environment to create an action map
and return it to the authoring application in the form of an event argument.

Attributes

enabled (Optional) Whether this control is enabled (True)


or disabled (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
menugroupid (Required) Menu that is defined in the
<menugroupid> element of the appintgcontroller
component definition.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 257
menugroupconfig

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

menugroupconfig

Purpose
Generates the initial menu map that is passed to the Application Connector authoring application.

Attributes

enabled (Optional) Whether this control is enabled (True)


or disabled (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
menugroupid (Required) Menu that is defined in the
<menugroupid> element of the appintgcontroller
component definition.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

258 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
menuitem

menuitem

Purpose
Renders a menu item. Must be used within a menu tag.

Attributes

accessible (Optional) Whether to enable (True) or disable


(False) accessible mode. Menus are not displayed
in accessible mode.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
hotkeyid (Optional) Value of a <hotkey> id attribute in the
hotkeys configuration file (hotkeys.xml, located
in /webcomponent/config) that references the
keyboard shortcut command string for this
control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
imageicon (Optional) URL to an image to display on the
left‑hand side of the menu item. Do not include
the custom folder in the URL.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the value attribute value.
onclick (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
runatclient (Optional) Whether the onclick event is to run on
the client (True) or the server (False).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 259
menuseparator

value (Optional) Menu item text.


visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

menuseparator

Purpose
A menu separator control used within menu.

Attributes

accessible (Optional) Whether to enable (True) or disable


(False) accessible mode. Menus are not displayed
in accessible mode.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

260 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
bookmarklink

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Navigational aids

bookmarklink

Purpose
Generates an icon that the user can click to create an Internet Explorer or Firefox favorite to a DRL for
an object.

Attributes

cssclass (Optional) CSS class to apply to this control.


datafield (Optional) Link text; overrides the nlsid and
label attributes.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False). Since 6.0.
href (Optional) Target of the link. Default is the drl
component.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Link text.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 261
bookmarklink

name (Optional) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed..
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label attribute value.
runatclient (Optional) Behavior unknown.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute. Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.Since 6.0: In Internet
Explorer, Drag to desktop, email or document
to create link, or click to Add to Favorites is
displayed;. In FireFox, Click to Add to Favorites
is displayed.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

262 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
breadcrumb

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
Because this control requires JavaScript, it is only available in Internet Explorer and Firefox.
In FireFox, the bookmark is initially created to load in the sidebar. If user wants the bookmark to
open on the main page, the user must uncheck the Load this bookmark in the sidebar checkbox in
the bookmark’s properties.

breadcrumb

Purpose
Displays a web‑style navigation path (breadcrumb) that a user can click to navigate.

Attributes

cssclass (Optional) CSS class to apply to this control.


displayleaf (Optional) Whether to display leaf cells when
they are selected (True) or not (False).
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
leafcssclass (Optional) CSS class to display for a breadcrumb
leaf.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 263
breadcrumb

onchange (Optional) Event that is fired when the user


clicks on the breadcrumb. This event is not
handled immediately. It is handled on the server
only when the form is submitted. The onchange
event handler cannot run on the client (that is,
the runatclient attribute cannot be true).
onclick (Required) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
onclickroot (Optional) Event to be fired when the user
clicks the first link in the breadcrumb control.
This event is handled only if a relative path is
displayed.Since 6.0.
runatclient (Optional) Whether the onclick event is to run on
the client (True) or the server (False).
separator (Optional) Character to separate each path
element.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.

264 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
breadcrumb

value (Optional) Current path displayed by the


breadcrumb.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
These topics are included:
• Navigation path changes from absolute to relative, page 266
• Global configuration, page 265

Global configuration
You specify global configuration for all instances of the breadcrumb control in the
wdk/config/breadcrumbcontrol_config.xml file. You can configure these elements:

Element Description
breadcrumbcontrolconfig Contains configuration elements.
displayleaf Whether a breadcrumb control should show its
leaf (current folder).
leafcssclass CSS class to be used to display the leaf. If
<displayleaf> is set to true and no value is
supplied for <leafcssclass>, the breadcrumb class
is used to display the leaf.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 265
breadcrumb

Element Description
breadcrumbserviceconfig This XML structure is used to configure the
BreadcrumbService class.

Parent: scope

Children:
enablerelativepath

Since 6.0.

enablerelativepath Boolean: Whether to enable relative and absolute


paths (True) or only absolute paths (False).

Parent: breadcrumbserviceconfig

Children: None.

Since 6.0.

Navigation path changes from absolute to relative


Since 6.0.
By default, the navigation path starts from a top‑level node in the browser tree (that is, an absolute
path). When a user jumps to a location from a component specified in the relativepathcomponents
element structure in the wdk/config/breadcrumbcontrol_config.xml file, the path changes to start from
the component (that is, relative to the componentnot absolute from a top‑level node).
For example, when a user clicks Folder A on the Search Results page, Search/Folder A is displayed
for the navigation path. Then, the user clicks Folder B in Folder A, the navigation path is displayed as
Search/Folder A/Folder B.
The navigation path changes from a relative path to an absolute path when the user performs one
of these actions:
• Clicks a node in the browser tree (when the browser tree is not the virtual document manager)
• Clicks an object in the Versions, Relationships, Renditions, Locations views
• Clicks a container in the Search Results page (when row selection is off).

266 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
formurl

formurl

Purpose
Generates a form navigation link (URL). The argument tag can be used to pass arguments to the form.

Attributes

cssclass (Optional) CSS class fo apply to this control.


enabled (Optional) Whether this control is enabled (True)
or disabled (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Text displayed as the link.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
target (Optional) Target frame to display the form.
Default is the current frame.
url (Required) Form JSP file. For example,
url=’<%=strContextPath + ʺ/wdk/samples/
control_pen/formurlPen.jspʺ%>’
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 267
primaryfolderpathlink

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

primaryfolderpathlink

Purpose
Displays for a given sysobject the first full primary folder path on which the user has full browse
permissions on all parts of the path. If the sysobject id refers to a cabinet, the rendered parent folder
path is ’/’.

Attributes

cssclass (Optional) CSS class to apply to this control.


datafield (Optional) Datafield that supplies the folder
path.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
label (Optional) Folder path (truncated or full) to
display for the link.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
onclick (Required) Event fired when the user clicks
clicks the folder path link. This event is handled
immediately on the server (when the runatclient
attribute is false) or on the client (when the
runatclient attribute is true).
runatclient (Optional) Whether the onclick event is to run on
the client (True) or the server (False).

268 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
primaryfolderpathlink

showfullpath (Optional) Whether to render the whole path


(True) or to truncate it (False) when the path
exceeds four folders. When the path is truncated,
an ellipses (...) is displayed to represent the
truncated folder names and only the first two
folder names (including the cabinet) and the last
two folder names are displayed. For example:
/cabinet/folder1/.../folder4/folder5.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 269
filebrowse

Object and file selection

filebrowse

Purpose
Launches a file browser on the user’s system.

Attributes

autocompleteenabled (Optional) (Boolean) Enables (True) or disables


(False) autocompletion on the control. Default
is True.
autocompleteid (Optional) Key used to store the autocomplete
list in the user preferences. You can set the same
ID on two text controls, for example, if they share
the same set of suggestions. If the control does
not have an ID specified, the ID is generated
using this syntax: formid_controlid. formid is
the form id attribute and controlid is the text
control name. For docbaseattribute controls that
render a text control, an ID is generated using the
attribute name; for example, ʺkeyword or ʺtitle.
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Overrides the label or nlsid attribute
on the browse button with data from the data
dictionary.
defaultonenter (Optional) Whether pressing the Enter key calls
the JavaScript handleKeyPress() function (True)
or not (False). Must be used with a button (on
the same page) that has its default attribute
set to true. The button event is fired when the
user presses the Enter key in the defaultonenter
control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).

270 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
filebrowse

fileupload (Optional) Whether to upload the file when a file


path is specified and a form submitted (True)
(also called, upload mode), or to upload the file
name only and not the file contents (False) (also
called, default filename only mode).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
maxautocompletesuggestionsize (Optional) Number of matching suggestions to
display to the user. Default is 10.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label on the browse button.
onchange (Optional) Server‑side event handler.
onselect (Optional) Event fired when the user selects a
file. This event is handled immediately on the
server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
runatclient (Optional) Whether the onselect event is to run
on the client (True) or the server (False).
size (Optional) Size of file browser control.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 271
fileselectorapplet

are tabbed to in the order they appear in the


character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
value (Optional) File name, including path, selected
in the browser.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

fileselectorapplet

Purpose
Generates a file selector for browsing to a file on the user’s local system. The user can drag files or
directories onto the browser when the applet is loaded, and the files will be imported. This applet is
used in the importcontainer component.

272 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
fileselectorapplet

Attributes

align (Optional) Horizontal alignment of applet


text. Valid values are the same as those for the
HTML IMG tag: left, right, top, texttop, middle,
absmiddle, baseline, bottom, absbottom.
alt (Optional) Text to be displayed when the
browser understands the applet tag, but cannot
run Java applets.
fileselect (Optional) Whether to enable selecting files
(True) or not (False).
folderselect (Optional) Whether to enable adding directories
(True) or not (False). Must be true to enable drag
and drop of folders.
folderselectmode (Optional) Specifies how folder contents are
selected. Valid values are: root Only the current
folder node is selected; descendants are not
selected. tree The root folder and all its children
are selected, including their folder structure.
contents (Default) Only the files contained in the
folder are selected.
height (Required) Height of the applet.
hspace (Optional) Margin (n pixels) for the right and left
sides of the applet in the browser window.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
launchonstart (Optional) Dialog box to display when the applet
is started. Valid values are: selectFolders Select
Folders dialog box. selectFiles Select Files dialog
box. null No dialog box is launched. If the
attribute value collides with the fileselect or
folderselect attributes, then no action is taken.
multiselect (Optional) Whether to enable multiple file
selection (True) or not (False).
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 273
folderselectionvalidator

object (Optional) Object to be serialized and encoded


as a string.
onfileselect (Optional) Event to fire when a file has been
selected.
showbuttonpanel (Optional) Whether to show the Change button
for HTTP import (True) or not (False).
vspace (Optional) Margin (in pixels) above and below
the applet in the browser window.
width (Required) Width of the applet.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Usage
The file selector applet look and feel is configured in the fileSelectorAppletStyle.properties file located in
the /theme/css directories of each application layer. The image paths for the file selector are specified in
/WEB‑INF/classes/com/documentum/web/form/control/fileselector/FileSelectorImageProp.properties.

folderselectionvalidator

Purpose
Ensures that the user has sufficient permission to select the folder and to import into it. Checks
user permission and folder security. For example, in the import component, this control validates
the multidocbasetree control.

274 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
booleanformatter

Attributes

controltovalidate (Required) Name of the control to validate.


cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Output formatting

booleanformatter

Purpose
Wraps a boolean value with a formatted ouput, such as True, T, False, or F.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 275
docformatvalueformatter

Attributes

falsenlsid (Optional) ID of the NLS key to look up the


string for false.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
truenlsid (Optional) ID of the NLS key to look up the
string for true.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

docformatvalueformatter

Purpose
Wraps a raw Documentum format code, such as msw97, with a full description of the format from the
data dictionary (in this example, Microsoft Word 97).

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name for this control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.

276 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docsizevalueformatter

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

docsizevalueformatter

Purpose
Wraps a raw Documentum object size value, such as 12500.0, with a formatted value in KB or MB as
appropriate (in this example, 12.5 KB).

Attributes

datafield (Optional) Overrides the type attribute.


name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
type (Optional) Object type. If set to a value of
dm_folder or one of its subtypes, the formatter
displays a blank value instead of 0 KB for objects
of the specified object type.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 277
folderexclusionformatter

folderexclusionformatter

Purpose
Excludes the contents if the object type is folder. Can be used to hide inappropriate attributes for
folders, such as version or authors.

Attributes

datafield (Optional) Datafield that supplies the folder


object type.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
type (Optional) Folder object type.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

htmlsafetextformatter

Purpose
Formats text into HTML safe form by replacing strings that may be misinterpreted by the browser,
such as <, >, &, newline characters, and single and double quotes.

278 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
messageaddressformatter

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name for this control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

messageaddressformatter

Purpose
Formats the addresses in dm_message_route objects related to a dm_message_archive object.

Attributes

datafield (Required) Attribute to be formatted; for


example, to_addr, cc_addr, bcc_addr.

Description
Since
6.0

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 279
multilinestringlengthformatter

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

multilinestringlengthformatter

Purpose
Formats strings that span multiple lines.

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
lineseparator (Optional) Line separator in the string to be
formatted.
lineseparatoroutput (Optional) Line separator to be used in the
output string.
maxlen (Optional) Maximum length of the string after
which it is truncated.
maxlennlsid (Optional) Localized value of maxlen (integer).
You can have a different maximum length for
strings depending on locale.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
postfix (Optional) Postfix string appended to the
truncated string, for example, ’’.
postfixnlsid (Optional) Localized value of postfix string.

280 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
noopformatter

showastooltip (Optional) Whether the untruncated value is to


be shown as a mousever tooltip when the string
gets truncated (True) or not (False). Default is
true.
wrapped (Optional) Whether the maxlen attribute applies
to the entire string (False) or to each word in the
string (True). For example, if maxlen=’5’ and
wrapped=’true’, the string ʺhello worldʺ would
not be truncated, because the string can wrap
between words and no word exceeds the length
of 5. If wrapped=’false’, the string would be
truncated after ʺhelloʺ.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

noopformatter

Purpose
Prevents the label string of this control’s child tag from being escaped.

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name for this control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 281
numberformatter

Description
Since
6.0

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

numberformatter

Purpose
Formats numeric data that is returned in result sets as doubles, including integer and float values.

Attributes

blankifzero (Optional) Boolean: Whether a 0 (zero) is to be


formatted as an empty space (True) or not (False).
format (Optional) Format mask for the display, for
example, format=ʺ$###.##ʺ
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
type (Required) Type of number. Valid values
are: integer, percent, or float (currency is not
implemented).

Description

Since
6.0

282 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
objectidformatter

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

objectidformatter

Purpose
Formats attributes stored as r_object_id to names (for example, user_name, object_name, group_name).

Attributes

datafield (Required) Column to be used as the value for


the control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

Description
Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 283
policystatenameformatter

policystatenameformatter

Purpose
Displays the state name using the policy ID.

Attributes

datafield (Required) Datafield that provides the state


name.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

rankvalueformatter

Purpose
Wraps a raw score (from 0.0 to 1.0) of a Verity search (pre‑5.3 repository only) with a formatted HTML
table containing a score bar graph. The ranking is based upon the number of occurrences of the search
string in a given object’s content or attributes and indicates the relevance of objects returned by a search.

284 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
stringlengthformatter

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name for this control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

stringlengthformatter

Purpose
Truncates a string and provides a mouseover popup that contains the untruncated string.

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
maxlen (Optional) Maximum length of the string after
which it is truncated.
maxlennlsid (Optional) Localized value of maxlen (integer).
You can have a different maximum length for
strings depending on locale.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 285
termshighlightingformatter

name (Optional) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.
postfix (Optional) Postfix string appended to the
truncated string, for example, ’’.
postfixnlsid (Optional) Localized value of postfix string.
showastooltip (Optional) Whether the untruncated value is to
be shown as a mousever tooltip when the string
gets truncated (True) or not (False). Default is
true.
wrapped (Optional) Whether maxlen applies to the
entire string (False) or to each word in the
string (True). For example, if maxlen=’5’ and
wrapped=’true’, the string ʺhello worldʺ would
not be truncated, because the string can wrap
between words and no word exceeds the length
of 5. If wrapped=’false’, the string would be
truncated after ʺhelloʺ.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

termshighlightingformatter

Purpose
Formats a document by highlighting matching terms (exact matching and case insensitive). Ignores
text between ʺ< > characters.

286 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
yesnovalueformatter

Attributes

cssclass (Optional) CSS class to apply to this control.


datafield (Optional) Overrides the values of the terms
attribute
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name for this control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.
separator (Optional) String to be used between two
matching terms
terms (Optional) List of terms to be highlighted
visible (Optional) Boolean: Whether this control is
displayed (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

yesnovalueformatter

Purpose
Formats Yes/No values. Provides the facility to add a locale specific textual description to a Yes/No
value.

Since
6.5

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 287
argument

Passing arguments

argument

Purpose
Generates arguments that are passed to a control’s event handler.

Attributes

datafield (Optional) Overrides the value attribute with


data from a data source. If the data source is
not available, a null value is used.(Optional)
Overrides the value attribute with data from a
data source. If the data source is not available, a
null value is used.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.(Required)
Name of this control. Named controls are cached
on the server. Controls with the same name are
automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the value attribute value.(Optional) NLS lookup
key. The string corresponding to the NLS ID is
substituted for the value attribute value.
value (Optional) Argument value.(Optional) Argument
value.

288 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
argument

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

argument

Purpose
Generates arguments that are passed to a control’s event handler.

Attributes

contextvalue (Optional) Overrides the datafield attribute.


datafield (Optional) Overrides the value attribute with
data from a data source. If the data source is
not available, a null value is used.(Optional)
Overrides the value attribute with data from a
data source. If the data source is not available, a
null value is used.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.(Required)
Name of this control. Named controls are cached
on the server. Controls with the same name are
automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the value attribute value.(Optional) NLS lookup
key. The string corresponding to the NLS ID is
substituted for the value attribute value.
value (Optional) Argument value.(Optional) Argument
value.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 289
password

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Passwords

password

Purpose
Text control whose characters are displayed as * in the browser.

Attributes

cssclass (Optional) CSS class to apply to this control.


defaultonenter (Optional) Whether pressing the Enter key calls
the JavaScript handleKeyPress() function (True)
or not (False). Must be used with a button (on
the same page) that has its default attribute
set to true. The button event is fired when the
user presses the Enter key in the defaultonenter
control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False).
forcereenter (Optional) Whether, when the password control
is re‑drawn, the text in it is deleted (True) or not
(False). Deleting the text in the password control
forces the user to re‑enter a password.

290 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
password

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
onchange (Optional) Server‑side event handler. This event
is fired after the form is submitted.
required (Optional) Whether to force the user to provide
input to the password control on login before
the authentication service is invoked (True)
or not (False). Default is true. If this attribute
is set to false, you must also remove the
requiredfieldvalidator tag for the password
control on the login JSP page.
runatclient (Optional) Whether the onselect event is to run
on the client (True) or the server (False).
size (Optional) Length of the password control.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 291
attributeselector

tooltipnlsid (Optional) NLS key to use when looking up a


localized tooltip string.
value (Optional) Value stored in the control and
displayed in the password control.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Preferences

attributeselector

Purpose
Displays a list of attributes from which the user can compose and order items. The items are either a
list passed into the control or the attributes of a selected object type. Control state is manipulated on
the client and passed to the server via a hidden field when the page is submitted. This control is used
in the columnselector component to select attribute columns for display.

Attributes

buttoncssclass (Optional) CSS class to apply to button


appearance.
buttoncssstyle (Optional) CSS rule to apply to button
appearance.
buttonheight (Optional) Height (in pixels) of the button.

292 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attributeselector

buttonimagefolder (Optional) Location of the image folder, if


buttons are used to display items.
buttonwidth (Optional) Width (in pixels) of the button.
disabledclass (Optional) CSS class to apply to the disabled
control.
disabledstyle (Optional) Entire CSS‑syntax style sheet rule
(enclosed in quotes) to apply to a disabled item.
docbasetypes (Optional) Comma‑delimited list of the object
type names to display in the Docbase types
dropdown list.
docbasetypeslabel (Optional) Label to be displayed for the Docbase
type dropdown list.
docbasetypesnlsid (Optional) NLS string to be displayed as label for
the Docbase type dropdown list.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
items (Optional) Serialized list of items to be displayed
in the available items listbox. This list is supplied
when the user selects an object type or by the
component class. The default list before selection
is provided by the component definition, in the
<columns> element.
itemslabel (Optional) Label for the available items list.
itemsnlsid (Optional) NLS string for the available items list
label.
listboxcssclass (Optional) CSS class to apply to lisboxes.
listboxcssstyle (Optional) CSS rule to apply to listboxes.
listboxwidth (Optional) Width of the listboxes.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
orderingenabled (Optional) Whether to enable up and down
buttons that change the order of the list (True) or
not (False). Default is true.
selecteditems (Optional) Serialized list of items to be displayed
in the selected items listbox.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 293
attributeselector

selecteditemslabel (Optional) Label for the selected items list.


selecteditemsnlsid (Optional) NLS string for the selected items list
label.
showlabels (Optional) Whether to display data dictionary
labels (True) or the actual names (False) of object
types and attributes.
showrepeatingattributes (Optional) Whether to display repeating
attributes when displaying all the attributes for a
given type (True) or not (False).
size (Optional) Size of the listboxes. Default is 10.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
A serialized list of items can be an array of one string (value) or two strings (value and label). By
default, the list of items to be displayed is provided by the component definition, in the columns
element. For example, the drilldown component definition specifies that the object_name attribute
will be displayed but the title attribute will not, in the following excerpt:
<columns>
<!­­ <loadinvisibleattribute>true</loadinvisibleattribute>­­>
<column>
<attribute>object_name</attribute>
<label><nlsid>MSG_NAME</nlsid></label>
<visible>true</visible>
</column>
<column>
<attribute>title</attribute>
<label><nlsid>MSG_TITLE</nlsid></label>
<visible>false</visible>
</column>
...
</columns>

294 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
authoringapplicationformatter

authoringapplicationformatter

Purpose
Displays the string, ʺWeb Browserʺ, if the authoring application opens in a browser (that is, a system
inline application), the string, ʺDefault Applicationʺ if it opens in a desktop application (that is, a
system default application), otherwise, it displays the path to the authoring application on the
user’s local machine.

Attributes

name (Optional) Name for this control. Named


controls are cached on the server. Controls with
the same name are automatically indexed.

Description
Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

columnlist

Purpose
For internal use only.

Attributes

columnlabel (Optional) For internal use only.


columnnlsid (Optional) For internal use only.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 295
columnlist

columns (Optional) For internal use only.


columnsparamname (Optional) For internal use only.
cssclass (Optional) For internal use only.
datafield (Optional) For internal use only.
defaultselectedcolumns (Optional) For internal use only.
defaultselectedcolumnsparamname (Optional) For internal use only.
docbasetypes (Optional) For internal use only.
editcomponent (Optional) For internal use only.
editcontainer (Optional) For internal use only.
enabled (Optional) For internal use only.
id (Optional) For internal use only.
inheritinglabel (Optional) For internal use only.
inheritingpreference (Optional) For internal use only.
inherits (Optional) For internal use only.
name (Optional) For internal use only.
namelabel (Optional) For internal use only.
namenlsid (Optional) For internal use only.
selectedcolumns (Optional) For internal use only.
selectedcolumnsparamname (Optional) For internal use only.
showrepeatingattributes (Optional) For internal use only.
style (Optional) For internal use only.
value (Optional) For internal use only.
visible (Optional) For internal use only.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

296 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
preference

preference

Purpose
Displays a preference for a component and saves user entries. This control embeds a columnlist
control that generates a label and value in each row and, optionally, a description label below this row.

Attributes

cssclass (Optional) CSS class to apply to this control.


datafield (Optional) Datafield that provides a preference
to be displayed. Overrides the value and
preferenceid attributes.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
preferenceid (Optional) ID of the preference to be retrieved.
One of the following attributes must have a
value: preferenceid, datafield, or value.
scopeid (Required) Name of the preferencescope control.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
value (Optional) Preference to be displayed; overrides
the preferenceid attribute.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 297
preferencedisplaygroups

Usage
The preference control instantiates the columnlist control and provides the label to display the current
column selection and a link that nest to the Column Selector component to modify the list of columns.
Preferences for a component, and default preference values, must be defined in the component
Configuration file, within a <preferences> element. See Web Development Kit Development Guidefor
more information on defining component preferences. User preferences that apply across components
are defined in the general preferences component.

preferencedisplaygroups

Purpose
Renders preferences that have display group configuration definitions in the
<preferencedisplaygroups> element of a component definition (for example, the display_preferences
component definition). This control loops around the preference groups defined in
<preferencedisplaygroups> element and renders the enclosed body content for each iteration.

Attributes

cssclass (Optional) CSS class to apply to this control.


id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
prefidattrname (Required) Value of this attribute defines the
name of the page context attribute in which the
current preference id is stored.
scopeid (Required) Value of this attribute is used
to bind the preferencedisplaygroup to the
preferencescope control and has essentially
the same role as the scopeid on the preference
control (which defines the scope for the
preferencedisplaygroup configuration lookup).

298 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
preferencedisplaygroups

scopeidattrname (Required) Value of this attribute defines the


name of the page context attribute in which the
scopeid for the preferencedisplaygroup tag is
stored.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
Preference can be displayed in groups. The following elements can be added to the component
definition to display groups:
<preferencedisplaygroups>
<group id=xxx>
<members>
<preference­ref id=a1 />
<preference­ref id=a2 />
...
</members>
<label><nlsid>MSG_FOO</nlsid></label>
</group>
<group id=yyy>
...
</group>
...
</preferencedisplaygroups>

The order of groups and the order of preferences inside a group controls the display of preference
groups. The preference‑ref element must have an ID that matches an existing preference id in the
<preferences> element of the component definition. The group <label> is used for rendering the
group title.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 299
preferencescope

preferencescope

Purpose
Used internally by the preference control to retrieve preference data. This control is hidden on the
JSP page, which must contain one or more preference controls.

Attributes

componentid (Optional) For internal use only.


context (Optional) For internal use only.
cssclass (Optional) For internal use only.
defaultscope (Optional) For internal use only.
enabled (Optional) For internal use only.
focus (Optional) For internal use only.
height (Optional) For internal use only.
id (Optional) For internal use only.
name (Optional) For internal use only.
onchange (Optional) For internal use only.
onselect (Optional) For internal use only.
runatclient (Optional) For internal use only.
style (Optional) For internal use only.
tabindex (Optional) For internal use only.
tooltip (Optional) For internal use only.
tooltipnlsid (Optional) For internal use only.
userlevelprefscomponent (Optional) For internal use only.
value (Optional) For internal use only.
visible (Optional) For internal use only.
width (Optional) For internal use only.

300 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbasefoldertree

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
This control should not be used independently. It is called by the WDK preferences framework.

Repositories

docbasefoldertree

Purpose
Generates a folder tree hierarchy of the cabinets and folders in a repository. Set the limit
for number of folders to be displayed in the tree in the Environment.properties file (in
/WEB‑INF/classes/com/documentum/web/formext). Larger numbers are replaced with a More
Folders link.

Attributes

cachechildren (Optional) Whether children are cached when


nodes are collapsed. Default is true.
cssclass (Optional) CSS class to apply to this control.
disabledclass (Optional) CSS class to apply to the text of
disabled rows.
disabledstyle (Optional) Entire CSS‑syntax style sheet rule
(enclosed in quotes) to apply to a disabled tree
item.
dragenabled (Optional) Whether to enable (True) or disable
(False) drag and drop to and from the tree.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 301
docbasefoldertree

enabled (Optional) Whether this control is enabled (True)


or disabled (False).
frameborder (Optional) Whether a frame border is required
(True) or not (False). Default is true. Valid
only when the width and height attributes are
specified.
height (Optional) Height of the entire tree control. Use
with the width attribute. The tree is placed in an
IE Iframe of the specified width and height.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
includeassemblydocuments (Optional) Whether to include virtual document
snapshots in the tree (True) or not (False).
includevirtualdocuments (Optional) Whether to include virtual documents
in the tree (True) or not (False).
multiselect (Optional) Whether to enable multiple expansion
of tree nodes (True) or not (False). Setting this
attribute to true might have a negative impact
performance.
multiselectdepth (Optional) Level at which multiple expansion is
supported. For example, a level of 2 prevents
multiple repositories (level 1) from being
expanded in the tree.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nodeheight (Optional) Height of an individual node graphic.
Default is 17. If node images exist, the default is
the height of Tplus.gif.
nodewidth (Optional) Width of an individual node graphic.
Default is 17. If node images exist, the default is
the width of Tplus.gif.
normalclass (Optional) CSS class to apply to text of normal
rows.
normalstyle (Optional) Entire CSS‑syntax style sheet rule
enclosed in quotes to apply to a normal tree item.

302 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbasefoldertree

onclick (Optional) Event fired when the user clicks clicks


this control. This event is handled immediately
on the server (when the runatclient attribute
is false) or on the client (when the runatclient
attribute is true).
oncollapse (Optional) Event fired when the user attempts
to collapse a node. If you override this node,
then you need to write code to collapse the
appropriate node.
ondrop (Optional) Name of an event handler for the
drop event in the component class
onexpand (Optional) Fired when the user attempts to
expand a node. If you override this node, then
you need to write code to expand the appropriate
node.
rootpath (Optional) Repository path to the root folder of
the tree. Default is the repository root itself.
runatclient (Optional) Whether the event is to run on the
client (True) or the server (False).
selectedclass (Optional) Class to apply to the text of selected
rows.
selectedstyle (Optional) Entire CSS‑syntax style sheet rule
enclosed in quotes to apply to a selected tree
item.
showicons (Optional) Whether icons for each tree item are
displayed (True) or not (False). Default is false.
showlines (Optional) Whether lines between each tree item
are displayed (True) or not (False). Default is
true.
showlockedicon (Optional) Whether lock icons are displayed next
to locked objects in the tree (True) or not (False).
showroot (Optional) Whether the root node is displayed
(True) or not (False). Default is true.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 303
docbasefoldertree

tabindex (Optional) Value (a whole number from 0 to


32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
value (Optional) Selected node ID. Stores the name of
the selected tree item. This attribute is generally
managed programmatically.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of the entire tree control. Use
with the height attribute. The tree is placed in an
IE Iframe of the specified width and height.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

304 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseicon

docbaseicon

Purpose
Generates a Documentum icon for the type and format of the object. The tag will resolve the icon
based on format first, then type. Both format attributes override type attributes if both are resolved to
icons. You can set the format or type programmatically using setFormat() or setType(), respectively,
on the DocbaseIconTag class.

Attributes

assembledfromdatafield (Optional) Datafield that identifies


an object as a snapshot; for example,
assembledfromdatafield=’r_assembled_from_id’.
cssclass (Optional) CSS class to apply to this control.
folderiddatafield (Optional) Datafield that supplies the folder ID.
format (Optional) Format code; for example, msw97’.
formatdatafield (Optional) Overrides format attribute value. For
example, formatdatafield=’a_content_type’.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
isfrozenassemblydatafield (Optional) Datafield that identifies a
frozen snapshot object; for example,
isfrozenassemblydatafield=’r_has_frzn_
assembly’.
isreferencedatafield (Optional) Datafield that identifies whether the
object is a reference object.
isreplicadatafield (Optional) Datafield that identifies whether the
object is a replica object.
isvirtualdocdatafield (Optional) Datafield that identifies
virtual documents. For example:
isvirtualdocdatafield=’r_is_virtual_doc’.
linkcntdatafield (Optional) Datafield that determines whether
the document is a virtual document in a 4.1
repository.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 305
docbaselockicon

name (Optional) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.
size (Optional) Size (in pixels) of the icon. Valid
values are: 16 or 32.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
type (Optional) Name of the object type; for example,
dm_folder.
typedatafield (Optional) Overrides the type attribute value.
For example: typedatafield=’r_object_type’.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

docbaselockicon

Purpose
Displays an icon for locked repository objects.

306 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaselockicon

Attributes

cssclass (Optional) CSS class to apply to this control.


datafield (Optional) Datafield that supplies the lock
owner name and overrides lockowner attribute
value. For example: datafield=’r_lock_owner’.
You can set the datafield programmatically
using the setLockOwner() method on the
DocbaseLockIconTag class.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
lockowner (Optional) Name of the owner of the lock.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
size (Optional) Size (in pixels) of the icon. Valid
values are: 16 or 32.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 307
docbasepriorityicon

docbasepriorityicon

Purpose
Displays an icon that represents the priority of a repository object.

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
priority (Optional) Priority of the object
prioritydatafield (Optional) Overrides the priority attribute.
Datafield that supplies the priority for the
object; for example, prioritydatafield=’priority’.
You can set the priority programmatically
using the setPriority() method on the
DocbasePriorityIconTag class.
size (Optional) Size (in pixels) of the icon. Valid
values are: 16 or 32.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

308 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseselector

docbaseselector

Purpose
Generates a dropdown list of available Docbases

Attributes

cssclass (Optional) CSS class to apply to this control.


enabled (Optional) Whether this control is enabled (True)
or disabled (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
onselect (Optional) Event fired when the user selects a
repository. This event is handled immediately
on the server (when the runatclient attribute
is false) or on the client (when the runatclient
attribute is true).Specifies the event to be fired
when the user selects a DocbaseSpecifies the
event to be fired when the user selects a Docbase
runatclient (Optional) Whether the onselect event is to run
on the client (True) or the server (False).
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 309
docbaseselector (Webtop)

tabindex (Optional) Value (a whole number from 0 to


32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

docbaseselector (Webtop)

Purpose
Generates a dropdown list of available repositories.

310 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseselector (Webtop)

Attributes

cssclass (Optional) CSS class to apply to this control.


enabled (Optional) Whether this control is enabled (True)
or disabled (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
onselect (Optional) Specifies the event to be fired when
the user selects a repository.
runatclient (Optional) Whether the event is to run on the
client (True) or the server (False).
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute. Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 311
multidocbasetree

Description
Since
5.x

Tag library descriptor


dmwt (WEB‑INF\tlds\dmwebtop_1_0.tld)

multidocbasetree

Purpose
Generates the display of browser tree nodes including custom nodes. Set the limit for
the number of folders to be displayed in the tree in the Environment.properties file (in
/WEB‑INF/classes/com/documentum/web/formext). Larger numbers of folders are replaced with a
More Folders link for better performance.

Attributes

cachechildren (Optional) Whether children are cached when


nodes are collapsed (True) or not (False). Default
is true.
cssclass (Optional) CSS class to apply to this control.
disabledclass (Optional) CSS class to apply to the text of
disabled rows.
disabledstyle (Optional) Entire CSS‑syntax style sheet rule
enclosed in quotes to apply to a disabled tree
item.
dragenabled (Optional) Whether to enable (True) or disable
(False) drag and drop to and from the tree.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
frameborder (Optional) Whether a frame border is required
(True) or not (False). Default is true. Valid
only when the width and height attributes are
specified.

312 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
multidocbasetree

height (Optional) Height of the entire tree control. Use


with the width attribute. The tree is placed in an
IE Iframe of the specified width and height.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
includeassemblydocuments (Optional) Whether to include virtual document
assemblies in the tree (True) or not (False).
includevirtualdocuments (Optional) Whether to include virtual documents
in the tree (True) or not (False).
multiselect (Optional) Whether to enable multiple expansion
of tree nodes (True) or not (False). Setting this
attribute to true might have a negative impact
performance.
multiselectdepth (Optional) Level at which multiple expansion is
supported. For example, a level of 2 prevents
multiple repositories (level 1) from being
expanded in the tree.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nodeheight (Optional) Height of an individual node graphic.
Default is 17. If the node images exist, default is
the height of Tplus.gif.
nodewidth (Optional) Width of an individual node graphic.
Default is 17. If the node images exist, default is
the width of Tplus.gif.
normalclass (Optional) CSS class to apply to the text of
normal rows
normalstyle (Optional) Entire CSS‑syntax style sheet rule
enclosed in quotes to apply to a normal tree item.
onclick (Optional) Event fired when the user clicks
the folder path link. This event is handled
immediately on the server (when the runatclient
attribute is false) or on the client (when the
runatclient attribute is true).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 313
multidocbasetree

oncollapse (Optional) Event fired when the user attempts


to collapse a node. If you override this node,
then you need to write code to collapse the
appropriate node.
ondrop (Optional) Name of an event handler for the
drop event in the component class.
onexpand (Optional) Event fired when the user attempts to
expand a node. If you override this node, then
you need to write code to expand the appropriate
node.
runatclient (Optional) Whether the event is to run on the
client (True) or the server (False).
selectedclass (Optional) Class to apply to the text of selected
rows
selectedstyle (Optional) Entire CSS‑syntax style sheet rule
enclosed in quotes to apply to a selected tree
item.
showicons (Optional) Whether to display icons for each tree
item (True) or not (False). Default is false.
showlines (Optional) Whether to display lines between
trees (True) or not (False). Default is true.
showlockedicon (Optional) To display lock icons next to locked
objects in the tree (True) or not (False).
showroot (Optional) Whether the root node is displayed
(True) or not (False). Default is true.
value (Optional) Selected node ID. Stores the name of
the selected tree item. This attribute is generally
managed programmatically.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of the entire tree control. Use
with the height attribute. The tree is placed in an
IE Iframe of the specified width and height.

Description

Since
5.x

314 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
clustergroup

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Search

clustergroup

Purpose
Displays a search cluster group as a list of clustertree, page 317 controls.

Attributes

cssclass (Optional) CSS class to apply to this control.


disabledclass (Optional) CSS class to apply to the text of
disabled nested trees.
disabledstyle (Optional) Entire CSS‑syntax style sheet rule
(enclosed in quotes) to apply to the text of
disabled nested trees.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
frameborder (Optional) Whether a frame border is required
(True) or not (False). Default is true. Valid
only when the width and height attributes are
specified.
headerclass (Optional) CSS class to apply to the text of the
headers of normal trees.
height (Optional) Height of the entire tree control. Use
with the width attribute. The tree is placed in an
IE Iframe of the specified width and height.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 315
clustergroup

isVertical (Optional) Boolean: Whether to display


contained trees in cells from a single column
(True) or in a single row (False). Default is true.
name (Required) Name for this control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.
nodeheight (Optional) Height of an individual node graphic.
Default is 17. If the node images exist, default is
the height of Tplus.gif.
nodewidth (Optional) Width of an individual node graphic.
Default is 17. If the node images exist, default is
the width of Tplus.gif.
normalclass (Optional) CSS class to apply to the text of nested
normal trees.
normalstyle (Optional) Entire CSS‑syntax style sheet rule
enclosed in quotes to apply to a normal tree item.
onclick (Optional) Event fired when the user clicks clicks
this control. This event is handled immediately
on the server (when the runatclient attribute
is false) or on the client (when the runatclient
attribute is true).
runatclient (Optional) Specifies that the onclick event is to
run on the client (True) or the server (False).
selectedclass (Optional) Class to apply to the text of selected
tree item.
selectedstyle (Optional) Entire CSS‑syntax style sheet rule
enclosed in quotes to apply to a selected tree
item.
showheaders (Optional) Whether a header for each tree is
displayed (True) or not (False).
showicons (Optional) Whether icons for each tree item are
displayed (True) or not (False). Default is false.
showlines (Optional) Whether lines between each tree item
are displayed (True) or not (False). Default is
true.
showroots (Optional) Boolean: Whether to display (True)
the contained tree roots or not (False). Default is
true.

316 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
clustertree

value (Optional) Value stored in the control. Stores the


name of the selected tree item.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of this control.

Description

Since
6.0

Tag library descriptor


dmfxs (WEB‑INF\tlds\dmfxsearch_1_0.tld)

clustertree

Purpose
Displays a search cluster tree.

Attributes

cachechildren (Optional) Whether children are cached when


nodes are collapsed (True) or not (False). Default
is true.
clustericonpath (Optional) Specifies the icons displayed for the
tree nodes (by level). Paths are resolved within
the current user’s theme.
clusterrange (Optional) Specifies the degree to which results
within the same cluster are related. Valid values
are: ClusterTree.HIGH_CLUSTER_RANGE
= ʺHIGHʺ ClusterTree.MEDIUM_
CLUSTER_RANGE = ʺMEDIUMʺ
ClusterTree.LOW_CLUSTER_RANGE =
ʺLOWʺ

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 317
clustertree

clusterstrategy (Optional) Specifies the cluster strategies


that define the meaningful data used to
compute cluters. You must declare the cluster
strategies in the strategies configuration file
(wdk\config\clusterstrategies_config.xml).
cssclass (Optional) CSS class to apply to this control.
disabledclass (Optional) CSS class to apply to the text of
disabled rows.
disabledstyle (Optional) Entire CSS‑syntax style sheet rule
(enclosed in quotes) to apply to disabled tree
items.
dragenabled (Optional) Whether dragging the control is
supported (True) or not (False).
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
frameborder (Optional) Whether a frame border is required
(True) or not (False). Default is true. Valid
only when the width and height attributes are
specified.
height (Optional) Height of the entire tree control. Use
with the width attribute. The tree is placed in an
IE Iframe of the specified width and height.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
misccluster (Optional) Specifies a label for the node
containing all results that are not included in any
real cluster. This node is hidden, if a value is
not specified.
multiselect (Optional) Whether to enable multiple expansion
of tree nodes (True) or not (False).To add or
remove a node to or from the current selection,
use Ctrl+click. To select all the nodes from
the first node selected to the current one, use
Shift+click. A parent and child cannot be selected
at the same time.
multiselectdepth (Optional) Level at which multiple expansion is
supported. For example, a level of 2 prevents
multiple repositories (level 1) from being
expanded in the tree.

318 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
clustertree

name (Required) Name for this control. Named


controls are cached on the server. Controls with
the same name are automatically indexed.
nodeheight (Optional) Height of an individual node graphic.
Default is 17. If the node images exist, default is
the height of Tplus.gif.
nodewidth (Optional) Width of an individual node graphic.
Default is 17. If the node images exist, default is
the width of Tplus.gif.
normalclass (Optional) CSS class to apply to the text of a
normal tree item.
normalstyle (Optional) Entire CSS‑syntax style sheet rule
enclosed in quotes to apply to a normal tree item.
onclick (Optional) Event fired when the user clicks clicks
this control. This event is handled immediately
on the server (when the runatclient attribute
is false) or on the client (when the runatclient
attribute is true).
oncollapse (Optional) Event fired when the user attempts
to collapse a node. If you override this node,
then you need to write code to collapse the
appropriate node.
onexpand (Optional) Client event fired when the user
attempts to expand a node. If you override this
node, then you need to write code to expand the
appropriate node.
rootlabel (Optional) String to display as the label for the
root node.
runatclient (Optional) Specifies that the onclick event is to
run on the client (True) or the server (False).
selectedclass (Optional) Class to apply to the text of selected
tree items.
selectedstyle (Optional) Entire CSS‑syntax style sheet rule
enclosed in quotes to apply to a selected tree
item.
showicons (Optional) Whether icons for each tree item are
displayed (True) or not (False). Default is false.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 319
repositorysearch

showlines (Optional) Whether lines between each tree item


are displayed (True) or not (False). Default is
true.
showroot (Optional) Whether the root node is displayed
(True) or not (False). Default is true.
subclustericonpath (Optional) Specifies the icons displayed for the
tree nodes (by level). Paths are resolved within
the current user’s theme.
subclusterstrategy (Optional) Specifies the sub‑cluster strategies
that define the meaningful data used to compute
sub‑clusters. You must declare the cluster
strategies in the strategies configuration file
(wdk\config\clusterstrategies_config.xml).
value (Optional) Value stored in the control. Stores the
name of the selected tree item.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of this control.

Description
Since
6.0

Tag library descriptor


dmfxs (WEB‑INF\tlds\dmfxsearch_1_0.tld)

repositorysearch

Purpose
Top level container control that uses the other search controls to form a search query. All search
controls on the JSP page must be contained within this control.

320 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchattribute

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Required) Name for this control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.

Description
Since
5.x

Tag library descriptor


dmfxs (WEB‑INF\tlds\dmfxsearch_1_0.tld)

searchattribute

Purpose
Displays a repository object attribute for search criterion.

Attributes

andorvisible (Optional) For internal use only. Whether the


AND/OR selector is displayed (True) or not
(False). Default is true.6.0: Deprecated.
attribute (Optional) Attribute of objects in a repository
that can be searched.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 321
searchattribute

casevisible (Optional) Removes the checkbox Match


case in advanced search. By default, the
search is case sensitive for faster performance.
The default match case is set in the
/wdk/config/advsearchex.xml file. Applies only
to non‑indexed repositories.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
height (Optional) Height of this control as an input
control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) String to be displayed for the attribute.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label attribute value.
removable (Optional) For internal use only. To enable (True)
or disable (False) removing the attribute from
the containing group.6.0: Deprecated.
size (Optional) Size (in pixels) of this control as a
text‑input control.
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.

322 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchattribute

valuewidth (Optional) Width of the value field. Specify


this attribute when you want the width of the
value field to be different from the width of the
other fields (such as the attribute and operator
drop‑down lists). Default is the value of the
width attribute.

Since 6.5.

visible (Optional) (Boolean) Whether this control is


displayed (True) or hidden (False).
width (Optional) Width of this control as in input
control.

Description
Since
5.x

Tag library descriptor


dmfxs (WEB‑INF\tlds\dmfxsearch_1_0.tld)

Usage
Since 6.0: Conditional value assistance is supported. To enable conditional value assistance, place the
searchattribute controls in the same order on the JSP as the value assistance dependencies.
Data dictionary value assistance is supported. To add non‑data dictionary value assistance,
you configure custom classes to perform the assistance. The assistance is configured in
/wdk/config/advsearchex.xml. For information on setting up non‑data dictionary value assistance for
search, see ʺProgrammatic Search Value Assistance in Web Development Kit Development Guide.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 323
searchattributegroup

searchattributegroup

Purpose
Container of other attribute‑related search controls. It creates the child controls when the user clicks
Add. It contains tags for specific types of attributes and can exclude other, specified types of attributes.
For information on how to display specific attributes for search, refer to ʺConfiguring advanced
search in Web Development Kit Development Guide.

Attributes

addvisible (Optional) Whether the Add and Remove


buttons are displayed (True) or not (False).
Default is true.
casevisible (Optional) Removes the checkbox Match case in
advanced search. The search is by default case
sensitive for faster performance. Default match
case is set in /wdk/config/advsearchex.xml.
Applies only to non‑indexed repositories.
defaultattribute (Optional) Default attribute to be selected.
Cannot be an attribute specified in the
excludenames attribute.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
excludenames (Optional) A comma‑separated list of attribute
names to be excluded from the auto‑populated
dropdown for attribute names.
excludetypes (Optional) A comma‑separated list of
attribute datatypes to be excluded from the
auto‑populated dropdown for attribute names.
Valid attribute datatypes are: Boolean (or bool),
id, double, integer (or int, date, time, string,
number (DM_DOUBLE or DM_INTEGER).
height (Optional) Height of fields.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.

324 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchattributegroup

initialattributes (Optional) Comma‑separated list of attribute


names that are displayed and selected by default
in the group without having to click Add
Property. A property line (that is, an AND/OR
DropDown, Attribute Name Dropdown,
Operator DropDown, Value Box, and Remove
link) is displayed for each specified attribute
name. Since 5.3 SP4.
logicaloperatorpos (Optional) Whether to display logical operators
on the same line (sameline) as the rest of the
property line or on a newline (newline) when
the Add Property link is clicked. Default is
sameline.Since 6.0.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
opened (Optional) Whether to display the attribute
group as expanded (True) or collapsed (False).
Default is false.
size (Optional) Size (in pixels) of any text field.
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute. Since 6.0.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 325
searchattributegroup

valuewidth (Optional) Width of the value field. Specify


this attribute when you want the width of the
value field to be different from the width of the
other fields (such as the attribute and operator
drop‑down lists). Default is the value of the
width attribute.

Since 6.5.

visible (Optional) (Boolean) Whether this control is


displayed (True) or hidden (False).
width (Optional) Width of fields.

Description
Since
5.x

Tag library descriptor


dmfxs (WEB‑INF\tlds\dmfxsearch_1_0.tld)

Usage
By default, when the user clicks Add Property, the default operator is AND. Your component class can
call setLogicalOr on the searchattributegroup control to change the default to OR.
The precedence of constraints is given to the last constraint added. For example:
A
OR B
AND C
is equivalent to ((A OR B) AND C)

A
AND B
OR C
AND D
is equivalent to (((A AND B) OR C) and D)

326 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchdateattribute

searchdateattribute

Purpose
Subclass of SearchAttribute control. It can be used to input search values on date attributes.

Attributes

andorvisible (Optional) Whether the AND/OR selector is


displayed (True) or not (False). Default is true.
attribute (Optional) Date attribute of objects in a
repository that can be searched.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
height (Optional) Height of this control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) String to be displayed for the attribute.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label attribute value.
removable (Optional) For internal use only. To enable (True)
or disable (False) removing the attribute from
the containing group.
size (Optional) Size (in pixels) of the control if it is
rendered as a text control.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 327
searchdateattribute

tabindex (Optional) Value (a whole number from 0 to


32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute. Since 6.0.
valuespos (Optional) Whether to display values to the right
(right) or at the bottom (bottom) of this control.
Default is bottom.Since 6.0.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of this control.

Description
Since
5.x

Tag library descriptor


dmfxs (WEB‑INF\tlds\dmfxsearch_1_0.tld)

Usage
This control by default does not have a dropdown item to allow the user to select a date value that is
ʺIn the next day/week/month/yearʺ for effective date and expiration date attributes. The visibility of
the dropdown items is configured in /wdk/config/advsearchex.xml as follows:
<scope type="dm_sysobject">
<inthenextdate>
<a_effective_date>true</a_effective_date>
<a_expiration_date>true</a_expiration_date>
</inthenextdate>
</scope>

328 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchfulltext

searchfulltext

Purpose
Accepts keywords for a full‑text query. Searches indexed documents and indexed attributes. You can
use AND, OR, and NOT operators, and you can search on exact strings within quotation marks; for
example, ʺthis string”. Since 6.0 SP1: NOT operater is supported.

Attributes

autocompleteenabled (Optional) (Boolean) Enables (True) or disables


(False) autocompletion on the control. Default
is True.
autocompleteid (Optional) Key that is used to store the
autocomplete list in the user preferences.
You can set the same ID on two text controls,
for example, if they share the same set of
suggestions. If the control has no ID specified,
the ID will be generated based on the form id
and text control name, in the form consisting of
formid_controlid. For docbaseattribute controls
that render a text control, an ID is generated
using the attribute name, for example, keyword
or title.
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Datafield that supplies the keyword
and overrides the value and nlsid attributes.
defaultonenter (Optional) Whether pressing the Enter key calls
the JavaScript handleKeyPress() function (True)
or not (False). Must be used with a button (on
the same page) that has its default attribute
set to true. The button event is fired when the
user presses the Enter key in the defaultonenter
control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 329
searchfulltext

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
maxautocompletesuggestionsize (Optional) Number of matching suggestions to
display to the user. Default is 10.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the value attribute value.
onchange (Optional) Event fired when this control’s value
is changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted. The onchange event
handler cannot run on the client (that is, the
runatclient attribute cannot be true).
runatclient (Optional) Whether the onchange event is to run
on the client (True) or the server (False).
size (Optional) Size (in pixels) of the control if it is
rendered as a text control.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.

330 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchicon

tooltipnlsid (Optional) NLS key to use when looking up a


localized tooltip string.
value (Optional) Keyword for full‑text search.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmfxs (WEB‑INF\tlds\dmfxsearch_1_0.tld)

searchicon

Purpose
Displays a search template or a saved search icon according to the search type. It also differentiates
private from public searches. If the object type is not a saved search (dm_smart_list) or a search
template (dmc_search_template), then no icon is displayed.

Since
6.5

searchlocation

Purpose
Extends the label control and displays the current search source and folder path as a static string. The
location is expressed as a semi‑comma separated list in this format: soucename[:]/cabinet/folder.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 331
searchlocation

Attributes

align (Optional) (Image label only) Alignment of the


label text.
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Datafield that supplies the label and
overrides the label and nlsid attributes.
encodelabel (Optional) Whether the label is to be encoded
(True) or not (False). Specify true if the label can
contain HTML. Default is false.
height (Optional) Height of this control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
imagefolder (Optional) Folder in which the label graphics
are stored. If left.gif, right.gif and bg.gif are not
found, a normal label is displayed instead of an
image label.
label (Optional) String to be displayed for the location
display.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label attribute value.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of this control.

Description
Since
5.x

332 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchobjecttypedropdownlist

Tag library descriptor


dmfxs (WEB‑INF\tlds\dmfxsearch_1_0.tld)

searchobjecttypedropdownlist

Purpose
Generates a dropdown list from which the user can select the object type on which to search.

Attributes

autocompleteenabled (Optional) (Boolean) Enables (True) or disables


(False) autocompletion on the control. Default is
true.
autocompleteid (Optional) Key that is used to store the
autocomplete list in the user preferences.
You can set the same ID on two text controls,
for example, if they share the same set of
suggestions. If the control has no ID specified,
the ID will be generated based on the form id
and text control name, in the form consisting of
formid_controlid. For docbaseattribute controls
that render a text control, an ID is generated
using the attribute name, for example, keyword
or title.
cssclass (Optional) CSS class to apply to this control.
editable (Optional) Whether the user can type a value in
the control (True) or not (False).
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 333
searchobjecttypedropdownlist

forceselection (Optional) Whether to force the user to select


an item from the dropdown list (True) or not
(False). If true is specified, no item is selected
initially. If false is specified, the first item in the
list is selected initially.
height (Optional) Height of this control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
includetypes (Optional) Comma‑delimited list of object type
names that are displayed in the dropdown list;
for example, ʺmytype,yourtype. If a listed type is
selected, subtypes of that type are also queried
and displayed. Names of object types that do not
exist in the repository are not displayed.
maxautocompletesuggestionsize (Optional) Number of matching suggestions to
display to the user. Default is 10.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
onchange (Optional) Event fired when this control’s value
is changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted. The onchange event
handler cannot run on the client (that is, the
runatclient attribute cannot be true).
onselect (Optional) Event fired when the user selects a
repository. This event is handled immediately
on the server (when the runatclient attribute
is false) or on the client (when the runatclient
attribute is true).
runatclient (Optional) Whether the onchange event is to run
on the client (True) or the server (False).
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ

334 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchobjecttypedropdownlist

tabindex (Optional) Value (a whole number from 0 to


32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
value (Optional) ??
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of this control.

Description
Since
5.x

Tag library descriptor


dmfxs (WEB‑INF\tlds\dmfxsearch_1_0.tld)

Usage
The options in this list can be set programmatically. See for an example. This control has also a method
setOptionFromScrollableResultSet().
If multiple search locations are set in the user preferences, a reference repository is used to present the
list of types. This repository is either the first one selected by the end user or the repository that is
used as a BOF registry if the user has not selected a repository. If a selected type is not known to the
reference repository that is used to drive the composition of the advanced search, it will be ignored.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 335
searchscopecheckbox

searchscopecheckbox

Purpose
Checkbox that enables a user to set a value for a search setting or capability. Currently, it is used to
enable finding all versions or hidden objects.

Attributes

checkedvalue (Optional) Valid value for the scopename


attribute. Set to true or false for findAllVersions
or findHidden. Set to a specific object type to set
the base type for search.
cssclass (Optional) CSS class to apply to this control.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) Label for the checkbox.
labelalign (Optional) Vertical alignment of the checkbox
label. Valid values are: left, right.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label attribute value.
onchange (Optional) Event fired when this control’s value
is changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted. The onchange event
handler cannot run on the client (that is, the
runatclient attribute cannot be true).

336 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchscopecheckbox

onclick (Optional) Event fired when the user clicks this


control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
runatclient (Optional) Whether the onchange event is to run
on the client (True) or the server (False).
scopename (Required) Name of the global setting. Valid
values are: type, findAllVersions, findHidden,
DatabaseSearch.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
uncheckedvalue (Optional) Specifies a valid value for
the scopename. Set to true or false for
findAllVersions or findHidden. Set to a specific
object type to set the base type for search.
value (Optional) ??
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 337
searchsizeattribute

Description
Since
5.x

Tag library descriptor


dmfxs (WEB‑INF\tlds\dmfxsearch_1_0.tld)

searchsizeattribute

Purpose
Subclass of SearchAttribute control. It can be used to input search values on size attributes.
You can configure the global size values that are displayed, and their labels, by extending
/wdk/config/advsearchex.xml and copying the <searchsizeattributerange> element and its contents.

Attributes

andorvisible (Optional) Whether the AND/OR selector is


displayed (True) or not (False). Default is true.
attribute (Optional) Size attribute of an object type in a
repository that can be searched.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
height (Optional) Height of this control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
label (Optional) String to be displayed for the attribute.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label attribute value.

338 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchsizeattribute

removable (Optional) To enable (True) or disable (False)


removing the attribute from the containing
group.
size (Optional) Size (in pixels) of the control if it is
rendered as a text control.
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of this control.

Description

Since
5.x

Tag library descriptor


dmfxs (WEB‑INF\tlds\dmfxsearch_1_0.tld)

Usage
Size options can be configured for all instances of this control by extending the control configuration
file /wdk/config/advsearchex.xml. The following control attributes can be configured to add a search
size option:

Element Description
<option> Size option for display. Contains <label>,
<value>, <operator>, and <unit> elements.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 339
searchtemplatefreelist

Element Description
<label> String or <nlsid>. The NLS ID key
is resolved by the NLS resource file
SearchControlNlsProp.properties.
<operator> Size operator. Valid operators are: LT (less than),
GT (greater than).
<value> Default value to be displayed.
<unit> Units for value. Valid units: MB, KB.

searchtemplatefreelist

Purpose
Displays the list of search template constraints (based on the selected search template) to specify for a
new search. Webtop Extended Search is required.

Attributes

cssclassinputtext (Optional) CSS class to apply to this control


for the input‑text (attribute value). Default
value set to SearchTemplateFreeListTag.
DEFAULT_CSSCLASS_INPUT_TEXT
(defaultDocbaseAttributeStyle)
cssclasslabel (Optional) CSS class to apply to this control
for the label (attribute name to display).
Default value set to SearchTemplateFreeListTag.
DEFAULT_CSSCLASS_LABEL (fieldlabel).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
objectId (Optional) Object ID of the search template to
display.

340 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchtemplatehiddenfixedlist

style (Optional) CSS rule (enclosed inmarks) to apply


to this control; for example: style=ʺ{COLOR:
darkmagenta;DECORATION: underline}ʺ
width (Optional) Width of this control as an input
control (text‑input or dropdownlist).

Description
Since
6.0

Tag library descriptor


dmfxs (WEB‑INF\tlds\dmfxsearch_1_0.tld)

searchtemplatehiddenfixedlist

Purpose
Displays a search template’s sources and fixed expressions. Webtop Extended Search is required.

Attributes

cssclasslabel (Optional) CSS class to apply to this control


for the label (attribute name to display).
Default value set to SearchTemplateFreeListTag.
DEFAULT_CSSCLASS_LABEL (fieldlabel).
cssclasstext (Optional) CSS class to apply to this control
for the text (attribute value). Default value set
to SearchTemplateHiddenFixedListTag.DE‑
FAULT_CSSCLASS_TEXT (defaultDocbaseAt‑
tributeStyle)
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 341
sortableclustertreelist

name (Required) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.
objectId (Optional) Object ID of the search template
to display when displaying a saved search
template.
showfixedconstraints (Optional) Set to true to also display the fixed
expressions with the hidden expressions. Default
is false.
showsources (Optional) Set to ’true’ to display the sources
(locations) of the search template. Default is true.
style (Optional) CSS rule (enclosed inmarks) to apply
to this control; for example: style=ʺ{COLOR:
darkmagenta;DECORATION: underline}ʺ

Description
Since
6.0

Tag library descriptor


dmfxs (WEB‑INF\tlds\dmfxsearch_1_0.tld)

sortableclustertreelist

Purpose
Displays a search cluster tree (that is, ClusterTreeDefinition objects) that users can sort.

Attributes

cssclass (Optional) CSS class to apply to this control.


enabled (Optional) Whether this control is enabled (True)
or disabled (False).

342 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
sortableclustertreelist

focus (Optional) Whether this control accepts focus


(True) or not (False).
height (Optional) Height of this control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
multiselect (Optional) Whether to enable (True) or disable
(False) selection of multiple items for Add or
Remove. If a move operation is chosen, only the
first selection is moved. Default is false.
name (Required) Name for this control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.
onchange (Optional) Event fired when this control’s value
is changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted.
onselect (Optional) Event fired when the user clicks this
control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true). The form is not submitted until the
onselect event is fired.
runatclient (Optional) Specifies that the onclick event is to
run on the client (True) or the server (False).
size (Optional) Size of this control.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
value (Optional) Value stored in the control. Stores the
name of the selected tree item.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 343
sortablelistbox

visible (Optional) (Boolean) Whether this control is


displayed (True) or hidden (False).
width (Optional) Width of this control.

Description
Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

sortablelistbox

Purpose
Displays a listbox of values that the user can reorder and delete values.

Attributes

cssclass (Optional) CSS class to apply to this control.


enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False).
height (Optional) Vertical length of this control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.

344 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
sortablelistbox

multiselect (Optional) Whether to enable (True) or disable


(False) multiple selection in the listbox. When
multiselect is enables, the you can select multiple
items in the list and perform these actions: To
delete all selected items, click Remove. To move
only the first item of the selection, click the up
or down arrows. You cannot move all the items
in a selection.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
onchange (Optional) Not used. Will be deleted.
onselect (Optional) Not used. Will be deleted.
runatclient (Optional) Specifies that the onselect event is to
run on the client (True) or the server (False).
size (Optional) Number of rows of selectable data
visible in this control.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control. For
example: style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
value (Optional) Not used. Will be deleted.
visible (Optional) (Boolean) Whether the control is
rendered as visible (True) or hidden (False).
width (Optional) Horizontal length of this control.

Description
Since
6.0

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 345
strategyselector

Usage
When this control is initialized, the first item is selected. You can initialize this control with values
using a Java class. You can add values to this control after initialization by using another control.

strategyselector

Purpose
Selector for selecting a search cluster strategy.

Attributes

cssclass (Optional) CSS class to apply to this control.


enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False).
forceselection (Optional) Boolean: Whether to require a cluster
strategy to be selected (True) or not (False).
height (Optional) Height of this control.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name for this control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.
onchange (Optional) Event fired when this control’s value
is changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted.

346 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
strategyselector

onselect (Optional) Event fired when the user clicks this


control. This event is handled immediately on
the server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true). The form is not submitted until the
onselect event is fired.
runatclient (Optional) Specifies that the onclick event is to
run on the client (True) or the server (False).
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
value (Optional) The ID of the cluster strategy
that is initially selected. This value
must match the the corresponding
clusterStrategy element’s id attribute in
the WDK\config\clusterstrategies_config.xml
file.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of this control.

Description
Since
6.0

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
This control is populated with the list of cluster strategies specified in the
WDK\config\clusterstrategies_config.xml file. Each list item is composed of a cluster
strategy localized label and ID.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 347
label

Each cluster strategy’s localized label is displayed in the


list. The cluster strategy localized labels are specified in the
wdk\strings\com\documentum\web\formext\control\cluster\ClusterStrategiesNlsProp.properties
file.
The ID is the clusterStrategy element’s id attribute specified in the clusterstrategies_config.xml file. An
example of a cluster strategy defined in the clusterstrategies_config.xml file is:
<clusterStrategy id='subject' nlsid='MSG_SUBJECT' icon='taxmgmt.gif'>
<criterion>object_name</criterion>
<criterion>subject</criterion>
<criterion>title</criterion>
</clusterStrategy>

Text display and input

label

Purpose
Text label control that can be used to label an image, user input control, or other user interface element.

Attributes

align (Optional) (Image label only) HTML horizontal


alignment attribute. Default is center.
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Overrides label with data from a data
source.
encodelabel (Optional) Whether the label is to be encoded
(True) or not (False). Specify true if the label can
contain HTML. Default is false.
height (Optional) (Image label only) Height of the label.
Set this to the height of the graphic, so that it
lines up correctly.

348 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
label

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
imagefolder (Optional) Folder in which the label graphics
are stored. If left.gif, right.gif and bg.gif are not
found, a normal label is displayed instead of an
image label.
label (Optional) String displayed as the label.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the label attribute value.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) (Image label only) Width of the label.
Default is the width of the label text.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 349
text

text

Purpose
Renders an HTML text box.

Attributes

autocompleteenabled (Optional) (Boolean) Enables (True) or disables


(False) autocompletion on the control. Default
is True.
autocompleteid (Optional) Key that is used to store the
autocomplete list in the user preferences.
You can set the same ID on two text controls,
for example, if they share the same set of
suggestions. If the control has no ID specified,
the ID will be generated based on the form id
and text control name, in the form consisting of
formid_controlid. For docbaseattribute controls
that render a text control, an ID is generated
using the attribute name, for example, keyword
or title.
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Overrides value and nlsid with a
string from a data source.
defaultonenter (Optional) Whether pressing the Enter key calls
the JavaScript handleKeyPress() function (True)
or not (False). Must be used with a button (on
the same page) that has its default attribute
set to true. The button event is fired when the
user presses the Enter key in the defaultonenter
control. The disableenter attribute overrides this
attribute.

350 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
text

disableenter (Optional) Set to true to prevent a form from


being submitted when a user presses the Enter
key while editing the title (that is, when the text
input field has the focus) in the comment editor.
Overrides the defaultonenter attribute.

Since 6.0.

enabled (Optional) Whether this control is enabled (True)


or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
maxautocompletesuggestionsize (Optional) Number of matching suggestions to
display to the user. Default is 10.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the value attribute value.
onchange (Optional) Event fired when this control’s value
is changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted.
runatclient (Optional) Whether the onchange event is to run
on the client (True) or the server (False).
size (Optional) Length of the text control.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 351
textarea

tabindex (Optional) Value (a whole number from 0 to


32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
value (Optional) String displayed in the text box.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

textarea

Purpose
Generates an HTML multi‑line text box.

352 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
textarea

Attributes

cols (Optional) Number of columns in the text area


control.
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Overrides the value and nlsid
attributes with a value from a data source.
editable (Optional) Whether the user can type in a value
(True) or not (False).
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
focus (Optional) Whether this control accepts focus
(True) or not (False).
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Required) Name for this control. Named
controls are cached on the server. Controls with
the same name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the value attribute value.
onchange (Optional) Event fired when this control’s value
is changed by the user. This event is not handled
immediately. It is handled on the server only
when the form is submitted.
rows (Optional) Number of rows in the text area
control.
runatclient (Optional) Whether the onchange event is to run
on the client (True) or the server (False).
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 353
textarea

tabindex (Optional) Value (a whole number from 0 to


32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
value (Optional) Value displayed in the text area box.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
wrap (Optional) Whether to turn word‑wrapping on
for displaying and submitted data from the
textarea field (True) or not (False).

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

354 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
browsertree (Webtop)

Trees

browsertree (Webtop)

Purpose
Generates the display of browser tree nodes including custom nodes. All attributes are the
same as those for the Docbase‑enabled control docbasefoldertree. You can set the limit for
number of folders to be displayed in the tree in the file Environment.properties, located in
/WEB‑INF/classes/com/documentum/web/formext. Larger numbers will be replaced with a More
Folders link for better performance.

Attributes

cachechildren (Optional) Determines whether children are


cached when nodes are collapsed (default = true)
cssclass (Optional) CSS class to apply to this control.
disabledclass (Optional) Class to apply to text of disabled rows.
disabledstyle (Optional) An entire CSS‑syntax style sheet rule
enclosed in quotes and applied to a disabled tree
item
dragenabled (Optional) Whether dragging the control is
supported (True) or not (False).
enabled (Optional) Whether this control is enabled (True)
or disabled (False).
frameborder (Optional) When width and height are specified
to put the tree in an iFrame, specifies whether a
frame border is required (default = true).
height (Optional) The height of the entire tree control.
Use with width to put the tree in an IE Iframe of
the specified width and height.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 355
browsertree (Webtop)

includeassemblydocuments (Optional) Set to true to include virtual document


assemblies (snapshots) in the tree
includevirtualdocuments (Optional) Set to true to show virtual documents
in the tree
multiselect (Optional) Whether to enable multiple expansion
of tree nodes (True) or not (False). Setting this
attribute to true might have a negative impact
performance.
multiselectdepth (Optional) Level at which multiple expansion is
supported. For example, a level of 2 prevents
multiple repositories (level 1) from being
expanded in the tree.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nodeheight (Optional) The height of an individual node
graphic (default = 17). If node images exist,
default height = height of Tplus.gif.
nodewidth (Optional) The width of an individual node
graphic (default = 17). If node images exist,
default width = width of Tplus.gif.
normalclass (Optional) CSS class to apply to text of normal
rows.
normalstyle (Optional) An entire CSS‑syntax style sheet rule
enclosed in quotes and applied to a normal tree
item
onchange (Optional) Event fired when the control has been
modified (fired when an onclick occurs).
onclick (Optional) Event fired when the user clicks clicks
this control. This event is handled immediately
on the server (when the runatclient attribute
is false) or on the client (when the runatclient
attribute is true).
oncollapse (Optional) Fire when the user attempts to
collapse a node. If you override this node,
then you need to write code to collapse the
appropriate node.
ondrop (Optional) Name of an event handler for the
drop event in the component class.

356 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
browsertree (Webtop)

onexpand (Optional) Fired when the user attempts to


expand a node. If you override this node, then
you need to write code to expand the appropriate
node.
rootpath (Optional) Repository path to the root folder for
the tree (default = the repository root itself).
runatclient (Optional) Specifies that the event is to run on
the client, instead of the server. The onchange
event cannot run on the client.

Since: 6.5
selectedclass (Optional) Class to apply to text of selected rows.
selectedstyle (Optional) An entire CSS‑syntax style sheet rule
enclosed in quotes and applied to a selected tree
item.
showicons (Optional) Determines visibility of icons for each
tree item (default = false).
showlines (Optional) Determines visibility of tree lines
(default = true).
showroot (Optional) Determines visibility of the root node
(default = true).
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute. Since 6.0.
value (Optional) Sets the selected node ID. Stores the
name of the selected tree item. This attribute is
generally managed programmatically.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 357
tree

visible (Optional) (Boolean) Whether this control is


displayed (True) or hidden (False).
width (Optional) The width of the entire tree control.
Use with height to put the tree in an IE Iframe of
the specified width and height.

Description
Since
5.x

Tag library descriptor


dmwt (WEB‑INF\tlds\dmwebtop_1_0.tld)

tree

Purpose
Generates a tree control.

Attributes

cachechildren (Optional) Whether children are cached when


nodes are collapsed (True) or not (False). Default
is true.
cssclass (Optional) the CSS class to apply to this control.
disabledclass (Optional) CSS class to apply to the text of
disabled rows.
disabledstyle (Optional) Entire CSS‑syntax style sheet rule
(enclosed in quotes) to apply to the disabled
control.
dragenabled (Optional) Unsupported.
enabled (Optional) Whether this control is enabled (True)
or disabled (False).

358 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
tree

frameborder (Optional) Whether a frame border is required


(True) or not (False). Default is true. Valid
only when the width and height attributes are
specified.
height (Optional) Height of the entire tree control. Use
with the width attribute. The tree is placed in an
IE Iframe of the specified width and height.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
inlinerefresh (Optional) Whether to cause partial refresh of the
tree (True) rather than the full tree (False) when
user expands or collapses a node.
multiselect (Optional) Whether to enable multiple expansion
of tree nodes (True) or not (False).To add or
remove a node to or from the current selection,
use Ctrl+click. To select all the nodes from
the first node selected to the current one, use
Shift+click. A parent and child cannot be selected
at the same time.
multiselectdepth (Optional) Level at which multiple expansion is
supported. For example, a level of 2 prevents
multiple repositories (level 1) from being
expanded in the tree.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nodeheight (Optional) Height of an individual node graphic.
Default is 17. If the node images exist, default is
the height of Tplus.gif.
nodewidth (Optional) Width of an individual node graphic.
Default is 17. If the node images exist, default is
the width of Tplus.gif.
normalclass (Optional) Class to apply to the text of normal
rows.
normalstyle (Optional) Entire CSS‑syntax style sheet rule
enclosed in quotes to apply to a normal tree item.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 359
tree

onclick (Optional) Event fired when the user clicks a tree


item. This event is handled immediately on the
server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
oncollapse (Optional) Event fired when the user attempts
to collapse a node. If you override this node,
then you need to write code to collapse the
appropriate node.
ondrop (Optional) Unsupported.
onexpand (Optional) Client event fired when the user
attempts to expand a node. If you override this
node, then you need to write code to expand the
appropriate node.
runatclient (Optional) Whether the onclick event is to run on
the client (True) or the server (False).
selectedclass (Optional) Class to apply to the text of selected
rows.
selectedstyle (Optional) Entire CSS‑syntax style sheet rule
enclosed in quotes to apply to a selected tree item
showicons (Optional) Whether icons associated with each
tree item are displayed (True) or not (False).
Default is false.
showlines (Optional)Whether to display lines between trees
(True) or not (False). Default is true.
showroot (Optional) Whether the root node is displayed
(True) or not (False). Default is true.
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from

360 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
combocontainerpanel

being tabbed to (in most browsers), specify a


value of ‑1 for this attribute.Since 6.0.
value (Optional) Value stored in the control. Stores the
name of the selected tree item.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width of the entire tree control. Use
with the height attribute. The tree is placed in an
IE Iframe of the specified width and height. If no
Iframe is used, the tree is rendered inline.

Description

Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

User feedback

combocontainerpanel

Purpose
Generates a panel to display progress.

Attributes

progressbarid (Optional) ID of the assoicated progressbar


control on the page.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 361
formatmessageparams

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
This control should be used to wrap a <dmfx:containerinclude/> control in order to display a progress
bar. The JSP page must also contain a progressbar control.

formatmessageparams

Purpose
Formats a message by inserting parameters into the message at runtime.

Attributes

align (Optional) HTML horizontal alignment attribute.


Default is center.
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Overrides the nlsid attribute.
encodelabel (Optional) Whether the label is to be encoded
(True) or not (False). Specify true if the label can
contain HTML. Default is false.
height (Optional) Height (in pixels) of the message field.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

362 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
formatmessageparams

nlsid (Required) NLS lookup key. ID of an NLS string


that provides the fixed portion of the message,
with dynamic placeholder within numbered
brackets ({})
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).
width (Optional) Width (in pixels) of the message field.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Usage
The parameters are contained within the body of the control using argument controls. The
place holders in an nlsid string are filled in at runtime with the argument values. For example:
ʺMSG_CHECKED_IN_BY =Checked in by {0} has a placeholder for 1 parameter, {0}. During runtime,
the placeholder {0} gets filled in with first argument in control body. For example:
<dmfx:formatmessageparams nlsid="MSG_CHECKED_IN_BY">
<dmfx:argument name="vm_owner" datafield="owner_name"/>
</dmfx:formatmessageparams>

The NLS string in the properties file is as follows:


MSG_CHECKED_IN_BY=checked in by {0},

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 363
progressbar

progressbar

Purpose
Displays a progress bar. Should be used with a progressbarupdater or a combocontainerpanel control
for which the progressbarid attribute value is set to the same value as the progressbar id.

Attributes

height (Optional) Height of the progress bar control.


id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
maximum (Optional) Maximum percent value on progress
bar scale. Default is 100.
message (Optional) String message to be displayed with
the progress bar.
minimum (Optional) Minimum percent value on progress
bar scale. Default is 0.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the message attribute value.
value (Optional) Current percent complete.
width (Optional) Width (in pixels) of the progress bar.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

364 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
progressbarupdater

progressbarupdater

Purpose
Updates a progress bar at specified steps. Should be used with a progressbar control.

Attributes

name (Optional) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.
progressbarid (Optional) ID of the progressbar control with
which this control is associated. Must matche
the ID attribute on the progressbar control in
the JSP page.
stepbarid (Optional) ID of a step bar.
steplabelid (Optional) Current percent complete.

Description
Since
5.x

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

promptedtext

Purpose
Text for a prompt.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 365
promptedtext

Attributes

autocompleteenabled (Optional) (Boolean) Enables (True) or disables


(False) autocompletion on the control. Default
is True.
autocompleteid (Optional) Key used to store the autocomplete
list in the user preferences. You can set the same
ID on two text controls, for example, if they share
the same set of suggestions. If the control does
not have an ID specified, the ID is generated
using this syntax: formid_controlid. formid is
the form id attribute and controlid is the text
control name. For docbaseattribute controls that
render a text control, an ID is generated using the
attribute name; for example, ʺkeyword or ʺtitle.
cssclass (Optional) CSS class to apply to this control.
datafield (Optional) Overrides the nlsid attribute.
defaultonenter (Optional) Whether pressing the Enter key calls
the JavaScript handleKeyPress() function (True)
or not (False). Must be used with a button (on
the same page) that has its default attribute
set to true. The button event is fired when the
user presses the Enter key in the defaultonenter
control.
enabled (Optional) Sets whether the control is enabled.
focus (Optional) True to allow the control to accept
focus.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
maxautocompletesuggestionsize (Optional) Number of matching suggestions to
display to the user. Default is 10.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
nlsid (Optional) NLS lookup key. The string
corresponding to the NLS ID is substituted for
the message attribute value.

366 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
promptedtext

onchange (Optional) Event fired when the control has been


modified (fired when an onclick occurs).
onclick (Optional) Event fired when the user clicks a tree
item. This event is handled immediately on the
server (when the runatclient attribute is false)
or on the client (when the runatclient attribute
is true).
prompt (Optional) Text for the prompt.
runatclient (Optional) Whether the onclick event is to run on
the client (True) or the server (False).
size (Optional) Length of the text control.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
tabindex (Optional) Value (a whole number from 0 to
32767, inclusive) that determines the order
in which this control is tabbed to (that is,
receives focus when the user presses the Tab
key) in relation to the other controls on the
page. Controls on the same JSP are tabbed to in
this sequence: Controls that specify a positive
number in this attribute are tabbed to starting
from the lowest number to the highest. Controls
that do not have this attribute, or specify a
value of 0 (zero) or no value for this attribute
are tabbed to in the order they appear in the
character stream. To prevent this control from
being tabbed to (in most browsers), specify a
value of ‑1 for this attribute.Since 6.0.
tooltip (Optional) String displayed when you place the
mouse pointer over this control.
tooltipnlsid (Optional) NLS key to use when looking up a
localized tooltip string.
value (Optional) Sets the selected node ID. Stores the
name of the selected tree item. This attribute is
generally managed programmatically.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 367
vdmbindingruleformatter

visible (Optional) (Boolean) Whether this control is


displayed (True) or hidden (False).
width (Optional) The width of the entire tree control.
Use with height to put the tree in an IE Iframe of
the specified width and height.

Description
Since
6.0

Tag library descriptor


dmf (WEB‑INF\tlds\dmform_1_0.tld)

Virtual documents

vdmbindingruleformatter

Purpose
Formats a virtual document binding rule.

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
vdmtreegridname (Required) Name of the vdmtreegrid control for
which the binding rule output is formatted.

368 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
vdmtreegrid

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

vdmtreegrid

Purpose
Generates a grid display of a virtual document tree or snapshot (assembly). The grid is a data
container similar to the data grid and must contain vdmtreegridrow tags to display the data.

Attributes

bordersize (Optional) Border (in pixels) around the datagrid.


cellpadding (Optional) Spacing between the cell content and
cell border.
cellspacing (Optional) Spacing between the cells in the grid.
cssclass (Optional) CSS class to apply to this control.
expanddepth (Optional) Number (integer) of node levels to
expand.
fixedheaders (Optional) Boolean: Whether the datagrid header
rows are to scroll with the body rows (False) or
not (True). Default is false. To set this attribute
value for all datagrid controls in your application,
set the following element value in the app.xml
file: <desktopui<.<datagrid>.<fixedheaders>.
This element ’s default value is true.Since 6.0.
height (Optional) Height of the entire tree control. Use
with the width attribute. The tree is placed in an
IE Iframe of the specified width and height.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 369
vdmtreegrid

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Required) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
paged (Optional) Whether data is displayed in pages
(True) or not (False).
pagesize (Optional) Number of objects per page, if the
pagesize attribute is set to true.
rowselection (Optional) Boolean: Enables (True) or disables
(False) mouse or keyboard row selection
(selecting one or more objects) and right‑click
context menus. Default is True. The app.xml
file’s desktopui/datagrid/rowselection element
must be set to true to enable this attribute.
showroot (Optional) Determines whether the root node is
displayed (default = true).
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
vdmid (Optional) ID of the virtual document root node.
width (Optional) Width of the entire tree control. Use
with the height attribute. The tree is placed in an
IE Iframe of the specified width and height. If no
Iframe is used, the tree is rendered inline.

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

370 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
vdmtreegridRow

vdmtreegridRow

Purpose
Generates a table row for each node in a virtual document.

Attributes

align (Optional) Horizontal alignment of the row.


altclass (Optional) CSS class for alternating rows.
altstyle (Optional) Inline CSS rule for alternating rows.
cssclass (Optional) CSS class to apply to this control.
height (Optional) Height of the row.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
showindent (Optional) Whether to indent the nodes by node
level in an outline style (True) or not (False).
Default is false.
showplusminus (Optional) Whether to display +/‑ symbols for
nodes that can be expanded or collapsed (True)
or not (False). Default is false.
style (Optional) CSS rule (enclosed in quotation
marks) to apply to this control; for
example:style=ʺ{COLOR: darkmagenta;
TEXT‑DECORATION: underline}ʺ
valign (Optional) Vertical alignment of the row.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 371
workfloweditorapplet

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Web Workflow Manager

workfloweditorapplet

Purpose
Generates an applet that displays the workflow editor.

Attributes

align (Optional) Horizontal alignment of applet text.


Possible values are the same as those for the
HTML IMG tag: left, right, top, texttop, middle,
absmiddle, baseline, bottom, absbottom.
height (Optional) Height of the applet.
hspace (Optional) Horizontal space between applet and
surrounding text.
id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
successhandler (Optional) Server‑side event handler that handles
the applet return.
tracelevel (Optional) Whether to turn on (1) or off (0)
tracing.
viewonly (Optional) Whether to disable (True) or enable
(False) all editing controls. When this attribute
value is true, only File > New, File > Open, and
File > Save As menu items are enabled.

372 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
workflowcompletetypeformatter

vspace (Optional) Vertical space between applet and


surrounding text.
width (Optional) Width of the applet.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

Workflow

workflowcompletetypeformatter

Purpose
Wraps a value for the integer that signifies the type of workflow completion.

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 373
workflowdisabledformatter

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

workflowdisabledformatter

Purpose
Wraps the integer that signifies the workflow in or out.

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

374 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
workflowdurationformatter

workflowdurationformatter

Purpose
Wraps the integer that signifies the workflow duration.

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

workflowstateicon

Purpose
Obtains an icon that represents the workflow state of a repository object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 375
workflowtaskstatusvalueformatter

Attributes

name (Optional) Name of this control. Named controls


are cached on the server. Controls with the same
name are automatically indexed.
size (Optional) Size (in pixels) of the icon.
state (Optional) Object state.
statedatafield (Optional) Datafield that overrides the state
attribute value. The datafield supplies
the state for the object, for example,
statedatafield=’w.r_runtime_state’.
visible (Optional) (Boolean) Whether this control is
displayed (True) or hidden (False).

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

workflowtaskstatusvalueformatter

Purpose
Wraps a workflow task status value.

376 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
workqueueflagvalueformatter

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

workqueueflagvalueformatter

Purpose
Wraps a work queue flag value (isAssigned).

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 377
workqueuetaskstatusvalueformatter

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

workqueuetaskstatusvalueformatter

Purpose
Wraps a work queue task status value.

Attributes

id (Optional) ID of this control. The ID is generated


by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
performerName (Required) User name of the work queue
performer.
wqname (Required) Name of the work queue.

Description

Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

378 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
xforms

xForms

xforms

Purpose
Renders a form for viewing or editing using the Chiba open source xforms engine. The application
server must have Java 1.4.x to display forms. The user must have the role form_user to view or edit a
form. Forms are designed through the Documentum Forms Builder product.

Attributes

formstemplate (Optional)ID of the template.


id (Optional) ID of this control. The ID is generated
by the framework. You can also set the ID in the
JSP page.
name (Optional) Name of this control. Named controls
are cached on the server. Controls with the same
name are automatically indexed.
objectid (Optional) Object ID for the form.
readonly (Optional) Whether to render the form for
viewing only (True) or editing (False).
tabindex (Optional)
xformsconfigid (Optional) ID that corresponds to an xforms
configuration.

Description
Since
5.x

Tag library descriptor


dmfx (WEB‑INF\tlds\dmformext_1_0.tld)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 379
xforms

Usage
When a form is saved, the control passes the form content to the Chiba engine for validation. Errors
are passed to the form. Each button on the form has a configurable event that is fired when the
button is clicked. The events are configured in an XML Configuration file whose ID is specified in
the control xformsconfigid attribute.
If a component must respond to a button event, the component should register an
XFormsControlListener and set the control event handler. The listener is required if the component
would like to listen to events that the control fires. The events are named onTriggerIdwhere TriggerId
is the trigger name.
Your component should add the listener in the onControlInitialized() method of the component class.
For example, if the Xforms Configuration file specifies a trigger listener for the Submit button with the
ID submit‑trigger, the component can register an event that responds to this trigger as follows:
public void onControlInitialized(Form form, Control control)
{
if (control instanceof XForms)
{
XForms value = (XForms)control;
value.setEventHandler("onsubmit­trigger", "onSubmitTrigger", form);
addControlListener(new XFormsControlListener());
}
}
public void onSubmitTrigger(Control control, ArgumentList arg)
{
//handle event here
}

The XForms Configuration file is a Chiba Configuration file. For more information on Chiba
configuration, see the Chiba Web site.

380 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Chapter 2
Actions Reference
Overview
Actions are grouped according to how they are used.

Common elements
This topic describes the elements that can be specified in more than one action configuration file.
Elements that can only be specified in one action configuration file are described in that action’s entry.

failoverenabled

<failoverenabled>true</failoverenabled>

Boolean: Whether to enable (true) failover for this action or not (false). Failover means that user
session data is persisted, and the load balancer routes the last HTTP request before failover to a
secondary server. Make sure that application‑level failover is specified in the app.xml file. You must
implement failover in your custom action.

invocation
Use this element structure to display the component that an action calls in a modal dialog box.
<invocation>
<modalpopup>
1 <windowsize>small</windowsize>
2 <refreshparentwindow>never</refreshparentwindow>
</modalpopup>
</invocation>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 381
appintginsertobject

1 Specifies the size of the modal dialog box. Valid values are small, medium, large and properties.
Default is medium. These default sizes are defined in the <themes> element in the wdk/app.xml file;
you can define your own sizes in this location.
2 Specify one of these values to determine whether the parent window is refreshed when the modal
dialog box is closed:
• always — (default) The parent window is always refreshed.
• onok — The parent window is refreshed only if the modal dialog box is closed and the return value
is not null. If a user cancels out of the modal dialog box, no refresh occurs. Since the framework
checks for the return value of the component to determine whether to refresh the parent window,
you must ensure that the proper return values are set for components that are configured for
modal dialog box display.
• never — The parent window is never refreshed.

reverse­precondition
Set to true to turn off the action for components within a precondition. Specify this element within
a <precondition> element preceding the <component> elements that specify the components for
which to turn off the action. In the following definition for the move action, the action is disabled in
the search component:
<precondition class="com.documentum.web.formext.action.ComponentPrecondition">
<reverse­precondition>true</reverse­precondition>
<component>search</component>
</precondition>

Application connectors

appintginsertobject

Purpose
Downloads object content to the client and sends the InsertObject event; called from within a Windows
application (Application Connectors).

382 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintginsertweblink

Parameters

folderId (Optional) Location of the current document.


User can then choose a new file name to import
to that folder or an existing document to check in
to the folder, or navigate from the folder.
locatorcomponent (Optional) Locates the destination folder for
import. Specify the component to start with (for
example, myfiles_streamline).

Description
Since
5.x

Configuration File
webcomponent\config\actions\appintg_actions.xml

Scope
All.

Usage
With Application Connectors, the repository object is inserted into the active document at the current
cursor position.

Elements
None.

appintginsertweblink

Purpose
Downloads a virtual link or DRL to the client and sends the InsertWebLink event; called from within a
Windows application (Application Connectors).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 383
appintgnewfromtemplate

Parameters

folderId (Optional) Location of the current document.


User can then choose a new file name to import
to that folder or an existing document to check in
to the folder, or navigate from the folder.
locatorcomponent (Optional) Locates the destination folder for
import. Specify the component to start with (for
example, myfiles_streamline).

Description
Since
5.x

Configuration File
webcomponent\config\actions\appintg_actions.xml

Scope
All.

Usage
With Application Connectors, a link to the repository object is inserted into the active document at
the current cursor position.

Elements
None.

appintgnewfromtemplate

Purpose
Creates a new document from a template, called from within a Windows application (Application
Connectors)

384 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintgopenfrom

Parameters

contentType (Optional) File format

Description
Since
5.x

Configuration File
webcomponent\config\actions\appintg_actions.xml

Scope
All.

Elements
None.

appintgopenfrom

Purpose
Locates a document in a repository to open within a Windows application (Application Connectors).

Parameters

contentType (Optional) Type of document.


folderId (Optional) ID of folder in which the document
is located.
launchViewer (Optional) Boolean flag that indicates whether to
launch a viewing application.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 385
appintgsaveas

locatorcomponent (Optional) ID of the locator component to


use for locating the document, for example,
myfiles_streamline.
showViewEdit (Optional) Boolean: Whether to display the
View/Edit prompt to the user (True) or not
(False). Default is true.Since 6.0.

Description
Since
5.x

Configuration File
webcomponent\config\actions\appintg_actions.xml

Scope
All.

Elements
None.

appintgsaveas

Purpose
Performs an import or checkin of current document from within a Windows application (Application
Connectors)

Parameters

contentType (Optional) Type of document


doCheckout (Optional)
filenamewithpath (Required) Name and path of the file to be
checked in.

386 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
about (Webtop)

folderId (Optional) Location of the current document.


The user can then choose a new file name to
import to that folder or an existing document to
check in to the folder, or navigate from the folder
locatorcomponent (Optional) Locates the destination folder for
import. Specify the component to start with (for
example, myfiles_streamline)

Description
Since
5.x

Configuration File
webcomponent\config\actions\appintg_actions.xml

Scope
All.

Elements
None.

Application management

about (Webtop)

Purpose
Calls the component about (Webtop), page 881 to display information about the Webtop application
and to optionally display tools.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 387
configuredocbroker

Parameters

enableTools (Optional) alias ctrlKeyPressed. Set to true to


display buttons to launch the API and DQL
editors.

Description
Since
5.x

Configuration File
webtop\config\generic_actions.xml

Scope
All.

Elements
None.

configuredocbroker

Purpose
Launches the configuredocbroker component in the dialogcontainer.

Parameters
None.

Description
Since
5.x

388 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
launchauthenticate

Configuration File
wdk\config\preferences_actions.xml

Scope
All.

Elements
None.

launchauthenticate

Purpose
Launches the authenticate component

Parameters

docbase (Required) Repository for which to display the


login dialog
docbroker (Optional) Name of the connection broker to
which the specified repository is projected
docbrokerPort (Optional) Port that needs to be used for the
specified connection broker
suppressLoginEvent (Optional) Specifies whether to fire the
ʺloginSuccessʺ or ʺloginCancelʺ client events
after the login dialog has been dismissed

Description
Since
5.x

Configuration File
wdk\config\session_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 389
launchauthenticateexternalsource

Scope
All.

Elements
None.

launchauthenticateexternalsource

Purpose
Displayed when a user is required to provide credential to an external source

Parameters

externalSource (Required) Source that is set up in the ECI


server. It is an internal name for the source,
and is used to obtain a suitable source name.
For example, for an internal source name
’general/GoogleBackends/Google‑French,’ it
returns ’Google‑French.’

Description
Since
5.x

Configuration File
wdk\config\session_actions.xml

Scope
All.

Elements
None.

390 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
logout

logout

Purpose
Logs the user out of the application

Parameters
The parameters are inherited from /wdk/config/session_actions.xml. See logout, page 392.

Description
Since
5.x

Configuration File
webcomponent\config\session_actions.xml

Parent Definition
/wdk/config/session_actions.xml

Scope
All.

Elements
execution/homeurl

<execution>
<homeurl></homeurl>
</execution>
URL to a JSP page or component that will be displayed when the user logs out of the application.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 391
logout

logout

Purpose
Logs the user out of the application

Parameters

homeurl (Optional) URL to a JSP page or component


that will be displayed when the user logs out of
the application or when a DRL action has been
completed by a default account (anonymous)
user

Description
Since
5.x

Configuration File
wdk\config\session_actions.xml

Scope
All.

Elements
None.

logout (Webtop)

Purpose
Extends the WDK logout action and sets the value of the homeurl attribute to the component.

392 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newwindow

Parameters
The parameters are inherited from /wdk/config/session_actions.xml. See logout, page 392.

Description
Since
5.x

Configuration File
webtop\config\session_actions.xml

Parent Definition
/webcomponent/config/session_actions.xml

Scope
All.

Elements
None.

newwindow

Purpose
Launches the newwindow component to open a second WDK application browser window

Parameters
None.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 393
attributes (type dm_acl)

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
None.

Attributes

attributes (type dm_acl)

Purpose
Displays the attributes of an ACL

Parameters

objectId (Required) ID of the ACL.

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope

type dm_acl

394 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attributes (type dm_externalresult)

Elements
None.

attributes (type dm_externalresult)

Purpose
Displays the attributes page for an external result object.

Parameters

entryId (Required) ID of the result entry.


queryId (Required) ID of the query used for searching
the external source.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_externalresult_actions.xml

Scope

type dm_externalresult

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 395
attributes (type dm_group)

attributes (type dm_group)

Purpose
Displays the attributes for a repository group or creates a new group.

Parameters

objectId (Required) ID of the selected group. Set to


newobject to create a new group.
objectname (Required) Name of the group.

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\dm_group_actions.xml

Scope

type dm_group

Elements
None.

attributes (type dm_member_group)

Purpose
Displays the attributes for an object.

396 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attributes (type dm_member_user, entitlement collaboration6)

Parameters

objectId (Required) ID of the selected object.


objectname (Required) Name of the selected object.

Description

Since
5.x

Configuration File
webcomponent\config\admin\group\dm_member_actions.xml

Scope

type dm_member_group

Elements
None.

attributes (type dm_member_user, entitlement


collaboration6)

Purpose
Displays the attributes for a dm_member_user object. Requires a Documentum Collaborative Services
license.

Parameters

objectId (Required) ID of the selected object.


objectname (Required) Name of the selected object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 397
attributes (type dm_message_archive)

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\dm_member_actions.xml

Scope

type dm_member_user
entitlement collaboration6

Elements
None.

attributes (type dm_message_archive)

Purpose
Displays the attributes for a dm_message_archive object.

Since
6.5

attributes (type dm_sysobject)

Purpose
Displays the attributes for an object.

398 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attributes (type dm_user, entitlement collaboration6)

Parameters

enableShowAll (Optional) Determines whether the Show All


checkbox is displayed.(true|false)
objectId (Required) ID of the selected object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
failoverenabled
See failoverenabled, page 381.

attributes (type dm_user, entitlement collaboration6)

Purpose
Displays the attributes for a dm_user object. Requires a Documentum Collaborative Services license.

Parameters

objectId (Required) ID of the selected object.


objectname (Required) Name of the selected object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 399
attributes (type dm_user)

Description
Since
6.0

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

type dm_user
entitlement collaboration6

Elements
None.

attributes (type dm_user)

Purpose
Displays attributes for the selected user.

Parameters

objectId (Required) ID of the selected user. Set to


newobject to create a new user.
objectname (Required) Name of the user.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

400 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attributes (type workflow_calendar)

Scope

type dm_user

Elements
None.

attributes (type workflow_calendar)

Purpose
Displays the attributes page for an workflow calendar object.

Since
6.5

attributes (type dmc_workqueue_category)

Purpose
Displays the attributes of the selected object.

Parameters

objectId (Required) ID of the selected object.


objectname (Required) Name of the selected object.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 401
attributes (type dmc_workqueue_doc_profile)

Configuration File
webcomponent\config\actions\dmc_workqueue_category_actions.xml

Scope

type dmc_workqueue_category

Elements
None.

attributes (type dmc_workqueue_doc_profile)

Purpose
Displays the attributes page for a work queue document profile object.

Parameters

objectId (Required) ID of the work queue document


profile object.
objectname (Required) Name of the work queue document
profile.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_doc_profile_actions.xml

Scope

type dmc_workqueue_doc_profile

402 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attributes (type dmc_workqueue_policy)

Elements
None.

attributes (type dmc_workqueue_policy)

Purpose
Displays the attributes page for a work queue policy

Parameters

objectId (Required) ID of the work queue policy object.


objectname (Required) Name of the work queue policy
object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_policy_actions.xml

Scope

type dmc_workqueue_policy

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 403
attributes (type dmc_workqueue)

attributes (type dmc_workqueue)

Purpose
Displays the attributes of a dmc_workqueue object.

Parameters

objectId (Required) ID of the selected object.


objectname (Required) Name of the selected object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_actions.xml

Scope

type dmc_workqueue

Elements
None.

history (type dm_sysobject)

Purpose
Displays the audit trail for an object.

404 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
modifyversionlabels (type dm_sysobject)

Parameters

objectId (Required) ID of the selected object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
failoverenabled
See failoverenabled, page 381.

modifyversionlabels (type dm_sysobject)

Purpose
Modifies the version labels on an object or one or more nodes in a virtual document.

Parameters

nodeId (Optional) Node ID of the virtual document


node on which to change the version label.
objectId (Required) Object ID of the object on which to
change version labels.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 405
permissions (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

permissions (type dm_sysobject)

Purpose
Displays the permissions for a selected object.

Parameters

objectId (Required) ID of the selected object.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

406 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
properties (type dm_message_archive)

Elements
failoverenabled
See failoverenabled, page 381.

properties (type dm_message_archive)

Purpose
Displays the properties of an object (dm_message_archive).

Since
6.5

properties (type dm_sysobject)

Purpose
Displays the properties of an object (dm_sysobject).

Parameters

enableShowAll (Optional) Determines whether the Show All


checkbox is displayed.(true|false)
objectId (Required) ID of the selected object.
preferForms (Optional) Set to true to launch the forms
properties component
templateId (Optional) ID of associated Xforms template, if
any

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 407
relationships (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
failoverenabled
See failoverenabled, page 381.

relationships (type dm_sysobject)

Purpose
Shows relationships between objects.

Parameters

folderId (Optional) ID of the folder that contains the


selected object.
folderPath (Optional) Path to the folder that contains the
selected object. This path must be a complete
path from the repository root, for example,
/Documentation/Library/subfolder
objectId (Required) ID of the selected object.
objectNamePrefix (Optional)

408 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
rename (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
failoverenabled
See failoverenabled, page 381.

rename (type dm_sysobject)

Purpose
Renames an object in the repository. The user must have a role of contributor or higher and
write_permit access to the parent folder or cabinet (valid values: DELETE_PERMIT | WRITE_PERMIT
|VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT | BROWSE_PERMIT | NONE_PERMIT).

Parameters

lockOwner (Optional) User who has checked out the object


objectId (Required) The ID of the object to be renamed.
ownerName (Optional) User who owns the checked in object

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 409
versions (type dm_sysobject)

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

versions (type dm_sysobject)

Purpose
Displays the versions of an object. Versions are disabled for folders and cabinets

Parameters

folderId (Optional) ID of the folder that contains the


selected object.
folderPath (Optional) Path to the folder that contains the
selected object. This path must be a complete
path from the repository root, for example,
/Documentation/Library/subfolder
objectId (Required) ID of the selected object.
objectNamePrefix (Optional)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

410 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
folderbrowse (privilege sysadmin, type dm_user)

Scope

type dm_sysobject

Elements
failoverenabled
See failoverenabled, page 381.

Cabinets and folders

folderbrowse (privilege sysadmin, type dm_user)

Purpose
Allows the administrator to browse a list of folders in a repository.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

privilege sysadmin
type dm_user

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 411
newcabinet (type dm_docbase)

Elements
None.

newcabinet (type dm_docbase)

Purpose
Creates a new cabinet in a repository

Parameters

ownerName (Optional) Name of the user having the rights


to create a new cabinet

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_cabinet_actions.xml

Scope

type dm_docbase

Elements
None.

412 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newfolder (type dm_folder)

newfolder (type dm_folder)

Purpose
Creates a new folder. The user must have a contributor role. The permit value folder_link_permit
performs a check for write permissions on the folder when the folder security is enabled.

Parameters

objectId (Required) ID of the folder or cabinet that will


contain the new object.
ownerName (Optional) Name of the owner of the folder or
cabinet. Used by the NewObjectPrecondition
class to determine whether the action can be
performed.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_folder_actions.xml

Scope

type dm_folder

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 413
rename (type dm_folder)

rename (type dm_folder)

Purpose
Renames a folder in the repository. The user must have a role of contributor or higher and
write_permit access to the parent folder or cabinet (valid values: DELETE_PERMIT | WRITE_PERMIT
|VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT | BROWSE_PERMIT | NONE_PERMIT).

Parameters

objectId (Required) The ID of the folder to be renamed.


ownerName (Optional) User who owns the folder

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_folder_actions.xml

Scope

type dm_folder

Elements
None.

414 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
submitforcategorization (type dm_document)

Categories

submitforcategorization (type dm_document)

Purpose
Submits a document for categorization by the CI Server. The repository must have Content Intelligence
Services installed and configured.

Parameters

objectId (Required) ID of the selected object.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_document_actions.xml

Scope

type dm_document

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 415
addtoclipboard (type dm_sysobject)

Clipboard operations

addtoclipboard (type dm_sysobject)

Purpose
Adds an object to the clipboard.

Parameters

isReference (Optional) Boolean flag that indicates whether


the object is a reference object
lockOwner (Optional) User who has checked out the object
objectId (Required) ID of the object to be added to the
clipboard.
ownerName (Optional) Name of owner of the object to be
added to the clipboard
type (Optional) The content type of the object.

Description

Since
5.x

Configuration File
webcomponent\config\environment\clipboard\dm_sysobject_clipboard_actions.xml

Scope

type dm_sysobject

Elements
None.

416 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
addtoclipboard (type dmc_workqueue_category)

addtoclipboard (type dmc_workqueue_category)

Purpose
Adds a dmc_workqueue_category object to the queue management clipboard.

Parameters

objectId (Required) ID of the dmc_workqueue_category


object to add to the clipboard.
ownerName (Optional) Name of the user who owns the
dmc_workqueue_category to be added to the
clipboard.
type (Optional) Content type of the object to be added
to the clipboard

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_category_actions.xml

Scope

type dmc_workqueue_category

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 417
addtoclipboard (type dmc_workqueue)

addtoclipboard (type dmc_workqueue)

Purpose
Adds a dmc_workqueue object to the clipboard.

Parameters

objectId (Required) ID of the object to be added to the


clipboard.
ownerName (Optional) Name of the user who owns the
object.
type (Optional) Content type of the object to be added
to the clipboard.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_actions.xml

Scope

type dmc_workqueue

Elements
None.

copy (type dm_sysobject)

Purpose
Copies a clipboard object to a new location

418 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
copyhere (type dm_folder)

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\environment\clipboard\dm_sysobject_clipboard_actions.xml

Scope

type dm_sysobject

Usage
Copy behavior can be configured in the <copy_operation> element of app.xml. Set the value of the
child element <retainstorageareas> to true to retain storage areas.
The abstract clipboard class ignores auxiliary files for the linked or copied object if they are not in the
clipboard. The link or copy operation proceeds without the auxiliary files. Whether a linked file is
auxiliary can be determined by calling isAuxiliaryObject(objectId).

Elements
None.

copyhere (type dm_folder)

Purpose
Copies a clipboard object to the target folder.

Parameters

objectId (Required) Object ID of the target folder to which


the clipboard contents are to be copied.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 419
link (type dm_sysobject)

Description
Since
6.0

Configuration File
webcomponent\config\actions\dm_folder_actions.xml

Scope

type dm_folder

Elements
None.

link (type dm_sysobject)

Purpose
Links a clipboard object to a new location

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\environment\clipboard\dm_sysobject_clipboard_actions.xml

Scope

type dm_sysobject

420 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
linkhere (type dm_folder)

Elements
None.

linkhere (type dm_folder)

Purpose
Links a clipboard object to the target folder.

Parameters

objectId (Required) Object ID of the target folder to which


the clipboard contents are to be linked.

Description

Since
6.0

Configuration File
webcomponent\config\actions\dm_folder_actions.xml

Scope

type dm_folder

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 421
move (type dm_sysobject)

move (type dm_sysobject)

Purpose
Moves a clipboard object to a new location

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\environment\clipboard\dm_sysobject_clipboard_actions.xml

Scope

type dm_sysobject

Usage
The move operation can be globally configured as the value of <move_operations>.<all_versions> in
app.xml to move the selected version (false) or to move all versions of the selected object (true). With
the value of true, if the object has versions linked to other folders, only the versions linked to the folder
containing the current version will be moved. When a virtual document is selected and move, only the
root document is moved with all its versions, not the descendants.

Elements
None.

422 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
movehere (type dm_folder)

movehere (type dm_folder)

Purpose
Moves a clipboard object to the target folder.

Parameters

objectId (Required) Object ID of the target folder to which


the clipboard contents are to be moved.

Description
Since
6.0

Configuration File
webcomponent\config\actions\dm_folder_actions.xml

Scope

type dm_folder

Elements
None.

viewclipboard

Purpose
Displays the clipboard

Parameters
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 423
accessiblefolderbrowser (entitlement collaboration6, role dce_user_manager)

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
None.

Collaboration

accessiblefolderbrowser (entitlement collaboration6,


role dce_user_manager)

Purpose
Enables a Documentum Collaborative Services manager to locate dm_user objects.

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) Type of the selected object.
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected.

424 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (entitlement collaboration, type dmc_notepage)

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

entitlement collaboration6
role dce_user_manager

Elements
None.

delete (entitlement collaboration, type


dmc_notepage)

Purpose
Deletes a dmc_notepage object. Requires a Documentum Collaborative Services license.

Parameters

folderId (Optional) ID of the folder in which the


dmc_notepage object to delete resides.
lockOwner (Optional) Lock owner of the dmc_notepage
object to delete.
objectId (Required) Object ID of the dmc_notepage object
to delete.
ownerName (Optional) Owner name of the dmc_notepage
object to delete.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 425
delete (type dmc_datatable)

Description
Since
5.x

Configuration File
webcomponent\config\library\notepage\dmc_notepage_actions.xml

Scope

entitlement collaboration
type dmc_notepage

Elements
None.

delete (type dmc_datatable)

Purpose
Deletes a dmc_datatable object. Requires a Documentum Collaborative Services license.

drlview (entitlement collaboration, type


dmc_notepage)

Purpose
Navigates to the parent folder or object of the DRL and opens the dmc_notepage object for viewing.
Requires a Records Manager license.

426 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
drlview (type dmc_datatable_row)

Parameters

objectId (Required) Object ID of the dmc_notepage object


to be opened.

Description
Since
5.x

Configuration File
webcomponent\config\library\notepage\dmc_notepage_actions.xml

Scope

entitlement collaboration
type dmc_notepage

Elements
None.

drlview (type dmc_datatable_row)

Purpose
Navigates to the parent folder or object of the DRL and opens the dmc_datatable_row object for
viewing. Requires a Documentum Collaborative Services license.

Parameters
The parameters are inherited from view:webcomponent/config/actions/dm_sysobject_actions.xml. See
view (type dm_sysobject), page 500.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 427
editfile (entitlement collaboration, type dmc_notepage)

Description
Since
6.0 SP1

Configuration File
webcomponent\config\library\datatables\table_entry_actions.xml

Parent Definition
view:webcomponent/config/library/datatables/table_entry_actions.xml

Scope

entitlement collaboration
type dmc_notepage

Elements
None.

editfile (entitlement collaboration, type


dmc_notepage)

Purpose
Launches the editing application for dmc_notepage objects as recognized by the operating system
for the document extension. Requires a Records Manager license.

Parameters

objectId (Required) Object ID of the dmc_notepage object


to be opened.
ownerName (Optional) User name of owner of the
dmc_notepage object to be opened.

428 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
editfile (type dmc_calendar_event)

Description
Since
5.x

Configuration File
webcomponent\config\library\notepage\dmc_notepage_actions.xml

Scope

entitlement collaboration
type dmc_notepage

Elements
None.

editfile (type dmc_calendar_event)

Purpose
Edits dmc_calendar_event objects.

Parameters
The parameters are inherited from editfile:webcomponent/config/actions/dm_sysobject_actions.xml.
See editfile (type dm_sysobject), page 485.

Description

Since
6.0

Configuration File
webcomponent\config\library\calendars\calendar_event_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 429
editfile (type dmc_datatable_row)

Parent Definition
editfile:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dmc_calendar_event

Elements
None.

editfile (type dmc_datatable_row)

Purpose
Calls the properties (type dmc_datatable), page 1041 container component to edit dmc_datatable_row
objects.

Parameters
The parameters are inherited from editfile:webcomponent/config/actions/dm_sysobject_actions.xml.
See editfile (type dm_sysobject), page 485.

Description
Since
6.0

Configuration File
webcomponent\config\library\datatables\table_entry_actions.xml

Parent Definition
editfile:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dmc_datatable_row

430 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
editfile (type dmc_datatable)

Elements
None.

editfile (type dmc_datatable)

Purpose
Calls the properties (type dmc_datatable), page 1041 container component to edit dmc_datatable
objects.

Parameters
The parameters are inherited from editfile:webcomponent/config/actions/dm_sysobject_actions.xml.
See editfile (type dm_sysobject), page 485.

Description
Since
6.0

Configuration File
webcomponent\config\library\datatables\table_actions.xml

Parent Definition
editfile:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dmc_datatable

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 431
er_properties (Webtop)

er_properties (Webtop)

Purpose
For internal use only.

Parameters

enableShowAll (Optional) For internal use only.


er_objectId (Required) For internal use only.
newFile (Required) For internal use only.

Description
Since
5.x

Configuration File
webtop\config\eroom_properties_component.xml

Scope
All.

Elements
None.

er_search (Webtop)

Purpose
For internal use only.

432 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
folderbrowse (entitlement collaboration6, role dce_user_manager)

Parameters

component (Optional) For internal use only.

Description
Since
5.x

Configuration File
webtop\config\eroom_search_action.xml

Scope
All.

Elements
None.

folderbrowse (entitlement collaboration6, role


dce_user_manager)

Purpose
Enables a Documentum Collaborative Services manager to browse a list of folders in a repository.

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 433
folderbrowse (type dm_member_user, entitlement collaboration6)

objecttype (Optional) Type of the selected object.


selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected.

Description

Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

entitlement collaboration6
role dce_user_manager

Elements
None.

folderbrowse (type dm_member_user, entitlement


collaboration6)

Purpose
Enables browsing a list of folders in a repository. Requires Documentum Collaborative Services license.

Parameters
None.

434 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
govern (entitlement collaboration)

Description
Since
6.0

Configuration File
webcomponent\config\admin\group\dm_member_actions.xml

Scope

entitlement collaboration6
type dm_member_user

Elements
None.

govern (entitlement collaboration)

Purpose
Causes an object to become governed by a room. Requires Documentum Collaborative Services. The
object’s access is restricted to a rooms membership, and object can be governed by only one room.

Parameters

folderId (Required) ID of the governed folder that will


contain the selected object..
objectId (Required) ID of the selected object.
roomId (Required) ID of the room that will govern the
object.

Description
Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 435
governfolder (entitlement collaboration)

Configuration File
webcomponent\config\library\rooms\room_actions.xml

Scope

entitlement collaboration

Elements
None.

governfolder (entitlement collaboration)

Purpose
Launches the govern component to govern a folder. The UI asks the user to specify whether child
objects should also become governed. Requires Documentum Collaborative Services.

Parameters

folderId (Required) ID of the governed folder that will


contain the new governed folder.
objectId (Required) ID of the selected object.
ownerName (Optional) Name of the folder owner
roomId (Required) ID of the room that will govern the
folder
sourceFolderId (Optional) ID of the folder that will be added to
the governed folder or room

Description
Since
5.x

436 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
groupbrowse (type dm_member_user, entitlement collaboration6)

Configuration File
webcomponent\config\library\rooms\room_actions.xml

Scope

entitlement collaboration

Elements
None.

groupbrowse (type dm_member_user, entitlement


collaboration6)

Purpose
Allows the administrator to browse a list of groups for dm_member_user objects in a repository.
Requires a Documentum Collaborative Services license.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\dm_member_actions.xml

Scope

entitlement collaboration6
type dm_member_user

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 437
import (type dmc_datatable)

Elements
None.

import (type dmc_datatable)

Purpose
Imports dmc_datatable objects from the client file system to the repository.

Parameters

objectId (Required) ID of the target folder into which to


import the object.

Description

Since
6.0

Configuration File
webcomponent\config\library\datatables\table_actions.xml

Scope

type dmc_datatable

Elements
None.

438 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
markread (entitlement collaboration, type dm_sysobject)

markread (entitlement collaboration, type


dm_sysobject)

Purpose
Marks a topic as having been read. Requires Documentum Collaborative Services.

Parameters

objectId (Required) ID of the topic to mark as read.


topicStatus (Optional) Valid values of TopicStatusAttribute‑
DataHandler: 0 (STATUS_DISABLED) | 1 (STA‑
TUS_NONE) | 2 (STATUS_NO_COMMENTS) |
3 (STATUS_READ) | 4 (STATUS_UNREAD)

Description

Since
5.x

Configuration File
webcomponent\config\library\discussion\topic_actions.xml

Scope

entitlement collaboration
type dm_sysobject

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 439
markunread (entitlement collaboration, type dm_sysobject)

markunread (entitlement collaboration, type


dm_sysobject)

Purpose
Marks a selected topic as unread. Requires Documentum Collaborative Services.

Parameters

objectId (Required) ID of the topic to mark as unread.


topicStatus (Optional) Valid values of TopicStatusAttribute‑
DataHandler: 0 (STATUS_DISABLED) | 1 (STA‑
TUS_NONE) | 2 (STATUS_NO_COMMENTS) |
3 (STATUS_READ) | 4 (STATUS_UNREAD)

Description

Since
5.x

Configuration File
webcomponent\config\library\discussion\topic_actions.xml

Scope

entitlement collaboration
type dm_sysobject

Elements
None.

440 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
nativeroombrowse (type dm_group)

nativeroombrowse (type dm_group)

Purpose
Calls the nativeroomobjectlocatorcontainer, page 1020 to browse a room.

Parameters

objectId (Optional) Object ID of the room to browse.

Description
Since
6.0

Configuration File
webcomponent\config\admin\group\dm_group_actions.xml

Scope

type dm_group

Elements
None.

newcalendar (type dm_folder, entitlement


collaboration6)

Purpose
Creates a new calendar, which is a dm_folder object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 441
newcalendarevent (type dmc_calendar)

Parameters

objectId (Required) ID of a dm_folder object.


ownerName (Optional) User name of the owner of the object.

Description

Since
6.0

Configuration File
webcomponent\config\library\calendars\calendar_actions.xml

Scope

type dm_folder
entitlement collaboration6

Elements
None.

newcalendarevent (type dmc_calendar)

Purpose
Creates a new calendar event object (dmc_calendar).

Parameters

objectId (Required) ID of the dmc_calendar object to


create.
ownerName (Optional) User name of the owner of the
dmc_calendar object.

442 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newinvitewindow (entitlement collaboration6)

Description
Since
6.0

Configuration File
webcomponent\config\library\calendars\calendar_actions.xml

Scope

type dmc_calendar

Elements
None.

newinvitewindow (entitlement collaboration6)

Purpose
Calls the newinvitewindow (entitlement collaboration), page 1024 component to send an invitation
to selected room members.

Parameters

objectId (Required) ID of the dmc_room object for which


to send an invitation.

Description

Since
6.0

Configuration File
webcomponent\config\library\rooms\room_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 443
newnotepage (entitlement collaboration, type dm_folder)

Scope

entitlement collaboration6

Elements
None.

newnotepage (entitlement collaboration, type


dm_folder)

Purpose
Creates a new note object. A note is a content file that can be displayed directly in the browser.
Requires Documentum Collaborative Services.

Parameters

objectId (Required) ID of the folder or cabinet that will


contain the new object.
ownerName (Optional) Name of the owner of the folder or
cabinet. Used by the NewObjectPrecondition
class to determine whether the action can be
performed.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_folder_actions.xml

444 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newroom (entitlement collaboration, privilege creategroup, type dm_folder)

Scope

entitlement collaboration
type dm_folder

Elements
None.

newroom (entitlement collaboration, privilege


creategroup, type dm_folder)

Purpose
Creates a new room object (subtype of dm_folder). Requires Documentum Collaborative Services

Parameters

objectId (Required) ID of the cabinet in which to create


a room.
ownerName (Optional) Name of the object owner

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\room_actions.xml

Scope

entitlement collaboration
privilege creategroup
type dm_folder

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 445
newtable (type dm_folder, entitlement collaboration6)

Elements
None.

newtable (type dm_folder, entitlement collaboration6)

Purpose
Calls the newtable, page 1031 component to create a new dmc_datatable object. Requires Documentum
Collaborative Services.

Parameters

objectId (Required) ID of the dm_folder object in which


to create the dmc_datatable object.
ownerName (Optional) User name of the owner of the new
dmc_datatable object.

Description
Since
6.0

Configuration File
webcomponent\config\library\datatables\table_actions.xml

Scope

type dm_folder
entitlement collaboration6

Elements
None.

446 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newtableentry (type dmc_datatable)

newtableentry (type dmc_datatable)

Purpose
Calls the newtableentry, page 1033 component to create a new entry in a dmc_datatable object.
Requires Documentum Collaborative Services.

Parameters

objectId (Required) ID of the dmc_datatable object in


which to create the new entry.
ownerName (Optional) User name of the owner of the
dmc_datatable object in which to create the new
entry.

Description

Since
6.0

Configuration File
webcomponent\config\library\datatables\table_actions.xml

Scope

type dmc_datatable

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 447
newuser (entitlement collaboration6, privilege sysadmin, type dm_user)

newuser (entitlement collaboration6, privilege


sysadmin, type dm_user)

Purpose
Enables administrators to create users (dm_user objects). Requires a Documentum Collaborative
Services license.

Parameters

objectId (Required) ID of the selected user. Set to


newobject to create a new user.
objectname (Required) Name of the user.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

entitlement collaboration6

Since 6.0.

privilege sysadmin
type dm_user

Elements
None.

448 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newuser (entitlement collaboration6, role dce_user_manager, type dm_user)

newuser (entitlement collaboration6, role


dce_user_manager, type dm_user)

Purpose
Enables a Documentum Collaborative Services manager to create a new user (dm_user object).
Requires Documentum Collaborative Services license.

Parameters

objectId (Required) ID of the selected user.


objectname (Required) Name of the user.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

entitlement collaboration6

Since 6.0.

role dce_user_manager
type dm_user

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 449
options (type dmc_room)

options (type dmc_room)

Purpose
Launches the roomoptions component with room options such as setting a banner and default
permissions

Parameters

objectId (Required) Room ID

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\room_actions.xml

Scope

type dmc_room

Elements
failoverenabled
See failoverenabled, page 381.

properties (entitlement collaboration, type


dm_folder)

Purpose
Displays the message archive properties of an object (dm_sysobject).

450 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
properties (entitlement collaboration6, type dm_user)

Since
6.5

properties (entitlement collaboration6, type dm_user)

Purpose
Displays the properties of a user (dm_user object).

Parameters

objectId (Required) ID of the selected user.


objectname (Required) Name of the user.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

entitlement collaboration6

Since 6.0.

type dm_user

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 451
properties (type dmc_rm_formal_record, dmc_rm_formal_rec_folder, dmc_rm_formal_rec_cabinet)

properties (type dmc_rm_formal_record, dmc_rm_


formal_rec_folder, dmc_rm_formal_rec_cabinet)

Purpose
Displays the properties of a dmc_rm_formal_record, dmc_rm_formal_rec_folder,
dmc_rm_formal_rec_cabinet object.

Since
6.5

roommembers (type dmc_room)

Purpose
Displays the members of a room. Requires Documentum Collaborative Services.

Parameters

enableShowAll (Optional) Not used


objectId (Required) ID of the room

Description

Since
5.x

Configuration File
webcomponent\config\library\rooms\room_actions.xml

Scope

type dmc_room

452 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
showtopic (entitlement collaboration, type dm_sysobject)

Elements
None.

showtopic (entitlement collaboration, type


dm_sysobject)

Purpose
Displays a discussion with threaded topics. Requires Documentum Collaborative Services.

Parameters

folderId (Optional) ID of folder containing a discussion


folderPath (Optional) Path to folder containing a discussion
objectId (Required) ID of the discussion.
topicStatus (Optional) Valid values of TopicStatusAttribute‑
DataHandler: 0 (STATUS_DISABLED) | 1 (STA‑
TUS_NONE) | 2 (STATUS_NO_COMMENTS) |
3 (STATUS_READ) | 4 (STATUS_UNREAD)
type (Optional) Not used

Description

Since
5.x

Configuration File
webcomponent\config\library\discussion\topic_actions.xml

Scope

entitlement collaboration
type dm_sysobject

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 453
showtopicaction (entitlement collaboration, type dm_sysobject)

Elements
None.

showtopicaction (entitlement collaboration, type


dm_sysobject)

Purpose
Displays a topic. Requires Documentum Collaborative Services.

Parameters

folderId (Optional) ID of the current folder


objectId (Required) ID of the topic’s parent
topicStatus (Optional) Valid values of TopicStatusAttribute‑
DataHandler: 0 (STATUS_DISABLED) | 1 (STA‑
TUS_NONE) | 2 (STATUS_NO_COMMENTS) |
3 (STATUS_READ) | 4 (STATUS_UNREAD)
type (Optional) Object type of the selected object

Description
Since
5.x

Configuration File
webcomponent\config\library\discussion\topic_actions.xml

Scope

entitlement collaboration
type dm_sysobject

454 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
showtopicaction (entitlement collaboration, type dm_sysobject) (Webtop)

Elements
None.

showtopicaction (entitlement collaboration, type


dm_sysobject) (Webtop)

Purpose
Calls the WDK showtopic action to launch the showtopic component, which displays a topic.

Parameters

folderId (Optional) ID of the folder containing the note.


objectId (Required) ID of the topic.
topicStatus (Optional) Integer that denotes status of topic
(set by topicstatus control): 0 = disabled | 1 =
none | 2 = read | 3 = unread
type (Optional) Subtype of dm_sysobject. Must
be dmc_notepage or a subtype in order to be
viewed.

Description
Since
5.x

Configuration File
webtop\config\dm_sysobject_actions.xml

Scope

entitlement collaboration
type dm_sysobject

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 455
tablefields (type dmc_datatable)

Elements
None.

tablefields (type dmc_datatable)

Purpose
Displays the datatable fields. Calls the tablefields, page 1057 component.

Parameters

objectId (Required) Object ID of the dmc_datatable_row


object.

Description

Since
6.0 SP1

Configuration File
webcomponent\config\library\datatables\table_actions.xml

Scope

type dmc_datatable_row

Elements
None.

456 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
ungovern (entitlement collaboration)

ungovern (entitlement collaboration)

Purpose
Causes an object to become ungoverned by a room. Requires Documentum Collaborative Services.

Parameters

objectId (Required) ID of the selected object.


roomId (Required) ID of the room that governs the object.

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\room_actions.xml

Scope

entitlement collaboration

Elements
None.

ungovernfolder (entitlement collaboration)

Purpose
Causes a folder to become ungoverned by a room. Requires Documentum Collaborative Services.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 457
view (entitlement collaboration, type dmc_notepage)

Parameters

objectId (Required) ID of the selected folder.


ownerName (Optional) User who owns the selected folder.
roomId (Required) ID of the room that currently governs
the folder.

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\room_actions.xml

Scope

entitlement collaboration

Elements
None.

view (entitlement collaboration, type dmc_notepage)

Purpose
Displays a note object. A note is a content file that can be displayed directly in the browser. Requires
Documentum Collaborative Services.

458 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
view (type dmc_calendar_event)

Parameters

folderPath (Optional) Path to the folder in which the


dmc_notepage object resides.
objectId (Required) Object ID of the dmc_notepage object
to view.

Description
Since
5.x

Configuration File
webcomponent\config\library\notepage\dmc_notepage_actions.xml

Scope

entitlement collaboration
type dmc_notepage

Elements
None.

view (type dmc_calendar_event)

Purpose
Calls the attributes (type dmc_calendar_event), page 983 component.

Parameters
The parameters are inherited from editfile:webcomponent/config/actions/dm_sysobject_actions.xml.
See editfile (type dm_sysobject), page 485.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 459
view (type dmc_datatable_row)

Description
Since
6.0

Configuration File
webcomponent\config\library\calendars\calendar_event_actions.xml

Parent Definition
editfile:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dmc_calendar_event

Elements
None.

view (type dmc_datatable_row)

Purpose
Calls the properties (type dmc_datatable), page 1041 container component.

Parameters
The parameters are inherited from view:webcomponent/config/actions/dm_sysobject_actions.xml. See
view (type dm_sysobject), page 500.

Description
Since
6.0

Configuration File
webcomponent\config\library\datatables\table_entry_actions.xml

460 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newdocument (type dm_folder)

Parent Definition
view:webcomponent/config/actions/dm_sysobject_actions.xml
Since 6.0 SP1.

Scope

type dmc_datatable_row

Elements
None.

Creating objects

newdocument (type dm_folder)

Purpose
Creates a document within a folder. The user must have a contributor role. The permit value
folder_link_permit performs a check for write permissions on the folder when folder security is
enabled.

Parameters

contentType (Optional) Document format


editAfterCreate (Optional) Specifies whether the document can
be edited after creation
objectId (Required) ID of the folder or cabinet that will
contain the new object.
ownerName (Optional) Name of the owner of the folder or
cabinet. Used by the NewObjectPrecondition
class to determine whether the action can be
performed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 461
exporttocsv

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_folder_actions.xml

Scope

type dm_folder

Elements
None.

Data export

exporttocsv

Purpose
Calls the exporttocsv, page 1064 component to export a datagrid to a comma‑separated value file.

Parameters
None.

Description

Since
6.0

Configuration File
webcomponent\config\actions\generic_actions.xml

462 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
auditimagingaction

Scope
All.

Elements
None.

Document Imaging Services

auditimagingaction

Purpose
For internal use only.

Parameters

activity (Optional) For internal use only.


description (Optional) For internal use only.
objectId (Required) For internal use only.
printername (Optional) For internal use only.

Description

Since
6.0

Configuration File
webcomponent\config\actions\imaging_actions.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 463
saveannotation (type dm_document)

Elements
None.

saveannotation (type dm_document)

Purpose
For internal use only.

Parameters

objectId (Required) For internal use only.

Description

Since
5.x

Configuration File
webcomponent\config\actions\imaging_actions.xml

Scope

type dm_document

Elements
None.

464 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
cancelcheckout (type dm_sysobject)

Downloading and uploading content

cancelcheckout (type dm_sysobject)

Purpose
Cancels the checked out status of an object. The user must have version level permission (valid values:
DELETE_PERMIT | WRITE_PERMIT | VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT |
BROWSE_PERMIT | NONE_PERMIT).

Parameters

isReference (Optional) Boolean flag that indicates whether


the object is a reference object
lockOwner (Optional) User who has checked out the object
nodeId (Optional) Node ID of the object to check out,
when checking out part of a virtual document.
objectId (Required) ID of the object to be checked in.
vdmRootObjectId (Optional) Object ID of the root object of a virtual
document.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 465
checkin (type dm_sysobject)

Elements
None.

checkin (type dm_sysobject)

Purpose
Checks in the selected object. The user must have version_permit access to the object (valid values:
DELETE_PERMIT | WRITE_PERMIT|VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT |
BROWSE_PERMIT | NONE_PERMIT). The user must be assigned to a contributor role defined
in the repository.

Parameters

filenamewithpath (Optional) Name and path of the file to be


checked in.
isReference (Optional) Boolean flag that indicates whether
the object is a reference object
keepLocalFile (Optional) Whether to keep the local file on the
machine (True) or not (False).Since 6.0.
lockOwner (Optional) User who has checked out the object
nodeId (Optional) ID of the repository node
objectId (Required) ID of the object to be checked in.
ownerName (Optional) User who owns the checked in object
retainLock (Optional) Boolean: Whether to keep the lock on
the object (True) or not (False).Since 6.0.
silent (Optional) Boolean: Whether to check in the
object without displaying the checkin or checkin
from dialog box (True) or not (False). If you
specify true for this parameter, you must specify
a valid value for the version parameter.Since 6.0.

466 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
checkout (type dm_sysobject)

vdmRootObjectId (Optional) Object ID of the root for a virtual


document, when checking in a virtual document
version (Optional) Whether to check in the object as a
major, minor, branched, or the same version
when true is specified for the silent parameter.
Valid values are: major, minor, branch, same. If
this parameter is not specified, then the checkin
dialog box is displayed even when true is
specified for the silent parameter.Since 6.0.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

checkout (type dm_sysobject)

Purpose
Checks out the selected object. The user must have version level permission (valid values:
DELETE_PERMIT | WRITE_PERMIT |VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT |
BROWSE_PERMIT | NONE_PERMIT).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 467
checkout (type dm_sysobject)

Parameters

compoundArchitecture (Optional)
isIgnoreDescendents (Optional) Boolean value that indicates whether
or not to check out descendants in a virtual
document.
isLockOnly (Optional) Boolean flag that indicates whether
the object should be locked but not copied to the
checkout location
isReference (Optional) Boolean flag that indicates whether
the object is a reference object
lockOwner (Optional) User who has checked out the object
nodeId (Optional) Node ID of the object to check out,
when checking out part of a virtual document.
objectId (Required) ID of the object to be checked out.
ownerName (Optional) User who owns the checked in object
vdmRootObjectId (Optional) Object ID of the root of a virtual
document.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

468 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (privilege sysadmin, type dm_user)

delete (privilege sysadmin, type dm_user)

Purpose
Deletes a user from the repository.

Parameters

objectId (Required) ID of the selected user.


objectname (Required) Name of the user.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

privilege sysadmin
type dm_user

Elements
None.

delete (type dm_folder)

Purpose
Deletes one or more folder objects. The user must have a role of contributor.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 469
delete (type dm_group)

Parameters

folderId (Optional) The ID of the folder in which the


object is located
objectId (Required) The ID of the object to be deleted.
ownerName (Optional) The name of the user who owns the
object to be deleted

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_folder_actions.xml

Scope

type dm_folder

Elements
None.

delete (type dm_group)

Purpose
Deletes a group from the repository.

Parameters

objectId (Required) The ID of the object to be deleted.


objectname (Required) Name of the group.

470 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (type dm_notification)

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\dm_group_actions.xml

Scope

type dm_group

Elements
None.

delete (type dm_notification)

Purpose
Deletes a notification.

Parameters

objectId (Required) The ID of the object to be deleted.


objectName (Optional) The name of the notification object

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_notification_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 471
delete (type dm_sysobject)

Scope

type dm_notification

Elements
None.

delete (type dm_sysobject)

Purpose
Deletes one or more objects. The user must have a role of contributor. In addition, the user
must have the DELETE_PERMIT access (valid values: DELETE_PERMIT | WRITE_PERMIT |
VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT | BROWSE_PERMIT | NONE_PERMIT).

Parameters

folderId (Optional) The ID of the folder in which the


object is located
lockOwner (Optional) User who has checked out the object
objectId (Required) The ID of the object to be deleted.
ownerName (Optional) The name of the user who owns the
object to be deleted

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

472 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (type dmc_comment)

Elements
None.

delete (type dmc_comment)

Purpose
Deletes one or more comment objects. The user must have a role of contributor.

Parameters

objectId (Required) ID of the selected object.


ownerName (Optional) Name of the user who owns the object
to be deleted

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_comment_actions.xml

Scope

type dmc_comment

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 473
delete (type dmr_content)

delete (type dmr_content)

Purpose
Deletes the selected rendition. The user must have write permission on the base object.If the selected
object is a replica, it cannot be deleted.

Parameters

contentType (Required) Type of the selected rendition.


objectId (Required) The ID of the object to be deleted.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmr_content_actions.xml

Scope

type dmr_content

Elements
None.

delete (type job_request)

Purpose
Deletes a job request from the repository.

474 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
downloadcontent (type dm_sysobject)

Parameters

objectId (Required) The ID of the object to be deleted.

Description
Since
5.x

Configuration File
webcomponent\config\admin\renamelog\renamelog_actions.xml

Scope

type job_request

Elements
None.

downloadcontent (type dm_sysobject)

Purpose
Downloads the selected object to the disk.

Parameters

contentSize (Optional) Size of the object in bytes


contentType (Optional) File format to use when opening the
object (passed to the operating system)
isIgnoreDescendents (Optional) Boolean value that indicates whether
or not to download descendants in a virtual
document.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 475
drledit (type dm_sysobject)

isReference (Optional) Boolean flag that indicates whether


the object is a reference object
nodeId (Optional) Node ID of the object to download,
when checking out part of a virtual document.
objectId (Required) ID of the object to be viewed.
type (Optional) Object type
vdmRootObjectId (Optional) Object ID of the root of a virtual
document (when operating on a child node).

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

drledit (type dm_sysobject)

Purpose
Extends the action editfile (type dm_sysobject), page 485 and opens a DRL for editing. This action is
not defined for folders.

Parameters
The parameters are inherited from editfile:webcomponent/config/actions/dm_sysobject_actions.xml.
See editfile (type dm_sysobject), page 485.

476 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
drledit (type dm_sysobject) (Webtop)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Parent Definition
editfile:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

drledit (type dm_sysobject) (Webtop)

Purpose
Navigates to myfiles component and performs editfile action on the object referenced by the DRL
(document resource locator).

Parameters

navigateOnComplete (Optional) Boolean: By default (true), navigates


to the main component after the edit action.
When this value is set to false, the component
does not navigate to the main component after
the edit action.
objectId (Required) ID of the object to open for editing.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 477
drledit (type search_template)

Description
Since
5.x

Configuration File
webtop\config\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

drledit (type search_template)

Purpose
Uses a DRL to open a search template for editing.

Parameters
The parameters are inherited from edittemplate:webcomponent/config/actions/dmc_search_template_
actions.xml. See .

Description
Since
6.0

Configuration File
webcomponent\config\actions\dmc_search_template_actions.xml

Parent Definition
edittemplate:webcomponent/config/actions/dmc_search_template_actions.xml

478 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
drlview (type dm_folder) (Webtop)

Scope

type search_template

Elements
None.

drlview (type dm_folder) (Webtop)

Purpose
Navigates to the parent folder or object and performs the view action on the object referenced by the
DRL. This action is scoped to dm_sysobject, dm_folder, and dmi_queue_item.

Parameters

contentType (Optional) File format to use when opening the


object (passed to the operating system).
objectId (Required) ID of the object to be viewed.

Description
Since
5.x

Configuration File
webtop\config\dm_folder_actions.xml

Scope

type dm_folder

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 479
drlview (type dm_message_archive) (Webtop)

drlview (type dm_message_archive) (Webtop)

Purpose
Opens a DRL to a dm_message_archive object for viewing.

Parameters

folderPath (Optional) Path to the folder in which the


dm_message_archive object resides.
objectId (Required) ID of the dm_message_archive object
to be viewed.

Description
Since
6.0

Configuration File
webtop\config\dm_message_archive_action.xml

Scope

type dm_message_archive

Elements
None.

drlview (type dm_sysobject)

Purpose
Opens a DRL for viewing.

480 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
drlview (type dm_sysobject) (Webtop)

Parameters
The parameters are inherited from view:webcomponent/config/actions/dm_sysobject_actions.xml. See
view (type dm_sysobject), page 500.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Parent Definition
view:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

drlview (type dm_sysobject) (Webtop)

Purpose
Navigates to the parent folder or object and performs the view action on the object referenced by the
DRL. This action is scoped to dm_sysobject, dm_folder, and dmi_queue_item.

Parameters

assembledFromId (Optional) ID of the virtual document from


which the assembly was created.
contentType (Optional) File format to use when opening the
object (passed to the operating system).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 481
drlview (type dmi_queue_item) (Webtop)

isVirtualDoc (Optional) Boolean: Whether the object is a


virtual document (True) or not (False)
navigateOnComplete (Optional) Boolean: By default (true), navigates
to the main component after the view action.
When this value is set to false, the component
does not navigate to the main component after
the edit action.
objectId (Required) ID of the dm_message_archive object
to be viewed.

Description
Since
5.x

Configuration File
webtop\config\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

drlview (type dmi_queue_item) (Webtop)

Purpose
Navigates to the parent folder or object and performs the view action on the object referenced by the
DRL. This action is scoped to dm_sysobject, dm_folder, and dmi_queue_item.

482 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
drlview (type search_template)

Parameters

contentType (Optional) File format to use when opening the


dmi_queue_item object (passed to the operating
system).
objectId (Required) ID of the dmi_queue_item object to
view.

Description
Since
5.x

Configuration File
webtop\config\dmi_queue_item_actions.xml

Scope

type dmi_queue_item

Elements
None.

drlview (type search_template)

Purpose
Navigates to the parent folder or object and performs the view action on the search template object
referenced by the DRL.

Parameters
The parameters are inherited from runsearchtemplate:webcomponent/config/actions/dmc_search_
template_actions.xml. See .

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 483
editafternew (type dm_sysobject)

Description
Since
6.0

Configuration File
webcomponent\config\actions\dmc_search_template_actions.xml

Parent Definition
view:webcomponent/config/actions/dmc_search_template_actions.xml

Scope

type search_template

Elements
None.

editafternew (type dm_sysobject)

Purpose
Launches the editing application, as recognized by the operating system for the document extension,
when a new object is created. The user must have a contributor role.

Parameters
The parameters are inherited from editfile:webcomponent/config/actions/dm_sysobject_actions.xml.
See editfile (type dm_sysobject), page 485.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

484 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
editfile (type dm_sysobject)

Parent Definition
editfile:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

editfile (type dm_sysobject)

Purpose
Launches the editing application, as recognized by the operating system for the document extension.
The user must have version level permission (valid values: DELETE_PERMIT | WRITE_PERMIT
|VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT | BROWSE_PERMIT | NONE_PERMIT).
The user must also have a contributor role.

Parameters

contentSize (Optional) Size of the object in bytes


contentType (Optional) File format to use when opening the
object (passed to the operating system)
isReference (Optional) Boolean flag that indicates whether
the object is a reference object
lockOwner (Optional) User who has checked out the object
(dm_query only)
nodeId (Optional) Node ID of the object to open, when
opening part of a virtual document.
objectId (Required) ID of the object to be viewed. (This is
the only parameter defined for templates.)
ownerName (Optional) Name of the user who owns the object

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 485
export (type dm_message_archive)

skipVersionCheck (Optional) Boolean: Whether to prompt the user


to choose the current version of an object when
the object is not the current version (False) or not
(True). Default is false.
type (Optional) Object type
vdmRootObjectId (Optional) Object ID of the root of a virtual
document.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

export (type dm_message_archive)

Purpose
Exports a dm_message_archive object to the local filesystem.

Since
6.5

486 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
export (type dm_sysobject)

export (type dm_sysobject)

Purpose
Exports the object to the local file system.

Parameters

contentSize (Optional) Size of the object in bytes


contentType (Optional) File format of the object (passed to the
operating system)
isReference (Optional) Boolean flag that indicates whether
the object is a reference object
nodeId (Optional) Node ID of the object to export, when
exporting part of a virtual document.
objectId (Required) ID of the object to be exported.
vdmRootObjectId (Optional) Object ID of the root of a virtual
document.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 487
exportrendition (type dmr_content)

exportrendition (type dmr_content)

Purpose
Exports a rendition to the local file system and launches the viewing application for the selected
rendition

Parameters

contentType (Required) File format to use when opening the


object (passed to the operating system)
objectId (Required) ID of the selected object.
pageModifier (Optional) A valid value for the page_modifier
attribute of the dmr_content object. Do not pass
in your own value for PDF renditions.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmr_content_actions.xml

Scope

type dmr_content

Elements
None.

488 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
import (type dm_folder)

import (type dm_folder)

Purpose
Launches import of an object from the local file system to the repository. The user must have a
contributor role. The permit value folder_link_permit performs a check for write permissions on
the folder when the folder security is enabled.

Parameters

baseDocbaseType (Optional) Base object type for import


docbaseType (Optional) Object type of imported object
filePath (Optional) Path to the file on the local machine
format (Optional) Format of the object to be imported
isDirectory (Optional) Boolean that indicates whether the
object being imported is a directory
objectId (Required) ID of the destination folder.
objectName (Optional) Name of object to be imported
ownerName (Optional) Name of the owner of the destination
folder.
parentPath (Optional) Repository path into which the file
is imported

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_folder_actions.xml

Scope

type dm_folder

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 489
importrendition (type dm_sysobject)

Elements
None.

importrendition (type dm_sysobject)

Purpose
Imports an HTML or PDF rendition of the selected object. The user must have version level permission
on the object. The user must have read_permit access to the object (valid values: DELETE_PERMIT |
WRITE_PERMIT |VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT | BROWSE_PERMIT |
NONE_PERMIT).

Parameters

contentType (Optional) Type of rendition to import


fileNameWithPath (Optional) Path (including the file name) of the
file to import.Since 6.0.
isReference (Optional) Boolean flag that indicates whether
the object is a reference object
lockOwner (Optional) User who has checked out the object
objectId (Required) ID of the selected object.
ownerName (Optional) Name of the user who owns the object

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

490 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
importrendition (type dmr_content)

Elements
None.

importrendition (type dmr_content)

Purpose
Imports a file to create a new rendition

Parameters

contentType (Optional) File format to use when importing the


object (passed to the operating system).
isReference (Optional) Boolean flag that specifies whether
the object is a reference
lockOwner (Optional) User who has checked out the object
objectId (Required) ID of the selected object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmr_content_actions.xml

Scope

type dmr_content

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 491
importrenditiongeneric (type dm_sysobject)

importrenditiongeneric (type dm_sysobject)

Purpose
Imports an HTML or PDF rendition of the selected object. The user must have version level permission
on the object.

Parameters

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Parent Definition
importrendition:application=’webcomponent’ type=’dm_sysobject’

Scope

type dm_sysobject

Elements
None.

importrenditiongeneric (type dmr_content)

Purpose
Imports a file to create a new rendition

492 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
messagearchiveattachviewproperties

Parameters

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmr_content_actions.xml

Parent Definition
importrendition:application=’webcomponent’ type=’dm_sysobject’

Scope

type dmr_content

Elements
None.

messagearchiveattachviewproperties

Purpose
Views the properties of dm_message_archive object attachments.

Since
6.5

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 493
view_as_html_drilldown (type dm_message_archive) (Webtop)

view_as_html_drilldown (type dm_message_archive)


(Webtop)

Purpose
Calls the drilldown (type dm_message_archive), page 1073 component to open a dm_message_archive
object for viewing as HTML.

Parameters

folderPath (Optional) Specifies the path to the folder in


which to start browsing. This path must be
a complete path from the repository root, for
example: /Documentation/Library/subfolder.
objectId (Required) ID of the dm_message_archive object.

Description

Since
6.0

Configuration File
webtop\config\dm_message_archive_action.xml

Scope

type dm_message_archive

Elements
None.

494 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
view_as_html (type dm_message_archive) (Webtop)

view_as_html (type dm_message_archive) (Webtop)

Purpose
Calls the doclist (type dm_message_archive), page 1188 component to open a dm_message_archive
object for viewing as HTML.

Parameters

folderPath (Optional) Specifies the path to the folder in


which to start browsing. This path must be
a complete path from the repository root, for
example: /Documentation/Library/subfolder.
objectId (Required) ID of the dm_message_archive object.

Description

Since
6.0

Configuration File
webtop\config\dm_message_archive_action.xml

Scope

type dm_message_archive

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 495
view_as_outlook_mail_msg (type dm_message_archive)

view_as_outlook_mail_msg (type dm_message_


archive)

Purpose
Opens a dm_message_archive object for viewing in Microsoft Outlook.

Parameters

contentSize (Optional) Size of the object in bytes


contentType (Optional) File format to use when opening the
object (passed to the operating system).
isReference (Optional) Set to true if the selected object is a
reference object.
launchViewer (Optional) Boolean flag that indicates whether to
launch a viewing application.
objectId (Required) ID of the dm_message_archive object
to view.

Description
Since
6.5

Configuration File
webcomponent\config\actions\dm_message_archive_action.xml

Scope

type dm_message_archive

Elements
None.

496 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
view (type dm_folder) (Webtop)

view (type dm_folder) (Webtop)

Purpose
Launches a viewing application.

Parameters

contentSize (Optional) Size of object to view, in bytes


contentType (Optional) File format to use when opening the
object (passed to the operating system)
isCurrentVDMNode (Optional) Boolean flag that specifies whether
the node is the root node of the current virtual
document. The menu item to remove a node is
disabled if the node is the root node.
isReference (Optional) Boolean flag that specifies whether
the object is a reference
isVirtualDoc (Optional) Set to true to specify that the object to
be viewed is a virtual document
linkCount (Optional) Number of links (child nodes) in a
document. If greater than 0, the document is a
virtual document.
lockOwner (Optional) Name of object owner
objectId (Required) ID of the selected object
type (Optional) Type of the selected object

Description
Since
5.x

Configuration File
webtop\config\dm_folder_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 497
view (type dm_message_archive)

Scope

type dm_folder

Elements
None.

view (type dm_message_archive)

Purpose
Opens a dm_message_archive object for viewing as HTML in Microsoft Outlook.

Since
6.5

view (type dm_message_archive) (Webtop)

Purpose
Calls the drilldown (type dm_message_archive), page 1073 component to open a dm_message_archive
object for viewing as HTML, the doclist (type dm_message_archive), page 1188 component
to open a dm_message_archive object for viewing as HTML, the exportviewcontainer (type
dm_message_archive), page 1131 or the httpview (Webtop), page 1157 component to open a
dm_message_archive object for viewing in Microsoft Outlook.

Parameters

assembledFromId (Optional) ID of the virtual document from


which the assembly was created.
contentSize (Optional) Size of object to view, in bytes.

498 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
view (type dm_message_archive) (Webtop)

contentType (Optional) File format to use when opening the


object (passed to the operating system).
isCurrentVDMNode (Optional) Boolean flag that specifies whether
the node is the root node of the current virtual
document. The menu item to remove a node is
disabled if the node is the root node.
isReference (Optional) Boolean flag that specifies whether
the object is a reference.
isVirtualDoc (Optional) Set to true to specify that the object to
be viewed is a virtual document.
linkCount (Optional) Number of links (child nodes) in a
document. If greater than 0, the document is a
virtual document.
lockOwner (Optional) Name of the user who has the object
locked.
objectId (Required) ID of the selected object.
type (Optional) Object type of the selected object.

Description
Since
6.0

Configuration File
webtop\config\dm_message_archive_action.xml

Scope

type dm_message_archive

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 499
view (type dm_sysobject)

view (type dm_sysobject)

Purpose
Launches the viewing application for the selected object. The user must have read_permit access to the
object (valid values: DELETE_PERMIT | WRITE_PERMIT |VERSION_PERMIT | RELATE_PERMIT |
READ_PERMIT | BROWSE_PERMIT | NONE_PERMIT).

Parameters

assembledFromId (Optional) ID of the virtual document from


which the assembly was assembled
contentSize (Optional) Size of the object in bytes
contentType (Optional) File format to use when opening the
object (passed to the operating system)
isIgnorePrefRenditions (Optional) Boolean: Whether to ignore the user’s
preference for opening renditions (True) or not
(False). Default is false. Since 5.3 SP4.
isReference (Optional) Boolean flag that indicates whether
the object is a reference object
launchViewer (Optional) Boolean flag that indicates whether to
launch a viewing application.
nodeId (Optional) Node ID of the virtual document
node to view.
objectId (Required) ID of the object to be viewed.
type (Optional) Object type
vdmRootObjectId (Optional) Object ID of the root of the virtual
document.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

500 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
view (type dm_sysobject) (Webtop)

Scope

type dm_sysobject

Elements
None.

view (type dm_sysobject) (Webtop)

Purpose
Launches a viewing application.

Parameters

assembledFromId (Optional) ID of the virtual document from


which the assembly was assembled.
contentSize (Optional) Size of object to view, in bytes.
contentType (Optional) File format to use when opening the
object (passed to the operating system).
isCurrentVDMNode (Optional) Boolean flag that specifies whether
the node is the root node of the current virtual
document. The menu item to remove a node is
disabled if the node is the root node.
isIgnorePrefRenditions (Optional) Boolean: Whether to ignore the user’s
preference for opening renditions (True) or not
(False). Default is true. Since 5.3 SP4.
isReference (Optional) Boolean flag that specifies whether
the object is a reference.
isVirtualDoc (Optional) Set to true to specify that the object to
be viewed is a virtual document.
linkCount (Optional) Number of links (child nodes) in a
document. If greater than 0, the document is a
virtual document.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 501
view (type dmr_content)

lockOwner (Optional) Name of the user who has the object


locked.
objectId (Required) ID of the selected object.
type (Optional) Object type of the selected object.

Description
Since
5.x

Configuration File
webtop\config\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

view (type dmr_content)

Purpose
Launches the viewing application for the selected rendition.

Parameters

contentType (Required) File format to use when opening the


object (passed to the operating system)
isIgnorePrefRenditions (Optional) Boolean: Whether to ignore the user’s
preference for opening renditions (True) or not
(False). Default is true.Since 5.3 SP4.

502 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
viewcontent (type dm_sysobject)

objectId (Required) ID of the object to be viewed.


pageModifier (Optional) A valid value for the page_modifier
attribute of the dmr_content object. You should
not pass in your own value for PDF renditions.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dmr_content_actions.xml

Scope

type dmr_content

Elements
None.

viewcontent (type dm_sysobject)

Purpose
Opens a virtual document for viewing. The user must have at least read permit on the virtual
document.

Parameters

contentSize (Optional) Size of the object in bytes


contentType (Optional) File format to use when opening the
object (passed to the operating system)
isReference (Optional) Boolean flag that indicates whether
the object is a reference object

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 503
sendlocator (type dm_queued)

launchViewer (Optional) Boolean flag that indicates whether to


launch a viewing application.
nodeId (Optional) Node ID of the virtual document
node to view.
objectId (Required) ID of the object to be viewed.
vdmRootObjectId (Optional) Object ID of the root of the virtual
document.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

Emailing links to objects

sendlocator (type dm_queued)

Purpose
Sends one or more object locators through email.

504 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
sendlocator (type dm_sysobject)

Parameters

objectId (Required) ID of the object to send.


type (Optional) Specifies the object type. If null, an
object fetch will determine the type.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_queued_actions.xml

Scope

type dm_queued

Elements
None.

sendlocator (type dm_sysobject)

Purpose
Sends one or more object locators through email

Parameters

objectId (Required) ID of the object to send.


type (Optional) Specifies the object type. If null, an
object fetch will determine the type.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 505
sendto (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

sendto (type dm_sysobject)

Purpose
Sends an object to a user or group

Parameters

objectId (Required) ID of the object to send.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

506 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
sendtodistributionlist (type dm_sysobject)

Elements
None.

sendtodistributionlist (type dm_sysobject)

Purpose
Sends an object to a distribution list

Parameters

objectId (Required) ID of the object to send.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 507
newformat (type dm_format)

Formats

newformat (type dm_format)

Purpose
Creates a new Documentum format

Parameters

objectId (Required) Set value to newobject to create new


format.

Description

Since
5.x

Configuration File
webcomponent\config\admin\format\dm_format_actions.xml

Scope

type dm_format

Elements
None.

508 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
properties (type dm_format)

properties (type dm_format)

Purpose
Displays the properties of a selected format.

Parameters

objectId (Required) ID of the selected object.

Description
Since
5.x

Configuration File
webcomponent\config\admin\format\dm_format_actions.xml

Scope

type dm_format

Elements
None.

General user interface

accessibilityaction

Purpose
Handles accessibility option for buttons and menu items in a component.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 509
accessibilityaction (type dm_acedm_requiredgroupdm_requiredgroupsetdm_restriction)

Parameters

accessible (Optional) Set to true to call the menubar


component in accessible mode

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
None.

accessibilityaction (type dm_acedm_


requiredgroupdm_requiredgroupsetdm_restriction)

Purpose
Not used.

Parameters

accessible (Optional) Not used.


accessorName (Required) Not used.
aceavailableactions (Optional) Not used.
basicpermit (Optional) Not used.
extpermit (Optional) Not used.

510 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
accessiblefolderbrowser (privilege sysadmin, type dm_user)

extpermit_readonly (Optional) Not used.


objectId (Optional) Not used.
objectName (Optional) Not used.
permit (Optional) Not used.
permitType (Optional) Not used.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_accessor_actions.xml

Scope

type dm_ace, dm_requiredgroup, dm_required‑


groupset, dm_restriction

Elements
None.

accessiblefolderbrowser (privilege sysadmin, type


dm_user)

Purpose
Locator for dm_user objects.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 511
abortjob

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) Type of the selected object.
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

privilege sysadmin
type dm_user

Jobs

abortjob

Purpose
Aborts an asynchronous action or component job.

512 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
showjobstatus

Parameters

jobId (Required) ID of the job to abort.

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
None.

showjobstatus

Purpose
Displays the status of running asynchronous jobs.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 513
showjobstatushistory

Scope
All.

Elements
None.

showjobstatushistory

Purpose
Displays the history of asynchronous jobs.

Parameters

jobId (Required) ID of the selected job.


jobName (Required) Name of the selected job.

Description

Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
None.

514 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
applylifecycle (type dm_sysobject)

Lifecycles

applylifecycle (type dm_sysobject)

Purpose
Attaches a lifecycle (business policy) to an object

Parameters

isReplica (Optional) Boolean indicating whether the object


is a replica; the action is invalid for replicas
lockOwner (Optional) User who has checked out the selected
object
objectId (Required) The object to which a lifecycle will
be applied.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 515
demote (type dm_sysobject)

demote (type dm_sysobject)

Purpose
Demotes an object to the previous lifecycle state.

Parameters

lockOwner (Optional) User who has checked out the object


objectId (Required) ID of the object to be demoted.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

detachlifecycle (type dm_sysobject)

Purpose
Detaches a lifecycle from the selected object.

516 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
promote (type dm_sysobject)

Parameters

lockOwner (Optional) User who has checked out the object


objectId (Required) ID of the object to be demoted.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

promote (type dm_sysobject)

Purpose
Promotes an object to the next lifecycle state.

Parameters

lockOwner (Optional) User who has checked out the object


objectId (Required) ID of the object to be promoted.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 517
restorelifecycle (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

restorelifecycle (type dm_sysobject)

Purpose
Restores an object from the suspended state to the active state (resumes previous state)

Parameters

lockOwner (Optional) User who has checked out the object


objectId (Required) The ID of the object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

518 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
suspendlifecycle (type dm_sysobject)

Scope

type dm_sysobject

Elements
None.

suspendlifecycle (type dm_sysobject)

Purpose
Suspends the lifecycle state of the selected object

Parameters

lockOwner (Optional) User who has checked out the object


objectId (Required) ID of the selected object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 519
findtarget (type dm_sysobject)

Locating objects

findtarget (type dm_sysobject)

Purpose
Allows the user to click on a reference object and navigate to the object or folder in the remote
repository

Parameters

isReference (Optional) Set to true if the selected object is a


reference object
objectId (Required) ID of the reference object.
openFolder (Optional) Set to true if the reference object is a
folder.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

520 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
findtarget (type dm_sysobject) (Webtop)

findtarget (type dm_sysobject) (Webtop)

Purpose
Allows the user to click on a reference object and navigate to the object or folder in the remote
repository.

Parameters

isReference (Optional) Set to true if the selected object is a


reference object.
objectId (Required) ID of the reference object.
openFolder (Optional) Set to true if the reference object is
a folder.

Description
Since
5.x

Configuration File
webtop\config\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 521
locations (type dm_cabinet)

locations (type dm_cabinet)

Purpose
Specifies the locations in the repository of a given object (links). This action is disabled for dm_cabinet
objects.

Parameters

objectId (Required) ID of the selected object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_cabinet_actions.xml

Scope

type dm_cabinet

Elements
None.

locations (type dm_group)

Purpose
Allows an administrator to get locations where the group owns objects, ACLS, or workflows.

522 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
locations (type dm_member_group)

Parameters

objectId (Required) ID of the selected object.


objectname (Required) Name of the group.

Description

Since
5.x

Configuration File
webcomponent\config\admin\group\dm_group_actions.xml

Scope

type dm_group

Elements
None.

locations (type dm_member_group)

Purpose
Specifies the locations in the repository of a given object (links).

Parameters

objectId (Required) ID of the selected object.


objectname (Required) The name of the selected object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 523
locations (type dm_member_user)

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\dm_member_actions.xml

Scope

type dm_member_group

Elements
None.

locations (type dm_member_user)

Purpose
Specifies the locations in the repository of a given object (links).

Parameters

objectname (Required) The name of the selected object.

Description

Since
5.x

Configuration File
webcomponent\config\admin\group\dm_member_actions.xml

Scope

type dm_member_user

524 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
locations (type dm_sysobject)

Elements
None.

locations (type dm_sysobject)

Purpose
Specifies the locations in the repository of a given object (links).

Parameters

folderId (Optional) ID of the folder that contains the


selected object.
folderPath (Optional) Path to the folder that contains the
selected object. This path must be a complete
path from the repository root, for example,
/Documentation/Library/subfolder
objectId (Required) ID of the selected object.
objectNamePrefix (Optional)

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 525
locations (type dm_user)

Elements
failoverenabled
See failoverenabled, page 381.

locations (type dm_user)

Purpose
Allows the administrator to view all of the groups, ACLs, alias sets, objects, and workflows that
the specified user owns or belongs to.

Parameters

objectname (Required) The name of the selected user

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

type dm_user

Elements
None.

526 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
rendition_transformation (type dmr_content)

Media and transformation

rendition_transformation (type dmr_content)

Purpose
Requires Media Transformation Services. Customization not supported.

Parameters

contentType (Optional) File format to use when transforming


the object (passed to the operating system)
folderId (Optional) ID of the folder from which the action
was called
objectId (Required) ID of the selected object.
ownerName (Optional) Name of the object owner
transformableToRendition (Optional) The valid rendition to which the
object can be transformed

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmr_content_actions.xml

Scope

type dmr_content

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 527
transformation (type dm_sysobject)

transformation (type dm_sysobject)

Purpose
Requires Media Transformation Services. Customization not supported.

Parameters

contentType (Optional) Customization not supported.


folderId (Optional) Customization not supported.
objectId (Required) Customization not supported.
ownerName (Optional) Customization not supported.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

transformationtonewrelation (type dm_sysobject)

Purpose
Requires Media Transformation Services. Customization not supported.

528 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
transformationtonewrelation (type dmr_content)

Parameters

contentType (Optional) Customization not supported.


folderId (Optional) Customization not supported.
objectId (Required) Customization not supported.
ownerName (Optional) Customization not supported.
transformableToRendition (Optional) Customization not supported.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

transformationtonewrelation (type dmr_content)

Purpose
Requires Media Transformation Services. Customization not supported.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 529
transformationtonewrendition (type dm_sysobject)

Parameters

contentType (Optional) File format to use when opening the


object (passed to the operating system)
folderId (Optional) ID of the folder from which the action
was called
objectId (Required) ID of the selected object.
ownerName (Optional) Name of the object owner
transformableToRendition (Optional) Not used

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmr_content_actions.xml

Scope

type dmr_content

Elements
None.

transformationtonewrendition (type dm_sysobject)

Purpose
Requires Media Transformation Services. Customization not supported.

530 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
transformationtonewrendition (type dmr_content)

Parameters

contentType (Optional) Customization not supported.


folderId (Optional) Customization not supported.
objectId (Required) Customization not supported.
ownerName (Optional) Customization not supported.
transformableToRendition (Optional) Customization not supported.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

transformationtonewrendition (type dmr_content)

Purpose
Transforms the object to the selected rendition. Requires Media Transformation Services.
Customization not supported.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 531
addtobrowserfavorites

Parameters

contentType (Optional) File format to use when transforming


the object (passed to the operating system)
folderId (Optional) ID of the folder from which the action
was called
objectId (Required) ID of the selected object.
ownerName (Optional) Name of the object owner
transformableToRendition (Optional) The valid rendition to which the
object can be transformed

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmr_content_actions.xml

Scope

type dmr_content

Elements
None.

Navigational aids

addtobrowserfavorites

Purpose
Generates a bookmark to a DRL for a selected object.

532 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
JumpToBrowserTreeLocationAction (Webtop)

Parameters

objectId (Required) Object ID of the selected object.


type (Optional) Type of the selected object.

Description

Since
6.0

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Usage
Returns the object name and DRL for each object.

Elements
None.

JumpToBrowserTreeLocationAction (Webtop)

Purpose
Makes a specific node in the browser tree control the current node.

Since
6.5

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 533
registerevents (type dm_sysobject)

Notifications

registerevents (type dm_sysobject)

Purpose
Registers for notification when certain events occur on an object. Replica and reference objects
cannot be registered.

Parameters

events (Optional) List of the specific events for which


to register.
notificationStatus (Optional) (Boolean) True, if the current user is
registered for events on the selected object; False,
if not.Since 6.0.
objectId (Required) Object ID of the object whose events
should be registered for notification

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

534 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
registerreadevent (type dm_sysobject)

registerreadevent (type dm_sysobject)

Purpose
Registers a user to receive notification when a specific object is read (that is, viewed, edited, exported,
or checked out).

Parameters

events (Required) Name of the event for which to


register. Valid value is: dm_getfile.
objectId (Required) ID of the object to which this event
(specified in the events attribute) applies.

Description
Since
6.0

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

unregisterevents (type dm_sysobject)

Purpose
Removes registration for notification when certain events occur on an object

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 535
unregisterreadevent (type dm_sysobject)

Parameters

events (Optional) List of specific events for which to


remove registration.
notificationStatus (Optional) (Boolean) True, if the current user is
registered for events on the selected object; False,
if not.Since 6.0.
objectId (Required) Object ID of the object from which to
remove event registration.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

unregisterreadevent (type dm_sysobject)

Purpose
De‑registers a user from receiving notification when an object is read (that is, viewed, edited, exported,
or checked out).

536 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
dmc_prm_action_make_library_request (entitlement prm, role dmc_prm_library_user, type dmc_prm_physical_container)

Parameters

events (Required) Name of the event for which to


de‑register. Valid value is: dm_getfile.
objectId (Required) ID of the object to which this event
(specified in the events attribute) applies.

Description
Since
6.0

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

Physical Records Manager


These actions require a Physical Records Manager license.

dmc_prm_action_make_library_request
(entitlement prm, role dmc_prm_library_user, type
dmc_prm_physical_container)

Purpose
Calls the makelibraryrequest, page 1261 component and the makelibraryrequestcontainer, page
1262 container to make a library request. Requires Physical Records Manager license.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 537
dmc_prm_action_make_library_request (entitlement prm, role dmc_prm_library_user, type dmc_prm_physical_document)

Parameters

objectId (Required) Object ID of the object for which the


request is being made.

Description
Since
6.0

Configuration File
webcomponent\config\library\records\request\prm_physical_container_actions.xml

Scope

entitlement prm
role dmc_prm_library_user
type dmc_prm_physical_container

Elements
None.

dmc_prm_action_make_library_request
(entitlement prm, role dmc_prm_library_user, type
dmc_prm_physical_document)

Purpose
Calls the makelibraryrequest, page 1261 component and the makelibraryrequestcontainer, page
1262 container to make a library request. Requires Physical Records Manager license.

538 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
dmc_prm_cancel_request (entitlement prm, role dmc_prm_library_user, type dmc_prm_library_request)

Parameters

objectId (Required) Object ID of the object for which the


request is being made.

Description
Since
6.0

Configuration File
webcomponent\config\library\records\request\prm_physical_document_actions.xml

Scope

entitlement prm
role dmc_prm_library_user
type dmc_prm_physical_document

Elements
None.

dmc_prm_cancel_request (entitlement
prm, role dmc_prm_library_user, type
dmc_prm_library_request)

Purpose
Cancels a library request. Requires Physical Records Manager license.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 539
dmc_prm_user_request_list (entitlement prm, role dmc_prm_library_user)

Parameters

lockOwner (Optional) Name of the user who has the object


locked.
objectId (Required) Object ID of the object for which the
cancellation is being made.

Description
Since
6.0

Configuration File
webcomponent\config\library\records\request\prm_library_request_actions.xml

Scope

entitlement prm
role dmc_prm_library_user
type dmc_prm_library_request

Elements
None.

dmc_prm_user_request_list (entitlement prm, role


dmc_prm_library_user)

Purpose
Calls the userrequestlist (entitlement prm, role dmc_prm_library_user), page 1265 to display a list of
Physical Records Manager library users. Requires Physical Records Manager license.

Parameters
None.

540 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
deleteformatpref

Description
Since
6.0

Configuration File
webcomponent\config\library\records\request\prm_generic_actions.xml

Scope

entitlement prm
role dmc_prm_library_user

Elements
None.

Preferences

deleteformatpref

Purpose
Deletes a user’s format preferences and caches the changes until they are committed.

Parameters

primaryFormat (Optional) Name of the primary format.


type (Optional) Object type to which this format
preference applies.

Description

Since
6.0

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 541
editformatpref

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Caller
format_preferences_summary, page 1274

Usage
This action updates the format_preferences_summary, page 1274 component’s cached list of
format preferences and displays the updated list. When the user saves the changes in the
format_preferences_summary, page 1274 component, the format preference is committed to the
repository.

Elements
None.

editformatpref

Purpose
Edits a user’s format preferences and caches the changes until they are committed.

Parameters

editApp (Optional) Name of the application to edit objects


with the format specified in the primaryFormat
attribute.
isEditing (Optional) Boolean: Whether the format is
already being edited (True) or not (False).
preferredRenditionFormat (Optional) Name of the preferred format for
displaying renditions.
primaryFormat (Optional) Name of the primary format.

542 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
preferences

type (Optional) Object type to which this format


preference applies.
viewApp (Optional) Name of the application to view
objects with the format specified in the
preferredRenditionFormat attribute.

Description
Since
6.0

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Caller
format_preferences_summary, page 1274

Usage
Calls the format_pref_attr_selector component and passes in this action’s arguments.

Elements
None.

preferences

Purpose
Allows a user to set preferences.

Parameters
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 543
createpreset (type dmc_preset_package)

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

Presets

createpreset (type dmc_preset_package)

Purpose
Calls the preseteditorcontainer, page 1288 container component to create a preset.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\actions\dmc_preset_package_actions.xml

544 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (type dmc_preset_package)

Scope

type dmc_preset_package

Elements
None.

delete (type dmc_preset_package)

Purpose
Calls the deletepreset (type dmc_preset_package), page 1282 component, which is contained in the
deletepresetcombocontainer (type dmc_preset_package), page 1283 container component, to delete a
dmc_preset_package object.

Parameters

objectName (Required) Name of the dm_preset_package


object to delete.
ownerName (Optional) Name of the user who owns the
dmc_preset_package object.

Description
Since
6.0

Configuration File
webcomponent\config\actions\dmc_preset_package_actions.xml

Scope

type dmc_preset_package

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 545
editpreset (type dmc_preset_package)

Elements
None.

editpreset (type dmc_preset_package)

Purpose
Calls the preseteditorcontainer, page 1288 container component to modify a preset.

Parameters

objectName (Required) Name of the object to edit.

Description

Since
6.0

Configuration File
webcomponent\config\actions\dmc_preset_package_actions.xml

Scope

type dmc_preset_package

Elements
None.

546 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
migratepresets (dmc_preset_package)

migratepresets (dmc_preset_package)

Purpose
Prepare preset objects to be deployed to a production repository.

Parameters

objectName (Optional) Object name of the preset to prepare


for migration.

Description
Since
6.0 SP1

Configuration File
webcomponent\config\actions\dmc_preset_package_actions.xml

Scope
All.

Elements
None.

presetdocbaseselector

Purpose
Enable selecting repositories from the multiselector.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 547
presetgrouplocator

Parameters

selections (Optional) Names of repositories to display.

Description
Since
6.0 SP1

Configuration File
webcomponent\config\actions\preset_generic_actions.xml

Scope
All.

Elements
None.

presetgrouplocator

Purpose
Enables selecting preset users, groups and roles.

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Required) Boolean: Set to true to support
multiple object selection.
selectedobjectids (Optional) Comma‑separated list of IDs of the
objects to intially select.

548 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
presetlocationlocator

Description
Since
6.0

Configuration File
webcomponent\config\actions\preset_generic_actions.xml

Scope
All.

Elements
None.

presetlocationlocator

Purpose
Calls the presetlocationlocatorcontainer, page 1294 container component to navigate preset cabinets
and folders.

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
invalidpresetentries (Optional) Specifies the object IDs of folders that
do not exist or are from other repositories.

Since 6.0 SP1.

multiselect (Required) Boolean: Set to true to support


multiple object selection.
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 549
presetobjectlocator

Description
Since
6.0

Configuration File
webcomponent\config\actions\preset_generic_actions.xml

Scope
All.

Elements
None.

presetobjectlocator

Purpose
Calls the presetobjectlocatorcontainer, page 1298 container component to locate preset objects.

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
invalidpresetentries (Optional) Specifies the object IDs of folders that
do not exist or are from other repositories.

Since 6.0 SP1.

multiselect (Required) Boolean: Set to true to support


multiple object selection.
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected.

550 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
presetobjecttypelocator

Description
Since
6.0

Configuration File
webcomponent\config\actions\preset_generic_actions.xml

Scope
All.

Elements
None.

presetobjecttypelocator

Purpose
Calls the presetobjecttypelocatorcontainer, page 1300 container component to locate preset object types.

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Required) Boolean: Set to true to support
multiple object selection.
selectedobjectids (Optional) Comma‑ or semicolon‑delimited list
of object IDs that are initially selected.

Description
Since
6.0

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 551
presetpermissionlocator

Configuration File
webcomponent\config\actions\preset_generic_actions.xml

Scope
All.

Elements
None.

presetpermissionlocator

Purpose
Calls the aclobjectlocatorcontainer, page 1403 to select ACLs.

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Required) Boolean: Set to true to support
multiple object selection.
selectedobjectids (Optional) Comma‑delimited delimited list of
object IDs that are initially selected.

Description

Since
6.0

Configuration File
webcomponent\config\actions\preset_generic_actions.xml

Scope
All.

552 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
presetuserorgrouplocator

Elements
None.

presetuserorgrouplocator

Purpose
Calls the userorgrouplocator, page 1526 component, contained in the userorgrouplocatorcontainer,
page 1528 component container, to locate preset users, groups, and roles.

Parameters

flatlist (Optional) Boolean: Set to true to list users and


groups in a flat list, set to false to display users
and groups in a drop‑down list.
multiselect (Required) Boolean: Set to true to support
multiple user/group selection.
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected.

Description
Since
6.0

Configuration File
webcomponent\config\actions\preset_generic_actions.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 553
properties (type dmc_preset_package)

properties (type dmc_preset_package)

Purpose
Calls the presetwizardcontainer, page 1306 component container to display the properties of a
dmc_preset_package object.

Parameters

objectName (Required) Name of the dmc_preset_package


object for which to display properties.

Description
Since
6.0

Configuration File
webcomponent\config\actions\dmc_preset_package_actions.xml

Scope

type dmc_preset_package

Records Manager

createrecordrelation (entitlement recordsmanager,


type dm_sysobject not dm_folder)

Purpose
Creates a relationship between formal records.Requires a Records Manager license.

554 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
declareformalrecord (entitlement recordsmanager, role dmc_rm_recordscontributor, type dm_sysobjectnotdm_folder)

Parameters

objectId (Required) Object ID of the source formal record


object.

Description
Since
5.x

Configuration File
webcomponent\config\library\records\relationships\dm_sysobject_actions.xml

Scope

entitlement recordsmanager
type dm_sysobject,not dm_folder

Elements
failoverenabled
See failoverenabled, page 381.

declareformalrecord (entitlement recordsmanager,


role dmc_rm_recordscontributor, type
dm_sysobjectnotdm_folder)

Purpose
Creates formal records.Requires a Records Manager license.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 555
removerecordrelationships (entitlement recordsmanager)

Parameters

folderId (Optional) ID of the folder in which to create the


formal record object.
objectId (Required) Object ID of the formal record object
to create.

Description
Since
5.x

Configuration File
webcomponent\config\library\records\declarerecord\dmc_rm_record_actions.xml

Scope

entitlement recordsmanager
role dmc_rm_recordscontributor
type dm_sysobject, not dm_folder

Elements
None.

removerecordrelationships (entitlement
recordsmanager)

Purpose
Deletes the relationship between formal records.Requires a Records Manager license.

556 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
viewformalrecordassociations (entitlement recordsmanager, type dm_sysobjectnotdm_folder) (Webtop)

Parameters

isRecordRelationship (Required) Boolean: True indicates that the


relationship is between formal records.
objectId (Required) Object ID of the source formal record
object.

Description
Since
5.x

Configuration File
webcomponent\config\library\records\relationships\dm_relation_actions.xml

Scope

entitlement recordsmanager

Elements
None.

viewformalrecordassociations (entitlement
recordsmanager, type dm_sysobjectnotdm_folder)
(Webtop)

Purpose
Calls the viewContainedInFormalRecords (entitlement recordsmanager) (Webtop), page
1337 component to view a list of formal record objects that contain a specified object. Requires
a Records Manager license.

Parameters

objectId (Required) ID of the formal record object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 557
viewrecordrelationships (entitlement recordsmanager, type dm_sysobjectnotdm_folder)

Description
Since
6.0

Configuration File
webtop\config\dm_sysobject_actions.xml

Scope

entitlement recordsmanager
type dm_sysobject,not dm_folder

Elements
failoverenabled
See failoverenabled, page 381.

viewrecordrelationships (entitlement
recordsmanager, type dm_sysobjectnotdm_folder)

Purpose
Calls the view_record_relationships (entitlement recordsmanager), page 1336 component view
relationships between records. Requires a Records Manager license.

Parameters

folderId (Optional) ID of the folder in which the source


formal record resides.
folderPath (Optional) Path to the folder in which the source
formal record resides.
objectId (Required) Object ID of the source formal record
object.

558 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
deleterelation (type dm_document)

Description
Since
5.x

Configuration File
webcomponent\config\library\records\relationships\dm_relation_actions.xml

Scope

entitlement recordsmanager
type dm_sysobject, not dm_folder

Elements
failoverenabled
See failoverenabled, page 381.

Relationships between objects

deleterelation (type dm_document)

Purpose
Calls a component that deletes a relation object (dm_relation) for two dm_document objects.

Parameters

relationObjectId (Required) ID of the dm_relation object to delete.

Description

Since
6.0

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 559
newrelation (type dm_document)

Configuration File
webcomponent\config\actions\dm_document_actions.xml

Scope

type dm_document

Elements
None.

newrelation (type dm_document)

Purpose
Calls a component that creates a relation object (dm_relation) for two dm_document objects.

Parameters

childObjectId (Optional) ID of the child object.


objectId (Required) ID of the parent object.

Description

Since
6.0

Configuration File
webcomponent\config\actions\dm_document_actions.xml

Scope

type dm_document

Elements
None.

560 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
comment (type dm_sysobject)

Renditions

comment (type dm_sysobject)

Purpose
Checks for a rendition in the allowable formats and generates JavaScript to invoke Adobe Acrobat 6 in a
new browser window. The allowable formats for comments are specified in /webcomponent/app.xml.
The Adobe Comment Connector feature must be enabled for the repository. This action does not
check for the presence of Adobe Acrobat on the client machine.

Parameters

contentType (Required) Type of the selected object.


objectId (Required) ID of the template
format (Required) File format of the selected object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 561
createhtmlrendition (type dm_sysobject)

createhtmlrendition (type dm_sysobject)

Purpose
Creates an HTML rendition of the object.

Parameters

contentType (Optional) File format to use when opening the


object (passed to the operating system)
lockOwner (Optional) User who has checked out the object
objectId (Required) ID of the object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

createhtmlrendition (type dmr_content)

Purpose
Creates an HTML rendition of a document

562 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
createhtmlrenditiongeneric (type dm_sysobject)

Parameters

contentType (Required) File format to use when creating the


object (passed to the operating system)
lockOwner (Optional) User who has checked out the object
objectId (Required) ID of the selected object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmr_content_actions.xml

Scope

type dmr_content

Elements
None.

createhtmlrenditiongeneric (type dm_sysobject)

Purpose
Creates an HTML rendition of the object

Parameters

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 563
createhtmlrenditiongeneric (type dmr_content)

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Parent Definition
createhtmlrendition:application=’webcomponent’ type=’dm_sysobject’

Scope

type dm_sysobject

Elements
None.

createhtmlrenditiongeneric (type dmr_content)

Purpose
Creates an HTML rendition of a document

Parameters

Description

Since
5.x

Configuration File
webcomponent\config\actions\dmr_content_actions.xml

Parent Definition
createhtmlrendition:application=’webcomponent’ type=’dm_sysobject’

Scope

type dmr_content

564 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
createpdfrendition (type dm_sysobject)

Elements
None.

createpdfrendition (type dm_sysobject)

Purpose
Creates a PDF rendition of the object.

Parameters

contentType (Optional) File format to use when opening the


object (passed to the operating system)
lockOwner (Optional) User who has checked out the object
objectId (Required) ID of the object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 565
createpdfrendition (type dmr_content)

createpdfrendition (type dmr_content)

Purpose
Creates a PDF rendition of a document.

Parameters

contentType (Required) File format to use when creating the


object (passed to the operating system)
lockOwner (Optional) User who has checked out the object
objectId (Required) ID of the selected object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmr_content_actions.xml

Scope

type dmr_content

Elements
None.

createpdfrenditiongeneric (type dm_sysobject)

Purpose
Creates a PDF rendition of the object.

566 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
createpdfrenditiongeneric (type dmr_content)

Parameters

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Parent Definition
createpdfrendition:application=’webcomponent’ type=’dm_sysobject’

Scope

type dm_sysobject

Elements
None.

createpdfrenditiongeneric (type dmr_content)

Purpose
Creates a PDF rendition of a document

Parameters

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmr_content_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 567
renditions (type dm_sysobject)

Parent Definition
createpdfrendition:application=’webcomponent’ type=’dm_sysobject’

Scope

type dmr_content

Elements
None.

renditions (type dm_sysobject)

Purpose
Displays the renditions for a selected object

Parameters

contentType (Required) The content type of the renditions to


display.
folderId (Optional) ID of the folder that contains the
selected object.
folderPath (Optional) Path to the folder that contains the
selected object. This path must be a complete
path from the repository root, for example,
/Documentation/Library/subfolder
objectId (Required) ID of the selected object.
objectNamePrefix (Optional)

Description
Since
5.x

568 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
refresh (type dm_sysobject)

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

Replicas and References

refresh (type dm_sysobject)

Purpose
Refreshes a reference or replica object to reflect changes in the object source.

Parameters

isReplica (Optional) Boolean parameter that specifies


whether the object is a replica.
objectId (Required) ID of the object to refresh (not ID of
the source object.)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 569
changehomedblog (type dm_user)

Scope

type dm_sysobject

Elements
None.

Repository

changehomedblog (type dm_user)

Purpose
Displays user change home repository requests and their status.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

type dm_user

Elements
None.

570 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
changehomedocbase (privilege sysadmin, type dm_user)

changehomedocbase (privilege sysadmin, type


dm_user)

Purpose
Changes the user’s home repository.

Parameters

objectId (Required) ID of the selected object.


objectname (Required) Name of the selected object.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

privilege sysadmin
type dm_user

Elements
None.

changehomedocbase (type dm_member_user)

Purpose
Changes the user’s home repository.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 571
selectrepository

Parameters

objectId (Required) ID of the selected object.


objectname (Required) Name of the selected object.

Description

Since
5.x

Configuration File
webcomponent\config\admin\group\dm_member_actions.xml

Scope

type dm_member_user

Elements
None.

selectrepository

Purpose
This action allows the user to select a repository from a list of preferred repositories. Displays visible
repositories for the list of connection brokers. The user can manually enter the name of a connection
broker to select a repository that connects to that broker.

Parameters
None.

572 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
addtoclipboard (type dm_smart_list)

Description
Since
5.x

Configuration File
wdk\config\session_actions.xml

Scope
All.

Elements
None.

Search

addtoclipboard (type dm_smart_list)

Purpose
Adds a dm_smart_list object to the clipboard.

Parameters

isReference (Optional) Boolean flag that indicates whether


the object is a reference object
lockOwner (Optional) User who has checked out the object
objectId (Required) ID of the object to be added to the
clipboard.
ownerName (Optional) Name of owner of the object to be
added to the clipboard
type (Optional) The content type of the object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 573
delete (type dm_smart_list)

Description
Since
5.x

Configuration File
webcomponent\config\environment\clipboard\dm_smart_list_clipboard_actions.xml

Scope

type dm_smart_list

Elements
None.

delete (type dm_smart_list)

Purpose
Deletes smart lists.

Parameters

folderId (Optional) ID of the dm_folder object that


contains the dm_smart_list object to delete..
lockOwner (Optional) Name of the user who has the
dm_smart_list object locked.
objectId (Required) ID of the dm_smart_list object to
delete.
ownerName (Optional) User name of the owner of the
dm_smart_list object.

574 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (type dmc_search_template)

Description
Since
6.0

Configuration File
webcomponent\config\actions\dm_smart_list_actions.xml

Scope

type dm_smart_list

Elements
failoverenabled
Since 6.0 SP1.
See failoverenabled, page 381.

delete (type dmc_search_template)

Purpose
Calls the delete, page 1118 component and the combocontainer, page 1183 container to delete search
templates.

Parameters

folderId (Optional) Object ID of the folder in which the


search template resides.
lockOwner (Optional) Name of the user who has checked
out the search template.
objectId (Required) Object ID of the search template to
be viewed.
ownerName (Optional) Name of the owner of the search
template.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 575
drledit (type dm_smart_list)

Description
Since
6.0

Configuration File
webcomponent\config\actions\dmc_search_template_actions.xml

Scope

type dmc_search_template

Elements
failoverenabled
Since 6.0 SP1.
See failoverenabled, page 381.

drledit (type dm_smart_list)

Purpose
Opens a DRL to a dm_smart_list object for editing.

Parameters
The parameters are inherited from edit:webcomponent/config/actions/dm_smart_list_actions.xml. See
edit (type dm_smart_list), page 580.

Description
Since
6.0

Configuration File
webcomponent\config\actions\dm_smart_list_actions.xml

576 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
drledit (type dmc_search_template)

Parent Definition
edit:webcomponent/config/actions/dm_smart_list_actions.xml

Scope

type dm_smart_list

Elements
None.

drledit (type dmc_search_template)

Purpose
Opens a DRL to a dmc_search_template object for editing.

Parameters
The parameters are inherited from edittemplate:webcomponent/config/actions/dmc_search_template_
actions.xml. See edittemplate (type dmc_search_template), page 585.

Description
Since
6.0

Configuration File
webcomponent\config\actions\dmc_search_template_actions.xml

Parent Definition
edit:webcomponent/config/actions/dmc_search_template_actions.xml

Scope

type dmc_search_template

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 577
drlview (type dm_smart_list)

Elements
None.

drlview (type dm_smart_list)

Purpose
Opens a DRL to a dm_smart_list object for viewing.

Parameters
The parameters are inherited from view:webcomponent/config/actions/dm_smart_list_actions.xml.
See view (type dm_smart_list), page 598.

Description
Since
6.0

Configuration File
webcomponent\config\actions\dm_smart_list_actions.xml

Parent Definition
view:webcomponent/config/actions/dm_smart_list_actions.xml

Scope

type dm_smart_list

Elements
None.

578 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
drlview (type dmc_search_template)

drlview (type dmc_search_template)

Purpose
Opens a DRL to a dm_smart_list object for viewing.

Parameters
The parameters are inherited from view:webcomponent/config/actions/dm_smart_list_actions.xml.
See view (type dm_smart_list), page 598.

Description
Since
6.0

Configuration File
webcomponent\config\actions\dm_smart_list_actions.xml

Parent Definition
view:webcomponent/config/actions/dm_smart_list_actions.xml

Scope

type dm_smart_list

Elements
None.

editsearch

Purpose
Calls the advsearch, page 1354 component, which is contained in the advsearchcontainer, page
1358 container component, to edit a saved search.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 579
edit (type dm_smart_list)

Parameters

queryId (Required) Internal ID assigned to the query.

Description
Since
6.0

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

edit (type dm_smart_list)

Purpose
Calls the advsearch, page 1354 component to edit a saved search.

Parameters

contentSize (Optional) Size of the object in bytes.


contentType (Optional) File format to use when opening the
object (passed to the operating system).
isReference (Optional) Boolean: Indicates whether the object
is a reference object (True) or not (False).
lockOwner (Optional) Name of the user who has checked
out the object.
navigation (Optional) Type of navigation upon execution.
objectId (Required) ID of the object to be viewed.
ownerName (Optional) Name of the object owner.

580 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
edit (type dm_smart_list)

querydeftype (Optional) Type of the saved search. Valid values


are: IDfSmartList.TYPE_QUERY_BUILDER
= ʺquery_builderʺ IDfSmartList.TYPE_
PASSTHROUGH_QUERY = ʺpassthrough_
queryʺ IDfSmartList.TYPE_UNKNOW =
ʺʺIDfSmartList.TYPE_UNKNOW is only used
in version 5.3.x. If this parameter value is
not specified, it is retrieved from the object
specified by the objectId parameter.For
this action to be enabled (for example,
from the menu or right‑click context
menu): The value of this parameter must
be IDfSmartList.TYPE_QUERY_BUILDER
or IDfSmartList.TYPE_UNKNOW, or The
value retrieved from the object must be
IDfSmartList.TYPE_QUERY_BUILDER.
Otherwise, this action is disabled.Since 6.0:
passthrough_query value.
type (Optional) Object type.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_smart_list_actions.xml

Scope

type dm_smart_list

Caller
searchstoreclassic, page 1389
searchstorestreamline, page 1390

Usage
The advanced search component is displayed when query_builder is specified for the querydeftype
parameter.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 581
editfile (type dm_smart_list)

The user must have read_permit access to the object (valid values: DELETE_PERMIT |
WRITE_PERMIT |VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT | BROWSE_PERMIT
| NONE_PERMIT). The advanced search component is displayed when ʺquery_builder is specified
for the querydeftype parameter. Also, a query that is too old or being edited by another component
when the query is executed cannot be edited.

Elements
failoverenabled
Since 6.0 SP1.
See failoverenabled, page 381.

editfile (type dm_smart_list)

Purpose
Calls the advsearch, page 1354 component to edit a saved search.

Parameters

contentSize (Optional) Size of the object in bytes.


contentType (Optional) File format to use when opening the
object (passed to the operating system).
isReference (Optional) Boolean flag that indicates whether
the object is a reference object (pointer to smart
list in another repository).
lockOwner (Optional) User who has checked out the smart
list.
navigation (Optional) Type of navigation upon execution.
objectId (Required) ID of the smart list.
ownerName (Optional) Name of the smart list owner.

582 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
editfile (type dm_smart_list)

querydeftype (Optional) Type of the saved search. Valid values


are: IDfSmartList.TYPE_QUERY_BUILDER
= ʺquery_builderʺ IDfSmartList.TYPE_
PASSTHROUGH_QUERY = ʺpassthrough_
queryʺ IDfSmartList.TYPE_UNKNOW =
ʺʺIDfSmartList.TYPE_UNKNOW is only used
in version 5.3.x. If this parameter value is
not specified, it is retrieved from the object
specified by the objectId parameter.For
this action to be enabled (for example,
from the menu or right‑click context
menu): The value of this parameter must
be IDfSmartList.TYPE_QUERY_BUILDER
or IDfSmartList.TYPE_UNKNOW, or The
value retrieved from the object must be
IDfSmartList.TYPE_QUERY_BUILDER.
Otherwise, this action is disabled.

6.0: The passthrough_query value was added as


a valid value.
type (Optional) Object type of smartlist (dm_smartlist
or subtype).

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_smart_list_actions.xml

Scope

type dm_smart_list

Caller
searchstoreclassic, page 1389
searchstorestreamline, page 1390

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 583
editfile (type dmc_search_template)

Usage
The advanced search component is displayed when query_builder is specified for the querydeftype
parameter.
The user must have read_permit access to the object (valid values: DELETE_PERMIT |
WRITE_PERMIT |VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT | BROWSE_PERMIT
| NONE_PERMIT). The advanced search component is displayed when ʺquery_builder is specified
for the querydeftype parameter. Also, a query that is too old or being edited by another component
when the query is executed cannot be edited.

Elements
failoverenabled
Since 6.0 SP1.
See failoverenabled, page 381.

editfile (type dmc_search_template)

Purpose
Calls the advsearch, page 1354 component to edit a search template.

Parameters
The parameters are inherited from edittemplate:webcomponent/config/actions/dmc_search_template_
actions.xml. See .

Description

Since
6.0

Configuration File
webcomponent\config\actions\dmc_search_template_actions.xml

Parent Definition
edittemplate:webcomponent/config/actions/dmc_search_template_actions.xml

584 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
edittemplate (type dmc_search_template)

Scope

type dmc_search_template

Elements
None.

edittemplate (type dmc_search_template)

Purpose
Calls the savesearchtemplate, page 1371 to edit a search template to change the list of fixed and free
constraints of the template (without modifying the search).

Parameters

lockOwner (Optional) User who has checked out the search


template.
objectId (Required) Object ID of the search template to
be edited.
ownerName (Optional) Name of the user who owns the
search template.

Description

Since
6.0

Configuration File
webcomponent\config\actions\dmc_search_template_actions.xml

Scope

type dmc_search_template

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 585
edittemplatedefinition (type dmc_search_template)

Usage
The user must have read_permit access to the object (valid values: DELETE_PERMIT |
WRITE_PERMIT |VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT | BROWSE_PERMIT |
NONE_PERMIT).

Elements
failoverenabled
Since 6.0 SP1.
See failoverenabled, page 381.

edittemplatedefinition (type dmc_search_template)

Purpose
Edit the template in the advanced search component to modify the search definition.

Parameters

lockOwner (Optional) User who has checked out the search


template definition.
objectId (Required) Object ID of the search template
definition to edit.
ownerName (Optional) Name of the user who owns the
search template definition.

Description

Since
6.0

Configuration File
webcomponent\config\actions\dmc_search_template_actions.xml

586 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
importexternalresult (type dm_externalresult)

Scope

type dmc_search_template

Usage
The user must have read_permit access to the object (valid values: DELETE_PERMIT |
WRITE_PERMIT |VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT | BROWSE_PERMIT |
NONE_PERMIT).

Elements
failoverenabled
Since 6.0 SP1.
See failoverenabled, page 381.

importexternalresult (type dm_externalresult)

Purpose
Imports a file listed after searching an external source

Parameters

entryId (Required) ID of the result entry.


queryId (Required) Internal ID of the query used for
searching the external source.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_externalresult_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 587
properties (type dm_externalresult)

Scope

type dm_externalresult

Elements
None.

properties (type dm_externalresult)

Purpose
Displays the properties component for an external result object

Parameters

entryId (Required) ID of the result entry.


queryId (Required) ID of the query used for searching
the external source.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_externalresult_actions.xml

Scope

type dm_externalresult

Elements
failoverenabled
Since 6.0 SP1.

588 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
properties (type dm_smart_list)

See failoverenabled, page 381.

properties (type dm_smart_list)

Purpose
Displays the properties component for a dm_smart_list object

Parameters

entryId (Required) ID of the dm_smart_list object.


queryId (Required) ID of the query used for searching
the dm_smart_list.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_smart_list_actions.xml

Scope

type dm_smart_list

Elements
failoverenabled
Since 6.0 SP1.
See failoverenabled, page 381.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 589
revisesearchtemplate

revisesearchtemplate

Purpose
Calls the searchtemplate component to revise a search with its original search template form instead of
the classical advanced search component.Webtop Extended Search is required.

Parameters

queryId (Required) Internal ID assigned to the search.

Description
Since
6.0

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 381.

runsearchtemplate (type dmc_search_template)

Purpose
Displays a search form from a search template and create a search. Webtop Extended Search is
required.

590 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
savesearch

Parameters

lockOwner (Optional) Name of the user who has the search


template checked out.
objectId (Required) Object ID of the search template.
ownerName (Optional) Name of the user who owns the
search template.

Description
Since
6.0

Configuration File
webcomponent\config\actions\dmc_search_template_actions.xml

Scope

type dmc_search_template

Elements
failoverenabled
Since 6.0 SP1.
See failoverenabled, page 381.

savesearch

Purpose
Saves a search as a search template if the search template service is available or create a template
from another search template.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 591
savesearchtemplate

Parameters

queryId (Optional) Internal ID assigned to the query

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 381.

savesearchtemplate

Purpose
Calls the savesearchtemplate component. Webtop Extended Search is required.

Parameters

queryId (Required) Internal ID assigned to the search.

Description
Since
6.0

592 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
search

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 381.

search

Purpose
Performs a search based on a query.

Parameters

query (Required) The query string. The queryType


parameter specifies the kind of query.
queryType (Optional) Specifies the kind of query specified in
the query parameter. Valid values are:

• objectId — the object ID of the smartlist


• querydef — the XML content of a smartlist
• queryId — For internal use only.
• lastQuery — the results of the last executed
search
• savedResults — the saved search results
• dql — the DQL query
• string or null — keywords
ranking (Optional) Not used. (The 6.0 version of this
guide incorrectly stated this parameter as being
used.).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 593
searchuser (type dm_user)

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

searchuser (type dm_user)

Purpose
Displays a list of users.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

type dm_user

594 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
view (type dm_externalresult)

Elements
None.

view (type dm_externalresult)

Purpose
Views the content of an external search result

Parameters

entryId (Required) ID of the result entry.


queryId (Required) ID of the query used for searching
the external source.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_externalresult_actions.xml

Scope

type dm_externalresult

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 595
view (type dm_query)

view (type dm_query)

Purpose
Launches the search component to run a query. The user must have the read_permit access to the
object (valid values: DELETE_PERMIT | WRITE_PERMIT |VERSION_PERMIT | RELATE_PERMIT |
READ_PERMIT | BROWSE_PERMIT | NONE_PERMIT).

Parameters

contentSize (Optional) Size of the object in bytes


contentType (Optional) File format to use when opening the
object (passed to the operating system)
isReference (Optional) Boolean flag that indicates whether
the object is a reference object
lockOwner (Optional) User who has checked out the object
(dm_query only)
navigation (Optional) Type of navigation to perform after
the action
objectId (Required) ID of the object to be viewed.
ownerName (Optional) Name of the object owner (dm_query
only)
type (Optional) Object type (dm_query only)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_query_actions.xml

Scope

type dm_query

596 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
view (type dmc_search_template)

Elements
None.

view (type dmc_search_template)

Purpose
Launches a viewing application to view a search template.

Parameters
The parameters are inherited from runsearchtemplate:webcomponent/config/actions/dmc_search_
template_actions.xml. See .

Description
Since
6.0

Configuration File
webcomponent\config\actions\dmc_search_template_actions.xml

Parent Definition
runsearchtemplate:webcomponent/config/actions/dmc_search_template_actions.xml

Scope

type dmc_search_template

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 597
view (type dm_smart_list)

view (type dm_smart_list)

Purpose
Calls the search, page 1372 component to run the saved search.

Parameters

contentSize (Optional) Size of the object in bytes.


contentType (Optional) File format to use when opening the
object (passed to the operating system).
isReference (Optional) Boolean flag that indicates whether
the object is a reference object.
lockOwner (Optional) Name of the user who has checked
out the object.
navigation (Optional) Type of navigation upon execution.
Default is returnJump.
objectId (Required) ID of the object to be viewed.
ownerName (Optional) Name of the object owner.
query (Optional) Query in the format specified by the
queryType parameter. Default is r_object_id.
querydeftype (Optional) Type of the saved search. Valid values
are: IDfSmartList.TYPE_QUERY_BUILDER
= ʺquery_builderʺ IDfSmartList.TYPE_
PASSTHROUGH_QUERY = ʺpassthrough_
queryʺ IDfSmartList.TYPE_UNKNOW =
ʺʺIDfSmartList.TYPE_UNKNOW is only used
in version 5.3.x. If this parameter value is not
specified, it is retrieved from the object specified
by the objectId parameter. For this action to
be enabled (for example, from the menu or
right‑click context menu), the value of this
parameter or the value retrieved from the object
must be a valid value; otherwise, this action is
disabled.

6.0: Added passthrough as a valid value.

598 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
view (type dm_smart_list)

queryType (Optional) Specifies the kind of the query that


is specified in the query parameter or specific
results to display. Valid values are: string or null:
Keywords. dql: DQL query. objectId: Object
ID of the smartlist. querydef: XML content of
a smartlist. queryId: (Internal use only) An
active query for editing. lastQuery: Display the
results of the last executed search. savedResults:
Display saved search results. Default is objectId.
type (Optional) Object type.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_smart_list_actions.xml

Scope

type dm_smart_list

Caller
search, page 1372

Usage
The user must have read_permit access to the object (valid values: DELETE_PERMIT |
WRITE_PERMIT |VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT | BROWSE_PERMIT |
NONE_PERMIT). Launches the search component to run the saved search when ʺquery_builderʺ or
ʺpassthrough_queryʺ is specified for the querydeftype

Elements
failoverenabled
Since 6.0 SP1.
See failoverenabled, page 381.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 599
viewsavedresults (type dm_smart_list)

viewsavedresults (type dm_smart_list)

Purpose
Calls the search, page 1372 component to view the saved search results of the saved search.

Parameters

contentSize (Optional) Size of the object in bytes.


contentType (Optional) File format to use when opening the
object (passed to the operating system).
hasresults (Optional) Boolean: Whether the dm_smart_list
object contains search results (True) or not
(False). To enable this action, set this parameter’s
value to true; otherwise, this parameter’s value
is retrieved from the object specified by the
objectId parameter.
isReference (Optional) Boolean: Whether the object is a
reference object (True) or not (False).
lockOwner (Optional) User who has checked out the object
(dm_query only).
navigation (Optional) Type of navigation to perform after
the action.
objectId (Required) ID of the selected dm_smart_list
object.
ownerName (Optional) Name of the object owner (dm_query
only).
query (Optional) Query in the format specified by the
queryType parameter.
queryType (Optional) Type of the saved search. Valid values
are: IDfSmartList.TYPE_QUERY_BUILDER
= ʺquery_builderʺ IDfSmartList.TYPE_
PASSTHROUGH_QUERY = ʺpassthrough_
queryʺ IDfSmartList.TYPE_UNKNOW =
ʺʺIDfSmartList.TYPE_UNKNOW is only used in
version 5.3.x.
type (Optional) Object type.

600 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
aclbrowse (privilege sysadmin, type dm_user)

Description
Since
6.0

Configuration File
webcomponent\config\actions\dm_smart_list_actions.xml

Scope

type dm_smart_list

Caller
searchstoreclassic, page 1389
searchstorestreamline, page 1390

Usage
The user must have read_permit access to the object (valid values: DELETE_PERMIT |
WRITE_PERMIT |VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT | BROWSE_PERMIT |
NONE_PERMIT).

Elements
failoverenabled
Since 6.0 SP1.
See failoverenabled, page 381.

Security

aclbrowse (privilege sysadmin, type dm_user)

Purpose
Allows the administrator to browse a list of ACLs in the repository

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 601
addaccessortorevoke (type dm_common_restriction)

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

privilege sysadmin
type dm_user

Elements
None.

addaccessortorevoke (type dm_common_restriction)

Purpose
Adds an accessor to an in‑memory list of accessors to revoke from the ACLs of more than one
selected object.

Parameters

flatlist (Optional) Boolean: To display all objects in a flat


list (True) or a drop‑down list (False).
multiselect (Required) Boolean: Support multiple object
selection (True) or not (False).
objecttype (Optional) Type of the selected object.

602 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
addaceaction (type dm_ace)

permit (Optional) String that represents the permission


to be applied to the accessor.
roomId (Optional) ID of the room that currently governs
the folder.

Description

Since
6.0

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope

type dm_common_restriction

Elements
None.

addaceaction (type dm_ace)

Purpose
Adds a user or group entry to an ACL

Parameters

flatlist (Optional) Boolean: True to list all objects in a


flat list, false to display a drop down list.
multiselect (Required) Boolean: True to support multiple
object selection
objecttype (Optional) Type of the selected object

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 603
addgroupmembership

permit (Optional) Set of working and new permits. Valid


values: DELETE_PERMIT | WRITE_PERMIT
| VERSION_PERMIT | RELATE_PERMIT
| READ_PERMIT | BROWSE_PERMIT |
NONE_PERMIT
roomId (Optional) ID of the room, in the case of a room
ACL

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope

type dm_ace

addgroupmembership

Purpose
Adds a user or group to a group

Parameters

accessorName (Required) Name of user or group


objectId (Optional) ID of the ACL (permission set)

604 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
addrestriction (type dm_restriction)

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope

type dm_ace

addrestriction (type dm_restriction)

Purpose
Adds a restriction to the ACL. Trusted Content Services must be enabled in the repository.

Parameters

flatlist (Optional) Boolean: true to list all objects in a flat


list, false to display a drop down list.
multiselect (Required) Boolean: true to support multiple
object selection
objecttype (Optional) Type of the selected object
permit (Optional) Set of working and new permits. Valid
values: DELETE_PERMIT | WRITE_PERMIT
| VERSION_PERMIT | RELATE_PERMIT
| READ_PERMIT | BROWSE_PERMIT |
NONE_PERMIT
roomId (Optional) ID of the room, in the case of a room
ACL

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 605
aliassetbrowse (privilege sysadmin, type dm_user)

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope

type dm_restriction

Elements
None.

aliassetbrowse (privilege sysadmin, type dm_user)

Purpose
Allows the administrator to browse a list of alias sets in the repository.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

606 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
aliassetbrowse (type dm_group)

Scope

privilege sysadmin
type dm_user

Elements
None.

aliassetbrowse (type dm_group)

Purpose
Allows the administrator to browse a list of alias sets in the repository.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\admin\group\dm_group_actions.xml

Scope

type dm_group

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 607
delete (type dm_acl)

delete (type dm_acl)

Purpose
Deletes an ACL.

Parameters

objectId (Required) The ID of the object to be deleted.


objectname (Required) Name of the ACL.
type (Required) Object type of the ACL.

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope

type dm_acl

Elements
None.

editaceaction

Purpose
Edits an entry in an ACL.

608 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
editaceaction

Parameters

accessorName (Required) Name of user or group to add to ACL.


basicpermit (Optional) The name of the basic permit for the
accessor. Valid values are 1 (none), 2 (browse), 3
(read), 4 (relate), 5 (version), 6 (write), 7 (delete).
Default = 3 (read)
extpermit (Optional) The extended permission for
the accessor. Valid values are EXECUTE_
PROCEDURE_BIT, CHANGE_LOCATION_BIT,
CHANGE_STATE_BIT, CHANGE_
PERMISSIONS_BIT, TAKE_OWNERSHIP_BIT.
Default = 0 (no extended permissions)
extpermit_readonly (Optional) Set to true to disable extended
permission controls
objectId (Optional) ID of the ACL
objectName (Optional) Name of ACL
permit (Optional) String representation of the
permission that is being applied to the accessor
permitType (Optional) Valid types of IDfPermit:
DF_ACCESS_PERMIT = 0 DF_EXTENDED_
PERMIT = 1 DF_APPLICATION_PERMIT
= 2 DF_ACCESS_RESTRICTION = 3
DF_EXTENDED_RESTRICTION = 4
DF_APPLICATION_RESTRICTION = 5
DF_REQUIRED_GROUP = 6 DF_REQUIRED_
GROUP_SET = 7

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 609
editacepermitaction

editacepermitaction

Purpose
Sets extended permissions in an ACL including Trusted Content Services support if it is configured
for the repository

Parameters

accessorName (Required) Name of accessor (user or group)


basicpermit (Optional) The name of the basic permit for the
accessor. Valid values are 1 (none), 2 (browse), 3
(read), 4 (relate), 5 (version), 6 (write), 7 (delete).
Default = 3 (read)
extpermit (Optional) The extended permission for
the accessor. Valid values are EXECUTE_
PROCEDURE_BIT, CHANGE_LOCATION_BIT,
CHANGE_STATE_BIT, CHANGE_
PERMISSIONS_BIT, TAKE_OWNERSHIP_BIT.
Default = 0 (no extended permissions)
extpermit_readonly (Optional) Set to true to disable extended
permission controls
objectId (Optional) ID of the ACL
objectName (Optional) Name of ACL
permit (Optional) String representation of the
permission that is being applied to the accessor
permitType (Optional) Valid types of IDfPermit:
DF_ACCESS_PERMIT=0DF_EXTENDED_
PERMIT = 1DF_APPLICATION_PERMIT
= 2DF_ACCESS_RESTRICTION =
3DF_EXTENDED_RESTRICTION =
4DF_APPLICATION_RESTRICTION =
5DF_REQUIRED_GROUP = 6DF_REQUIRED_
GROUP_SET = 7

610 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
editrestriction (type dm_restriction)

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope
All.

editrestriction (type dm_restriction)

Purpose
Edits the restricted access of selected users or groups. Trusted Content Services must be enabled
in the repository.

Parameters

accessorName (Required) Name of user or group to add to ACL.


basicpermit (Optional) The name of the basic permit for the
accessor. Valid values are 1 (none), 2 (browse), 3
(read), 4 (relate), 5 (version), 6 (write), 7 (delete).
Default = 3 (read)
extpermit (Optional) The extended permission for
the accessor. Valid values are EXECUTE_
PROCEDURE_BIT, CHANGE_LOCATION_BIT,
CHANGE_STATE_BIT, CHANGE_
PERMISSIONS_BIT, TAKE_OWNERSHIP_BIT.
Default = 0 (no extended permissions)
objectName (Optional) Name of ACL

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 611
getowner (type dm_acl)

permit (Optional) String representation of the


permission that is being applied to the accessor
permitType (Optional) Valid types of IDfPermit:
DF_ACCESS_PERMIT=0DF_EXTENDED_
PERMIT = 1DF_APPLICATION_PERMIT
= 2DF_ACCESS_RESTRICTION =
3DF_EXTENDED_RESTRICTION =
4DF_APPLICATION_RESTRICTION =
5DF_REQUIRED_GROUP = 6DF_REQUIRED_
GROUP_SET = 7

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope

type dm_restriction

Elements
None.

getowner (type dm_acl)

Purpose
Gets the ACL owner name

612 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
locations (type dm_acl)

Parameters

flatlist (Optional) Boolean: true to list all objects in a flat


list, false to display a drop down list.
multiselect (Optional) Boolean: true to support multiple
object selection
objectId (Required) ID of ACL object.
objecttype (Optional) Type of the selected object

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope

type dm_acl

Elements
None.

locations (type dm_acl)

Purpose
Displays the locations where an ACL is used.

Parameters

objectId (Required) ID of the selected object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 613
newacl (type dm_acl)

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope

type dm_acl

Elements
None.

newacl (type dm_acl)

Purpose
Creates a new ACL

Parameters

objectId (Required) ID of the ACL.

Description

Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope

type dm_acl

614 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
properties (type dm_acl)

Elements
None.

properties (type dm_acl)

Purpose
Displays the properties of an ACL.

Parameters

objectId (Required) ID of the selected object.

Description

Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope

type dm_acl

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 615
removeaccessor

removeaccessor

Purpose
Removes an accessor from an ACL

Parameters

accessorName (Required) Name of accessor (user or group) to


be removed
permitType (Optional) Valid types of IDfPermit:
DF_ACCESS_PERMIT=0DF_EXTENDED_
PERMIT = 1DF_APPLICATION_PERMIT
= 2DF_ACCESS_RESTRICTION =
3DF_EXTENDED_RESTRICTION =
4DF_APPLICATION_RESTRICTION =
5DF_REQUIRED_GROUP = 6DF_REQUIRED_
GROUP_SET = 7

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope
All.

616 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
removeaccessortorevoke (type dm_common_restriction)

removeaccessortorevoke (type dm_common_


restriction)

Purpose
Removes an accessor from an in‑memory list of accessors to revoke from the ACLs of more than one
selected object.

Parameters

accessorName (Required) Name of user or group to remove


from the in‑memory list.
permitType (Optional) Valid types of IDfPermit:
DF_ACCESS_PERMIT = 0 DF_EXTENDED_
PERMIT = 1 DF_APPLICATION_PERMIT
= 2 DF_ACCESS_RESTRICTION = 3
DF_EXTENDED_RESTRICTION = 4
DF_APPLICATION_RESTRICTION = 5
DF_REQUIRED_GROUP = 6 DF_REQUIRED_
GROUP_SET = 7

Description

Since
6.0

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope

type dm_common_restriction

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 617
removerestriction (type dm_restriction)

removerestriction (type dm_restriction)

Purpose
Removes an access restriction for selected users or group. Trusted Content Services must be enabled
in the repository.

Parameters

accessorName (Required) Name of user or group for which to


remove the restriction
permitType (Optional) Valid types of IDfPermit:
DF_ACCESS_PERMIT=0, DF_EXTENDED_
PERMIT = 1, DF_APPLICATION_PERMIT
= 2, DF_ACCESS_RESTRICTION = 3,
DF_EXTENDED_RESTRICTION = 4,
DF_APPLICATION_RESTRICTION
= 5, DF_REQUIRED_GROUP = 6,
DF_REQUIRED_GROUP_SET = 7

Description

Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope

type dm_restriction

Elements
None.

618 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
rmaccessor

rmaccessor

Purpose
Removes an entry from an ACL.

Parameters

accessorName (Required) Name of user or group to remove


from the ACL.

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope
All.

Subscriptions

subscribe (type dm_sysobject)

Purpose
Subscribes the user to an object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 619
subscribeothers (type dm_sysobject)

Parameters

folderPath (Optional) Path to object


objectId (Required) ID of the selected object.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

subscribeothers (type dm_sysobject)

Purpose
Enables a user to subscribe other users to objects.

Parameters

folderPath (Optional) Path to the object.


objectId (Required) ID of the selected object.

620 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
unsubscribe (type dm_sysobject)

Description
Since
6.0

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

unsubscribe (type dm_sysobject)

Purpose
Unsubscribes an object.

Parameters

events (Optional) List of the events for which to remove


subscriptions.
objectId (Required) ID of the object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 621
testcustomattrs (type wdk5_testtype_1)

Scope

type dm_sysobject

Elements
None.

Testing

testcustomattrs (type wdk5_testtype_1)

Purpose
One of a set of components and actions that test controls and actions. This action can be used for
internal testing to display custom attributes.

Parameters
The parameters are inherited from versions:webcomponent/config/actions/dm_sysobject_actions.xml.
See versions (type dm_sysobject), page 410.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Parent Definition
versions:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type wdk5_testtype_1

622 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
testcustomrepeatingattrs (type wdk5_testtype_2)

Elements
None.

testcustomrepeatingattrs (type wdk5_testtype_2)

Purpose
One of a set of components and actions that test controls and actions. This action can be used for
internal testing of repeating attributes display.

Parameters
The parameters are inherited from versions:webcomponent/config/actions/dm_sysobject_actions.xml.
See versions (type dm_sysobject), page 410.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Parent Definition
versions:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type wdk5_testtype_2

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 623
testdocbasescope (docbase CS52ORABuild162wdkFormnotw2k52WDK_CustomTest01, type wdk5_testtype_3)

testdocbasescope (docbase
CS52ORABuild162wdkFormnotw2k52WDK_
CustomTest01, type wdk5_testtype_3)

Purpose
One of a set of components and actions that tests controls and actions. This action can be used for
internal testing of scope on repository and type values.

Parameters
The parameters are inherited from renditions:webcomponent/config/actions/dm_sysobject_actions.
xml. See renditions (type dm_sysobject), page 568.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Parent Definition
renditions:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

docbase CS52ORABuild162, wdkForm, not


w2k52WDK_CustomTest01
type wdk5_testtype_3

Elements
None.

624 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
testfilterattrs (type wdk5_testtype_3)

testfilterattrs (type wdk5_testtype_3)

Purpose
One of a set of components and actions that test controls and actions. This action can be used for
internal testing to filter an action by a scope value.

Parameters
The parameters are inherited from versions:webcomponent/config/actions/dm_sysobject_actions.xml.
See versions (type dm_sysobject), page 410.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Parent Definition
versions:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type wdk5_testtype_3

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 625
testmultirole (role consumernotadministrator, type wdk5_testtype_4)

testmultirole (role consumernotadministrator, type


wdk5_testtype_4)

Purpose
One of a set of components and actions that test controls and actions. This action can be used for
internal testing of roles.

Parameters
The parameters are inherited from renditions:webcomponent/config/actions/dm_sysobject_actions.
xml. See renditions (type dm_sysobject), page 568.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Parent Definition
renditions:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

role consumer, not administrator


type wdk5_testtype_4

Elements
None.

626 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
testmultiscope (type wdk5_testtype_1wdk5_testtype_2)

testmultiscope (type wdk5_testtype_1wdk5_


testtype_2)

Purpose
One of a set of components and actions that test controls and actions. This action can be used for
internal testing of multiple scope values.

Parameters
The parameters are inherited from renditions:webcomponent/config/actions/dm_sysobject_actions.
xml. See renditions (type dm_sysobject), page 568.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Parent Definition
renditions:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type wdk5_testtype_1, wdk5_testtype_2

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 627
testmultiscopeandnot (type wdk5_testtype_1notwdk5_testtype_2)

testmultiscopeandnot (type wdk5_testtype_


1notwdk5_testtype_2)

Purpose
One of a set of components and actions that test controls and actions. This action can be used for
internal testing of multiple scopes and excluding values.

Parameters
The parameters are inherited from renditions:webcomponent/config/actions/dm_sysobject_actions.
xml. See renditions (type dm_sysobject), page 568.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Parent Definition
renditions:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type wdk5_testtype_1, not wdk5_testtype_2

Elements
None.

628 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
testnotkeyword (type notwdk5_testtype_1)

testnotkeyword (type notwdk5_testtype_1)

Purpose
One of a set of components and actions that test controls and actions. This action can be used for
internal testing of scope that excludes certain values.

Parameters
The parameters are inherited from history:webcomponent/config/actions/dm_sysobject_actions.xml.
See history (type dm_sysobject), page 404.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Parent Definition
history:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type not wdk5_testtype_1

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 629
showallmessages

User feedback

showallmessages

Purpose
Calls the messages, page 1487 component to display a data grid of all the user’s messages for a session.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
None.

630 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
accessiblefolderbrowse (privilege sysadmin, type dm_user)

Users, groups, and roles

accessiblefolderbrowse (privilege sysadmin, type


dm_user)

Purpose
Locates dm_user objects.

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Optional) Set to true to support multiple object
selection.
objecttype (Optional) Object type of the selected object.
selectedobjectids (Optional) Comma‑ or semicolon‑delimited list
of object IDs that are initially selected.

Description

Since
6.0

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

privilege sysadmin
type dm_user

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 631
accessiblefolderbrowse (type dm_member_user, entitlement collaboration6)

Elements
None.

accessiblefolderbrowse (type dm_member_user,


entitlement collaboration6)

Purpose
Locates dm_member_user objects.

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Optional) Set to true to support multiple object
selection.
objecttype (Optional) Object type of the selected object.
selectedobjectids (Optional) Comma‑ or semicolon‑delimited list
of object IDs that are initially selected.

Description
Since
6.0

Configuration File
webcomponent\config\admin\group\dm_member_actions.xml

Scope

entitlement collaboration6
type dm_member_user

632 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
addgroupmembership (type dm_restriction)

Elements
None.

addgroupmembership (type dm_restriction)

Purpose
Adds a user or group to a group that has restricted access. Trusted Content Services must be enabled
in the repository.

Parameters

accessorName (Required) Name of user or group


objectId (Optional) ID of the ACL (permission set)

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope

type dm_restriction

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 633
addprocessorauthentication

addprocessorauthentication

Purpose
Sets the skill level and authorized document profiles for a new work queue processor

Parameters

multiselect (Optional) Set to true to allow multiple selection

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\userprofile_actions.xml

Scope
All.

Elements
None.

addrequiredgroup

Purpose
Adds a group of users to an ACL. A user must belong to that group in order to satisfy any security
check with that ACL (Requires that Trusted Content Services be enabled in the repository.)

634 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
addrequiredgroupset

Parameters

flatlist (Optional) Boolean: True to list all objects in a


flat list, false to display a drop down list.
multiselect (Required) Boolean: True to support multiple
object selection
objecttype (Optional) Type of the selected object
permit (Optional) Set of working and new permits. Valid
values: DELETE_PERMIT | WRITE_PERMIT
| VERSION_PERMIT | RELATE_PERMIT
| READ_PERMIT | BROWSE_PERMIT |
NONE_PERMIT
roomId (Optional) ID of a room, in the case of a room
ACL

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

addrequiredgroupset

Purpose
Creates a set of groups. A user must belong to one of the groups in order to satisfy any security check
with that ACL (Requires that Trusted Content Services be enabled in the repository.)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 635
adduserorgroup (type grouplist)

Parameters

flatlist (Optional) Boolean: true to list all objects in a flat


list, false to display a drop down list.
multiselect (Required) Boolean: true to support multiple
object selection
objecttype (Optional) Type of the selected object
permit (Optional) Set of working and new permits. Valid
values: DELETE_PERMIT | WRITE_PERMIT
| VERSION_PERMIT | RELATE_PERMIT
| READ_PERMIT | BROWSE_PERMIT |
NONE_PERMIT
roomId (Optional) ID of the room, in the case of a room
ACL

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

adduserorgroup (type grouplist)

Purpose
Adds a user or group to the repository

636 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
adminbrowse (type dm_group)

Parameters

flatlist (Optional) Boolean: true to list all objects in a flat


list, false to display a drop down list.
multiselect (Optional) Boolean: true to support multiple
object selection
objecttype (Optional) Type of the selected object

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\grouplist_actions.xml

Scope

type grouplist

Elements
None.

adminbrowse (type dm_group)

Purpose
Allows the administrator to browse a list of group administrators in a repository.

Parameters
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 637
groupbrowse (privilege sysadmin, type dm_user)

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\dm_group_actions.xml

Scope

type dm_group

Elements
None.

groupbrowse (privilege sysadmin, type dm_user)

Purpose
Allows the administrator to browse a list of groups in a repository.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

638 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
groupbrowse (type dm_group)

Scope

privilege sysadmin
type dm_user

Elements
None.

groupbrowse (type dm_group)

Purpose
Allows the administrator to browse a list of groups in a repository.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\admin\group\dm_group_actions.xml

Scope

type dm_group

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 639
groupreassign (type dm_group)

groupreassign (type dm_group)

Purpose
Renames a group

Parameters

objectId (Required) ID of the selected group.


objectname (Required) Name of the group.

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\dm_group_actions.xml

Scope

type dm_group

Elements
None.

groupreassign (type dm_member_group)

Purpose
Renames a group.

640 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
grouprenamelog (type dm_group)

Parameters

objectId (Required) ID of the selected group.


objectname (Required) Name of the group.

Description

Since
5.x

Configuration File
webcomponent\config\admin\group\dm_member_actions.xml

Scope

type dm_member_group

Elements
None.

grouprenamelog (type dm_group)

Purpose
Displays requests for renaming groups.

Parameters

renametarget (Optional) Type of objects requested for rename.


Valid values: USER | GROUP

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 641
newgroup (privilege creategroup, type dm_group)

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\dm_group_actions.xml

Scope

type dm_group

Elements
None.

newgroup (privilege creategroup, type dm_group)

Purpose
Creates a new group in the repository.

Parameters

objectId (Required) Must have a value of newobject to


create a new group.
objectname (Required) Name of the group.

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\dm_group_actions.xml

642 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newrole (privilege creategroup, type dm_role)

Scope

privilege creategroup
type dm_group

Elements
None.

newrole (privilege creategroup, type dm_role)

Purpose
Creates a new role in the repository (dm_group object with attributes group_class=ʺroleʺ and
group_name=ʺ role_nameʺ).

Parameters

objectId (Required) ID of the selected role. Set to


newobject to create a new role.
objectname (Required) Name of the role.

Description
Since
5.x

Configuration File
webcomponent\config\admin\role\dm_role_actions.xml

Scope

privilege creategroup
type dm_role

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 643
newuser (privilege sysadmin, type dm_user)

Elements
None.

newuser (privilege sysadmin, type dm_user)

Purpose
Creates a new user in the repository

Parameters

objectId (Required) ID of the selected user. Set to


newobject to create a new user.
objectname (Required) Name of the user.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

privilege sysadmin
type dm_user

Elements
None.

644 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
ownerbrowse (type dm_group)

ownerbrowse (type dm_group)

Purpose
Allows the administrator to browse a list of group owners in the repository.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\dm_group_actions.xml

Scope

type dm_group

Elements
None.

properties (type dm_group)

Purpose
Displays the properties for the repository group or creates a new group.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 645
properties (type dm_member_group)

Parameters

objectId (Required) ID of the selected group. Set to


newobject to create a new group.
objectname (Required) Name of the group.

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\dm_group_actions.xml

Scope

type dm_group

Elements
None.

properties (type dm_member_group)

Purpose
Displays the properties of a dm_member_group object.

Parameters

objectId (Required) ID of the group for which to display


properties
objectname (Required) Name of group

646 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
properties (type dm_member_user, entitlement collaboration6)

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\dm_member_actions.xml

Scope

type dm_member_group

Elements
None.

properties (type dm_member_user, entitlement


collaboration6)

Purpose
Displays the properties of a dm_member_user object. Requires a Documentum Collaborative Services
license.

Parameters

objectId (Required) ID of the user.


objectname (Required) Name of user

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\dm_member_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 647
properties (type dm_user)

Scope

type dm_member_user
entitlement collaboration6

Elements
None.

properties (type dm_user)

Purpose
Displays properties for a selected user.

Parameters

objectId (Required) ID of the selected user. Set to


newobject to create a new user.
objectname (Required) Name of the user.

Description

Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

type dm_user

Elements
None.

648 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reassignuser (privilege superuser, type dm_user)

reassignuser (privilege superuser, type dm_user)

Purpose
Renames a user.

Parameters

objectId (Required) Object ID of the user to reassign.


objectname (Required) The name of the user.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

privilege superuser
type dm_user

Elements
None.

reassignuser (type dm_member_user)

Purpose
Renames a user.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 649
removerequiredgroup

Parameters

objectId (Required) ID of the selected user. Set to


newobject to create a new user.
objectname (Required) Name of the user.

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\dm_member_actions.xml

Scope

type dm_member_user

Elements
None.

removerequiredgroup

Purpose
Removes a group requirement from an ACL. (Requires that Trusted Content Services be enabled in
the repository.)

650 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
removerequiredgroupset

Parameters

accessorName (Required) Group to be removed from ACL


permitType (Optional) Valid types of IDfPermit:
DF_ACCESS_PERMIT DF_EXTENDED_
PERMIT DF_APPLICATION_PERMIT
DF_ACCESS_RESTRICTION DF_EXTENDED_
RESTRICTION DF_APPLICATION_
RESTRICTION DF_REQUIRED_GROUP
DF_REQUIRED_GROUP_SET

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope
All.

removerequiredgroupset

Purpose
Removes a set of required groups from an ACL. (Requires that Trusted Content Services be enabled in
the repository.)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 651
removeuserorgroup (type dm_member_group)

Parameters

accessorName (Required) Name of group set to remove


permitType (Optional) Valid types of IDfPermit:
DF_ACCESS_PERMIT=0DF_EXTENDED_
PERMIT = 1, DF_APPLICATION_PERMIT
= 2, DF_ACCESS_RESTRICTION = 3,
DF_EXTENDED_RESTRICTION = 4,
DF_APPLICATION_RESTRICTION
= 5, DF_REQUIRED_GROUP = 6,
DF_REQUIRED_GROUP_SET = 7

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acl_actions.xml

Scope
All.

removeuserorgroup (type dm_member_group)

Purpose
Allows the administrator to remove a group from the repository

Parameters

groupId (Required) ID of the group to remove.

652 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
removeuserorgroup (type dm_member_user)

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\dm_member_actions.xml

Scope

type dm_member_group

Elements
None.

removeuserorgroup (type dm_member_user)

Purpose
Allows the administrator to remove a user from the repository

Parameters

groupId (Required) ID of the user to remove.

Description

Since
5.x

Configuration File
webcomponent\config\admin\group\dm_member_actions.xml

Scope

type dm_member_user

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 653
selectuser (type selectuser)

Elements
None.

selectuser (type selectuser)

Purpose
Selects a user

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\selectuser_action.xml

Scope

type selectuser

Elements
None.

userbrowse (privilege sysadmin, type dm_user)

Purpose
Allows the administrator to browse a list of users in the repository

654 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
userimport (privilege sysadmin, type dm_user)

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

privilege sysadmin
type dm_user

Elements
None.

userimport (privilege sysadmin, type dm_user)

Purpose
Imports a user from another repository in the domain

Parameters
None.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 655
userorgroupchooser

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

privilege sysadmin
type dm_user

Elements
None.

userorgroupchooser

Purpose
Displays a locator component for selecting users or groups for use with work queues

Parameters

groupName (Optional) Name of group from which to locate a


member user or group

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\queue_actions.xml

Scope
All.

Elements
None.

656 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
userrenamelog (type dm_user)

userrenamelog (type dm_user)

Purpose
Displays job requests for renaming users.

Parameters

renametarget (Optional) Type of objects requested for rename.


Valid values: USER | GROUP

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\dm_user_actions.xml

Scope

type dm_user

Elements
None.

viewreport (type dm_rename_log)

Purpose
Displays a selected job report for a user or group rename or user change home repository job.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 657
addcomponent (type dm_sysobject)

Parameters

objectId (Required) Job request ID.


oldname (Optional) Old name of user or group

Description

Since
5.x

Configuration File
webcomponent\config\admin\renamelog\renamelog_actions.xml

Scope

type dm_rename_log

Elements
None.

Virtual documents

addcomponent (type dm_sysobject)

Purpose
Adds a child node to a virtual document. The child object must be in the same repository.

658 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
addcomponent (type dm_sysobject)

Parameters

compoundArchitecture (Optional) Boolean specifying whether the object


is a compound virtual document
insertAfterNodeId (Optional) ID of the virtual document node after
which the new node is added
lockOwner (Optional) User who has checked out the root
object
newNodeIds (Optional)
newNodeObjectIds (Required) IDs of the objects to be added to the
virtual document.
newVDRootNodeIds (Optional)
nodeId (Optional) Node ID of the parent node for the
new object.
objectId (Required) Object ID of the parent node for the
new object.
preconditionShouldDisplayErrors (Optional) Set to true to display errors when the
precondition criteria are not met.
vdmRootObjectId (Optional) Object ID of the root of the virtual
document.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 659
addcomponentfromclipboard (type dm_sysobject)

addcomponentfromclipboard (type dm_sysobject)

Purpose
Adds a child node to a virtual document from the clipboard

Parameters

compoundArchitecture (Optional) Boolean specifying whether the object


is a compound virtual document
lockOwner (Optional) User who has checked out the root
object
nodeId (Optional) ID of the object to be added as a child
node
objectId (Required) Parent node.
vdmRootObjectId (Optional) Object ID of the root of a virtual
document (when operating on a child node).

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

660 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
addcomponentfromfileselector (type dm_sysobject)

addcomponentfromfileselector (type dm_sysobject)

Purpose
Adds a child node to a virtual document from the file selector.

Parameters

compoundArchitecture (Optional) Boolean specifying whether the object


is a compound virtual document
lockOwner (Optional) User who has checked out the root
object
nodeId (Optional) ID of the object to be added as a child
node
objectId (Required) Parent node.
vdmRootObjectId (Optional) Object ID of the root of a virtual
document (when operating on a child node).

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 661
addnewvirtualdocumentnode (type dm_sysobject)

addnewvirtualdocumentnode (type dm_sysobject)

Purpose
Create content and add it to a virtual document

Parameters

compoundArchitecture (Optional) Boolean specifying whether the object


is a compound virtual document
lockOwner (Optional) User who has checked out the object
nodeId (Optional) Node ID of the parent for the new
content.
objectId (Required) Object ID of the parent for the new
content.
ownerName (Optional) Owner of the object, evaluated by the
role precondition
vdmRootObjectId (Optional) Object ID of the root of the virtual
document.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

662 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
assemblylist (type dm_sysobject)

assemblylist (type dm_sysobject)

Purpose
Displays the structure of a virtual document snapshot.

Parameters
The parameters are inherited from viewassembly:webcomponent/config/actions/dm_sysobject_
actions.xml. See viewassembly (type dm_sysobject), page 690.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Parent Definition
viewassembly:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

assemblylist (type dm_sysobject) (Webtop)

Purpose
Calls the main (Webtop), page 900 or assemblylist (Webtop), page 1535 component to display the
structure of a virtual document snapshot.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 663
assemblyliststreamline (type dm_sysobject)

Parameters
The parameters are inherited from viewassembly:webcomponent/config/actions/dm_sysobject_
actions.xml. See viewassembly (type dm_sysobject), page 690.

Description

Since
5.x

Configuration File
webtop\config\dm_sysobject_actions.xml

Parent Definition
assemblylist:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

assemblyliststreamline (type dm_sysobject)

Purpose
Displays the structure of a virtual document snapshot in drilldown (streamline) view.

Parameters
The parameters are inherited from streamlineviewassembly:webcomponent/config/actions/dm_
sysobject_actions.xml. See streamlineviewassembly (type dm_sysobject), page 679.

664 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
assemblyliststreamline (type dm_sysobject) (Webtop)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Parent Definition
streamlineviewassembly:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

assemblyliststreamline (type dm_sysobject)


(Webtop)

Purpose
Calls the assemblyliststreamline, page 1536 component.

Parameters
The parameters are inherited from streamlineviewassembly:webcomponent/config/actions/dm_
sysobject_actions.xml. See streamlineviewassembly (type dm_sysobject), page 679.

Description
Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 665
freezeassembly (type dm_sysobject)

Configuration File
webtop\config\dm_sysobject_actions.xml

Parent Definition
assemblyliststreamline:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

freezeassembly (type dm_sysobject)

Purpose
Freezes a virtual document snapshot. The user must have a contributor role.

Parameters

assembledFromId (Optional) ID of the parent virtual document, if


any
isFrozenAssembly (Optional) Boolean parameter that specifies
whether the snapshot to be frozen is already
frozen
lockOwner (Optional) User who has checked out the
snapshot
objectId (Required) ID of the virtual document.
ownerName (Optional) User who owns the snapshot

666 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
makesimple (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

makesimple (type dm_sysobject)

Purpose
Converts a virtual document to a simple document if the document has no child nodes.

Parameters

isReference (Optional) Boolean flag that indicates whether


the object is a reference object
isVirtualDoc (Optional) Boolean flag that specifies whether
the object is a virtual document (required for
pre‑4.1 repository virtual documents)
linkCount (Optional) Number of links (child nodes) in a
document. If greater than 0, the document is a
virtual document.
lockOwner (Optional) User who has checked out the object
objectId (Required) ID of the object to be converted into a
virtual document.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 667
makevirtual (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

makevirtual (type dm_sysobject)

Purpose
Converts a simple object to a virtual document.

Parameters

isReference (Optional) Boolean flag that indicates whether


the object is a reference object
isVirtualDoc (Optional) Boolean flag that specifies whether
the object is a virtual document (required for
pre‑4.1 repository virtual documents)
linkCount (Optional) Number of links (child nodes) in a
document. If greater than 0, the document is a
virtual document.
lockOwner (Optional) User who has checked out the object
objectId (Required) ID of the object to be converted into a
virtual document.

668 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newassembly (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

newassembly (type dm_sysobject)

Purpose
Creates a new virtual document snapshot. The user must have a contributor role assigned in the
repository.

Parameters

folderId (Optional) ID of the folder in which to create the


assembly
linkCount (Optional) Number of links (child nodes) in a
document. If greater than 0, the document is a
virtual document.
objectId (Required) ID of the virtual document.
ownerName (Optional) Owner of virtual document. Used by
role precondition to determine whether user can
create an assembly.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 669
newvirtualdocumentnode (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

newvirtualdocumentnode (type dm_sysobject)

Purpose
Adds content to a virtual document

Parameters

editAfterCreate (Optional) Set to true to opening editing


application after creating the new node
objectId (Required) Object ID of the object to add to the
virtual document.
ownerName (Optional) Owner of virtual document. Used by
role precondition to determine whether user can
add a node.

Description
Since
5.x

670 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
openassembly (type dm_sysobject)

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

openassembly (type dm_sysobject)

Purpose
Opens a virtual document assembly (snapshot) in the virtual document editor

Parameters

contentSize (Optional) Size of the object in bytes


contentType (Optional) File format to use when opening the
object (passed to the operating system)
isReference (Optional) Boolean flag that indicates whether
the object is a reference object
launchViewer (Optional) Boolean flag that indicates whether to
launch a viewing application.
nodeId (Optional) ID of the node in a virtual document
objectId (Required) ID of the object to be viewed.
pathInfo (Optional) Path to be displayed in the
breadcrumb
selectedNodeIds (Optional) Comma‑separated list of nodeIds that
should be initially selected when the vdmlist
component is first displayed
structureComponent (Optional) Name of the component that displays
virtual document structure

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 671
openvirtualdocument (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

openvirtualdocument (type dm_sysobject)

Purpose
Opens a virtual document in the virtual document structure viewing component.

Parameters

contentSize (Optional) Size of the object in bytes


contentType (Optional) File format to use when opening the
object (passed to the operating system)
isReference (Optional) Boolean flag that indicates whether
the object is a reference object
launchViewer (Optional) Boolean flag that indicates whether to
launch a viewing application.
nodeId (Optional) ID of the node in a virtual document
objectId (Required) ID of the object to be viewed.
pathInfo (Optional) Path to be displayed in the
breadcrumb

672 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
removecomponent (type dm_sysobject)

selectedNodeIds (Optional) Comma‑separated list of nodeIds that


should be initially selected when the vdmlist
component is first displayed
structureComponent (Optional) Name of the component that displays
virtual document structure

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

removecomponent (type dm_sysobject)

Purpose
Removes a component document of dm_sysobject type from a virtual document.

Parameters

isCurrentVDMNode (Optional) Set to true if the object to be removed


is the current virtual document node (node
cannot delete itself).
nodeId (Optional) ID of the node to be removed from
the virtual document.
objectId (Required) ID of the object to be removed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 673
removevirtualdocumentnode (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

removevirtualdocumentnode (type dm_sysobject)

Purpose
Removes a node from a virtual document

Parameters

isCurrentVDMNode (Optional) Set to true if the object to be removed


is the current virtual document node (node
cannot delete itself)
nodeId (Required) ID of the node to be removed
vdmRootObjectId (Required) ID of the virtual document root

Description
Since
5.x

674 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reordercomponents (type dm_sysobject)

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

reordercomponents (type dm_sysobject)

Purpose
Changes the order of nodes in a virtual document

Parameters

compoundArchitecture (Optional) Boolean specifying whether the object


is a compound virtual document
isVirtualDoc (Optional) Boolean flag that specifies whether
the object is a virtual document (required for
pre‑4.1 repository virtual documents)
linkCount (Optional) Number of links (child nodes) in a
document. If greater than 0, the document is a
virtual document.
lockOwner (Optional) User who has checked out the object
nodeId (Optional) ID of the child node to be removed
objectId (Required) ID of the object to be converted into a
virtual document.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 675
reordervirtualdocumentnodes (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

reordervirtualdocumentnodes (type dm_sysobject)

Purpose
Changes the order of nodes in a virtual document

Parameters

nodeId (Required) ID of the node to be changed


vdmRootObjectId (Required) ID of the virtual document root node

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

676 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
repositioncomponent (type dm_sysobject)

Scope

type dm_sysobject

Elements
None.

repositioncomponent (type dm_sysobject)

Purpose
Rearranges the structure of a virtual document

Parameters

insertAfterNodeId (Optional) ID of the virtual document node after


which to move the object.
nodeId (Required) Node ID of the current parent node
for the object.
preconditionShouldDisplayErrors (Optional) Set to true to display errors on
evaluation of the precondition
targetParentNodeId (Required) Node ID of the new parent node for
the object.
vdmRootObjectId (Required) Object ID of the root of the virtual
document.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 677
savechanges

Scope

type dm_sysobject

Elements
None.

savechanges

Purpose
Saves changes made to a virtual document structure

Parameters

closeUponCompletion (Optional) Set to true to close virtual document


structure after saving
objectId (Optional) Object ID of the virtual document to
save.
ownerName (Optional) Owner of the virtual document

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
None.

678 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
setbindingrule (type dm_sysobject)

setbindingrule (type dm_sysobject)

Purpose
Allows a user to set a binding rule on a virtual document node. The setbindingrule precondition
determines that the selected object is a virtual document node. Also, the precondition checks that the
user has at least version permission on the virtual document parent node.

Parameters

nodeId (Required) ID of the document node on which to


set a binding rule.
vdmRootObjectId (Required) ID of virtual document root

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

streamlineviewassembly (type dm_sysobject)

Purpose
Displays in drilldown (streamline) view a list of virtual document snapshots for the selected object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 679
streamlineviewvirtualdoc (type dm_sysobject)

Parameters

assembledFromId (Optional) ID of the virtual document from


which the assembly was assembled
isLaunchedFromDRL (Optional) Boolean: Whether the virtual
document was displayed from a DRL (True) or
not (False).Since 6.0.
objectId (Required) ID of the assembly

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

streamlineviewvirtualdoc (type dm_sysobject)

Purpose
Displays a virtual document in the drilldown view.

680 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
streamlineviewvirtualdoc (type dm_sysobject)

Parameters

isCurrentVDMNode (Optional) Boolean flag that specifies whether


the node is the root node of the current virtual
document. The menu item to remove a node is
disabled if the node is the root node.
isLaunchedFromDRL (Optional) Boolean: Whether the virtual
document was displayed from a DRL (True) or
not (False).Since 6.0.
isVirtualDoc (Optional) Boolean flag that specifies whether
the object is a virtual document (required for
pre‑4.1 repository virtual documents)
linkCount (Optional) Number of links (child nodes) in a
document. If greater than 0, the document is a
virtual document.
objectId (Required) ID of the virtual document.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 681
unfreezeassembly (type dm_sysobject)

unfreezeassembly (type dm_sysobject)

Purpose
Unfreezes a frozen virtual document snapshot. The user must have a contributor role assigned in the
repository.

Parameters

isFrozenAssembly (Optional) Boolean parameter that specifies


whether the snapshot to be unfrozen is frozen
lockOwner (Optional) User who has checked out the
snapshot
objectId (Required) ID of the virtual document snapshot.
ownerName (Optional) User who owns the snapshot

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

682 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
vdmclickactionprompt (type dm_sysobject)

vdmclickactionprompt (type dm_sysobject)

Purpose
Displays a dialog box allowing the user to view a virtual document structure or edit the document.

Parameters

contentSize (Optional) Size of the object in bytes


contentType (Optional) File format to use when opening the
object (passed to the operating system)
isLaunchedFromDRL (Optional) Boolean: Whether the virtual
document was displayed from a DRL (True) or
not (False).Since 6.0.
isReference (Optional) Boolean flag that indicates whether
the object is a reference object
launchViewer (Optional) Boolean flag that indicates whether to
launch a viewing application.
nodeId (Optional) ID of the node in a virtual document
objectId (Required) ID of the object to be viewed.
pathInfo (Optional) Path to be displayed in the
breadcrumb
selectedNodeIds (Optional) Comma‑separated list of nodeIds that
should be initially selected when the vdmlist
component is first displayed
structureComponent (Optional) Name of component to be used for
displaying the virtual document structure
useAssembly (Optional) Set to true to display a list of
assemblies.Set to false to display a list of virtual
documents.

Description
Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 683
vdmcopyoption (type dm_sysobject)

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

vdmcopyoption (type dm_sysobject)

Purpose
Presents the user with options for the type of copy operation on a virtual document

Parameters

objectName (Required) Name of the object that will be copied.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

684 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
vdmlist (type dm_sysobject)

vdmlist (type dm_sysobject)

Purpose
Displays a list of virtual documents in a list view

Parameters
The parameters are inherited from viewvirtualdoc:webcomponent/config/actions/dm_sysobject_
actions.xml. See viewvirtualdoc (type dm_sysobject), page 692.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Parent Definition
viewvirtualdoc:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

vdmlist (type dm_sysobject) (Webtop)

Purpose
Extends the WDK vdmlist component and adds support for the classic view. Displays the structure of
a virtual document. The user can navigate to the different parts of the virtual document by clicking
on the breadcrumb or the child node.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 685
vdmliststreamline (type dm_sysobject)

Parameters
The parameters are inherited from viewvirtualdoc:webcomponent/config/actions/dm_sysobject_
actions.xml. See viewvirtualdoc (type dm_sysobject), page 692.

Description

Since
5.x

Configuration File
webtop\config\dm_sysobject_actions.xml

Parent Definition
vdmlist:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

vdmliststreamline (type dm_sysobject)

Purpose
Displays a list of virtual documents in a streamline (drilldown) view

Parameters
The parameters are inherited from streamlineviewvirtualdoc:webcomponent/config/actions/dm_
sysobject_actions.xml. See streamlineviewvirtualdoc (type dm_sysobject), page 680.

686 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
vdmliststreamline (type dm_sysobject) (Webtop)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Parent Definition
streamlineviewvirtualdoc:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

vdmliststreamline (type dm_sysobject) (Webtop)

Purpose
Provides a streamline view of virtual documents. Both the vdmlist components provide a UI that
displays the children and root in a virtual document, allows navigation through the virtual document’s
hierarchy, and displays menus to launch actions on selected items.

Parameters
The parameters are inherited from streamlineviewvirtualdoc:webcomponent/config/actions/dm_
sysobject_actions.xml. See streamlineviewvirtualdoc (type dm_sysobject), page 680.

Description
Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 687
vdmvalidate (type dm_sysobject)

Configuration File
webtop\config\dm_sysobject_actions.xml

Parent Definition
vdmliststreamline:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

vdmvalidate (type dm_sysobject)

Purpose
Calls the vdmvalidate, page 1565 component and the vdmvalidate_container, page 1566 container to
validate a virtual document.

Parameters

compoundArchitecture (Optional) Compound document type of the


virtual document.
nodeId (Required) Node ID of the virtual document
node to validate.
objectId (Required) Object ID of the object to validate.
vdmRootObjectId (Required) Object ID of the root of the virtual
document.

Description
Since
6.0

688 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
viewassemblies (type dm_sysobject)

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

viewassemblies (type dm_sysobject)

Purpose
View all assemblies generated from a virtual document

Parameters

assembledFromId (Optional) ID of the virtual document from


which the assembly was assembled
folderId (Optional) ID of folder containing the virtual
document
folderPath (Optional) Path to folder containing the virtual
document
isVirtualDoc (Optional) Boolean flag that specifies whether
the object is a virtual document (required for
pre‑4.1 repository virtual documents)
linkCount (Optional) Number of links (child nodes) in a
document. If greater than 0, the document is a
virtual document.
objectId (Required) ID of the virtual document for which
to display assemblies

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 689
viewassembly (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

viewassembly (type dm_sysobject)

Purpose
View an assembly object

Parameters

assembledFromId (Optional) ID of the virtual document from


which the assembly was assembled
isLaunchedFromDRL (Optional) Boolean: Whether the assembly was
displayed from a DRL (True) or not (False).Since
6.0.
objectId (Required) Object ID of the selected object.

Description
Since
5.x

690 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
viewvdm (type dm_sysobject)

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

viewvdm (type dm_sysobject)

Purpose
Displays a virtual document tree

Parameters

isCurrentVDMNode (Optional) Set to true if user has selected the


current node for viewing
isVirtualDoc (Optional) Boolean flag that specifies whether
the object is a virtual document (required for
pre‑4.1 repository virtual documents)
linkCount (Optional) Number of links (child nodes) in a
document.If greater than 0, the document is a
virtual document.
objectId (Required) ID of the virtual document.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 691
viewvirtualdoc (type dm_sysobject)

Scope

type dm_sysobject

Elements
None.

viewvirtualdoc (type dm_sysobject)

Purpose
Displays a virtual document in the objectlist view

Parameters

isCurrentVDMNode (Optional) Boolean flag that specifies whether


the node is the root node of the current virtual
document. The menu item to remove a node is
disabled if the node is the root node.
isLaunchedFromDRL (Optional) Boolean: Whether the virtual
document was displayed from a DRL (True) or
not (False).Since 6.0.
isVirtualDoc (Optional) Boolean flag that specifies whether
the object is a virtual document (required for
pre‑4.1 repository virtual documents)
linkCount (Optional) Number of links (child nodes) in a
document. If greater than 0, the document is a
virtual document.
objectId (Required) ID of the virtual document.

Description

Since
5.x

692 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
abortfailedautoworkflowtask (type dm_task)

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

Workflows

abortfailedautoworkflowtask (type dm_task)

Purpose
Aborts a failed automatic workflow task.

Parameters

canCompleteTask (Optional) Specifies that the task is active and


can be completed.
isFailedAutoTask (Optional) Specifies that an automatic task has
failed and can be re‑run.
objectId (Required) ID of the task.
userCost (Optional) Customer‑defined cost data, stored as
double in Server. Can be audited and summed
up for completed workflows.
userTime (Optional) Customer‑defined time data, stored
as integer in Server. Can be audited and summed
up for completed workflows.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 693
abortworkflow (type dm_workflow)

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\taskmgr_actions.xml

Scope

type dm_task

Elements
None.

abortworkflow (type dm_workflow)

Purpose
Aborts a workflow.

Parameters

objectId (Required) ID of the workflow.


supervisor (Optional) User name of workflow supervisor
workflowRuntimeState (Required) State of the workflow. 0=dormant |
1=running | 2=finished | 3=halted | 4=terminated

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_workflow_actions.xml

694 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
acceptworkflowtask (type dm_task)

Scope

type dm_workflow

Elements
None.

acceptworkflowtask (type dm_task)

Purpose
Accepts a workflow task for the user.

Parameters

canAcquireTask (Optional) Boolean flag that indicates that the


task is in a state such that it can be acquired (not
paused, already acquired, or finished)
isGroupOwned (Optional) Boolean flag that indicates that the
task is assigned to a group of which the user is
a member
objectId (Required) ID of the task.

Description

Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\taskmgr_actions.xml

Scope

type dm_task

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 695
addattachment (type dmi_package)

Elements
None.

addattachment (type dmi_package)

Purpose
Adds an attachment to a workflow package

Parameters

formTemplateId (Optional) ID of the XForm template


objectId (Required) Task ID
objecttype (Optional) Type of the attachment object
packageName (Required) Name of the workflow package
runtimeState (Required) State of the workflow. 0=dormant
| 1=running | 2=finished | 3=halted |
4=terminated. Only 0 or 1 can be suspended.
versionlabel (Optional) Version label for the attachment

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmi_package_actions.xml

Scope

type dmi_package

Elements
None.

696 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
addwfattachment

addwfattachment

Purpose
Adds an ad hoc attachment to a workflow

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
None.

attributes (type workflow_calendar)

Purpose
Attributes of a workflow business calendar.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 697
cancelcheckout (type dm_process)

Parameters

actiontype (Optional) Not used.

objectId (Required) ID of the workflow business calendar.


objectName (Optional) Object name of the workflow business
calendar.

Description
Since
6.0 SP1

Configuration File
webcomponent\config\library\workflow\calendar\workflow_calendar_actions.xml

Scope

type workflow_calendar

Elements
None.

cancelcheckout (type dm_process)

Purpose
Cancels the checked out status of an object. The user must have version level permission (valid values:
DELETE_PERMIT | WRITE_PERMIT | VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT |
BROWSE_PERMIT | NONE_PERMIT).

Parameters
The parameters are inherited from cancelcheckout:webcomponent/config/actions/dm_sysobject_
actions.xml. See cancelcheckout (type dm_sysobject), page 465.

698 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
changeperformer (type dm_task)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_process_actions.xml

Parent Definition
cancelcheckout:webcomponent/config/actions/dm_sysobject_actions.xml

Scope

type dm_process

Elements
None.

changeperformer (type dm_task)

Purpose
Changes the performer of a future task in a workflow

Parameters

objectName (Required) Activity name of the future task.


supervisor (Optional) Workflow supervisor
taskRuntimeFlag (Required) State of the workflow task. Valid
values: 0=dormant | 1=acquired | 2=finished |
3‑6 =paused | 7=ready
workflowId (Required) ID of the workflow.
workflowRuntimeState (Required) State of the workflow activity. Valid
values: 0=dormant | 1=running | 2=finished |
3=halted | 4=terminated

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 699
changesupervisor (type dm_workflow)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_task_actions.xml

Scope

type dm_task

Elements
None.

changesupervisor (type dm_workflow)

Purpose
Changes the supervisor of a workflow.

Parameters

objectId (Required) ID of the workflow.


workflowRuntimeState (Required) State of the workflow activity. Valid
values: 0=dormant | 1=running | 2=finished |
3=halted | 4=terminated

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_workflow_actions.xml

700 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
comment (type dm_process)

Scope

type dm_workflow

Elements
None.

comment (type dm_process)

Purpose
Adds a comment to a workflow template

Parameters

objectId (Required) ID of the template


startworkflowId (Required) Component ID of the task manager
component to be displayed as the first tab in the
container.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_process_actions.xml

Scope

type dm_process

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 701
comment (type dm_task)

comment (type dm_task)

Purpose
Adds a comment to a workflow task.

Parameters

objectId (Required) ID of the task


taskmanagerId (Required) Component ID of the task manager
component.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_task_actions.xml

Scope

type dm_task

Elements
None.

commitchanges (type dm_sysobject)

Purpose
Asks the user whether to save changes to a virtual document before displaying it. Called by the
vdmviewcomponent when a user views a virtual document that has been checked out.

702 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
completefailedautoworkflowtask (type dm_task)

Parameters

lockOwner (Optional) User who has checked out the object


objectId (Required) ID of the template
ownerName (Optional) Name of the person who created the
document

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

completefailedautoworkflowtask (type dm_task)

Purpose
Completes a failed automatic workflow task.

Parameters

canCompleteTask (Optional) Specifies that the task is active and


can be completed.
isFailedAutoTask (Optional) Specifies that an automatic task has
failed and can be re‑run.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 703
delegateworkflowtask (type dm_task)

objectId (Required) ID of the task.


userCost (Optional) Customer‑defined cost data, stored as
double in Server. Can be audited and summed
up for completed workflows.
userTime (Optional) Customer‑defined time data, stored
as integer in Server. Can be audited and summed
up for completed workflows.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\taskmgr_actions.xml

Scope

type dm_task

Elements
None.

delegateworkflowtask (type dm_task)

Purpose
Delegates a task in a workflow.

Parameters

canCompleteTask (Optional) Specifies that the task is active and


can be completed.
isDelegable (Optional) True to specify that the task can be
delegated

704 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (type dm_activity)

isFailedAutoTask (Optional) Specifies that an automatic task has


failed and can be re‑run.
objectId (Required) ID of the task.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\taskmgr_actions.xml

Scope

type dm_task

Elements
None.

delete (type dm_activity)

Purpose
Deletes one or more activity objects. The user must have a role of contributor.

Parameters

folderId (Optional) The ID of the folder in which the


object is located
lockOwner (Optional) User who has checked out the object
objectId (Required) The ID of the object to be deleted.
ownerName (Optional) The name of the user who owns the
object to be deleted

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 705
delete (type dm_process)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_activity_actions.xml

Scope

type dm_activity

Elements
None.

delete (type dm_process)

Purpose
Deletes one or more workflow templates. The user must have a role of contributor.

Parameters

folderId (Optional) The ID of the folder in which the


workflow template is located
lockOwner (Optional) User who has checked out the
workflow template
objectId (Required) The ID of the workflow template to
be deleted.
ownerName (Optional) User who owns the workflow
template to be deleted

706 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (type dm_workflow)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_process_actions.xml

Scope

type dm_process

Elements
None.

delete (type dm_workflow)

Purpose
Deletes a workflow object.

Parameters

objectId (Required) The ID of the object to be deleted.


workflowRuntimeState (Required) State of the workflow. 0=dormant |
1=running | 2=finished | 3=halted | 4=terminated

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_workflow_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 707
delete (type workflow_calendar)

Scope

type dm_workflow

Elements
None.

delete (type workflow_calendar)

Purpose
Enables deleting workflow business calendars.

Parameters

objectId (Required) ID of the workflow business calendar.


objectName (Optional) Object name of the workflow business
calendar.

Description
Since
6.0 SP1

Configuration File
webcomponent\config\library\workflow\calendar\workflow_calendar_actions.xml

Scope

type workflow_calendar

Elements
None.

708 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
deletenotification (type dm_notification)

deletenotification (type dm_notification)

Purpose
Deletes a notification from a router.

Parameters

objectId (Required) The ID of the notification.


routerId (Required) ID of the router.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\taskmgr_actions.xml

Scope

type dm_notification

Elements
None.

drlview (type dm_process)

Purpose
Navigates to the parent folder or object of the DRL and opens the workflow template for viewing.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 709
editfile (type dm_process)

Parameters
The parameters are inherited from view:webcomponent/config/actions/dm_process_actions.xml.
See view (type dm_process), page 750.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_process_actions.xml

Parent Definition
view:webcomponent/config/actions/dm_process_actions.xml

Scope

type dm_process

Elements
None.

editfile (type dm_process)

Purpose
Launches the Web Workflow Manager to allow editing of a workflow template. The user must have
version level permission (valid values: DELETE_PERMIT | WRITE_PERMIT |VERSION_PERMIT |
RELATE_PERMIT | READ_PERMIT | BROWSE_PERMIT | NONE_PERMIT). The user must also
have a contributor role.

710 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
editstartwfnote (type dmi_package)

Parameters

objectId (Required) ID of the workflow template. (This is


the only parameter defined for templates.)
ownerName (Optional) User who owns the workflow
template
setError (Optional) Set to true to pass the precondition
error message to the WebcomponentErrorService
as a non‑fatal message

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_process_actions.xml

Scope

type dm_process

Elements
None.

editstartwfnote (type dmi_package)

Purpose
Allows the user to add or edit a task note at the start of a workflow

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 711
edittasknote (type dmi_package)

Parameters

operationType (Required) Type of operations to perform on a


note. Valid values: add | edit | remove.
packageName (Required) Name of the workflow package.
processId (Required) ID of the workflow template

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmi_package_actions.xml

Scope

type dmi_package

Elements
None.

edittasknote (type dmi_package)

Purpose
Allows the user to add, remove, or edit a task note

Parameters

operationType (Required) Type of edit operation: add | edit |


remove
packageName (Required) Name of the workflow package.

712 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
emailperformers (type dm_workflow)

queueItemId (Required) ID of the workflow task, which is


passed as the objectId value to the edittasknote
component.
queueItemState (Required) State of queue item. Valid values:
dormant | acquired | paused | ready | null.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmi_package_actions.xml

Scope

type dmi_package

Elements
None.

emailperformers (type dm_workflow)

Purpose
Calls the container component to send an email to the dm_workflow object performers.

Parameters

objectId (Required) ID of the dm_workflow object.


wfperformers (Required) User names of the workflow
performers.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 713
emailsupervisor (type dm_workflow)

Description
Since
6.0

Configuration File
webcomponent\config\actions\dm_workflow_actions.xml

Scope

type dm_workflow

Elements
None.

emailsupervisor (type dm_workflow)

Purpose
Calls the container component to send an email to the supervisor of the dm_workflow object.

Parameters

objectId (Required) ID of the dm_workflow object.


wfsupervisor (Required) User name of the supervisor of the
dm_workflow object.

Description
Since
6.0

Configuration File
webcomponent\config\actions\dm_workflow_actions.xml

714 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
finishworkflowtask (type dm_task)

Scope

type dm_workflow

Elements
None.

finishworkflowtask (type dm_task)

Purpose
Finishes a workflow task.

Parameters

canCompleteTask (Optional) Specifies that the task is active and


can be completed.
hasEmptyMandatoryPkg (Optional) The task contains an empty package
that must be passed with the task
isFailedAutoTask (Optional) Specifies that an automatic task has
failed and can be re‑run.
isManual (Optional) Specifies whether transition is manual
or automated.
objectId (Required) ID of the task.
userCost (Optional) Customer‑defined cost data, stored as
double in Server. Can be audited and summed
up for completed workflows.
userTime (Optional) Customer‑defined time data, stored
as integer in Server. Can be audited and summed
up for completed workflows.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 715
forwardroutertask (type dm_router_task)

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\taskmgr_actions.xml

Scope

type dm_task

Elements
None.

forwardroutertask (type dm_router_task)

Purpose
Forwards a router task.

Parameters

canCompleteTask (Optional) True to specify that the user can


complete the task
objectId (Required) ID of the router task.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\taskmgr_actions.xml

716 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
forwardworkflowtask (type dm_task)

Scope

type dm_router_task

Elements
None.

forwardworkflowtask (type dm_task)

Purpose
Forwards a task in a workflow.

Parameters

canCompleteTask (Optional) Specifies that the task is active and


can be completed.
hasEmptyMandatoryPkg (Optional) The task contains an empty package
that must be passed with the task
hasForwardPaths (Optional) Boolean flag that specifies whether
there are any remaining paths in the workflow
isManual (Optional) Specifies whether transition is manual
or automated.
objectId (Required) ID of the task.
userCost (Optional) Customer‑defined cost data, stored as
double in Server. Can be audited and summed
up for completed workflows.
userTime (Optional) Customer‑defined time data, stored
as integer in Server. Can be audited and summed
up for completed workflows.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 717
halttask (type dm_task)

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\taskmgr_actions.xml

Scope

type dm_task

Elements
None.

halttask (type dm_task)

Purpose
Halts (pauses) a task in a workflow.

Parameters

objectName (Required) Task name.


taskRuntimeFlag (Required) State of the workflow task. Valid
values: 0=dormant |1=acquired | 2=finished |
3 6 =paused | 7=ready
workitemId (Required) ID of the work item.

Description
Since
5.x

718 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
haltworkflow (type dm_workflow)

Configuration File
webcomponent\config\actions\dm_task_actions.xml

Scope

type dm_task

Elements
None.

haltworkflow (type dm_workflow)

Purpose
Halts a workflow

Parameters

objectId (Required) ID of the workflow.


supervisor (Optional) User name of workflow supervisor
workflowRuntimeState (Required) State of the workflow. 0=dormant |
1=running | 2=finished | 3=halted | 4=terminated

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_workflow_actions.xml

Scope

type dm_workflow

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 719
historicalprocessreport

Elements
None.

historicalprocessreport

Purpose
Creates a report showing historical workflow data.

Parameters

ownerName (Optional) Not used

Description

Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

720 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
historicaluserreport

historicaluserreport

Purpose
Creates a report showing historical workflow data organized by user

Parameters

ownerName (Optional) Not used

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
None.

history (type dm_task)

Purpose
Displays the history of a workflow task.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 721
newprocess (type dm_folder)

Parameters

objectId (Required) ID of the selected object.


taskmanagerId (Required) Component ID of the task manager
component.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_task_actions.xml

Scope

type dm_task

Elements
None.

newprocess (type dm_folder)

Purpose
Creates a new workflow template by launching the Web workflow manager. The user must have a
contributor role. The permit value folder_link_permit performs a check for write permissions on the
folder when folder security is enabled.

722 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newWorkflowCalendar (type workflow_calendar)

Parameters

objectId (Required) ID of the folder in which to create


the template.
ownerName (Optional) Name of the owner of the folder or
cabinet. Used by the NewObjectPrecondition
class to determine whether the action can be
performed.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_folder_actions.xml

Scope

type dm_folder

Elements
None.

newWorkflowCalendar (type workflow_calendar)

Purpose
Creates a new workflow business calendar.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 723
rejectroutertask (type dm_router_task)

Parameters

actiontype (Optional) Name of the action to be performed.


objectId (Required) ID of the workflow business calendar.
objectName (Optional) Object name of the workflow business
calendar.

Description
Since
6.0 SP1

Configuration File
webcomponent\config\library\workflow\calendar\workflow_calendar_actions.xml

Scope

type workflow_calendar

Elements
None.

rejectroutertask (type dm_router_task)

Purpose
Rejects a router.

Parameters

canCompleteTask (Optional) True to specify that the user can


complete the task
objectId (Required) ID of the router task.

724 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
rejectworkflowtask (type dm_task)

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\taskmgr_actions.xml

Scope

type dm_router_task

Elements
None.

rejectworkflowtask (type dm_task)

Purpose
Rejects a task in a workflow

Parameters

canCompleteTask (Optional) Specifies that the task is active and


can be completed.
hasEmptyMandatoryPkg (Optional) The task contains an empty package
that must be passed with the task
hasRejectPaths (Optional) Boolean flag that specifies whether
there are any reject paths in the workflow
isManual (Optional) Specifies whether transition is manual
or automated.
objectId (Required) ID of the task.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 725
removeattachment (type dmi_package)

userCost (Optional) Customer‑defined cost data, stored as


double in Server. Can be audited and summed
up for completed workflows.
userTime (Optional) Customer‑defined time data, stored
as integer in Server. Can be audited and summed
up for completed workflows.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\taskmgr_actions.xml

Scope

type dm_task

Elements
None.

removeattachment (type dmi_package)

Purpose
Removes an attachment from a workflow package

Parameters

attachmentName (Optional) Name of the attachment


isPackageManufactured (Optional) Boolean flag that specifies whether
the package was added in this task or previously

726 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
removestartwfattachment (type dmi_package)

objectId (Required) ID of the workflow task.


packageName (Required) Name of the workflow package.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dmi_package_actions.xml

Scope

type dmi_package

Elements
None.

removestartwfattachment (type dmi_package)

Purpose
Removes an attachment before the workflow has started

Parameters

attachmentName (Optional) Name of the attachment


objectId (Required) ID of the workflow task.
packageName (Required) Name of the workflow package.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 727
removestartwfwfattachment (type dmi_wf_attachment)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmi_package_actions.xml

Scope

type dmi_package

Elements
None.

removestartwfwfattachment (type dmi_wf_


attachment)

Purpose
Removes an attachment before the workflow has started

Parameters

attachmentName (Optional) Name of the attachment to be


removed from the workflow.
docId (Required) ID of the attachment.
objectId (Required) ID of the workflow process.

Description

Since
5.x

728 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
removewfattachment (type dmi_wf_attachment)

Configuration File
webcomponent\config\actions\dmi_wf_attachment_actions.xml

Scope

type dmi_wf_attachment

Elements
None.

removewfattachment (type dmi_wf_attachment)

Purpose
Removes an attachment from a workflow

Parameters

attachmentName (Optional) Name of the attachment to be


removed from the workflow
objectId (Required) ID of the queue item.
packageName (Optional) Name of the workflow package
wf_attachment_id (Required) ID of the attachment to be removed
from the workflow.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmi_wf_attachment_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 729
repeatworkflowtask (type dm_task)

Scope

type dmi_wf_attachment

Elements
None.

repeatworkflowtask (type dm_task)

Purpose
Repeats a task in a workflow

Parameters

canCompleteTask (Optional) Specifies that the task is active and


can be completed.
isFailedAutoTask (Optional) Specifies that an automatic task has
failed and can be re‑run.
isRepeatable (Optional) Boolean flag that specifies whether
a task can be repeated
objectId (Required) ID of the task.
userCost (Optional) Customer‑defined cost data, stored as
double in Server. Can be audited and summed
up for completed workflows.
userTime (Optional) Customer‑defined time data, stored
as integer in Server. Can be audited and summed
up for completed workflows.

Description
Since
5.x

730 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportdetailsauditclassic (type dm_workflow) (Webtop)

Configuration File
webcomponent\config\library\workflow\taskmanager\taskmgr_actions.xml

Scope

type dm_task

Elements
None.

reportdetailsauditclassic (type dm_workflow)


(Webtop)

Purpose
Launches the reportdetailscontainerclassic (type dm_workflow) (Webtop), page 1579 component
, which displays several workflow report components. This action is called by a link in the
reportmainclassic (Webtop), page 1590 component.

Parameters

objectId (Required) ID of the selected workflow.

Description

Since
5.x

Configuration File
webtop\config\dm_workflow_actions.xml

Scope

type dm_workflow

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 731
reportdetailsauditdrilldown (type dm_workflow)

Elements
None.

reportdetailsauditdrilldown (type dm_workflow)

Purpose
Displays several workflow report components.

Parameters

objectId (Required) ID of the selected workflow.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_workflow_actions.xml

Scope

type dm_workflow

Elements
None.

732 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportdetailsauditlist (type dm_workflow)

reportdetailsauditlist (type dm_workflow)

Purpose
Displays several workflow report components.

Parameters

objectId (Required) ID of the selected workflow.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_workflow_actions.xml

Scope

type dm_workflow

Elements
None.

reportdetailsauditstreamline (type dm_workflow)


(Webtop)

Purpose
Launches the component reportdetailscontainerstreamline (type dm_workflow) (Webtop), page
1582, which displays several workflow report components. This action is called by a link in the
reportmainstreamline (Webtop), page 1594 component.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 733
reportdetailsmap (type dm_workflow)

Parameters

objectId (Required) ID of the selected workflow.

Description
Since
5.x

Configuration File
webtop\config\dm_workflow_actions.xml

Scope

type dm_workflow

Elements
None.

reportdetailsmap (type dm_workflow)

Purpose
Displays several workflow report components

Parameters

objectId (Required) ID of the selected workflow.

Description

Since
5.x

734 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportdetailssummarydrilldown (type dm_workflow)

Configuration File
webcomponent\config\actions\dm_workflow_actions.xml

Scope

type dm_workflow

Elements
None.

reportdetailssummarydrilldown (type dm_workflow)

Purpose
Displays several workflow report components

Parameters

objectId (Required) Object ID of the dm_workflow object


to report on.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_workflow_actions.xml

Scope

type dm_workflow

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 735
reportdetailssummarydrilldown (type dm_workflow) (Webtop)

reportdetailssummarydrilldown (type dm_workflow)


(Webtop)

Purpose
Launches the component reportdetailscontainerstreamline (type dm_workflow) (Webtop), page 1582,
which displays several workflow report components. This action is called by a link in the component
reportmainstreamline (Webtop), page 1594.

Parameters

objectId (Required) ID of the selected workflow.

Description
Since
5.x

Configuration File
webtop\config\dm_workflow_actions.xml

Scope

type dm_workflow

Elements
None.

reportdetailssummarylist (type dm_workflow)

Purpose
Displays several workflow report components.

736 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportdetailssummarylist (type dm_workflow) (Webtop)

Parameters

objectId (Required) ID of the selected workflow.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_workflow_actions.xml

Scope

type dm_workflow

Elements
None.

reportdetailssummarylist (type dm_workflow)


(Webtop)

Purpose
Displays several workflow report components. This action is called by a link in the component
reportmain_list.

Parameters

objectId (Required) ID of the selected workflow.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 737
reportmainclassic (Webtop)

Description
Since
5.x

Configuration File
webtop\config\dm_workflow_actions.xml

Scope

type dm_workflow

Elements
None.

reportmainclassic (Webtop)

Purpose
Calls the component reportmainclassic (Webtop), page 1590 and displays a list of workflow instances
and its attributes.

Parameters
None.

Description
Since
5.x

Configuration File
webtop\config\generic_actions.xml

Scope
All.

738 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportmaindrilldown

Elements
None.

reportmaindrilldown

Purpose
Displays a list of workflow instances and their attributes.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
None.

reportmainsettings

Purpose
Displays report settings.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 739
reportmainstreamline (Webtop)

Parameters

documentId (Optional) Specifies a document for which


workflows will be reported
filter (Required) Sets the selected filter. Valid values: 0
= all | 1 = completed | 2 = running
overdueDays (Optional) Specifies the number of days overdue
for which to display a report
overdueOnly (Required) True to filter for overdue task status.
templateId (Optional) Specifies a template for which
workflows will be reported
userName (Required) Name of the user for which to display
workflows.

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
None.

reportmainstreamline (Webtop)

Purpose
Calls the reportmainstreamline (Webtop), page 1594 component and displays a list of workflow
instances and its attributes.

740 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
rerunfailedautoworkflowtask (type dm_task)

Parameters
None.

Description
Since
5.x

Configuration File
webtop\config\generic_actions.xml

Scope
All.

Elements
None.

rerunfailedautoworkflowtask (type dm_task)

Purpose
Reruns a failed automatic workflow task

Parameters

canCompleteTask (Optional) Specifies that the task is active and


can be completed.
isFailedAutoTask (Optional) Specifies that an automatic task has
failed and can be re‑run.
objectId (Required) ID of the task.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 741
resumetask (type dm_task)

userCost (Optional) Customer‑defined cost data, stored as


double in Server. Can be audited and summed
up for completed workflows.
userTime (Optional) Customer‑defined time data, stored
as integer in Server. Can be audited and summed
up for completed workflows.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\taskmgr_actions.xml

Scope

type dm_task

Elements
None.

resumetask (type dm_task)

Purpose
Resumes a task in a workflow that was previously halted

Parameters

objectName (Required) Task name.


taskRuntimeFlag (Required) State of the workflow task. Valid
values: 0=dormant |1=acquired | 2=finished |
3 6 =paused | 7=ready
workitemId (Required) Object ID of the work item to resume.

742 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
resumeworkflow (type dm_workflow)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_task_actions.xml

Scope

type dm_task

Elements
None.

resumeworkflow (type dm_workflow)

Purpose
Resumes a halted workflow

Parameters

objectId (Required) ID of the workflow.


supervisor (Optional) User name of workflow supervisor
workflowRuntimeState (Required) State of the workflow. 0=dormant |
1=running | 2=finished | 3=halted | 4=terminated

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_workflow_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 743
sendlocator (type dm_notification)

Scope

type dm_workflow

Elements
None.

sendlocator (type dm_notification)

Purpose
Sends one or more object locators through email

Parameters

objectId (Required) ID of the object to send.


type (Optional) Specifies the object type. If null, an
object fetch will determine the type.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_notification_actions.xml

Scope

type dm_notification

Elements
None.

744 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
sendlocator (type dm_router_task)

sendlocator (type dm_router_task)

Purpose
Sends one or more object locators through email

Parameters

objectId (Required) ID of the object to send.


type (Optional) Specifies the object type. If null, an
object fetch will determine the type.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_router_task_actions.xml

Scope

type dm_router_task

Elements
None.

sendlocator (type dm_task)

Purpose
Sends one or more object locators through email

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 745
startworkflow (type dm_process)

Parameters

objectId (Required) ID of the object to send.


type (Optional) Specifies the object type. If null, an
object fetch will determine the type.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_task_actions.xml

Scope

type dm_task

Elements
None.

startworkflow (type dm_process)

Purpose
Starts a workflow using a selected template. The user starts the workflow by selecting a document.
The startworkflow component is added to the container dynamically. The user must have a
contributor level of client capability.

Parameters

attachmentIds (Optional) IDs of the objects attached to the


workflow
objectId (Required) ID of the workflow template.

746 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
startworkflowfromdoc (type dm_sysobject)

ownerName (Optional) Name of the user who starts the


workflow
startworkflowId (Required) Component ID of the task manager
component to be displayed as the first tab in the
container.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_process_actions.xml

Scope

type dm_process

Elements
None.

startworkflowfromdoc (type dm_sysobject)

Purpose
Starts a workflow with the selected document. The user starts the workflow by selecting a workflow
template. The user must have a contributor level of client capability.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 747
startworkflownotemplate

Parameters

objectId (Required) ID of the object to route through the


workflow
ownerName (Optional) Name of the user who starts the
workflow
startworkflowId (Optional) Component ID of the task manager
component to be displayed as the first tab in the
container

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

startworkflownotemplate

Purpose
Starts a workflow without a workflow template

748 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
view (type dm_notification)

Parameters

ownerName (Optional) Owner of the object for which to start


a workflow
startworkflowId (Optional) Component ID of the taskmanager
component to be displayed as the first tab in the
container.

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
None.

view (type dm_notification)

Purpose
Displays a notification.

Parameters

objectId (Required) ID of the notification object.


taskmanagerId (Required) Component ID of the task manager
component.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 749
view (type dm_process)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_notification_actions.xml

Scope

type dm_notification

Elements
None.

view (type dm_process)

Purpose
Launches the Web Workflow Manager for viewing a workflow template. The user must
have read_permit access to the object (valid values: DELETE_PERMIT | WRITE_PERMIT
|VERSION_PERMIT | RELATE_PERMIT | READ_PERMIT | BROWSE_PERMIT | NONE_PERMIT).

Parameters

objectId (Required) ID of the workflow template.


ownerName (Optional) Name of the user who owns the object
to be viewed.
setError (Optional) Set to true to pass the precondition
error message to the WebcomponentErrorService
as a non‑fatal message

750 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
view (type dm_router_task)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_process_actions.xml

Scope

type dm_process

Elements
None.

view (type dm_router_task)

Purpose
Launches the viewing application for the selected object. The user must have read_permit access to the
object (valid values: DELETE_PERMIT | WRITE_PERMIT |VERSION_PERMIT | RELATE_PERMIT |
READ_PERMIT | BROWSE_PERMIT | NONE_PERMIT).

Parameters

objectId (Required) ID of the object to be viewed.


taskmanagerId (Required) Component ID of the task manager
component.

Description
Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 751
view (type dm_task)

Configuration File
webcomponent\config\actions\dm_router_task_actions.xml

Scope

type dm_router_task

Elements
None.

view (type dm_task)

Purpose
Launches the task manager for viewing a task.

Parameters

objectId (Required) dm_queue_id of the object to be


viewed.
taskmanagerId (Required) Component ID of the task manager
component.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_task_actions.xml

Scope

type dm_task

752 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
view (type dm_workflow)

Elements
None.

view (type dm_workflow)

Purpose
Launches the Web Workflow Manager to display the selected workflow.

Parameters

objectId (Required) ID of the object to be viewed.


workflowRuntimeState (Required) (Required) Integer that specifies
whether the workflow runtime state is Dormant
(0), Running (1), Terminated (2), Halted (3), or
Finished (4).

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_workflow_actions.xml

Scope

type dm_workflow

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 753
workflowavailability

workflowavailability

Purpose
Sets the user’s availability to receive workflow tasks

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
None.

workflowcalendarlist (type workflow_calendar)

Purpose
Enables displaying a list of workflow business calendars.

Parameters
None.

754 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
workflowstatusclassic (Webtop)

Description
Since
6.0 SP1

Configuration File
webcomponent\config\library\workflow\calendar\workflow_calendar_actions.xml

Scope

type workflow_calendar

Elements
None.

workflowstatusclassic (Webtop)

Purpose
Launches the workflowstatusclassic (Webtop), page 1686 component.

Parameters
None.

Description

Since
5.x

Configuration File
webtop\config\generic_actions.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 755
workflowstatusdrilldown

Elements
None.

workflowstatusdrilldown

Purpose
Displays in a drilldown view the workflows initiated by the user and the status of the workflows

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
None.

workflowstatuslist

Purpose
Displays in an object list view the workflows initiated by the user and the status of the workflows

756 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
workflowstatusstreamline (Webtop)

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\actions\generic_actions.xml

Scope
All.

Elements
None.

workflowstatusstreamline (Webtop)

Purpose
Launches the workflowstatusstreamline (Webtop), page 1688 component.

Parameters
None.

Description
Since
5.x

Configuration File
webtop\config\generic_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 757
addprocessorworkqueue

Scope
All.

Elements
None.

Work queue management

addprocessorworkqueue

Purpose
Adds a work queue processor to a work queue.

Parameters
None.

Description

Since
6.0

Configuration File
webcomponent\config\library\queuemanagement\userprofile_actions.xml

Scope
All.

Elements
None.

758 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
addworkqueuemember

addworkqueuemember

Purpose
Adds a user as a valid processor for a work queue.

Parameters

addQueueMemberContext (Required) Boolean that must have a value of


true to perform action
groupName (Optional) Must have a value of queue_processor
to perform action
multiselect (Optional) Set to true to allow multiple selection
objectId (Optional) ID of work queue
queueName (Required) Name of work queue

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\queueusersandgroups_actions.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 759
assign_queued_task (type dm_task)

assign_queued_task (type dm_task)

Purpose
Assigns a task from a work queue to a particular performer.

Parameters

objectId (Required) ID of the dm_task object.


ownerName (Optional) Name of the user who owns the task.
performer (Required) User name of the owner to whom to
assign the task.
queueName (Required) Name of the work queue.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_queued_task_actions.xml

Scope

type dm_task

Elements
None.

attributes (type dm_queuegroup)

Purpose
Displays the attributes of dm_queuegroup objects.

760 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attributes (type dm_queueprocessor)

Parameters

objectId (Required) ID of the dm_queuegroup object.


objectname (Required) Name of the dm_queuegroup object.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_queuegroup_actions.xml

Scope

type dm_queuegroup

Elements
None.

attributes (type dm_queueprocessor)

Purpose
Displays the attributes of work queue processors.

Parameters

objectId (Required) ID of the dm_user object that


represents a work queue processor.
objectname (Required) Name of the dm_user object that
represents a work queue processor.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 761
attributes (type dmc_wq_skill_info)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_queueprocessor_actions.xml

Scope

type dm_queueprocessor

Elements
None.

attributes (type dmc_wq_skill_info)

Purpose
Displays the attributes of dmc_wq_skill_info objects.

Parameters

objectId (Required) ID of the dmc_wq_skill_info object.


objectname (Required) Name of the dmc_wq_skill_info
object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_wq_skill_info_actions.xml

762 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
changeprocessorworkqueuemember

Scope

type dmc_wq_skill_info

Elements
None.

changeprocessorworkqueuemember

Purpose
Edit the user profile for a work queue member in a work queue.

Parameters

direct_member (Required) (Boolean) True, if the processor was


added as a user to the work queue; False, if the
processor is a member of a group that was added
to the work queue.
member (Required) (Boolean) True, if the processor is a
member of a group that was added to the work
queue; False, if the processor was added as a
user to the work queue.
name (Required) Name of the work queue.

Description
Since
6.0

Configuration File
webcomponent\config\library\queuemanagement\userprofile_actions.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 763
delete (type dm_queued)

Elements
None.

delete (type dm_queued)

Purpose
Deletes a queue item in the inbox.

Parameters

objectId (Required) The ID of the object to be deleted.


objectName (Optional) The name of the queue item.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_queued_actions.xml

Scope

type dm_queued

Elements
None.

764 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (type dmc_workqueue_category)

delete (type dmc_workqueue_category)

Purpose
Deletes one or more objects.

Parameters

objectId (Required) ID of the object to be deleted.


objectname (Optional) Name of the selected object.
ownerName (Optional) Name of the user who owns the object
to be deleted.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_category_actions.xml

Scope

type dmc_workqueue_category

Elements
None.

delete (type dmc_workqueue_doc_profile)

Purpose
Deletes a work queue document profile object. This action is available only when the document
profile is not used.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 765
delete (type dmc_workqueue_policy)

Parameters

objectId (Required) ID of the work queue document


profile object.
objectname (Optional) Name of the work queue document
profile.
ownerName (Optional) Name of the user who owns the work
queue document profile object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_doc_profile_actions.xml

Scope

type dmc_workqueue_doc_profile

Elements
None.

delete (type dmc_workqueue_policy)

Purpose
Deletes a work queue policy. This action is available only when the policy is not being used.

766 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (type dmc_workqueue)

Parameters

objectId (Required) ID of the work queue policy object.


objectname (Optional) Name of the work queue policy object.
ownerName (Optional) Name of the user who owns the work
queue policy object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_policy_actions.xml

Scope

type dmc_workqueue_policy

Elements
None.

delete (type dmc_workqueue)

Purpose
Deletes one or more workqueue objects. The user must have a role of contributor.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 767
delete (type dmc_wq_skill_info)

Parameters

objectId (Required) ID of the selected object.


objectname (Optional) Name of the selected object to be
deleted
ownerName (Optional) Name of the user who owns the object
to be deleted

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_actions.xml

Scope

type dmc_workqueue

Elements
None.

delete (type dmc_wq_skill_info)

Purpose
Deletes dmc_wq_skill_info objects.

Parameters

objectId (Required) ID of the dmc_wq_skill_info object.


objectname (Optional) Name of the dmc_wq_skill_info
object.

768 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
deletenotification (type dm_queued)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_wq_skill_info_actions.xml

Scope

type dmc_wq_skill_info

Elements
None.

deletenotification (type dm_queued)

Purpose
Deletes a notification from a router.

Parameters

objectId (Required) The ID of the notification.


routerId (Required) ID of the router.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\taskmgr_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 769
docprofileadd

Scope

type dm_queued

Elements
None.

docprofileadd

Purpose
Adds a work queue document profile object

Parameters

objectId (Optional) Work queue ID

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\docprofileadd_actions.xml

Scope
All.

Elements
None.

770 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docprofileremove

docprofileremove

Purpose
Removes a work queue document profile object. This action is available only if the document profile is
not being used.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\docprofileadd_actions.xml

Scope
All.

Elements
None.

editprocessorauthentication

Purpose
Sets the skill level and authorized document profiles for an existing work queue processor.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 771
editwquserskill (type dmc_wq_user_skill)

Parameters

docprofile_enable (Optional) Set to true to enable setting a profile


for the user
docprofile_name (Optional) Name to assign to the profile
skill (Optional) Adds a value to the dropdown list of
skills in the form of an NLS ID
username (Required) Sets a label for the User Name, in the
form of an NLS ID
wq_name (Required) Work queue name

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\userprofile_actions.xml

Scope
All.

Elements
None.

editwquserskill (type dmc_wq_user_skill)

Purpose
Enables editing of dmc_wq_user_skill objects.

772 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
get_work

Parameters

skill_info_id (Optional) ID of the dmc_wq_skill_info object.


skill_values (Optional) For the specified skill, the actual skill
values (String) of the user.
user_name (Required) Name of the user.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_wq_user_skill_actions.xml

Scope

type dmc_wq_user_skill

Elements
None.

get_work

Purpose
Retrieves the highest priority unassigned task from a work queue

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 773
managequeueinbox (type dmc_workqueue)

Parameters

allowPullEmptyOnly (Optional) Set to false to allow the user to get the


next task even if the user’s inbox contains other
active tasks.
getWorkContext (Required) Set to true to allow this action within
the context of the calling component (set by
inboxdrilldown and inboxlist). The action will
be disabled within components that do not set
the value to true.
ownerName (Optional) Owner of the task
userName (Optional) Current user

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\queue_actions.xml

Scope
All.

Elements
None.

managequeueinbox (type dmc_workqueue)

Purpose
Manages the work queue inbox containing the tasks of the selected queue.

774 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
move_queued_task (type dm_task)

Parameters

categoryPath (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
queuename (Required) Name of the selected queue.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_actions.xml

Scope

type dmc_workqueue

Elements
None.

move_queued_task (type dm_task)

Purpose
Moves a task from one work queue to another.

Parameters

objectId (Required) ID of the dm_task object.


ownerName (Optional) Name of the user who owns the
dm_task object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 775
move (type dmc_workqueue_category)

performer (Required) Name of the performer.


queueName (Required) Name of work queue.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_queued_task_actions.xml

Scope

type dm_task

Elements
None.

move (type dmc_workqueue_category)

Purpose
Moves a work queue or work queue category to a new location.

Parameters

ownerName (Optional) Name of the user who owns the work


queue to be moved.

Description

Since
5.x

776 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
move (type dmc_workqueue)

Configuration File
webcomponent\config\actions\dmc_workqueue_category_actions.xml

Scope

type dmc_workqueue_category

Elements
None.

move (type dmc_workqueue)

Purpose
Moves a clipboard object to a new location.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_actions.xml

Scope

type dmc_workqueue

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 777
myworkqueuecategories

myworkqueuecategories

Purpose
Displays a list of the work queue categories of which the current user is a manager.

Parameters

arrangeselect (Optional) Boolean: true to allow rearrangement


of order.
multiselect (Optional) Boolean: true to support multiple
object selection.
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected.

Description
Since
5.x

Configuration File
webcomponent\config\actions\queue_management_actions.xml

Scope
All.

Elements
None.

778 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newWorkQueue (type dmc_workqueue)

newWorkQueue (type dmc_workqueue)

Purpose
Creates a new work queue object.

Parameters

categoryPath (Required) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
objectId (Required) ID of the work queue object.
objectname (Required) Name of the work queue object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_actions.xml

Scope

type dmc_workqueue

Elements
None.

newWorkQueueCategory

Purpose
Creates a new work queue category object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 779
newWorkQueueDocProfile (type dmc_workqueue_doc_profile)

Parameters

categoryPath (Required) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
objectId (Required) ID of the work queue category object.
objectname (Required) Name of the work queue category
object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_category_actions.xml

Scope
All.

Elements
None.

newWorkQueueDocProfile (type dmc_workqueue_


doc_profile)

Purpose
Creates a new work queue document profile object.

780 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newWorkQueuePolicy (type dmc_workqueue_policy)

Parameters

objectId (Required) ID of the work queue document


profile object.
objectname (Required) Name of the work queue document
profile.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_doc_profile_actions.xml

Scope

type dmc_workqueue_doc_profile

Elements
None.

newWorkQueuePolicy (type dmc_workqueue_policy)

Purpose
Creates a new work queue policy object.

Parameters

objectId (Required) ID of the work queue policy object.


objectname (Required) Name of the work queue policy
object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 781
newWQSkillInfo (type dmc_wq_skill_info)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_policy_actions.xml

Scope

type dmc_workqueue_policy

Elements
None.

newWQSkillInfo (type dmc_wq_skill_info)

Purpose
Creates dmc_wq_skill_info objects.

Parameters

objectId (Required) ID of the dmc_wq_skill_info object.


objectname (Required) Name of the dmc_wq_skill_info
object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_wq_skill_info_actions.xml

782 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
processorqueueinbox (type dmc_workqueue)

Scope

type dmc_wq_skill_info

Elements
None.

processorqueueinbox (type dmc_workqueue)

Purpose
Displys the inbox for a work queue processor.

Parameters

categoryPath (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
queuename (Required) Name of the work queue to display
in the work queue inbox.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_actions.xml

Scope

type dmc_workqueue

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 783
processorskillattributes

processorskillattributes

Purpose
Modify a work queue processor’s skill attributes.

Parameters

skill_info_id (Optional) skill_info_id attribute to modify.


skill_values (Optional) Values to change to in the specified
skill_info_id parameter.
user_name (Required) Name of the work queue processor.

Description
Since
6.0

Configuration File
webcomponent\config\library\queuemanagement\userprofile_actions.xml

Scope
All.

Elements
None.

processorworkloadinbox

Purpose
Displays the work queue items assigned to a particular work queue processor.

784 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
properties (type dm_queuegroup)

Parameters

categoryPath (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
objectname (Required) Name of group to which user or
group must belong to process inbox queue items.
ownerName (Optional) Owner of group
queueName (Required) Name of the workload queue

Description
Since
5.x

Configuration File
webcomponent\config\actions\queue_member_actions.xml

Scope
All.

Elements
None.

properties (type dm_queuegroup)

Purpose
Displays the properties of dm_queuegroup objects.

Parameters

objectId (Required) ID of the dm_queuegroup object.


objectname (Required) Name of the dm_queuegroup object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 785
properties (type dm_queueprocessor)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_queuegroup_actions.xml

Scope

type dm_queuegroup

Elements
None.

properties (type dm_queueprocessor)

Purpose
Displays the properties of work queue processors.

Parameters

objectId (Required) ID of the dm_user object that


represents a work queue processor.
objectname (Required) The user_name attribute value in the
dm_user object that represents a work queue
processor.

Description
Since
5.x

786 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
properties (type dmc_workqueue_category)

Configuration File
webcomponent\config\actions\dm_queueprocessor_actions.xml

Scope

type dm_queueprocessor

Elements
None.

properties (type dmc_workqueue_category)

Purpose
Displays the properties of an object (dmc_workqueue_category).

Parameters

objectId (Required) ID of the selected object.


objectname (Required) Name of the selected object.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_category_actions.xml

Scope

type dmc_workqueue_category

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 787
properties (type dmc_workqueue_doc_profile)

properties (type dmc_workqueue_doc_profile)

Purpose
Displays the properties of a dmc_workqueue_doc_profile object.

Parameters

objectId (Required) ID of the dmc_workqueue_doc_


profile object.
objectname (Required) Name of the dmc_workqueue_doc_
profile object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_doc_profile_actions.xml

Scope

type dmc_workqueue_doc_profile

Elements
None.

properties (type dmc_workqueue_policy)

Purpose
Displays the properties component for a work queue policy.

788 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
properties (type dmc_workqueue)

Parameters

objectId (Required) ID of the work queue policy object.


objectname (Required) Name of the work queue policy
object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_policy_actions.xml

Scope

type dmc_workqueue_policy

Elements
None.

properties (type dmc_workqueue)

Purpose
Displays the properties of a dmc_workqueue object

Parameters

objectId (Required) ID of the selected object.


objectname (Required) Name of the selected object

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 789
properties (type dmc_wq_skill_info)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_actions.xml

Scope

type dmc_workqueue

Elements
None.

properties (type dmc_wq_skill_info)

Purpose
Displays properites for dmc_wq_skill_info objects.

Parameters

objectId (Required) ID of the dmc_wq_skill_info object.


objectname (Required) Name of the dmc_wq_skill_info
object.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_wq_skill_info_actions.xml

790 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
pull_queued_task (type dm_task)

Scope

type dmc_wq_skill_info

Elements
None.

pull_queued_task (type dm_task)

Purpose
Calls the pullqueuedtask, page 1719 component in the pullqueuedtaskcontainer, page 1720 container
component.

Parameters

objectId (Required) Queue item ID of the dm_task object


to be selected.
performer (Required) Name of the user to whom to assign
the dm_task object
queueName (Required) Name of the work queue from which
to select the the dm_task objects.

Description

Since
6.0

Configuration File
webcomponent\config\actions\dm_queued_task_actions.xml

Scope

type dm_task

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 791
queuelist (Webtop)

Elements
None.

queuelist (Webtop)

Purpose
Calls queuelist (Webtop), page 1725 to display a list of the available work queues and work queue
categories.

Parameters

category_path (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
nodeIds (Optional) IDs of queue management nodes in
the browsertree.
object_name (Optional) Not used.
objectId (Optional) Queue ID.

Description

Since
6.0

Configuration File
webtop\config\queuelistclassic_actions.xml

Scope
All.

Elements
None.

792 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
queuelist

queuelist

Purpose
Displays a list of the available work queues and work queue categories.

Parameters

category_path (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
object_name (Optional) Not used.
objectId (Optional) Queue ID.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\list\queuelist_actions.xml

Scope
All.

Elements
None.

queuemonitorlist

Purpose
Displays an overview screen showing the status of a manager’s work queues.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 793
queueusersandgroups (type dmc_workqueue)

Parameters

ownerName (Optional) Not used.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\queue_actions.xml

Scope
All.

Elements
None.

queueusersandgroups (type dmc_workqueue)

Purpose
Displays a list of the users and groups assigned to a work queue.

Parameters

categoryPath (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
objectId (Required) ID of the work queue.
queuename (Required) Name of the work queue.

794 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reassign_queued_task (type dm_task)

Description
Since
5.x

Configuration File
webcomponent\config\actions\dmc_workqueue_actions.xml

Scope

type dmc_workqueue

Elements
None.

reassign_queued_task (type dm_task)

Purpose
Changes the user assigned to work on a work queue task.

Parameters

objectId (Required) ID of the dm_task object.


ownerName (Optional) Not used.
performer (Required) Name of the performer to which to
reassign the task.
queueName (Required) Name of the work queue for which to
assign a task.

Description
Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 795
reassignworkflowtask (type dm_task)

Configuration File
webcomponent\config\actions\dm_queued_task_actions.xml

Scope

type dm_task

Elements
None.

reassignworkflowtask (type dm_task)

Purpose
Delegate task in a workflow’s ReportDetailsSummary page.

Since
6.5

removeprocessorauthentication

Purpose
Removes the skill level and authorized document profile settings for a work queue processor.

Parameters
None.

796 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
removeworkqueuemember

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\userprofile_actions.xml

Scope
All.

Elements
None.

removeworkqueuemember

Purpose
Removes a user from the list of valid processors for a work queue.

Parameters

addQueueMemberContext (Required) Boolean that must have a value of


true to perform action.
queueName (Required) Name of queue from which to remove
a user.

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\queueusersandgroups_actions.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 797
suspend_queued_task (type dm_task)

Scope
All.

Elements
None.

suspend_queued_task (type dm_task)

Purpose
Suspends a task from a work queue.

Parameters

objectId (Required) ID of the dm_task object.


runtimeState (Required) State of the workflow. Valid values
are: 0 = dormant 1 = running 2 = finished 3
= halted 4 = terminated Only 0 and 1 can be
suspended.

Description

Since
5.x

Configuration File
webcomponent\config\actions\dm_queued_task_actions.xml

Scope

type dm_task

Elements
None.

798 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
unassign_queued_task (type dm_task)

unassign_queued_task (type dm_task)

Purpose
Removes a work queue task from an individual processor’s task list and returns it to the work queue.

Parameters

objectId (Required) ID of the dm_task object.


ownerName (Optional) Name of the user who owns the
dm_task object.
performer (Required) Performer to whom the task was
assigned.
queueName (Required) Name of the work queue.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_queued_task_actions.xml

Scope

type dm_task

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 799
unhold_queued_task (type dm_task)

unhold_queued_task (type dm_task)

Purpose
Releases a hold on a work queue task.

Since
6.5

unsuspend_queued_task (type dm_task)

Purpose
Returns a suspended queue task to active state.

Parameters

objectId (Required) ID of the dm_task object.


runtimeState (Required) State of the workflow. Valid values
are: 0 = dormant 1 = running 2 = finished 3
= halted 4 = terminated Only 0 and 1 can be
suspended.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_queued_task_actions.xml

Scope

type dm_task

800 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
updateprocessorauthentication

Elements
None.

updateprocessorauthentication

Purpose
Updates the skill level and authorized document profiles for a work queue processor

Parameters

docprofile_name (Optional) Name to assign to the profile


skill (Optional) Adds a value to the dropdown list of
skills in the form of an NLS ID
username (Required) Sets a label for the User Name, in the
form of an NLS ID
wq_name (Required) Work queue name

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\userprofile_actions.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 801
updateprocessorskill

updateprocessorskill

Purpose
Updates the skill level for a work queue processor.

Parameters

objectname (Required) Name of the work queue processor


(dm_queueprocessor) object.
requiredSkillIds (Required) Ids of the dmc_wq_skill_info objects
the work queue requires.

Description
Since
6.0

Configuration File
webcomponent\config\library\queuemanagement\userprofile_actions.xml

Scope
All.

Elements
None.

view (type dm_queued)

Purpose
Launches the viewing application for the selected object. The user must have read_permit access to the
object (valid values: DELETE_PERMIT | WRITE_PERMIT |VERSION_PERMIT | RELATE_PERMIT |
READ_PERMIT | BROWSE_PERMIT | NONE_PERMIT).

802 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
viewqueuemanagementclipboard

Parameters

objectId (Required) ID of the object to be viewed.


taskmanagerId (Required) Component ID of the task manager
component.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_queued_actions.xml

Scope

type dm_queued

Elements
None.

viewqueuemanagementclipboard

Purpose
Displays the contents of the queue management clipboard.

Parameters
None.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 803
newprintforms (type dm_folder)

Configuration File
webcomponent\config\library\queuemanagement\queue_actions.xml

Scope
All.

Elements
None.

XForms

newprintforms (type dm_folder)

Purpose
Creates a new form. The user must have the role form_user and folder_link_permit permission.
Customization is not supported.

Since
6.5

Usage
This edit component is same as the edit component, but its processor extends from the print form
check out processor.

newxforms (type dm_folder)

Purpose
Creates a new form. The user must have the role form_user and folder_link_permit permission.
Customization is not supported.

804 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
saveasxforms (type dm_folder)

Parameters

objectId (Required) Object ID of the current folder in


which the form will be created.
ownerName (Optional) Name of the owner of the folder or
cabinet. Used by the NewObjectPrecondition
class to determine whether the action can be
performed.

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_folder_actions.xml

Scope

type dm_folder

Elements
None.

saveasxforms (type dm_folder)

Purpose
Creates a new form from a current form. The user must have the role form_user. Launched as a menu
item for a selected object in the list view. Customization is not supported.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 805
saveasxforms (type dm_sysobject)

Parameters

contentType (Optional) File format of the object (passed to the


operating system)
objectId (Required) Object ID of the current folder in
which the form will be created.
ownerName (Optional) Not implemented

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_folder_actions.xml

Scope

type dm_folder

Elements
None.

saveasxforms (type dm_sysobject)

Purpose
Creates a new form from a current form. The user must have the role form_user.

806 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
saveasxforms (type dm_sysobject)

Parameters

contentType (Optional) File format of the object (passed to the


operating system)
objectId (Required) Object ID of the current folder in
which the form will be created.
ownerName (Optional) Owner of object

Description
Since
5.x

Configuration File
webcomponent\config\actions\dm_sysobject_actions.xml

Scope

type dm_sysobject

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 807
saveasxforms (type dm_sysobject)

808 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Chapter 3
Components Reference
Overview
Components are grouped according to how they are used.

Common elements
This topic describes the elements that can be specified in more than one component configuration
file. Elements that can only be specified in one component configuration file are described in that
component’s entry.

actiontable
<actiontable>/webcomponent/testbed/wdklinks.jsp</actiontable>

For internal use only.

allversionsvisible
<allversionsvisible>false</allversionsvisible>
Boolean: Whether to display all versions (true) or only the current version (false).

asynchronous
<asynchronous>true</asynchronous>

Boolean: Whether to enable (true) or disable (false) asynchronous execution of a component job. The
default is false.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 809
Components Reference

attributes
1 <attributes>
2<attribute column="1">
3<name>name</name>
4<columnheader>MSG_OBJECT_NAME</columnheader>
</attribute>
...
</attributes>

1 Contains attribute definitions for columns to display.


2 Specifies a mapping for an attribute to a column. Specify an integer that represents the position
of the column in relation to the other columns.
3 Specifies the name of the attribute.
4 Specifies the name of the column header.

autogettaskdefault
<autogettaskdefault>false</autogettaskdefault>

Default value for auto get next task checkbox (default = unchecked).

base_type
<base_type>dm_cabinet</base_type>

Specifies the base type (which includes subtypes) for the component.

bindingcomponentversion
<bindingcomponentversion>latest</bindingcomponentversion>

Specifies the version of components that are supported by the container component. Default: latest.

breadcrumbiconwellmode
<breadcrumbiconwellmode>true</breadcrumbiconwellmode>

Whether to use the iconwell node (true) or the repository node (false) as the root of the breadcrumb.
See also iconwell, page 212.

810 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Components Reference

cabinets
<cabinets>objectlist</cabinets>

Link to a component for a cabinet.

category
<category>categoryclassic</category>

Link to a component for a category.

clientevent
1 <clientevent>aiEvent</clientevent>

1 Specifies the client event to be fired on page rendering that is handled on the client. For events that
are handled by Application Connectors, an aiEvent is fired and passed to the Application Connectors.

columns (for data columns)


1 <columns>
2<column attribute="r_object_type">false</column>
...
</columns>

1 Root element of the element structure that configures data columns. Use with the celltemplate,
page 97 control.
2 Specifies whether the column is displayed (true) or not (false) for an object type attribute specified
in this element’s attribute attribute.

columns (for streamline view)


1 <columns>
<loadinvisibleattributes>true</loadinvisibleattributes>
2<column>
3<attribute>r_version_label</attribute>
4<label>
5<nlsid>MSG_VERSION_LABEL</nlsid>
</label>
6<visible>true</visible>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 811
Components Reference

</column>
...
</columns>

1 Specifies the order of columns and whether they are displayed in streamline view. Contains
<column> elements.
2 Root element for the element structure that configures a column.
3 Attribute to be displayed in the column.
4 Label for the column. Valid value is a string. Can specify an <nlsid> child element instead of a string.
5 NLS lookup key. The string corresponding to the NLS ID is displayed.
6 Whether to show the column (true) or not (false).

columns_list
1 <columns_list>
2<loadinvisibleattribute>true</loadinvisibleattributes>
3<column>
4<attribute>r_version_label</attribute>
5<label>
<nlsid>MSG_VERSION_LABEL</nlsid>
</label>
6<visible>true</visible>
</column>
...
</columns_list>

1 Specifies the order of columns and whether they are displayed in classic view. Contains <column>
elements.
2 Whether to load and calculate hidden columns (true) or not (false).
3 Contains the configurable elements for a column.
4 Attribute to be displayed in the column.
5 Label for the column. Valid value is a string. Can specify an <nlsid> child element instead of a string.
6 Whether to show the column (true) or not (false).

columns_all_saved_searches
1 <columns_all_saved_searches>
2<loadinvisibleattribute>true</loadinvisibleattribute>
3<column>
4<attribute>object_name</attribute>
5<label>
6<nlsid>MSG_NAME</nlsid>
</label>
7<visible>true</visible>
</column>
...

812 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Components Reference

</columns_all_saved_searches>

1 Specifies the attributes to load in columns for all saved searches.


2 Whether to load and calculate hidden columns (true) or not (false).
3 Specifies a mapping for an attribute to a column.
4 Specifies the name of the attribute.
5 Specifies the name of the column header.
6 Specifies the NLS ID specified in the NLS file for the component.
7 Specifies whether the column is to be displayed (true) or hidden (false).

columns_my_saved_searches
1 <columns_my_saved_searches>
2<loadinvisibleattribute>true</loadinvisibleattribute>
3<column>
4<attribute>object_name</attribute>
5<label>
6<nlsid>MSG_NAME</nlsid>
</label>
7<visible>true</visible>
</column>
...
</columns_my_saved_searches>

1 Specifies the order and visibility of attribute columns for a user’s saved searches.
2 Whether to load and calculate hidden columns (true) or not (false).
3 Corresponds to a column in saved searches. Contains <attribute>, <label>, and <visible> elements.
4 Corresponds to an attribute of the saved searches.
5 Label for the column in the saved searches. Contains string or <nlsid>.
6 Specifies the NLS ID specified in the NLS file for the component.
7 Boolean flag that sets the visibility of the column in the saved searches.

columns_saved_search
1 <columns_saved_search>
2<loadinvisibleattribute>true</loadinvisibleattribute>
3<column>
4<attribute>object_name</attribute>
5<label>
6<nlsid>MSG_NAME</nlsid>
</label>
7<visible>true</visible>
</column>
...
</columns_saved_search>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 813
Components Reference

1 Specifies the order and visibility of attribute columns for a saved search.
2 Whether to load and calculate hidden columns (true) or not (false).
3 Corresponds to a column in a saved search. Contains <attribute>, <label>, and <visible> elements.
4 Corresponds to an attribute of a saved search.
5 Label for the column in a saved search. Contains string or <nlsid>.
6 Specifies the NLS ID specified in the NLS file for the component.
7 Boolean flag that sets the visibility of the column in a saved search.

comments
1 <comments>
2<comment>
3<attribute>object_name</attribute>
4<visible>true</visible>
</comment>
...
</comments>

1 Contains one or more <comment> elements.


2 Specifies comment attributes to include in the TopicResultSet. Contains <attribute> and <visible>
elements.
3 Sets the name of the attribute to be included in the result set.
4 Set to true to make the attribute visible.

commitorder
1 <commitorder>
2<component>multiobjectspermissions</component>
<component>multiobjectsattributes</component>
</commitorder>

1 Contains <component> elements that specify the order in which properties changes will be saved.
2 Value specifies one or more contained component for which changes will be saved in the order the
components are listed within <commitorder>.

containerselectable
<containerselectable>true</containerselectable>
Boolean: Whether the container type is selectable when the container is a subtype of the objecttype.

814 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Components Reference

contenttypepanelvisible
<contenttypepanelvisible>true</contenttypepanelvisible>
Boolean: Whether to show the content type panel (true) or not (false).

cost_attribute_conditions
1 <cost_attribute_conditions>
2<number>
3<condition>
4<nlsid>MSG_EQUAL_TO</nlsid>
</condition>
...
</number>
</cost_attribute_conditions>

1 Specifies the operators that can be used to define a range of user‑specified task costs for the business
process historical report. The unit for task cost is not defined. To enable users to specify a cost for a
task, you must enable the showusertimeandcost element in the taskmanager, page 1653 component.
2 Container for <condition> elements.
3 Container for <nlsid> elements.
4 Specifies the NLS ID for an operator.

default_binding_filter_values
1 <default_binding_filter_values>
2<version_label>Approved</version_label>
...
</default_binding_filter_values>

1 List of version labels to include in the default child version dropdown. These values are in addition
to ʺCURRENTʺ and existing version labels on the virtual document root node.
2 Additional label to display, for example, Approved.

default_type
<default_type>dm_cabinet</default_type>

Specifies the default object type selection for the component. Must be the same as the one (or one of its
subtypes) specified in the <base_type> element.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 815
Components Reference

defaultaccounts
1 <defaultaccounts>
2<filter docbase=repository­name>
3<defaultaccount>
4<username>username</username>
5<password>encrypted_password</password>
6<domain>domain_name</domain>
</defaultaccount>
</filter>
...
7<logoffoncomplete>true</logoffoncomplete>
</defaultaccounts>

1 Contains anonymous access login information in one or more <defaultaccount> elements.


2 Optional filter to specify the account for a single repository. Set the repository attribute on this
element to the repository name.
3 Sets up anonymous access for virtual links.
4 Name of a user in the target repository.
5 Password for the anonymous user. Can be encrypted with the Trusted Authenticator Tool. Refer to
Web Development Kit Development Guide for instructions.
6 Optional network domain name for login to the repository.
7 Set to true to log the default account off and close the window after the DRL action is performed.

defaultsources
<defaultsources>preferred_sources</defaultsources>

Sets the default search locations to be displayed for a search. Valid values: current_docbase
(current repository) | visibile_docbases (all visible repositories) | preferred_sources (all visible
repositories and external sources set in the user’s preferences) | all_sources (all visible repositories
and external sources).

defaultview
<defaultview>my</defaultview>

Default display when the end user preference is not set. Valid values are:
my
all
For search templates, the default is all, which displays all search templates; for saved searches,
the default is my.

816 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Components Reference

displayresultspath
<displayresultspath>true</displayresultspath>

Set to true to query and display the folder path to each result object. A value of false will speed
performance.

docbase­type­mappings
1 <docbase­type­mappings>
2<docbase­type­mapping>
3<format>msg</format>
4<type>dm_email_message</type>
</docbase­type­mapping>
...
</docbase­type­mappings>

1 Contains file format to object type mappings.


2 Contains <format> and <type> elements.
3 File format.
4 Object type.

document­docbase­base­type
<document­docbase­base­type>dmc_calendar_event</document­docbase­base­type>

Default base for retrieving a type list to be displayed on import.

document­docbase­type
<document­docbase­type>dmc_calendar_event</document­docbase­type>

Default selected object type of an object to be imported. Must be the type or subtype of
<document‑docbase‑base‑type>.

document_filter
1 <document_filter>
2<preset_item id="type_filter">
3<selection>
4<entries>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 817
Components Reference

5<entry></entry>
</entries>
</selection>
</preset_item>
</document_filter>

1 Preset filter for documents.


2 Specifies the kind of preset item; in this case, an object type filter.
3 Contains the <entries> element.
4 Contains <entry> elements.
5 An <entry> element.

dragdrop
1 <dragdrop>
2<sourceactions></sourceactions>
3<targetactions></targetactions>
4<dataproviders>
5<dataprovider>
6<format>com.documentum.web.formext.control.dragdrop.ObjectIdData</format>
7<provider>com.documentum.web.formext.control.dragdrop.ObjectIdDataProvider</provider>
</dataprovider>
...
</dataproviders>
</dragdrop>

1 Supports the drag and drop feature.


2 Contains zero or more <sourceaction> classes that support drag and drop actions on sources in
the component.
3 Contains zero or more <targetaction> classes that support drag and drop actions on targets in
the component.
4 Contains one or more <dataprovider> elements.
5 Contains a <format> element and a <provider> element.
6 Fully qualified class name for the class that provides data for the format. Built‑in formats include
object ID, tree node, and external files.
7 Fully qualified class name for the class that implements IDragDropDataProvider and provides
data for the associated format.

duration_attribute_conditions
1 <duration_attribute_conditions>
2<number>
3<condition>
4<nlsid>MSG_EQUAL_TO</nlsid>
</condition>

818 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Components Reference

...
</number>
</duration_attribute_conditions>

1 Specifies the operators that can be used to define a range of user‑specified task durations for the
business process historical report. The unit for task duration is not defined. To enable users to specify
a duration for a task, you must enable the showusertimeandcost element in the taskmanager, page
1653 component.
2 Container for <condition> elements.
3 Container for <nlsid> elements.
4 Specifies the NLS ID for an operator.

enableShowAll
<enableShowAll>true</enableShowAll>

Whether to display (true) or hide (false) the Show All Properties link.

entrypage
<entrypage>classic</entrypage>

Default entry view when the entryPage parameter is not specified in the request.

failoverenabled
<failoverenabled>true</failoverenabled>

Boolean: Whether to enable (true) failover for this component or not (false).

filenamefiltervisible
<filenamefiltervisible>false</filenamefiltervisible>

Whether to display the file name filter (true) or not (false).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 819
Components Reference

filter
<filter role="administrator, dce_user_manager">
...
</filter>

Standard WDK filter that applies a scope qualifier such as type or role, which limits the application of
contained elements to user contexts that match the scope value.

flatlist
<flatlist>false</flatlist>
Boolean: Whether to display a flat list (true) or a drop‑down list (false) of all selectable objects.

folder­docbase­type
<folder­docbase­type>dmc_calendar</folder­docbase­type>

Default folder type of a folder to be imported.

folder_filter
1 <folder_filter>
2<preset_item id="type_filter">
<selection>
<entries>
<entry></entry>
...
</entries>
...
</selection>
</preset_item>
</folder_filter>

1 Specifies a preset filter for folders.


2 Standard preset_item structure that specifies an object type filter. See preset_item, page 830.

formsavefolderpath
<formsavefolderpath>/System/Workflow/Processing Form</formsavefolderpath>

Path in the repository to associated XForm, if any. For example, /System/Workflow/Processing Form.

820 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Components Reference

header
1 <header visible="true">
2<showpagingcontrol>true</showpagingcontrol>
3<showclosebutton>true</showclosebutton>
</header>

1 Contains header settings <showpagingcontrol> and <showclosebutton>. Set the visible attribute to
true to display a header when the objectgrid component is used as standalone. Sub‑components can
override this element to configure the header.
2 True to display a paging control within the header
3 True to display a close button within the header

help­entries
1 <help­entries>
2<entry id="default">default.htm</entry>
...
</help­entries>

Specifies the relative paths to help files in the application.

helppath
<helppath>Web Workflow Manager</helppath>

Subdirectory of the help folder that contains online help for the Web workflow manager. For
example, a path of webwfmhelp could be resolved to C:\Program Files\Apache Group\Tomcat
4.1\webapps\webtop\help\en\webwfmhelp and a similar path for each installed language pack
(replacing ʺen)

hideEvents
<hideEvents>dm_changestateactivity</hideEvents>

Specifies one or more events to hide from the report. See the Content Server Administration Guide for
a list of events.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 821
Components Reference

highlight_matching_terms
<highlight_matching_terms>true</highlight_matching_terms>

Set to true to highlight matches for search terms in the results.

homeURL
<homeURL>/component/testbed</homeURL>

Specifies the URL that should be displayed when the logout action is invoked. The default value
ensures that the testbed component is loaded again after the session is released.

homecabinet
<homecabinet>homecabinet_classic</homecabinet>
Specifies the component that displays a user’s home cabinet.

iconwell_icon
1 <iconwell_icon>icons/iconwell/iconwell_cabinets.gif</iconwell_icon>

1 Path within a theme directory to the icon. For example, a path of /icons/perspective/inbox32.gif
would map to a file at /root_directory/custom/theme/mytheme/icons/perspective\inbox32.gif. See
Web Development Kit Development Guidefor information on how themes are located.

inbox
<inbox>inboxclassic</inbox>
Specifies a component that displays a user’s inbox.

includetypes
<includetypes>dm_sysobject</includetypes>

822 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Components Reference

Optional element (cannot be more than one instance of this element) that specifies a comma‑separated
list of Documentum types to be included in the view. The container must be listed along with the
subtypes within the container; for example, dm_folder, dm_document.
<includetypes descend="true">dm_sysobject</includetypes>

Comma‑delimited list of object types to display for search. Set the descend attribute to true to search
subtypes of the selected type; set to false to search only the selected type..

includeunlisted
<includeunlisted>true</includeunlisted>
Boolean: Whether to display (true) hidden users or not (false).

init­controls
1 <init­controls>
2<control name="downloadDescCheckbox" type="com.documentum.web.form.control.Checkbox">
3<init­property>
4<property­name>value</property­name>
<property­value>false</property­value>
</init­property>
...
</control>
...
</init­controls>

1 Initializes values for controls.


2 Names a control and sets its initial value. The value of the name attribute must match the name of a
control in the component JSP page. The value of the type attribute must be a fully qualified class name
for a display control. For example, when the Name attribute value is branchrevision, the type attribute
value is com.documentum.web.form.control.Radio.
3 Specifies an attribute on the control. Value is value.
4 Specifies an attribute on the control. Value is true.

isIgnorePrefRenditions
<isIgnorePrefRenditions>false</isIgnorePrefRenditions>
(Optional) Boolean: Whether to ignore the user’s preference for opening renditions (True) or not
(False).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 823
Components Reference

locator
<locator></locator>
Locator component to be launched for selecting the attribute value. For example, the
selectuserattributevalue component sets the value to useronlylocatorcontainer.

lockInstance
<lockInstance>true</lockInstance>

(Optional) Boolean: Whether the component is to lock the form instance automatically when the form
is edited and release the lock when the component is exited (by submitting or canceling) (True) or
not (False).

map
1 <map>
2<height>480</height>
</map>

1 Contains elements that configure the report map view.


2 Default height in pixels for report map view for applets that cannot resize with the browser (for
example, Netscape).

maxidletime
<maxidletime>20</maxidletime>

Specifies how often (in minutes) the Web workflow manager sends event to the server to keep the
session alive.

menugrouptarget
<menugrouptarget>content</menugrouptarget>

Specifies the name of the frame that receives the content generated by a menu selection. If null or
empty, the name of the form that is submitted is used. In Webtop, the content frame name is used.

824 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Components Reference

modifiedwithindays
<modifiedwithindays>7</modifiedwithindays>
Integer: Search for user’s objects that have been modified within the specified number of days.

multidocbasesupport
<multidocbasesupport>false</multidocbasesupport>
Boolean: Whether to enable (true) or disable (false) this locator to search for objects in more than
one repository.

myobjects
<myobjects>myfiles_classic</myobjects>
Specifies component that displays a user’s My Files node.

navigationlinks
<navigationlinks>/webcomponent/testbed/navigationMenu.jsp</navigationlinks>
Displays links to a specified JSP. Used in the WDK Automated Test Framework.

newcomponentname
<newcomponentname>newcabinet</newcomponentname>

Specifies the name of the component that will be launched to create the new object.

nodes
1 <nodes>
2<filter role="administrator, dce_user_manager">
3<node componentid="usermanagement">
4<icon>usermgmt.gif</icon>
5<handlerclass>com.documentum.webtop.webcomponent.administration.
UserManagementNavigationNode</handlerclass>
6<label>
7<nlsid>MSG_USER_MANAGEMENT</nlsid>
</label>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 825
Components Reference

8<streamlinecomponent/>
9<description>
<nlsid>MSG_USER_MANAGEMENT</nlsid>
</description>
</node>
...
</filter>
...
10<docbase_nodes>
<node/>
...
</docbase_nodes>
</nodes>

1 Root element of an element structure that specifies the nodes in a tree. Contains <node> elements.
2 See filter, page 820.
3 Defines a node and its handler. In this element’s componentid attribute, specify the component
to be launched from a tree node in the administration branch of the tree. Contains <icon>, <label>,
<handlerclass>, and <description> elements.
4 File name of the icon to be used for the node.
5 Specifies the class to handle navigation within the node.
6 Specifies the label to be used for the node. May contain the <nlsid> element.
7 NLS lookup key. The string corresponding to the NLS ID is displayed as the label.
8 Specifies the name of the component to be used to display the node when the user switches to the
streamline view
9 String: Description that is displayed in the Description column for the node. May contain the
<nlsid> element.
10 Supports custom Docbase navigation nodes for individual Docbases (contains <node> elements)

nomaclsupport
<nomaclsupport>nomaclsupport_permissions</nomaclsupport>

Specifies the name of the component to use when Trusted Content Services is not enabled for the
repository. Default: permissions component.

nondocbasecolumns
1 <nondocbasecolumns>
2<column>
3<attribute>path</attribute>
4<label>
<nlsid>MSG_PATH</nlsid>
</label>
5<visible>true</visible>
</column>

826 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Components Reference

</nondocbasecolumns>

1 Contains <column> elements that are databound or otherwise provided by the component class but
are not included in the query.
2 Root element for the element structure that configures a column.
3 Attribute to be displayed in the column.
4 Label for the column. Valid value is a string. Can specify an <nlsid> child element instead of a string.
5 Whether to show the column (true) or not (false).

numberedtabs
<numberedtabs>true</numberedtabs>
Boolean: To display each tab’s title with a sequential number (true) or not (false).

objectfilters
1 <objectfilters>
2<objectfilter>
3<label>
<nlsid>MSG_FILTER_FILES</nlsid>
</label>
4<type>dm_document</type>
</objectfilter>
...
</objectfilters>

1 Contains filters that define which objects should be shown in the objects selection list.
2 Specifies a filter for the items that are displayed. Contains <label>, <showfolders>, <type>.
3 Displays a label such as Folders or All. Can contain a string or <nlsid>.
4 To show folders only, set <showfolders> to true and <type> to null (no value). To show objects only,
set <showfolders> to false and <type> to dm_sysobject. To show all, set <showfolders> to true and
<type> to dm_sysobject. <type> can take any value that is a valid Docbase type.

pageTitle
<pageTitle>Webtop Test Bed</pageTitle>
Title displayed for the testbed component. This title can be used to distinguish different versions of
the testbed component used by other WDK‑based applications.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 827
Components Reference

permissionsservice
<permissionsservice>com.documentum.webcomponent.library.permissions.
PermissionsService</permissionsservice>
Specifies the package and class name of the permissions service.

preferencedisplaygroups
<preferencedisplaygroups>
<group id=xxx>
<members>
<preference­ref id=a1 />
<preference­ref id=a2 />
...
</members>
<label><nlsid>MSG_FOO</nlsid></label>
</group>
<group id=yyy>
...
</group>
...
</preferencedisplaygroups>

The order of groups and the order of preferences inside a group controls the display of preference
groups. The preference‑ref element must have an ID that matches an existing preference id in the
<preferences> element of the component definition. The group <label> is used for rendering the
group title.

preferences
1 <preferences>
2<display_docbase_types>
3<docbase_type>
4<value>dm_document</value>
5<label>
6<nlsid>LBL_DOCUMENT</nlsid>
</label>
</docbase_type>
...
</display_docbase_types>
7<show_repeating_attributes>true</show_repeating_attributes>
8<preference id="application.display.classic_cabinets_columns">
9<label>
10<nlsid>CLASSIC_CABINETS_COLUMNS_LABEL</nlsid>
</label>
11<columnlabel>
12<nlsid>CLASSIC_COLUMNS</nlsid>
</columnlabel>

828 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Components Reference

13<type>columnlist</type>
14<display_hint>hidden</display_hint>
15<value>component[id=doclist].columns</value>
16<editcomponent>columnselector</editcomponent>
17<editcontainer>columnselectorcontainer</editcontainer>
</preference>
...
</preferences>

1 Container for preferences.


2 Container for specifying the object types for which column display preferences can be set. Only
used in the display_preferences component.
3 Container to specify an object type.
4 Object type name.
5 The string name to display for the object type.
6 Specifies an NLS key that is resolved to a string in the <nlsbundle> class referenced in the
component definition file.
7 Set to false to not display repeating attributes. Will not affect attributes in the default list or
attributes already in the selected list.
8 Defines the preference and its required ID attribute. Disabled attribute is optional and defaults to
false.
9 (Required) Sets the display name of the preference.
10 (Optional) Specifies an NLS key that is resolved to a string in the <nlsbundle> class referenced in
the component definition file. Use this element inside <label> and <description>.
13 (Required) Specifies the data type of the preference value. Valid value are: int | string |boolean |
columnlist.
14 Forces the control to use a type of display. Valid values are: password (for strings or integers) |
dropdownlist | listbox | hidden. A <constraints> element containing one or more <element> elements
must be present for drop‑down list or list box.
15 Specifies the default value for the preference.
16 Specifies the component to launch for editing the preference. Configures column lists only (<type>
columnlist</type>).
17 Specifies the container to launch for editing the preference. Configures column lists only (<type>
columnlist</type>).

preserve­file­extension
<preserve­file­extension>true</preserve­file­extension>
Whether to keep (true) or strip out (false) the file extension as part of the object name when imported
into the repository.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 829
Components Reference

preset_item
1 <preset_item id="format_filter">
2<selection>
3<entries>
4<entry></entry>
</entries>
</selection>
</preset_item>

1 Preset item. The id attribute specifies the kind of filter that this preset represents.
2 Defines a selection for the preset item.
3 Contains <entry> elements.
4 An entry.

1 <preset_item id="group_filter">
2<selection>
3<entries>
4<entry></entry>
</entries>
</selection>
</preset_item

1 Preset item. The id attribute specifies the kind of filter that this preset represents; in this case, a
filter for groups.
2 Defines a selection for the preset item.
3 Contains <entry> elements.
4 An entry.

1 <preset_item id="format_filter">
2<selection>
3<entries>
4<entry></entry>
</entries>
</selection>
5<allow_nocontent_entry></allow_nocontent_entry>
</preset_item>

1 Preset item. The id attribute specifies the kind of filter that this preset represents; in this case, a
filter for file formats.
2 Defines a selection for the preset item.
3 Contains <entry> elements.
4 An entry.
5 Enables allowing a blank entry.

830 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Components Reference

preset_item_definition
1 <preset_item_definition>
2<id>format_filter</id>
3<package_definition_name>webcomponent</package_definition_name>
4<itemdata_binding_definitions>
5<definition>
6<id>sole_itemdata</id>
7<target_definition_ids>
8<id>checkin_format_filter</id>
...
</target_definition_ids>
</definition>
...
</itemdata_binding_definitions>
</preset_item_definition>

1 Defines a kind of preset item.


2 ID of the kind of preset item; specified in the id attribute of the <preset_item> element.
3 Specifies the preset package name for the definition.
4 Specifies definitions for each item in the preset item definition.
5 Contains <id>, <target_definition> elements.
6 Specifies an ID for the <definition> element.
7 Contains <id> elements.
8 Specifies strings that identify different preset filters.

preset_scope_definitions
1 <preset_scope_definitions>
2<definition>
3<name>docbase</name>
4<package_definition_name>wdk</package_definition_name>
</definition>
...
</preset_scope_definitions>

1 Defines scopes for presets.


2 Defines a single scope.
3 Specifies the name of a scope.
4 Specifies the name of the package definition.

privatecabinet_visible
<privatecabinet_visible>true</privatecabinet_visible>
Boolean: Whether to show (true) or hide (false) private cabinets that are not owned by the session user.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 831
Components Reference

privatecabinetvisible
<privatecabinetvisible>false</privatecabinetvisible>
Boolean: Whether to make private cabinets visible (true) or not (false).

privategroupvisible
<privategroupvisible>false</privategroupvisible>
Boolean: Whether private groups are displayed (true) or not (false).

readOnly
<readOnly>false</readOnly>
Boolean: Whether to display the attributes as read‑only (true) or write (false). Applies to all types.
The readOnly parameter overrides this element.

savedetailsreport
<savedetailsreport>false</savedetailsreport>

Set to true to save the workflow details report in CSV format. Default is false.

search_types
1 <search_types>
2<type id="dm_document">
3<name>
<nlsid>MSG_DOCUMENT</nlsid>
</name>
4<attributes>
5<attribute>
6<name>
<nlsid>MSG_NAME</nlsid>
</name>
7<docbase_attribute>object_name</docbase_attribute>
8<attribute_type>string</attribute_type>
</attribute>
...
</attributes>
</type>
...
</search_types>

832 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Components Reference

1 Contains the types of objects (<type> that are searched for. The first type is the default.
2 The type attribute specifies the object type that is searched for. Value must be a valid object type in
the repository. Contains <name>, <attributes>.
3 Name that will be displayed for the object type. Contains string or <nlsid>.
4 Contains the attributes to be displayed.
5 Specifies an attribute to be displayed.
6 Name that will be displayed for the attribute. Contains string or <nlsid>.
7 Specifies the name of the attribute to be displayed.
8 Specifies the data type of the attribute.

searchtypes
1 <searchtypes>
2<searchtype>
3<displayname>
4<nlsid>MSG_DOCUMENT_BYFULLTEXT</nlsid>
</displayname>
5<docbasetype>dm_document</docbasetype>
6<fulltextsearch showranking="true">true</fulltextsearch>
7<column></column>
</searchtype>
...
</searchtypes>

1 Contains the types of objects (<searchtype> that are searched for. The first type is the default.
2 Contains <displayname>, <docbasetype>, and <fulltextsearch>.
3 Name that will be displayed for the object type. Contains string or <nlsid>.
4 NLS lookup key. The string corresponding to the NLS ID is displayed.
5 Type that is searched for. Value must be a valid object type in the repository.
6 True to perform full‑text search on the type, false to search on properties only. By default, full‑text
search is performed on dm_document and subtypes only. Set the showranking attribute to true to
show the Verity ranking of results.
7 Set to false to hide a column for the attribute that is specified. For example, a value of false and
<column attribute=’r_content_size’> hides the size column for the object type.

selectedattribute
<selectedattribute>object_name</selectedattribute>
Selected attribute value. Set this value in the derived component. For example, the
selectuserattributevalue component sets the value to object_name.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 833
Components Reference

serveroptionenabled
<serveroptionenabled>false</serveroptionenabled>
Whether to display an additional login option for any running content servers (true) or not (false).

service
1 <service>
2<service­class>com.documentum.web.contentxfer.impl.ViewService</service­class>
3<transport­class>com.documentum.web.contentxfer.ucf.UcfContentTransport</transport­class>
4<post­processor­class>com.documentum.webcomponent.library.contenttransfer.view.
LaunchViewer</post­processor­class>
</service>

1 Specifies service classes for content transfer.


2 Specifies the fully qualified class name for the class that implements the service.
3 Specifies the fully qualified class name for the class that implements the transport.
4 Specifies the fully qualified class name for the class that implements any post‑processing.

setrepositoryfromobjectid
<setrepositoryfromobjectid>true</setrepositoryfromobjectid>
Set to true to execute the query against the source repository. Affects reference and foreign objects.

showattachmentinfo
<showattachmentinfo>false</showattachmentinfo>

Boolean: true to show the attachment info.

showautogettask
<showautogettask>true</showautogettask>

Set to true to display a checkbox to get next task automatically.

834 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Components Reference

showbreadcrumb
<showbreadcrumb>true</showbreadcrumb>
Boolean: Whether to display (true) breadcrumbs or not (false).

showfilters
<showfilters>false</showfilters>

True to show object type filters.

showfolderpath
<showfolderpath>true</showfolderpath>

Whether to display (true) the folder path to each result or not (false).

showfolders
<showfolders>false</showfolders>

Sets the user preference for whether to display folders. See type, page 837.

showheaderforsinglepackage
<showheaderforsinglepackage>true</showheaderforsinglepackage>

True to display the attached document header information when there is only one attached document.

showjobstatus
<showjobstatus>true</showjobstatus>
Boolean: Whether to display (true) the current status of a job or not (false).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 835
Components Reference

showoptions
<showoptions>false</showoptions>

Set to true to display the additional options panel on the login page.

showpagesastabs
<showpagesastabs>true</showpagesastabs>
Whether to display attribute categories as tabs (true).

showusertimeandcost
<showusertimeandcost>true</showusertimeandcost>

Whether to enable (true) or disable (false) task duration and cost.

skipVersionCheck
<skipVersionCheck>false</skipVersionCheck>

Boolean: Whether to prompt the user to choose the current version of an object when the object
is not the current version (False) or not (True).

startComp
<startComp>objectlist</startComp>

Specifies the component that will be loaded in the content frame initially.

startQueryString
<startQueryString></startQueryString>

Specifies additional query string parameters to pass to the component loaded in the content frame, for
example, folderPath.

836 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Components Reference

subscriptions
<subscriptions>subscriptions_classic</subscriptions>
Specifies the component that displays the Subscriptions node.

taskmgractionname
<filter clientenv="not portal">
<taskmgractionname>taskmgrstreamline</taskmgractionname>
</filter>

Specifies the name of the taskmanager component.

taskmanagerid
<taskmanagerid>taskmanager</taskmanagerid>

ID of the task manager component accessible from inbox.

transformation

1 <transformation>
2<rendition value="transformationcontainerrendition"></rendition>
3<relation value="transformationcontainernewobject"></relation>
4<choose value="transformationcontainer"></choose>
</transformation>

1 Specifies the components for different transformations.


2 Specifies the component to execute for renditions in the value attribute.
3 Specifies the component to execute for relations in the value attribute.
4 Specifies the component to execute for a choice in the value attribute.

type
<type>dm_sysobject</type>

Default object type for which to search.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 837
Components Reference

ucfrequired
1 <ucfrequired>
2<events>
3<event name="onInit" enabled="false"></event>
...
</events>
4<pages>
5<page name="start" enabled="false"></page>
<page name="invokeucf" enabled="true"></page>
...
</pages>
</ucfrequired>

1 If this element is present, then the component requires UCF to be installed. Contains zero or
more <events> and/or <pages> elements.
2 Contains one or more <event> elements that correspond to events in the component class, for
example, onInit. If the <ucfrequired> element is present and UCF is disabled for events, one or more
pages must have UCF enabled.
3 The component class method must be the value of the <event> name attribute, and the enabled
attribute must be set to false to bypass UCF for the event.
4 Contains one or more <page> elements that correspond to JSP pages in the component definition,
for example, start.
5 The page element in the component definition must be the value of the <page> name attribute, and
the enabled attribute must be set to false to bypass UCF for the page.

updatereplicasource
<updatereplicasource>true</updatereplicasource>

Set to true to add a rendition to both the source and replica document. Set to false to add the rendition
to the selected document only (either a source or replica).

useronly
<useronly>false</useronly>
Boolean: Whether to display users only (true) or not (false) in a recently used or modified list.

useroptions
1 <useroptions>
2<filteroption>

838 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Components Reference

3<label>
4<nlsid>MSG_ALL_QUEUE_TASKS</nlsid>
</label>
</filteroption>
...
</useroptions>

1 Container for filter options to display.


2 Container for a filter option.
3 Filter option name to display.
4 NLS lookup key. The string corresponding to the NLS ID is displayed.

views
1 <views>
2<view applyto="root">
3<queryfiltersets>
4<queryfilterset>
5<queryfilter>
6<displayname>
<nlsid>TAXONOMY</nslid>
</displayname>
7<containertypes>dm_taxonomy</containertypes>
8<includetypes>dm_taxonomy</includetypes>
9<excludetypes>dm_document</excludetypes>
10<attributefilters>
11<attributefilter>
12<and>true</and>
13<attribute>a_status</attribute>
14<predicate>eq</predicate>
15<value dqlformatted="false" casesensitive="true">online</value>
</attributefilter>
...
</attributefilters>
</queryfilter>
</queryfilterset>
</queryfiltersets>
</view>
...
</views>

1 Root element for an element structure that defines the following views:
• root
Displays a hierarchical list of root containers of the selectable objects, for example, cabinets
or folders
• flatlist
Displays all the selectable objects that meet the criteria. By default, myobject and recently used
object locators display results in a flatlist.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 839
Components Reference

• container
Displays a hierarchical list of objects within the selected root container. By default, subscriptions
locators display results in a container (hierarchical) list.
Contains <view> elements.
2 Defines a configuration for a specific view that is specified by the applyto attribute. Each view
element configures root (cabinet view), container, and flatlist views. The applyto attribute must specify
one or more of the views in a comma‑separated list, for example, applyto=’root,container,flatlist’.
3 Element that contains <queryfilterset> elements that display drop‑down lists if there is more than
one filter (<queryfilterset>) defined.
4 Element that contains a set of queries contained in <queryfilter> elements that filter the selection list;
for example, folders only. Defines one dropdown item. Each view can contain up to three filter sets.
5 Defines one DQL query: select <includetypes> from <containertypes> not <excludetypes> where
<attribute> <predicate> <value> <and> <attribute> <predicate> <value>...
6 Specifies the name to be displayed for the queryfilter. Can contain a <nlsid> element or text string.
7 Comma‑separated list of navigable object types, such as dm_cabinet, dm_folder.
8 Optional element (cannot be more than one instance of this element) that specifies a
comma‑separated list of object types to be included in the view. The container must be listed along
with the subtypes within the container; for example, dm_folder, dm_document.
9 Optional element (cannot be more than one instance of this element) that specifies the type of object
to be excluded from the view. if a container type is not one of the subtypes listed in this tag, the
containers are not listed. If a container type is listed, the objects of the container type will be hidden,
for example, dm_folder, dm_document hides all folders or documents.
10 Cannot be more than one instance of this element. Contains <attributefilter> sets that filter objects
based on their attributes.
11 Contains <and>, <attribute>, <predicate>, and <value> to compose an attribute filter.
12 Boolean: true to combine attribute filters, false to perform OR filter (single tag only)
13 (Required) String attribute name, for example, a_content_type (single tag only)
14 Contains a logical operation such as equals. Valid values: sw (starts with), ew (ends with), co
(contains), nc (not contains), eq (equal), ne (not equal), gt (greater than), ge (greater than or equal),
lt (less than), le (less than or equal).
15 Use the attribute dqlformatted=’false’ to quote and escape a value. Use the attribute
casesensitive=’true’ to require a case‑sensitive comparison (must be true for integer attributes on
Content Server/DB2 environment).

windowparams
<windowparams>height=600,width=800</windowparams>

Configuration for the new window. The parameters specified for this element are used when opening
a new window using JavaScript.

840 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
actiondispatcher

workflowstatusactionname
<workflowstatusactionname>workflowstatusdrilldown</workflowstatusactionname>

Specifies the action that calls the workflow status page.

workqueuegroupvisible
<workqueuegroupvisible>false</workqueuegroupvisible>
Boolean: Whether to display (true) work queue groups or not (false).

Actions

actiondispatcher

Purpose
Executes the passed action and, if necessary, displays the login, page 891 component. Any additional
arguments are passed through to the action.

Parameters

action (Required) The action that is called by the


dispatcher

Description
Since
5.x

Configuration File
wdk\config\actiondispatcher_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 841
administration (Webtop)

Scope
All.

Elements
None.

Administration

administration (Webtop)

Purpose
The administration component contains a list of links that launch installed Docbase administration
tools.

Parameters

nodeIds (Optional) IDs of the administration nodes.

Description

Since
5.x

Configuration File
webtop\config\administration_component.xml

Scope
All.

Elements
nodes
See nodes, page 825.

842 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
adminpropertycontainer

adminpropertycontainer

Purpose
Creates administration objects, such as IDfUser, IDfGroup, and IDfACL, based on the object ID or on
the type specified as the value of the element, <objecttype>.<object>. When necessary, this component
handles saving and reverting these objects.

Parameters

objectId (Required) ID of the object for which properties


are displayed

Description
Since
5.x

Configuration File
webcomponent\config\admin\container\adminpropertycontainer_component.xml

Parent Definition
propertysheetwizardcontainer:webcomponent/config/library/propertysheetwizardcontainer/
propertysheetwizardcontainer_component.xml

Scope
All.

Elements
numberedtabs
See numberedtabs, page 827.

objecttype
<objecttype></objecttype>

Specifies the object type of the objects to create.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 843
nodemanagement

nodemanagement

Purpose
Handles nodes on the tree that have subnodes. It reproduces the nodes as a list in the content area.

Parameters

nodeIds (Optional) Target nodes in the tree

Description
Since
5.x

Configuration File
webcomponent\config\admin\nodemanagement\nodemanagement_component.xml

Scope
All.

Elements
None.

Application connectors

appintgcontroller

Purpose
This component launches an action or component and sets up a return listener to load a success
or failure page.

844 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintgcontroller

Parameters

disconnect (Optional) Boolean: Set to true to disconnect all


sessions before execution
dispatchargs (Optional) Argument list to be passed to the
dispatch item.
dispatchitem (Required) Item to be dispatched.
dispatchtype (Required) The action or component.
docbase (Optional) ID of the Docbase to connect to.
locale (Optional) ID of the Locale to use (default is
ʺen_US).
theme (Optional) ID of the Theme to use (default is
ʺwindowsxpsilver).
view (Optional) ID of the view to use(Classic or
Streamline view).

Description
Since
5.x

Configuration File
webcomponent\config\library\appintgcontroller\appintgcontroller_component.xml

Scope
All.

Elements
clientevent
See clientevent, page 811.
dispatchitems
1 <dispatchitems>
2<item>
3<name>appintgnewfromtemplate</name>
4<type>action</type>
5<successpage>opendocumentevent</successpage>
</item>
...
</dispatchitems>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 845
appintgcontroller (Webtop)

1 Root element for a structure that defines the action or component to launch and the success page to
load on successful execution. Contains <item> elements.
2 Containing element for a structure that defines an action or component. Contains <name>, <type>,
and <successpage> elements.
3 Specifies the name (that is, the <action> or <component> element’s id attribute) of the action or
component.
4 Specifies whether this <item> is an action or component.
5 Specifies the success page to be displayed for the action or component.
locale
<locale>en_US</locale>

Specifies the ISO locale in which to display the text of the success or failure page.

menugroupid
1 <menugroupid>appintgmenubar</menugroupid>

1 ID attribute value of a <menugroup> element in the /webcomponent/config/library/


appintgmenubar/appintgmenubar_menugroup.xml file.

theme
<theme>windowsxpsilver</theme>
Webtop user interface theme that includes a set of colors, patterns and fonts.

appintgcontroller (Webtop)

Purpose
This component launches an action or component and sets up a return listener to load a success
or failure page.

Parameters
The parameters are inherited from appintgcontroller:webcomponent/config/library/appintgcontroller/
appintgcontroller_component.xml. See appintgcontroller, page 844.

Description

Since
5.x

846 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintgcontroller (Webtop)

Configuration File
webtop\config\appintgcontroller_component.xml

Parent Definition
appintgcontroller:webcomponent/config/library/appintgcontroller/appintgcontroller_component.xml

Scope
All.

Elements
clientevent
This element structure is inherited from appintgcontroller:webcomponent/config/library/
appintgcontroller/appintgcontroller_component.xml. See appintgcontroller, page 844.

dispatchitems
This element structure is inherited from appintgcontroller:webcomponent/config/library/
appintgcontroller/appintgcontroller_component.xml. See appintgcontroller, page 844.

locale
This element structure is inherited from appintgcontroller:webcomponent/config/library/
appintgcontroller/appintgcontroller_component.xml. See appintgcontroller, page 844.

menugroupid
<menugroupid>appintgmenubar</menugroupid>
This element structure is inherited from appintgcontroller:webcomponent/config/library/
appintgcontroller/appintgcontroller_component.xml. See appintgcontroller, page 844.

theme
This element structure is inherited from appintgcontroller:webcomponent/config/library/
appintgcontroller/appintgcontroller_component.xml. See appintgcontroller, page 844.

view
<view>classic</view>

Default Webtop view to display after user logs in.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 847
appintgcontrollerlogin

appintgcontrollerlogin

Purpose
This component is called when a user attempts to open a repository file from a Windows application
but does not have an active repository session. It extends appintgcontroller, page 844 to fire the
loginsuccess event.

Parameters
The parameters are inherited from appintgcontroller:webcomponent/config/library/appintgcontroller/
appintgcontroller_component.xml. See appintgcontroller, page 844.

Description
Since
5.x

Configuration File
webcomponent\config\library\appintgcontroller\appintgcontroller_component.xml

Parent Definition
appintgcontroller:webcomponent/config/library/appintgcontroller/appintgcontroller_component.xml

Scope
All.

Elements
These element structures are inherited from appintgcontroller:webcomponent/config/library/
appintgcontroller/appintgcontroller_component.xml. See appintgcontroller, page 844.

848 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintgcontrollerlogin (Webtop)

appintgcontrollerlogin (Webtop)

Purpose
This component is called when a user attempts to open a repository file from a Windows application
but does not have an active repository session. It extends appintgcontroller, page 844 to fire the
loginsuccess event.

Parameters
The parameters are inherited from appintgcontroller:webcomponent/config/library/appintgcontroller/
appintgcontroller_component.xml. See appintgcontroller, page 844.

Description
Since
5.x

Configuration File
webtop\config\appintgcontroller_component.xml

Parent Definition
appintgcontroller:webtop/config/appintgcontroller_component.xml

Scope
All.

Elements
view
This element structure is inherited from appintgcontroller:webtop/config/appintgcontroller_
component.xml. See appintgcontroller (Webtop), page 846.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 849
appintghelp

appintghelp

Purpose
This component is used to display help for Application Connector components.

Parameters

helpcontextid (Optional) Used by the WDK framework to


launch a URL to a help file for Application
Connectors

Description
Since
5.x

Configuration File
webcomponent\config\library\appintghelp\appintghelp_component.xml

Scope
All.

Elements
None.

appintginsertcabinetslocator

Purpose
Enables inserting repository files when starting from cabinets; called from within a Windows
application (Application Connectors).

850 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintginsertcategorieslocator

Parameters
The parameters are inherited from appintgopenfromcabinetslocator:webcomponent/
config/library/appintgopenfrom/appintgopenfromcabinetslocator_component.xml. See
appintgopenfromcabinetslocator, page 860.

Description
Since
6.0

Configuration File
webcomponent\config\library\appintginsert\appintginsertcabinetslocator_component.xml

Parent Definition
appintgopenfromcabinetslocator:webcomponent/config/library/appintgopenfrom/
appintgopenfromcabinetslocator_component.xml

Scope
All.

Elements
The element structures are inherited from appintgopenfromcabinetslocator:webcomponent/
config/library/appintgopenfrom/appintgopenfromcabinetslocator_component.xml. See
appintgopenfromcabinetslocator, page 860.

appintginsertcategorieslocator

Purpose
Enables inserting repository files when starting from categories; called from within a Windows
application (Application Connectors).

Parameters
The parameters are inherited from appintgopenfromcategorieslocator:webcomponent/
config/library/appintgopenfrom/appintgopenfromcategorieslocator_component.xml. See
appintgopenfromcategorieslocator, page 862.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 851
appintginsertlocatorcontainer

Description
Since
5.x

Configuration File
webcomponent\config\library\appintginsert\appintginsertcategorieslocator_component.xml

Parent Definition
appintgopenfromcategorieslocator:webcomponent/config/library/appintgopenfrom/
appintgopenfromcategorieslocator_component.xml

Scope
All.

Elements
The parameters are inherited from appintgopenfromcategorieslocator:webcomponent/
config/library/appintgopenfrom/appintgopenfromcategorieslocator_component.xml. See
appintgopenfromcategorieslocator, page 862.

appintginsertlocatorcontainer

Purpose
Enables inserting repository files from within Windows applications. It displays a specific component
for one of several different contexts.

Parameters
The parameters are inherited from appintgopenfromlocatorcontainer:webcomponent/
config/library/appintgopenfrom/appintgopenfromlocatorcontainer_component.xml. See
appintgopenfromlocatorcontainer, page 863.

Description

Since
5.x

852 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintginsertmyfileslocator

Configuration File
webcomponent\config\library\appintginsert\appintginsertlocatorcontainer_component.xml

Parent Definition
appintgopenfromlocatorcontainer:webcomponent/config/library/appintgopenfrom/
appintgopenfromlocatorcontainer_component.xml

Scope
All.

Elements
The element structures are inherited from appintgopenfromlocatorcontainer:webcomponent/
config/library/appintgopenfrom/appintgopenfromlocatorcontainer_component.xml. See
appintgopenfromlocatorcontainer, page 863.

appintginsertmyfileslocator

Purpose
Enables inserting repository files when starting in My Files; called from within a Windows application
(Application Connectors).

Parameters
The parameters are inherited from appintgopenfrommyfileslocator:webcomponent/
config/library/appintgopenfrom/appintgopenfrommyfileslocator_component.xml. See
appintgopenfrommyfileslocator, page 865.

Description

Since
5.x

Configuration File
webcomponent\config\library\appintginsert\appintginsertmyfileslocator_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 853
appintginsertobject

Parent Definition
appintgopenfrommyfileslocator:webcomponent/config/library/appintgopenfrom/
appintgopenfrommyfileslocator_component.xml

Scope
All.

Elements
All element structures are inherited from appintgopenfrommyfileslocator:webcomponent/
config/library/appintgopenfrom/appintgopenfrommyfileslocator_component.xml. See
appintgopenfrommyfileslocator, page 865.

appintginsertobject

Purpose
Downloads object content to the client and sends the InsertObject event; called from within a Windows
application (Application Connectors).

Parameters

contentType (Optional) Content type for filetype filter.


folderId (Optional) Object ID of the folder in which the
locator component initially opens. This folder
is one in which the open document (that is, the
document into which the object is being inserted)
is located.
locatorcomponent (Optional) Name of the locator component to
call.

Description

Since
5.x

854 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintginsertsubscriptionslocator

Configuration File
webcomponent\config\library\appintginsert\appintginsertobject_component.xml

Scope
All.

Elements
None.

appintginsertsubscriptionslocator

Purpose
Enables inserting repository files when starting in Subscriptions; called from within a Windows
application (Application Connectors).

Parameters
The parameters are inherited from appintgopenfromsubscriptionslocator:webcomponent/
config/library/appintgopenfrom/appintgopenfromsubscriptionslocator_component.xml. See
appintgopenfromsubscriptionslocator, page 868.

Description
Since
5.x

Configuration File
webcomponent\config\library\appintginsert\appintginsertsubscriptionslocator_component.xml

Parent Definition
appintgopenfromsubscriptionslocator:webcomponent/config/library/appintgopenfrom/
appintgopenfromsubscriptionslocator_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 855
appintginsertweblink

Elements
All element structures are inherited from appintgopenfromsubscriptionslocator:webcomponent/
config/library/appintgopenfrom/appintgopenfromsubscriptionslocator_component.xml. See
appintgopenfromsubscriptionslocator, page 868.

appintginsertweblink

Purpose
Downloads a virtual link or DRL to the client and sends the InsertWebLink event; called from within a
Windows application (Application Connectors).

Parameters

contentType (Optional) Content type for filetype filter.


folderId (Optional) Location of the current document.
User can then choose a new file name to import
to that folder or an existing document to check in
to the folder, or navigate from the folder.
locatorcomponent (Optional) Locates the destination folder for
import. Specify the component to start with (for
example, myfiles_streamline).

Description
Since
5.x

Configuration File
webcomponent\config\library\appintginsert\appintginsertweblink_component.xml

Scope
All.

856 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintgnewfromtemplate

Elements
None.

appintgnewfromtemplate

Purpose
This component is used to create a new repository object from a template. This component is called
from within a Microsoft Windows application.

Parameters

contentType (Optional) Content type for filetype filter.

Description

Since
5.x

Configuration File
webcomponent\config\library\appintgnewfromtemplate\appintgnewfromtemplate_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 857
appintgopen

appintgopen

Purpose
This component is used to download content for view or edit a file when opened from within a
Windows application. It verifies a user’s permissions, presents a view/edit prompt if necessary, then
performs the view or checkout action as necessary.

Parameters

launchViewer (Optional) Boolean: When true, this component


will load the finish page when called from
Search, Versions, Locations, and Renditions.
objectId (Required) ID of object to view
openDocument (Optional) Set to true to open the document
showViewEdit (Optional) Boolean: Whether to display the
View/Edit prompt to the user (True) or not
(False). Default is true.Since 6.0.

Description
Since
5.x

Configuration File
webcomponent\config\library\appintgopenfrom\appintgopen_component.xml

Scope
All.

Elements
ucfrequired
See ucfrequired, page 838.

858 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintgopenfrom

appintgopenfrom

Purpose
This is the base component used to display locator containers when a file is opened from within a
Windows application.

Parameters

contentType (Optional) Content type for filetype filter


folderId (Optional) ID of folder in which to begin
navigation
launchViewer (Optional) Boolean flag that indicates whether to
launch a viewing application.
locatorcomponent (Optional) ID of the locator component displayed
showViewEdit (Optional) Boolean: Whether to display the
View/Edit prompt to the user (True) or not
(False). Default is true.Since 6.0.

Description
Since
5.x

Configuration File
webcomponent\config\library\appintgopenfrom\appintgopenfrom_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 859
appintgopenfromcabinetslocator

appintgopenfromcabinetslocator

Purpose
Enables opening files when starting from Cabinets; called from Windows applications (Application
Connectors).

Parameters

contentType (Optional) Content type for filetype filter


flatlist (Optional) Boolean: Set to true to display a flat
list of all selectable objects.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) The type of object to open

Description
Since
5.x

Configuration File
webcomponent\config\library\appintgopenfrom\appintgopenfromcabinetslocator_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
allversionsvisible
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

breadcrumbiconwellmode
See breadcrumbiconwellmode, page 810.

860 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintgopenfromcabinetslocator

columns
See columns (for data columns), page 811.

containerselectable
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

contenttypepanelvisible
See contenttypepanelvisible, page 815.

filenamefiltervisible
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

filter
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

filter
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.
iconwell_icon
See iconwell_icon, page 822.
objecttype
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

privatecabinetvisible
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.
views
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 861
appintgopenfromcategorieslocator

appintgopenfromcategorieslocator

Purpose
Enables opening files when starting from Categories; called from Windows applications (Application
Connectors).

Parameters

contentType (Optional) Content type for filetype filter

flatlist (Optional) Boolean: Set to true to display a flat


list of all selectable objects.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) The type of file selected

Description

Since
5.x

Configuration File
webcomponent\config\library\appintgopenfrom\appintgopenfromcategorieslocator_component.
xml

Parent Definition
categorylocator:webcomponent/config/library/locator/categorylocator_component.xml

Scope
All.

Elements
allversionsvisible
This element structure is inherited from categorylocator:webcomponent/config/library/locator/
categorylocator_component.xml. See categorylocator, page 965.

862 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintgopenfromlocatorcontainer

breadcrumbiconwellmode
See breadcrumbiconwellmode, page 810.

columns
See columns (for data columns), page 811.
containerselectable
This element structure is inherited from categorylocator:webcomponent/config/library/locator/
categorylocator_component.xml. See categorylocator, page 965.

contenttypepanelvisible
See contenttypepanelvisible, page 815.
iconwell_icon
See iconwell_icon, page 822.
objecttype
This element structure is inherited from categorylocator:webcomponent/config/library/locator/
categorylocator_component.xml. See categorylocator, page 965.

privatecabinetvisible
This element structure is inherited from categorylocator:webcomponent/config/library/locator/
categorylocator_component.xml. See categorylocator, page 965.

views
See views, page 839.

appintgopenfromlocatorcontainer

Purpose
Enables opening files from the repository; called from Windows applications (Application
Connectors). It displays a specific component for one of several different contexts.

Parameters

component (Optional) ID of the component to be displayed


contentType (Optional) Content type for filetype filter

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 863
appintgopenfromlocatorcontainer

flatlist (Optional) Boolean: Set to true to display a flat


list of all selectable objects.
folderId (Optional) ID of the folder in which to begin the
search

multiselect (Optional) Boolean: Set to true to support


multiple object selection.
objecttype (Optional) Type of object to select

repository (Optional) ID of the repository to be searched.


selectedobjectids (Optional) Comma‑ or semicolon‑separated list
of objects to be selected when the component is
displayed

Description
Since
5.x

Configuration File
webcomponent\config\library\appintgopenfrom\appintgopenfromlocatorcontainer_component.
xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
breadcrumbiconwellmode
See breadcrumbiconwellmode, page 810.

containerselectable
See containerselectable, page 814.
flatlist
See flatlist, page 820.

864 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintgopenfrommyfileslocator

multidocbasesupport
See multidocbasesupport, page 825.

appintgopenfrommyfileslocator

Purpose
This component is used to open a file from a Windows application when the user is navigating the
repository via my files.

Parameters

contentType (Optional) Content type for filetype filter.


flatlist (Optional) Boolean: Set to true to display a flat
list of all selectable objects.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) The type of object to be selected

Description
Since
5.x

Configuration File
webcomponent\config\library\appintgopenfrom\appintgopenfrommyfileslocator_component.xml

Parent Definition
myobjectlocator:webcomponent/config/library/locator/myobjectlocator_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 865
appintgopenfrommyfileslocator

Elements
allversionsvisible
See allversionsvisible, page 809.
breadcrumbiconwellmode
See breadcrumbiconwellmode, page 810.
columns
See columns (for data columns), page 811.
containerselectable
See containerselectable, page 814.

contenttypepanelvisible
See contenttypepanelvisible, page 815.

flatlist
See flatlist, page 820.

iconwell_icon
See iconwell_icon, page 822.

modifiedwithindays
See modifiedwithindays, page 825.

objecttype
<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to select.

privatecabinetvisible
See privatecabinetvisible, page 832.

views
See views, page 839.

866 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintgopenfromrecentfileslocator

appintgopenfromrecentfileslocator

Purpose
This component is used to open files from within a Windows application when the user is navigating
the repository via recent files.

Parameters

contentType (Optional) Content type for filetype filter


flatlist (Optional) Boolean: Set to true to display a flat
list of all selectable objects.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) The type of object to be selected

Description
Since
5.x

Configuration File
webcomponent\config\library\appintgopenfrom\appintgopenfromrecentfileslocator_component.
xml

Parent Definition
recentsysobjectlocator:webcomponent/config/library/locator/recentsysobjectlocator_component.xml

Scope
All.

Elements
breadcrumbiconwellmode
See breadcrumbiconwellmode, page 810.

columns
See columns (for data columns), page 811.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 867
appintgopenfromsubscriptionslocator

containerselectable
See containerselectable, page 814.

iconwell_icon
See iconwell_icon, page 822.
objecttype
1 <objecttype>dm_sysobject</objecttype>

1 Specifies the object type of the objects to be selected.


views
See views, page 839.

appintgopenfromsubscriptionslocator

Purpose
This component is used to open a file from within a Windows application when the user is navigating
the repository via subscriptions.

Parameters

contentType (Optional) Content type for filetype filter


flatlist (Optional) Boolean: Set to true to display a flat
list of all selectable objects.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) The type of object to be selected

Description
Since
5.x

868 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintgopenfromsubscriptionslocator

Configuration File
webcomponent\config\library\appintgopenfrom\appintgopenfromsubscriptionslocator_
component.xml

Parent Definition
subscriptionlocator:webcomponent/config/library/locator/subscriptionlocator_component.xml

Scope
All.

Elements
allversionsvisible
See allversionsvisible, page 809.

breadcrumbiconwellmode
See breadcrumbiconwellmode, page 810.

columns
See columns (for data columns), page 811.

containerselectable
See containerselectable, page 814.
contenttypepanelvisible
See contenttypepanelvisible, page 815.
flatlist
See flatlist, page 820.

iconwell_icon
See iconwell_icon, page 822.

objecttype
1 <objecttype>dm_sysobject</objecttype>

1 Specifies the object type of the objects to be selected.

privatecabinet_visible
<privatecabinet_visible>true</privatecabinet_visible>
See privatecabinet_visible, page 831.

views
See views, page 839.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 869
appintgsaveascabinets

appintgsaveascabinets

Purpose
This component is used by the save ascommand when the user is navigating the repository via cabinets.
This component is displayed in the container appintgsaveascontainer.

Parameters
The parameters are inherited from appintgopenfromcabinetslocator:webcomponent/
config/library/appintgopenfrom/appintgopenfromcabinetslocator_component.xml. See
appintgopenfromcabinetslocator, page 860.

Description
Since
5.x

Configuration File
webcomponent\config\library\appintgsaveas\appintgsaveascabinets_component.xml

Parent Definition
appintgopenfromcabinetslocator:webcomponent/config/library/appintgopenfrom/
appintgopenfromcabinetslocator_component.xml

Scope
All.

Elements
breadcrumbiconwellmode
See breadcrumbiconwellmode, page 810.

columns
See columns (for data columns), page 811.
contenttypepanelvisible
See contenttypepanelvisible, page 815.

870 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintgsaveascategories

filenamefiltervisible
See filenamefiltervisible, page 819.

iconwell_icon
See iconwell_icon, page 822.

appintgsaveascategories

Purpose
This component is used by the save ascommand when the user is navigating the repository via
categories. This component is displayed in the container appintgsaveascontainer.

Parameters
The parameters are inherited from appintgopenfromcategorieslocator:webcomponent/
config/library/appintgopenfrom/appintgopenfromcategorieslocator_component.xml. See
appintgopenfromcategorieslocator, page 862.

Description
Since
5.x

Configuration File
webcomponent\config\library\appintgsaveas\appintgsaveascategories_component.xml

Parent Definition
appintgopenfromcategorieslocator:webcomponent/config/library/appintgopenfrom/
appintgopenfromcategorieslocator_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 871
appintgsaveascontainer

Elements
breadcrumbiconwellmode
1 <breadcrumbiconwellmode>true</breadcrumbiconwellmode>

1 See breadcrumbiconwellmode, page 810.


columns
See columns (for data columns), page 811.
contenttypepanelvisible
1 <contenttypepanelvisible>true</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.

filenamefiltervisible
<filenamefiltervisible>false</filenamefiltervisible>
See filenamefiltervisible, page 819.
iconwell_icon
See iconwell_icon, page 822.

views
See views, page 839.

appintgsaveascontainer

Purpose
This component is used to display components used to perform save as transactions in integrated
applications.

Parameters

component (Optional) The component to be displayed


contentType (Optional) Content type for filetype filter
doCheckout (Optional)

872 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintgsaveascontainer

filenamewithpath (Required) Name and path of the file to be


checked in
flatlist (Optional) Boolean: Set to true to display a flat
list of all selectable objects.
folderId (Optional) ID of the folder in which to save the
object
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) The type of object to be created
repository (Optional) ID of the repository in which to save
the object.
selectedobjectids (Optional) Comma‑ or semicolon‑delimited list
of objects to be selected when the component is
displayed

Description
Since
5.x

Configuration File
webcomponent\config\library\appintgsaveas\appintgsaveascontainer_component.xml

Parent Definition
appintgopenfromlocatorcontainer:webcomponent/config/library/appintgopenfrom/
appintgopenfromlocatorcontainer_component.xml

Scope
All.

Elements
breadcrumbiconwellmode
1 <breadcrumbiconwellmode>true</breadcrumbiconwellmode>

1 See breadcrumbiconwellmode, page 810.

containerselectable
1 <containerselectable>true</containerselectable>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 873
appintgsaveasmyfiles

1 See containerselectable, page 814.


flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.


multidocbasesupport
<multidocbasesupport>false</multidocbasesupport>

See multidocbasesupport, page 825.

appintgsaveasmyfiles

Purpose
This component is used to perform the save ascommand when the user is navigating the repository
via the myfiles file list.

Parameters
The parameters are inherited from appintgopenfrommyfileslocator:webcomponent/
config/library/appintgopenfrom/appintgopenfrommyfileslocator_component.xml. See
appintgopenfrommyfileslocator, page 865.

Description

Since
5.x

Configuration File
webcomponent\config\library\appintgsaveas\appintgsaveasmyfiles_component.xml

Parent Definition
appintgopenfrommyfileslocator:webcomponent/config/library/appintgopenfrom/
appintgopenfrommyfileslocator_component.xml

874 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintgsaveasrecentfiles

Scope
All.

Elements
breadcrumbiconwellmode
1 <breadcrumbiconwellmode>true</breadcrumbiconwellmode>

1 See breadcrumbiconwellmode, page 810.


columns
See columns (for data columns), page 811.
contenttypepanelvisible
1 <contenttypepanelvisible>true</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.


filenamefiltervisible
<filenamefiltervisible>false</filenamefiltervisible>
See filenamefiltervisible, page 819.

iconwell_icon
See iconwell_icon, page 822.

appintgsaveasrecentfiles

Purpose
This component is used to perform the save ascommand when the user is navigating the repository via
a list of recently viewed or edited files.

Parameters
The parameters are inherited from appintgopenfromrecentfileslocator:webcomponent/
config/library/appintgopenfrom/appintgopenfromrecentfileslocator_component.xml. See
appintgopenfromrecentfileslocator, page 867.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 875
appintgsaveassubscriptions

Description
Since
5.x

Configuration File
webcomponent\config\library\appintgsaveas\appintgsaveasrecentfiles_component.xml

Parent Definition
appintgopenfromrecentfileslocator:webcomponent/config/library/appintgopenfrom/
appintgopenfromrecentfileslocator_component.xml

Scope
All.

Elements
breadcrumbiconwellmode
1 <breadcrumbiconwellmode>true</breadcrumbiconwellmode>

1 See breadcrumbiconwellmode, page 810.

columns
See columns (for data columns), page 811.

iconwell_icon
See iconwell_icon, page 822.

appintgsaveassubscriptions

Purpose
This component is used to perform the save ascommand when the user is navigating the repository via
a list of subscriptions.

876 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
appintgsaveassubscriptions

Parameters
The parameters are inherited from appintgopenfromsubscriptionslocator:webcomponent/
config/library/appintgopenfrom/appintgopenfromsubscriptionslocator_component.xml. See
appintgopenfromsubscriptionslocator, page 868.

Description
Since
5.x

Configuration File
webcomponent\config\library\appintgsaveas\appintgsaveassubscriptions_component.xml

Parent Definition
appintgopenfromsubscriptionslocator:webcomponent/config/library/appintgopenfrom/
appintgopenfromsubscriptionslocator_component.xml

Scope
All.

Elements
breadcrumbiconwellmode
1 <breadcrumbiconwellmode>true</breadcrumbiconwellmode>

1 See breadcrumbiconwellmode, page 810.

columns
See columns (for data columns), page 811.
contenttypepanelvisible
1 <contenttypepanelvisible>true</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.


filenamefiltervisible
<filenamefiltervisible>false</filenamefiltervisible>
See filenamefiltervisible, page 819.
iconwell_icon
See iconwell_icon, page 822.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 877
appintgxdql

appintgxdql

Purpose
Returns the results (in XML) of a Documentum Query Language (DQL) query statement.

Parameters

query (Required) DQL query statement.

Description
Since
6.0

Configuration File
webcomponent\config\library\appintgxdql\appintgxdql_component.xml

Scope
All.

Elements
None.

clientapplicationinstaller

Purpose
Lists the Application Connector installers that can be accessed from the current application server.
Supports command line arguments for the installers and does not require authentication.

878 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
clientapplicationinstaller

Parameters

application (Optional) Specifies a comma‑delimited list of


applications to display

Description
Since
5.x

Configuration File
webcomponent\config\library\clientapplicationinstaller\clientapplicationinstaller_component.xml

Scope
All.

Elements
applicationinstallers
The application installer is constructed by concatenating current application server URL, client
application installer, and installer parameters in the following element structure.
1 <applicationinstallers>
2<applicationinstaller>
3<application>appconnectors</application>
4<label>
5<nlsid>MSG_APPCONNECTORS_LABEL</nlsid>
</label>
6<description>
<nlsid>MSG_APPCONNECTORS_DESCRIPTION</nlsid>
</description>
7<installer>/webcomponent/install/appconnector/
Documentum­AppConnectors­Client­5.3.exe</installer>
8<cmdargs>/v"webtopUrl=$APP_SERVER"</cmdargs>
</applicationinstaller>
</applicationinstallers>

1 Contains one or more <applicationinstaller> elements that define the installers.


2 Defines an application installer. Contains <application>, <label>, <description>, <installer>, and
<cmdargs>.
4 Contains a string label or NLS ID key to be displayed.
5 NLS ID key to be displayed.
6 Contains a string description or NLS ID key to be displayed that describes the application.
7 Path to the installer program relative to the Web application root, for example,
/webcomponent/install/appconnector/installer.exe.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 879
about

8 Supports the following system variables as command line arguments: $PROTOCOL, $PORT,
APPLICATION, $APP_SERVER, $ROOT_PATH, $APP_SERVER dynamically passes the application
server URL to the installer, for example, /vwebtopUrl=$APP_SERVERhttp://myserver/webtop.

ucfrequired
See ucfrequired, page 838.

Application management

about

Purpose
Displays information about the version of the application.

Parameters

enableTools (Optional) True to enable the display of DQL


editor and API tester tools

Description
Since
5.x

Configuration File
webcomponent\config\library\about\about_component.xml

Scope
All.

Elements
None.

880 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
about (Webtop)

about (Webtop)

Purpose
Extends the WDK about component and adds information about the Webtop application.

Parameters
The parameters are inherited from about:webcomponent/config/library/about/about_component.xml.
See about, page 880.

Description
Since
5.x

Configuration File
webtop\config\about_component.xml

Parent Definition
about:webcomponent/config/library/about/about_component.xml

Scope
All.

Elements
None.

api

Purpose
Tests and executes Content Server API calls.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 881
authenticate

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\admin\utilities\api_component.xml

Scope
All.

Elements
None.

authenticate

Purpose
Enables a user to log in to an additional content repository. Verifies the user’s name and password.

Parameters

docbase (Required) Name of the content repository


docbroker (Optional) Name of the connection broker
docbrokerPort (Optional) Port number of the connection broker
suppressLoginEvent (Optional) Boolean: Prevents or enables the
login event. Set to true to suppress the client
events loginCancel and loginSuccess used by
Application Connectors.

882 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
authenticate (Webtop)

Description
Since
5.x

Configuration File
wdk\config\authenticate_component.xml

Parent Definition
login:wdk/config/login_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from login:wdk/config/login_component.xml. See login, page 891.

serveroptionenabled
1 <serveroptionenabled>false</serveroptionenabled>
See serveroptionenabled, page 834.

showoptions
See showoptions, page 836.

authenticate (Webtop)

Purpose
Extends the WDK login component and adds a required parameter for the repository to log into. This
component is displayed when the user requests to log in to an additional repository after the initial
login. Called from browsertree (Webtop), page 1476.

Parameters
The parameters are inherited from authenticate:wdk/config/authenticate_component.xml. See
authenticate, page 882.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 883
authenticateexternalsource

Description
Since
5.x

Configuration File
webtop\config\authenticate_component.xml

Parent Definition
authenticate:wdk/config/authenticate_component.xml

Scope
All.

Elements
None.

authenticateexternalsource

Purpose
Enables a user to provide credentials to an external source.

Parameters

externalSource (Required) Path to the external source

Description
Since
5.x

Configuration File
wdk\config\authenticateexternalsource_component.xml

884 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
backdetector

Scope
All.

Elements
None.

backdetector

Purpose
Detects the browser’s back button event during nested navigation to another component and prevents
re‑execution of operation unintentionally for operations that execute on component initialization,
for example, UCF content transfer.

Parameters

ticket (Required) Ticket is generated by a call


to BackDetector.setComponentNested() in
ContentTransferServiceContainer. The caller can
override BackDetector.setComponentNested()
to generate a ticket internally and perform the
redirection accordingly.

Description

Since
5.x

Configuration File
wdk\config\backdetector_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 885
dql

Usage
To handle the Back button event from a nested component in your custom component, add a call to
BackDetector in your event handler that handles the return from nesting:
if (BackDetector.clickBackButton(map))
{
//abort the operation
}

Elements
None.

dql

Purpose
The dql component edits and executes queries to a repository. This component is nested to from the
Webtop about component.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\admin\utilities\dql_component.xml

Scope
All.

Elements
None.

886 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
dqleditor

dqleditor

Purpose
The dqleditor component edits and executes queries to a repository.

Parameters

query (Optional) DQL query

Description
Since
5.x

Configuration File
webcomponent\config\library\dqleditor\dqleditor_component.xml

Scope
All.

Elements
None.

drl

Purpose
Opens a DRL object (document resource locator) and prompts the user to view or edit it. You can also
send an inbox item as a DRL. If the DRL is to an inbox item, the DRL will open the user’s inbox, and
the task manager will open the inbox item. The login component is invoked unless the user has
a session or a default account is configured for anonymous access. The appropriate repository is
derived from the object ID.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 887
drl

Parameters

format (Optional) If the user can edit and view the


passed object, a user interface is presented to
allow the user to choose the action. If no format
is specified for the action, the object’s native
format is used.
objectId (Required) ID of the object identified by the DRL.
versionLabel (Optional) Any labelled version can be passed,
such as CURRENT. If no value is set for
versionLabel and the object’s version is not
current, an open current checkbox is shown.

Description
Since
5.x

Configuration File
wdk\config\drl_component.xml

Scope
All.

Usage
The DRL component displays View and Edit buttons. The event handlers for these buttons call the
drlview (type dm_sysobject), page 480 and drledit (type dm_sysobject), page 476 actions, respectively.
Requires the Nautilus File Manager on Mozilla clients.
DRLs have the following syntax: http:// host_name:port/ app_name/component/drl?objectId=xxx. For
example, the following DRL specifies an object and the format:
http://localhost:8080/webtop/component/drl?
objectId=090056ce8002d6ef&format=msw8

Note: The format argument should not be supplied if the object has no content.
Although 5.3 encryption is supported, this component uses triple DES encryption. So, you should
use the password encryption tool, which uses triple DES encryption. The encrypted password is
specified in this component’s configuration file.
The DRL component supports the following anonymous access functionality:
• Virtual links and DRLs have independent sets of stored credentials for anonymous access.

888 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
drlauthenticate

• If the anonymous user account user does not have permission to perform the requested DRL
operation (view or edit), a login dialog is presented.
• Anonymous credentials are used only for content DRLs, not DRLs to folders or inbox.
• User is logged out of the application after the anonymous DRL operation has been performed.
(Configurable as the <logoffoncomplete> element in the drl component definition.)
You can construct a DRL in your component class by importing the DRLComponent class and calling
constructDRL(String strObjectId, String strVersionLabel, String strFormat, Component component).
The version label and format parameters are optional. The following example initializes a bookmark
control in component JSP page:
BookmarkLink bookmark = (BookmarkLink)getControl(
"bookmark", BookmarkLink.class);
bookmark.setHREF(DRLComponent.constructDRL(
strObjectId, null, null, this));

Elements
defaultaccounts
See defaultaccounts, page 816.

new­pw
Triple DES encrypted password for the anonymous user. Can be encrypted with the Trusted
Authenticator Tool. Refer to Web Development Kit Development Guide for instructions.

password
Password for the anonymous user. If new‑pw is specified, then this element is ignored.

drlauthenticate

Purpose
This component opens an object, prompting the user to select view or edit mode. Note that the opened
object may differ if a version label is passed (for example, CURRENT). The login component is
invoked if necessary.

Parameters
The parameters are inherited from drl:wdk/config/drl_component.xml. See drl, page 887.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 889
index

Description
Since
5.x

Configuration File
wdk\config\drlauthenticate_component.xml

Parent Definition
drl:wdk/config/drl_component.xml

Scope
All.

Usage
Although 5.3 encryption is supported, this component uses triple DES encryption. So, you should
use the password encryption tool, which uses triple DES encryption. The encrypted password is
specified in this component’s configuration file.

Elements
defaultaccounts
This element structure is inherited from drl:wdk/config/drl_component.xml. See drl, page 887.

new­pw
This element structure is inherited from drl:wdk/config/drl_component.xml. See drl, page 887.

password
This element structure is inherited from drl:wdk/config/drl_component.xml. See drl, page 887.

index

Purpose
Not used.

890 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
login

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\navigation\index\index.xml

Scope
All.

Elements
None.

login

Purpose
Performs an explicit login to a single repository or a trusted login to a J2EE application server. The
trusted login will log in to the repositories accessible to the application.

Parameters

docbase (Optional) Specifies the repository to log into


startComponent (Optional) If an entry component name is
specified, the login component will forward to
that component after successful login.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 891
login

startPage (Optional) This parameter sets the component


page that will be displayed on forward.
startUrl (Optional) URL to forward to. If a startURL is
specified, the login component will forward to
that URL after successful login. This value takes
precedence over startComponent. The URL must
be relative to the root context, not relative to the
directory location of the current JSP page.

Description
Since
5.x

Configuration File
wdk\config\login_component.xml

Scope
All.

Usage
For more information on the types of application login, see the section on application login and
authentication inWeb Development Kit Development Guide.
In addition to the showoptions element in the login component definition, the Web application’s
definition file (app.xml) contains an <authentication> element whose child elements <domain> and
<docbase> specify the default domain and repository, respectively. You can configure these values
in the app.xml file in your custom directory (/custom/app.xml).
These values for default domain and repository are used to initialize the login dialog. The user can
change the domain and repository in the login screen, and the user’s selections will be stored in
a cookie for the next login.
Several types of login connections are provided in the WDK authentication framework:
• Login dialog
• Skip authentication (for example, to the login or password component)
• J2EE principal user login
Each Documentum component requires a Documentum connection unless skip authentication is
configured (for example, for the login component). If a Documentum connection is not available when
the component is called, the component dispatcher calls the authentication service to obtain a session.

892 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
login (version 6.0)

If the authentication service does not obtain a session, the dispatcher calls the login component to
create one. The login component then forwards to the original request after authentication.

Elements
failoverenabled
See failoverenabled, page 819.

serveroptionenabled
1 <serveroptionenabled>false</serveroptionenabled>
See serveroptionenabled, page 834.

showoptions
See showoptions, page 836.

login (version 6.0)

Purpose
Performs an explicit login to a single repository or a trusted login to a J2EE application server. The
trusted login will log in to the repositories accessible to the application.

Since
6.5

login (version 6.0) (Webtop)

Purpose
Performs an explicit login to a single repository or a trusted login to a J2EE application server. The
trusted login will log in to the repositories accessible to the application.

Since
6.5

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 893
login (Webtop)

login (Webtop)

Purpose
Extends the WDK login component and displays a login page, adding a Webtop application
identification string in the login screen. The login component is called by the component dispatcher if
a component is called without a valid session.

Parameters
The parameters are inherited from login:wdk/config/login_component.xml. See login, page 891.

Description
Since
5.x

Configuration File
webtop\config\login_component.xml

Parent Definition
login:wdk/config/login_component.xml

Scope
All.

Elements
centered
1 <centered>true</centered>

1 Whether to display the login dialog centered in the frame (true) or left‑aligned (false).

failoverenabled
This element structure is inherited from login:wdk/config/login_component.xml. See login, page 891.

serveroptionenabled
1 <serveroptionenabled>false</serveroptionenabled>
See serveroptionenabled, page 834.

894 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
logoff

showoptions
See showoptions, page 836.

logoff

Purpose
The logoff component is one of the components specified in the file Environment.properties (located
in /WEB‑INF/classes/com/documentum/web/formext) as a non_docbase_component, which means
that it does not require a Documentum session.

Parameters

afterLogoff (Optional) Accepts as a value the following


JavaScript functions on the Window object:
closeWindow | forward
forwardUrl (Optional) URL to which to forward the browser

Description
Since
5.x

Configuration File
wdk\config\logoff_component.xml

Scope
All.

Elements
failoverenabled
1 <failoverenabled>true</failoverenabled>

1 See failoverenabled, page 819.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 895
logoff (Webtop)

logoff (Webtop)

Purpose
Extends the WDK logoff component and displays a Login Again link. The logoff component
invalidates the user’s session.

Parameters
The parameters are inherited from logoff:wdk/config/logoff_component.xml. See logoff, page 895.

Description
Since
5.x

Configuration File
webtop\config\logoff_component.xml

Parent Definition
logoff:wdk/config/logoff_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from logoff:wdk/config/logoff_component.xml. See logoff, page
895.

896 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
main

main

Purpose
The main component is an abstract application entry point. The default Web page in the application
virtual root should redirect to this component. Override the main component to handle all timeouts
and history releases, which by default are redirected to this component.

Parameters
None.

Description
Since
5.x

Configuration File
wdk\config\main_component.xml

Scope
All.

Usage
The default URL for Webtop is http:// server:port/webtop. This URL redirects to the main component.
To redirect your default application page to the main component, use the following JavaScript function
in your default.html or index.html page:
<script>
function redirect()
{
//Get the virtual dir via the window.location.pathname
var strPath = window.location.pathname;
var nIndex1 = strPath.indexOf("/");
var nIndex2 = strPath.indexOf("/", nIndex1 + 1);
var strVirtualDir = strPath.substring(
nIndex1 + 1, nIndex2);
window.location.replace("/"
+ strVirtualDir + "/component/main");
}
</script>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 897
main (version 5.3) (Webtop)

Elements
failoverenabled
See failoverenabled, page 819.

main (version 5.3) (Webtop)

Purpose
Extends the WDK main component and establishes the streamline or classic view for Webtop. This
component is the entry point for the Webtop application. It is called from the index.html and
default.html pages (identical content).

Parameters

callerClientId (Optional) Internally generated ID for the client


browser.
entryPage (Optional) Specifies the entry view. Supported
values: classic and streamline. If entryPage is
not specified, the user’s preference is used. If
no preference, the default view specified in the
<entrypage> element is used.
entrySection (Optional) Determines the browsertree node
(classic view) or tab (streamline view) to start
in. If entrySection is not specified, the cabinets
view is displayed by default for both classic
and streamline views. The section values are
described below: Classic viewThe section
is the Docbase tree node. Valid values are
homecabinet_classic, cabinets, inboxclassic,
subscriptions_classic, myfiles_classic, and
administration. These values correspond
to node IDs in the browsertree component
definition file. Streamline viewThe section
determines the start tab. Valid values are
homecabinet_drilldown, streamlineview,
inboxstreamline, myfiles_streamline, and
subscriptions_streamline. These values are

898 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
main (version 5.3) (Webtop)

specified as tab component IDs in the tab bar


component definition file.
objectId (Optional) Determines the object of the bookmark
(a folder or an object). If the ID is a folder or
cabinet, the folder or cabinet is displayed. If the
ID is an object, the contents of the containing
folder are displayed. The objectId argument
cannot be used with an entrySection argument.

Description
Since
6.0

Configuration File
webtop\config\main_component.xml

Parent Definition
main:wdk/config/main_component.xml

Scope

version 5.3

As of 6.5, changed from “5.3.0” to “5.3”.

Usage
For backward compatibility with version 5.3.

Elements
entrypage
See entrypage, page 819.

failoverenabled
This element structure is inherited from login:wdk/config/main_component.xml. See main, page 897.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 899
main (Webtop)

main (Webtop)

Purpose
Extends the WDK main component and establishes the streamline or classic view for Webtop. This
component is the entry point for the Webtop application. It is called from the index.html and
default.html pages (identical content).

Parameters

callerClientId (Optional) Internally generated ID for the client


browser.
entryPage (Optional) Specifies the entry view. Supported
values: classic and streamline. If entryPage is
not specified, the user’s preference is used. If
no preference, the default view specified in the
<entrypage> element is used.
entrySection (Optional) Determines the browsertree node
(classic view) or tab (streamline view) to start
in. If entrySection is not specified, the cabinets
view is displayed by default for both classic
and streamline views. The section values are
described below: Classic viewThe section
is the Docbase tree node. Valid values are
homecabinet_classic, cabinets, inboxclassic,
subscriptions_classic, myfiles_classic, and
administration. These values correspond
to node IDs in the browsertree component
definition file. Streamline viewThe section
determines the start tab. Valid values are
homecabinet_drilldown, streamlineview,
inboxstreamline, myfiles_streamline, and
subscriptions_streamline. These values are
specified as tab component IDs in the tab bar
component definition file
objectId (Optional) Determines the object of the bookmark
(a folder or an object). If the ID is a folder or
cabinet, the folder or cabinet is displayed. If the
ID is an object, the contents of the containing

900 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newwindow

folder are displayed. The objectId argument


cannot be used with an entrySection argument.

Description

Since
5.x

Configuration File
webtop\config\mainex_component.xml

Parent Definition
main:wdk/config/main_component.xml

Scope
All.

Elements
entrypage
See entrypage, page 819.

failoverenabled
This element structure is inherited from login:wdk/config/main_component.xml. See main, page 897.

newwindow

Purpose
Opens a second WDK application browser window.

Parameters
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 901
newwindow (Webtop)

Description
Since
5.x

Configuration File
webcomponent\config\library\newwindow\newwindow_component.xml

Scope
All.

Elements
windowparams
See windowparams, page 840.

newwindow (Webtop)

Purpose
Launched by the newwindow action to open a second WDK application browser window.

Description
Since
5.x

Configuration File
webtop\config\newwindow_component.xml

Parent Definition
newwindow:webcomponent/config/library/newwindow/newwindow_component.xml

Scope
All.

902 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
portal_login

Elements
windowparams
See windowparams, page 840.

portal_login

Purpose
Enables logging in to a portal.

Parameters

docbase (Optional) For internal use only.


startComponent (Optional) For internal use only.
startPage (Optional) For internal use only.
startUrl (Optional) For internal use only.

Description
Since
5.x

Configuration File
webcomponent\config\library\portallogin\portallogin_component.xml

Scope
All.

Elements
showoptions
See showoptions, page 836.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 903
removecredential

removecredential

Purpose
Removes the user credentials (login name, password, repository, domain) for the specified repository
by deleting the cookie. Saved credentials are turned on by default in /wdk/app.xml. Saved credentials
are used for HTTP session timeout, DRLs, switching repositories, and accessing the application with a
new browser session.

Parameters

docbase (Required) Name of the repository for which the


user credentials will be removed.

Description
Since
5.x

Configuration File
webcomponent\config\environment\preferences\credential\removecredential_component.xml

Scope
All.

Usage
Username and password are encrypted and saved as browser cookies. This means that credentials
saved with one browser, such as IE, will not be available if the user switches to another browser,
such as Netscape.
To turn off the save credentials feature, add the following section to your /custom/app.xml file, within
the <application> element:
<save_credential>
<enabled>false</enabled>
<encryption_key>encryption key here</encryption_key>
<disabled_docbases>
<docbase></docbase>
</disabled_docbases>
</save_credential>

904 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
savecredential

To enable saved credentials in certain repositories, you must enable the credentials and then name the
repositories that will not support saved credentials. In the following example from a /custom/app.xml
file, all repositories except admin support saved credentials:
<save_credential>
<enabled>true</enabled>
<encrypted_key>encryption key here</encrypted_key>
<disabled_docbases>
<docbase>admin</docbase>
</disabled_docbases>
</save_credential>

Note: The encryption key must be identical across all WDK application instances on the application
server. If the key is changed by an administrator, users will be prompted for login. You can use the
trusted authenticator tool (com.documentum.web.formext.session.TrustedAuthenticatorTool). See
Web Development Kit Development Guide for details on this tool.

Elements
None.

savecredential

Purpose
Saves the user credentials (login name, password, repository, domain) as a cookie. This feature is
turned on by default in /wdk/app.xml.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\environment\preferences\credential\savecredential_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 905
sso_login

Scope
All.

Usage
Although 5.3 encryption is supported, this component uses triple DES encryption. This component
automatically performs encryption for each user who saves credentials. You should use the password
encryption tool, which uses triple DES encryption.

Elements
None.

sso_login

Purpose
Enables a user to log in to a content repository using the single sign‑on (SSO) feature.

Parameters
The parameters are inherited from login:wdk/config/login_component.xml. See login, page 891.

Description
Since
5.x

Configuration File
wdk\config\sso_login_component.xml

Parent Definition
login:wdk/config/login_component.xml

Scope
All.

906 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
ucfinvoker

Usage
The component dispatcher must invoke this component to authenticate the user against a particular
repository.

Elements
failoverenabled
This element structure is inherited from login:wdk/config/login_component.xml. See login, page 891.

serveroptionenabled
1 <serveroptionenabled>false</serveroptionenabled>
See serveroptionenabled, page 834.

showoptions
See showoptions, page 836.

ucfinvoker

Purpose
Enables invoking a component using the unified client facilities feature.

Parameters

targetComponent (Optional) ID of the component to invoke.


targetComponentPage (Optional) Name of the component page to
render as named in the component definition

Description
Since
5.x

Configuration File
wdk\config\ucfinvoker_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 907
virtuallinkconnect

Scope
All.

Elements
ucfrequired
See ucfrequired, page 838.

virtuallinkconnect

Purpose
Supports virtual links (URL to a single document) by providing authentication and a list of root
paths that are used to resolve the path in the URL.

Parameters

redirectUrl (Required) URL to be displayed when the object


cannot be located in the repository.
virtualLinkPath (Required) URL to the feature that provides
anonymous access, which allows the use of
predefined login credentials (per repository)
instead of requiring a user to log in using their
credentials.

Description
Since
5.x

Configuration File
wdk\config\virtuallinkconnect_component.xml

Scope
All.

908 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
virtuallinkconnect

Usage
This component is part of the virtual link service. It has no user interface. The component is called
by the browser after the virtual link servlet determines that the URL may contain a virtual link. A
virtual link has this syntax:
http://host[/docbase:path]/document

This component reads the configuration information from its component definition file and provides
authentication details to the virtual link handler based on the user’s current session. If the user does
not have a session, the virtual link service presents a login page or is automatically logged in using
anonymous login.
Although 5.3 encryption is supported, this component uses triple DES encryption. So, you should
use the password encryption tool, which uses triple DES encryption. The encrypted password is
specified in this component’s configuration file.
To support virtual links for anonymous login to multiple repositories, extend the virtuallinkconnect
component’s configuration file in /wdk/virtuallinkconnect_component.xml and add the following
elements with the repository‑specific credentials for the anonymous user and default account
credentials for all other repositories.
<defaultaccounts>
<filter docbase='repository_1">
<!­­ one account per repository­­>
<account>
<username>anonymous_username</username>
<password>encrypted_password</password>
<domain>domain_if_UNIX</domain>
</account>
</filter>
<!­­ default account for all remaining repositories. ­­>
<defaultaccount>
<username>anonymous_user2</username>
<password>encrypted_password2</password>
<domain></domain>
</defaultaccount>
</defaultaccounts>

See Web Development Kit Development Guide for more details about the virtual link service.

Elements
defaultaccounts
1 <defaultaccounts></defaultaccounts>

1 See defaultaccounts, page 816.


failoverenabled
See failoverenabled, page 819.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 909
attributes (type dm_document)

new­pw
Triple DES encrypted password for the anonymous user. Can be encrypted with the Trusted
Authenticator Tool. Refer to Web Development Kit Development Guide for instructions.

password
Password for the anonymous user. If new‑pw is specified, then this element is ignored.

rootpaths
1 <rootpaths>
2<rootpath>/</rootpath>
</rootpaths>

1 Contains one or more <rootpath> elements, which can optionally be enclosed within a <filter>
element.
2 An absolute path to a repository.

Attributes

attributes (type dm_document)

Purpose
Displays the primary attributes of the selected document and includes a link to expand the attributes
list or to display all attributes. The attributes component is designed to run within the container
component properties, page 926.

Parameters
The parameters are inherited from attributes:webcomponent/config/library/attributes/attributes_dm_
sysobject_component.xml. See attributes (type dm_sysobject), page 912.

Description
Since
5.x

910 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attributes (type dm_document)

Configuration File
webcomponent\config\library\attributes\attributes_dm_document_component.xml

Parent Definition
attributes:webcomponent/config/library/attributes/attributes_dm_sysobject_component.xml

Scope

type dm_document

Usage
You can configure the layout of the attributes display using the docbaseattributelist control (see
). See the control description for details. Each category of attributes that is defined in the list layout
Configuration file can be shown as tabs or inline in the properties UI. Set the value of showpagesastabs
in the Configuration file to true to display category tabs.
The Show All attributes functionality is provided by an alternative layout to the base attributes
layout. The layout is switched when the user clicks a link. The link is displayed if the enableshowall
parameter is set to true.

How Attributes are Saved


The OK button in the properties component has an event handler in the parent class DialogContainer,
which calls canCommitChanges() and onCommitChanges(). The latter method is implemented in
the Properties class to save the object.

Using filters
You can configure the attributes definition to display a different UI based on the user role. The
following example allows administrators to see all attributes and allows the attributes to be editable
if they are editable in the repository:
<filter role='administrator'>
<enableShowAll>true</enableShowAll>
</filter>
<readOnly>false</readOnly>

Elements
enableShowAll
<filter role="administrator">
<enableShowAll>true</enableShowAll>
</filter>
See enableShowAll, page 819.

failoverenabled
This element structure is inherited from attributes:webcomponent/config/library/attributes/attributes_
dm_sysobject_component.xml. See attributes (type dm_sysobject), page 912.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 911
attributes (type dm_sysobject)

readOnly
<readOnly>false</readOnly>
See readOnly, page 832.

showpagesastabs
See showpagesastabs, page 836.

attributes (type dm_sysobject)

Purpose
The attributes component displays the primary attributes of the selected object and includes a link
to expand the attributes list or to display all attributes. The attributes component is designed to run
within the container component properties, page 926.

Parameters

enableShowAll (Optional) Boolean: Displays the Show all


attributes link (true) or hides it (false). The
default depends on the user’s role: true for
administrators, false for all non‑administrator
users.
objectId (Required) The ID of the object for which
attributes are to be shown.
readOnly (Optional) Boolean: Displays the attributes as
read‑only (true) or in edit mode (false). This
value does not override the state of the attributes
in the repository. The value of this parameter
does override individual readonly attributes that
are set to false on the docbaseattribute controls
in the UI.

Description
Since
5.x

912 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attributes (type dm_sysobject)

Configuration File
webcomponent\config\library\attributes\attributes_dm_sysobject_component.xml

Scope

type dm_sysobject

Usage
You can configure the layout of the attributes display using the docbaseattributelist control (see
). See the control description for details. Each category of attributes that is defined in the list layout
Configuration file can be shown as tabs or inline in the properties UI. Set the value of showpagesastabs
in the Configuration file to true to display category tabs.
The Show All attributes functionality is provided by an alternative layout to the base attributes
layout. The layout is switched when the user clicks a link. The link is displayed if the enableshowall
parameter is set to true.

How Attributes are Saved


The OK button in the properties component has an event handler in the parent class DialogContainer,
which calls canCommitChanges() and onCommitChanges(). The latter method is implemented in
the Properties class to save the object.
Using filters
You can configure the attributes definition to display a different UI based on the user role. The
following example allows administrators to see all attributes and allows the attributes to be editable
if they are editable in the repository:
<filter role='administrator'>
<enableShowAll>true</enableShowAll>
</filter>
<readOnly>false</readOnly>

Elements
enableShowAll
See enableShowAll, page 819.
failoverenabled
See failoverenabled, page 819.

readOnly
See readOnly, page 832.

showpagesastabs
See showpagesastabs, page 836.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 913
docbaserepeatingattribute

docbaserepeatingattribute

Purpose
Component called by the docbaseattributevalue, page 47 control to display an editing page for
a repeating attribute.

Parameters

control (Required) ID of the docbaseattributevalue


control.

Description
Since
5.x

Configuration File
wdk\config\docbaserepeatingattribute_component.xml

Scope
All.

Usage
When a docbaseattributevalue, page 47 control is used to display an attribute, an Edit link
is displayed if the attribute is repeating, that is, if the attribute allows multiple values. The
docbaserepeatingattribute component is called by an onClick event handler internal to the
docbaseattributevalue control when the user clicks the Edit link. The event handler nests to the
docbaserepeatingattribute component, which means that the docbaserepeatingattribute component is
nested within the component that contains the docbaseattributevalue control.
By default, the docbaserepeatingattribute component opens the repeatingAttributes.jsp page, which
displays an editing screen that allows the user to construct a list of values with an Add/Remove
button. For repeating attributes without value assistance, a text box is displayed to for entry of values.
For repeating attributes with closed‑end value assistance, the user adds values by selecting values
from a list. For repeating attributes with open‑ended value assistance, there is both a text box and a list
of values to select from. The JSP page can be customized by modifying the component definition file.
Note: The docbaserepeatingattribute component can only be called from the docbaseattributevalue
control.

914 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbasesingleattribute

Elements
failoverenabled
See failoverenabled, page 819.

docbasesingleattribute

Purpose
Component called by the docbaseattributevalue, page 47 control to display an editing page for a
single‑value attribute.

Parameters

control (Required) ID of the docbaseattributevalue


control.

Description
Since
5.x

Configuration File
wdk\config\docbasesingleattribute_component.xml

Scope
All.

Usage
When the docbaseattributevalue, page 47 control is used to display an attribute, an Edit link is
displayed if the attribute is single‑valued with open‑ended value assistance. The docbasesingleattribute
component is called by an onClick event handler internal to the docbaseattributevalue control when
the user clicks the Edit link. The event handler nests to the docbasesingleattribute component, which
means that the docbasesingleattribute component is nested within the component that contains the
docbaseattributevalue control.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 915
history

By default, the docbasesingleattribute component opens the singleAttribute.jsp page, which displays
an editing screen that allows the user to either select a value from a list or enter a value in a text box.
The JSP page can be customized by modifying the component definition file.
Note: The docbasesingleattribute component can only be called from the docbaseattributevalue
control.

Elements
None.

history

Purpose
Extends the component objectgrid, page 1194 and displays an object history (audit trail) including
events, users, event source, and time stamp.

Parameters

objectId (Required) ID of the selected object

Description
Since
5.x

Configuration File
webcomponent\config\library\history\history_component.xml

Parent Definition
objectgrid:/webcomponent/config/navigation/objectgrid/objectgrid_component.xml

Scope
All.

916 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
modifyversionlabels

Elements
columns
See columns (for data columns), page 811.
failoverenabled
See failoverenabled, page 819.
header
See header, page 821.
lookuptable
1 <lookuptable>
2<lookup key="dm_archive" nlsid="MSG_ARCHIVE"></lookup>
...
</lookuptable>

1 Contains <lookup> elements that supply user‑friendly textual descriptions for system and user
defined events. NLS mappings are provided in the <nlsbundle> file.
2 Has two configurable attributes: key specifies the attribute name, and nlsid specifies the NLS key
to match to a localized string for the attribute.

nondocbasecolumns
See nondocbasecolumns, page 826.

queryconditionstring
1 <queryconditionstring>audited_obj_id={r_object_id} or (id_5={r_object_
id} and event_name in ('dm_addpackage', 'dm_completedworkitem', 'dm_
removepackage', 'dm_signoff'))</queryconditionstring>

1 Specify the query for events to be shown. The DQL query format will be of the form ʺselect...
from FROM dm_audittrail WHERE queryconditionstring. By default, the following histories will be
displayed: dm_addpackage, dm_completedworkitem, dm_removepackage, and dm_signoff.

modifyversionlabels

Purpose
This component provides the UI and functionality to allow users to modify version labels on objects.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 917
multiobjectsattributes (type dm_sysobject)

Parameters

nodeId (Optional) ID of the node if it is part of a virtual


document
objectId (Required) ID of the object being modified

Description
Since
5.x

Configuration File
webcomponent\config\library\modifyversionlabels\modifyversionlabels_component.xml

Scope
All.

Elements
None.

multiobjectsattributes (type dm_sysobject)

Purpose
Displays the attribute values that are common between more than one selected object.

Parameters

objectId (Required) IDs of the selected objects.

918 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
multiobjectsdocbaserepeatingattribute

Description
Since
5.x

Configuration File
webcomponent\config\library\attributes\multiobjectsattributes_component.xml

Scope

type dm_sysobject

Usage
This component is not valid for Application Connectors.

Elements
failoverenabled
See failoverenabled, page 819.

readOnly
See readOnly, page 832.
showpagesastabs
See showpagesastabs, page 836.

multiobjectsdocbaserepeatingattribute

Purpose
Enables updating repeating‑value attributes that are common between more than one selected object.

Parameters
The parameters are inherited from docbaserepeatingattribute:wdk/config/docbaserepeatingattribute_
component.xml. See docbaserepeatingattribute, page 914.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 919
multiobjectsdocbasesingleattribute

Description
Since
5.x

Configuration File
wdk\config\multiobjectsdocbaserepeatingattribute_component.xml

Parent Definition
docbaserepeatingattribute:wdk/config/docbaserepeatingattribute_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

multiobjectsdocbasesingleattribute

Purpose
Displays single‑value attributes that are common between more than one selected object.

Parameters
The parameters are inherited from docbasesingleattribute:wdk/config/docbasesingleattribute_
component.xml. See docbasesingleattribute, page 915.

Description
Since
5.x

Configuration File
wdk\config\multiobjectsdocbasesingleattribute_component.xml

920 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
multiobjectsproperties

Parent Definition
docbasesingleattribute:wdk/config/docbasesingleattribute_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

multiobjectsproperties

Purpose
Displays the properties common between more than one selected object.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class.) The name of the
component to contain.
componentArgs (Required) Supplied by the LaunchComponent
action execution class.) List of arguments and
values to pass to each contained component.

Description
Since
5.x

Configuration File
webcomponent\config\library\properties\multiobjectsproperties_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 921
multiobjectsselectsingleattributevalue

Scope
All.

Elements
commitorder
See commitorder, page 814.

failoverenabled
See failoverenabled, page 819.

multiobjectsservice
1 <multiobjectsservice>com.documentum.web.formext.control.docbase.
MultiObjectsService</multiobjectsservice>

1 Specifies the multiobject service.

multiobjectsselectsingleattributevalue

Purpose
Provides UI and behavior for selecting a value for a single (not repeating) attribute that is common
between more than one selected object.

Parameters

control (Required) ID of the docbaseattributevalue


control.
locator (Optional) Specifies a selector component to
select a single attribute value
selectedAttribute (Optional) Attribute to be passed to the locator

Description
Since
5.x

922 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
multiobjectsselectuserattributevalue

Configuration File
webcomponent\config\library\selectsingleattributevalue\multiobjectsselectsingleattributevalue_
component.xml

Parent Definition
selectsingleattributevalue:webcomponent/config/library/selectsingleattributevalue/
selectsingleattributevalue_component.xml

Scope
All.

Elements
locator
See locator, page 824.
selectedattribute
See selectedattribute, page 833.

multiobjectsselectuserattributevalue

Purpose
Provides user interface and behavior for selecting a user to supply a value for an attribute that is
common between more than one object.

Parameters
The parameters are inherited from multiobjectsselectsingleattributevalue:webcomponent/config/
library/selectsingleattributevalue/multiobjectsselectsingleattributevalue_component.xml. See
multiobjectsselectsingleattributevalue, page 922.

Description
Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 923
multiobjectsselectuserorgroupattributevalue

Configuration File
webcomponent\config\library\selectsingleattributevalue\multiobjectsselectuserattributevalue_
component.xml

Parent Definition
multiobjectsselectsingleattributevalue:webcomponent/config/library/selectsingleattributevalue/
multiobjectsselectsingleattributevalue_component.xml

Scope
All.

Elements
locator
See locator, page 824.
selectedattribute
See selectedattribute, page 833.

multiobjectsselectuserorgroupattributevalue

Purpose
Provides user interface and behavior for selecting a user or group to supply a value for an attribute
that is common between more than one object.

Since
6.5

924 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
multiobjectsselectuserorgroupidattributevalue

multiobjectsselectuserorgroupidattributevalue

Purpose
Provides user interface and behavior for selecting a user or group to supply a value for the ID attribute
that is common between more than one object.

Since
6.5

multiobjectsversionlabels

Purpose
Displays the version label attribute values of more than one selected object.

Parameters
The parameters are inherited from docbaserepeatingattribute:wdk/config/docbaserepeatingattribute_
component.xml. See docbaserepeatingattribute, page 914.

Description

Since
5.x

Configuration File
wdk\config\multiobjectsversionlabels_component.xml

Parent Definition
versionlabels:wdk/config/versionlabels_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 925
properties

Elements
failoverenabled
See failoverenabled, page 819.

properties

Purpose
Extends the container propertysheetcontainer, page 928 and displays property sheets that show
general information about the selected object, such as name, type, format and owner. The properties
component contains attributes, history, and permissions. The properties component for dm_category
objects extends this properties component.

Parameters

component (Required) The ID of the first contained


component to be shown
objectId (Required) The ID of the object for which
properties are to be shown

Description
Since
5.x

Configuration File
webcomponent\config\library\properties\properties_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope
All.

926 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
properties (type dm_externalresult)

Usage
The following example adds the locations component to the list of properties for an object. Copy
the properties component configuration file from /webcomponent/config/library/properties to your
custom config directory. Add the locations component to the list of contained components:
<contains>
<component>attributes</component>
<component>permissions</component>
<component>history</component>
<component>locations</component>
</contains>

Elements
commitorder
See commitorder, page 814.

failoverenabled
See failoverenabled, page 819.

setrepositoryfromobjectid
<setrepositoryfromobjectid>true</setrepositoryfromobjectid>
See setrepositoryfromobjectid, page 834.

properties (type dm_externalresult)

Purpose
This component is used to display attributes components.

Parameters

component (Required) ID of the component displayed


entryId (Required) Internal key to the query results.
queryId (Required) Internally used to identify the current
search context

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 927
propertysheetcontainer

Description
Since
5.x

Configuration File
webcomponent\config\library\properties\dm_externalresult_properties_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope

type dm_externalresult

Elements
failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

propertysheetcontainer

Purpose
Extends wizardcontainer, page 1201 and contains attributes, history, and permissions.

Parameters

component (Required) The contained component. Set the


requiresVisit attribute to true to require the
component to be visited before an OK button is
displayed.

928 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
propertysheetcontainer

Description
Since
5.x

Configuration File
wdk\config\propertysheetcontainer_component.xml

Parent Definition
wizardcontainer:wdk/config/wizardcontainer_component.xml

Scope
All.

Usage
The property sheet wizard container extends the propertysheetcontainer container and adds support
for wizard‑type navigation through the pages of a component (Previous and Next buttons) and
through components in the container (tabs).
Some examples of containers that extend the propertysheetwizardcontainer include
adminpropertysheetcontainer, newcabinet, newdoc, and newfolder containers.
Set requiresVisit attribute to true to declare that a particular component must be visited before the
container can commit changes. In the following example, the attributes component must be viewed
before the user can commit changes:
<contains>
<component>newFolder</component>
<component requiresVisit='true'>attributes</component>
<component>permissions</component>
</contains>

You can also declare the visit requirement in the individual component definition. Add the following
tag to a component definition:
<requiresVisitBeforeCommit>true</requiresVisitBeforeCommit>

Elements
failoverenabled
See failoverenabled, page 819.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 929
propertysheetwizardcontainer

propertysheetwizardcontainer

Purpose
Extends the container propertysheetcontainer, page 928 and contains propertysheetcontainer, page
928 and wizardcontainer, page 1201. This container has Previous and Next buttons that move
through pages in the currently selected components and another set of buttons that move through the
contained components. The contained components are presented as horizontal tabs.

Parameters

component (Required) The contained component. Set the


requiresVisit attribute to true to require the
component to be visited before an OK button is
displayed.

Description
Since
5.x

Configuration File
webcomponent\config\library\propertysheetwizardcontainer\propertysheetwizardcontainer_
component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope
All.

Usage
If your component extends propertysheetwizardcontainer and you wish to show the contained
components as vertical tabs, call setcomponentpage(ʺvertical_tabsʺ) in your component class.

930 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
rename

Elements
failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.
numberedtabs
See numberedtabs, page 827.

rename

Purpose
Provides a simple UI for users to rename objects by entering a new name in a single text‑edit field on a
form. Webtop does not provide a menu to access this component.

Parameters

objectId (Required) ID of the object to rename

Description
Since
5.x

Configuration File
webcomponent\config\library\rename\rename_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 931
selectmultipleuserattributevalue

selectmultipleuserattributevalue

Purpose
Provides UI and behavior for selecting multiple users for which to supply a common attribute value.

Parameters
Since 6.0 SP1.

control (Required) ID of the docbaseattributevalue


control.
locator (Optional) Specifies a selector component to
select a single attribute value
objectId (Optional) Object ID of the object on which the
component was invoked to select users. If the
object is governed by a room, then a RoomUser
locator component is invoked; otherwise, a
UserLocator component is invoked.
selectedAttribute (Optional) Attribute to be passed to the locator
selectedobjectids (Optional) Object IDs of the user objects that are
selected on the right side of the page.

Description

Since
5.x

Configuration File
webcomponent\config\library\selectsingleattributevalue\selectmultipleuserattributevalue_
component.xml

Parent Definition
selectrepeatingattributevalue:webcomponent/config/library/selectsingleattributevalue/
selectrepeatingattributevalue_component.xml

Scope
All.

932 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
selectmultipleuseridattributevalue

Elements
locator
See locator, page 824.
roomlocator
<roomlocator></roomlocator>
Room locator component to be launched for selecting the attribute value.
Since 6.0 SP1.

selectedattribute
See selectedattribute, page 833.

selectmultipleuseridattributevalue

Purpose
Enables selection of multiple users to supply repeating‑value attribute values.

Parameters
The parameters are inherited from selectrepeatingattributevalue:webcomponent/config/
library/selectsingleattributevalue/selectrepeatingattributevalue_component.xml. See
selectrepeatingattributevalue, page 935.

Description
Since
6.0

Configuration File
webcomponent\config\library\selectsingleattributevalue\selectmultipleuserattributevalue_
component.xml

Parent Definition
selectmultipleuserattributevalue:webcomponent/config/library/selectsingleattributevalue/
selectmultipleuserattributevalue_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 933
selectmultipleuserorgroupattributevalue

Scope
All.

Elements
locator
See locator, page 824.

selectedattribute
<selectedattribute>r_object_id</selectedattribute>
See selectedattribute, page 833.

selectmultipleuserorgroupattributevalue

Purpose
Provides UI and behavior for selecting multiple users or groups for which to supply a common
attribute value.

Parameters
Since 6.0 SP1.
The parameters are inherited from selectmultipleuserattributevalue:webcomponent/config/
library/selectrepeatingattributevalue/selectmultipleuserattributevalue_component.xml. See
selectmultipleuserattributevalue, page 932.

Description

Since
6.0

Configuration File
webcomponent\config\library\selectrepeatingattributevalue\selectmultipleuserorgroupattributevalue_
component.xml

Parent Definition
Since 6.0 SP1.

934 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
selectrepeatingattributevalue

selectmultipleuserattributevalue:webcomponent/config/library/selectrepeatingattributevalue/
selectmultipleuserattributevalue_component.xml

Scope
All.

Elements
locator
See locator, page 824.
roomlocator
Since 6.0 SP1.
<roomlocator></roomlocator>
Room locator component to be launched for selecting the attribute value.
selectedattribute
See selectedattribute, page 833.

selectrepeatingattributevalue

Purpose
Component called by the docbaseattributevalue, page 47 control to display an editing page for
a repeating‑value attribute.

Parameters

control (Required) ID of the docbaseattributevalue


control.
locator (Optional) Specifies a selector component to
select a repeating‑value attribute value.
selectedAttribute (Optional) Attribute to be passed to the locator.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 935
selectsingleattributevalue

Description
Since
5.x

Configuration File
webcomponent\config\library\selectsingleattributevalue\selectrepeatingattributevalue_component.
xml

Parent Definition
docbaserepeatingattribute:wdk/config/docbaserepeatingattribute_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from docbaserepeatingattribute:wdk/config/
docbaserepeatingattribute_component.xml. See docbaserepeatingattribute, page 914.
locator
See locator, page 824.
selectedattribute
<selectedattribute>object_name</selectedattribute>
See selectedattribute, page 833.

selectsingleattributevalue

Purpose
Provides UI and behavior for selecting a single (not repeating) attribute value.

936 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
selectsingleattributevalue

Parameters

control (Required) ID of the docbaseattributevalue


control.
locator (Optional) Specifies a selector component to
select a single attribute value
selectedAttribute (Optional) Attribute to be passed to the locator

Description
Since
5.x

Configuration File
webcomponent\config\library\selectsingleattributevalue\selectsingleattributevalue_component.xml

Parent Definition
docbasesingleattribute:wdk/config/docbasesingleattribute_component.xml

Scope
All.

Usage
Extend this component to provide a locator for an open‑ended attribute value of a single‑value
attribute. Register your component as the value of the <editcomponent> element for the desired
attribute in a docbaseobjectconfiguration file. For more information on docbaseobject configuration,
refer to docbaseobject, page 54.

Elements
failoverenabled
See failoverenabled, page 819.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 937
selectuserattributevalue

selectuserattributevalue

Purpose
Attribute value selector that provides a user interface and behavior for selecting a user.

Parameters
Since 6.0 SP1.

control (Required) ID of the docbaseattributevalue


control.
locator (Optional) Specifies a selector component to
select a single attribute value
objectId (Optional) Object ID of the object on which the
component was invoked to select users. If the
object is governed by a room, then a RoomUser
locator component is invoked; otherwise, a
UserLocator component is invoked.
selectedAttribute (Optional) Attribute to be passed to the locator
selectedobjectids (Optional) Object IDs of the user objects that are
selected on the right side of the page.

Description

Since
5.x

Configuration File
webcomponent\config\library\selectsingleattributevalue\selectuserattributevalue_component.xml

Parent Definition
selectsingleattributevalue:webcomponent/config/library/selectsingleattributevalue/
selectsingleattributevalue_component.xml

Scope
All.

938 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
selectuseridattributevalue

Elements
locator
See locator, page 824.
roomlocator
<roomlocator></roomlocator>
Room locator component to be launched for selecting the attribute value.
Since 6.0 SP1.

selectedattribute
See selectedattribute, page 833.

selectuseridattributevalue

Purpose
Enables selection of a user to supply single‑value attribute values.

Parameters
The parameters are inherited from selectsingleattributevalue:webcomponent/config/library/
selectsingleattributevalue/selectsingleattributevalue_component.xml. See selectsingleattributevalue,
page 936.

Description
Since
6.0

Configuration File
webcomponent\config\library\selectsingleattributevalue\selectuserattributevalue_component.xml

Parent Definition
selectuserattributevalue:webcomponent/config/library/selectsingleattributevalue/
selectuserattributevalue_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 939
selectuserorgroupattributevalue

Scope
All.

Elements
locator
See locator, page 824.

selectedattribute
See selectedattribute, page 833.

selectuserorgroupattributevalue

Purpose
Attribute value selector that provides a user interface and behavior for selecting a user or group.

Parameters
The parameters are inherited from selectsingleattributevalue:webcomponent/config/library/
selectsingleattributevalue/selectsingleattributevalue_component.xml. See selectsingleattributevalue,
page 936.

Description
Since
6.0

Configuration File
webcomponent\config\library\selectsingleattributevalue\selectuseror groupattributevalue_
component.xml

Parent Definition
selectuserattributevalue:webcomponent/config/library/selectsingleattributevalue/
selectuserattributevalue_component.xml

940 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
versionlabels

Scope
All.

Elements
locator
See locator, page 824.

roomlocator
<roomlocator></roomlocator>
Room locator component to be launched for selecting the attribute value.
Since 6.0 SP1.

selectedattribute
See selectedattribute, page 833.

versionlabels

Purpose
Allows editing of version labels

Parameters
The parameters are inherited from docbaserepeatingattribute:wdk/config/docbaserepeatingattribute_
component.xml. See docbaserepeatingattribute, page 914.

Description

Since
5.x

Configuration File
wdk\config\versionlabels_component.xml

Parent Definition
docbaserepeatingattribute:wdk/config/docbaserepeatingattribute_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 941
versions (type dm_sysobject)

Scope
All.

Elements
failoverenabled
This element structure is inherited from docbaserepeatingattribute:wdk/config/
docbaserepeatingattribute_component.xml. See docbaserepeatingattribute, page 914.

versions (type dm_sysobject)

Purpose
Extends objectgrid, page 1194, displays and allows users to edit version information on an object.

Parameters

objectId (Required) ID of the selected object

Description
Since
5.x

Configuration File
webcomponent\config\library\versions\versions_component.xml

Parent Definition
objectgrid:/webcomponent/config/navigation/objectgrid/objectgrid_component.xml

Scope

type dm_sysobject

942 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
versions (type dm_sysobject) (Webtop)

Elements
columns
See columns (for streamline view), page 811.
dragdrop
See dragdrop, page 818.
header
See header, page 821.
nondocbasecolumns
See nondocbasecolumns, page 826.

versions (type dm_sysobject) (Webtop)

Purpose
Extends the WDK versions component component and displays the versions for the selected object.

Parameters
The parameters are inherited from versions:webcomponent/config/library/versions/versions_
component.xml. See versions (type dm_sysobject), page 942.

Description
Since
5.x

Configuration File
webtop\config\versions_component.xml

Parent Definition
versions:webcomponent/config/library/versions/versions_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 943
versions (type wdk5_testtype_1)

Scope

type dm_sysobject

Elements
columns
See columns (for streamline view), page 811.

columns_list
See columns_list, page 812.

dragdrop
This element structure is inherited from versions:webcomponent/config/library/versions/versions_
component.xml. See versions (type dm_sysobject), page 942.
nondocbasecolumns
See nondocbasecolumns, page 826.

versions (type wdk5_testtype_1)

Purpose
Extendsobjectgrid, page 1194, displays, and edits version information on an object.

Parameters
The parameters are inherited from versions:/webcomponent/config/library/versions/versions_
component.xml. See versions (type dm_sysobject), page 942.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

944 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
versions (type wdk5_testtype_2)

Parent Definition
versions:/webcomponent/config/library/versions/versions_component.xml

Scope

type wdk5_testtype_1

Elements
columns
See columns (for streamline view), page 811.
dragdrop
See dragdrop, page 818.
nondocbasecolumns
See nondocbasecolumns, page 826.

versions (type wdk5_testtype_2)

Purpose
Extends objectgrid, page 1194 and displays and edits version information on an object.

Parameters
The parameters are inherited from versions:/webcomponent/config/library/versions/versions_
component.xml. See versions (type dm_sysobject), page 942.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 945
versions (type wdk5_testtype_3)

Parent Definition
versions:/webcomponent/config/library/versions/versions_component.xml

Scope

type wdk5_testtype_2

Elements
columns
See columns (for streamline view), page 811.
dragdrop
See dragdrop, page 818.
nondocbasecolumns
See nondocbasecolumns, page 826.

versions (type wdk5_testtype_3)

Purpose
Extends objectgrid, page 1194 and displays and edits version information on an object.

Parameters
The parameters are inherited from versions:/webcomponent/config/library/versions/versions_
component.xml. See versions (type dm_sysobject), page 942.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

946 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
allfolderlocator

Parent Definition
versions:/webcomponent/config/library/versions/versions_component.xml

Scope

type wdk5_testtype_3

Elements
columns
See columns (for streamline view), page 811.
dragdrop
See dragdrop, page 818.
nondocbasecolumns
See nondocbasecolumns, page 826.

Cabinets and folders

allfolderlocator

Purpose
Locates dm_folder objects in a repository and displays them in a hierarchical view. Users can navigate
from the root cabinets to locate an object.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description
Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 947
allfolderlocator

Configuration File
webcomponent\config\library\locator\folderlocators_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
iconwell_icon
See iconwell_icon, page 822.

objecttype

<objecttype>dm_folder</objecttype>

Specifies the object type of the objects to locate.

containerselectable

1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

allversionsvisible

1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

views
See views, page 839.

948 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attributes (type dm_folder)

columns
See columns (for data columns), page 811.

contenttypepanelvisible
See contenttypepanelvisible, page 815.
filenamefiltervisible
See filenamefiltervisible, page 819.

attributes (type dm_folder)

Purpose
Displays the primary attributes of the selected folder and includes a link to expand the attributes list
or to display all attributes.

Parameters
The parameters are inherited from attributes:webcomponent/config/library/attributes/attributes_dm_
sysobject_component.xml. See attributes (type dm_sysobject), page 912.

Description
Since
5.x

Configuration File
webcomponent\config\library\attributes\attributes_dm_folder_component.xml

Parent Definition
attributes:webcomponent/config/library/attributes/attributes_dm_sysobject_component.xml

Scope

type dm_folder

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 949
attributes (type dm_folder)

Usage
You can configure the layout of the attributes display using the docbaseattributelist control (see
). See the control description for details. Each category of attributes that is defined in the list layout
Configuration file can be shown as tabs or inline in the properties UI. Set the value of showpagesastabs
in the Configuration file to true to display category tabs.
The Show All attributes functionality is provided by an alternative layout to the base attributes
layout. The layout is switched when the user clicks a link. The link is displayed if the enableshowall
parameter is set to true.

Using filters
You can configure the attributes definition to display a different UI based on the user role. The
following example allows administrators to see all attributes and allows the attributes to be editable
if they are editable in the repository:
<filter role='administrator'>
<enableShowAll>true</enableShowAll>
</filter>
<readOnly>false</readOnly>

How Attributes are Saved


The OK button in the properties component has an event handler in the parent class DialogContainer,
which calls canCommitChanges() and onCommitChanges(). The latter method is implemented in
the Properties class to save the object.

Elements
showpagesastabs
See showpagesastabs, page 836.

failoverenabled
This element structure is inherited from attributes:webcomponent/config/library/attributes/attributes_
dm_sysobject_component.xml. See attributes (type dm_sysobject), page 912.

enableShowAll
See enableShowAll, page 819.
readOnly
See readOnly, page 832.

950 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
cabinetslocator

cabinetslocator

Purpose
The cabinetslocator component is a basic sysobject locator that displays folders and the content type.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\cabinetslocator_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
iconwell_icon
See iconwell_icon, page 822.

filter
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

filter
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 951
delete (type dm_folder)

columns
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

objecttype
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.
containerselectable
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

privatecabinetvisible
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.
allversionsvisible
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

contenttypepanelvisible
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

filenamefiltervisible
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

views
This element structure is inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

delete (type dm_folder)

Purpose
The delete component deletes dm_folders and other dm_sysobjects, deletes inbox notifications
(dm_notification and dm_queued), and deletes folders (queries the user whether all objects should be
deleted from a folder selected for deletion). This component must be used within the deletecontainer
component.

952 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newcabinet

Parameters

folderId (Optional) ID of the parent folder of the file or


folder that is to be deleted. Applies only to
dm_folder and dm_sysobject types.
objectId (Required) ID of the object to be deleted. Applies
to all types.

Description
Since
5.x

Configuration File
webcomponent\config\library\delete\deletefolder_component.xml

Scope

type dm_folder

Elements
None.

newcabinet

Purpose
Creates a new cabinet. This component must run within the component newcabinetcontainer, page
955.

Parameters
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 953
newcabinet

Description
Since
5.x

Configuration File
webcomponent\config\library\create\newcabinet_component.xml

Scope
All.

Elements
base_type
See base_type, page 810.

default_type
See default_type, page 815.

cabinet_filter

1 <cabinet_filter>
2<preset_item id="type_filter">
<selection>
<entries>
<entry></entry>
</entries>
</selection>
</preset_item>
</cabinet_filter>

1 Specifies an object type preset filter for cabinets.


2 Standard preset_item structure that specifies an object type filter. See preset_item, page 830.

preset_item
See preset_item, page 830.

954 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newcabinetcontainer

newcabinetcontainer

Purpose
Extends propertysheetwizardcontainer, page 930 and contains attributes, newcabinet, and
permissions. The newcabinet component requires a visit.

Parameters

component (Required) Supplied by the action execution


class). The name of the component to contain.

Description
Since
5.x

Configuration File
webcomponent\config\library\create\newcabinetcontainer_component.xml

Parent Definition
propertysheetwizardcontainer:webcomponent/config/library/propertysheetwizardcontainer/
propertysheetwizardcontainer_component.xml

Scope
All.

Usage
The container parameters are added by the LaunchComponent action execution class in order to
support actions on multiple objects. Do not call the container by URL.

Elements
newcomponentname
See newcomponentname, page 825.

numberedtabs
See numberedtabs, page 827.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 955
newfolder

newfolder

Purpose
Creates a new folder. This component must run within the component newfoldercontainer, page 957.

Parameters

objectId (Required) ID of the folder or cabinet that will


contain the new folder.

Description
Since
5.x

Configuration File
webcomponent\config\library\create\newfolder_component.xml

Scope
All.

Elements
base_type
See base_type, page 810.

default_type
See default_type, page 815.

folder_filter
See folder_filter, page 820.

956 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newfoldercontainer

newfoldercontainer

Purpose
Extends propertysheetwizardcontainer, page 930 and contains attributes, newfolder, and permissions.
The newfolder container requires a visit.

Parameters

component (Required): The name of the component to


contain. Supplied by the action execution class.

Description
Since
5.x

Configuration File
webcomponent\config\library\create\newfoldercontainer_component.xml

Parent Definition
propertysheetwizardcontainer:webcomponent/config/library/propertysheetwizardcontainer/
propertysheetwizardcontainer_component.xml

Scope
All.

Elements
numberedtabs
See numberedtabs, page 827.

newcomponentname
See newcomponentname, page 825.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 957
attributes (type dm_category)

Categories

attributes (type dm_category)

Purpose
The attributes component displays the primary attributes of the selected object and includes a link
to expand the attributes list or to display all attributes. The attributes component is scoped for
dm_sysobject, dm_document, and dm_folder, with three different JSP pages to display attributes.

Parameters
The parameters are inherited from attributes:webcomponent/config/library/attributes/attributes_dm_
sysobject_component.xml. See attributes (type dm_sysobject), page 912.

Description
Since
5.x

Configuration File
webcomponent\config\library\properties\dm_category_properties_component.xml

Parent Definition
attributes:webcomponent/config/library/attributes/attributes_dm_folder_component.xml

Scope

type dm_category

Usage
You can configure the layout of the attributes display using the docbaseattributelist control. See
the control description for details. Each category of attributes that is defined in the list layout
Configuration file can be shown as tabs or inline in the properties UI. Set the value of showpagesastabs
in the Configuration file to true to display category tabs.

958 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
categoriesnotenabled

The Show All attributes functionality is provided by an alternative layout to the base attributes
layout. The layout is switched when the user clicks a link. The link is displayed if the enableshowall
parameter is set to true.

Using filters
You can configure the attributes definition to display a different UI based on the user role. The
following example allows administrators to see all attributes and allows the attributes to be editable
if they are editable in the repository:
<filter role='administrator'>
<enableShowAll>true</enableShowAll>
</filter>
<readOnly>false</readOnly>

How Attributes are Saved


The OK button in the properties component has an event handler in the parent class DialogContainer,
which calls canCommitChanges() and onCommitChanges(). The latter method is implemented in
the Properties class to save the object.

Elements
readOnly
See readOnly, page 832.

showpagesastabs
See showpagesastabs, page 836.

categoriesnotenabled

Purpose
Displays a message that CIS is not enabled for the repository.

Parameters
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 959
categoryattributes

Description
Since
5.x

Configuration File
webcomponent\config\navigation\category\categorylist_component.xml

Scope
All.

Elements
None.

categoryattributes

Purpose
Sets the attributes of a work queue category.

Parameters

categoryPath (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs
objectId (Required) ID of the work queue category object

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\categoryattributes_component.xml

960 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
categoryclassic (Webtop)

Scope
All.

Elements
None.

categoryclassic (Webtop)

Purpose
Extends the component WDK categorylist component and displays categories in a classic view. Only
categories with a status of ʺonlineʺ are shown.

Parameters

folderId (Optional) ID of the category folder to navigate.


folderPath (Optional) Specifies the path to the folder in
which to start browsing. This path must be
a complete path from the repository root, for
example, /Documentation/Library/subfolder
nodeIds (Optional) List of dot‑separated object IDs used
to build an absolute location to display the
categories.

Description

Since
6.0

Configuration File
webtop\config\categoryclassic_component.xml

Parent Definition
categorylist:webcomponent/config/navigation/category/categorylist_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 961
categorydrilldown

Scope
All.

Elements
showfilters
See showfilters, page 835.

failoverenabled
This element structure is inherited from categorylist:webcomponent/config/navigation/category/
categorylist_component.xml. See categorylist, page 963.

objectfilters
See objectfilters, page 827.
columns
See columns (for streamline view), page 811.
preset_item
See preset_item, page 830.

categorydrilldown

Purpose
Allows the user to view CIS categories in a streamline style presentation. The repository must have CI
types installed and configured to use this component.

Parameters

folderId (Optional) ID of the category folder to navigate


folderPath (Optional) Specifies the path to the folder in
which to start browsing. This path must be
a complete path from the repository root, for
example, /Documentation/Library/subfolder

962 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
categorylist

Description
Since
5.x

Configuration File
webcomponent\config\navigation\category\categorydrilldown_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

showfilters
See showfilters, page 835.

objectfilters
See objectfilters, page 827.
columns
See columns (for streamline view), page 811.

categorylist

Purpose
Allows the user to browse CIS categories in a classic (tree and content frame) presentation. The
repository must have CI types installed and configured to use this component.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 963
categorylist

Parameters

folderId (Optional) ID of the category folder to navigate


folderPath (Optional) Specifies the path to the folder in
which to start browsing. This path must be
a complete path from the repository root, for
example, /Documentation/Library/subfolder

Description
Since
5.x

Configuration File
webcomponent\config\navigation\category\categorylist_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.
showfilters
See showfilters, page 835.

objectfilters
See objectfilters, page 827.

columns
See columns (for streamline view), page 811.
preset_item
See preset_item, page 830.

964 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
categorylocator

categorylocator

Purpose
Enables users to select categories.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\categorylocator_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
objecttype

<objecttype>dm_category</objecttype>

Specifies the object type of the objects to locate.


containerselectable

1 <containerselectable>false</containerselectable>

1 See containerselectable, page 814.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 965
categorylocatorcontainer

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

allversionsvisible

1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

views
See views, page 839.

columns
See columns (for data columns), page 811.
contenttypepanelvisible

1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.

filenamefiltervisible

<filenamefiltervisible>true</filenamefiltervisible>
See filenamefiltervisible, page 819.

categorylocatorcontainer

Purpose
Enables users to select categories.

966 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
categorystreamline (Webtop)

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\categorylocator_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

categorystreamline (Webtop)

Purpose
Displays categories in a streamline view. Only categories with a status of ʺonlineʺ are shown.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 967
categorystreamline (Webtop)

Parameters

folderId (Optional) ID of the category folder to navigate.


folderPath (Optional) Path to the category folder to navigate.
nodeIds (Optional) List of dot‑separated object IDs used
to build an absolute location to display the
categories.

Description
Since
5.x

Configuration File
webtop\config\categorystreamline_component.xml

Parent Definition
categorydrilldown:webcomponent/config/navigation/category/categorydrilldown_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from categorydrilldown:webcomponent/config/navigation/
category/categorydrilldown_component.xml. See categorydrilldown, page 962.

showfilters
See showfilters, page 835.

objectfilters
See objectfilters, page 827.
columns
See columns (for streamline view), page 811.

968 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
categorysubscriptionlocator

categorysubscriptionlocator

Purpose
Enables user to select from a list of category subscriptions.

Parameters
The parameters are inherited from subscriptionlocator:webcomponent/config/library/locator/
subscriptionlocator_component.xml. See subscriptionlocator, page 1423.

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\categorylocator_component.xml

Parent Definition
subscriptionlocator:webcomponent/config/library/locator/subscriptionlocator_component.xml

Scope
All.

Elements
objecttype

<objecttype>dm_category</objecttype>

Specifies the object type of the objects to locate.


containerselectable

1 <containerselectable>false</containerselectable>

1 See containerselectable, page 814.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 969
categorysubscriptionlocator

privatecabinetvisible

1 <privatecabinetvisible>true</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

allversionsvisible

1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

views
See views, page 839.

columns
See columns (for data columns), page 811.
flatlist

1 <flatlist>false</flatlist>

1 See flatlist, page 820.

privatecabinet_visible

<privatecabinet_visible>true</privatecabinet_visible>
See privatecabinet_visible, page 831.

970 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
properties (type dm_category)

properties (type dm_category)

Purpose
Extends the container propertysheetcontainer, page 928 and displays property sheets that show
general information about the selected object, such as name, type, format and owner. The properties
component contains attributes, history, and permissions. The properties component for dm_category
objects extends this properties component.

Parameters
The parameters are inherited from properties:webcomponent/config/library/properties/properties_
component.xml. See properties, page 926.

Description
Since
5.x

Configuration File
webcomponent\config\library\properties\dm_category_properties_component.xml

Parent Definition
properties:webcomponent/config/library/properties/properties_component.xml

Scope

type dm_category

Elements
failoverenabled
This element structure is inherited from properties:webcomponent/config/library/properties/
properties_component.xml. See properties, page 926.

commitorder
See commitorder, page 814.

setrepositoryfromobjectid

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 971
recentcategorylocator

<setrepositoryfromobjectid>true</setrepositoryfromobjectid>
See setrepositoryfromobjectid, page 834.

recentcategorylocator

Purpose
Locator for all recently selected categories.

Parameters
The parameters are inherited from recentsysobjectlocator:webcomponent/config/library/locator/
recentsysobjectlocator_component.xml. See recentsysobjectlocator, page 1090.

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\categorylocator_component.xml

Parent Definition
recentsysobjectlocator:webcomponent/config/library/locator/recentsysobjectlocator_component.xml

Scope
All.

Elements
objecttype

<objecttype>dm_category</objecttype>

Specifies the object type of the objects to locate.

972 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
submitforcategorization

iconwell_icon
See iconwell_icon, page 822.

columns
See columns (for data columns), page 811.
containerselectable

1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

views
See views, page 839.

submitforcategorization

Purpose
Submits the selected object to a task queue for categorization by the category manager.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\library\submitforcategorization\submitforcategorization_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 973
taxonomylocator

Elements
None.

taxonomylocator

Purpose
This component is used to search for taxonomies.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\taxonomylocator_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
objecttype

<objecttype>dm_taxonomy</objecttype>

Specifies the object type of the objects to locate.

974 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
taxonomylocator

containerselectable

1 <containerselectable>false</containerselectable>

1 See containerselectable, page 814.

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

allversionsvisible

1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

views
See views, page 839.

columns
See columns (for data columns), page 811.

contenttypepanelvisible

1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.

filenamefiltervisible
See filenamefiltervisible, page 819.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 975
clipboard

Clipboard operations

clipboard

Purpose
The clipboard component displays the contents of the current user’s clipboard and supports link
and copy operations.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\environment\clipboard\clipboard_component.xml

Scope
All.

Usage
To disable clipboard functions for specific object types, use the addtoclipboard action (see
addtoclipboard (type dm_sysobject), page 416).

Elements
dragdrop
See dragdrop, page 818.

976 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
link

link

Purpose
This component is used to create a link to an object in the local repository or to create a reference object.

Parameters

folderId (Required) ID of the target folder for the link


objectId (Required) Object for which to create a link

Description
Since
5.x

Configuration File
webcomponent\config\library\link\link_component.xml

Scope
All.

Elements
None.

linkcontainer

Purpose
This component displays the link component, which is used to create a link to a local object or
to create a reference object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 977
linkcontainer

Parameters

component (Required) Supplied by the action execution


class). The name of the component to contain.
componentArgs (Required) Supplied by the LaunchComponent
action execution class.) List of arguments and
values to pass to each contained component.
localItems (Optional) This is a comma‑separated list of IDs
of linked items from the local repository. Local
items are linked differently than items linked
from external sources. IDs of items not listed in
the localItems parameter are assumed to be from
an external repository.

Description
Since
5.x

Configuration File
webcomponent\config\library\link\linkcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.
propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

978 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
addroommembercontainer

Collaboration

addroommembercontainer

Purpose
Container object for adding a user as a member of a room. Requires Documentum Collaborative
Services.

Parameters

arrangeselect (Optional) Boolean: Set to true to allow selection


of users in a sequential order.
flatlist (Optional) Boolean: Set to true to list all objects in
a flat list, set to false to display a drop‑down list.
multiselect (Optional) Boolean: Set to true to support
multiple selection.
objectId (Required) ID of the dmc_room object.

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\addroommembercontainer_component.xml

Parent Definition
userorgrouplocatorcontainer:webcomponent/config/library/locator/userorgrouplocator_component.
xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 979
addroomusercontainer

Elements
failoverenabled
See failoverenabled, page 819.

addroomusercontainer

Purpose
Enables adding users as members to rooms.

Parameters

arrangeselect (Optional) Boolean: Set to true to allow selection


of users and groups in a sequential order.
flatlist (Optional) Boolean: Set to true to list users and
groups in a flat list, set to false to display users
and groups in a drop‑down list.
multiselect (Optional) Boolean: Set to true to support
multiple user/group selection.
objectId (Required) Object ID of the dm_user object to
add.
roomId (Required) Object ID of the room to which to add
the user as a member.

Description
Since
6.0

Configuration File
webcomponent\config\admin\unlisteduser\unlisteduser_component.xml

Parent Definition
userproperties:webcomponent/config/admin/user/userproperties_component.xml

980 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
addroomuserorgrouplocator

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to display.

addroomuserorgrouplocator

Purpose
A locator that finds users or groups in a docbase. Used in operations that add groups or users to a
room.

Parameters

objectId This is a copy of the existing parameter


description.(Required) ID of the dm_user or
dm_group object to add.

Description

Since
5.x

Configuration File
webcomponent\config\library\rooms\addroommembercontainer_component.xml

Parent Definition
userorgrouplocator:webcomponent/config/library/locator/userorgrouplocator_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 981
addroomuserorgrouplocator

Scope
All.

Elements
columns
See columns (for data columns), page 811.

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

failoverenabled
This element structure is inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.
flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.

iconwell_icon
See iconwell_icon, page 822.

includeunlisted
See includeunlisted, page 823.

objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to locate.

preset_item
See preset_item, page 830.

privategroupvisible
See privategroupvisible, page 832.
views
See views, page 839.
workqueuegroupvisible
See workqueuegroupvisible, page 841.

982 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attributes (type dmc_calendar_event)

attributes (type dmc_calendar_event)

Purpose
Displays the attributes of a dmc_calendar_event object.

Parameters
The parameters are inherited from attributes:webcomponent/config/library/attributes/attributes_dm_
sysobject_component.xml. See attributes (type dm_sysobject), page 912.

Description
Since
6.0

Configuration File
webcomponent\config\library\calendars\attributes_dmc_calendar_event_component.xml

Parent Definition
attributes:webcomponent/config/library/attributes/attributes_dm_sysobject_component.xml

Scope

type dmc_calendar_event

Elements
enableShowAll
See enableShowAll, page 819.

failoverenabled
This element structure is inherited from attributes:webcomponent/config/library/attributes/attributes_
dm_sysobject_component.xml. See attributes (type dm_sysobject), page 912.
readOnly
See readOnly, page 832.

showpagesastabs
See showpagesastabs, page 836.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 983
attributes (type dmc_datatable_row)

attributes (type dmc_datatable_row)

Purpose
Displays the attributes of a dmc_datatable_row object.

Parameters
The parameters are inherited from attributes:webcomponent/config/library/attributes/attributes_dm_
sysobject_component.xml. See attributes (type dm_sysobject), page 912.

Description
Since
6.0

Configuration File
webcomponent\config\library\datatables\attributes_dmc_datatable_row_component.xml

Parent Definition
attributes:webcomponent/config/library/attributes/attributes_dm_sysobject_component.xml

Scope

type dmc_datatable_row

Elements
enableShowAll
See enableShowAll, page 819.

failoverenabled
This element structure is inherited from attributes:webcomponent/config/library/attributes/attributes_
dm_sysobject_component.xml. See attributes (type dm_sysobject), page 912.
readOnly
See readOnly, page 832.

showpagesastabs
See showpagesastabs, page 836.

984 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
changeroommemberrole

changeroommemberrole

Purpose
Specifies whether a given user is a contributor or an owner to a room. Requires Documentum
Collaborative Services.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\library\rooms\changeroomrolecontainer_component.xml

Scope
All.

Elements
None.

changeroommemberrolecontainer

Purpose
Container component for changing the roles assigned to room members. Requires Documentum
Collaborative Services.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 985
changeroommemberrolelocator

Parameters

arrangeselect (Optional) Boolean: Set to true to allow selection


of members in a sequential order.
multiselect (Optional) Boolean: Set to true to support
multiple selections.
roomId (Required) Object ID of the dmc_room object.

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\changeroomrolecontainer_component.xml

Parent Definition
roomuserorgrouplocatorcontainer:webcomponent/config/library/rooms/
roomuserorgrouplocatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
<multidocbasesupport>false</multidocbasesupport>

See multidocbasesupport, page 825.

changeroommemberrolelocator

Purpose
Displays a list of room members to select for changing their roles. Requires Documentum
Collaborative Services.

986 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
changeroommemberrolestep

Parameters
The parameters are inherited from roomuserorgrouplocator:webcomponent/config/library/rooms/
roomuserorgrouplocatorcontainer_component.xml. See roomuserorgrouplocator, page 1050.

Description

Since
5.x

Configuration File
webcomponent\config\library\rooms\changeroomrolecontainer_component.xml

Parent Definition
roomuserorgrouplocator:webcomponent/config/library/rooms/roomuserorgrouplocatorcontainer_
component.xml

Scope
All.

Elements
includeunlisted
See includeunlisted, page 823.

changeroommemberrolestep

Purpose
This is a container component that displays the second step in the process to pick the role which
the selected users will have.

Parameters
The parameters are inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml. See
dialogcontainer, page 1185.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 987
choosecontributors

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\changeroomrolecontainer_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

choosecontributors

Purpose
Sets the list of contributors for a room. Requires Documentum Collaborative Services.

Parameters
The parameters are inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

Description

Since
5.x

988 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
choosecontributors

Configuration File
webcomponent\config\library\rooms\newroom_component.xml

Parent Definition
userorgrouplocator:webcomponent/config/library/locator/userorgrouplocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

failoverenabled
This element structure is inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.
flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.

iconwell_icon
See iconwell_icon, page 822.

objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to locate.

preset_item
See preset_item, page 830.

privategroupvisible
See privategroupvisible, page 832.

views
See views, page 839.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 989
chooseowners

workqueuegroupvisible
See workqueuegroupvisible, page 841.

chooseowners

Purpose
Sets the owners for a room. Requires Documentum Collaborative Services.

Parameters
The parameters are inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\newroom_component.xml

Parent Definition
userorgrouplocator:webcomponent/config/library/locator/userorgrouplocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

990 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
datatableentrypage (type dmc_datatable_row)

failoverenabled
This element structure is inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.


iconwell_icon
See iconwell_icon, page 822.
includeunlisted
See includeunlisted, page 823.

objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to locate.

preset_item
See preset_item, page 830.

privategroupvisible
See privategroupvisible, page 832.

views
See views, page 839.

workqueuegroupvisible
See workqueuegroupvisible, page 841.

datatableentrypage (type dmc_datatable_row)

Purpose
Displays a datatable entry, which corresponds to a row. Requires a Documentum Collaborative
Services license.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 991
datatableentrypage (type dmc_datatable_row) (Webtop)

Since
6.5

datatableentrypage (type dmc_datatable_row)


(Webtop)

Purpose
Displays a datatable entry, which corresponds to a row. Requires a Documentum Collaborative
Services license.

Since
6.5

datatablerepeatingattreditcomponent

Purpose
Enables editing repeating attribute values in a datatable.

Since
6.5

dceuserattributes

Purpose
Displays the properties for creating new users and for viewing existing users’ attributes.

992 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
dceuserproperties

Parameters

objectId (Required) Object ID of the dm_user object for


which to display attributes.
objectname (Required) ID of the folder or cabinet in which
the new object is to be created. If this is a new
user then this parameter’s value is newobject.

Description
Since
6.0

Configuration File
webcomponent\config\admin\unlisteduser\unlisteduser_component.xml

Scope
All.

Usage
This component also contains specific attributes for users created by users that belong to the
dce_user_manager role. Provides the ability to create users with inline passwords, mark users as
unlisted, and add restricted folders to a user.

Elements
None.

dceuserproperties

Purpose
Displays a room user’s properties (container for the dceuserattributes, page 992 component).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 993
delete (type dmc_calendar_event)

Parameters

component (Required) Name of the contained component.


objectId (Required) Object ID of the dm_user object for
which to display attributes.
objectname (Required) ID of the folder or cabinet in which
the new object is to be created. If this is a new
user then this parameter’s value is newobject.

Description
Since
6.0

Configuration File
webcomponent\config\admin\unlisteduser\unlisteduser_component.xml

Parent Definition
adminpropertycontainer:webcomponent/config/admin/container/adminpropertycontainer_
component.xml

Scope
All.

Elements
objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to display.

delete (type dmc_calendar_event)

Purpose
Deletes a dmc_calendar_event object.

994 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (type dmc_calendar)

Parameters

objectId (Required) ID of the dmc_calendar_event object.

Description
Since
6.0

Configuration File
webcomponent\config\library\calendars\deletecalendarevent_component.xml

Scope

type dmc_calendar_event

Elements
None.

delete (type dmc_calendar)

Purpose
Deletes a dmc_calendar object.

Parameters
The parameters are inherited from delete:webcomponent/config/library/delete/deletefolder_
component.xml. See delete (type dm_folder), page 952.

Description

Since
6.0

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 995
delete (type dmc_comment)

Configuration File
webcomponent\config\library\calendars\deletecalendar_component.xml

Parent Definition
delete:webcomponent/config/library/delete/deletefolder_component.xml

Scope

type dmc_calendar

Elements
None.

delete (type dmc_comment)

Purpose
Deletes a comment from a thread.

Parameters

objectId (Required) ID of the dmc_comment object to


delete.

Description
Since
5.x

Configuration File
webcomponent\config\library\discussion\deletecomment_component.xml

Scope

type dmc_comment

996 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (type dmc_datatable)

Elements
None.

delete (type dmc_datatable)

Purpose
Deletes a dmc_datatable object. Requires Documentum Collaborative Services.

Since
6.5

delete (type dmc_notepage)

Purpose
This component is used to delete dmc_notepage objects. Requires Documentum Collaborative
Services.

Parameters
The parameters are inherited from delete:webcomponent/config/library/delete/deletedocument_
component.xml. See delete (type dm_sysobject), page 1119.

Description
Since
5.x

Configuration File
webcomponent\config\library\notepage\deletenotepage_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 997
delete (type dmc_room)

Parent Definition
delete:webcomponent/config/library/delete/deletedocument_component.xml

Scope

type dmc_notepage

Elements
None.

delete (type dmc_room)

Purpose
Deletes room objects. Requires Documentum Collaborative Services.

Parameters

folderId (Optional) Not required for deleting dmc_room


objects.
objectId (Required) Object ID of the dmc_room object to
delete.

Description

Since
5.x

Configuration File
webcomponent\config\library\rooms\deleteroom_component.xml

Scope

type dmc_room

998 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
doclist (type dmc_calendar)

Elements
None.

doclist (type dmc_calendar)

Purpose
Displays the contents, including calendar events, of a dmc_calendar object.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\library\calendars\calendar_listing_components.xml

Parent Definition
webcomponent/config/navigation/doclist/doclist_component.xml

Scope

type dmc_calendar

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 999
doclist (type dmc_datatable)

doclist (type dmc_datatable)

Purpose
Displays the contents of a dmc_datatable object. Requires Documentum Collaborative Services.

Since
6.5

edit (type dmc_notepage)

Purpose
This component is used to edit dmc_notepage objects. Requires Documentum Collaborative Services.

Parameters

objectId (Required) Object ID of the note

Description
Since
5.x

Configuration File
webcomponent\config\library\notepage\editnotepage_component.xml

Scope

type dmc_notepage

Elements
None.

1000 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
editdatatableentry (type dmc_datatable_row)

editdatatableentry (type dmc_datatable_row)

Purpose
Enbles editing a dmc_datatable_row object. Requires Documentum Collaborative Services.

Since
6.5

editdatatableentrycontainer (type dmc_datatable_


row)

Purpose
Container for the editdatatableentry component. Requires Documentum Collaborative Services.

Since
6.5

embeddedtopic

Purpose
Enables a user to add, edit, or delete a topic in an embedded view. The embedded view appears at the
bottom of dm_folder and dmc_notepage objects. Requires Documentum Collaborative Services.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1001
embeddedtopic

Parameters

folderPath (Optional) Folder path of the parent topic.


nodeIds (Optional) List of dot‑separated object IDs used
to build an absolute location to display the
embedded topic
objectId (Required) ID of the parent topic.
type (Optional) Object type of the topic parent

Description
Since
5.x

Configuration File
webcomponent\config\library\discussion\topicembedded_component.xml

Scope
All.

Usage
Use the componentinclude tag to embed the component at the bottom of parent page. The parameter
objectId is that of the parent page and is used to acquire the existing topic or is used in the creation of a
topic upon entry of the first comment.
<dmfx:componentinclude name="showtopic" component="embeddedtopic">
<dmfx:argument name="objectId" contextvalue="objectId">
</dmfx:componentinclude>

Elements
comments
See comments, page 814.

1002 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
embeddedtopic (type dmc_room)

embeddedtopic (type dmc_room)

Purpose
Displays the topic for a folder or note at the bottom of the parent objects page in a room. Requires
Documentum Collaborative Services. A user adds, edits or deletes a comment using the controls
rendered by the components page.

Parameters
The parameters are inherited from embeddedtopic:webcomponent/config/library/discussion/
topicembedded_component.xml. See embeddedtopic, page 1001.

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\topicembedded_component.xml

Parent Definition
embeddedtopic:webcomponent/config/library/discussion/topicembedded_component.xml

Scope

type dmc_room

Elements
comments
See comments, page 814.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1003
er_properties (Webtop)

er_properties (Webtop)

Purpose
Used for eRoom 7.x for integration with Webtop. For internal use only. (Customization not supported.)

Parameters

component (Required) For internal use only.


er_objectId (Required) For internal use only.
newFile (Required) For internal use only.

Description
Since
5.x

Configuration File
webtop\config\eroom_properties_component.xml

Parent Definition
properties:webcomponent/config/library/properties/properties_component.xml

Scope
All.

Elements
commitorder
See commitorder, page 814.

failoverenabled
This element structure is inherited from properties:webcomponent/config/library/properties/
properties_component.xml. See properties, page 926.

setrepositoryfromobjectid
See setrepositoryfromobjectid, page 834.

1004 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
export (type dmc_datatable)

export (type dmc_datatable)

Purpose
Exports dmc_datatable objects.

Parameters

contentType (Optional) Content type of document being


exported.
objectId (Required) ID of the dmc_datatable object to
export.
pageModifier (Optional) A valid value for the page_modifier
attribute of the dmc_datatable object. You
should not pass in your own value for PDF
renditions. Specifies a user‑defined attribute
(page_modifier) value that distinguishes
between renditions.

Description
Since
6.0

Configuration File
webcomponent\config\library\datatables\table_actions.xml

Scope

type dmc_datatable

Elements
init­controls
See init‑controls, page 823.

service
See service, page 834.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1005
govern (type dm_folder)

ucfrequired
1 <ucfrequired></ucfrequired>
See ucfrequired, page 838.

govern (type dm_folder)

Purpose
Enables the user to specify whether governing should be applied to the children of a selected object to
govern. Requires Documentum Collaborative Services.

Parameters

folderId (Required) Object ID of the folder that contains


the object specified by the objectID parameter
objectId (Required) ID of the object to govern
sourceFolderId (Optional) ID of the folder that will be added to
the governed folder or room

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\govern_component.xml

Scope

type dm_folder

Elements
None.

1006 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
homecabinet_classic (type dmc_calendar) (Webtop)

homecabinet_classic (type dmc_calendar) (Webtop)

Purpose
Supports browsing of the user home cabinet for dmc_calendar objects. Users can select cabinets
and folders and view their contents. The component is identical to the doclist component with
the exception that the top‑level navigation location is the user’s home cabinet path instead of the
repository root cabinet list.

Parameters
None.

Description
Since
6.0

Configuration File
webtop\config\calendar_listing_components.xml

Parent Definition
webtop/config/homecabinet_classic_component.xml

Scope

type dmc_calendar

Elements
columnpreferenceid
<columnpreferenceid>application.display.presetlist_columns</columnpreferenceid>

columns
See columns (for streamline view), page 811.
objectfilters
See objectfilters, page 827.

showfilters
See showfilters, page 835.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1007
homecabinet_classic (type dmc_datatable) (Webtop)

showthumbnail
Since 6.0 SP1.
Enables (true) and disables (false) displaying thumbnails.

homecabinet_classic (type dmc_datatable) (Webtop)

Purpose
Supports browsing of the user home cabinet for dmc_datatable objects in classic view.

Parameters
None.

Description

Since
6.0

Configuration File
webtop\config\datatable_listing_components.xml

Parent Definition
webtop/config/homecabinet_classic_component.xml

Scope

type dmc_datatable

Elements
columns
See columns (for streamline view), page 811.
objectfilters
See objectfilters, page 827.

1008 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
homecabinet_classic (type dmc_room) (Webtop)

showfilters
See showfilters, page 835.

showthumbnail
Since 6.0 SP1.
Enables (true) and disables (false) displaying thumbnails.

homecabinet_classic (type dmc_room) (Webtop)

Purpose
Supports browsing of the user home room.

Parameters
The parameters are inherited from homecabinet_classic:webtop/config/homecabinet_classic_
component.xml. See homecabinet_classic (Webtop), page 1206.

Description
Since
5.x

Configuration File
webtop\config\room_homecabinet_classic_component.xml

Parent Definition
homecabinet_classic:webtop/config/homecabinet_classic_component.xml

Scope

type dmc_room

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1009
homecabinet_list (type dmc_calendar)

Elements
failoverenabled
This element structure is inherited from homecabinet_classic:webtop/config/homecabinet_classic_
component.xml. See homecabinet_classic (Webtop), page 1206.

homecabinet_list (type dmc_calendar)

Purpose
Browsing of a user’s home cabinet for dmc_calendar objects.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\library\calendars\calendar_listing_components.xml

Parent Definition
webcomponent/config/navigation/homecabinet/homecabinet_list_component.xml

Scope

type dmc_calendar

Elements
None.

1010 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
homecabinet_streamline (type dmc_room) (Webtop)

homecabinet_streamline (type dmc_room) (Webtop)

Purpose
Supports browsing of the user home room.

Parameters
The parameters are inherited from homecabinet_drilldown:webcomponent/config/navigation/
homecabinet/homecabinet_drilldown_component.xml. See homecabinet_drilldown, page 1208.

Description
Since
5.x

Configuration File
webtop\config\room_homecabinet_streamline_component.xml

Parent Definition
homecabinet_streamline:webtop/config/homecabinet_streamline_component.xml

Scope

type dmc_room

Elements
None.

import (type dmc_calendar_event)

Purpose
Imports dmc_calendar_event objects.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1011
import (type dmc_calendar_event)

Parameters
The parameters are inherited from import:webcomponent/config/library/contenttransfer/
importcontent/import_component.xml. See import, page 1159.

Description

Since
6.0

Configuration File
webcomponent\config\library\calendars\import_component.xml

Parent Definition
import:webcomponent/config/library/contenttransfer/importcontent/import_component.xml

Scope

type dmc_calendar_event

Elements
docbase­type­mappings
See docbase‑type‑mappings, page 817.

document_filter
See document_filter, page 817.

document­docbase­base­type
See document‑docbase‑base‑type, page 817.

document­docbase­type
See document‑docbase‑type, page 817.

folder_filter
See folder_filter, page 820.
folder­docbase­type
See folder‑docbase‑type, page 820.
init­controls
See init‑controls, page 823.

1012 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
import (type dmc_calendar)

preserve­file­extension
See preserve‑file‑extension, page 829.

preset_item
See preset_item, page 830.
service
See service, page 834.
ucfrequired
See ucfrequired, page 838.

import (type dmc_calendar)

Purpose
Imports a dmc_calendar object.

Parameters
The parameters are inherited from import:webcomponent/config/library/contenttransfer/
importcontent/import_component.xml. See import, page 1159.

Description

Since
6.0

Configuration File
webcomponent\config\library\calendars\import_component.xml

Parent Definition
import:webcomponent/config/library/contenttransfer/importcontent/import_component.xml

Scope

type dmc_calendar

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1013
myrooms_classic (Webtop)

Elements
docbase­type­mappings
See docbase‑type‑mappings, page 817.
document_filter
See document_filter, page 817.
document­docbase­base­type
See document‑docbase‑base‑type, page 817.
document­docbase­type
See document‑docbase‑type, page 817.

folder_filter
See folder_filter, page 820.
folder­docbase­type
See folder‑docbase‑type, page 820.
init­controls
See init‑controls, page 823.

preserve­file­extension
See preserve‑file‑extension, page 829.

preset_item
See preset_item, page 830.

service
See service, page 834.

ucfrequired
See ucfrequired, page 838.

myrooms_classic (Webtop)

Purpose
Lists rooms used by the user. This component is displayed when the user is in classic view

1014 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
myrooms_drilldown

Description
Since
5.x

Configuration File
webtop\config\myrooms_classic_component.xml

Parent Definition
myrooms_list:/webcomponent/config/library/rooms/myrooms_list_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

objecttype
<objecttype>dmc_room</objecttype>

Specifies the object type of the objects to locate.

preferences
See preferences, page 828.
showfolders
See showfolders, page 835.

myrooms_drilldown

Purpose
In My Rooms Streamline view component, used to display the rooms to which the user
belongs.Deprecated as of version 6.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1015
myrooms_drilldown

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\myrooms_drilldown_component.xml

Parent Definition
myobjects_drilldown:/webcomponent/config/library/myobjects/myobjects_drilldown_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

failoverenabled
This element structure is inherited from myobjects_drilldown:/webcomponent/config/library/
myobjects/myobjects_drilldown_component.xml. See myobjects_drilldown, page 1256.

modifiedwithindays
See modifiedwithindays, page 825.
objecttype
<objecttype>dmc_room</objecttype>

Specifies the object type of the objects to display.

preferences
See preferences, page 828.

showfolders
See showfolders, page 835.

1016 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
myrooms_list

myrooms_list

Purpose
My Rooms Classic view component, used to list rooms of which the user is a member.

Description

Since
5.x

Configuration File
webcomponent\config\library\rooms\myrooms_list_component.xml

Parent Definition
myobjects_list:/webcomponent/config/library/myobjects/myobjects_list_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

failoverenabled
This element structure is inherited from myobjects_list:/webcomponent/config/library/myobjects/
myobjects_list_component.xml. See myobjects_list, page 1082.
modifiedwithindays
<modifiedwithindays>7</modifiedwithindays>

See modifiedwithindays, page 825.


objecttype
<objecttype>dmc_room</objecttype>

Specifies the object type of the objects to display.

preset_item
See preset_item, page 830.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1017
myrooms_streamline (Webtop)

showfolders
<showfolders>false</showfolders>

See showfolders, page 835.

myrooms_streamline (Webtop)

Purpose
Displays a drilldown style list of rooms used by the user.

Description
Since
5.x

Configuration File
webtop\config\myrooms_streamline_component.xml

Parent Definition
myrooms_drilldown:/webcomponent/config/library/rooms/myrooms_drilldown_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

objecttype
<objecttype>dmc_room</objecttype>

Specifies the object type of the objects to display.


preferences
See preferences, page 828.

1018 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
nativeroomobjectlocator

nativeroomobjectlocator

Purpose
Locates and selects dmc_room objects in the repository.

Parameters

multiselect (Optional) Boolean: Set to true to support


multiple object selection.
objectId (Optional) Object ID of the dmc_room object to
select initially.

Description
Since
6.0

Configuration File
webcomponent\config\library\locator\nativeroomobjectlocator_component.xml

Parent Definition
persistentobjectlocator:webcomponent/config/library/locator/persistentobjectlocator_component.xml

Scope
All.

Elements
attributes
See attributes, page 810.
columns
See columns (for data columns), page 811.

objecttype
<objecttype>dmc_room</objecttype>

Specifies the object type of the objects to locate.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1019
nativeroomobjectlocatorcontainer

views
See views, page 839.

nativeroomobjectlocatorcontainer

Purpose
Container for the nativeroomobjectlocator, page 1019component.

Parameters

multiselect (Optional)
objectId (Optional)

Description
Since
6.0

Configuration File
webcomponent\config\library\locator\nativeroomobjectlocator_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

1020 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newcalendar

newcalendar

Purpose
Creates a new dmc_calendar object.

Parameters
The parameters are inherited from newfolder:webcomponent/config/library/create/newfolder_
component.xml. See newfolder, page 956.

Description

Since
5.x

Configuration File
webcomponent\config\library\calendars\newcalendar_component.xml

Parent Definition
newfolder:webcomponent/config/library/create/newfolder_component.xml

Scope
All.

Elements
base_type
See base_type, page 810.

default_type
See default_type, page 815.

folder_filter
See folder_filter, page 820.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1021
newcalendarcontainer

newcalendarcontainer

Purpose
Contains the newcalendar, page 1021 component.

Parameters
The parameters are inherited from newfoldercontainer:webcomponent/config/library/create/
newfoldercontainer_component.xml. See newfoldercontainer, page 957.

Description

Since
5.x

Configuration File
webcomponent\config\library\calendars\newcalendar_component.xml

Parent Definition
newfoldercontainer:webcomponent/config/library/create/newfoldercontainer_component.xml

Scope
All.

Elements
newcomponentname
See newcomponentname, page 825.

numberedtabs
See numberedtabs, page 827.

1022 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newcalendarevent

newcalendarevent

Purpose
Creates a new dmc_calendar_event object.

Parameters
The parameters are inherited from newdocbaseobject:webcomponent/config/library/create/
newdocbaseobject_component.xml. See newdocbaseobject, page 1059.

Description

Since
5.x

Configuration File
webcomponent\config\library\calendars\newcalendarevent_component.xml

Parent Definition
newdocbaseobject:webcomponent/config/library/create/newdocbaseobject_component.xml

Scope
All.

Elements
objecttype
<objecttype>dmc_calendar_event</objecttype>

Specifies the object type of the objects to create.

newcalendareventcontainer

Purpose
Container for newcalendarevent, page 1023.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1023
newinvitewindow (entitlement collaboration)

Parameters
The parameters are inherited from newdocbaseobjectcontainer:webcomponent/config/library/create/
newdocbaseobject_component.xml. See newdocbaseobjectcontainer, page 1060.

Description

Since
5.x

Configuration File
webcomponent\config\library\calendars\newcalendarevent_component.xml

Parent Definition
newdocbaseobjectcontainer:webcomponent/config/library/create/newdocbaseobject_component.xml

Scope
All.

Elements
newcomponentname
See newcomponentname, page 825.

newinvitewindow (entitlement collaboration)

Purpose
Displays a second WDK application browser window from which users can send an invitation
to selected room members.

Parameters

objectId (Required) ID of the dmc_room object for which


to send an invitation.

1024 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newnotepage

Description
Since
6.0

Configuration File
webcomponent\config\library\rooms\room_invites_component.xml

Parent Definition
newwindow:webcomponent/config/library/newwindow/newwindow_component.xml

Scope

entitlement collaboration

Elements
windowparams
See windowparams, page 840.

newnotepage

Purpose
This component is used to create a new notepage object. Requires Documentum Collaborative Services.

Parameters

objectId (Required) ID of the folder in which to create the


new notepage object

Description
Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1025
newnotepagecontainer

Configuration File
webcomponent\config\library\notepage\newnotepage_component.xml

Scope
All.

Elements
base_type
See base_type, page 810.

default_type
See default_type, page 815.

newnotepagecontainer

Purpose
This component is used to display the newnotepage component. Requires Documentum Collaborative
Services.

Parameters

component (Required) ID of the component to be displayed

Description

Since
5.x

Configuration File
webcomponent\config\library\notepage\newnotepagecontainer_component.xml

Parent Definition
propertysheetwizardcontainer:webcomponent/config/library/propertysheetwizardcontainer/
propertysheetwizardcontainer_component.xml

1026 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newroom

Scope
All.

Elements
newcomponentname
See newcomponentname, page 825.

numberedtabs
See numberedtabs, page 827.

newroom

Purpose
Creates a new room: its name, description, and default access controls. Requires Documentum
Collaborative Services. This component must run within the container newroomcontainer, page 1028.

Parameters

objectId (Optional) Object ID of the cabinet in which the


new room is created.

Description

Since
5.x

Configuration File
webcomponent\config\library\rooms\newroom_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1027
newroomcontainer

newroomcontainer

Purpose
Container component for creating new eRooms. Requires Documentum Collaborative Services.

Parameters
The parameters are inherited from propertysheetwizardcontainer:webcomponent/config/
library/propertysheetwizardcontainer/propertysheetwizardcontainer_component.xml. See
propertysheetwizardcontainer, page 930.

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\newroomcontainer_component.xml

Parent Definition
propertysheetwizardcontainer:webcomponent/config/library/propertysheetwizardcontainer/
propertysheetwizardcontainer_component.xml

Scope
All.

Elements
newcomponentname
See newcomponentname, page 825.
numberedtabs
See numberedtabs, page 827.

1028 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newroomgroup

newroomgroup

Purpose
Creates a private group in a room. Requires Documentum Collaborative Services.

Parameters

groupName (Optional) ID of group to which the selection


will be restricted
objectId (Optional) Object ID of the room in which the
private group is created

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\newroomgroupcontainer_component.xml

Parent Definition
objectlocator:webcomponent/config/library/locator/objectlocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


flatlist
1 <flatlist>false</flatlist>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1029
newroomgroupcontainer

1 See flatlist, page 820.


objecttype
<objecttype></objecttype>

Specifies the object type of the objects to locate.

views
See views, page 839.

newroomgroupcontainer

Purpose
Container component for creating private groups in a room. Requires Documentum Collaborative
Services.

Parameters

component (Required) Name of the contained component to


display first.
groupName (Optional) ID of group to be created
objectId (Required) Object ID of the room in which the
private group is created.

Description

Since
5.x

Configuration File
webcomponent\config\library\rooms\newroomgroupcontainer_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

1030 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newtable

Scope
All.

Elements
failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

newtable

Purpose
Creates a new dmc_datatable object.

Parameters
The parameters are inherited from newfolder:webcomponent/config/library/create/newfolder_
component.xml. See newfolder, page 956.

Description

Since
6.0

Configuration File
webcomponent\config\library\datatables\newtable_component.xml

Parent Definition
newfolder:webcomponent/config/library/create/newfolder_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1031
newtablecontainer

Elements
base_type
See base_type, page 810.
default_type
See default_type, page 815.
folder_filter
See folder_filter, page 820.

newtablecontainer

Purpose
A container component for creating a new dmc_datatable object.

Parameters

component (Required) Name of the component to contain.

Description

Since
6.0

Configuration File
webcomponent\config\library\datatables\newtable_component.xml

Parent Definition
propertysheetwizardcontainer:webcomponent/config/library/propertysheetwizardcontainer/
propertysheetwizardcontainer_component.xml

Scope
All.

1032 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newtableentry

Elements
newcomponentname
See newcomponentname, page 825.
numberedtabs
See numberedtabs, page 827.

newtableentry

Purpose
Creates a new dmc_datatable object entry.

Parameters
The parameters are inherited from newdocbaseobject:webcomponent/config/library/create/
newdocbaseobject_component.xml. See newdocbaseobject, page 1059.

Description

Since
6.0

Configuration File
webcomponent\config\library\datatables\newtableentry_component.xml

Parent Definition
newdocbaseobject:webcomponent/config/library/create/newdocbaseobject_component.xml

Scope
All.

Elements
objecttype
<objecttype>dmc_document</objecttype>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1033
newtableentrycontainer

Specifies the object type of the objects to create.

newtableentrycontainer

Purpose
A container component for creating new dmc_datatable object table entries.

Parameters
The parameters are inherited from newdocbaseobjectcontainer:webcomponent/config/library/create/
newdocbaseobject_component.xml. See newdocbaseobjectcontainer, page 1060.

Description
Since
6.0

Configuration File
webcomponent\config\library\datatables\newtableentry_component.xml

Parent Definition
newdocbaseobjectcontainer:webcomponent/config/library/create/newdocbaseobject_component.xml

Scope
All.

Elements
newcomponentname
See newcomponentname, page 825.

1034 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
notepage (type dmc_notepage)

notepage (type dmc_notepage)

Purpose
This component is used to display a note object. A note is a content file that can be displayed directly
in the browser. Requires Documentum Collaborative Services.

Parameters

folderId (Optional) ID of the folder in which the notepage


is located
folderPath (Optional) Specifies the ID of the primary
location for the folder in which the notepage is
located
objectId (Required) ID of the notepage to be displayed

Description
Since
5.x

Configuration File
webcomponent\config\library\notepage\notepage_component.xml

Scope

type dmc_notepage

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1035
notepage (type dmc_notepage) (Webtop)

notepage (type dmc_notepage) (Webtop)

Purpose
Displays a note (content file that can be displayed directly in the browser). Requires Documentum
Collaborative Services.

Parameters
The parameters are inherited from notepage:webcomponent/config/library/notepage/notepage_
component.xml. See notepage (type dmc_notepage), page 1035.

Description
Since
5.x

Configuration File
webtop\config\notepage_component.xml

Parent Definition
notepage:webcomponent/config/library/notepage/notepage_component.xml

Scope

type dmc_notepage

Elements
None.

objectlist (type dmc_calendar) (Webtop)

Purpose
Displays a list of dmc_calendar objects.

1036 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
objectlist (type dmc_calendar) (Webtop)

Parameters
None.

Description
Since
6.0

Configuration File
webtop\config\calendar_listing_components.xml

Parent Definition
webtop/config/objectlist_component.xml

Scope

type dmc_calendar

Elements
columnpreferenceid
<columnpreferenceid>application.display.presetlist_columns</columnpreferenceid>

columns
See columns (for streamline view), page 811.
objectfilters
See objectfilters, page 827.

showfilters
See showfilters, page 835.

showthumbnail
Since 6.0 SP1.
Enables (true) and disables (false) displaying thumbnails.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1037
objectlist (type dmc_datatable) (Webtop)

objectlist (type dmc_datatable) (Webtop)

Purpose
Displays a list of dmc_datatable objects.

Parameters
None.

Description
Since
6.0

Configuration File
webtop\config\datatable_listing_components.xml

Parent Definition
webtop/config/objectlist_component.xml

Scope

type dmc_datatable

Elements
columns
See columns (for streamline view), page 811.

objectfilters
See objectfilters, page 827.
showfilters
See showfilters, page 835.
showthumbnail
Since 6.0 SP1.
Enables (true) and disables (false) displaying thumbnails.

1038 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
objectlist (type dmc_room) (Webtop)

objectlist (type dmc_room) (Webtop)

Purpose
Displays a list of all rooms in the repository.

Parameters
The parameters are inherited from objectlist:webtop/config/objectlist_component.xml. See objectlist
(Webtop), page 1083.

Description
Since
5.x

Configuration File
webtop\config\room_objectlist_component.xml

Parent Definition
objectlist:webtop/config/objectlist_component.xml

Scope

type dmc_room

Usage
This component can be initialized in the following ways:
• No parameters
Displays Docbase root cabinets
• folderId
Displays the primary location of the specified folder Id
• folderIds
Displays an absolute folder that is specified as a list of dot‑separated (.) object IDs
• folderPath
Displays the folder that is specified by the path

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1039
properties (type dmc_calendar_event)

Elements
None.

properties (type dmc_calendar_event)

Purpose
Displays the properties of a dmc_calendar_event object.

Parameters
The parameters are inherited from properties:webcomponent/config/library/properties/properties_
component.xml. See properties, page 926.

Description
Since
6.0

Configuration File
webcomponent\config\library\calendars\calendar_event_properties_component.xml

Parent Definition
properties:webcomponent/config/library/properties/properties_component.xml

Scope

type dmc_calendar_event

Elements
commitorder
See commitorder, page 814.

failoverenabled
This element structure is inherited from properties:webcomponent/config/library/properties/
properties_component.xml. See properties, page 926.

1040 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
properties (type dmc_datatable)

setrepositoryfromobjectid
See setrepositoryfromobjectid, page 834.

properties (type dmc_datatable)

Purpose
Displays the properties of dmc_datatable objects.

Parameters
The parameters are inherited from properties:webcomponent/config/library/properties/properties_
component.xml. See properties, page 926.

Description
Since
6.0

Configuration File
webcomponent\config\library\datatables\table_properties_component.xml

Parent Definition
properties:webcomponent/config/library/properties/properties_component.xml

Scope

type dmc_datatable

Elements
commitorder
See commitorder, page 814.

failoverenabled
This element structure is inherited from properties:webcomponent/config/library/properties/
properties_component.xml. See properties, page 926.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1041
properties (type dmc_room)

setrepositoryfromobjectid
<setrepositoryfromobjectid>true</setrepositoryfromobjectid>
Set to true to execute the query against the source repository. Affects reference and foreign objects.

properties (type dmc_room)

Purpose
Displays property sheets that show general information about the selected room object, such as name,
type, format and owner. Requires Documentum Collaborative Services.

Parameters
The parameters are inherited from properties:webcomponent/config/library/properties/properties_
component.xml. See properties, page 926.

Description

Since
5.x

Configuration File
webcomponent\config\library\rooms\room_properties_component.xml

Parent Definition
properties:webcomponent/config/library/properties/properties_component.xml

Scope

type dmc_room

Elements
commitorder
See commitorder, page 814.

1042 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
recurrence

failoverenabled
This element structure is inherited from properties:webcomponent/config/library/properties/
properties_component.xml. See properties, page 926.

setrepositoryfromobjectid
See setrepositoryfromobjectid, page 834.

recurrence

Purpose
Creates the recurring event portion of a dmc_calendar_event object.

Parameters

objectId (Required) ID of the dmc_calendar_event object.

Description
Since
6.0

Configuration File
webcomponent\config\library\calendars\newcalendarevent_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1043
richtextimagepicker

richtextimagepicker

Purpose
Uploads an image into the Rich Text Editor, resulting in the insertion of an image tag <img> in the
rich text HTML. The image file is stored in a temporary location on the application server until the
rich text is saved, at which point the image file is saved to the repository. Requires Documentum
Collaborative Services on the Content Server.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\richtext\imagepicker_component.xml

Scope
All.

Elements
None.

richtextinsertlink

Purpose
Inserts a link in the rich text editor. Requires Documentum Collaborative Services on the Content
Server.

1044 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
roomgrouplocator

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\richtext\insertlink_component.xml

Scope
All.

Elements
None.

roomgrouplocator

Purpose
Displays a selection list with all groups for a room.

Parameters

arrangeselect (Optional) Boolean: Set to true to allow selection


of members in a sequential order.
flatlist (Optional) Boolean: Set to true to list all objects
in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1045
roomgrouplocator

objecttype (Optional) Type of the selected object


roomId (Required) Object ID of the room whose
members to include in the list.

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\roomuserorgrouplocatorcontainer_component.xml

Parent Definition
grouplocator:webcomponent/config/library/locator/grouplocator_component.xml

Scope
All.

Elements
containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

objecttype
<objecttype>dm_group</objecttype>

Specifies the object type of the objects to locate.

privategroupvisible
See privategroupvisible, page 832.
views
See views, page 839.

1046 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
roomgrouplocatorcontainer

roomgrouplocatorcontainer

Purpose
Contains one or more roomgrouplocator components.

Parameters

arrangeselect (Optional) Boolean: Set to true to allow selection


of members in a sequential order.
flatlist (Optional) Boolean: Set to true to list all objects
in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
nobuiltingroups (Optional) Boolean: Set to true to suppress
display of built‑in groups (Owners, Contributors,
Members, Visitors)
objecttype (Optional) Type of the selected object
roomId (Required) Object ID of the room whose
members to include in the list.
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected

Description

Since
5.x

Configuration File
webcomponent\config\library\rooms\roomuserorgrouplocatorcontainer_component.xml

Parent Definition
grouplocatorcontainer:webcomponent/config/library/locator/grouplocator_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1047
roominvite (entitlement collaboration)

Scope
All.

Elements
None.

roominvite (entitlement collaboration)

Purpose
Sends an invitation to selected room members.

Parameters

objectId (Required) ID of the dmc_room object for which


to send an invitation.

Description
Since
6.0

Configuration File
webcomponent\config\library\rooms\room_invites_component.xml

Scope

entitlement collaboration

Elements
None.

1048 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
roommembership

roommembership

Purpose
Displays a table listing all members of a room. Requires Documentum Collaborative Services.

Parameters

objectId (Required) Object ID of the room whose


members are listed.

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\room_membership.xml

Scope
All.

Elements
None.

roomoptions

Purpose
Sets the options for a room, including default permissions for contributors. Requires Documentum
Collaborative Services.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1049
roomuserorgrouplocator

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\newroom_component.xml

Scope
All.

Elements
None.

roomuserorgrouplocator

Purpose
Displays a selection list with all members of a room. Requires Documentum Collaborative Services.

Parameters

arrangeselect (Optional) Boolean: Set to true to allow selection


of members in a sequential order.
flatlist (Optional) Boolean: Set to true to list all objects
in a flat list, set to false to display objects in a
drop‑down list.
groupName (Optional) ID of group to which the selection
will be restricted
multiselect (Optional) Boolean: Set to true to support
multiple selection.

1050 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
roomuserorgrouplocator

nobuiltingroups (Optional) Boolean: Set to true to suppress


display of built‑in groups (Owners, Contributors,
Members, Visitors).
objecttype (Optional) Object type to display.
roomId (Required) Object ID of the room whose
members to include in the list.
toplevelusers (Optional) Boolean: Set to true to display only
those users added directly to room.

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\roomuserorgrouplocatorcontainer_component.xml

Parent Definition
userorgrouplocator:webcomponent/config/library/locator/userorgrouplocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

failoverenabled
This element structure is inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.
flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1051
roomuserorgrouplocatorcontainer

iconwell_icon
See iconwell_icon, page 822.

includeunlisted
See includeunlisted, page 823.
objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to locate.

preset_item
See preset_item, page 830.
privategroupvisible
See privategroupvisible, page 832.
views
See views, page 839.
workqueuegroupvisible
See workqueuegroupvisible, page 841.

roomuserorgrouplocatorcontainer

Purpose
Container component for displaying a list of room members. Requires Documentum Collaborative
Services.

Parameters

arrangeselect (Optional) Boolean: Set to true to allow selection


of members in a sequential order.
flatlist (Optional) Boolean: Set to true to list all objects
in a flat list, set to false to display objects in a
drop‑down list.

1052 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
roomuserorgrouplocatorcontainer

groupName (Optional) ID of a group to which the selection


will be limited.
multiselect (Optional) Boolean: Set to true to support
multiple selection.
nobuiltingroups (Optional) Boolean: Set to true to display only
custom groups.
objecttype (Optional) Object type to display.
roomId (Required) Object ID of the room whose
members to include in the list.
selectedobjectids (Optional) Comma‑separated list of IDs of
objects that are to be initially selected.Since 6.0.
toplevelusers (Optional) Boolean: Set to true to display only
top‑level users.

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\roomuserorgrouplocatorcontainer_component.xml

Parent Definition
userorgrouplocatorcontainer:webcomponent/config/library/locator/userorgrouplocator_component.
xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from userorgrouplocatorcontainer:webcomponent/config/library/
locator/userorgrouplocator_component.xml. See userorgrouplocatorcontainer, page 1528.

multidocbasesupport
See multidocbasesupport, page 825.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1053
showtopic

showtopic

Purpose
Displays a standalone topic page for objects that do not have embedded topics. The topic is rendered
on the page along with the controls needed to add, edit, and delete comments. Requires Documentum
Collaborative Services.

Parameters

folderPath (Optional) Folder path of the parent topic


nodeIds (Optional) List of dot‑separated object IDs used
to build an absolute location for display
objectId (Required) ID of the parent object
type (Optional) Parent object type, for example,
dm_folder

Description
Since
5.x

Configuration File
webcomponent\config\library\discussion\topicpage_component.xml

Scope
All.

Elements
comments
See comments, page 814.

1054 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
showtopic (Webtop)

showtopic (Webtop)

Purpose
Extends the webcomponent showtopic and displays an object’s associated topic. Requires
Documentum Collaborative Services.

Parameters
The parameters are inherited from showtopic:/webcomponent/config/library/discussion/topicpage_
component.xml. See showtopic, page 1054.

Description
Since
5.x

Configuration File
webtop\config\topicpage_component.xml

Parent Definition
showtopic:/webcomponent/config/library/discussion/topicpage_component.xml

Scope
All.

Elements
comments
See comments, page 814.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1055
spellchecker

spellchecker

Purpose
Checks the spelling in the rich text editor. Requires the ActiveX plug‑in to be enabled in app.xml
and a successful plug‑in download to the client. Rich text editing or display requires Documentum
Collaborative Services on the Content Server.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\richtext\spellchecker_component.xml

Scope
All.

Usage
The calling window needs to set the following variables:
window.contentWindow window: the iFrame ContentWindow
window.layerDoc: the iFrame document

Elements
None.

streamlineview (type dmc_room) (Webtop)

Purpose
Displays dmc_room objects in the Webtop streamline view.

1056 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
tablefields

Parameters
The parameters are inherited from drilldown:webcomponent/config/navigation/drilldown/drilldown_
component.xml. See drilldown, page 1071.

Description

Since
5.x

Configuration File
webtop\config\room_streamlineview_component.xml

Parent Definition
streamlineview:webtop/config/streamlineview_component.xml

Scope

type dmc_room

Elements
None.

tablefields

Purpose
Displays table entries in a dmc_table object.

Parameters

objectId (Required) ID of the dmc_table object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1057
ungovern (type dm_folder)

Description
Since
6.0

Configuration File
webcomponent\config\library\datatables\newtable_component.xml

Scope
All.

Elements
None.

ungovern (type dm_folder)

Purpose
Confirms that objects are being removed from a Room. Allows users to ungovern just a folder or
the folder and all children. Children that are governed by a different room than the folder remain
governed. Requires Documentum Collaborative Services.

Parameters

objectId (Required) ID of the object being removed

Description
Since
5.x

Configuration File
webcomponent\config\library\rooms\ungovern_component.xml

1058 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newdocbaseobject

Scope

type dm_folder

Elements
None.

Creating objects

newdocbaseobject

Purpose
Creates a new object in the repository.

Parameters

objectId (Required) ID of the object to create.

Description
Since
6.0

Configuration File
webcomponent\config\library\create\newdocbaseobject_component.xml

Scope
All.

Elements
objecttype

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1059
newdocbaseobjectcontainer

<objecttype>dmc_document</objecttype>

Specifies the object type of the objects to create.

newdocbaseobjectcontainer

Purpose
Calls the newdocbaseobject, page 1059 component.

Parameters

component (Required) Name of the component to call.

Description
Since
6.0

Configuration File
webcomponent\config\library\create\newdocbaseobject_component.xml

Parent Definition
propertysheetwizardcontainer:webcomponent/config/library/propertysheetwizardcontainer/
propertysheetwizardcontainer_component.xml

Scope
All.

Elements
newcomponentname
See newcomponentname, page 825.
numberedtabs
See numberedtabs, page 827.

1060 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newdoccontainer

newdoccontainer

Purpose
Extends propertysheetwizardcontainer, page 930 and contains attributes, the component
newdocument, page 1062, and permissions. The componentnewdocument, page 1062 requires a visit.

Parameters

component (Required) ID of the component displayed


contentType (Optional) Content type of document being
created.
editAfterCreate (Optional) Boolean: Set to true to open the new
document object in edit mode after it has been
created.

Description
Since
5.x

Configuration File
webcomponent\config\library\create\newdoccontainer_component.xml

Parent Definition
propertysheetwizardcontainer:webcomponent/config/library/propertysheetwizardcontainer/
propertysheetwizardcontainer_component.xml

Scope
All.

Usage
For performance reasons, validation is not performed on new document creation. The validation is
performed only when the document is checked in. If the user creates a document with no format (zero
content), then validation is done, because the document can not be edited and is not checked out.
Both NewContainer and NewDocContainer determine the component name by calling a protected
member function, getNewComponentName(). You can override this function to return the component

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1061
newdocument

name. For example, the NewAssemblyContainer Java class, which derives from NewDocContainer,
overrides the getNewComponentName() function to return ʺnewassemblyʺ as the contained
component name.
The parameters for combocontainer (parent of newdoccontainer) are added by the LaunchComponent
action execution class in order to support actions on multiple objects. Do not call the container by URL.

Elements
numberedtabs
See numberedtabs, page 827.

newcomponentname
See newcomponentname, page 825.

numberedtabs
See numberedtabs, page 827.

newdocument

Purpose
Creates new objects. This component must run within the component newdoccontainer, page 1061 or
the component newhttpdoccontainer, page 1063. Each custom object must have a template in the
repository Templates cabinet in order for the template and its associated formats to show up in the
newdocument UI.

Parameters

objectId (Required) ID of the folder that will contain the


new document

Description
Since
5.x

1062 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newhttpdoccontainer

Configuration File
webcomponent\config\library\create\newdocument_component.xml

Scope
All.

Usage
Refer to newdoccontainer, page 1061.

Elements
combo_defaults

1 <combo_defaults>
2<base_type>dm_document</base_type>
3<type>dm_document</type>
4<format>msw8</format>
</combo_defaults>

1 Configures the preferred default selected object type and format and whether to display templates
for supertypes of formats that do not have a template in the current repository.
2 Base object type of the one specified in <type>.
3 Default type to display in type combo box. Valid values: dm_sysobject or subtype.
4 Default format to display in format combo box. A template of this format must be available in the
/Templates cabinet or subfolder. Valid values: ’name’ attribute values for dm_format object.

document_filter
See document_filter, page 817.

preset_item
See preset_item, page 830.

newhttpdoccontainer

Purpose
Extends newdoccontainer, page 1061.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1063
exporttocsv

Parameters
The parameters are inherited from newdoccontainer:webcomponent/config/library/create/
newdoccontainer_component.xml. See newdoccontainer, page 1061.

Description

Since
5.x

Configuration File
webcomponent\config\library\httpcreate\newhttpdocument_component.xml

Parent Definition
newdoccontainer:webcomponent/config/library/create/newdoccontainer_component.xml

Scope
All.

Elements
numberedtabs
See numberedtabs, page 827.

newcomponentname
See newcomponentname, page 825.

Data import and export

exporttocsv

Purpose
Exports datagrid row content to a comma‑separated value file.

1064 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
importcsv

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\library\exporttocsv\exporttocsv_component.xml

Scope
All.

Elements
None.

importcsv

Purpose
Imports a comma‑separated value file into a repository.

Parameters

objectId (Required) ID of the object to be imported.

Description
Since
6.0

Configuration File
webcomponent\config\library\datatables\import_csv_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1065
importcsvcontainer

Scope
All.

Elements
None.

importcsvcontainer

Purpose
Contains the importcsv, page 1065 component.

Parameters

component (Required) Name of the contained component.


objectId (Required) ID of the object to be imported.

Description

Since
6.0

Configuration File
webcomponent\config\library\datatables\import_csv_component.xml

Scope
All.

Elements
None.

1066 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
alldocumentlocator

Displaying lists of objects

alldocumentlocator

Purpose
Locates dm_objects in a repository. It allows users to navigate from the root cabinets to locate objects.
Users can filter objects by the content format.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\documentlocators_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

columns
See columns (for data columns), page 811.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1067
attachments

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


contenttypepanelvisible
1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.


filenamefiltervisible
See filenamefiltervisible, page 819.
objecttype
<objecttype>dm_document</objecttype>

Specifies the object type of the objects to locate.

privatecabinetvisible
1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

views
See views, page 839.

attachments

Purpose
Displays a list of attachment objects.

Since
6.5

1068 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
dmr_contentlocator

dmr_contentlocator

Purpose
This component is the locator for all repository documents and dmr_content with folders shown.

Parameters

flatlist (Optional) Boolean: Set to true to display a flat


list of all selectable objects.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) The logical (base) type of the
selectable type

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\dmr_contentlocators_component.xml

Parent Definition
alldocumentlocator:webcomponent/config/library/locator/documentlocators_component.xml

Scope
All.

Elements
objecttype
<objecttype>dm_document</objecttype>

Specifies the object type of the objects to locate.

views
See views, page 839.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1069
dmr_contentlocatorcontainer

dmr_contentlocatorcontainer

Purpose
This component is the locator for all docbase documents and dmr_content with folders shown.

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\dmr_contentlocators_component.xml

Parent Definition
documentlocatorcontainer:webcomponent/config/library/locator/documentlocators_component.xml

Scope
All.

Elements
None.

documentlocatorcontainer

Purpose
Extends the container locatorcontainer, page 1081 and contains locator components:
alldocumentlocator, page 1067, documentsubscriptionlocator, page 1418, mydocumentlocator, page
1250, and recentdocumentlocator, page 1088.

1070 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
drilldown

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\documentlocators_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

drilldown

Purpose
Displays a folder frame and a folder contents frame. The content pane supports filters similar to
those in the doclist component. The user navigates by clicking on a folder or on a folder name
in the breadcrumb control. The drilldown component has an extended version in Webtop called
streamlineview. Deprecated as of version 6.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1071
drilldown

Parameters

folderId (Optional) Specifies the ID of the folder in which


to start browsing
folderPath (Optional) Specifies the path to the folder in
which to start browsing. This path must be
a complete path from the repository root, for
example, /Documentation/Library/subfolder
home_component (Optional) In Portal application, specifies portal
component that calls this component. Used to
construct a breadcrumb back to the portal.
home_component_args (Optional) In Portal application, specifies
arguments that are passed to the portal
component that calls this component when the
user clicks the breadcrumb to go back.
isolate (Optional) Set to true to disable clicking in the
path to the drilldown component
showAllVersions (Optional) Set to true to show all versions of the
object

Description
Since
5.x

Configuration File
webcomponent\config\navigation\drilldown\drilldown_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

dragdrop
See dragdrop, page 818.

1072 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
drilldown (type dm_message_archive)

failoverenabled
See failoverenabled, page 819.

objectfilters
See objectfilters, page 827.
preferences
See preferences, page 828.
showfilters
See showfilters, page 835.

drilldown (type dm_message_archive)

Purpose
Displays a dm_message_archive object in a folder frame and a folder contents frame.

Parameters

folderId (Optional) Specifies the ID of the folder in which


to start browsing.
folderPath (Optional) Specifies the path to the folder in
which to start browsing. This path must be
a complete path from the repository root, for
example: /Documentation/Library/subfolder.
home_component (Optional) In Portal application, specifies portal
component that calls this component. Used to
construct a breadcrumb back to the portal.
home_component_args (Optional) In Portal application, specifies
arguments that are passed to the portal
component that calls this component when the
user clicks the breadcrumb to go back.
isolate (Optional) Set to true to disable clicking in the
path to the drilldown component.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1073
drilldown (type dm_message_archive)

objectId (Optional) ID of the dm_message_archive object.


showAllVersions (Optional) Boolean: Whether to show all versions
of objects (True) or not (False).

Description
Since
5.x

Configuration File
webcomponent\config\library\messagearchive\messagearchive_component.xml

Parent Definition
drilldown:webcomponent/config/navigation/drilldown/drilldown_component.xml

Scope

type dm_message_archive

Elements
columns
See columns (for streamline view), page 811.
dragdrop
See dragdrop, page 818.

failoverenabled
This element structure is inherited from drilldown:webcomponent/config/navigation/drilldown/
drilldown_component.xml. See drilldown, page 1071.

objectfilters
See objectfilters, page 827.

preferences
See preferences, page 828.

showfilters
See showfilters, page 835.

1074 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
folderlocatorcontainer

folderlocatorcontainer

Purpose
Extends the containerlocatorcontainer, page 1081 and selects the folders to be searched. This container
is used by advsearch, page 1354 and contains allfolderlocator, page 947, foldersubscriptionlocator,
page 1419, and recentfolderlocator, page 1089.

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\folderlocators_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

locatecheckinlocalfile

Purpose
Enables browsing the local filesystem to find files to check in.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1075
locatecheckinlocalfilecontainer

Parameters
The parameters are inherited from locatelocalfile:webcomponent/config/library/contenttransfer/
locatelocalfile_component.xml. See locatelocalfile, page 1079.

Description

Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\checkin\locatecheckinlocalfile_component.xml

Parent Definition
locatelocalfile:webcomponent/config/library/contenttransfer/locatelocalfile_component.xml

Scope
All.

Elements
None.

locatecheckinlocalfilecontainer

Purpose
Container for components that enable browsing the local filesystem to find files to check in.

Parameters
The parameters are inherited from locatelocalfilecontainer:webcomponent/config/library/
contenttransfer/locatelocalfilecontainer_component.xml. See locatelocalfilecontainer, page 1080.

1076 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
locateimportlocalfile

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\checkin\locatecheckinlocalfilecontainer_component.
xml

Parent Definition
locatelocalfilecontainer:webcomponent/config/library/contenttransfer/locatelocalfilecontainer_
component.xml

Scope
All.

Elements
None.

locateimportlocalfile

Purpose
Displays local files for import into repositories.

Parameters
The parameters are inherited from locatelocalfile:webcomponent/config/library/contenttransfer/
locatelocalfile_component.xml. See locatelocalfile, page 1079.

Description
Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1077
locateimportlocalfilecontainer

Configuration File
webcomponent\config\library\contenttransfer\importcontent\locateimportlocalfile_component.xml

Parent Definition
locatelocalfile:webcomponent/config/library/contenttransfer/locatelocalfile_component.xml

Scope
All.

Elements
None.

locateimportlocalfilecontainer

Purpose
Container for components that display local files to import.

Parameters
The parameters are inherited from locatelocalfilecontainer:webcomponent/config/library/
contenttransfer/locatelocalfilecontainer_component.xml. See locatelocalfilecontainer, page 1080.

Description

Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\importcontent\locateimportlocalfilecontainer_
component.xml

Parent Definition
locatelocalfilecontainer:webcomponent/config/library/contenttransfer/locatelocalfilecontainer_
component.xml

1078 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
locatelocalfile

Scope
All.

Elements
None.

locatelocalfile

Purpose
Displays local files.

Parameters

fileName (Optional) Name of the file to import.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\locatelocalfile_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1079
locatelocalfilecontainer

locatelocalfilecontainer

Purpose
Container for components that display local files.

Parameters

component (Required) Supplied by the action execution


class). The name of the component to contain.
fileName (Optional) Name of the file to import.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\locatelocalfilecontainer_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

1080 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
locatorcontainer

locatorcontainer

Purpose
Extends propertysheetcontainer, page 928 and serves as a base locator container component.

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
folderId (Optional) The ID of the folder in which to begin
the search.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) Type of the selected object
repository (Optional) The docbase in which to search
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected
storelist (Optional)

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\locatorcontainer_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1081
myobjects_list

Elements
failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.
multidocbasesupport
See multidocbasesupport, page 825.

myobjects_list

Purpose
Lists objects that are owned by the user. Deprecated as of version 6.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\library\myobjects\myobjects_list_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

failoverenabled
See failoverenabled, page 819.

1082 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
objectlist (Webtop)

modifiedwithindays
See modifiedwithindays, page 825.

objecttype
<objecttype>dm_document</objecttype>

Specifies the object type of the objects to display.

preset_item
See preset_item, page 830.

showfolders
See showfolders, page 835.

objectlist (Webtop)

Purpose
Displays a list of dm_sysobject objects.

Parameters

folderId (Optional) Specifies the primary location of the


specified folder Id
folderIds (Optional) Specifies a list of dot‑separated object
IDs that are used to build an absolute location
to display as the path
folderPath (Optional) Specifies the path to the folder in
which to start browsing. This path must be
a complete path from the Docbase root, for
example, /Documentation%20Library/subfolder
showAllVersions (Optional) Set to true to display all versions of
the objects

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1083
objectlist (Webtop)

Description
Since
5.x

Configuration File
webtop\config\objectlist_component.xml

Parent Definition
doclist:webcomponent/config/navigation/doclist/doclist_component.xml

Scope
All.

Usage
This component can be initialized in the following ways:
• No parameters
Displays Docbase root cabinets
• folderId
Displays the primary location of the specified folder Id
• folderIds
Displays an absolute folder that is specified as a list of dot‑separated (.) object IDs
• folderPath
Displays the folder that is specified by the path

Elements
columns
See columns (for streamline view), page 811.

dragdrop
See dragdrop, page 818.
failoverenabled
This element structure is inherited from doclist:webcomponent/config/navigation/doclist/doclist_
component.xml. See doclist, page 1187.

objectfilters
See objectfilters, page 827.

1084 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
objectlocator

preset_item
See preset_item, page 830.

showfilters
See showfilters, page 835.

objectlocator

Purpose
The locator components locate objects in the repository. You can include locators in your component
class when you need to locate Documentum objects. Locator components locate objects by type. Some
locators search on specific criteria within the type, such as objects that are subscribed to or belong to
the user. Two types of views are supported: flatlist, in which all selectable objects in the repository are
shown, and hierarchical, in which the user can drill down from a list of root container (cabinets).

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
folderId (Optional) ID of the folder in which to search
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) Type of the selected object
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected.
storelist (Optional)

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1085
persistentobjectlocator

Configuration File
webcomponent\config\library\locator\objectlocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.

objecttype
<objecttype></objecttype>

Specifies the object type of the objects to locate.


views
See views, page 839.

persistentobjectlocator

Purpose
Locates and selects any persistent object in the repository. It is a generic locator which can be
configured to locate any object in the repository.

1086 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
persistentobjectlocator

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) Type of the selected object

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\persistentobjectlocator_component.xml

Scope
All.

Elements
attributes
See attributes, page 810.

columns
See columns (for data columns), page 811.

objecttype
<objecttype></objecttype>

Specifies the object type of the objects to locate.


views
See views, page 839.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1087
recentdocumentlocator

recentdocumentlocator

Purpose
Displays all objects that have been selected within the user’s current HTTP session. This component
has no scope, but <objecttype> element is configured by default to restrict search to dm_document.

Parameters
The parameters are inherited from recentsysobjectlocator:webcomponent/config/library/locator/
recentsysobjectlocator_component.xml. See recentsysobjectlocator, page 1090.

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\documentlocators_component.xml

Parent Definition
recentsysobjectlocator:webcomponent/config/library/locator/recentsysobjectlocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


iconwell_icon
See iconwell_icon, page 822.

objecttype
<objecttype>dm_document</objecttype>

1088 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
recentfolderlocator

Specifies the object type of the objects to locate.


views
See views, page 839.

recentfolderlocator

Purpose
Extends recentsysobjectlocator, page 1090 and locates folders that were recently selected or used. This
component has no scope, but the <objecttype> element restricts the search by default to dm_folder
objects.

Parameters
The parameters are inherited from recentsysobjectlocator:webcomponent/config/library/locator/
recentsysobjectlocator_component.xml. See recentsysobjectlocator, page 1090.

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\folderlocators_component.xml

Parent Definition
recentsysobjectlocator:webcomponent/config/library/locator/recentsysobjectlocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1089
recentsysobjectlocator

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


iconwell_icon
See iconwell_icon, page 822.
objecttype
<objecttype>dm_folder</objecttype>

Specifies the object type of the objects to locate.


views
See views, page 839.

recentsysobjectlocator

Purpose
Extends objectlocator, page 1085 and locates objects that were recently selected or used.

Parameters

contentType (Optional) Content type for filetype filter


multiselect (Optional) Boolean: Set to true to support
multiple selection.
objecttype (Optional) Object type to display in the list

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\recentsysobjectlocator_component.xml

1090 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
sysobjectlocator

Parent Definition
objectlocator:webcomponent/config/library/locator/objectlocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.

iconwell_icon
See iconwell_icon, page 822.

objecttype
<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to locate.


views
See views, page 839.

sysobjectlocator

Purpose
Displays all dm_sysobject objects in a locator.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1091
sysobjectlocator

Parameters

contentType (Optional) Content type for filetype filter


flatlist (Optional) Boolean: Set to true to list all objects
in a flat list, set to false to display objects in a
drop‑down list.
folderId (Optional) ID of folder in which to begin the
search
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) Type of the selected object

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\sysobjectlocator_component.xml

Parent Definition
objectlocator:webcomponent/config/library/locator/objectlocator_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

columns
See columns (for data columns), page 811.

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

1092 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
unfilteredcontainersysobjectlocator

contenttypepanelvisible
1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.


filenamefiltervisible
See filenamefiltervisible, page 819.
flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.

objecttype
<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to locate.


privatecabinetvisible
1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

views
See views, page 839.

unfilteredcontainersysobjectlocator

Purpose
Extends sysobjectlocator, page 1091 and allows the user to navigate the repository from the root
cabinet in order to locate a dm_sysobject. Two types of views are supported: flatlist, in which all
selectable objects in the repository are shown, and hierarchical, in which the user can drill down
from a list of root container (cabinets).

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1093
unfilteredcontainersysobjectlocator

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\unfilteredcontainersysobjectlocator_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

contenttypepanelvisible
1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.

filenamefiltervisible
See filenamefiltervisible, page 819.
objecttype
<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to locate.


privatecabinetvisible
1 <privatecabinetvisible>false</privatecabinetvisible>

1094 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
locations

1 See privatecabinetvisible, page 832.


views
See views, page 839.

Displaying lists of objects associated with an


object

locations

Purpose
Extends objectgrid, page 1194 and lists the folders and virtual documents to which the selected object
is directly linked.

Parameters

objectId (Required) ID of the object

Description
Since
5.x

Configuration File
webcomponent\config\library\locations\locations_component.xml

Parent Definition
objectgrid:/webcomponent/config/navigation/objectgrid/objectgrid_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1095
locations (Webtop)

Elements
dragdrop
See dragdrop, page 818.
header
See header, page 821.
columns
See columns (for streamline view), page 811.
nondocbasecolumns
See nondocbasecolumns, page 826.

locations (Webtop)

Purpose
Extends the WDK locations component and lists the folders and virtual documents to which the
selected object is directly linked. Gets the current view, sets the appropriate view page, and presents
the Webtop browsertree.

Parameters
The parameters are inherited from locations:/webcomponent/config/library/locations/locations_
component.xml. See locations, page 1095.

Description
Since
5.x

Configuration File
webtop\config\locations_component.xml

Parent Definition
locations:/webcomponent/config/library/locations/locations_component.xml

1096 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
relationships

Scope
All.

Elements
dragdrop
See dragdrop, page 818.

relationships

Purpose
Extends objectgrid, page 1194 and lists the sysobjects to which the source sysobject has a relationship
(dm_relation object).

Parameters

objectId (Required) ID of the sysobject for which to locate


relationships

Description
Since
5.x

Configuration File
webcomponent\config\library\relationships\relationships_component.xml

Parent Definition
objectgrid:/webcomponent/config/navigation/objectgrid/objectgrid_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1097
bravaviewer

Elements
columns
See columns (for data columns), page 811.
header
See header, page 821.
nondocbasecolumns
See nondocbasecolumns, page 826.

Document Imaging Services

bravaviewer

Purpose
This is a sample IGC Brava viewer component for illustration purposes only.

Parameters
The parameters are inherited from daejaviewer:webcomponent/config/library/imaging/samples/
daejaviewer_component.xml. See daejaviewer, page 1099.

Description

Since
5.x

Configuration File
webcomponent\config\library\imaging\samples\bravaviewer_component.xml

Parent Definition
daejaviewer:webcomponent/config/library/imaging/samples/daejaviewer_component.xml

1098 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
daejaviewer

Scope
All.

Elements
CreateAnno and CreateRedact
These element structures are inherited from daejaviewer:webcomponent/config/library/imaging/
samples/daejaviewer_component.xml. See daejaviewer, page 1099.

daejaviewer

Purpose
Base component used by the Image Viewer Framework. All the other viewer components, such as
pdfviewer and bravaviewer, are derived from this base component, which means that they share the
same component behavior class and parameters but with different JSP pages to embed different
viewers. The JSP page for the base component uses Daeja ViewOne Pro as the viewer.

Parameters

objectId (Required) Document to be opened by the


viewer.

Description

Since
5.x

Configuration File
webcomponent\config\library\imaging\samples\daejaviewer_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1099
getannotation

Elements
CreateAnno and CreateRedact

<filter>
<CreateAnno>true</CreateAnno>
<CreateRedact>false</CreateRedact>
</filter>

getannotation

Purpose
For internal use only.

Parameters

format (Optional) For internal use only.


objectId (Required) For internal use only.

Description
Since
5.x

Configuration File
webcomponent\config\library\imaging\getannotation_component.xml

Scope
All.

Elements
None.

1100 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
getdocument

getdocument

Purpose
For internal use only.

Parameters

format (Optional) For internal use only.


objectId (Required) For internal use only.
pageModifier (Optional) For internal use only.
pageNumber (Optional) For internal use only.

Description
Since
5.x

Configuration File
webcomponent\config\library\imaging\getdocument_component.xml

Scope
All.

Elements
None.

imagingserviceservlet

Purpose
For internal use only.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1101
pdfviewer

Parameters

format (Optional) For internal use only.


objectId (Required) For internal use only.
pageModifier (Optional) For internal use only.
pageNumber (Optional) For internal use only.

Description

Since
5.x

Configuration File
webcomponent\config\library\imaging\samples\imagingserviceservlet_component.xml

Scope
All.

Elements
None.

pdfviewer

Purpose
Component derived from daejaviewer component; the JSP page shows Acrobat Reader as the viewer.

Parameters
The parameters are inherited from daejaviewer:webcomponent/config/library/imaging/samples/
daejaviewer_component.xml. See daejaviewer, page 1099.

1102 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
printdocuments (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\library\imaging\samples\pdfviewer_component.xml

Parent Definition
daejaviewer:webcomponent/config/library/imaging/samples/daejaviewer_component.xml

Scope
All.

Elements
CreateAnno and CreateRedact
These element structures are inherited from daejaviewer:webcomponent/config/library/imaging/
samples/daejaviewer_component.xml. See daejaviewer, page 1099.

printdocuments (type dm_sysobject)

Purpose
For internal use only.

Parameters

clientlog (Optional) For internal use only.


inline (Optional) For internal use only.
objectId (Required) For internal use only.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1103
saveannotation

Description
Since
6.0

Configuration File
webcomponent\config\library\imaging\printdocuments_component.xml

Scope

type dm_sysobject

Elements
printablemimetypes

<printablemimetypes>
<mimetype>application/pdf</mimetype>
...
</printablemimetypes>

For internal use only.

saveannotation

Purpose
For internal use only.

Parameters

format (Optional) For internal use only.


objectId (Required) For internal use only.
pageModifier (Optional) For internal use only.
pageNumber (Optional) For internal use only.

1104 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
savedocument

Description
Since
5.x

Configuration File
webcomponent\config\library\imaging\saveannotation_component.xml

Scope
All.

Elements
None.

savedocument

Purpose
For internal use only.

Since
6.5

viewcontainer_imaging (type dm_sysobject)

Purpose
Sample viewer container component used to illustrate the use of other viewer components, for
example, daejaviewer and pdfviewer.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1105
viewcontainer_imaging (type dm_sysobject)

Parameters

component (Required) Viewer container component;


use defaultviewer to call the default viewer
component; use pdfviewer to call the viewer
component for showing a PDF document.
componentArgs (Required) List of arguments and values to pass
to each contained component. Supplied by the
LaunchComponent action execution class.

Description
Since
5.x

Configuration File
webcomponent\config\library\imaging\samples\viewcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope

type dm_sysobject

Elements
defaultviewer

<defaultviewer>daejaviewer</defaultviewer>

Specifies the default viewer.


pdfviewer

<pdfviewer>pdfviewer</pdfviewer>

Specifies the PDF viewer.

1106 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attachmentcheckin

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

Downloading and uploading content

attachmentcheckin

Purpose
Checks in attachments.

Since
6.5

attachmentimport

Purpose
Imports files as attachments.

Since
6.5

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1107
attachmentimportcontainer

attachmentimportcontainer

Purpose
Container for importing files as attachments.

Since
6.5

cancelcheckout (type dm_sysobject)

Purpose
This is the WDK 5.3 cancelcheckout component. It cancels the checkout of one or more previously
checked out objects by removing the lock on the specified objects. This component must run within
the 5.3 cancelcheckoutcontainer component or the httpcancelcheckoutcontainer. The cancelcheckout
component is defined for dm_sysobject and dm_folder.

Parameters

nodeId (Optional) Node ID of the checked out object,


when it is part of a virtual document.
objectId (Required)The ID of the checked out docbase
object.
vdmRootObjectId (Optional) Object ID of the root of a virtual
document (when operating on a child node).

Description
Since
5.x

1108 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
cancelcheckoutcontainer

Configuration File
webcomponent\config\library\contenttransfer\cancelcheckout\cancelcheckout_component.xml

Scope

type dm_sysobject

Elements
init­controls
See init‑controls, page 823.
service
See service, page 834.
ucfrequired
See ucfrequired, page 838.

cancelcheckoutcontainer

Purpose
This is the WDK 5.3 cancelcheckoutcontainer component. It allows users to remove the lock on
specified checked‑out documents

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\cancelcheckout\cancelcheckoutcontainer_
component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1109
changeucfcheckoutlocation

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

setrepositoryfromobjectid
<setrepositoryfromobjectid>true</setrepositoryfromobjectid>
See setrepositoryfromobjectid, page 834.

ucfrequired
See ucfrequired, page 838.

changeucfcheckoutlocation

Purpose
Sets the checkout location for objects.

Parameters
None.

1110 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
checkin (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\environment\preferences\general\changeucfcheckoutlocation_component.
xml

Scope
All.

Elements
ucfrequired
See ucfrequired, page 838.

checkin (type dm_sysobject)

Purpose
This is the WDK 5.3 checkin component. It checks in objects that were checked out and sets properties
on the objects. The checkin component is available in all views for objects that are checked out on the
user’s current machine. This component must be used within 5.3 checkincontainer.

Parameters

keepLocalFile (Optional) Whether to keep the local file on the


machine (True) or not (False).Since 6.0.
nodeId (Optional) ID of the node in a virtual document
to check in
objectId (Required) The ID of the object to check in.
retainLock (Optional) Boolean: Whether to keep the lock on
the object (True) or not (False).Since 6.0.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1111
checkin (type dm_sysobject)

silent (Optional) Boolean: Whether to check in the


object without displaying the checkin or checkin
from dialog box (True) or not (False). If you
specify true for this parameter, you must specify
a valid value for the version parameter.Since 6.0.
vdmRootObjectId (Optional) Root object ID or the virtual document
to check in.
version (Optional) Whether to check in the object as a
major, minor, branched, or the same version
when true is specified for the silent parameter.
Valid values are: major, minor, branch, same. If
this parameter is not specified, then the checkin
dialog box is displayed even when true is
specified for the silent parameter.Since 6.0.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\checkin\checkin_component.xml

Scope

type dm_sysobject

Usage
To customize the checkin layout, use the control. First, create a definition file that is scoped to the
custom type. In the JSP page for the custom type, add a tag for the custom attribute list that you wish
to display on checkin. Add a tag similar to the following:
<dmfx:docbaseattributelist name="attrlist"
object="obj" attrconfigid="checkin"/>

All custom attributes that are in a category appear unless they are listed in the <ignore_attributes>
element. Attributes are displayed in order of category. If the value of showpagesastabs, then the
categories are displayed as tabs.
You can have different attribute lists for checkin, properties, import, and other components.

1112 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
checkincontainer

Elements
init­controls
See init‑controls, page 823.
preset_item
See preset_item, page 830.
service
See service, page 834.
ucfrequired
See ucfrequired, page 838.

checkincontainer

Purpose
This is the WDK 5.3 checkincontainer component. Checking in multiple objects creates one checkin
container and an inner checkin component instance for each object.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description

Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\checkin\checkincontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1113
checkout (type dm_sysobject)

Scope
All.

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

setrepositoryfromobjectid
See setrepositoryfromobjectid, page 834.

ucfrequired
See ucfrequired, page 838.

checkout (type dm_sysobject)

Purpose
This is the WDK 5.3 checkout component. It checks out objects from the repository without launching
an editing application. The checkout component is available in all views for objects that are checked
out on the user’s current machine. This component must be used within the 5.3 checkoutcontainer.
The checkoutcontainer component extends . Checking out multiple objects creates one checkout
container and an inner checkout component instance for each object.

1114 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
checkout (type dm_sysobject)

Parameters

isIgnoreDescendents (Optional) Boolean value that indicates whether


or not to check out descendants in a virtual
document.
isLockOnly (Optional) Boolean value that indicates whether
or not to check out objects that are locked.
nodeId (Optional) r_object_id of a virtual document
node to check out.
objectId (Required) The ID of the object to check out.
skipVersionCheck (Optional) Boolean: Whether to prompt the user
to choose the current version of an object when
the object is not the current version (False) or not
(True). Default is false.
vdmRootObjectId (Optional) r_object_id of the virtual document
root.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\checkout\checkout_component.xml

Scope

type dm_sysobject

Elements
init­controls
See init‑controls, page 823.
service
See service, page 834.

skipVersionCheck
See skipVersionCheck, page 836.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1115
checkoutbyother

ucfrequired
See ucfrequired, page 838.

checkoutbyother

Purpose
Informs the user that the requested object is checked out by another user.

Parameters

message (Optional) The message to display to the user.

Description

Since
5.x

Configuration File
webcomponent\config\library\checkout\checkoutbyother_component.xml

Scope
All.

Elements
None.

checkoutbyothercontainer

Purpose
Container for informing the user that a requested object is checked out by another user.

1116 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
checkoutcontainer

Parameters

component (Required) Supplied by the action execution


class). The name of the component to contain.
message (Optional) The message to display to the user.

Description
Since
5.x

Configuration File
webcomponent\config\library\checkout\checkoutbyothercontainer_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

checkoutcontainer

Purpose
This is the WDK 5.3 checkoutcontainer component. It is the container for the checkout process.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1117
delete

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\checkout\checkoutcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

ucfrequired
See ucfrequired, page 838.

delete

Purpose
Base component for deleting work queue‑related objects.

1118 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (type dm_sysobject)

Parameters

objectId (Required) ID of the object to delete.


objectname (Optional) The name of the object.

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\delete\deleteworkqueueobject_component.xml

Scope
All.

Elements
None.

delete (type dm_sysobject)

Purpose
The delete component deletes dm_folders and other dm_sysobjects, deletes inbox notifications
(dm_notification and dm_queued), and deletes folders (queries the user whether all objects should be
deleted from a folder selected for deletion). This component must be used within the deletecontainer
component.

Parameters

folderId (Optional) ID of the parent folder of the file or


folder that is to be deleted. Applies only to
dm_folder and dm_sysobject types.
objectId (Required) ID of the object to be deleted. Applies
to all types.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1119
delete (type dm_sysobject) (Webtop)

Description
Since
5.x

Configuration File
webcomponent\config\library\delete\deletedocument_component.xml

Scope

type dm_sysobject

Elements
None.

delete (type dm_sysobject) (Webtop)

Purpose
The delete component deletes dm_folders and other dm_sysobjects, deletes inbox notifications
(dm_notification and dm_queued), and deletes folders (queries the user whether all objects should
be deleted from a folder selected for deletion).

Parameters
The parameters are inherited from delete:webcomponent/config/library/delete/deletedocument_
component.xml. See delete (type dm_sysobject), page 1119.

Description
Since
6.0

Configuration File
webtop\config\deletedocument_component.xml

1120 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
download

Parent Definition
delete:webcomponent/config/library/delete/deletedocument_component.xml

Scope

type dm_sysobject

Elements
None.

download

Purpose
The download component calls a servlet that forces download of an object to the browser.

Parameters

docId (Optional) ID of the object to download.


servletAction (Optional) Type of action. Valid values: view |
download.

Description

Since
5.x

Configuration File
webcomponent\config\library\httpview\download_action_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1121
downloadcontentcontainer (type dm_sysobject)

downloadcontentcontainer (type dm_sysobject)

Purpose
Container for components that enable downloading content objects.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\view\viewcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope

type dm_sysobject

Elements
failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.
service
See service, page 834.

1122 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
edit (type dm_sysobject)

ucfrequired
See ucfrequired, page 838.

edit (type dm_sysobject)

Purpose
This is the WDK 5.3 edit component. It edits objects in the repository. This component must run
within the editcontainer component. The edit component is defined for dm_sysobject scope. Editing is
excluded for dm_folder objects by the notdefined attribute on the component element. The container
extends .

Parameters
The parameters are inherited from checkout:webcomponent/config/library/contenttransfer/checkout/
checkout_component.xml. See checkout (type dm_sysobject), page 1114.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\edit\edit_component.xml

Parent Definition
checkout:webcomponent/config/library/contenttransfer/checkout/checkout_component.xml

Scope

type dm_sysobject

Elements
init­controls
See init‑controls, page 823.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1123
editcontainer (type dm_sysobject)

service
See service, page 834.

skipVersionCheck
See skipVersionCheck, page 836.
ucfrequired
See ucfrequired, page 838.

editcontainer (type dm_sysobject)

Purpose
This is the WDK 5.3 editcontainer component. It is the container for components that enable checking
out objects and opening them for editing in an associated application.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\edit\editcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope

type dm_sysobject

1124 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
emfimport

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.
failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.
ucfrequired
See ucfrequired, page 838.

emfimport

Purpose
Enables importing an email as a dm_message_archive object.

Since
6.5

export (type dm_sysobject)

Purpose
This is the WDK 5.3 export component. Exports objects from the repository to the client file system.
This component must run within the 5.3 component exportcontainer.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1125
export (type dm_sysobject)

Parameters

contentType (Optional) File format to use when opening the


object (passed to the operating system).
isIgnoreDescendents (Optional) Specifies whether descendants of a
virtual document should be ignored.
nodeId (Optional) r_object_id of a virtual document
node to edit.
objectId (Required) ID of the object to be exported.
pageModifier (Optional) A valid value for the page_modifier
attribute of the dmr_content object. You should
not pass in your own value for PDF renditions.
vdmRootObjectId (Optional) r_object_id of the virtual document
root.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\export\export_component.xml

Scope

type dm_sysobject

Elements
init­controls
See init‑controls, page 823.

service
See service, page 834.
ucfrequired
See ucfrequired, page 838.

1126 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
export (type dmr_content)

export (type dmr_content)

Purpose
This is the WDK 5.3 export component. It is used to export dm_sysobjects and dmr_content objects
from the repository to the client file system. This component must run within the component
exportcontainer. Export of multiple objects creates one export container and an inner export
component instance for each object.

Parameters

contentType (Optional) File format to use when opening the


object (passed to the operating system).
objectId (Required) ID of the object to be
exported(Required) ID of the object to be
exported
pageModifier (Optional) A valid value for the page_modifier
attribute of the dmr_content object. You should
not pass in your own value for PDF renditions.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\export\export_component.xml

Scope

type dmr_content

Elements
init­controls
See init‑controls, page 823.

service
See service, page 834.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1127
exportcontainer (type dm_message_archive)

ucfrequired
See ucfrequired, page 838.

exportcontainer (type dm_message_archive)

Purpose
Container for displaying a dm_message_archive object to export.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description
Since
6.0

Configuration File
webcomponent\config\library\contenttransfer\export\exportcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope

type dm_message_archive

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

1128 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
exportcontainer (type dm_sysobject)

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

ucfrequired
See ucfrequired, page 838.

exportcontainer (type dm_sysobject)

Purpose
This is a WDK 5.3 exportcontainer component. It is used to export dm_sysobjects and dmr_content
objects from the repository to the client file system. Export of multiple objects creates one export
container and an inner export component instance for each object.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\export\exportcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope

type dm_sysobject

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1129
exportcontainer (type dmr_content)

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.
failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.
ucfrequired
Whether to enable (true) or disable (false) UCF. To enable and disable UCF for specific events, specify
the events/event element structure, where the event element’s attributes are:
• name: name of event.
• enabled: true to enable or false to disable UCF.
Since 6.0 SP1.

exportcontainer (type dmr_content)

Purpose
This is a WDK 5.3 exportcontainer component. It is used to export dm_sysobjects and dmr_content
objects from the repository to the client file system. This component must run within the component
exportcontainer. Export of multiple objects creates one export container and an inner export
component instance for each object.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

1130 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
exportviewcontainer (type dm_message_archive)

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\export\exportcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope

type dmr_content

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

ucfrequired
See ucfrequired, page 838.

exportviewcontainer (type dm_message_archive)

Purpose
Displays a dm_message_archive object to export.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1131
exportviewcontainer (type dm_message_archive)

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description

Since
6.0

Configuration File
webcomponent\config\library\contenttransfer\view\exportviewcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope

type dm_message_archive

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

ucfrequired
See ucfrequired, page 838.

1132 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
externalresultimportcontainer

externalresultimportcontainer

Purpose
Container for components that enable importing local files into repositories.

Parameters

component (Required) Supplied by the action execution


class). The name of the component to contain.
componentArgs (Required) Supplied by the LaunchComponent
action execution class.) List of arguments and
values to pass to each contained component.
entryId (Required) Internal key to the query results.
queryId (Required) Internally used to identify the current
search context

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\importcontent\externalresultimportcontainer_
component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1133
getcontent

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

getcontent

Purpose
Streams Documentum object content to the browser without the use of applets. Login is requested if
the user has not already logged in.

Parameters

format (Optional) If a value is provided, the component


attempts to stream the content in the specified
format. If not, the object’s native format is used.
objectId (Required) ID of the selected object.
pageModifier (Optional) Specifies a user‑defined attribute
(page_modifier) value that distinguishes
between renditions.
pageNumber (Optional) Specifies the page number of a
document.
streamingMode (Optional) Specifies whether the file is to be
opened in the client application appropriate to
the file’s format or the browser. Valid values are:
attachment: The downloaded file opens in the
client application. inline: The downloaded file
opens in the same browser window. Default is
attachment.Since 6.0.

1134 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
httpcancelcheckout (type dm_sysobject)

Description
Since
5.x

Configuration File
wdk\config\getcontent_component.xml

Scope
All.

Usage
The start page is specified as the URL (/wdk5‑download) that is mapped to the streaming content
servlet.
Following is an example of a URL to stream content to the browser:
http://host:port/webtop/component/getcontent?objectId=0900d47f80002426
&format=richtext&pageNumber=1&ext=bmp&streamingMode=inline

Because the getcontent component is a servlet, you must construct a fully qualified URL when calling
getcontent from a component class. The URL must have the virtual root, which you can obtain from
HttpServletRequest. For example:
String strVirtualRoot = ((HttpServletRequest)pageContext.
getRequest()).getContextPath();
String strUrl = strVirtualRoot + "/component/getcontent?objectId=" +
args.get("objectId"));
setRedirectUrl(strUrl);

Elements
streamingMode
<streamingMode>attachment</streamingMode>

Specifies whether the file is to be opened in the client application appropriate to the file’s format or the
browser. Valid values are: attachment: The downloaded file opens in the client application. inline:
The downloaded file opens in the same browser window. Default is attachment.

httpcancelcheckout (type dm_sysobject)

Purpose
This is the WDK 5.3 httpcancelcheckout component. It enables cancelling checkouts of objects.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1135
httpcancelcheckoutcontainer

Parameters

objectId (Required) r_object_id of the object for which to


cancel the checkout.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\cancelcheckout\httpcancelcheckout_component.xml

Scope

type dm_sysobject

Elements
init­controls
See init‑controls, page 823.
service
See service, page 834.

httpcancelcheckoutcontainer

Purpose
This is the WDK 5.3 httpcancelcheckoutcontainer component. It is a container for components that
enable cancelling the checkout of a repository object.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

1136 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
httpcancelcheckoutcontainer

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\cancelcheckout\httpcancelcheckoutcontainer_
component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.
propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

setrepositoryfromobjectid
See setrepositoryfromobjectid, page 834.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1137
httpcheckin (type dm_sysobject)

httpcheckin (type dm_sysobject)

Purpose
This is the WDK 5.3 httpcheckin component. It checks in non‑XML objects one at a time using the
HTTP input mechanism.

Parameters

objectId (Required) The ID of the object to check in.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\checkin\httpcheckin_component.xml

Scope

type dm_sysobject

Elements
init­controls
See init‑controls, page 823.

service
See service, page 834.

1138 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
httpcheckincontainer

httpcheckincontainer

Purpose
This is the WDK 5.3 httpcheckincontainer. It checks in non‑XML objects one at a time using the
HTTP input mechanism. (XML objects must be checked in using the UCF checkin component, which
contains a parser.) The httpcheckincontainer component extends combocontainer, page 1183.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\checkin\httpcheckincontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Usage
The parameters are added by the action execution class. Do not call the container by URL.

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.
failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1139
httpcheckout (type dm_sysobject)

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

setrepositoryfromobjectid
See setrepositoryfromobjectid, page 834.

httpcheckout (type dm_sysobject)

Purpose
This is the WDK 5.3 httpcheckout component. It checks out objects from the repository without
launching an editing application. The httpcheckout component is available in all views for objects
that are checked out on the user’s current machine. This component must be used within the
httpcheckoutcontainer, page 1141 container. Checking out multiple objects creates one checkout
container and an inner checkout component instance for each object.

Parameters

isIgnoreDescendents (Optional) Boolean value that indicates whether


or not to check out descendants in a virtual
document.
isLockOnly (Optional) Boolean value that indicates whether
or not to check out objects that are locked.
nodeId (Optional) r_object_id of a virtual document
node to check out.
objectId (Required) The ID of the object to check out.
vdmRootObjectId (Optional) r_object_id of the virtual document
root.

1140 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
httpcheckoutcontainer

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\checkout\httpcheckout_component.xml

Scope

type dm_sysobject

Elements
init­controls
See init‑controls, page 823.
service
See service, page 834.

httpcheckoutcontainer

Purpose
This is the WDK 5.3 httpcheckoutcontainer component. It is the container for components that enable
checking out objects from a repository.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1141
httpedit (type dm_sysobject)

Configuration File
webcomponent\config\library\contenttransfer\checkout\httpcheckoutcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

httpedit (type dm_sysobject)

Purpose
This is the WDK 5.3 httpedit component. It enables checking out objects from repositories and opening
them for editing in an associated application on the local machine.

Parameters
The parameters are inherited from httpcheckout:webcomponent/config/library/contenttransfer/
checkout/httpcheckout_component.xml. See httpcheckout (type dm_sysobject), page 1140.

1142 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
httpeditcontainer

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\edit\httpedit_component.xml

Parent Definition
httpcheckout:webcomponent/config/library/contenttransfer/checkout/httpcheckout_component.xml

Scope

type dm_sysobject

Elements
init­controls
See init‑controls, page 823.

service
See service, page 834.

httpeditcontainer

Purpose
This is the WDK 5.3 httpeditcontainer component. It is used to display components that enable
checking out objects and opening them for editing in an associated application via the HTTP protocol.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1143
httpexport (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\edit\httpeditcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.
service
See service, page 834.

httpexport (type dm_sysobject)

Purpose
This is the WDK 5.3 httpexport component. It is used to export dm_sysobjects from the repository
to the client file system. This component must run within the 5.3 exportcontainer (see export (type
dm_sysobject), page 1125).

1144 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
httpexport (type dmr_content)

Parameters

contentType (Optional) File format to use when opening the


object (passed to the operating system)
objectId (Required) ID of the object to be exported
pageModifier (Optional) A valid value for the page_modifier
attribute of the dmr_content object. You should
not pass in your own value for PDF renditions.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\export\httpexport_component.xml

Scope

type dm_sysobject

Elements
init­controls
See init‑controls, page 823.
service
See service, page 834.

httpexport (type dmr_content)

Purpose
This is the WDK 5.3 httpexport component. It is used to export dmr_content objects from the
repository to the client file system. This component must run within the 5.3 exportcontainer (see
export (type dmr_content), page 1127).Export of multiple objects creates one export container and an
inner export component instance for each object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1145
httpexportcontainer

Parameters

contentType (Optional) File format to use when opening the


object (passed to the operating system)
objectId (Required) ID of the object to be exported
pageModifier (Optional) A valid value for the page_modifier
attribute of the dmr_content object. You should
not pass in your own value for PDF renditions.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\export\httpexport_component.xml

Scope

type dmr_content

Elements
init­controls
See init‑controls, page 823.
service
See service, page 834.

httpexportcontainer

Purpose
This is the WDK 5.3 httpexportcontainer component. It is the container for components that enable
exporting objects from repositories to local machines.

1146 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
httpexportcontainer

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description

Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\export\httpexportcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1147
httpimport

httpimport

Purpose

This is the WDK 5.3 httpimport component. It must be used within the httpimportcontainer
component. Using the HTTP protocol, it enables the import of local files into repositories.

Parameters

baseDocbaseType (Optional) Parent object_type of the object_type


of the object to be imported.
docbaseType (Optional) object_type that the file is to be
imported as.
filenameWithPath (Required) True to display the file path with the
file name
localFilePath (Optional) Full path to the file to be imported.
objectId (Required) ID of the target folder for import

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\importcontent\httpimport_component.xml

Scope
All.

Elements
document­docbase­type
See document‑docbase‑type, page 817.

init­controls
See init‑controls, page 823.

1148 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
httpimportcontainer

preserve­file­extension
See preserve‑file‑extension, page 829.

service
See service, page 834.

httpimportcontainer

Purpose
This is the WDK 5.3 httpimportcontainer component. It is the container for components that use the
HTTP protocol to import local files into repositories.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class.) The name of the
component to contain.
componentArgs (Required) Supplied by the LaunchComponent
action execution class.) List of arguments and
values to pass to each contained component.
filePath (Optional) Path to the file on the local machine.
isDirectory (Optional) Boolean that indicates whether the
object being imported is a directory.
parentPath (Optional) Repository path into which the file is
imported.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\importcontent\httpimportcontainer_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1149
httpimportrendition

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

httpimportrendition

Purpose
This is the WDK 5.3 httpimportrendition component. It extends the component import, page
1159 and is used to import a single rendition into the repository using the HTTP content transfer. The
component must run within the 5.3 container httpimportrenditioncontainer.

Parameters

objectId (Required) ID of the target folder for import

1150 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
httpimportrenditioncontainer

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\importrendition\httpimportrendition_component.
xml

Scope
All.

Elements
init­controls
See init‑controls, page 823.
service
See service, page 834.

updatereplicasource
See updatereplicasource, page 838.

httpimportrenditioncontainer

Purpose
This is the WDK 5.3 httpimportrenditioncontainer component. It is the container for components that
are used to import renditions into repositories.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1151
httpmultifiledownload

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\importrendition\httpimportrenditioncontainer_
component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.
propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

httpmultifiledownload

Purpose
Displays a list of files to be downloaded over HTTP content transfer. The user will not have to open
multiple windows at the same time to do simultaneous downloads. It is used by all outbound HTTP
content transfer operations when more than one file is selected.

1152 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
httpview

Parameters

componentArgs (Optional) Not used


contentId (Optional) Array of IDs of selected objects for
download.

Description
Since
5.x

Configuration File
wdk\config\httpmultifiledownload_component.xml

Scope
All.

Elements
None.

httpview

Purpose
This is the WDK 5.3 httpview component. It downloads repository content to the browser local file
system and opens a viewing application on the client. The httpview component must run in the
httpviewcontainer, page 1158 container.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1153
httpview

Parameters

contentType (Optional) File format to use when opening the


object (passed to the operating system)
isIgnorePrefRenditions (Optional) Boolean: Whether to ignore the user’s
preference for opening renditions (True) or not
(False). Default is false for dm_sysobjects, but
true for dmr_content objects.Since 5.3 SP4.
objectId (Required) ID of the object to be viewed

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\view\httpview_component.xml

Scope
All.

Elements
init­controls
See init‑controls, page 823.

isIgnorePrefRenditions
See isIgnorePrefRenditions, page 823.
service
See service, page 834.

1154 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
httpview (type dmr_content)

httpview (type dmr_content)

Purpose
Downloads repository content to the browser local file system and opens a viewing application on the
client. The view component must run in the view (type dmr_content), page 1168 container.

Parameters

contentType (Optional) File format to use when opening the


object (passed to the operating system).
isIgnorePrefRenditions (Optional) Boolean: Whether to ignore the user’s
preference for opening renditions (True) or not
(False). Default is true. Since 5.3 SP4.
objectId (Required) ID of the object to be viewed.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\view\httpview_component.xml

Scope

type dmr_content

Elements
init­controls
See init‑controls, page 823.

isIgnorePrefRenditions
See isIgnorePrefRenditions, page 823.

service
See service, page 834.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1155
httpview (type dmr_content) (Webtop)

httpview (type dmr_content) (Webtop)

Purpose
Downloads repository content (of the dmr_content type) to the browser local file system and opens a
viewing application on the client. The view component must run in the WDK httpview container.

Parameters

contentType (Optional) File format to use when opening the


object (passed to the operating system).
isIgnorePrefRenditions (Optional) Boolean: Whether to ignore the user’s
preference for opening renditions (True) or not
(False). Default is true.
objectId (Required) ID of the object to be viewed

Description
Since
5.x

Configuration File
webtop\config\httpview_component.xml

Scope

type dmr_content

Elements
init­controls
See init‑controls, page 823.

isIgnorePrefRenditions
See isIgnorePrefRenditions, page 823.

service
See service, page 834.

1156 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
httpview (Webtop)

httpview (Webtop)

Purpose
Downloads repository content to the browser local file system and opens a viewing application on the
client. The view component must run in the WDK httpview container.

Parameters

contentType (Optional) File format to use when opening the


object (passed to the operating system).
isIgnorePrefRenditions (Optional) Boolean: Whether to ignore the user’s
preference for opening renditions (True) or not
(False). Default is true.
objectId (Required) ID of the object to be viewed.

Description
Since
5.x

Configuration File
webtop\config\httpview_component.xml

Scope
All.

Elements
init­controls
See init‑controls, page 823.

isIgnorePrefRenditions
See isIgnorePrefRenditions, page 823.
service
See service, page 834.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1157
httpviewcontainer

httpviewcontainer

Purpose
5.3 container for components that enable (via the HTTP protocol) viewing objects in an associated
application on local machines.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\view\httpviewcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.
failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.
propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

1158 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
import

service
See service, page 834.

import

Purpose
This is the WDK 5.3 import component. Imports objects from the client file system to the repository.
The component must run within the 5.3 importcontainer or httpimportcontainer.

Parameters

baseDocbaseType (Optional) Parent object_type of the object_type


of the object to be imported.
defaultAttributesValues (Optional) Default attribute values for the object
that is to be imported.
docbaseType (Optional) object_type that the file is to be
imported as.
filenameWithPath (Required) True to display the file path with the
file name
format (Optional) dm_format of the object to be
imported.
isDirectory (Optional) Boolean that indicates whether the
object being imported is a directory.
localFilePath (Optional) Full path to the file to be imported.
objectId (Required) ID of the target folder for import
oleScanEnable (Optional) Boolean: Whether to enable (true) or
disable (false) scanning files for OLE links.

Since 6.0 SP1.

parentPath (Optional) Repository path into which the file is


imported.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1159
import

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\importcontent\import_component.xml

Scope
All.

Usage
When the user imports a document and selects a custom type for the document, a format dropdown
list is presented for selecting the associated document format. The custom type must have a template
in order be associated with a format. You must have a template in the Templates cabinet for each
format that will apply to your custom type.
To customize the import layout, use the docbaseattributelist, page 42control. First, create a definition
file that is scoped to each type for which you wish to provide a different set of import attributes, as
described in docbaseattributelist, page 42. In the JSP page for the custom type, add a tag for the custom
attribute list that you wish to display on import. Add a tag similar to the following:
<dmfx:docbaseattributelist
name="attrlist" object="obj" attrconfigid="import"/>

All custom attributes that are in a category appear unless they are listed in the <ignore_attributes>
element. Attributes are displayed in order of category. If the value of showpagesastabs is true, then
the categories are displayed as tabs. You can have different attribute lists for checkin, properties,
import, and other components.
You can add default attribute values on import. The following example from a custom import class
that extends Import adds the value in onInit. It adds a value for a custom date attribute named
doc_date to an ArgumentList instance.
DateTime dtDocDt = (DateTime)getControl("cust_doc_date", DateTime.class);
argumentlist1.add("doc_date", new Long(dtDocDt.toDate().getTime()).toString());
setDefaultAttributesValues(argumentlist1);

Elements
docbase­type­mappings
See docbase‑type‑mappings, page 817.

document_filter
See document_filter, page 817.

1160 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
importcontainer

document­docbase­base­type
See document‑docbase‑base‑type, page 817.

document­docbase­type
See document‑docbase‑type, page 817.
folder_filter
See folder_filter, page 820.
folder­docbase­type
See folder‑docbase‑type, page 820.

init­controls
See init‑controls, page 823.

preserve­file­extension
See preserve‑file‑extension, page 829.

preset_item
See preset_item, page 830.

service
See service, page 834.

ucfrequired
See ucfrequired, page 838.

importcontainer

Purpose
This is the WDK 5.3 importcontainer component. It is the container used to display components that
enable the import of local files into repositories.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1161
importcontainer

Parameters

component (Required) Supplied by the action execution


class). The name of the component to contain.
componentArgs (Required) Supplied by the LaunchComponent
action execution class.) List of arguments and
values to pass to each contained component.
filePath (Optional) Path to the file on the local machine.
isDirectory (Optional) Boolean that indicates whether the
object being imported is a directory.
parentPath (Optional) Repository path into which the file is
imported.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\importcontent\importcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.
max­import­files­and­folders
<max­import­files­and­folders>1000</max­import­files­and­folders>

Specifies the maximum number of files and folders that can be imported in a single operation.

1162 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
importrendition

propagatepreviouspagevalues
<propagatepreviouspagevalues>false</propagatepreviouspagevalues>
Whether the previous page values are propagated to the next page (true) or not (false).

service
See service, page 834.

ucfrequired
Whether to enable (true) or disable (false) UCF. To enable and disable UCF for specific events, specify
the events/event element structure, where the event element’s attributes are:
• name: name of event.
• enabled: true to enable or false to disable UCF.
Since 6.0 SP1.

importrendition

Purpose
This is the WDK 5.3 importrendition component. It extends the component import, page 1159 and
is used to import a rendition into the repository. The component must run within the 5.3 container
importrenditioncontainer.

Parameters

objectId (Required) ID of the target folder for import

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\importrendition\importrendition_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1163
importrenditioncontainer

Scope
All.

Elements
init­controls
See init‑controls, page 823.

preset_item
See preset_item, page 830.

service
See service, page 834.

ucfrequired
See ucfrequired, page 838.

updatereplicasource
See updatereplicasource, page 838.

importrenditioncontainer

Purpose
This is the WDK 5.3 importrenditioncontainer component. It is the container for components that
enable the import of renditions into repositories.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description

Since
5.x

1164 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
locateappviewer

Configuration File
webcomponent\config\library\contenttransfer\importrendition\importrenditioncontainer_
component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

ucfrequired
Whether to enable (true) or disable (false) UCF. To enable and disable UCF for specific events, specify
the events/event element structure, where the event element’s attributes are:
• name: name of event.
• enabled: true to enable or false to disable UCF.
Since 6.0 SP1.

locateappviewer

Purpose
Enables browsing the local filesystem to find the application with which to view the downloaded
object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1165
locateappviewercontainer

Since
6.5

locateappviewercontainer

Purpose
Container for the component.

Since
6.5

residentucfinvoker

Purpose
Enables invoking a component using the unified client facilities feature.

Since
6.5

1166 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
view (type dm_sysobject)

view (type dm_sysobject)

Purpose
This is a WDK 5.3 view component. It is used to download repository content to the browser local
file system and open a viewing application on the client. The view component must run in the
viewcontainer component. This component is defined for dm_sysobject and dmr_content scopes.
The component is undefined for dm_folder using the notdefined attribute, so that folders cannot be
viewed with a viewing application. The viewcontainer extends .

Parameters

contentType (Optional) Type of object to view


isIgnoreDescendents (Optional) Boolean value that indicates whether
or not to download descendants in a virtual
document.
isIgnorePrefRenditions (Optional) Boolean: Whether to ignore the user’s
preference for opening renditions (True) or not
(False). Default is false.Since 5.3 SP4.
objectId (Required) ID of the object to be viewed
pageModifier (Optional) A valid value for the page_modifier
attribute of the object. You should not pass in
your own value for PDF renditions.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\view\view_component.xml

Scope

type dm_sysobject

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1167
view (type dmr_content)

Elements
init­controls
See init‑controls, page 823.
isIgnorePrefRenditions
See isIgnorePrefRenditions, page 823.
service
See service, page 834.
ucfrequired
See ucfrequired, page 838.

view (type dmr_content)

Purpose
This is a WDK 5.3 view component. It is used to download repository content to the browser local
file system and open a viewing application on the client. The view component must run in the
viewcontainer component. This component is defined for dm_sysobject and dmr_content scopes.
The component is undefined for dm_folder using the notdefined attribute, so that folders cannot be
viewed with a viewing application. The viewcontainer extends .

Parameters

contentType (Optional) Type of object to view


isIgnorePrefRenditions (Optional) Boolean: Whether to ignore the user’s
preference for opening renditions (True) or not
(False). Default is true.Since 5.3 SP4.
objectId (Required) ID of the object to be viewed
pageModifier (Optional) A valid value for the page_modifier
attribute of the dmr_content object. You should
not pass in your own value for PDF renditions.

1168 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
viewcontainer (type dm_sysobject)

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\view\view_component.xml

Scope

type dmr_content

Elements
init­controls
See init‑controls, page 823.
isIgnorePrefRenditions
See isIgnorePrefRenditions, page 823.

service
See service, page 834.

ucfrequired
See ucfrequired, page 838.

viewcontainer (type dm_sysobject)

Purpose
This is the WDK 5.3 viewcontainer component. It is the container used to display components that
enable viewing objects in an associated application on a local machine.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1169
viewcontainer (type dmr_content)

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\view\viewcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope

type dm_sysobject

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

ucfrequired
See ucfrequired, page 838.

viewcontainer (type dmr_content)

Purpose
This is a WDK 5.3 viewcontainer component. It is a container used to display components that enable
viewing objects from repositories.

1170 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
viewcontainer (type dmr_content)

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description

Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\view\viewcontainer_component_dmr.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope

type dmr_content

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

service
See service, page 834.

ucfrequired
See ucfrequired, page 838.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1171
sendemailcontainer

Emailing object links

sendemailcontainer

Purpose
Invokes an email client.

Parameters

objectId (Required) ID of the dm_workflow object.


wfperformers (Optional) User names of the workflow
performers.
wfsupervisor (Optional) User name of the supervisor of the
dm_workflow object.

Description
Since
6.0

Configuration File
webcomponent\config\library\workflow\sendemail\sendemailcontainer_component.xml

Scope
All.

Elements
None.

1172 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
sendlocator

sendlocator

Purpose
Sends an email link (DRL, see drl, page 887) to one or more selected documents, folders, tasks,
notifications, or quickflow items using the HTML mailto command.

Parameters

objectId (Required) ID of the folder or object for which


to send a locator.

Description
Since
5.x

Configuration File
webcomponent\config\library\sendlocator\sendlocator_component.xml

Scope
All.

Elements
None.

sendlocator (type dm_notification)

Purpose
Sends an email link (DRL, see drl, page 887) to one or more selected documents, folders, tasks,
notifications, or quickflow items using the HTML mailto command.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1173
sendlocator (type dm_queued)

Parameters
The parameters are inherited from sendlocator:webcomponent/config/library/sendlocator/
sendlocator_component.xml. See sendlocator, page 1173.

Description

Since
5.x

Configuration File
webcomponent\config\library\sendlocator\sendlocator_workflow_items_component.xml

Parent Definition
sendlocator:webcomponent/config/library/sendlocator/sendlocator_component.xml

Scope

type dm_notification

Elements
None.

sendlocator (type dm_queued)

Purpose
Sends an email link (DRL, see drl, page 887) to one or more selected documents, folders, tasks,
notifications, or quickflow items using the HTML mailto command.

Parameters
The parameters are inherited from sendlocator:webcomponent/config/library/sendlocator/
sendlocator_component.xml. See sendlocator, page 1173.

1174 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
sendlocator (type dm_router_task)

Description
Since
5.x

Configuration File
webcomponent\config\library\sendlocator\sendlocator_workflow_items_component.xml

Parent Definition
sendlocator:webcomponent/config/library/sendlocator/sendlocator_component.xml

Scope

type dm_queued

Elements
None.

sendlocator (type dm_router_task)

Purpose
Sends an email link (DRL, see drl, page 887) to one or more selected documents, folders, tasks,
notifications, or quickflow items using the HTML mailto command.

Parameters
The parameters are inherited from sendlocator:webcomponent/config/library/sendlocator/
sendlocator_component.xml. See sendlocator, page 1173.

Description
Since
5.x

Configuration File
webcomponent\config\library\sendlocator\sendlocator_workflow_items_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1175
sendlocator (type dm_task)

Parent Definition
sendlocator:webcomponent/config/library/sendlocator/sendlocator_component.xml

Scope

type dm_router_task

Elements
None.

sendlocator (type dm_task)

Purpose
Sends an email link (DRL, see drl, page 887) to one or more selected documents, folders, tasks,
notifications, or quickflow items using the HTML mailto command.

Parameters
The parameters are inherited from sendlocator:webcomponent/config/library/sendlocator/
sendlocator_component.xml. See sendlocator, page 1173.

Description
Since
5.x

Configuration File
webcomponent\config\library\sendlocator\sendlocator_workflow_items_component.xml

Parent Definition
sendlocator:webcomponent/config/library/sendlocator/sendlocator_component.xml

Scope

type dm_task

1176 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
sendlocatorcontainer

Elements
None.

sendlocatorcontainer

Purpose
This component is used to display a sendlocator component, which is used to send an email link (DRL,
see drl, page 887) to one or more selected documents, folders, tasks, notifications, or quickflow items
using the HTML mailto command.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class.) The name of the
component to contain.
componentArgs (Required) Supplied by the LaunchComponent
action execution class.) List of arguments and
values to pass to each contained component.

Description
Since
5.x

Configuration File
webcomponent\config\library\sendlocator\sendlocatorcontainer_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1177
sendtodistributionlist

sendtodistributionlist

Purpose
Sends objects to users within an ad hoc workflow (also known as quickflow).

Parameters

objectId (Required) ID of the object to send

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\sendto\sendtodistributionlist_component.xml

Scope
All.

Elements
None.

Formats

format_preferences

Purpose
Enables the user to set format preferences for preferred renditions.

1178 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
formatattributes

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\environment\preferences\format\format_preferences_component.xml

Scope
All.

Elements
ucfrequired
See ucfrequired, page 838.

base_type
See base_type, page 810.

formatattributes

Purpose
Displays attributes of objects or creates new objects of type dm_format. This component is contained
within the container formatproperties, page 1181.

Parameters

objectId (Required) ID of the object for which properties


are displayed. Set to newobject to create a new
format.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1179
formatlist

Description
Since
5.x

Configuration File
webcomponent\config\admin\format\formatattributes_component.xml

Scope
All.

Elements
None.

formatlist

Purpose
Displays a list of formats in the repository (objects of type dm_format).

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\admin\format\formatlist_component.xml

Scope
All.

1180 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
formatproperties

Elements
None.

formatproperties

Purpose
Extends the container adminpropertycontainer, page 843 and the attributes of format objects or creates
a new format object. Contains the component formatattributes, page 1179.

Parameters

objectId (Required) ID of the object for which properties


are displayed. Set to newobject to create a new
format.

Description

Since
5.x

Configuration File
webcomponent\config\admin\format\formatproperties_component.xml

Parent Definition
adminpropertycontainer:webcomponent/config/admin/container/adminpropertycontainer_
component.xml

Scope
All.

Elements
objecttype

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1181
select_application

<objecttype>dm_format</objecttype>

Specifies the object type of the objects to display.

select_application

Purpose
Enables the user to select an application from the file system to use as the standard application for
a given rendition or format type. Clicking OK returns the full path of the application to the calling
component as a return parameter.

Parameters

path (Optional) File system path to the folder


displayed as the default starting location.

Description

Since
5.x

Configuration File
webcomponent\config\library\selectapplication\select_application_component.xml

Scope
All.

Elements
None.

1182 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
combocontainer

General user interface

combocontainer

Purpose
Extends the component wizardcontainer, page 1201 and adds support for multiple instances of the
same contained component. This allows the user to perform multi‑select operations for a component.
An Apply to all prompt is displayed when the user selects multiple operations.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class.) The name of the
component to contain.
componentArgs (Required) Supplied by the LaunchComponent
action execution class.) List of arguments and
values to pass to each contained component.

Description

Since
5.x

Configuration File
wdk\config\combocontainer_component.xml

Parent Definition
wizardcontainer:wdk/config/wizardcontainer_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1183
container

Usage
The combo container extends the wizard container and adds support for multiple instances of the
same contained component. This allows the user to perform multi‑select operations for a component.
An Apply to All prompt is displayed when the user selects multiple operations. Change notifications
and paging methods are called as appropriate for each button event.
Control values that are changed by the user are propagated to all instances of the control in other
embedded components. For example, a user selects two checked out documents and then selects
Checkin. When the user enters a description for the first file and selects Next, the description is
propagated to the description field of the next file.
Some examples of actions that use the combocontainer include delete, rename, sendto,
removeattachment, abort, halt, or resume workflow.
The parameters, component and componentArgs, are added by the LaunchComponent action
execution class in order to support actions on multiple objects. Do not call the container by URL.

Elements
failoverenabled
See failoverenabled, page 819.

propagatepreviouspagevalues
<propagatepreviouspagevalues>false</propagatepreviouspagevalues>
Whether the previous page values are propagated to the next page (true) or not (false).

container

Purpose
The container component is a generic container component definition. It is the base component
for all containers.

Parameters

component (Required) The contained component. Set the


requiresVisit attribute to true to require the
component to be visited before an OK button is
displayed.

1184 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
dialogcontainer

Description
Since
5.x

Configuration File
wdk\config\container_component.xml

Scope
All.

Usage
Set requiresVisit attribute to true to declare that a particular component must be visited before the
container can commit changes. In the following example, the attributes component must be viewed
before the user can commit changes:
<contains>
<component>newFolder</component>
<component requiresVisit='true'>attributes</component>
<component>permissions</component>
</contains>

You can also declare the visit requirement in the individual component definition. Add the following
tag to a component definition:
<requiresVisitBeforeCommit>true</requiresVisitBeforeCommit>

Elements
failoverenabled
See failoverenabled, page 819.

dialogcontainer

Purpose
Extends the container container, page 1184, making a single set of arguments available to a single
contained component and providing a set of dialog buttons.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1185
dialogcontainer

Parameters

component (Required) The contained component. Set the


requiresVisit attribute to true to require the
component to be visited before an OK button is
displayed.
subTitle (Optional) Text for the subtitle of the dialog
box.Since 6.0.
title (Optional) Text for the title of the dialog
box.Since 6.0.

Description
Since
5.x

Configuration File
wdk\config\dialogcontainer_component.xml

Parent Definition
container:wdk/config/container_component.xml

Scope
All.

Usage
The dialog container extends the abstract container and adds dialog support for a single contained
component. The dialog layout contains a header and footer. The header includes a title (MSG_TITLE)
and object label (MSG_OBJECT). The footer contains OK (MSG_OK), Cancel (MSG_CANCEL) or
Close (MSG_CLOSE), and Help buttons. Change notifications are called as appropriate for each
button event.
The OK and Cancel buttons are disabled if canCommitChanges() or canCancelChanges() return false,
respectively. If both methods return false, the Close button is displayed.
Some examples of actions that use the dialogcontainer include removeuserorgroup, add_translation
(Web Publisher), newchangeset (Web Publisher). If an action launches a component within
dialogcontainer, the component fills up the entire browser frame. To display the component within
the content frame only, add the <navigation>jump</navigation> element to any location within the
<execution> element.

1186 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
doclist

Elements
failoverenabled
See failoverenabled, page 819.

doclist

Purpose
Displays the contents of a folder as a list of objects and folders. The user can filter the list to see
folders only, documents only, folders and documents, or all objects. The user navigates through a
separate tree frame or by clicking on a folder in the doc list. This component is extended in Webtop
as the objectlist component.

Parameters

folderId (Optional) Specifies the ID of the folder in which


to start browsing
folderPath (Optional) Specifies the path to the folder in
which to start browsing. This path must be
a complete path from the repository root, for
example, /Documentation/Library/subfolder
showAllVersions (Optional) Set to true to show all versions of the
object

Description

Since
5.x

Configuration File
webcomponent\config\navigation\doclist\doclist_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1187
doclist (type dm_message_archive)

Usage
The doclist and drilldown components have a default set of standard sysobject attributes that are
displayed and formatted in columns. You can also configure columns to be displayed dynamically
based on other attributes. SeeWeb Development Kit Development Guide for more information.

Elements
columns
See columns (for streamline view), page 811.
dragdrop
See dragdrop, page 818.

failoverenabled
See failoverenabled, page 819.

objectfilters
See objectfilters, page 827.

preset_item
See preset_item, page 830.

showfilters
See showfilters, page 835.

doclist (type dm_message_archive)

Purpose
Displays a dm_message_archive object and its dm_message_attachment objects as a list of objects
and folders.

Parameters

folderId (Optional) ID of the folder in which to initially


display.
folderPath (Optional) Path to the folder in which to initially
display.

1188 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
doclist (type dm_message_archive)

objectId (Optional) ID of the dm_message_archive object


to display.
showAllVersions (Optional) Boolean: Whether to show all versions
of objects (True) or not (False).

Description

Since
6.0

Configuration File
webcomponent\config\library\messagearchive\messagearchive_component.xml

Parent Definition
doclist:webcomponent/config/navigation/doclist/doclist_component.xml

Scope

type dm_message_archive

Elements
columns
See columns (for streamline view), page 811.

dragdrop
See dragdrop, page 818.

failoverenabled
This element structure is inherited from doclist:webcomponent/config/navigation/doclist/doclist_
component.xml. See doclist, page 1187.
objectfilters
See objectfilters, page 827.

preset_item
See preset_item, page 830.

showfilters
See showfilters, page 835.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1189
multiargdialogcontainer

multiargdialogcontainer

Purpose
Extends the container dialogcontainer, page 1185 and allows multiple sets of arguments (following a
multi‑select in classic view, for example) to be used by a single component contained in this container.
Contains sendtodistributionlist, page 1178.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class.) The name of the
component to contain.
componentArgs (Required) Supplied by the LaunchComponent
action execution class.) List of arguments and
values to pass to each contained component.

Description

Since
5.x

Configuration File
webcomponent\config\library\multiargdialogcontainer\multiargdialogcontainer_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

1190 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
navigation (type dm_message_archive) (Webtop)

navigation (type dm_message_archive) (Webtop)

Purpose
Launches the homecabinet_classic (type dm_message_archive) (Webtop), page 1205 component to
browse a dm_message_archive object and its dm_message_attachment objects in a user’s home cabinet
in classic view.

Parameters

folderPath (Optional) Path to the folder in which to initially


display.
objectId (Required) ID of the dm_message_archive object.

Description
Since
6.0

Configuration File
webtop\config\dm_message_archive_action.xml

Scope

type dm_message_archive

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1191
navigationcontainer

navigationcontainer

Purpose
Displays a breadcrumb, title, and drop‑down list above an included component to support navigation
to an object from the included component. This container component is a base component and must
be extended in order to add components.

Parameters

component (Required) Contained component.


folderId (Optional) Specifies the primary location of the
specified folder Id
folderPath (Optional) Specifies the path to the folder in
which to start browsing. This path must be
a complete path from the repository root, for
example, /Documentation/Library/subfolder
objectId (Required) Selected object.
objectNamePrefix (Optional)

Description

Since
5.x

Configuration File
webcomponent\config\navigation\navigationcontainer\navigationcontainer_component.xml

Scope
All.

Usage
The navigation container wraps navigation components and provides a header with active breadcrumb
and title controls. The breadcrumb allows the user to navigate to an object that is displayed, and the
drilldown component is updated by the breadcrumb selection. Override this component definition
to jump to another navigation component using a breadcrumb.

1192 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
navigationcontainer (Webtop)

The navigationcontainer definition includes a <navigation> element that specifies the type of
navigation.
Some examples of actions that use the navigationcontainer include versions, locations, relationships,
renditions.

Elements
None.

navigationcontainer (Webtop)

Purpose
Extends the WDK navigationcontainer component and displays a breadcrumb, title, and drop‑down
list above an included component to support navigation to an object from the included component.
This container component is a base component and must be extended in order to add components.

Parameters
None.

Description
Since
5.x

Configuration File
webtop\config\navigationcontainer_component.xml

Parent Definition
/webcomponent/config/navigation/navigationcontainer/navigationcontainer_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1193
nestedcomponentcontainer

nestedcomponentcontainer

Purpose
Extends the container dialogcontainer, page 1185 and displays Close and Help buttons for the
component that is nested within this container.

Parameters
The parameters are inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml. See
dialogcontainer, page 1185.

Description
Since
5.x

Configuration File
wdk\config\nestedcomponentcontainer_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

objectgrid

Purpose
Renders the result of a query attached to a data grid.

1194 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
objectgrid

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\navigation\objectgrid\objectgrid_component.xml

Scope
All.

Usage
The objectgrid component and the datagrid control can both display objects. The objectgrid component
renders attributes for a single object type. Some examples of components that extend objectgrid to
display objects are locations, relationships, renditions, versions, and history.
In Webtop, components that extend object grid component display a subset of the dm_sysobject
attributes and the folder path for the objects in the result set. If your component doesn’t need to
display attributes other than those of dm_sysobject, you can use the default object grid JSP pages.
To display other dm_sysobject attributes, you must extend this component and modify the JSP page
data fields to display the attributes you wish.
Components that extend ObjectGrid provide the query string by implementing getQuery(String
strVisibleAttrs, ArgumentList args). You must also provide custom JSP pages that display the custom
attributes from your query. For an example of a customized attribute display of the query resultset,
see /webcomponent/library/relationships/relationships.jsp.
Sample override of getQuery (error handling removed):
protected String geQuery(String strVisibleAttrs, ArgumentList args)
{
String strQuery = null;
String strCustomAttr = args.get("customAttr");
strQuery = new StringBuffer(512)
.append("SELECT" ")
.append(strVisibleAttrs)
.append(INTERNAL_attrs)
.append(" from mycustomobject(all) ")
.append("WHERE mycustomattr = '")
.append(strCustomAttr)
.append("')"
.toString();
return strQuery;
}

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1195
streamlineview (type dm_message_archive) (Webtop)

Elements
columns
See columns (for streamline view), page 811.
header
See header, page 821.
nondocbasecolumns
See nondocbasecolumns, page 826.

streamlineview (type dm_message_archive)


(Webtop)

Purpose
Displays dm_message objects and their dm_message_attachment objects in the Webtop streamline
view.

Parameters
The parameters are inherited from drilldown:webcomponent/config/library/messagearchive/
messagearchive_component.xml. See drilldown (type dm_message_archive), page 1073.

Description
Since
6.0

Configuration File
webtop\config\messagearchive_component.xml

Parent Definition
drilldown:webcomponent/config/library/messagearchive/messagearchive_component.xml

1196 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
streamlineview (Webtop)

Scope

type dm_message_archive

Elements
None.

streamlineview (Webtop)

Purpose
Extends the WDK drilldown component and displays the Webtop streamline view of folders and
content, adding a title frame at top and status bar frame at bottom. This component is called from a tab
in the tabbar component. This component is the default folder viewing component as defined in the
Webtop component main (Webtop), page 900.

Parameters
The parameters are inherited from drilldown:webcomponent/config/navigation/drilldown/drilldown_
component.xml. See drilldown, page 1071.

Description
Since
5.x

Configuration File
webtop\config\streamlineview_component.xml

Parent Definition
drilldown:webcomponent/config/navigation/drilldown/drilldown_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1197
tabbar (Webtop)

Elements
columns
See columns (for streamline view), page 811.
dragdrop
See dragdrop, page 818.
failoverenabled
This element structure is inherited from drilldown:webcomponent/config/navigation/drilldown/
drilldown_component.xml. See drilldown, page 1071.

objectfilters
See objectfilters, page 827.

preferences
See preferences, page 828.

showfilters
See showfilters, page 835.

tabbar (Webtop)

Purpose
The tabbar component is loaded into a frame iin the Webtop streamlineview component. The UI
contains a tab bar control, tab selection event handlers, and a Docbase selector control.

Parameters

entryTab (Optional) Name of the tab (component ID) to be


displayed on the first tab.
refreshOnInit (Optional) Boolean: Whether the content
component is to be initialized during tab bar
initialization (True) or not (False). Defaultis true.
Since 5.3 SP5.

1198 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
tabbar (Webtop)

Description
Since
5.x

Configuration File
webtop\config\tabbar_component.xml

Scope
All.

Elements
entrytab
<entrytab>homecabinet_streamline</entrytab>

Specifies the default tab to be selected on entry to the streamline component. Can be overridden by
user preference.

failoverenabled
See failoverenabled, page 819.

tabs
1 <tabs>
2<tab componentid="homecabinet_streamline">
3<label>
4<nlsid>MSG_HOME_CABINET</nlsid>
</label>
5<tooltip>
6<nlsid>MSG_HOME_CABINET_TIP</nlsid>
</tooltip>
7<classiccomponent>homecabinet_classic</classiccomponent>
</tab>
...
</tabs>

1 Root element for a structure that specifies tabs that are links to components.
2 The componentid attribute corresponds to a component defined in the application. The component
is displayed when the user clicks a tab.
3 Contains a string or <nlsid> that is displayed on the tab UI.
4 NLS lookup key. The string corresponding to the NLS ID is displayed.
5 Tip that is displayed on mouseover. Can be string or <nlsid>.
6 NLS lookup key. The string corresponding to the NLS ID is displayed.
7 Specifies the component to be displayed if the user switches to classic view.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1199
titlebar (Webtop)

titlebar (Webtop)

Purpose
Displays buttons and provides client‑side event handlers for advanced search, clipboard, preferences,
logout, and help, and a text field and button for simple search. The titlebar component is included
in the top frame of both the classic and streamline views. There is no dynamic behavior in the title
bar, so no special component class is provided.

Parameters
None.

Description
Since
5.x

Configuration File
webtop\config\titlebar_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

toolbar (Webtop)

Purpose
Displays action buttons for checkin, checkout, and properties. The tool bar component is included in
the top frame of the classic view UI of the main component.

1200 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
wizardcontainer

Parameters
None.

Description
Since
5.x

Configuration File
webtop\config\toolbar_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

wizardcontainer

Purpose
Displays a component within a wizard framework, where each layout page (JSP) is presented as a
different page in the wizard. Provides navigation buttons.

Parameters
The parameters are inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml. See
dialogcontainer, page 1185.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1201
wizardcontainer

Configuration File
wdk\config\wizardcontainer_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Usage
The wizard container extends the dialog container and adds wizard navigation support for a single
contained component that has multiple pages. The wizard layout adds Next (MSG_NEXT) and
Previous (MSG_PREVIOUS) buttons.
Component.hasNextPage() and hasPrevPage() are called on the contained component to determine
when to enable and display the next and previous page navigation buttons. The methods
onNextPage() and onPrevPage() are called to switch the contained component page when the user
clicks the Next or Previous button. The component within the container must support onNextPage()
and onPrevPage(), which returns false in the base Component class.
The taskcomponentcontainer in /webcomponent/config/library/workflow/taskmanager extends the
wizardcontainer. Use this component as an example of how to extend the wizardcontainer. For
information on programmatically navigating between next or previous components, refer to .

Elements
failoverenabled
See failoverenabled, page 819.

1202 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
componentlist

Helpers

componentlist

Purpose
Generates a list of components with their scopes and other information. This list can be generated
(after login to the application) through a URL such as the following: http:// host_name:8080/
webtop/component/componentlist/. Displays all components in the application, with links. Each link
displays the name of the config file, NLS bundle, parameters, whether it is a container, whether it is
configurable, the fully qualified class name, and the component description from the component
definition file.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\componentList\component_list.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1203
help­index

help­index

Purpose
Help files are mapped in the help‑index component definition. The help_component.xml configuration
file stores a list of reference entries for HTML help pages. This definition is overridden by the Webtop
help component, which has entries for help topics.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\help\help_component.xml

Scope
All.

Elements
help­entries
See help‑entries, page 821.

help­index (Webtop)

Purpose
Specifies context‑sensitive map entries for help topics. For information about adding custom or
localized help files to the application, see Web Development Kit Development Guide.

1204 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
homecabinet_classic (type dm_message_archive) (Webtop)

Parameters
None.

Description
Since
5.x

Configuration File
webtop\config\help_component.xml

Parent Definition
help‑index:/webcomponent/config/help/help_component.xml

Scope
All.

Elements
help­entries
See help‑entries, page 821.

Home Cabinet

homecabinet_classic (type dm_message_archive)


(Webtop)

Purpose
Supports browsing of a dm_message_archive object and its dm_message_attachment objects in a
user’s home cabinet in classic view.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1205
homecabinet_classic (Webtop)

Parameters
The parameters are inherited from homecabinet_list:webcomponent/config/library/messagearchive/
messagearchive_component.xml. See homecabinet_list (type dm_message_archive), page 1211.

Description

Since
6.0

Configuration File
webtop\config\messagearchive_component.xml

Parent Definition
homecabinet_list:webcomponent/config/library/messagearchive/messagearchive_component.xml

Scope

type dm_message_archive

Elements
columns
See columns (for streamline view), page 811.

homecabinet_classic (Webtop)

Purpose
Supports browsing of the user home cabinet. Users can select cabinets and folders and view their
contents. The visibility of object types is configurable. The component is identical to the doclist
component with the exception that the top‑level navigation location is the user’s home cabinet path
instead of the repository root cabinet list.

1206 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
homecabinet_classic (Webtop)

Parameters

folderPath (Optional) Path to the folder in which to initially


display.
nodeIds (Optional) Nodes to be displayed as the
breadcrumb path.

Description
Since
5.x

Configuration File
webtop\config\homecabinet_classic_component.xml

Parent Definition
homecabinet_list:webcomponent/config/navigation/homecabinet/homecabinet_list_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

dragdrop
See dragdrop, page 818.

failoverenabled
See failoverenabled, page 819.

objectfilters
See objectfilters, page 827.
preset_item
See preset_item, page 830.

showfilters
See showfilters, page 835.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1207
homecabinet_drilldown

homecabinet_drilldown

Purpose
Supports browsing of the user home cabinet contents. The user can select cabinets or folders and drill
down into them to see their contents. The visibility of object types is configurable. The component is
identical to the drilldown component except that the top‑level navigation location is the user’s home
cabinet path instead of the repository root cabinet list. Deprecated as of version 6.

Parameters

folderPath (Optional) Specifies the ID of the folder in which


to start browsing.

Description
Since
5.x

Configuration File
webcomponent\config\navigation\homecabinet\homecabinet_drilldown_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.
dragdrop
See dragdrop, page 818.

failoverenabled
See failoverenabled, page 819.

objectfilters
See objectfilters, page 827.

1208 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
homecabinet_drilldown (type dm_message_archive)

showfilters
See showfilters, page 835.

homecabinet_drilldown (type dm_message_archive)

Purpose
Supports browsing of a dm_message_archive object and its dm_message_attachment objects in a
user’s home cabinet.

Parameters

folderPath (Optional) Specifies the ID of the folder in which


to start browsing.
objectId (Optional) ID of the dm_message_archive object
to browse.

Description
Since
6.0

Configuration File
webcomponent\config\library\messagearchive\messagearchive_component.xml

Parent Definition
homecabinet_drilldown:webcomponent/config/navigation/homecabinet/homecabinet_drilldown_
component.xml

Scope

type dm_message_archive

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1209
homecabinet_list

Elements
columns
See columns (for streamline view), page 811.
dragdrop
See dragdrop, page 818.
failoverenabled
This element structure is inherited from homecabinet_drilldown:webcomponent/config/navigation/
homecabinet/homecabinet_drilldown_component.xml. See homecabinet_drilldown, page 1208.

objectfilters
See objectfilters, page 827.

showfilters
See showfilters, page 835.

homecabinet_list

Purpose
Supports browsing of the user home cabinet. Users can select cabinets and folders and view their
contents. The visibility of object types is configurable. The component is identical to the doclist
component with the exception that the top‑level navigation location is the user’s home cabinet path
instead of the repository root cabinet list.

Parameters

folderPath (Optional) Specifies the ID of the folder in which


to start browsing.

Description
Since
5.x

1210 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
homecabinet_list (type dm_message_archive)

Configuration File
webcomponent\config\navigation\homecabinet\homecabinet_list_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

dragdrop
See dragdrop, page 818.

objectfilters
See objectfilters, page 827.
preset_item
See preset_item, page 830.

showfilters
See showfilters, page 835.

homecabinet_list (type dm_message_archive)

Purpose
Supports browsing of a dm_message_archive object and its dm_message_attachment objects in a
user’s home cabinet.

Parameters

folderId (Optional) ID of the folder in which to initially


display.
folderPath (Optional) Path to the folder in which to initially
display.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1211
homecabinet_list (type dm_message_archive)

objectId (Optional) ID of the dm_message_archive object.


showAllVersions (Optional) Boolean: Whether to show all versions
of objects (True) or not (False).

Description
Since
6.0

Configuration File
webcomponent\config\library\messagearchive\messagearchive_component.xml

Parent Definition
homecabinet_list:webcomponent/config/navigation/homecabinet/homecabinet_list_component.xml

Scope

type dm_message_archive

Elements
columns
See columns (for streamline view), page 811.
dragdrop
See dragdrop, page 818.

objectfilters
See objectfilters, page 827.

preset_item
See preset_item, page 830.

showfilters
See showfilters, page 835.

1212 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
homecabinet_streamline (type dm_message_archive) (Webtop)

homecabinet_streamline (type dm_message_


archive) (Webtop)

Purpose
Supports browsing of a dm_message_archive object and its dm_message_attachment objects in a
user’s home cabinet in streamline view.

Parameters
The parameters are inherited from homecabinet_drilldown:webcomponent/config/library/
messagearchive/messagearchive_component.xml. See homecabinet_drilldown (type
dm_message_archive), page 1209.

Description
Since
6.0

Configuration File
webtop\config\messagearchive_component.xml

Parent Definition
homecabinet_drilldown:webcomponent/config/library/messagearchive/messagearchive_component.
xml

Scope

type dm_message_archive

Elements
columns
See columns (for streamline view), page 811.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1213
homecabinet_streamline (Webtop)

homecabinet_streamline (Webtop)

Purpose
Supports browsing of a dm_message_archive object and its dm_message_attachment objects in a
user’s home cabinet in streamline view.

Parameters
The parameters are inherited from homecabinet_drilldown:webcomponent/config/navigation/
homecabinet/homecabinet_drilldown_component.xml. See homecabinet_drilldown, page 1208.

Description
Since
6.0

Configuration File
webtop\config\homecabinet_streamline_component.xml

Parent Definition
homecabinet_drilldown:webcomponent/config/navigation/homecabinet/homecabinet_drilldown_
component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

dragdrop
See dragdrop, page 818.
failoverenabled
This element structure is inherited from homecabinet_drilldown:webcomponent/config/navigation/
homecabinet/homecabinet_drilldown_component.xml. See homecabinet_drilldown, page 1208.

1214 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
objectlist (type dm_message_archive) (Webtop)

objectfilters
See objectfilters, page 827.

showfilters
See showfilters, page 835.

objectlist (type dm_message_archive) (Webtop)

Purpose
Displays a list of dm_message_archive objects.

Parameters
The parameters are inherited from doclist:webcomponent/config/library/messagearchive/
messagearchive_component.xml. See doclist (type dm_message_archive), page 1188.

Description
Since
6.0

Configuration File
webtop\config\messagearchive_component.xml

Parent Definition
doclist:webcomponent/config/library/messagearchive/messagearchive_component.xml

Scope

type dm_message_archive

Elements
columns
See columns (for streamline view), page 811.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1215
inboxclassic (Webtop)

Inbox

inboxclassic (Webtop)

Purpose
Extends the WDK inboxlist component and displays the inbox in a single‑selection list format. This
component is a node in the component.

Parameters
None.

Description
Since
5.x

Configuration File
webtop\config\inboxclassic_component.xml

Parent Definition
inboxlist:webcomponent/config/navigation/inbox/inboxlist_component.xml

Scope
All.

Elements
autogettaskdefault
See autogettaskdefault, page 810.

columns
See columns (for streamline view), page 811.

1216 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
inboxdrilldown

failoverenabled
This element structure is inherited from inboxlist:webcomponent/config/navigation/inbox/inboxlist_
component.xml. See inboxlist, page 1622.

preset_item
See preset_item, page 830.

showattachmentinfo
See showattachmentinfo, page 834.

showautogettask
See showautogettask, page 834.
showfilters
See showfilters, page 835.
taskmanagerid
See taskmanagerid, page 837.

inboxdrilldown

Purpose
Lists the user’s inbox tasks, using a streamline‑style layout. Deprecated as of version 6.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\navigation\inbox\inboxdrilldown_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1217
inboxstreamline (Webtop)

Scope
All.

Elements
autogettaskdefault
See autogettaskdefault, page 810.

columns
See columns (for streamline view), page 811.

failoverenabled
See failoverenabled, page 819.

showattachmentinfo
See showattachmentinfo, page 834.

showautogettask
See showautogettask, page 834.

showfilters
See showfilters, page 835.
taskmanagerid
See taskmanagerid, page 837.

workflowreportactionname
<workflowreportactionname>reportmaindrilldown</workflowreportactionname>

Specifies the action that calls the workflow report page.

workflowstatusactionname
See workflowstatusactionname, page 841.

inboxstreamline (Webtop)

Purpose
Extends the WDK inboxdrilldown component and displays the inbox in a drilldown view. This
component is a node in the tabbar (Webtop), page 1198 component.

1218 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
inboxstreamline (Webtop)

Parameters
None.

Description
Since
5.x

Configuration File
webtop\config\inboxstreamline_component.xml

Parent Definition
inboxdrilldown:webcomponent/config/navigation/inbox/inboxdrilldown_component.xml

Scope
All.

Elements
autogettaskdefault
See autogettaskdefault, page 810.

columns
See columns (for streamline view), page 811.
failoverenabled
This element structure is inherited from inboxdrilldown:webcomponent/config/navigation/inbox/
inboxdrilldown_component.xml. See inboxdrilldown, page 1217.

showattachmentinfo
See showattachmentinfo, page 834.

showautogettask
See showautogettask, page 834.

showfilters
See showfilters, page 835.
taskmanagerid
See taskmanagerid, page 837.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1219
jobabort

workflowreportactionname
<workflowreportactionname>reportmainstreamline</workflowreportactionname>

Specifies the action that calls the workflow report page.

workflowstatusactionname
See workflowstatusactionname, page 841.

Jobs

jobabort

Purpose
Called by the action abortjob, page 512 to abort a running asynchronous action or component job.

Parameters

jobId (Required) ID of the job to abort.

Description
Since
5.x

Configuration File
webcomponent\config\library\async\jobabort_component.xml

Scope
All.

Elements
None.

1220 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
jobprogressmonitor

jobprogressmonitor

Purpose
Displays the progress of an asynchronous job

Parameters

jobId (Optional) ID of the asynchronous job


pending (Optional) Boolean flag that signals to the
JobProgressMonitor class that the job is already
pending. This flag is set by the content
transfer container class when nesting to the
jobprogressmonitor component.

Description

Since
5.x

Configuration File
webcomponent\config\library\progress\progress_component.xml

Scope
All.

Elements
None.

jobstatus

Purpose
This component displays status and details about every running asynchronous action or component
job.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1221
jobstatushistory

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\async\jobstatus_component.xml

Scope
All.

Elements
None.

jobstatushistory

Purpose
This component displays job history and messages for a selected job.

Parameters

jobId (Required) ID of the selected job.


jobName (Required) Name of the selected job.

Description

Since
5.x

1222 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
renamejobrequestlist

Configuration File
webcomponent\config\library\async\jobstatushistory_component.xml

Scope
All.

Elements
None.

renamejobrequestlist

Purpose
Displays jobs that rename users or groups

Parameters

renametarget (Optional) Type of objects to be renamed. Valid


values: user | group. Default = user

Description
Since
5.x

Configuration File
webcomponent\config\admin\renamelog\renamejobrequestlist_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1223
alllifecyclelocator

Lifecycles

alllifecyclelocator

Purpose
Locates dm_policy objects in a repository.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\lifecyclelocators_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
breadcrumbiconwellmode
See breadcrumbiconwellmode, page 810.

iconwell_icon
See iconwell_icon, page 822.
columns
See columns (for data columns), page 811.

1224 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
alllifecyclelocator

objecttype

<objecttype>dm_policy</objecttype>

Specifies the object type of the objects to locate.


flatlist

1 <flatlist>true</flatlist>

1 See flatlist, page 820.

allversionsvisible

1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

preset_item
See preset_item, page 830.
containerselectable

1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

contenttypepanelvisible

1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1225
applylifecycle (type dm_sysobject)

filenamefiltervisible
See filenamefiltervisible, page 819.

views
See views, page 839.

applylifecycle (type dm_sysobject)

Purpose
Applies a lifecycle to the selected object. It displays the available lifecycles in the system. Contains
applylifecycleall (type dm_sysobject), page 1227.

Parameters

component (Required) Name of the component within the


container
componentArgs (Optional) List of arguments and values to pass
to each contained component. Supplied by the
LaunchComponent action execution class.
objectId (Required) ID of the object to which a lifecycle
shall be applied

Description

Since
5.x

Configuration File
webcomponent\config\library\applylifecycle\applylifecyclecontainer_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

1226 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
applylifecycleall (type dm_sysobject)

Scope

type dm_sysobject

Elements
breadcrumbiconwellmode
See breadcrumbiconwellmode, page 810.

multidocbasesupport
See multidocbasesupport, page 825.

applylifecycleall (type dm_sysobject)

Purpose
Applies a lifecycle to all selected objects.

Parameters

objectId (Required) ID of the object to which the lifecycle


shall be applied

Description
Since
5.x

Configuration File
webcomponent\config\library\applylifecycle\applylifecycle_all_component.xml

Scope

type dm_sysobject

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1227
lifecyclefolderlocator

Elements
None.

lifecyclefolderlocator

Purpose
Extends the component sysobjectlocator, page 1091 and displays in a folder view all objects with
attached lifecycles.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\lifecyclelocators_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
iconwell_icon
See iconwell_icon, page 822.

columns
See columns (for data columns), page 811.

1228 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
lifecyclefolderlocator

objecttype

<objecttype>dm_policy</objecttype>

Specifies the object type of the objects to locate.


flatlist

1 <flatlist>false</flatlist>

1 See flatlist, page 820.

allversionsvisible

1 <allversionsvisible>true</allversionsvisible>

1 See allversionsvisible, page 809.

containerselectable

1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

contenttypepanelvisible

1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.

filenamefiltervisible
See filenamefiltervisible, page 819.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1229
lifecyclelocatorcontainer

views
See views, page 839.

lifecyclelocatorcontainer

Purpose
Extends the container locatorcontainer, page 1081 and contains lifecyclelocator components:
alllifecyclelocator, page 1224, lifecyclesubscriptionlocator, page 1231, lifecyclefolderlocator, page 1228,
and recentlifecyclelocator, page 1232.

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\lifecyclelocators_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

1230 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
lifecyclesubscriptionlocator

lifecyclesubscriptionlocator

Purpose
Extends subscriptionlocator, page 1423 and displays subscribed lifecycle objects.

Parameters
The parameters are inherited from subscriptionlocator:webcomponent/config/library/locator/
subscriptionlocator_component.xml. See subscriptionlocator, page 1423.

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\lifecyclelocators_component.xml

Parent Definition
subscriptionlocator:webcomponent/config/library/locator/subscriptionlocator_component.xml

Scope
All.

Elements
iconwell_icon
See iconwell_icon, page 822.

columns
See columns (for data columns), page 811.
objecttype

<objecttype>dm_policy</objecttype>

Specifies the object type of the objects to locate.

flatlist

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1231
recentlifecyclelocator

1 <flatlist>false</flatlist>

1 See flatlist, page 820.

allversionsvisible

1 <allversionsvisible>true</allversionsvisible>

1 See allversionsvisible, page 809.

containerselectable

1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

privatecabinet_visible
See privatecabinet_visible, page 831.

views
See views, page 839.

recentlifecyclelocator

Purpose
Locates lifecycles that were recently selected or used. This component has no scope, but the
<objecttype> element restricts the search to objects of type dm_policy.

Parameters
The parameters are inherited from recentsysobjectlocator:webcomponent/config/library/locator/
recentsysobjectlocator_component.xml. See recentsysobjectlocator, page 1090.

1232 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
recentlifecyclelocator

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\lifecyclelocators_component.xml

Parent Definition
recentsysobjectlocator:webcomponent/config/library/locator/recentsysobjectlocator_component.xml

Scope
All.

Elements
iconwell_icon
See iconwell_icon, page 822.

columns
See columns (for data columns), page 811.

objecttype

<objecttype>dm_policy</objecttype>

Specifies the object type of the objects to locate.

containerselectable

1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

views
See views, page 839.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1233
selectlifecycle (type dm_sysobject)

selectlifecycle (type dm_sysobject)

Purpose
Selects a lifecycle.

Parameters

type (Required) Object type of the lifecycle.

Description
Since
6.0

Configuration File
webcomponent\config\library\applylifecycle\selectlifecyclecontainer_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope

type dm_sysobject

Elements
breadcrumbiconwellmode
See breadcrumbiconwellmode, page 810.
multidocbasesupport
See multidocbasesupport, page 825.

1234 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
findtarget (Webtop)

Locating objects

findtarget (Webtop)

Purpose
Allows the user to click on a reference object and navigate to the object or folder in the remote
repository.

Parameters

objectId (Required) ID of the reference object.


openFolder (Optional) Set to true if the reference object is a
folder.

Description
Since
5.x

Configuration File
webtop\config\findtarget_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1235
choosetransformationtype

Media and transformation

choosetransformationtype

Purpose
A transformation selection component. Requires Media Transformation Services. Enables the user
to select the available media profiles.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\transformation\choosetransformationtype_component.xml

Scope
All.

Elements
None.

transformationapplylifecycle (type dm_sysobject)

Purpose
Applies a lifecycle (business policy) to the selected transformed dm_sysobject object. Requires Media
Transformation Services.

1236 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
transformationapplylifecycle (type dmr_content)

Parameters

component (Required) Name of the component to contain.


objectId (Optional) ID of the transformed object to which
a lifecycle will be applied.
objectType (Required) Content type of the object.

Description
Since
5.x

Configuration File
webcomponent\config\library\transformation\transformationapplylifecycle_component.xml

Parent Definition
transformationapplylifecyclecontainer:webcomponent/config/library/transformation/
transformationapplylifecyclecontainer_component.xml

Scope

type dm_sysobject

Elements
None.

transformationapplylifecycle (type dmr_content)

Purpose
Applies a lifecycle (business policy) to the selected transformed dmr_content object. Requires Media
Transformation Services.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1237
transformationapplylifecycleall (type dm_sysobject)

Parameters

component (Required) Name of the component to contain.


objectId (Optional) ID of the transformed object to which
a lifecycle will be applied.
objectType (Required) Content type of the object.

Description
Since
5.x

Configuration File
webcomponent\config\library\transformation\transformationapplylifecycle_component.xml

Parent Definition
transformationapplylifecyclecontainer:webcomponent/config/library/transformation/
transformationapplylifecyclecontainer_component.xml

Scope

type dmr_content

Elements
None.

transformationapplylifecycleall (type dm_sysobject)

Purpose
Applies a lifecycle (business policy) to all the selected transformed dm_sysobject objects. Requires
Media Transformation Services.

1238 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
transformationapplylifecycleall (type dmr_content)

Parameters

objectId (Optional) ID of the transformed object to which


a lifecycle will be applied.
objectType (Required) Content type of the object.

Description
Since
5.x

Configuration File
webcomponent\config\library\transformation\transformationapplylifecycle_component.xml

Parent Definition
applylifecycleall:webcomponent/config/library/applylifecycle/applylifecycle_all_component.xml

Scope

type dm_sysobject

Elements
None.

transformationapplylifecycleall (type dmr_content)

Purpose
Applies a lifecycle (business policy) to all the selected transformed dmr_content objects. Requires
Media Transformation Services.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1239
transformationapplylifecyclecontainer

Parameters

objectId (Optional) ID of the transformed object to which


a lifecycle will be applied.
objectType (Required) Content type of the object.

Description
Since
5.x

Configuration File
webcomponent\config\library\transformation\transformationapplylifecycle_component.xml

Parent Definition
applylifecycleall:webcomponent/config/library/applylifecycle/applylifecycle_all_component.xml

Scope

type dmr_content

Elements
None.

transformationapplylifecyclecontainer

Purpose
Base container for the transformationapplylifecycle component. Requires Media Transformation
Services.

Parameters
The parameters are inherited from applylifecycle:webcomponent/config/library/applylifecycle/
applylifecyclecontainer_component.xml. See applylifecycle (type dm_sysobject), page 1226.

1240 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
transformationcontainer

Description
Since
5.x

Configuration File
webcomponent\config\library\transformation\transformationapplylifecyclecontainer_component.
xml

Parent Definition
applylifecycle:webcomponent/config/library/applylifecycle/applylifecyclecontainer_component.xml

Scope
All.

Elements
breadcrumbiconwellmode
See breadcrumbiconwellmode, page 810.

transformationcontainer

Purpose
Base container for transformation. Requires Media Transformation Services.

Parameters

component (Required) Name of the component to contain.


Supplied by the action execution class).
componentArgs (Required) List of arguments and values to pass
to each contained component. Supplied by the
LaunchComponent action execution class.
folderId (Optional) Not used.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1241
transformationcontainernewobject

objectId (Required) ID of the transformed object.


renditionId (Optional) ID of the content selected for
transformation.

Description
Since
5.x

Configuration File
webcomponent\config\library\transformation\transformationcontainer_component.xml

Parent Definition
propertysheetwizardcontainer:webcomponent/config/library/propertysheetwizardcontainer/
propertysheetwizardcontainer_component.xml

Scope
All.

Elements
transformation
See transformation, page 837.
numberedtabs
See numberedtabs, page 827.

transformationcontainernewobject

Purpose
Transformation container for the new object. Requires Media Transformation Services.

Parameters
The parameters are inherited from transformationcontainer:webcomponent/config/library/
transformation/transformationcontainer_component.xml. See transformationcontainer, page 1241.

1242 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
transformationcontainerrendition

Description
Since
5.x

Configuration File
webcomponent\config\library\transformation\transformationcontainer_newobject_component.xml

Parent Definition
transformationcontainer:webcomponent/config/library/transformation/transformationcontainer_
component.xml

Scope
All.

Elements
transformation
See transformation, page 837.

transformationcontainerrendition

Purpose
Transformation container for the new rendition. Requires Media Transformation Services.

Parameters
The parameters are inherited from transformationcontainer:webcomponent/config/library/
transformation/transformationcontainer_component.xml. See transformationcontainer, page 1241.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1243
transformationdetails

Configuration File
webcomponent\config\library\transformation\transformationcontainer_rendition_component.xml

Parent Definition
transformationcontainer:webcomponent/config/library/transformation/transformationcontainer_
component.xml

Scope
All.

Elements
transformation
See transformation, page 837.

transformationdetails

Purpose
Specifies transformation details for an object. Requires Media Transformation Services.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\library\transformation\transformationdetails_component.xml

Scope
All.

1244 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
transformationnewobjectdef

Elements
controlproperties

1 <controlproperties>
2<textareanumcols value="32"></textareanumcols>
3<textareanumrows value="5"></textareanumrows>
4<thumbnailheight value="40"></thumbnailheight>
5<thumbnailwidth value="40"></thumbnailwidth>
6<listboxsize value="5"></listboxsize>
7<colorpickernumrows value="24"></colorpickernumrows>
8<colorpickerwidth value="200"></colorpickerwidth>
9<colorpickerheight value="20"></colorpickerheight>
</controlproperties>

1 Contains specifications for the control.


2 Number of columns of the text block.
3 Number of rows of the text block.
4 Height of the content object thumbnail .
5 Width of the content object thumbnail.
6 Size of the list box .
7 Number of rows of the color picker.
8 Width of the color picker.
9 Height of the color picker.

transformationnewobjectdef

Purpose
Provides definition of the new transformation object. Requires Media Transformation Services.

Parameters

objectId (Required) ID of the selected object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1245
transformationselect

Description
Since
5.x

Configuration File
webcomponent\config\library\transformation\transformationnewobjectdef_component.xml

Scope
All.

Elements
showaliasset

<showaliasset>false</showaliasset>

Whether to display (true) the alias set or not (false).

transformationselect

Purpose
A transformation selection component. Requires Media Transformation Services. Enables the user
to select the available media profiles.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\library\transformation\transformationselect_component.xml

1246 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
menubar

Scope
All.

Elements
None.

Menus

menubar

Purpose
Adds a bar of menu controls.

Parameters

accessible (Optional) Set to true to render menu selections


accessible (Section 508 compliant)

Description

Since
5.x

Configuration File
webcomponent\config\library\menubar\menubar_component.xml

Scope
All.

Elements
menugrouptarget
See menugrouptarget, page 824.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1247
menubar (Webtop)

failoverenabled
See failoverenabled, page 819.

menuconfigids

1 <menuconfigids>
2<id>menubar_file_menu</id>
...
</menuconfigids>

1 Contains <id> elements that identify <menuconfig> elements.


2 A string that corresponds to the ID attribute of a <menuconfig> element.

menubar (Webtop)

Purpose
Adds a bar of menu controls in the top frame of workarea.jsp (the content frame of the Webtop classic
view). The menubar component loads into a frame of the workarea.jsp (part of the main component
set of JSP pages).

Parameters
The parameters are inherited from menubar:/webcomponent/config/library/menubar/menubar_
component.xml. See menubar, page 1247.

Description
Since
5.x

Configuration File
webtop\config\menubar_component.xml

Parent Definition
menubar:/webcomponent/config/library/menubar/menubar_component.xml

1248 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
messagearchiveattach (type dm_message_archive)

Scope
All.

Elements
menugrouptarget
See menugrouptarget, page 824.

failoverenabled
See failoverenabled, page 819.

menuconfigids
See menuconfigids, page 1248.

Message archives

messagearchiveattach (type dm_message_archive)

Purpose
Provides user interface and behaviour for displaying and editing a dm_message_archive object’s
attachement attributes.

Since
6.5

messagearchiveattachlocations

Purpose
Lists the email message to which the selected attachment object is linked.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1249
messagearchiveattachlocations (Webtop)

Since
6.5

messagearchiveattachlocations (Webtop)

Purpose
Lists the email message to which the selected attachment object is linked.

Since
6.5

My Files

mydocumentlocator

Purpose
Extends myobjectlocator, page 1254 and displays all objects of type dm_document or its subtypes
that are owned by the user. The scope is not defined, but the <objecttype> element restricts this
component to dm_document objects.

Parameters
The parameters are inherited from myobjectlocator:webcomponent/config/library/locator/
myobjectlocator_component.xml. See myobjectlocator, page 1254.

Description
Since
5.x

1250 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
mydocumentlocator

Configuration File
webcomponent\config\library\locator\documentlocators_component.xml

Parent Definition
myobjectlocator:webcomponent/config/library/locator/myobjectlocator_component.xml

Scope
All.

Elements
objecttype

<objecttype>dm_document</objecttype>

Specifies the object type of the objects to locate.

views
See views, page 839.

columns
See columns (for data columns), page 811.

containerselectable

1 <containerselectable>false</containerselectable>

1 See containerselectable, page 814.

flatlist

1 <flatlist>true</flatlist>

1 See flatlist, page 820.

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1251
myfiles_classic (Webtop)

allversionsvisible

1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

modifiedwithindays
See modifiedwithindays, page 825.

myfiles_classic (Webtop)

Purpose
Lists objects that are checked out or recently used by the user. The time interval since last modified
date, as a criterion for display, is configurable.

Description
Since
5.x

Configuration File
webtop\config\myfiles_classic_component.xml

Parent Definition
myobjects_list:/webcomponent/config/library/myobjects/myobjects_list_component.xml

Scope
All.

Elements
showfolders
See showfolders, page 835.

1252 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
myfiles_streamline (Webtop)

failoverenabled
This element structure is inherited from myobjects_list:/webcomponent/config/library/myobjects/
myobjects_list_component.xml. See myobjects_list, page 1082.

columns
See columns (for streamline view), page 811.

preset_item
See preset_item, page 830.

objecttype

<objecttype>dm_document</objecttype>

Specifies the object type of the objects to display.


modifiedwithindays
See modifiedwithindays, page 825.

myfiles_streamline (Webtop)

Purpose
Displays a folder frame and a folder contents frame for folders that contain objects checked out or
recently edited by the user.

Description

Since
5.x

Configuration File
webtop\config\myfiles_streamline_component.xml

Parent Definition
myobjects_drilldown:/webcomponent/config/library/myobjects/myobjects_drilldown_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1253
myobjectlocator

Scope
All.

Elements
failoverenabled
This element structure is inherited from myobjects_list:/webcomponent/config/library/myobjects/
myobjects_list_component.xml. See myobjects_list, page 1082.

columns
See columns (for streamline view), page 811.

objecttype

<objecttype>dm_document</objecttype>

Specifies the object type of the objects to display.


showfolders
See showfolders, page 835.

modifiedwithindays
See modifiedwithindays, page 825.

preferences
See preferences, page 828.

myobjectlocator

Purpose
Extends sysobjectlocator, page 1091 and displays all sysobjects that are owned by the user.

1254 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
myobjectlocator

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) Type of the selected object

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\myobjectlocator_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

objecttype

<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to locate.


containerselectable

1 <containerselectable>false</containerselectable>

1 See containerselectable, page 814.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1255
myobjects_drilldown

flatlist

1 <flatlist>true</flatlist>

1 See flatlist, page 820.

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

allversionsvisible

1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

modifiedwithindays
See modifiedwithindays, page 825.

views
See views, page 839.

contenttypepanelvisible
See contenttypepanelvisible, page 815.

filenamefiltervisible
See filenamefiltervisible, page 819.

myobjects_drilldown

Purpose
Displays a folder frame and a folder contents frame for folders that contain objects owned by the user.

1256 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
myobjects_drilldown

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\myobjects\myobjects_drilldown_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

columns
See columns (for streamline view), page 811.

objecttype

<objecttype>dm_document</objecttype>

Specifies the object type of the objects to display.

showfolders
See showfolders, page 835.

modifiedwithindays
See modifiedwithindays, page 825.
preferences
See preferences, page 828.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1257
attributes (type dmc_prm_library_request)

Physical Records Manager

attributes (type dmc_prm_library_request)

Purpose
Displays the attributes of a dmc_prm_library_request object.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\library\records\request\attributes_prm_library_request_component.xml

Scope

type dmc_prm_library_request

Elements
showpagesastabs
See showpagesastabs, page 836.

dmc_prm_address_locatorcontainer

Purpose
Container for the dmc_prm_addresslocator, page 1259 component.

1258 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
dmc_prm_addresslocator

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description

Since
6.0

Configuration File
webcomponent\config\library\records\locator\prm_address_locator_container.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

dmc_prm_addresslocator

Purpose
Contains dmc_prm_physical_address objects.

Parameters

attachedDocIds (Optional)
multiselect (Optional) Boolean: Set to true to support
multiple object selection.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1259
dmc_prm_addresslocator

Description
Since
6.0

Configuration File
webcomponent\config\library\records\locator\prm_address_locator_container.xml

Parent Definition
allfolderlocator:webcomponent/config/library/locator/folderlocators_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.

iconwell_icon
See iconwell_icon, page 822.

objecttype
<objecttype>dmc_prm_address</objecttype>

Specifies the object type of the objects to locate.


privatecabinetvisible
1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

1260 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
makelibraryrequest

views
See views, page 839.

makelibraryrequest

Purpose
Creates a library request (dmc_prm_library_request object).

Parameters

objectId (Required) Object ID of the dmc_prm_library_


request object to create.

Description

Since
6.0

Configuration File
webcomponent\config\library\records\request\make_prm_library_request_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1261
makelibraryrequestcontainer

makelibraryrequestcontainer

Purpose
Contains the makelibraryrequest, page 1261 component.

Parameters

component (Required) Name of the component to contain.


Supplied by the action execution class.
componentArgs (Optional) List of arguments and values to pass
to each contained component. Supplied by the
LaunchComponent action execution class.

Description
Since
6.0

Configuration File
webcomponent\config\library\records\request\make_prm_library_request_container_component.
xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

1262 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
pendingtargets

pendingtargets

Purpose
Displays a list of all pending items in a library request.

Parameters

objectId (Required) Object ID of the library request object.

Description
Since
6.0

Configuration File
webcomponent\config\library\records\request\pending_targets_component.xml

Scope
All.

Elements
None.

properties (type dmc_prm_library_request)

Purpose
Displays the properties of dmc_prm_library_request objects.

Parameters
The parameters are inherited from properties:webcomponent/config/library/properties/properties_
component.xml. See properties, page 926.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1263
requestedtargets

Description
Since
6.0

Configuration File
webcomponent\config\library\records\request\prm_library_request_properties_component.xml

Parent Definition
properties:webcomponent/config/library/properties/properties_component.xml

Scope

type dmc_prm_library_request

Elements
commitorder
See commitorder, page 814.

failoverenabled
This element structure is inherited from properties:webcomponent/config/library/properties/
properties_component.xml. See properties, page 926.

setrepositoryfromobjectid
See setrepositoryfromobjectid, page 834.

requestedtargets

Purpose
Displays a list of all items in a library request.

Parameters

objectId (Required) Object ID of the library request object.

1264 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
userrequestlist (entitlement prm, role dmc_prm_library_user)

Description
Since
6.0

Configuration File
webcomponent\config\library\records\request\requested_targets_component.xml

Scope
All.

Elements
None.

userrequestlist (entitlement prm, role


dmc_prm_library_user)

Purpose
Displays a list of a user’s library requests.

Parameters
None.

Description

Since
6.0

Configuration File
webcomponent\config\library\records\request\user_request_list.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1265
columnselector

Scope

entitlement prm
role dmc_prm_library_user

Elements
None.

Preferences

columnselector

Purpose
Edits display preferences. The JSP page contains an attributeselector control that generates the lists of
columns, selected columns, and selection buttons.

Parameters

columns (Required) A serialized list of items to populate


the available items list box. See multiselector
control for details on the list format.
defaultSelectedColumns (Optional) A serialized list of items to populate
the selected items list box before the user
performs an initial selection.
docbaseTypes (Optional) Specifies the repository types, in
addition to the default option, to populate the
attribute selectors docbase types drop‑down list.
If omitted, no docbase types will be available
for selection. This is a simple list of alternating
type names and values. To pass in as a string
argument to the column selector, the list may be
passed to ColumnListUtil.
enableOrdering (Optional) Boolean: true to enable the user to
control the order of columns.

1266 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
columnselectorcontainer

selectedColumns (Optional) A serialized list of items to populate


the selected columns list box.
showRepeatingAttributes (Optional) Specifies whether repeating attributes
should be shown when selecting one of the
repository types specified by docbasetypes.
Default is true.

Description
Since
5.x

Configuration File
webcomponent\config\environment\preferences\display\columnselector_component.xml

Scope
All.

Usage
The onCommitChanges method sets a list of return values by calling Form.setReturnValue. If your
component nests to the columnselector component and implements IReturnListener, you can get the
values from the Map instance with the onReturn(Form form, Map map) method.

Elements
None.

columnselectorcontainer

Purpose
Edits display preferences. The JSP page contains an attributeselector control that generates the lists of
columns and selected columns and the selection buttons.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1267
component_preferences

Parameters

component (Required) Supplied by the action execution


class. The name of the component to contain.
displaytitle (Optional) A title for the component.

Description
Since
5.x

Configuration File
webcomponent\config\environment\preferences\display\columnselectorcontainer_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

component_preferences

Purpose
Enables users to set preferences for portals.

Parameters

componentid (Optional) For internal use only.


context (Optional) For internal use only.

1268 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
debug_preferences

Description
Since
5.x

Configuration File
webcomponent\config\environment\preferences\portal\component\component_preferences_
component.xml

Scope
All.

Elements
None.

debug_preferences

Purpose
Sets debugging preferences during application development. This component is designed to run
within the preferences component, which is a property sheet container.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\environment\preferences\debug\debug_preferences_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1269
display_preferences

Elements
None.

display_preferences

Purpose
Sets the user’s preferences for the columns to be displayed by another component. This component
is presented within the preferences container. Displays the following (generated by the preference
control): the component’s list of columns in the order they will appear, and checkboxes (if appropriate)
to use the cabinets view and to use thumbnails.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\environment\preferences\display\display_preferences_component.xml

Scope
All.

Usage
WDK display preferences are edited by the columnselector component. The editing component is
configurable as the value of the display_preferences <editcomponent> element. You cannot display
an attribute if is_searchable is set to false. For more information on configuring display preferences,
see WDK Development Guide.

Elements
preferencedisplaygroups
See preferencedisplaygroups, page 828.

1270 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
display_preferences (version 5.3) (Webtop)

preferences
See preferences, page 828.

display_preferences (version 5.3) (Webtop)

Purpose
Sets the user’s preferences for the columns to be displayed by another component.

Description
Since
6.0

Configuration File
webtop\config\display_preferences_component.xml

Parent Definition
display_preferences:webcomponent/config/environment/preferences/display/display_preferences_
component.xml

Scope

version 5.3

As of 6.5: Changed from “5.3.0” to “5.3”.

Elements
preferencedisplaygroups
See preferencedisplaygroups, page 828.
preferences
See preferences, page 828.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1271
display_preferences (Webtop)

display_preferences (Webtop)

Purpose
Sets the user’s preferences for the columns to be displayed by another component.

Parameters
None.

Description
Since
6.0

Configuration File
webtop\config\display_preferences_ex_component.xml

Parent Definition
display_preferences:webcomponent/config/environment/preferences/display/display_preferences_
component.xml

Scope
All.

Elements
preferencedisplaygroups
See preferencedisplaygroups, page 828.

preferences
See preferences, page 828.

1272 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
format_pref_attr_selector

format_pref_attr_selector

Purpose
Enables selection of the attributes for a preferred rendition setting.

Parameters

editApp (Optional) Name of the application to edit


content of the specified preferred rendition
format.
isEditing (Optional) Boolean: Whether the format is
already being edited (True) or not (False).
preferredRenditionFormat (Optional) Name of the preferred rendition
format.
primaryFormat (Optional) Name of the primary format.
type (Optional) Object type to which the preferred
rendition setting applies.
viewApp (Optional) Name of the application to view
content of the specified preferred rendition
format.

Description

Since
6.0

Configuration File
webcomponent\config\environment\preferences\format\format_preference_attr_selector_
component.xml

Parent Definition
format_preferences:webcomponent/config/environment/preferences/format/format_preferences_
component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1273
format_preferences_summary

Caller
editformatpref, page 542

Usage
If the isEditing parameter value that was passed from the editformatpref, page 542 action is true, this
component sets the values of its controls to the values of the passed parameters. If the isEditing
parameter value that was passed from the editformatpref, page 542 action is false, then the controls
are populated with string values that prompt the user to input a value (for example, Choose an
object type). When the user clicks OK in this component, the format preference is passed to the
format_preferences_summary, page 1274 component and displays them. When the user saves
the changes in the format_preferences_summary, page 1274 component, the format preference is
committed to the repository.

Elements
base_type
See base_type, page 810.

ucfrequired
See ucfrequired, page 838.

format_preferences_summary

Purpose
Displays the current set of format preferences and allow a user to add, edit and delete specific format
preferences.

Parameters
None.

Description
Since
6.0

1274 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
formatpreferencescontainer

Configuration File
webcomponent\config\environment\preferences\format\format_preferences_summary_
component.xml

Scope
All.

Usage
When the user saves the format preferences in this component, the format preferences are committed
to the repository.

Elements
None.

formatpreferencescontainer

Purpose
Container for the format_preferences_summary, page 1274 component that enables users to set format
preferences.

Parameters
The parameters are inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml. See
dialogcontainer, page 1185.

Description

Since
6.0

Configuration File
webcomponent\config\environment\preferences\format\format_preferences_container_
component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1275
general_preferences

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.
ucfrequired
See ucfrequired, page 838.

general_preferences

Purpose
Enables the user to select a UI theme and the startup location.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\environment\preferences\general\general_preferences_component.xml

Scope
All.

1276 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
general_preferences (version 5.3) (Webtop)

Elements
None.

general_preferences (version 5.3) (Webtop)

Purpose
Enables the user to select a UI theme and the startup location.

Description
Since
5.x

Configuration File
webtop\config\general_preferences_component.xml

Parent Definition
general_preferences:webcomponent/config/environment/preferences/general/general_preferences_
component.xml

Scope

version 5.3

As of 6.5: Changed from “5.3.0” to “5.3”.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1277
general_preferences (Webtop)

general_preferences (Webtop)

Purpose
Enables the user to select a UI theme and the startup location.

Description
Since
6.0

Configuration File
webtop\config\general_preferences_ex_component.xml

Parent Definition
general_preferences:webcomponent/config/environment/preferences/general/general_preferences_
component.xml

Scope
All.

Elements
None.

portal_preferences

Purpose
Enables users to set preferences for portals..

Parameters
The parameters are inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

1278 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
portlet_preferences

Description
Since
5.x

Configuration File
webcomponent\config\environment\preferences\portal\portal_preferences_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

ucfrequired
See ucfrequired, page 838.

portlet_preferences

Purpose
Enables users to set preferences for portlets. For internal use only.

Parameters
The parameters are inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml. See
dialogcontainer, page 1185.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1279
preferences

Description
Since
5.x

Configuration File
webcomponent\config\environment\preferences\portal\portlet\portlet_preferences_component.
xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

preferences

Purpose
Extends the propertysheet container. Launched by the preferences action to contain several
preferences components.

Parameters
Since 6.0 SP1.

component (Required) Supplied by the action execution


class. The name of the component to contain.
refreshclient (Optional) Set to true to refresh the page once the
user has restored all preferences.

1280 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
visiblerepository_preferences

Description
Since
5.x

Configuration File
webcomponent\config\environment\preferences\preferences_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

ucfrequired
See ucfrequired, page 838.

visiblerepository_preferences

Purpose
Enables the user to select repositories that will be visible in the login dialog. The repositories that are
displayed for selection are those that are accessible to the connection brokers in the user’s preferred
connection broker list. The user can select or enter new connection brokers by clicking the Configure
connection broker link.

Parameters
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1281
deletepreset (type dmc_preset_package)

Description
Since
5.x

Configuration File
webcomponent\config\environment\preferences\visiblerepository\visiblerepository_preferences_
component.xml

Scope
All.

Elements
None.

Presets

deletepreset (type dmc_preset_package)

Purpose
Deletes dmc_preset_package objects.

Parameters

objectName (Required) Name of the dmc_preset_package


object to delete.

Description

Since
6.0

1282 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
deletepresetcombocontainer (type dmc_preset_package)

Configuration File
webcomponent\config\library\presets\delete\deletepreset_component.xml

Scope

type dmc_preset_package

Elements
None.

deletepresetcombocontainer (type dmc_preset_


package)

Purpose
Displays dmc_preset_package objects to delete.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description
Since
6.0

Configuration File
webcomponent\config\actions\dmc_preset_package_actions.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope

type dmc_preset_package

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1283
migratepresets

Elements
failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.
propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

migratepresets

Purpose
Prepare preset objects to be deployed to a production repository.

Parameters

objectName (Required) Object name of the preset to prepare


for migration.
componentArgs (Required) Supplied by the LaunchComponent
action execution class.) List of arguments and
values to pass to each contained component.

Description
Since
6.0 SP1

Configuration File
webcomponent\config\library\presets\migrate\migratepreset_component.xml

Scope
All.

1284 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
presetactionitem

Usage
ACL object ID references are udpated to use object_name and owner_name. Location folder object
ID references are updated with aspects. Repository scope references are updated to production
repository scopes.

Elements
None.

presetactionitem

Purpose
Enables editiing preset action items.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\library\presets\items\presetactionitem_component.xml

Scope
All.

Elements
menuconfigs
1 <menuconfigs>
2<menuconfig>
3<id>menubar_file_menu</id>
4<nlsbundle>com.documentum.webcomponent.library.menubar.MenuBarNlsProp</nlsbundle>
</menuconfig>
...
</menuconfigs>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1285
presetallfolderlocator

1 Specifies a menu items in a menubar.


2 Specifies a single menu item.
3 Specifies the ID of a menu item.
4 Specifies the NLS bundle for the menu.
preset_item_definition
See preset_item_definition, page 831.

presetallfolderlocator

Purpose
Locates all preset folders in a repository and displays them in a hierarchical view.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description
Since
6.0 SP1

Configuration File
webcomponent\config\library\locator\presetlocationlocators_component.xml

Parent Definition
allfolderlocator:webcomponent/config/library/locator/folderlocators_component.xml

Scope
All.

Elements
None.

1286 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
presetautoattributesitem

presetautoattributesitem

Purpose
Enables editing of preset auto attributes items.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\library\presets\items\presetautoattributesitem_component.xml

Scope
All.

Elements
basetype
<basetype>dm_document</basetype>

Specifies the base object type.


excludetypes
<excludetypes>dm_folder</excludetypes>

A list of comma‑separated object types to be excluded.


preset_item_definition
See preset_item_definition, page 831.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1287
presetdocbasenamescope

presetdocbasenamescope

Purpose
Enables setting repository scope for presets.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\library\presets\scopes\presetdocbasenamescope_component.xml

Scope
All.

Elements
preset_scope_definitions
See preset_scope_definitions, page 831.

show_selections
Sets the initial display of selections to expanded (true) or collapsed (false).
Since 6.0 SP1.

preseteditorcontainer

Purpose
Container for the presetscopes, page 1302 and presetitems, page 1291 components.

1288 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
presetformatitem

Parameters

component (Required) Supplied by the action execution


class. The name of the component to contain.
objectName (Optional) Name of the preset object.

Description
Since
6.0

Configuration File
webcomponent\config\library\presets\preseteditorcontainer_component.xml

Parent Definition
propertysheetwizardcontainer:webcomponent/config/library/propertysheetwizardcontainer/
propertysheetwizardcontainer_component.xml

Scope
All.

Elements
numberedtabs
See numberedtabs, page 827.

presetformatitem

Purpose
Enables editing preset formats.

Parameters
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1289
presetgroupitem

Description
Since
6.0

Configuration File
webcomponent\config\library\presets\items\presetformatitem_component.xml

Scope
All.

Elements
preset_item_definition
See preset_item_definition, page 831.

presetgroupitem

Purpose
Enables editing preset group items.

Parameters
None.

Description

Since
6.0

Configuration File
webcomponent\config\library\presets\items\presetgroupitem_component.xml

Scope
All.

1290 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
presetitems

Elements
groupfilters
1 <groupfilters>
2<groupfilter>
3<group_class>
4<nlsid>MSG_ALL_FILTER</nlsid>
</group_class>
5<label>
6<nlsid>MSG_ALL_FILTER</nlsid>
</label>
</groupfilter>
...
</groupfilters>

1 Specifies a filter for groups.

preset_item_definition
See preset_item_definition, page 831.

presetitems

Purpose
Enables editing preset items.

Parameters
None.

Description

Since
6.0

Configuration File
webcomponent\config\library\presets\items\presetitems_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1291
presetlifecycleitem

Elements
preset_item_editors
1 <preset_item_editors>
2<preset_item_editor>
3<componentname>presetpermissionitem</componentname>
4<label>
5<nlsid>MSG_PERMISSION_EDITOR</nlsid>
</label>
</preset_item_editor>
...
</preset_item_editors>

show_summary
<show_summary>true</show_summary>

Whether to initially display the summary (true) or not (false).

presetlifecycleitem

Purpose
Enables selecting a lifecycle for a preset.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\library\presets\items\presetlifecycleitem_component.xml

Scope
All.

1292 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
presetlist

Elements
preset_item_definition
See preset_item_definition, page 831.

presetlist

Purpose
Displays a list of available presets.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\admin\presetlist\presetlist_component.xml

Scope
All.

Elements
columnpreferenceid
<columnpreferenceid>application.display.presetlist_columns</columnpreferenceid>

columns
See columns (for streamline view), page 811.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1293
presetlocationlocatorcontainer

presetlocationlocatorcontainer

Purpose
Enables navigating preset cabinets and folders.

Parameters
Since 6.0 SP1.

invalidpresetentries (Optional) Specifies the object IDs of folders that


do not exist or are from other repositories.

multiselect (Optional) Boolean: Set to true to support


multiple object selection.
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected.

Description
Since
6.0

Configuration File
webcomponent\config\library\locator\presetlocationlocators_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

1294 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
presetlocationscope

presetlocationscope

Purpose
Enables setting location scope for a preset.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\library\presets\scopes\presetlocationscope_component.xml

Scope
All.

Elements
preset_scope_definitions
See preset_scope_definitions, page 831.

show_selections
Sets the initial display of selections to expanded (true) or collapsed (false).
Since 6.0 SP1.

presetnavigationitem

Purpose
Sets preferences for the preset navigation editor.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1295
presetobjectlocator

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\library\presets\items\presetnavigationitem_component.xml

Scope
All.

Elements
exclude_node
Excludes navigation nodes in this component. For example, in this component’s configuration file, the
administration node is not displayed:
<navigation_exclusion_nodes>
<exclude_node>administration</exclude_node>
</navigation_exclusion_nodes>

preset_item_definition
See preset_item_definition, page 831.

presetobjectlocator

Purpose
Enables locating preset objects.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

1296 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
presetobjectlocator

Description
Since
6.0

Configuration File
webcomponent\config\library\locator\presetobjectlocators_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

contenttypepanelvisible
1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.

filenamefiltervisible
See filenamefiltervisible, page 819.
iconwell_icon
See iconwell_icon, page 822.
objecttype
<objecttype>dmc_preset_package</objecttype>

Specifies the object type of the objects to locate.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1297
presetobjectlocatorcontainer

privatecabinetvisible
1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.


views
See views, page 839.

presetobjectlocatorcontainer

Purpose
Contains the presetobjectlocator, page 1296 component to locate dmc_preset_package objects.

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description
Since
6.0

Configuration File
webcomponent\config\library\locator\presetobjectlocators_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

1298 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
presetobjecttypelocator

presetobjecttypelocator

Purpose
Enables locating dmc_preset_package objects.

Parameters

multiselect (Optional) Boolean: Set to true to support


multiple object selection.

objecttype (Optional) Type of the selected object.

Description
Since
6.0

Configuration File
webcomponent\config\library\locator\presetobjecttypelocatorcontainer_component.xml

Parent Definition
persistentobjectlocator:webcomponent/config/library/locator/persistentobjectlocator_component.xml

Scope
All.

Elements
attributes
See attributes, page 810.
columns
See columns (for data columns), page 811.
iconwell_icon
See iconwell_icon, page 822.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1299
presetobjecttypelocatorcontainer

objecttype
<objecttype>dm_type</objecttype>

Specifies the object type of the objects to locate.

views
See views, page 839.

presetobjecttypelocatorcontainer

Purpose
Contains the presetobjecttypelocator, page 1299 component to locate dmc_preset_package objects.

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description
Since
6.0

Configuration File
webcomponent\config\library\locator\presetobjecttypelocatorcontainer_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

1300 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
presetotherdocbaselocationeditor

presetotherdocbaselocationeditor

Purpose
Enables editing locations in other repositories to which a preset is applied.

Parameters
None.

Description
Since
6.0 SP1

Configuration File
webcomponent\config\library\locator\presetlocationlocators_component.xml

Scope
All.

Usage
Although you can remove a location preset in another repository directly in this component, to add a
location preset, you must log into the repository.

Elements
iconwell_icon
See iconwell_icon, page 822.

presetpermissionitem

Purpose
Enables defining permission sets as preset items.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1301
presetscopes

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\library\presets\items\presetpermissionitem_component.xml

Scope
All.

Elements
preset_item_definition
See preset_item_definition, page 831.

presetscopes

Purpose
Enables defining scopes for a dmc_preset_package object.

Parameters
None.

Description

Since
6.0

Configuration File
webcomponent\config\library\presets\scopes\presetscopes_component.xml

1302 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
presettemplateitem

Scope
All.

Elements
preset_scope_editors
1 <preset_scope_editors>
2<preset_scope_editor>
3<componentname>presetusergrouprolescope</componentname>
4<label>
5<nlsid>MSG_USER_GROUP_ROLE_SCOPE</nlsid>
</label>
</preset_scope_editor>
...
</preset_scope_editors>

presettemplateitem

Purpose
Enables defining items for a preset template.

Parameters
None.

Description

Since
6.0

Configuration File
webcomponent\config\library\presets\items\presettemplateitem_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1303
presettypeitem

Elements
preset_item_definition
See preset_item_definition, page 831.

presettypeitem

Purpose
Enables defining object types as preset items.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\library\presets\items\presettypeitem_component.xml

Scope
All.

Elements
preset_item_definition
See preset_item_definition, page 831.

1304 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
presettypescope

presettypescope

Purpose
Enables setting the object type scope for a preset.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\library\presets\scopes\presettypescope_component.xml

Scope
All.

Elements
preset_scope_definitions
See preset_scope_definitions, page 831.

show_selections
Sets the initial display of selections to expanded (true) or collapsed (false).
Since 6.0 SP1.

presetusergrouprolescope

Purpose
Enables setting a user, group, or role scope for a preset.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1305
presetwizardcontainer

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\library\presets\scopes\presetusergrouprolescope_component.xml

Scope
All.

Elements
preset_scope_definitions
See preset_scope_definitions, page 831.

show_selections
Sets the initial display of selections to expanded (true) or collapsed (false).
Since 6.0 SP1.

presetwizardcontainer

Purpose
Contains the presetscopes, page 1302 and presetitems, page 1291 components to enable creating and
modifying dmc_preset_package objects.

1306 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
presetworkflowitem

Parameters

component (Required) Supplied by the action execution


class. The name of the component to contain.

objectName (Optional) Name of the dmc_preset_package


object to modify.

Description
Since
6.0

Configuration File
webcomponent\config\library\presets\presetwizardcontainer_component.xml

Parent Definition
propertysheetwizardcontainer:webcomponent/config/library/propertysheetwizardcontainer/
propertysheetwizardcontainer_component.xml

Scope
All.

presetworkflowitem

Purpose
Enables setting the workflows that can be started for a preset.

Parameters
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1307
assemblylist (type dmc_rm_formal_record) (Webtop)

Description
Since
6.0

Configuration File
webcomponent\config\library\presets\items\presetworkflowitem_component.xml

Scope
All.

Elements
preset_item_definition
See preset_item_definition, page 831.

Records Manager

assemblylist (type dmc_rm_formal_record) (Webtop)

Purpose
Displays the structure of a virtual document snapshot for a dmc _rm_formal_record object.

Parameters
The parameters are inherited from vdmlist:webcomponent/config/navigation/vdm/vdmlist_
component.xml. See vdmlist, page 1560.

Description
Since
6.0

1308 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
assemblyliststreamline (type dmc_rm_formal_record) (Webtop)

Configuration File
webtop\config\recordlist_component.xml

Parent Definition
vdmlist:webcomponent/config/navigation/vdm/vdmlist_component.xml

Scope

type dmc_rm_formal_record

Elements
dragdrop
See dragdrop, page 818.

columns
See columns (for streamline view), page 811.

preset_item
See preset_item, page 830.

default_binding_filter_values
See default_binding_filter_values, page 815.

assemblyliststreamline (type dmc_rm_formal_


record) (Webtop)

Purpose
Displays the structure of a virtual document snapshot for a dmc_rm_formal_record object in
drilldown (streamline) view.

Parameters
The parameters are inherited from vdmliststreamline:webcomponent/config/navigation/vdm/
vdmliststreamline_component.xml. See vdmliststreamline, page 1563.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1309
attributes (type dmc_rm_formal_rec_folderdmc_rm_formal_rec_cabinet)

Description
Since
6.0

Configuration File
webtop\config\recordliststreamline_component.xml

Parent Definition
vdmliststreamline:webcomponent/config/navigation/vdm/vdmliststreamline_component.xml

Scope

type dmc_rm_formal_record

Elements
dragdrop
See dragdrop, page 818.

columns
See columns (for streamline view), page 811.
default_binding_filter_values
See default_binding_filter_values, page 815.

attributes (type dmc_rm_formal_rec_folderdmc_rm_


formal_rec_cabinet)

Purpose
Displays the primary attributes of the selected dmc_rm_formal_record object or
dmc_rm_formal_rec_cabinet and includes a link to expand the attributes list or to display all attributes.
Requires a Records Manager license.

Parameters
The parameters are inherited from xforms:webcomponent/config/xforms/xforms_component.xml.
See xforms, page 1761.

1310 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attributes (type dmc_rm_formal_record)

Description
Since
5.x

Configuration File
webcomponent\config\library\records\declarerecord\attribute_rm_formalfolder_component.xml

Parent Definition
recordattributes:webcomponent/config/library/records/declarerecord/attribute_rm_formalrecord_
component.xml

Scope

type dmc_rm_formal_rec_folder, dmc_rm_formal_


rec_cabinet

Elements
None.

attributes (type dmc_rm_formal_record)

Purpose
Displays the primary attributes of the selected dmc_rm_formal_record object or
dmc_rm_formal_rec_cabinet and includes a link to expand the attributes list or to display all attributes.
Requires a Records Manager license.

Parameters
The parameters are inherited from xforms:webcomponent/config/xforms/xforms_component.xml.
See xforms, page 1761.

Description
Since
6.0

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1311
cancelcheckout (type dmc_rm_formal_record)

Configuration File
webcomponent\config\library\records\declarerecord\attribute_rm_formalrecord_component.xml

Parent Definition
recordattributes:webcomponent/config/library/records/declarerecord/attribute_rm_formalrecord_
component.xml

Scope

type dmc_rm_formal_record

Elements
None.

cancelcheckout (type dmc_rm_formal_record)

Purpose
Cancels the checkout of one or more previously checked out dmc_rm_formal_record objects by
removing the lock on the specified objects.

Parameters
The parameters are inherited from cancelcheckout:/webcomponent/config/library/contenttransfer/
cancelcheckout/cancelcheckout_component.xml. See cancelcheckout (type dm_sysobject), page 1108.

Description
Since
5.x

Configuration File
webcomponent\config\library\records\cancelcheckout\cancelcheckout_component.xml

Parent Definition
cancelcheckout:/webcomponent/config/library/contenttransfer/cancelcheckout/cancelcheckout_
component.xml

1312 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
cancelcheckoutcontainer (type dmc_rm_formal_record)

Scope

type dmc_rm_formal_record

Elements
ucfrequired
See ucfrequired, page 838.

service
See service, page 834.

init­controls
See init‑controls, page 823.

cancelcheckoutcontainer (type dmc_rm_formal_


record)

Purpose
Allows users to remove the lock on specified checked‑out dmc_rm_formal_record objects.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description
Since
5.x

Configuration File
webcomponent\config\library\records\cancelcheckout\cancelcheckoutcontainer_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1313
checkin (type dmc_rm_formal_record)

Parent Definition
cancelcheckoutcontainer:/webcomponent/config/library/contenttransfer/cancelcheckout/
cancelcheckoutcontainer_component.xml

Scope

type dmc_rm_formal_record

Elements
ucfrequired
See ucfrequired, page 838.

service
See service, page 834.

setrepositoryfromobjectid
See setrepositoryfromobjectid, page 834.

bindingcomponentversion
See bindingcomponentversion, page 810.

checkin (type dmc_rm_formal_record)

Purpose
Checks in dmc_rm_formal_record objects that were checked out and sets properties on objects.

Parameters

nodeId (Optional) ID of the node in a virtual document


to check in.
objectId (Required) The ID of the dmc_rm_formal_record
object to check in.
vdmRootObjectId (Optional) Root object ID or the virtual document
to check in.

1314 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
checkincontainer (type dmc_rm_formal_record)

Description
Since
5.x

Configuration File
webcomponent\config\library\records\checkin\checkin_component.xml

Parent Definition
checkin:/webcomponent/config/library/contenttransfer/checkin/checkin_component.xml

Scope

type dmc_rm_formal_record

Elements
init­controls
See init‑controls, page 823.

ucfrequired
See ucfrequired, page 838.
service
See service, page 834.
preset_item
See preset_item, page 830.

checkincontainer (type dmc_rm_formal_record)

Purpose
Checking in multiple dmc_rm_formal_record objects creates one checkin container and an inner
checkin component instance for each object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1315
checkincontainer (type dmc_rm_formal_record)

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description

Since
5.x

Configuration File
webcomponent\config\library\records\checkin\checkincontainer_component.xml

Parent Definition
checkincontainer:/webcomponent/config/library/contenttransfer/checkin/checkincontainer_
component.xml

Scope

type dmc_rm_formal_record

Elements
ucfrequired
See ucfrequired, page 838.

service
See service, page 834.

setrepositoryfromobjectid

<setrepositoryfromobjectid>true</setrepositoryfromobjectid>
See setrepositoryfromobjectid, page 834.

bindingcomponentversion
See bindingcomponentversion, page 810.

1316 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
checkout (type dmc_rm_formal_record)

checkout (type dmc_rm_formal_record)

Purpose
Checks out dmc_rm_formal_record objects from the repository without launching an editing
application. This component is available in all views for dmc_rm_formal_record objects that are
checked out on the user’s current machine. Checking out multiple objects creates one checkout
container and an inner checkout component instance for each dmc_rm_formal_record object.

Parameters
The parameters are inherited from checkout:/webcomponent/config/library/contenttransfer/checkout/
checkout_component.xml. See checkout (type dm_sysobject), page 1114.

Description
Since
5.x

Configuration File
webcomponent\config\library\records\checkout\checkout_component.xml

Parent Definition
checkout:/webcomponent/config/library/contenttransfer/checkout/checkout_component.xml

Scope

type dmc_rm_formal_record

Elements
ucfrequired
See ucfrequired, page 838.

service
See service, page 834.
init­controls
See init‑controls, page 823.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1317
checkoutcontainer (type dmc_rm_formal_record)

skipVersionCheck
See skipVersionCheck, page 836.

checkoutcontainer (type dmc_rm_formal_record)

Purpose
Container for the checkout process for dmc_rm_formal_record objects.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description
Since
5.x

Configuration File
webcomponent\config\library\records\checkout\checkoutcontainer_component.xml

Parent Definition
checkoutcontainer:/webcomponent/config/library/contenttransfer/checkout/checkoutcontainer_
component.xml

Scope

type dmc_rm_formal_record

Elements
ucfrequired
See ucfrequired, page 838.

service
See service, page 834.

1318 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
declareformalrecord (entitlement recordsmanager)

bindingcomponentversion
See bindingcomponentversion, page 810.

declareformalrecord (entitlement recordsmanager)

Purpose
Declare, that is, createformal record objects from existing objects. Requires a Records Manager license.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\library\records\declarerecord\declareformalrecord_component.xml

Scope

entitlement recordsmanager

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1319
declareFormalRecordContainer (entitlement recordsmanager)

declareFormalRecordContainer (entitlement
recordsmanager)

Purpose
Container for the declareformalrecord (entitlement recordsmanager) component. Requires a Records
Manager license.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class.) The name of the
component to contain.
componentArgs (Optional) Supplied by the LaunchComponent
action execution class.) List of arguments and
values to pass to each contained component.

Description

Since
5.x

Configuration File
webcomponent\config\library\records\declarerecord\declareformalrecordcontainer_component.
xml

Parent Definition
newdoccontainer:webcomponent/config/library/create/newdoccontainer_component.xml

Scope

entitlement recordsmanager

Elements
newcomponentname
See newcomponentname, page 825.

1320 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
fileplanlocator (entitlement recordsmanager)

numberedtabs
See numberedtabs, page 827.

fileplanlocator (entitlement recordsmanager)

Purpose
Enables selection of a file plan in which to place a record. Requires a Records Manager license.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description
Since
5.x

Configuration File
webcomponent\config\library\records\locator\fileplan_locator_component.xml

Parent Definition
allfolderlocator:webcomponent/config/library/locator/folderlocators_component.xml

Scope

entitlement recordsmanager

Elements
iconwell_icon
See iconwell_icon, page 822.

objecttype

<objecttype>dm_folder</objecttype>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1321
fileplanlocatorcontainer (entitlement recordsmanager)

Specifies the object type of the objects to locate.


containerselectable

1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

allversionsvisible

1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

views
See views, page 839.

fileplanlocatorcontainer (entitlement
recordsmanager)

Purpose
Container for the fileplanlocator component. Requires a Records Manager license.

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

1322 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
fileplanmyobjectlocator (entitlement recordsmanager)

Description
Since
5.x

Configuration File
webcomponent\config\library\records\locator\fileplan_locator_component.xml

Parent Definition
folderlocatorcontainer:webcomponent/config/library/locator/folderlocators_component.xml

Scope

entitlement recordsmanager

Elements
None.

fileplanmyobjectlocator (entitlement
recordsmanager)

Purpose
Displays all file plan objects that are owned by the user. Requires a Records Manager license.

Parameters
The parameters are inherited from myobjectlocator:webcomponent/config/library/locator/
myobjectlocator_component.xml. See myobjectlocator, page 1254.

Description
Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1323
fileplanmyobjectlocator (entitlement recordsmanager)

Configuration File
webcomponent\config\library\records\locator\fileplan_locator_component.xml

Parent Definition
myobjectlocator:webcomponent/config/library/locator/myobjectlocator_component.xml

Scope

entitlement recordsmanager

Elements
iconwell_icon
See iconwell_icon, page 822.

columns
See columns (for data columns), page 811.

objecttype

<objecttype>dm_folder</objecttype>

Specifies the object type of the objects to locate.

containerselectable

1 <containerselectable>false</containerselectable>

1 See containerselectable, page 814.

flatlist

1 <flatlist>true</flatlist>

1 See flatlist, page 820.

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

1324 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
fileplansubscriptionlocator (entitlement recordsmanager)

allversionsvisible

1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

modifiedwithindays
See modifiedwithindays, page 825.
views
See views, page 839.

fileplansubscriptionlocator (entitlement
recordsmanager)

Purpose
Displays a user’s subscribed file plans. Requires a Records Manager license.

Parameters
The parameters are inherited from subscriptionlocator:webcomponent/config/library/locator/
subscriptionlocator_component.xml. See subscriptionlocator, page 1423.

Description

Since
5.x

Configuration File
webcomponent\config\library\records\locator\fileplan_locator_component.xml

Parent Definition
subscriptionlocator:webcomponent/config/library/locator/subscriptionlocator_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1325
fileplansubscriptionlocator (entitlement recordsmanager)

Scope

entitlement recordsmanager

Elements
iconwell_icon
See iconwell_icon, page 822.

columns
See columns (for data columns), page 811.

objecttype

<objecttype>dm_folder</objecttype>

Specifies the object type of the objects to locate.

containerselectable

1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

flatlist

1 <flatlist>false</flatlist>

1 See flatlist, page 820.

privatecabinet_visible
See privatecabinet_visible, page 831.

allversionsvisible

1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

views
See views, page 839.

1326 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
formalrecordcombocontainer (entitlement recordsmanager)

formalrecordcombocontainer (entitlement
recordsmanager)

Purpose
Enables a user to perform multi‑select operations on formal record objects. Requires a Records
Manager license.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description
Since
5.x

Configuration File
webcomponent\config\library\records\declarerecord\formalrecordcombocontainer_component.
xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope

entitlement recordsmanager

Elements
failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1327
properties (type dmc_rm_formal_record)

properties (type dmc_rm_formal_record)

Purpose
Enables users to view and change properties of dmc_rm_formal_record objects. Requires a Records
Manager license.

Parameters
The parameters are inherited from properties:webcomponent/config/library/properties/properties_
component.xml. See properties, page 926.

Description
Since
5.x

Configuration File
webcomponent\config\library\records\declarerecord\formalrecord_properties_component.xml

Parent Definition
properties:webcomponent/config/library/properties/properties_component.xml

Scope

type dmc_rm_formal_record

Elements
failoverenabled
This element structure is inherited from properties:webcomponent/config/library/properties/
properties_component.xml. See properties, page 926.

commitorder
See commitorder, page 814.
setrepositoryfromobjectid
See setrepositoryfromobjectid, page 834.

1328 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
recordattributes

recordattributes

Purpose
Displays the attributes of formal record objects in a form based on a form template. Requires
a Records Manager license.

Parameters
The parameters are inherited from xforms:webcomponent/config/xforms/xforms_component.xml.
See xforms, page 1761.

Description
Since
5.x

Configuration File
webcomponent\config\library\records\declarerecord\attribute_rm_formalrecord_component.xml

Parent Definition
xforms:webcomponent/config/xforms/xforms_component.xml

Scope
All.

Elements
None.

recordlocator (entitlement recordsmanager)

Purpose
Locator for formal record objects. Requires a Records Manager license.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1329
recordlocator (entitlement recordsmanager)

Parameters

objectId (Required) ID of the source formal record


object of the create relationship action. This
formal record will be excluded from the list of
formal records, since an object cannot have a
relationship to itself.

Description
Since
5.x

Configuration File
webcomponent\config\library\records\locator\rm_record_locator_container.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope

entitlement recordsmanager

Elements
iconwell_icon
See iconwell_icon, page 822.

columns
See columns (for data columns), page 811.

allversionsvisible

1 <allversionsvisible>true</allversionsvisible>

1 See allversionsvisible, page 809.

objecttype

<objecttype>dm_sysobject</objecttype>

1330 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
recordlocatorcontainer (entitlement recordsmanager)

Specifies the object type of the objects to locate.


containerselectable

1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

contenttypepanelvisible

1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.

filenamefiltervisible
See filenamefiltervisible, page 819.

views
See views, page 839.

recordlocatorcontainer (entitlement
recordsmanager)

Purpose
Container for the recordlocator (entitlement recordsmanager), recordmyobjectlocator (entitlement
recordsmanager), and recordsubscriptionlocator (entitlement recordsmanager) components. Requires
a Records Manager license.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1331
recordmyobjectlocator (entitlement recordsmanager)

Parameters

objectId (Required) Object ID for the formal record that is


the parent of the relationship to create.

Description
Since
5.x

Configuration File
webcomponent\config\library\records\locator\rm_record_locator_container.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope

entitlement recordsmanager

Elements
multidocbasesupport
See multidocbasesupport, page 825.

recordmyobjectlocator (entitlement recordsmanager)

Purpose
Displays all formal record objects owned by a user. Requires a Records Manager license.

Parameters
The parameters are inherited from myobjectlocator:webcomponent/config/library/locator/
myobjectlocator_component.xml. See myobjectlocator, page 1254.

1332 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
recordmyobjectlocator (entitlement recordsmanager)

Description
Since
5.x

Configuration File
webcomponent\config\library\records\locator\rm_record_locator_container.xml

Parent Definition
myobjectlocator:webcomponent/config/library/locator/myobjectlocator_component.xml

Scope

entitlement recordsmanager

Elements
iconwell_icon
See iconwell_icon, page 822.

columns
See columns (for data columns), page 811.
objecttype

<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to locate.

containerselectable

1 <containerselectable>false</containerselectable>

1 See containerselectable, page 814.

allversionsvisible

1 <allversionsvisible>true</allversionsvisible>

1 See allversionsvisible, page 809.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1333
recordsubscriptionlocator (entitlement recordsmanager)

flatlist

1 <flatlist>true</flatlist>

1 See flatlist, page 820.

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

modifiedwithindays
See modifiedwithindays, page 825.

views
See views, page 839.

recordsubscriptionlocator (entitlement
recordsmanager)

Purpose
Displays all formal record objects to which a user is subscribed. Requires a Records Manager license.

Parameters
The parameters are inherited from subscriptionlocator:webcomponent/config/library/locator/
subscriptionlocator_component.xml. See subscriptionlocator, page 1423.

Description

Since
5.x

1334 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
recordsubscriptionlocator (entitlement recordsmanager)

Configuration File
webcomponent\config\library\records\locator\rm_record_locator_container.xml

Parent Definition
subscriptionlocator:webcomponent/config/library/locator/subscriptionlocator_component.xml

Scope

entitlement recordsmanager

Elements
iconwell_icon
See iconwell_icon, page 822.

columns
See columns (for data columns), page 811.

objecttype

<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to locate.

containerselectable

1 <containerselectable>false</containerselectable>

1 See containerselectable, page 814.

allversionsvisible

1 <allversionsvisible>true</allversionsvisible>

1 See allversionsvisible, page 809.

flatlist

1 <flatlist>false</flatlist>

1 See flatlist, page 820.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1335
view_record_relationships (entitlement recordsmanager)

privatecabinet_visible
See privatecabinet_visible, page 831.

views
See views, page 839.

view_record_relationships (entitlement
recordsmanager)

Purpose
View relationships between records. Requires a Records Manager license.

Parameters

objectId (Required) Object ID of the source record.

Description
Since
5.x

Configuration File
webcomponent\config\library\records\relationships\record_relationships.xml

Parent Definition
objectgrid:/webcomponent/config/navigation/objectgrid/objectgrid_component.xml

Scope

entitlement recordsmanager

Elements
columns
See columns (for data columns), page 811.

1336 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
viewContainedInFormalRecords (entitlement recordsmanager) (Webtop)

header
See header, page 821.

nondocbasecolumns
See nondocbasecolumns, page 826.

viewContainedInFormalRecords (entitlement
recordsmanager) (Webtop)

Purpose
View a list of formal record objects that contain a specified object. Requires a Records Manager license.

Parameters

objectId (Required) ID of the object contained within the


formal record objects to display.

Description
Since
6.0

Configuration File
webtop\config\view_contained_in_formal_records.xml

Scope

entitlement recordsmanager

Elements
columns
See columns (for data columns), page 811.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1337
xformsattachmentlocator (type rm_classification_guide)

xformsattachmentlocator (type rm_classification_


guide)

Purpose
This component is a locator specialized for locating document attachments based on the
rm_classification_guide type.

Parameters

objecttype (Optional) Type of the selected object.

Description
Since
5.x

Configuration File
webcomponent\config\library\records\locator\classification_guide_locator_component.xml

Parent Definition
xformsattachmentlocator:webcomponent/config/xforms/locator/xformsattachmentlocator_component.
xml

Scope

type rm_classification_guide

Elements
iconwell_icon
See iconwell_icon, page 822.

columns
See columns (for data columns), page 811.

objecttype

<objecttype>rm_classification_guide</objecttype>

1338 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
xformsattachmentlocator (type rm_dod5015ch4record)

Specifies the object type of the objects to locate.


views
See views, page 839.
containerselectable

1 <containerselectable>false</containerselectable>

1 See containerselectable, page 814.

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

allversionsvisible

1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

flatlist

1 <flatlist>true</flatlist>

1 See flatlist, page 820.

xformsattachmentlocator (type rm_


dod5015ch4record)

Purpose
Locator that locates document attachments for objects of the rm_dod5015ch4record type.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1339
xformsattachmentlocator (type rm_dod5015ch4record)

Parameters

objecttype (Optional) Type of the object.

Description
Since
6.0

Configuration File
webcomponent\config\library\records\locator\original_classified_records_locator_component.xml

Parent Definition
xformsattachmentlocator:webcomponent/config/xforms/locator/xformsattachmentlocator_component.
xml

Scope

type rm_dod5015ch4record

Elements
iconwell_icon
See iconwell_icon, page 822.

columns
See columns (for data columns), page 811.

containerselectable

1 <containerselectable>false</containerselectable>

1 See containerselectable, page 814.

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

1340 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
deleterelation (type dm_document)

allversionsvisible

1 <allversionsvisible>true</allversionsvisible>

1 See allversionsvisible, page 809.

flatlist

1 <flatlist>true</flatlist>

1 See flatlist, page 820.

objecttype

<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to locate.

Relationships between objects

deleterelation (type dm_document)

Purpose
Deletes an existing relation (dm_relation) between two dm_document objects.

Parameters

relationObjectId (Required) ID of the dm_relation object.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1341
newrelation (type dm_document)

Description
Since
6.0

Configuration File
webcomponent\config\library\delete\deleterelation_component.xml

Scope

type dm_document

Elements
None.

newrelation (type dm_document)

Purpose
Creates a new relation (dm_relation) between two dm_document objects.

Parameters

childObjectId (Required) ID of the child object in the relation.


objectId (Required) ID of the parent object in the relation.

Description
Since
6.0

Configuration File
webcomponent\config\library\create\newrelation_component.xml

1342 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newrelationcontainer

Scope

type dm_document

Elements
None.

newrelationcontainer

Purpose
Container for newrelation (type dm_document), page 1342 component, which creates a new relation
(dm_relation) between two dm_document objects.

Parameters

childObjectId (Optional) ID of the child object in the relation.


flatlist (Optional) Boolean: Set to true to list all objects
in a flat list, set to false to display objects in a
drop‑down list.
folderId (Optional) ID of the folder in which to begin the
search.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objectId (Required) ID of the parent object in the relation.
objecttype (Optional) Type of the selected object.
repository (Optional) Repoitory in which to search.
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1343
relationships (Webtop)

Description
Since
6.0

Configuration File
webcomponent\config\library\create\newrelationcontainer_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

relationships (Webtop)

Purpose
Extends the WDK relationships component and lists the sysobjects to which the source sysobject has
a relationship (dm_relation object).

Parameters
The parameters are inherited from relationships:/webcomponent/config/library/relationships/
relationships_component.xml. See relationships, page 1097.

Description

Since
5.x

1344 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
renditions (type dm_sysobject)

Configuration File
webtop\config\relationships_component.xml

Parent Definition
relationships:/webcomponent/config/library/relationships/relationships_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

Renditions

renditions (type dm_sysobject)

Purpose
Extends objectgrid, page 1194 and lists the renditions of an object. This component is defined with
dm_sysobject scope. For dm_folder objects it is specifically not defined, so that the renditions
component is not available for folders.

Parameters

contentType (Optional) Type of content to be rendered.


objectId (Required) ID of the object to be rendered.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1345
renditions (type dm_sysobject) (Webtop)

Configuration File
webcomponent\config\library\renditions\renditions_component.xml

Parent Definition
objectgrid:/webcomponent/config/navigation/objectgrid/objectgrid_component.xml

Scope

type dm_sysobject

Elements
columns
See columns (for streamline view), page 811.

nondocbasecolumns
See nondocbasecolumns, page 826.

header
See header, page 821.

renditions (type dm_sysobject) (Webtop)

Purpose
Extends the WDK renditions component and lists the renditions of an object. This component is
defined with dm_sysobject scope.

Parameters
The parameters are inherited from renditions:/webcomponent/config/library/renditions/renditions_
component.xml. See renditions (type dm_sysobject), page 1345.

Description

Since
5.x

1346 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
changehomedocbase

Configuration File
webtop\config\renditions_component.xml

Parent Definition
renditions:/webcomponent/config/library/renditions/renditions_component.xml

Scope

type dm_sysobject

Usage
For dm_folder objects, this component is specifically not defined, so that the renditions component
is not available for folders.

Elements
columns
See columns (for streamline view), page 811.

nondocbasecolumns
See nondocbasecolumns, page 826.

Repository

changehomedocbase

Purpose
Changes the user’s home docbase. The component offers the choice of running the associated job
immediately or waiting until the scheduled job.

Parameters

objectId (Required) ID of the new home repository


objectname (Required) User name

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1347
changepassword

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\changehomedocbase_component.xml

Scope
All.

Elements
None.

changepassword

Purpose
The component provides a user interface and functionality that allow users to change their repository
passwords. The login and changepassword components are the only two Documentum components
that do not require a Documentum connection.

Parameters

docbase (Optional) Name of the repository in which the


user is changing the password
domain (Optional) Network domain for the repository
username (Required) Name of user who is changing the
password

Description
Since
5.x

1348 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
configuredocbroker

Configuration File
wdk\config\changepassword_component.xml

Scope
All.

Elements
editableusername

<editableusername>true</editableusername>

Boolean. True to allow the username to be edited.

configuredocbroker

Purpose
This component allows the user to select the connection brokers that will supply repositories for
login. A dropdown list of connection brokers that are specified in the application server dmcl.ini file
is displayed. The user can enter the name of another connection broker to the list. The component
verifies the existence and connection to connection brokers when the user clicks OK.

Parameters
None.

Description
Since
5.x

Configuration File
wdk\config\configuredocbroker_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1349
launchrepositoryselector

Elements
None.

launchrepositoryselector

Purpose
This component is nested in the locatorcontainer component to call the launchauthenticate action.

Parameters

suppressLoginEvent (Optional) Specifies whether to fire the


loginSuccess or loginCancel client events after
the login dialog has been dismissed

Description

Since
5.x

Configuration File
wdk\config\launchrepositoryselector_component.xml

Scope
All.

Elements
None.

1350 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
repositoryselector

repositoryselector

Purpose
This component allows the user to select a repository to be added to a list of preferred repositories.
Like the login component, this component and its container are listed in Environment.properties as
non_docbase_components. Displays visible repositories for the list of connection brokers. The user
can manually enter the name of a connection broker to select a repository that connects to that broker.

Parameters
None.

Description
Since
5.x

Configuration File
wdk\config\repositoryselector_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

repositoryselectorcontainer

Purpose
A container that enables selection of a content repository.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1351
setretentiondate (type dm_sysobject)

Parameters
The parameters are inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml. See
dialogcontainer, page 1185.

Description

Since
5.x

Configuration File
wdk\config\repositoryselectorcontainer_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

Retention Policy Services

setretentiondate (type dm_sysobject)

Purpose
Sets a retention date for the object in its storage location. The action is executed asynchronously.

1352 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
setretentiondate (type dm_sysobject)

Parameters

lockOwner (Optional) Name of user who has checked out


the document
objectId (Required) ID of the object for which the
retention date is set.

Description
Since
5.x

Configuration File
webcomponent\config\library\retentiondate\setretentiondate_component.xml

Scope

type dm_sysobject

Caller
Not called in Webtop.

Elements
asynchronous
See asynchronous, page 809.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1353
advsearch

Search

advsearch

Purpose
WDK advanced search allows a user to select type, type attributes, and location for search. The data
dictionary supplies searchable types and attributes as well as value assistance and conditional value
assistance. Search results display columns are configured in the search column and can be selected by
users in the display_preferences component UI.

Parameters

drilldown (Optional) Set to true to use the drilldown view


by default to display the search results. This
parameter is set to false in Webtop when the user
selects classic view in preferences.
folderpath (Optional) Used to populate the radio button
that displays the current location
includetypes (Optional) Comma‑delimited list of object types
to display for search. Subtypes of the selected
type will also be searched. Overrides the default
set in the <includetypes> element.
objectId (Optional) Specifies the object id of the saved
search to be revised
query (Optional) Full‑text query string
queryId (Optional) Internally used to identify the current
search context
showwait (Optional) Specifies whether to show the wait
page for a non‑DQL query. By default, the wait
page is displayed.
type (Optional) Initial search type, defaults to the first
type in includetypes

1354 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
advsearch

usedocumentpresetfilter (Optional) Set to true to activate the use


of the type filter preset element from the
newDocument component. This element
overrides the includetypes element value.

Since 6.0 SP1.

usepreviousinput (Optional) Set to true to restore previous search


criteria input, if possible

Description
Since
5.x

Configuration File
webcomponent\config\library\search\searchex\advsearch_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

includetypes
See includetypes, page 822. This element value is not used if <usedocumentpresetfilter> is set to true.

usedocumentpresetfilter
Since 6.0 SP1.
Set to true to use the Types preset rule (which is also used by the newdocument component) to limit
the displayed types in the Object Types field; the includetypes element value is ignored. Set to false to
use the includetypes element value. Default is false.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1355
advsearch (clientenv portal, type dm_message_archive)

advsearch (clientenv portal, type dm_message_


archive)

Purpose
WDK advanced search for dm_message_archive objects in a WDK portlet environment.

Since
6.5

advsearch (type dm_message_archive)

Purpose
WDK advanced search for dm_message_archive objects.

advsearch (type dm_message_archive) (Webtop)

Purpose
Webtop advanced search for dm_message_archive objects.

1356 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
advsearch (Webtop)

advsearch (Webtop)

Purpose
The Webtop advanced search allows a user to select type, type attributes, and location for search. The
data dictionary supplies searchable types and attributes as well as value assistance and conditional
value assistance. Search results display columns are configured in the search column and can be
selected by users in the display_preferences component UI.

Parameters
The parameters are inherited from advsearch:webcomponent/config/library/search/searchex/
advsearch_component.xml. See advsearch, page 1354.

Description
Since
5.x

Configuration File
webtop\config\advsearchex_component.xml

Parent Definition
advsearch:webcomponent/config/library/search/searchex/advsearch_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from advsearch:webcomponent/config/library/search/searchex/
advsearch_component.xml. See advsearch, page 1354.

includetypes
This element structure is inherited from advsearch:webcomponent/config/library/search/searchex/
advsearch_component.xml. See advsearch, page 1354.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1357
advsearchcontainer

usedocumentpresetfilter
This element structure is inherited from advsearch:webcomponent/config/library/search/searchex/
advsearch_component.xml. See advsearch, page 1354.

advsearchcontainer

Purpose
Contains the WDK 5.3 search components.

Parameters

basetype (Optional) The base object type used to populate


the available search types
component (Optional) Name of the component within the
container
drilldown (Optional) Set to true to use the drilldown view
by default to display the search results. This
parameter is set to false in Webtop when the user
selects classic view in preferences.
folderpath (Optional) Specifies the initial folder path for the
search location. This value is used if the user has
not set a search location preference.
objectId (Optional) Specifies the object id of the saved
search to be revised
queryId (Optional) Internally used to identify the current
search context
showwait (Optional) Not used
type (Optional) Initial search type, defaults to the
basetype
usepreviousinput (Optional) Set to true to restore previous search
criteria input, if possible

1358 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
advsearchcontainer (version 5.2.5)

Description
Since
5.x

Configuration File
webcomponent\config\library\search\searchex\advsearchcontainer_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope
All.

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
See failoverenabled, page 819.

advsearchcontainer (version 5.2.5)

Purpose
WDK 5.2.5 component that contains the search components advsearch and savedsearches. This
component cannot be addressed directly, but it is present to support custom components that extend it.

Parameters

component (Optional) Name of the component within the


container to be initially displayed

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1359
allsavedsearches

Description
Since
5.x

Configuration File
webcomponent\config\library\search\advsearchcontainer_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope

version 5.2.5

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

allsavedsearches

Purpose
Lists all dm_smartlist objects for which the user has access. The user can revise (if permitted), execute,
view properties, and delete (if permitted).

Parameters
None.

1360 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attributes (type dm_externalresult)

Description
Since
5.x

Configuration File
webcomponent\config\library\search\searchex\allsavedsearches_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

attributes (type dm_externalresult)

Purpose
This component allows the user to view name and URL for an object that is in an external source,
returned by a query. Note that dm_externalresult is not a real docbase type, but a pseudotype used
only in the WDK for scoping.

Parameters

entryId (Required) Internal key to the query results.


queryId (Required) Internally used to identify the current
search context

Description
Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1361
changesearchsources

Configuration File
webcomponent\config\library\attributes\attributes_dm_externalresult_component.xml

Scope

type dm_externalresult

Elements
None.

changesearchsources

Purpose
Enables a user to change the repositories to search.

Parameters

searchsources (Optional) A semicolon‑separated list of


repositories to search in the format source:path

Description
Since
5.x

Configuration File
webcomponent\config\library\changesearchsources\changesearchsources_component.xml

Scope
All.

Elements
None.

1362 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
deletesmartlistcontainer (type dm_smart_list)

deletesmartlistcontainer (type dm_smart_list)

Purpose
This component is the component container used to delete dm_smart_list objects (saved search objects)

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description
Since
5.x

Configuration File
webcomponent\config\library\delete\deletesmartlistcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope

type dm_smart_list

Elements
failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.
setrepositoryfromobjectid
See setrepositoryfromobjectid, page 834.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1363
mysavedsearches

mysavedsearches

Purpose
Lists all dm_smartlist objects that are owned by the user. The user can revise , execute, view
properties, and delete.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\library\search\searchex\mysavedsearches_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

portalsearch

Purpose
Enables searching repositories for portal users. For internal use only.

1364 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
portalsearchcontainer

Parameters

drilldown (Optional) For internal use only.


showwait (Optional) For internal use only.

Description

Since
5.x

Configuration File
webcomponent\config\library\search\searchex\portalsearch_component.xml

Scope
All.

Elements
None.

portalsearchcontainer

Purpose
Container for the portalsearch component. For internal use only.

Parameters

drilldown (Optional) For internal use only.


showwait (Optional) For internal use only.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1365
resultshandling_preferences

Description
Since
5.x

Configuration File
webcomponent\config\library\search\searchex\portalsearchcontainer_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope
All.

Elements
bindingcomponentversion
See bindingcomponentversion, page 810.

failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

resultshandling_preferences

Purpose
Enables users to dynamically display asynchronous search results by arrival order or by relevancy
criteria.

Parameters
None.

1366 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
savedsearches (version 5.2.5)

Description
Since
6.0

Configuration File
webcomponent\config\environment\preferences\search\results\resultshandling_preferences.xml

Scope
All.

Elements
insertionmethod
<insertionmethod>dynamic_order</insertionmethod>

Specifies the default insertion method. Valid values are:


• arrival_order: Results are inserted according to their order of arrival.
• dynamic_order: Results are inserted dynamically according to sort criteria.

savedsearches (version 5.2.5)

Purpose
This is the WDK 5.2.5 savedsearches component that supports operations on saved searches. The user
can execute the saved search by viewing it from a folder or object list or by selecting the savedsearches
component within advanced search. This component cannot be called by URL, but it can be extended
by a custom component.

Parameters
None.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1367
savesearch

Configuration File
webcomponent\config\library\search\savedsearches_component.xml

Scope

version 5.2.5

Elements
queryfilterset
1 <queryfilterset>
2<queryfilter>
3<displayname>
4<nlsid>MSG_MY_SAVEDSEARCHES</nlsid>
</displayname>
5<dqlfilter>where owner_name=user</dqlfilter>
</queryfilter>
...
</queryfilterset>

savesearch

Purpose
Creates a dm_smart_list object. The search is automatically stored in the current repository. The
search is saved within a folder named Saved Searches in the user’s home cabinet. (This folder is
always hidden and is created if it does not exist.)

Parameters

queryId (Required) The object id of the current search,


an internal parameter to enable sharing of the
query context between search components. If the
parameter does not exist, the 5.2.5 save search
component is called.??

1368 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
savesearch (version 5.2.5)

Description
Since
5.x

Configuration File
webcomponent\config\library\savesearch\savesearchex\savesearch_component.xml

Scope
All.

Elements
enablesavingsearchresults
<enablesavingsearchresults>true</enablesavingsearchresults>

If the tag is set to true, a panel is displayed in SaveSearchEx component with two checkboxes. One
checkbox enables the user choose to include results in the saved search and the other one enables
the user to choose whether the save search must be public or not. If no tag is specified, the feature
is enabled by default.

failoverenabled
See failoverenabled, page 819.

includeresults
<includeresults>true</includeresults>

If the savingSearchResults feature is enabled, a default value for the includeresults checkbox can be set
by using the includeresults tag. If no tag is specified, it uses the default value, which is true. If the
savingSearchResults feature is disabled, then this value is ignored.

savesearch (version 5.2.5)

Purpose
This is the 5.2.5 savesearch component, present for backward compatibility. Saves a performed search
as a dm_query object. The search is saved within a folder named Saved Searches in the user’s home
cabinet. (The folder is created if it does not exist.)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1369
savesearchcontainer

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\savesearch\savesearch_component.xml

Scope

version 5.2.5

Usage
If your custom WDK 5.2.x component extends this component, it will use this component definition. If
your application simply calls savesearch, you will get the 5.3 component.

Elements
None.

savesearchcontainer

Purpose
This container extends dialogcontainer and contains the 5.3 savesearch component. It allows
authentication in the container initialization.

Parameters
The parameters are inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml. See
dialogcontainer, page 1185.

1370 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
savesearchtemplate

Description
Since
5.x

Configuration File
webcomponent\config\library\savesearch\savesearchex\savesearchcontainer_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

savesearchtemplate

Purpose
Creates in the current repository a search template from a search. Webtop Extended Search is required.

Parameters

objectId (Optional) ID of the search template object to


create.
queryId (Required) Internal ID assigned to the search.

Description
Since
6.0

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1371
search

Configuration File
webcomponent\config\library\search\searchtemplate\savesearchtemplate_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

search

Purpose
The search component performs a search query on the current repository for the supplied string of
keywords or other type of query input. This component displays the search results; can also display
cluster results. Searches in indexed attributes as well as full‑text.

Parameters

clusterId (Optional) ID of the ClusterInfo structure, which


contains cluster results, to display instead of
the global results list. A ClusterInfo structure’s
ID is generated by a ClusterTree control in a
ClusterTreeGroup control.Requires Enterprise
Content Integration (ECI) Services.
drilldown (Optional) Not used (incorrectly documented in
6.0).
query (Required) DQL query (for queryType = dql) or
search string (for queryType = string)

1372 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
search

queryType (Optional) Specifies the type of query. Valid


values:
• dql — a DQL query
• lastQuery — to display the results of the last
executed search
• objectId — object ID of a smartlist
• querydef — sthe XML content of a smartlist
• queryId — for internal use only
• savedResults — to display saved search
results
• string or null — one or more full‑text search
keywords
showwait (Optional) Not used.

Description
Since
6.0

Configuration File
webcomponent\config\library\search\searchex\search60_component.xml

Scope
All.

Usage
Results columns are configured in this component, even results for advanced search. You can scope
this component to display results columns for various object types. Add a column element for each
custom attribute to the scoped definition.

Elements
columns_drilldown
See columns_drilldown, page 1787.
columns_list
See columns_list, page 812.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1373
search (clientenv portal, type dm_message_archive)

defaultsources
See defaultsources, page 816.

displayresultspath
See displayresultspath, page 817.
dragdrop
See dragdrop, page 818.
failoverenabled
See failoverenabled, page 819.

highlight_matching_terms
See highlight_matching_terms, page 822.

type
See type, page 837.

search (clientenv portal, type dm_message_archive)

Purpose
Performs a search query on dm_message_archive objects in a portal environment for the current
repository for the supplied string of keywords or other type of query input

Since
6.5

search (type dm_message_archive)

Purpose
Performs a search query on dm_message_archive objects in the current repository for the supplied
string of keywords or other type of query input

1374 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
search (type dm_message_archive) (Webtop)

Since
6.5

search (type dm_message_archive) (Webtop)

Purpose
Performs a search query on dm_message_archive objects in the current repository for the supplied
string of keywords or other type of query input

Since
6.5

search (version 5.3)

Purpose
The Webtop 5.3 search component performs a search query on the current repository (if the
<defaultsources> parameter is set to current_docbase) for the supplied string of keywords or other
type of query input. This component displays the search results. Searches in indexed attributes as
well as full‑text.

Parameters

drilldown (Optional) Set to true to use the drilldown view


by default to display the search results. This
parameter is set to false in Webtop when the user
selects classic view in preferences.
query (Required) DQL query (for queryType = dql) or
search string (for queryType = string)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1375
search (version 5.3)

queryType (Optional) Specifies the type of query. Valid


values: string (one or more full‑text search
keywords) | objectId (of a saved search) |
querydef (string consisting of smartlist content)
| queryId (internal ID for the current query to
be revised) | null (one or more full‑text search
keywords)
showwait (Optional) Not used.

Description
Since
5.x

Configuration File
webcomponent\config\library\search\searchex\search_component.xml

Scope

version 5.3

Usage
For backward compatibility.

Elements
columns_drilldown
See columns_drilldown, page 1787.

columns_list
See columns_list, page 812.
columns_saved_search
See columns_saved_search, page 813.
defaultsources
See defaultsources, page 816.

displayresultspath
See displayresultspath, page 817.

1376 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
search (version 5.3) (Webtop)

dragdrop
See dragdrop, page 818.

failoverenabled
See failoverenabled, page 819.
highlight_matching_terms
See highlight_matching_terms, page 822.
type
See type, page 837.

search (version 5.3) (Webtop)

Purpose
The Webtop 5.3 search component performs a search query on the current repository (if the
<defaultsources> parameter is set to current_docbase) for the supplied string of keywords or other
type of query input. This component displays the search results. Searches in indexed attributes as
well as full‑text.

Parameters
The parameters are inherited from search:webcomponent/config/library/search/searchex/search_
component.xml. See search (version 5.3), page 1375.

Description

Since
5.x

Configuration File
webtop\config\searchex_component.xml

Parent Definition
search:webcomponent/config/library/search/searchex/search_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1377
search (Webtop)

Scope

version 5.3

Elements
columns_drilldown
See columns_drilldown, page 1787.

columns_list
See columns_list, page 812.

columns_saved_search
See columns_saved_search, page 813.

defaultsources
See defaultsources, page 816.

displayresultspath
See displayresultspath, page 817.

dragdrop
See dragdrop, page 818.

failoverenabled
This element structure is inherited from search:webcomponent/config/library/search/searchex/search_
component.xml. See search (version 5.3), page 1375.
highlight_matching_terms
See highlight_matching_terms, page 822.
type
See type, page 837.

search (Webtop)

Purpose
This component displays the search results on indexed attributes as well as full‑text.

1378 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
search (Webtop)

Parameters
The parameters are inherited from search:webcomponent/config/library/search/searchex/search60_
component.xml. See search, page 1372.

Description

Since
6.0

Configuration File
webtop\config\search60_component.xml

Parent Definition
search:webcomponent/config/library/search/searchex/search60_component.xml

Scope
All.

Usage
You can override the default behavior by using a null queryType parameter and supplying a DQL
string for the query attribute.

Elements
columns_drilldown
See columns_drilldown, page 1787.

columns_list
See columns_list, page 812.

defaultsources
See defaultsources, page 816.
displayresultspath
See displayresultspath, page 817.
dragdrop
See dragdrop, page 818.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1379
search_preferences

failoverenabled
This element structure is inherited from search:webcomponent/config/library/search/searchex/
search60_component.xml. See search, page 1372.

highlight_matching_terms
See highlight_matching_terms, page 822.

type
See type, page 837.

search_preferences

Purpose
Container for user preferences related to search.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\environment\preferences\search\search_preferences_component.xml

Scope
All.

Elements
None.

1380 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchcontainer

searchcontainer

Purpose
This is the WDK 5.2.5 search container component. It cannot be addressed by URL, but it can be
extended by your custom component for backward compatibility.

Parameters
The parameters are inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml. See
dialogcontainer, page 1185.

Description
Since
5.x

Configuration File
webcomponent\config\library\search\searchcontainer_component.xml

Parent Definition
nestedcomponentcontainer:wdk/config/nestedcomponentcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

searchitems

Purpose
Calls the searchstoreclassic, page 1389 or searchstoretemplate, page 1391 component.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1381
searchmonitoring

Parameters

compselection (Optional) Whether the the searchstoreclassic,


page 1389 (searchstoreclassic) or search‑
storetemplate, page 1391 (searchstoretemplate)
component is displayed. Default depends
on the preferences (that is, the last displayed
component). If preferences is not set, then the
searchstoreclassic component is displayed. The
searchstoreclassic component is only displayed
when the ECI option is installed.

Description
Since
6.0

Configuration File
webcomponent\config\library\search\searchex\searchitems_component.xml

Scope
All.

Elements
None.

searchmonitoring

Purpose
Displays the search repositories and external sources and their status, including real‑time graphics
and text data. Webtop Extended Search is required.

1382 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchmonitoring

Parameters

page (Optional) For internal use only.


queryId (Optional) ID of the query to display. Valid
value is a queryId in the com.documentum.
webcomponent.library.search.SearchInfo class.
Default is the most recent queryId value in
SearchInfo class.

Description
Since
6.0

Configuration File
webcomponent\config\library\search\searchex\searchmonitoring_component.xml

Scope
All.

Usage
Status information includes:
• Number of results returned by each source
• Original query (if available)
• Source status (including a detailed error message when the search fails for a source)
Figure 1, page 1384 shows the animation for in‑progress real‑time stack graphics:
• ECIDEV1: One stack (0 results)
• MSSQL53SP4ECI9: Two stacks (the first one for 0 results and the second one for 9 results)
• ORA53SP1ECI5: Three stacks (the first one for 0 results, the second stack for 50 results, and the
third stack for 42 results).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1383
searchmonitoring

Figure 1. In­progress real­time search monitoring

Figure 2, page 1385 shows the animation after results have been completely returned:
• ECIDEV1: Three stacks (the first one for 0 results, the second stack for 50 results, and the third
stack for 283 results)
• MSSQL53SP4ECI9: Two stacks (the first one for 0 results and the second one for 9 results)
• ORA53SP1ECI5: Three stacks (the first one for 0 results, the second stack for 50 results, and the
third stack for 42 results)

1384 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchmonitoring

Figure 2. Completed real­time search monitoring

Elements
animation_max_results_heap_1
<animation_max_results_heap_1>0</animation_max_results_heap_1>

Maximum number of results that the first stack (heap) graphic represents for a source. Valid values are
positive integers. Default is 0.
animation_max_results_heap_2
<animation_max_results_heap_2>50</animation_max_results_heap_2>

Maximum number of results that the second stack (heap) graphic represents for a source. Valid values
are positive integers starting after the animation_max_results_heap_1 parameter value. Default is 50.
The maximum number of stack graphics displayed for a source is three. The third stack graphic
represents the remainder of the search results.

failoverenabled
See failoverenabled, page 819.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1385
searchmonitoringcontainer

refresh_timeout
<refresh_timeout>3500</refresh_timeout>

Interval (in milliseconds) between refreshes of the animation of the real‑time graphics.

searchmonitoringcontainer

Purpose
Contains the searchmonitoring, page 1382 component to display the current search’s repository and
external sources and their status, including real‑time graphics and text data. Webtop Extended Search
is required.

Parameters
The parameters are inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml. See
dialogcontainer, page 1185.

Description

Since
6.0

Configuration File
webcomponent\config\library\search\searchex\searchmonitoringcontainer_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

1386 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchsources_preferences

searchsources_preferences

Purpose
Enables the user to select repositories for their search preference. Users can select external sources
if ECI Services is installed.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\environment\preferences\searchsources\searchsources_preferences_
component.xml

Scope
All.

Elements
preferences
See preferences, page 828.

searchstatus

Purpose
Lists each repository and external source that is used for the current search and gives the status of
each source. This component is displayed when the search monitoring (part of Webtop Extended
Search) is not available.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1387
searchstatuscontainer

Parameters

queryId (Optional) The object id of the current search, an


internal parameter to enable sharing of the query
context between search components.

Description
Since
5.x

Configuration File
webcomponent\config\library\search\searchex\searchstatus_component.xml

Scope
All.

Elements
None.

searchstatuscontainer

Purpose
Contains one or more search status components.

Parameters
The parameters are inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml. See
dialogcontainer, page 1185.

1388 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchstoreclassic

Description
Since
5.x

Configuration File
webcomponent\config\library\search\searchex\searchstatuscontainer_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

searchstoreclassic

Purpose
In classic view, enables users to view, delete, execute a search on, and view properties of existing user
(or all public) dm_smartlist objects (that is, saved searches), and modify new dm_smart_list objects in
the current repository. This component is displayed in the tree.

Parameters
None.

Description

Since
6.0

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1389
searchstorestreamline

Configuration File
webcomponent\config\library\search\searchex\searchstore_component.xml

Scope
All.

Elements
columns_all_saved_searches
See columns_all_saved_searches, page 812.

columns_my_saved_searches
See columns_my_saved_searches, page 813.

defaultview
See defaultview, page 816.
failoverenabled
See failoverenabled, page 819.

Usage
In 6.0, it replaced the allsavedsearches and mysavedsearches 5.3 components (which have been
deprecated).

searchstorestreamline

Purpose
In streamline view, enables users to view, delete, execute a search on, and view properties of existing
user (or all public) dm_smartlist objects (that is, saved searches), and modify new dm_smart_list
objects in the current repository. This component is displayed in the tree.

Parameters
None.

1390 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchstoretemplate

Description
Since
6.0

Configuration File
webcomponent\config\library\search\searchex\searchstorestreamline_component.xml

Scope
All.

Elements
columns_all_saved_searches
See columns_all_saved_searches, page 812.

columns_my_saved_searches
See columns_my_saved_searches, page 813.

defaultview
See defaultview, page 816.
failoverenabled
See failoverenabled, page 819.

searchstoretemplate

Purpose
Lists end‑user or all public search_template objects, enables executing search_template objects (that is,
run a new search with a search_template object),viewing properties, and deleting search_template
objects.

Parameters
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1391
searchstoretemplate

Description
Since
6.0

Configuration File
webcomponent\config\library\search\searchtemplate\searchstoretemplate_component.xml

Scope
All.

Elements
columns_all_search_templates
1 <columns_all_search_templates>
2<loadinvisibleattribute>true</loadinvisibleattribute>
3<column>
4<attribute>object_name</attribute>
5<label>
<nlsid>MSG_NAME</nlsid>
</label>
6<visible>true</visible>
</column>
...
</columns_all_search_templates>

1 Configures the attributes to display for all search templates.


2 Whether to load hidden attributes (true) or not (false).
3 Specifies a column.
4 Specifies the name of the attribute to display in the column.
5 Specifies the text to display as the column head.
6 Whether to display (true) or hide (false) the column.

columns_my_search_templates
1 <columns_my_search_templates>
2<loadinvisibleattribute>true</loadinvisibleattribute>
3<column>
4<attribute>object_name</attribute>
5<label>
<nlsid>MSG_NAME</nlsid>
</label>
6<visible>true</visible>
</column>
...
</columns_my_search_templates>

1 Configures the attributes to display for a user’s search templates.


2 Whether to load hidden attributes (true) or not (false).
3 Specifies a column.

1392 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
searchtemplate

4 Specifies the name of the attribute to display in the column.


5 Specifies the text to display as the column head.
6 Whether to display (true) or hide (false) the column.

defaultview
See defaultview, page 816.
failoverenabled
See failoverenabled, page 819.

searchtemplate

Purpose
Enables executing a search from a search template, displaying a search form from a search template,
and creating a search. Webtop Extended Search is required.

Parameters

objectId (Required)
queryId (Optional)

Description
Since
6.0

Configuration File
webcomponent\config\library\search\searchtemplate\searchtemplate_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1393
searchtemplatecontainer

Elements
failoverenabled
See failoverenabled, page 819.

searchtemplatecontainer

Purpose
Container for the search template.Webtop Extended Search is required.

Parameters
The parameters are inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml. See
dialogcontainer, page 1185.

Description
Since
6.0

Configuration File
webcomponent\config\library\search\searchtemplate\searchtemplatecontainer_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

1394 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
smartnavigation_preferences

smartnavigation_preferences

Purpose
Enables users to set their preferences for displaying the results of search strategies on the smart
navigation panel; that is, add and remove search cluster strategies, and move the cluster strategies up
and down.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\environment\preferences\search\cluster\smartnavigation_preferences_
component.xml

Scope
All.

Elements
None.

viewexternalresult

Purpose
This is an internal component that is invoked by the view action to view the results of a search on
external sources. Failover is not enabled for this component.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1395
accessoractions

Parameters

entryId (Required) Internal key to the query results.


queryId (Required) Internally used to identify the current
search context

Description
Since
5.x

Configuration File
webcomponent\config\library\search\searchex\viewexternalresult_component.xml

Scope
All.

Elements
None.

Security

accessoractions

Purpose
Displays actions for user or group permissions. The available actions are Edit and Remove for the
selected accessor.

Parameters

accessorName (Required) Name of accessor (user or group)


aceavailableactions (Optional) accessor action link list name

1396 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
accessoractions

basicpermit (Optional) The name of the basic permit for the


accessor. Valid values are 1 (none), 2 (browse), 3
(read), 4 (relate), 5 (version), 6 (write), 7 (delete).
Default = 3 (read)
extpermit (Optional) The extended permission for
the accessor. Valid values are EXECUTE_
PROCEDURE_BIT, CHANGE_LOCATION_BIT,
CHANGE_STATE_BIT, CHANGE_
PERMISSIONS_BIT, TAKE_OWNERSHIP_BIT.
Default = 0 (no extended permissions)
extpermit_readonly (Optional) Set to true to disable extended
permission controls
objectId (Optional) Not used
objectName (Optional) Accessor name
permit (Optional) String representation of the
permission that is being applied to the accessor
permitType (Optional) Valid types of IDfPermit:
DF_ACCESS_PERMIT=0DF_EXTENDED_
PERMIT = 1, DF_APPLICATION_PERMIT
= 2, DF_ACCESS_RESTRICTION = 3,
DF_EXTENDED_RESTRICTION = 4,
DF_APPLICATION_RESTRICTION
= 5, DF_REQUIRED_GROUP = 6,
DF_REQUIRED_GROUP_SET = 7
type (Optional) Not used

Description
Since
5.x

Configuration File
webcomponent\config\library\accessoractions\accessoractions_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1397
accessoractionscontainer

Elements
failoverenabled
See failoverenabled, page 819.

accessoractionscontainer

Purpose
Contains the accessoractions component to display actions on accessors (Edit and Remove)

Parameters

component (Optional) Specifies the contained component

Description
Since
5.x

Configuration File
webcomponent\config\library\accessoractions\accessoractionscontainer_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

1398 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
aclacelist

aclacelist

Purpose
Displays and allows editing of the current list of accessors (users and groups) and their permissions
within access control lists (ACLs, known as permission sets).

Parameters

objectId (Required) The ID of the ACL object to be


displayed.

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\aclacelist_component.xml

Scope
All.

Elements
None.

acldelete

Purpose
Deletes access control lists (ACLs, also called permission sets). Not used in Webtop.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1399
aclinfo

Parameters

objectId (Required) The ID of the ACL object to be


deleted.

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acldelete_component.xml

Scope
All.

Elements
None.

aclinfo

Purpose
Displays and updates the simple (single‑valued) attributes of access control lists (ACLs, known as
permission sets).

Parameters

objectId (Required) The ID of the ACL object to be


displayed and updated.

1400 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
acllist

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\aclinfo_component.xml

Scope
All.

Elements
None.

acllist

Purpose
Displays repository access control lists (ACLs, known as permission sets) according to various criteria.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\acllist_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1401
aclobjectlocator

Elements
showbreadcrumb
See showbreadcrumb, page 835.

aclobjectlocator

Purpose
Locates and selects any ACL in the repository

Parameters

flatlist (Optional) Boolean: Set to true to display a flat


list of all selectable objects.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) Type of the selected object

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\aclobjectlocator_component.xml

Parent Definition
persistentobjectlocator:webcomponent/config/library/locator/persistentobjectlocator_component.xml

Scope
All.

1402 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
aclobjectlocatorcontainer

Elements
failoverenabled
See failoverenabled, page 819.
iconwell_icon
See iconwell_icon, page 822.
attributes
See attributes, page 810.
columns
See columns (for data columns), page 811.

objecttype

<objecttype>dm_acl</objecttype>

Specifies the object type of the objects to locate.

views
See views, page 839.

preset_item
See preset_item, page 830.

aclobjectlocatorcontainer

Purpose
Container component for locating and selecting any ACL in the repository

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1403
aclproperties

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\aclobjectlocator_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

multidocbasesupport
See multidocbasesupport, page 825.

aclproperties

Purpose
Allows the user to view the attributes of an access control list (ACL). Contains aclinfo, page 1400 and
aclacelist, page 1399.

Parameters

component (Required) Specifies the starting component to


display (default = aclinfo). The components that
should be displayed within this container must
be listed as child elements of <contains>.
objectId (Required) The ID of the ACL object for which
attributes are to be displayed.

1404 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
aclsaveas

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\aclproperties_component.xml

Parent Definition
adminpropertycontainer:webcomponent/config/admin/container/adminpropertycontainer_
component.xml

Scope
All.

Elements
objecttype

<objecttype>dm_acl</objecttype>

Specifies the object type of the objects to display.

aclsaveas

Purpose
Saves an ACL with a new name.

Parameters
The parameters are inherited from aclproperties:webcomponent/config/admin/acl/aclproperties_
component.xml. See aclproperties, page 1404.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1405
aclvalidate

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\aclsaveas_component.xml

Parent Definition
aclproperties:webcomponent/config/admin/acl/aclproperties_component.xml

Scope
All.

Elements
objecttype

<objecttype>dm_acl</objecttype>

Specifies the object type of the objects to display.

aclvalidate

Purpose
This component is used to display the accessors for an access control list (ACL). Some features of the
UI are turned on only if Trusted Content Services is enabled in the Content Server.

Parameters

validation (Required) This is a background parameter


passed by the server to the component.

1406 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
aclwhereused

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\aclvalidate_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

aclwhereused

Purpose
Displays lists of all objects that use specific access control lists.

Parameters

objectId (Required) The ID of the ACL object for which


attributes are to be shown.

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\aclwhereused_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1407
addaccessor

Scope
All.

Elements
None.

addaccessor

Purpose
Adds or edits individual accessors and accessor groups, including their permissions, for inclusion
in access control lists.

Parameters

accessorName (Required) The name of the individual or group


to be added.
basicpermit (Optional) The name of the basic permit for the
accessor. Valid values are 1 (none), 2 (browse), 3
(read), 4 (relate), 5 (version), 6 (write), 7 (delete).
Default = 3 (read)
extpermit (Optional) The extended permission for
the accessor. Valid values are EXECUTE_
PROCEDURE_BIT, CHANGE_LOCATION_BIT,
CHANGE_STATE_BIT, CHANGE_
PERMISSIONS_BIT, TAKE_OWNERSHIP_BIT.
Default = 0 (no extended permissions)
extpermit_readonly (Optional) Set to true to disable extended
permission controls
objectName (Optional) Accessor name passed from container

1408 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
admindelete

permit (Optional) String representation of the


permission that is being applied to the accessor
permitType (Optional) Valid types of IDfPermit:
DF_ACCESS_PERMIT=0DF_EXTENDED_
PERMIT = 1, DF_APPLICATION_PERMIT
= 2, DF_ACCESS_RESTRICTION = 3,
DF_EXTENDED_RESTRICTION = 4,
DF_APPLICATION_RESTRICTION
= 5, DF_REQUIRED_GROUP = 6,
DF_REQUIRED_GROUP_SET = 7

Description
Since
5.x

Configuration File
webcomponent\config\admin\acl\addaccessor_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

admindelete

Purpose
Enables the administrator to delete an ACL

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1409
aliassetobjectlocator

Parameters

objectId (Required) The ID of the object to be deleted.


objectname (Required) Name of the ACL.
type (Required) Object type of the ACL.

Description
Since
5.x

Configuration File
webcomponent\config\admin\admindelete\admindelete_component.xml

Scope
All.

Elements
None.

aliassetobjectlocator

Purpose
Selects any alias set in the repository

Parameters

multiselect (Optional) Boolean: Set to true to support


multiple object selection.
objecttype (Optional) Type of the selected object

1410 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
aliassetobjectlocatorcontainer

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\aliassetobjectlocator_component.xml

Parent Definition
persistentobjectlocator:webcomponent/config/library/locator/persistentobjectlocator_component.xml

Scope
All.

Elements
iconwell_icon
See iconwell_icon, page 822.

attributes
See attributes, page 810.

columns
See columns (for data columns), page 811.

objecttype

<objecttype>dm_alias_set</objecttype>

Specifies the object type of the objects to locate.

views
See views, page 839.

aliassetobjectlocatorcontainer

Purpose
Selects any alias set in the repository.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1411
extendedaddaccessor

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\aliassetobjectlocator_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

extendedaddaccessor

Purpose
Adds or edits individual accessors and accessor groups, including their permissions, for inclusion in
access control lists. Requires Trusted Content Services for accessor groups.

1412 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
extendedaddaccessor

Parameters

accessorName (Required) The name of the individual or group


to be added.
basicpermit (Optional) The name of the basic permit for the
accessor. Valid values are 1 (none), 2 (browse), 3
(read), 4 (relate), 5 (version), 6 (write), 7 (delete).
Default = 3 (read)
extpermit (Optional) The extended permission for
the accessor. Valid values are EXECUTE_
PROCEDURE_BIT, CHANGE_LOCATION_BIT,
CHANGE_STATE_BIT, CHANGE_
PERMISSIONS_BIT, TAKE_OWNERSHIP_BIT.
Default = 0 (no extended permissions)
extpermit_readonly (Optional) Set to true to disable extended
permission controls
objectName (Optional) Accessor name passed from container
permit (Optional) String representation of the
permission that is being applied to the accessor
permitType (Optional) Valid types of IDfPermit:
DF_ACCESS_PERMIT=0DF_EXTENDED_
PERMIT = 1, DF_APPLICATION_PERMIT
= 2, DF_ACCESS_RESTRICTION = 3,
DF_EXTENDED_RESTRICTION = 4,
DF_APPLICATION_RESTRICTION
= 5, DF_REQUIRED_GROUP = 6,
DF_REQUIRED_GROUP_SET = 7

Description

Since
5.x

Configuration File
webcomponent\config\admin\acl\extendedaddaccessor_componenet.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1413
multiobjectspermissions

Elements
failoverenabled
See failoverenabled, page 819.

multiobjectspermissions

Purpose
Displays the permissions for multiple objects.

Parameters
The parameters are inherited from permissions:/webcomponent/config/library/permissions/
extendedpermissions_component.xml. See permissions, page 1416.

Description
Since
5.x

Configuration File
webcomponent\config\library\permissions\multiobjectsextendedpermissions_component.xml

Parent Definition
permissions:/webcomponent/config/library/permissions/extendedpermissions_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.
nomaclsupport
See nomaclsupport, page 826.

1414 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
nomaclsupport_permissions

permissionsservice
See permissionsservice, page 828.

nomaclsupport_permissions

Purpose
This is a backup ID for WDK 5.3 that passes the arguments to the standard permissions component.

Parameters
The parameters are inherited from permissions:webcomponent/config/library/permissions/
extendedpermissions_component.xml. See permissions, page 1416.

Description
Since
5.x

Configuration File
webcomponent\config\library\permissions\extendedpermissions_component.xml

Parent Definition
permissions:webcomponent/config/library/permissions/permissions_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1415
permissions

permissions

Purpose
Sets extended permissions on objects using Trusted Content Services when that feature is enabled
for the repository.

Parameters

objectId (Required) ID of the object

Description
Since
5.x

Configuration File
webcomponent\config\library\permissions\extendedpermissions_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

nomaclsupport
See nomaclsupport, page 826.

permissionsservice
See permissionsservice, page 828.

1416 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
permissions (version 5.2.5)

permissions (version 5.2.5)

Purpose
Sets permissions on objects. This component is the 5.2.5 version and cannot be launched directly. If
your custom component extends this component, it will continued to work until you migrate it to 5.3.

Parameters

objectId (Required) ID of the ACL

Description
Since
5.x

Configuration File
webcomponent\config\library\permissions\permissions_component.xml

Scope

version 5.2.5

Elements
failoverenabled
See failoverenabled, page 819.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1417
documentsubscriptionlocator

Subscriptions

documentsubscriptionlocator

Purpose
Extends the component subscriptionlocator, page 1423 and locates objects of type dm_document to
which the user has subscribed.

Parameters
The parameters are inherited from subscriptionlocator:webcomponent/config/library/locator/
subscriptionlocator_component.xml. See subscriptionlocator, page 1423.

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\documentlocators_component.xml

Parent Definition
subscriptionlocator:webcomponent/config/library/locator/subscriptionlocator_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.


columns
See columns (for data columns), page 811.

1418 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
foldersubscriptionlocator

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.


objecttype
<objecttype>dm_document</objecttype>

Specifies the object type of the objects to locate.

privatecabinet_visible
See privatecabinet_visible, page 831.

views
See views, page 839.

foldersubscriptionlocator

Purpose
Extends the component subscriptionlocator, page 1423 and locates subscribed folders.

Parameters
The parameters are inherited from subscriptionlocator:webcomponent/config/library/locator/
subscriptionlocator_component.xml. See subscriptionlocator, page 1423.

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\folderlocators_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1419
foldersubscriptionlocator

Parent Definition
subscriptionlocator:webcomponent/config/library/locator/subscriptionlocator_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.


iconwell_icon
See iconwell_icon, page 822.
objecttype
<objecttype>dm_folder</objecttype>

Specifies the object type of the objects to locate.

privatecabinet_visible
See privatecabinet_visible, page 831.
privatecabinetvisible
1 <privatecabinetvisible>true</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

views
See views, page 839.

1420 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
subscribeotherslocator

subscribeotherslocator

Purpose
Locator that displays all users except the current user; used by a user to subscribe other users to objects.

Parameters
The parameters are inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

Description

Since
5.x

Configuration File
webcomponent\config\library\subscription\subscribeotherslocator_component.xml

Parent Definition
useronlylocator:webcomponent/config/library/locator/useronlylocator_component.xml

Scope
All.

Elements
containerselectable
1 <containerselectable>false</containerselectable>

1 See containerselectable, page 814.

flatlist
1 <flatlist>true</flatlist>

1 See flatlist, page 820.

objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to locate.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1421
subscribeotherslocatorcontainer

privategroupvisible
See privategroupvisible, page 832.

views
See views, page 839.

subscribeotherslocatorcontainer

Purpose
Container for the subscribeotherslocator, page 1421 component.

Parameters

componentArgs (Required) Supplied by the LaunchComponent


action execution class.) List of arguments and
values to pass to each contained component.

Description
Since
5.x

Configuration File
webcomponent\config\library\subscription\subscribeotherslocator_component.xml

Parent Definition
useronlylocatorcontainer:webcomponent/config/library/locator/useronlylocator_component.xml

Scope
All.

Elements
None.

1422 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
subscriptionlocator

subscriptionlocator

Purpose
Extends sysobjectlocator, page 1091 and locates and displays a user’s subscriptions.

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) Type of the selected object

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\subscriptionlocator_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

columns
See columns (for data columns), page 811.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1423
subscriptions_classic (Webtop)

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


contenttypepanelvisible
1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.


filenamefiltervisible
See filenamefiltervisible, page 819.
flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.


objecttype
<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to locate.

privatecabinet_visible
See privatecabinet_visible, page 831.

privatecabinetvisible
1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.


views
See views, page 839.

subscriptions_classic (Webtop)

Purpose
Displays subscriptions of the current session user.

1424 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
subscriptions_classic (Webtop)

Description
Since
5.x

Configuration File
webtop\config\subscriptions_classic_component.xml

Parent Definition
subscriptions_list:/webcomponent/config/library/subscription/subscriptions_list_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

dragdrop
See dragdrop, page 818.

failoverenabled
This element structure is inherited from subscriptions_list:/webcomponent/config/library/
subscription/subscriptions_list_component.xml. See subscriptions_list, page 1427.
objecttype
<objecttype>dm_document</objecttype>

Specifies the object type of the objects to display.

preset_item
See preset_item, page 830.

showfilters
See showfilters, page 835.

showfolders
See showfolders, page 835.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1425
subscriptions_drilldown

subscriptions_drilldown

Purpose
Displays subscriptions of the current session user. Deprecated as of version 6.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\subscription\subscriptions_drilldown_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

dragdrop
See dragdrop, page 818.

failoverenabled
See failoverenabled, page 819.

preferences
See preferences, page 828.

1426 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
subscriptions_list

subscriptions_list

Purpose
Displays subscriptions of the current session user.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\subscription\subscriptions_list_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

dragdrop
See dragdrop, page 818.

failoverenabled
See failoverenabled, page 819.

objecttype
<objecttype>dm_document</objecttype>

Specifies the object type of the objects to display.


preset_item
See preset_item, page 830.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1427
subscriptions_streamline (Webtop)

showfilters
See showfilters, page 835.

showfolders
See showfolders, page 835.

subscriptions_streamline (Webtop)

Purpose
Extends the WDK subscriptions_drilldown component and displays subscriptions of the current
session user.

Description
Since
5.x

Configuration File
webtop\config\subscriptions_streamline_component.xml

Parent Definition
subscriptions_drilldown:/webcomponent/config/library/subscription/subscriptions_drilldown_
component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

dragdrop
See dragdrop, page 818.

1428 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
taskmgrclassic (Webtop)

failoverenabled
This element structure is inherited from subscriptions_drilldown:/webcomponent/config/library/
subscription/subscriptions_drilldown_component.xml. See subscriptions_list, page 1427.

preferences
See preferences, page 828.

Task manager

taskmgrclassic (Webtop)

Purpose
Displays the info tab in the taskmanager component group. It is the main component in the group of
task manager components, which are contained in the taskmanagercontainer component.

Parameters

objectId (Required) ID of the task.

Description
Since
5.x

Configuration File
webtop\config\taskmgrclassic_component.xml

Parent Definition
taskmanager:webcomponent/config/library/workflow/taskmanager/taskmanager_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1429
taskmgrstreamline (Webtop)

Elements
formsavefolderpath
See formsavefolderpath, page 820.
showusertimeandcost
See showusertimeandcost, page 836.
failoverenabled
This element structure is inherited from taskmanager:webcomponent/config/library/workflow/
taskmanager/taskmanager_component.xml. See taskmanager, page 1653.

taskmgrstreamline (Webtop)

Purpose
Extends the WDK taskmanager component and displays the info tab in the taskmanager component
group. It is the main component in the group of task manager components, which are contained in
the taskmanagercontainer component.

Parameters

objectId (Required) ID of the task

Description

Since
5.x

Configuration File
webtop\config\taskmgrstreamline_component.xml

Parent Definition
taskmanager:webcomponent/config/library/workflow/taskmanager/taskmanager_component.xml

1430 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
actionbuttonlisttest

Scope
All.

Elements
formsavefolderpath
See formsavefolderpath, page 820.

showusertimeandcost
See showusertimeandcost, page 836.

failoverenabled
This element structure is inherited from taskmanager:webcomponent/config/library/workflow/
taskmanager/taskmanager_component.xml. See taskmanager, page 1653.

Testing

actionbuttonlisttest

Purpose
Tests action button list controls

Parameters
None.

Description

Since
5.x

Configuration File
wdk\config\fxtest_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1431
actionbuttontest

Scope
All.

Elements
None.

actionbuttontest

Purpose
Tests action button controls

Parameters
None.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

1432 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
actionlinklisttest

actionlinklisttest

Purpose
Tests action link list controls

Parameters
None.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

actionlinktest

Purpose
Tests action link controls

Parameters
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1433
actionmenuitemtest

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

actionmenuitemtest

Purpose
Tests action menu item controls

Parameters
None.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

1434 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
actionmultiselecttest

Elements
None.

actionmultiselecttest

Purpose
Tests action multiselect controls.

Parameters
None.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

compiletest

Purpose
Tests whether a WDK Automated Test Framework test case file compiles.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1435
componentincludetest

Parameters

file (Required) Path to the test case file to compile.

Description
Since
6.0

Configuration File
webcomponent\config\testtool\compiletest_component.xml

Scope
All.

Elements
None.

componentincludetest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters
None.

Description
Since
5.x

1436 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
componenttestbed

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

componenttestbed

Purpose
Obsolete component that was used to test WDK 5.1 components.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\componentTestbed\testbed_index_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1437
componenturltest

componenturltest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters
None.

Description

Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

configservicemaintest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

1438 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
configservicetest

Parameters

folderPath (Optional) Full repository path to the folder.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

configservicetest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters

testInstructs (Optional) Instructions for testing.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1439
defineuifieldvalidation

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

defineuifieldvalidation

Purpose
For internal use only.

Parameters

controlTestId (Required) For internal use only.


optArgs (Optional) For internal use only.
uniqueFormId (Required) For internal use only.

Description

Since
6.0

Configuration File
wdk\config\test\defineuifieldvalidation_component.xml

Scope
All.

1440 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseattributeedittest

docbaseattributeedittest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters

testInstructs (Optional) Instructions for testing.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

docbaseattributelabeltest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1441
docbaseattributelistmaintest

Parameters
None.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

docbaseattributelistmaintest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters
None.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

1442 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseattributelisttest

Scope
All.

Elements
None.

docbaseattributelisttest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters
None.

Description

Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1443
docbaseattributetest

docbaseattributetest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters
None.

Description

Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

docbaseattributevalidatortest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters
None.

1444 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseattributevaluetest

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

docbaseattributevaluetest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters
None.

Description

Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1445
docbasefoldertreetest

Elements
None.

docbasefoldertreetest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters
None.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

1446 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseicontest

docbaseicontest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters
None.

Description

Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

docbaselockicontest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1447
docbaseobjectMainTest

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

docbaseobjectMainTest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters
None.

Description

Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

1448 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docbaseobjecttest

Elements
None.

docbaseobjecttest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters

lifecycleId (Optional) r_object_id of the document lifecycle


to which the object is attached.
objectId (Optional) r_object_id of the object to be tested.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1449
docbaseobjectvalidatortest

docbaseobjectvalidatortest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters

testInstructs (Optional) Instructions for testing.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

docformatvalueformattertest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

1450 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docsizevalueformattertest

Parameters
None.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

docsizevalueformattertest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

Parameters
None.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1451
iconwelltest

Scope
All.

Elements
None.

iconwelltest

Purpose
Tests the iconwell control in the dmf tag library.

Parameters

component (Required) At least one component must be


specified as the value of <iconwell>.<id> in the
component definition.

Description
Since
5.x

Configuration File
wdk\config\iconwelltest_component.xml

Scope
All.

Elements
iconwell

1 <iconwell>
2<iconwellicon>
3<id>homecabinet_classic</id>

1452 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
inspector

4<icon>icons/iconwell/iconwell_all.gif</icon>
5<label>
<nlsid>MSG_HOME_CABINET</nlsid>
</label>
6<tooltip>
<nlsid>MSG_HOME_CABINET_TIP</nlsid>
</tooltip>
</iconwellicon>
...
7<normalbgimage>images/iconwell/normalBg.gif</normalbgimage>
8<disabledbgimage>images/iconwell/disabledBg.gif</disabledbgimage>
9<selectedbgimage>images/iconwell/selectedBg.gif</selectedbgimage>
10<highlightedbgimage>images/iconwell/highlightedBg.gif</highlightedbgimage>
11<defaultid>inboxclassic</defaultid>
</iconwell>

1 Specifies icons.
2 Specifies one icon.
3 Specifies the component ID.
4 Specifies the relative path to the icon.
5 Specifies the label to display.
6 Specifies the tooltip to display.
7 Specifies the relative path to the normal background image to display.
8 Specifies the relative path to the disabled background image to display.
9 Specifies the relative path to the selected background image to display.
10 Specifies the relative path to the highlighted background image to display.
11 Specifies the default component ID..

inspector

Purpose
Provides functionality to inspect variable values resulting from test execution.

Parameters

controlTestId (Required)
optArgs (Optional)
uniqueFormId (Required)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1453
inspector

Description
Since
6.0

Configuration File
wdk\config\test\inspector_component.xml

Scope
All.

Elements
definition

<definition>
<inputassistanceinspectors>
<inspector>
<inputassistanceclass>com.documentum.web.test.validation.ui.
inputassistance.Checkbox</inputassistanceclass>
<class>com.documentum.web.test.validation.ui.inspector.CheckboxInspector</class>
<jsp>/wdk/system/test/inputassistance/checkboxInputAssistance.jsp</jsp>
</inspector>
...
</inputassistanceinspectors>
<commomcontrolvalidation>
<entry>
<field>visible</field>
<label>
<nlsid>MSG_IS_VISIBLE</nlsid>
</label>
</entry>
...
</commomcontrolvalidation>
<commomcontrolidentity>
<entry>
<field>name</field>
</entry>
...
</commomcontrolidentity>
<valuevalidation>
<entry>
<field>value</field>
<label>
<nlsid>MSG_VALUE</nlsid>
</label>
</entry>
</valuevalidation>
<dropdownlistvalidation>
<entry>
<field>size</field>

1454 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
multidocbasetreetest

<label>
<nlsid>MSG_SIZE</nlsid>
</label>
</entry>
...
</dropdownlistvalidation>
<labelvalidation>
<entry>
<field>label</field>
<label>
<nlsid>MSG_LABEL</nlsid>
</label>
</entry>
</labelvalidation>
<controls>
<control>
<class>com.documentum.web.formext.control.docbase.DocbaseAttributeLabel</class>
<validation>
<entry>
<reference>commomcontrolvalidation</reference>
</entry>
<entry>
<field>attributeLabel</field>
<label>
<nlsid>MSG_ATTRIBUTE_LABEL</nlsid>
</label>
</entry>
</validation>
<identity>
<entry>
<reference>commomcontrolidentity</reference>
</entry>
<entry>
<field>attribute</field>
</entry>
</identity>
</control>
...
</controls>
</definition>

multidocbasetreetest

Purpose
One of a set of components and actions that test controls and actions. This component is used
for internal testing at Documentum.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1455
recordertestcasevariables

Parameters
None.

Description
Since
5.x

Configuration File
wdk\config\fxtest_component.xml

Scope
All.

Elements
None.

recordertestcasevariables

Purpose
For internal use only.

Parameters

nodeId (Required) For internal use only.


ticket (Required) For internal use only.

Description

Since
5.x

1456 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
recordingurlgenerator

Configuration File
webcomponent\config\testtool\recordertestcasevariables_component.xml

Scope
All.

Elements
None.

recordingurlgenerator

Purpose
For internal use only.

Parameters

target (Required) For internal use only.


ticket (Required) For internal use only.

Description
Since
5.x

Configuration File
webcomponent\config\testtool\recordingurlgenerator_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1457
showtestcaseresult

showtestcaseresult

Purpose
For internal use only.

Parameters

file (Optional) For internal use only.


index (Required) For internal use only.
ticket (Optional) For internal use only.

Description
Since
5.x

Configuration File
webcomponent\config\testtool\showtestcaseresult_component.xml

Scope
All.

Elements
None.

showtestresult

Purpose
For internal use only.

1458 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
taborderoncomponentinclude

Parameters
None.

Description
Since
5.x

Configuration File
wdk\config\test\showtestresult_component.xml

Scope
All.

Elements
None.

taborderoncomponentinclude

Purpose
For internl use only.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\samples\samples_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1459
taborderoncomponentincludetest

Scope
All.

Elements
None.

taborderoncomponentincludetest

Purpose
For internal use only.

Parameters
None.

Description
Since
6.0

Configuration File
webcomponent\config\samples\samples_component.xml

Scope
All.

Elements
None.

1460 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
testbed

testbed

Purpose
Provides a testing environment for individual actions and components. Any action or component
from the WDK library, WDK client application library, or custom library built on WDK can be tested.
Also provides a common GUI for test automation.

Parameters

startComp (Optional) Specifies the component that will be


loaded in the content frame initially. Overrides
the value of the <startComp> element.

Description
Since
5.x

Configuration File
webcomponent\config\testbed\testbed_component.xml

Scope
All.

Elements
startComp
See startComp, page 836.
pageTitle
See pageTitle, page 827.

homeURL
See homeURL, page 822.

startQueryString
See startQueryString, page 836.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1461
testbed_generic

testbed_generic

Purpose
Provides actionlink controls for invoking the actions defined by the application. The component also
includes links to navigate to particular components or individual JSP pages. This component works
within the menubar frame of the component testbed, page 1461.

Parameters

cut (Optional) Name of component to test. Default


= attributes

Description
Since
5.x

Configuration File
webcomponent\config\componentTestbed\testbed_generic_component.xml

Scope
All.

Elements
None.

testbed (Webtop)

Purpose
Provides a testing environment for individual actions and components. Any action or component
from the WDK library, WDK client application library, Webtop library, or custom library built on WDK
and Webtop can be tested. Also provides a common GUI for test automation.

1462 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
testcaseparameters

Parameters
The parameters are inherited from testbed:webcomponent/config/testbed/testbed_component.xml.
See testbed, page 1461.

Description

Since
5.x

Configuration File
webtop\config\testbed_component.xml

Parent Definition
testbed:webcomponent/config/testbed/testbed_component.xml

Scope
All.

Elements
pageTitle
See pageTitle, page 827.

startComp
See startComp, page 836.

homeURL
See homeURL, page 822.

startQueryString
See startQueryString, page 836.

testcaseparameters

Purpose
For internal use only.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1463
testiteminfo

Parameters

nodeId (Required) For internal use only.


target (Required) For internal use only.
ticket (Required) For internal use only.

Description
Since
5.x

Configuration File
webcomponent\config\testtool\testcaseparameters_component.xml

Scope
All.

Elements
None.

testiteminfo

Purpose
For internal use only.

Parameters

type (Required) For internal use only.


value (Required) For internal use only.

1464 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
testlauncher

Description
Since
5.x

Configuration File
webcomponent\config\testtool\testiteminfo_component.xml

Scope
All.

Elements
None.

testlauncher

Purpose
For internal use only.

Parameters

docbase (Optional) For internal use only.


folderPath (Optional) For internal use only.
password (Optional) For internal use only.
username (Optional) For internal use only.

Description
Since
5.x

Configuration File
webcomponent\config\testtool\testlauncher_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1465
testlaunchermonitorticker

Scope
All.

Elements
None.

testlaunchermonitorticker

Purpose
For internal use only.

Parameters

ticket (Required) For internal use only.

Description
Since
5.x

Configuration File
webcomponent\config\testtool\testlaunchermonitorticker_component.xml

Scope
All.

Elements
None.

1466 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
testlaunchermonitortree

testlaunchermonitortree

Purpose
For internal use only.

Parameters

ticket (Required) For internal use only.

Description
Since
5.x

Configuration File
webcomponent\config\testtool\testlaunchermonitortree_component.xml

Scope
All.

Elements
None.

testlinks

Purpose
Provides actionlink controls for invoking the actions defined by the application. The component also
includes links to navigate to particular components or individual JSP pages. This component works
within the menubar frame of the component testbed, page 1461.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1467
testlinks

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\testbed\testbed_component.xml

Scope
All.

Elements
navigationlinks
See navigationlinks, page 825.

actiontable
See actiontable, page 809.

homecabinet
See homecabinet, page 822.

inbox
See inbox, page 822.

subscriptions
See subscriptions, page 837.

myobjects
See myobjects, page 825.

category
See category, page 811.
cabinets
See cabinets, page 811.

1468 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
testlinks (Webtop)

testlinks (Webtop)

Purpose
For internal use only.

Description
Since
5.x

Configuration File
webtop\config\testbed_component.xml

Parent Definition
testlinks:webcomponent/config/testbed/testbed_component.xml

Scope
All.

Elements
menupath

<menupath>/webcomponent/library/menubar/menubar_body.jsp</menupath>

homecabinet
See homecabinet, page 822.
inbox
See inbox, page 822.
subscriptions
See subscriptions, page 837.

myobjects
See myobjects, page 825.

category
See category, page 811.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1469
testmessage

cabinets
See cabinets, page 811.

navigationlinks
See navigationlinks, page 825.
actiontable
See actiontable, page 809.

testmessage

Purpose
Displays the last status message that was generated by a component in the testbed component. It also
provides simple search capability. This component loads within the message frame of the component
testbed, page 1461 and cannot be used outside the testbed component.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\testbed\testbed_component.xml

Scope
All.

Usage
To see the full list of messages, use the Message List link in the Navigation column of wdklinks.jsp.
The testbed.jsp page contains the onNewMessage() handler which reloads the testmessage component
when a new message should be displayed.

1470 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
testrecorderlauncher

Simple search is implemented using a form with a text field and button. A JavaScript function is
invoked when the form is submitted, calling the search component.

Elements
None.

testrecorderlauncher

Purpose
For internal use only.

Parameters

classname (Optional) For internal use only.


configpath (Optional) For internal use only.
docbase (Optional) For internal use only.
folderPath (Optional) For internal use only.
packagename (Optional) For internal use only.
password (Optional) For internal use only.
path (Optional) For internal use only.
testcaseId (Optional) For internal use only.
url (Optional) For internal use only.
username (Optional) For internal use only.

Description
Since
5.x

Configuration File
webcomponent\config\testtool\testrecorderlauncher_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1471
testrecorderlaunchermonitortree

Scope
All.

Elements
None.

testrecorderlaunchermonitortree

Purpose
For internal use only.

Parameters

classTicket (Required) For internal use only.


isRecording (Optional) For internal use only.
setupTicket (Required) For internal use only.
tearDownTicket (Required) For internal use only.

Description

Since
5.x

Configuration File
webcomponent\config\testtool\testrecorderlaunchermonitortree_component.xml

Scope
All.

Elements
None.

1472 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
testresultsviewer

testresultsviewer

Purpose
For internal use only.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\testtool\testresultsviewer_component.xml

Scope
All.

Elements
None.

testtool

Purpose
For internal use only.

Parameters
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1473
testxmleditor

Description
Since
5.x

Configuration File
webcomponent\config\testtool\testtool_component.xml

Scope
All.

Elements
None.

testxmleditor

Purpose
For internal use only.

Parameters

recordmode (Optional) For internal use only.


ticket (Optional) For internal use only.

Description

Since
5.x

Configuration File
webcomponent\config\testtool\testxmleditor_component.xml

Scope
All.

1474 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
unittestcase

Elements
None.

unittestcase

Purpose
Provides functionality to perform unit testing of components and actions (that is, testing without any
user interface interaction).

Parameters
None.

Description
Since
6.0

Configuration File
wdk\config\test\unitestcase_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1475
browsertree (version 6.0) (Webtop)

Trees

browsertree (version 6.0) (Webtop)

Purpose
Extends the WDK foldertree component to support custom tree nodes and browsing
through multiple Docbases. The browsertree component adds an optional entryNode
parameter, reads tree nodeconfiguration, and handles tree events. You can set the limit for
number of folders to be displayed in the tree in the file Environment.properties, located in
/WEB‑INF/classes/com/documentum/web/formext. Larger numbers will be replaced with a More
Folders link for better performance.

Since
6.5

browsertree (Webtop)

Purpose
Extends the WDK foldertree component to support custom tree nodes and browsing
through multiple Docbases. The browsertree component adds an optional entryNode
parameter, reads tree nodeconfiguration, and handles tree events. You can set the limit for
number of folders to be displayed in the tree in the file Environment.properties, located in
/WEB‑INF/classes/com/documentum/web/formext. Larger numbers will be replaced with a More
Folders link for better performance.

1476 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
browsertree (Webtop)

Parameters

entryNode (Optional) Specifies the node that is initially


selected in the browser tree.
entryObjectId (Optional) ID of the virtual document or
assembly document object associated with the
node that is to be initially selected in the browser
tree. Since 5.3 SP5.
folderPath (Optional) Specifies the folder path to
the node that is initially selected in the
browser tree. This path must be a complete
path from the Docbase root, for example,
/Documentation%20Library/subfolder

Description
Since
5.x

Configuration File
webtop\config\browsertree_component.xml

Parent Definition
foldertree:webcomponent/config/navigation/foldertree/foldertree_component.xml

Scope
All.

Usage
You cannot filter a browsertree node for repository, because all nodes are generated from a single
component configuration file. The result is that every node that is defined in the component definition
is shown for every repository.
You can configure the browsertree component to add a new component node. In your custom
component that extends the browsertree definition, add a new node by adding a <node> block. This
element does not need to contain a <handlerclass> element. The componetid attribute on the <node>
tag specifies the component to be launched when the user selects the tree node.
A simple node without a handler class cannot have custom sub‑nodes.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1477
browsertree (Webtop)

Adding a Tree Node

The following example adds a node that launches the my_coolness component when the user selects
the node in the tree:
<pages><whynot>/custom/library/whynot.jsp</whynot>
</pages>
<node componentid=my_coolness>
<startpage>mycoolpage</startpage>
<icon>reallycoolicon.gif</icon>
<label><nlsid>MSG_COOLCOMPONENT</nlsid></label>
</node>

To refresh the browser tree, fire the client event treeInvalidated in the component class that needs a
tree refresh. For example, in the JSP page classic.jsp, the client event handles the browsertree refresh:
function treeInvalidated(docbase, compId)
{
// inform the BrowserTree of a required tree refresh
window.frames["browser"].safeCall(
"postServerEvent", null, null, null, "onTreeInvalidated", "
docbase", docbase, "componentId", compId);
}

Fire this client event in your control class. For example, HomeCabinetClassicView performs the
refresh in the following way:
public void onRefreshData()
{
super.onRefreshData();
// fire a client event to refresh the WebTop Browser Tree
ArgumentList args = new ArgumentList();
args.add("docbase", getCurrentDocbase());
args.add("componentId", getComponentId());
setClientEvent("treeInvalidated", args);
}

Elements
failoverenabled
See failoverenabled, page 819.

clusteringenabled

<clusteringenabled>true</clusteringenabled>

Whether to enable (true) or disable (false) the displaying of search clusters.

nodes
See nodes, page 825.

1478 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
browsertree (Webtop)

includevirtualdocuments

<includevirtualdocuments>true</includevirtualdocuments>

Set to true to include virtual documents in the tree.


includeassemblydocuments

<includeassemblydocuments>true</includeassemblydocuments>

Set to true to include virtual document snapshots in the tree.

enableVdmExpandAll

<enableVdmExpandAll>true</enableVdmExpandAll>

Set to true to display a link to expand all nodes in the selected virtual document in the tree
enableVdmCollapseAll

<enableVdmCollapseAll>true</enableVdmCollapseAll>

Set to true to display a link to collapse all nodes in the selected virtual document in the tree.

enableTreeNodeSort

<enableTreeNodeSort>true</enableTreeNodeSort>

To enable (true) or disable the sorting of nodes.

dragdrop
See dragdrop, page 818.
preset_item
See preset_item, page 830.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1479
emptycontentclassic (Webtop)

emptycontentclassic (Webtop)

Purpose
Monitors the content frame of workarea.jsp for entryNode IDs passed from the browsertree
component. If an entryNode ID is on the request, the component generates a client‑side event that
causes the browsertree to reload and initialize the content frame with the requested content.

Parameters
None.

Description
Since
5.x

Configuration File
webtop\config\emptycontentclassic_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

emptycontentstreamline (Webtop)

Purpose
Monitors the content frame of workarea.jsp for entryNode IDs passed from the tabbar component. If
an entryNode ID is on the request, the component generates a client‑side event that causes the tabbar
to reload and initialize the content frame with the requested content.

1480 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
foldertree

Parameters
None.

Description
Since
5.x

Configuration File
webtop\config\emptycontentstreamline_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

foldertree

Purpose
The folder tree component provides basic folder navigation functionality. The user can browse
cabinets and folders. Failover is enabled for foldertree. This component is extended by the Webtop
browsertree component.

Parameters

folderPath (Optional) Specifies the path to the folder that


serves as the base for navigation. This path must
be a complete path from the repository root, for
example, /Documentation/Library/subfolder

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1481
errormessage

Description
Since
5.x

Configuration File
webcomponent\config\navigation\foldertree\foldertree_component.xml

Scope
All.

Usage
You can set the limit for number of folders to be displayed in the tree in the file Environment.properties,
located in /WEB‑INF/classes/com/documentum/web/formext. Larger numbers will be replaced with
a More Folders link.
The folder tree component class FolderTree has a single method: onInit(ArgumentList args). This
method gets the folder path parameter if it is supplied as an argument, and sets the base for navigation
to the supplied path or to the root path as supplied by the DocbaseFolderTree control. The control
docbasefoldertree, page 301 must be present in the foldertree component JSP page.

Elements
failoverenabled
See failoverenabled, page 819.

User feedback

errormessage

Purpose
The errormessage component displays a fatal error message, which appears in a popup dialog box if
and when the error message handler receives a fatal error.

Parameters
None.

1482 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
informinvalidaction

Description
Since
5.x

Configuration File
wdk\config\errormessage_component.xml

Scope
All.

Elements
displaystacktrace

<displaystacktrace>true</displaystacktrace>

Set to true to display the stack trace in an error message.

failoverenabled
See failoverenabled, page 819.

informinvalidaction

Purpose
Displays an error message indicating that the action that uses a dynamic filter is not valid for the
specified object.

Since
6.5

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1483
informinvalidactionformessagearchive

informinvalidactionformessagearchive

Purpose
Displays an error message indicating that the action that uses a dynamic filter is not valid for a
dm_message_archive object.

Since
6.5

informinvalidactionformessagearchiveattach

Purpose
Displays an error message indicating that the action that uses a dynamic filter is not valid for a
dm_message_archive object’s attachments.

Since
6.5

informinvalidactionformultiobjects

Purpose
Displays an error message indicating that the action that the user attempted to perform is not valid for
multiple objects.

Parameters
None.

1484 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
informinvalidactionforreference

Description
Since
5.x

Configuration File
webcomponent\config\library\informinvalidaction\informinvalidactionformultiobjects_component.
xml

Scope
All.

Elements
None.

informinvalidactionforreference

Purpose
Launched by certain actions that use a dynamic filter to display a message to the user that the action is
invalid for the selected reference object.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\library\informinvalidaction\informinvalidactionforreference_component.
xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1485
informinvalidactionforreplica

Scope
All.

Usage
For actions that should not be performed on reference objects, add a dynamic filter to the action
definition and list the action as notdefined for the scope foreign. To create a dynamic filter in the action
definition, see ʺDynamic Component Launching in Web Development Kit Development Guide. To specify
the action as notdefined, create an XML file in the /custom/config directory or a subdirectory with
the following type of entries:
<scope type="foreign">
<!­­ disabled actions ­­>
<action id="versions" notdefined="true"></action>
<action id="relationships" notdefined="true"></action>
...
</scope>

Elements
None.

informinvalidactionforreplica

Purpose
Launched by certain actions that use a dynamic filter to display a message to the user that the action is
invalid for the selected replicated object.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\library\informinvalidaction\informinvalidactionforreplica_component.xml

1486 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
messages

Scope
All.

Usage
For actions that should not be performed on replica objects, add a dynamic filter to the action
definition and list the action as notdefined for the scope foreign. To create a dynamic filter in the action
definition, see Dynamic Component Launching in Web Development Kit Development Guide. To specify
the action as notdefined, create an XML file in the /custom/config directory or a subdirectory with
the following type of entries:
<scope type="foreign">
<!­­ disabled actions ­­>
<action id="versions" notdefined="true"></action>
<action id="relationships" notdefined="true"> </action>
...

Elements
None.

messages

Purpose
Displays a data grid of all the user’s messages for a session. The error message service passes non‑fatal
error messages to the messages component for display.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\messages\messages_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1487
messagebar (Webtop)

Scope
All.

Usage
The messages component uses the message service to get the result set of messages and initialize a
data grid with the result set. For example:
Datagrid msgGrid = (Datagrid)getControl(
CONTROL_GRID, Datagrid.class);
ResultSet res = MessageService.getResultSet();
msgGrid.getDataProvider().setScrollableResultSet((
ScrollableResultSet)res)

Elements
None.

messagebar (Webtop)

Purpose
Loads into the left side of the status frame in classicview.jsp and streamlineview.jsp, part of the UI
of the component main (Webtop), page 900. The messagebar adds a message bar icon in the bottom
frame in both the class and streamline view of Webtop. The message bar gets messages from the
message service and renders them in the label.

Parameters
None.

Description
Since
5.x

Configuration File
webtop\config\messagebar_component.xml

1488 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
modalerrordialog

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

ignoreformloadforcomponent

1 <ignoreformloadforcomponent>
2<name>messagebar</name>
...
</ignoreformloadforcomponent>

1 Contains one ore more <name> elements


2 Specifies the ID of a component that will not clear the message bar when the component is rendered.

modalerrordialog

Purpose
This component provides the UI used to present modal error dialogs to the user.

Parameters

forceModal (Optional) Boolean: If this component is being


directed to a non‑modal frame, set to true to set
up the forced modality infrastructure.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1489
prompt

Configuration File
webcomponent\config\library\modalerrordialog\modalerrordialog_component.xml

Scope
All.

Elements
None.

prompt

Purpose
Provides the functionality of a message box. A prompt has a title, a message, and a selection of buttons:
OK, Cancel, Continue, Yes, No, Yes to all, No to all, and Help, any combination of which can be
displayed. There is also an optional icon and ʺDon’t show this againʺ checkbox. The don’t show again
feature is enabled only when the prompt component is used within the combocontainer component.

Parameters

button (Required) The name of the button that will be


displayed. Multiple values may be passed.
dontshowagain (Optional) Boolean flag to display a checkbox
that will hide the prompt the next time the
context of the prompt occurs. The actual
handling of this flag must be implemented in the
caller component.
icon (Optional) Name of icon class.
message (Optional) String message in the prompt frame.
title (Optional) String title for the prompt frame.

Description
Since
5.x

1490 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
prompt

Configuration File
wdk\config\prompt_component.xml

Scope
All.

Usage
The prompt component can either be extended, in order to set the message and title or modify its
behavior, or the component can be driven directly through arguments. In the following example,
the prompt component is nested within another component, and the user is returned to the parent
component after responding to the prompt:
ArgumentList args = new ArgumentList();
args.add(Prompt.ARG_TITLE, getString(strTitleId));
args.add(Prompt.ARG_MESSAGE, getString(strMessageId));
args.add(Prompt.ARG_ICON, Prompt.ICON_WARNING);
args.add(Prompt.ARG_BUTTONS, Prompt.CONTINUE + "," +
Prompt.CANCEL);
args.add(Prompt.ARG_DONTSHOWAGAIN,
"true");
setComponentNested("prompt", args, getContext());

For an example of the usage of the prompt component, see the combo container. The prompt
component is displayed when a user clicks OK before the last page has been displayed.

Handling DONTSHOWAGAIN
If you want to give the user the option of turning off the prompt when the prompt context arises, your
calling component must set the dontshowagain argument and then handle the user’s selection. You
should store the selection as a preference and retrieve it in your component.
The following example sets up the prompt component based on the user’s preference:
public void onEvent(Control control, ArgumentList args)
{
...
// display prompt conditionally
if (showPrompt())
// see helper below
{
ArgumentList args = new ArgumentList();
args.add(Prompt.ARG_TITLE, getString(TITLE));
args.add(Prompt.ARG_MESSAGE, getString(MESSAGE));
args.add(Prompt.ARG_ICON, Prompt.ICON_WARNING);
args.add(Prompt.ARG_BUTTONS, Prompt.CONTINUE + "," +
Prompt.CANCEL);
args.add(Prompt.ARG_DONTSHOWAGAIN, "true");
setComponentNested("prompt", args, getContext());
}
}

The helper method gets the user preference:


private boolean showPrompt()

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1491
prompt

{
IPreferenceStore preferences = PreferenceService.
getPreferenceStore();
return (preferences.readBoolean(
INHIBIT_PROMPT_PREFERENCE) == null);
}
// unique preference string
final private static String INHIBIT_PROMPT_PREFERENCE
= " com.documentum...";

The component onRender() method checks the prompt return and whether to inhibit or show the
prompt:
public void onRender()
{
...
// check whether the prompt has returned
String strButton = (String)getReturnedValue(
Prompt.RTN_BUTTON);
String strDontShowAgain = (String)getReturnedValue(
Prompt.RTN_DONTSHOWAGAIN);

if (strButton != null || strDontShowAgain != null)


{
// remove return values
removeReturnedValue(Prompt.RTN_BUTTON);
removeReturnedValue(Prompt.RTN_DONTSHOWAGAIN);
if ( strButton.equals(Prompt.CONTINUE) )
{
// inhibit prompt if 'dont show again' was selected
if ( strDontShowAgain != null && Boolean.valueOf(
strDontShowAgain).booleanValue())
{
inhibitPrompt();
// see inhibitPrompt() helper below
}
// perform task
}
}
}

Another helper method writes the preference:


private void inhibitPrompt()
{
IPreferenceStore preferences = PreferenceService.
getPreferenceStore();
preferences.writeBoolean(
INHIBIT_PROMPT_PREFERENCE, Boolean.TRUE);
}

Elements
None.

1492 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
promptinput

promptinput

Purpose
Prompts users for input.

Parameters

input (Required) Text that users enter.


message (Optional) Text that is displayed requesting
input from users.
values (Optional) Valid values that users can choose.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\promptinput_component.xml

Scope
All.

Elements
None.

promptinputcontainer

Purpose
Container for components that prompt users for input.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1493
promptinputcontainer

Parameters

component (Required) Supplied by the action execution


class). The name of the component to contain.
input (Required) Text that users enter.
message (Optional) Text that is displayed requesting
input from users.
values (Optional) Valid values that users can choose.

Description
Since
5.x

Configuration File
webcomponent\config\library\contenttransfer\promptinputcontainer_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

1494 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
statusbar (Webtop)

statusbar (Webtop)

Purpose
Displays a status message in statusbar.jsp, which is the source page for the bottom frame in both the
class and streamline view of Webtop. The status bar displays a button to show all messages and
tabs that toggle between the classic and streamline views. The error messages are passed in from
the message service.

Parameters
None.

Description
Since
5.x

Configuration File
webtop\config\statusbar_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1495
adminuserorgrouplocator

Users, groups, and roles

adminuserorgrouplocator

Purpose
Locates users and groups in a repository.

Parameters
The parameters are inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

Description

Since
5.x

Configuration File
webcomponent\config\admin\adminuserorgrouplocator\adminuserorgrouplocator_component.xml

Parent Definition
userorgrouplocator:webcomponent/config/library/locator/userorgrouplocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

1496 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
adminuserorgrouplocatorcontainer

failoverenabled
This element structure is inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.


iconwell_icon
See iconwell_icon, page 822.
objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to locate.

preset_item
See preset_item, page 830.

privategroupvisible
See privategroupvisible, page 832.

views
See views, page 839.

workqueuegroupvisible
See workqueuegroupvisible, page 841.

adminuserorgrouplocatorcontainer

Purpose
Locates users and groups in a repository.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1497
groupattributes

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) Type of the selected object

Description
Since
5.x

Configuration File
webcomponent\config\admin\adminuserorgrouplocator\adminuserorgrouplocator_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

groupattributes

Purpose
Creates a new user profile and edits existing user groups.

1498 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
groupdelete

Parameters

objectId (Required) The ID of the selected group.


objectname (Required) The name of the selected group.

Description

Since
5.x

Configuration File
webcomponent\config\admin\group\groupattributes_component.xml

Scope
All.

Elements
None.

groupdelete

Purpose
Deletes an existing user group. Warns the administrator about the repercussions of performing this
task and offers alternative solutions.

Parameters

objectId (Required) The ID of the group to delete.


objectname (Required) The name of the group to delete.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1499
grouplist

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\groupdelete_component.xml

Scope
All.

Elements
None.

grouplist

Purpose
Displays a list of all user groups present in the repository. It provides the ability to drill down in a
group to view all the users and groups within the group.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\admin\group\grouplist_component.xml

Scope
All.

1500 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
grouplocator

Usage
To preserve repository consistency, do not remove groups from the repository. Remove all members
of the group and leave the empty group in the repository. When you delete a group, the server
does not remove the group’s name from objects in the repository, such as ACLs and other groups.
You can delete a group, and then create a group with the same name. If you create a new group
with the same name as a deleted group, the new group inherits the group memberships and object
permissions belonging to the deleted group.

Elements
showbreadcrumb
See showbreadcrumb, page 835.

grouplocator

Purpose
Displays a list of groups in the repository.

Parameters
The parameters are inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\grouplocator_component.xml

Parent Definition
userorgrouplocator:webcomponent/config/library/locator/userorgrouplocator_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1501
grouplocator

Elements
columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


failoverenabled
This element structure is inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.


iconwell_icon
See iconwell_icon, page 822.

objecttype
<objecttype>dm_group</objecttype>

Specifies the object type of the objects to locate.

preset_item
See preset_item, page 830.
privategroupvisible
See privategroupvisible, page 832.
views
See views, page 839.

workqueuegroupvisible
See workqueuegroupvisible, page 841.

1502 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
grouplocatorcontainer

grouplocatorcontainer

Purpose
Extends the container locatorcontainer, page 1081 and contains one or more grouplocator, page 1501.

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\grouplocator_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

groupproperties

Purpose
Extends the container adminpropertycontainer, page 843 and displays properties components for the
selected group. It overrides some of the behavior from the adminpropertycontainer component. and
contains groupattributes, page 1498.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1503
grouprename

Parameters

objectId (Required) The ID of the group to delete.


objectname (Required) The name of the group to delete.

Description

Since
5.x

Configuration File
webcomponent\config\admin\group\groupproperties_component.xml

Parent Definition
adminpropertycontainer:webcomponent/config/admin/container/adminpropertycontainer_
component.xml

Scope
All.

Elements
objecttype
<objecttype>dm_group</objecttype>

Specifies the object type of the objects to display.

grouprename

Purpose
Reassigns an existing group. The administrator can reassign all the objects owned by the current
group and generate an exhaustive report.

1504 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
groupwhereused

Parameters

objectId (Required) The ID of the group to delete.


objectname (Required) The name of the group to delete.

Description

Since
5.x

Configuration File
webcomponent\config\admin\group\grouprename_component.xml

Scope
All.

Elements
None.

groupwhereused

Purpose
Lists the locations where the selected group is being used; for example, it lists all sysobjects owned
by the group, acls in which the group exists, and workflows for which the group is a designated
performer.

Parameters

objectId (Required) Object ID of the group to locate.


objectname (Required) Object name of the group to locate.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1505
recentgrouplocator

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\groupwhereused_component.xml

Scope
All.

Elements
None.

recentgrouplocator

Purpose
Extends recentuserorgrouplocator, page 1509 and locates user groups that were recently selected or
used. This component has no scope, but <objecttype> element restricts the search to dm_group objects.

Parameters
The parameters are inherited from recentuserorgrouplocator:webcomponent/config/library/locator/
recentuserorgrouplocator_component.xml. See recentuserorgrouplocator, page 1509.

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\grouplocator_component.xml

1506 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
recentuseronlylocator

Parent Definition
recentuserorgrouplocator:webcomponent/config/library/locator/recentuserorgrouplocator_
component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.
failoverenabled
This element structure is inherited from recentuserorgrouplocator:webcomponent/config/library/
locator/recentuserorgrouplocator_component.xml. See recentuserorgrouplocator, page 1509.

iconwell_icon
See iconwell_icon, page 822.

objecttype
<objecttype>dm_group</objecttype>

Specifies the object type of the objects to locate.

views
See views, page 839.

recentuseronlylocator

Purpose
Extends recentuserorgrouplocator, page 1509 and locates users that were recently selected or changed.
This component has no scope, but the <objecttype> element restricts the search to objects of type
dm_user.

Parameters
The parameters are inherited from recentuserorgrouplocator:webcomponent/config/library/locator/
recentuserorgrouplocator_component.xml. See recentuserorgrouplocator, page 1509.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1507
recentuseronlylocator

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\useronlylocator_component.xml

Parent Definition
recentuserorgrouplocator:webcomponent/config/library/locator/recentuserorgrouplocator_
component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

failoverenabled
This element structure is inherited from recentuserorgrouplocator:webcomponent/config/library/
locator/recentuserorgrouplocator_component.xml. See recentuserorgrouplocator, page 1509.
iconwell_icon
See iconwell_icon, page 822.

objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to locate.

useronly
See useronly, page 838.

views
See views, page 839.

1508 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
recentuserorgrouplocator

recentuserorgrouplocator

Purpose
Extends objectlocator, page 1085 and locates users or groups that were recently selected or modified.
This component has no scope, but the <objecttype> element restricts the search to objects of type
dm_user or dm_group.

Parameters

multiselect (Optional) Boolean: Set to true to support


multiple selection.
objecttype (Optional) Object type to display in the list.

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\recentuserorgrouplocator_component.xml

Parent Definition
objectlocator:webcomponent/config/library/locator/objectlocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1509
renamegrouplist

failoverenabled
See failoverenabled, page 819.

flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.


iconwell_icon
See iconwell_icon, page 822.
objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to locate.

useronly
See useronly, page 838.

views
See views, page 839.

renamegrouplist

Purpose
Extends renamejobrequestlist, page 1223 and displays job requests for rename user or group.

Parameters

renametarget (Optional) Type of objects requested for rename.


Valid values: USER | GROUP

Description

Since
5.x

1510 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
renamereport

Configuration File
webcomponent\config\admin\renamelog\renamegrouplist_component.xml

Parent Definition
renamejobrequestlist:webcomponent/config/admin/renamelog/renamejobrequestlist_component.xml

Scope
All.

Elements
None.

renamereport

Purpose
Displays job requests for rename user or group.

Parameters

objectId (Required) ID of the selected report


oldname (Optional) Name of the report before rename

Description
Since
5.x

Configuration File
webcomponent\config\admin\renamelog\renamereport_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1511
renameuserlist

Elements
None.

renameuserlist

Purpose
Extends renamejobrequestlist, page 1223 and displays job requests for renaming users.

Parameters

renametarget (Optional) Type of objects requested for rename.


Valid values: USER | GROUP

Description

Since
5.x

Configuration File
webcomponent\config\admin\renamelog\renameuserlist_component.xml

Parent Definition
renamejobrequestlist:webcomponent/config/admin/renamelog/renamejobrequestlist_component.xml

Scope
All.

Elements
None.

1512 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
roleattributes

roleattributes

Purpose
Extends the component groupattributes, page 1498 and displays a list of attributes of a role (dm_group
object with attributes group_class=ʺroleʺ and group_name=ʺ role_nameʺ).

Parameters
The parameters are inherited from groupattributes:webcomponent/config/admin/group/
groupattributes_component.xml. See groupattributes, page 1498.

Description
Since
5.x

Configuration File
webcomponent\config\admin\role\roleattributes_component.xml

Parent Definition
groupattributes:webcomponent/config/admin/group/groupattributes_component.xml

Scope
All.

Elements
None.

rolelist

Purpose
Extends the component grouplist, page 1500 and displays a list of objects of type dm_group with
attributes group_class=ʺroleʺ and group_name=ʺ role_nameʺ. This component is a node in the
usermanagement, page 1522 component.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1513
roleproperties

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\admin\role\rolelist_component.xml

Parent Definition
grouplist:webcomponent/config/admin/group/grouplist_component.xml

Scope
All.

Elements
showbreadcrumb
See showbreadcrumb, page 835.

roleproperties

Purpose
Extends the container adminpropertycontainer, page 843 and displays a list of object attributes of
type dm_group with attributes group_class=ʺroleʺ and group_name=ʺ role_nameʺ. Contains the
roleattributes component.

1514 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
useraclobjectlocator

Parameters

objectId (Required) ID of the object for which properties


are displayed. Set to newobject to create a new
role.
objectname (Required) Name of the object.

Description
Since
5.x

Configuration File
webcomponent\config\admin\role\roleproperties_component.xml

Parent Definition
adminpropertycontainer:webcomponent/config/admin/container/adminpropertycontainer_
component.xml

Scope
All.

Elements
objecttype
<objecttype>dm_group</objecttype>

Specifies the object type of the objects to display.

useraclobjectlocator

Purpose
Browses for ACLs that are owned by the user.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1515
useraclobjectlocator

Parameters
The parameters are inherited from aclobjectlocator:webcomponent/config/library/locator/
aclobjectlocator_component.xml. See aclobjectlocator, page 1402.

Description

Since
5.x

Configuration File
webcomponent\config\admin\user\useraclobjectlocator_component.xml

Parent Definition
aclobjectlocator:webcomponent/config/library/locator/aclobjectlocator_component.xml

Scope
All.

Elements
attributes
See attributes, page 810.

columns
See columns (for data columns), page 811.

failoverenabled
This element structure is inherited from aclobjectlocator:webcomponent/config/library/locator/
aclobjectlocator_component.xml. See aclobjectlocator, page 1402.

iconwell_icon
See iconwell_icon, page 822.
objecttype
<objecttype>dm_acl</objecttype>

Specifies the object type of the objects to locate.

preset_item
See preset_item, page 830.

1516 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
useraclobjectlocatorcontainer

views
See views, page 839.

useraclobjectlocatorcontainer

Purpose
Browses for ACLs that are owned by the user. The container extends the container aclobjectlocator,
page 1402.

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\useraclobjectlocator_component.xml

Parent Definition
aclobjectlocatorcontainer:webcomponent/config/library/locator/aclobjectlocator_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1517
userattributes

userattributes

Purpose
Creates new user profiles and edits existing user profiles. Administrators can set all the attributes of
the user object, such as name, email, privileges, and default group.

Parameters

objectId (Required) Object ID of the user object whose


attributes to set.
objectname (Required) Object name of the user object whose
attributes to set.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\userattributes_component.xml

Scope
All.

Elements
None.

userchangehomedblist

Purpose
Displays user change home repository job requests and their status.

1518 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
userchangestate

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\admin\renamelog\userchangehomedblist_component.xml

Scope
All.

Elements
None.

userchangestate

Purpose
Changes the state of the user. When the administrator changes the state of the user from active to
inactive, this component offers the choice of unlocking all objects locked by the user.

Parameters

objectId (Required) Object ID of the user object whose


state to change.
objectname (Required) Object name of the user object whose
state to change.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1519
userdelete

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\userchangestate_component.xml

Scope
All.

Elements
None.

userdelete

Purpose
Deletes an existing user profile from the repository. The component warns the administrator of the
repercussions of performing this task and offers alternative solutions.

Parameters

objectId (Required) Object ID of the user object to delete.


objectname (Required) Object name of the user object to
delete.

Description

Since
5.x

Configuration File
webcomponent\config\admin\user\userdelete_component.xml

1520 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
userimport

Scope
All.

Elements
None.

userimport

Purpose
Imports users through a LDIFF (list difference) utility. The administrator can select the ldiff format file
containing information about all the users. The component also offers the choice of overriding any of
the user attributes. The component must run within the userimportcontainer.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\userimport_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1521
userlist

userlist

Purpose
Searches for a user or pages through a list of all the users in the repository.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\userlist_component.xml

Scope
All.

Elements
showbreadcrumb
See showbreadcrumb, page 835.

usermanagement

Purpose
Extends nodemanagement, page 844 and defines the subnodes (components) of the usermanagement
node: userlist, grouplist, and rolelist

1522 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
useronlylocator

Parameters
The parameters are inherited from nodemanagement:webcomponent/config/admin/nodemanagement/
nodemanagement_component.xml. See nodemanagement, page 844.

Description

Since
5.x

Configuration File
webcomponent\config\admin\usermanagement\usermanagement_component.xml

Parent Definition
nodemanagement:webcomponent/config/admin/nodemanagement/nodemanagement_component.
xml

Scope
All.

Elements
None.

useronlylocator

Purpose
Locates users in a repository. The component allows users to navigate from user groups to find a user.
This component extends userorgrouplocator, page 1526.

Parameters
The parameters are inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1523
useronlylocator

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\useronlylocator_component.xml

Parent Definition
userorgrouplocator:webcomponent/config/library/locator/userorgrouplocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

containerselectable
1 <containerselectable>false</containerselectable>

1 See containerselectable, page 814.

failoverenabled
This element structure is inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.


iconwell_icon
See iconwell_icon, page 822.
objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to locate.

preset_item
See preset_item, page 830.

1524 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
useronlylocatorcontainer

privategroupvisible
See privategroupvisible, page 832.

views
See views, page 839.
workqueuegroupvisible
See workqueuegroupvisible, page 841.

useronlylocatorcontainer

Purpose
Extends locatorcontainer, page 1081 and contains user locators: useronlylocator, page 1523 and
recentuseronlylocator, page 1507.

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\useronlylocator_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1525
userorgrouplocator

Elements
multidocbasesupport
See multidocbasesupport, page 825.

userorgrouplocator

Purpose
Extends objectlocator, page 1085 and locates users and groups in a repository.

Parameters

arrangeselect (Optional) Boolean: Set to true to allow selection


of users and groups in a sequential order.
flatlist (Optional) Boolean: Set to true to list users and
groups in a flat list, set to false to display users
and groups in a drop‑down list.
multiselect (Optional) Boolean: Set to true to support
multiple user/group selection.
objecttype (Optional) Type of the selected object.

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\userorgrouplocator_component.xml

Parent Definition
objectlocator:webcomponent/config/library/locator/objectlocator_component.xml

Scope
All.

1526 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
userorgrouplocator

Elements
columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


failoverenabled
See failoverenabled, page 819.

flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.

iconwell_icon
See iconwell_icon, page 822.
objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to locate.

preset_item
See preset_item, page 830.

privategroupvisible
See privategroupvisible, page 832.

views
See views, page 839.

workqueuegroupvisible
See workqueuegroupvisible, page 841.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1527
userorgrouplocatorcontainer

userorgrouplocatorcontainer

Purpose
Extends locatorcontainer, page 1081 and contains the locator components userorgrouplocator, page
1526 and recentuserorgrouplocator, page 1509.

Parameters

arrangeselect (Optional) Boolean: Set to true to allow selection


of objects in a sequential order.
flatlist (Optional) Boolean: Set to true to list all objects
in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) Type of the selected object
selectedobjectids (Optional) IDs of the objects selected when the
component is displayed

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\userorgrouplocator_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

1528 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
userorgroupmemberlocator

multidocbasesupport
See multidocbasesupport, page 825.

userorgroupmemberlocator

Purpose
Extends userorgrouplocator, page 1526 and locates users and group members in a repository.

Parameters
The parameters are inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\userorgroupmemberlocator_component.xml

Parent Definition
userorgrouplocator:webcomponent/config/library/locator/userorgrouplocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1529
userorgroupmemberlocatorcontainer

failoverenabled
This element structure is inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.


iconwell_icon
See iconwell_icon, page 822.
objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to locate.

preset_item
See preset_item, page 830.

privategroupvisible
See privategroupvisible, page 832.

views
See views, page 839.

workqueuegroupvisible
See workqueuegroupvisible, page 841.

userorgroupmemberlocatorcontainer

Purpose
Extends userorgrouplocatorcontainer, page 1528 and contains the locator components
userorgroupmemberlocator, page 1529 and recentuserorgrouplocator, page 1509.

1530 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
userproperties

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) Type of the selected object

Description
Since
5.x

Configuration File
webcomponent\config\admin\group\userorgroupmemberlocator_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

userproperties

Purpose
Extends adminpropertycontainer, page 843 and overrides some of the behavior of the container.
Contains userattributes, page 1518.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1531
userrename

Parameters

objectId (Required) Object ID of the user.


objectname (Required) Object name of the user.

Description

Since
5.x

Configuration File
webcomponent\config\admin\user\userproperties_component.xml

Parent Definition
adminpropertycontainer:webcomponent/config/admin/container/adminpropertycontainer_
component.xml

Scope
All.

Elements
objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to display.

userrename

Purpose
Reassigns an existing user. The administrator is offered choices such as reassigning all the objects
owned by the current user and generating a report.

1532 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
userwhereused

Parameters

objectId (Required) Object ID of the user to rename.


objectname (Required) Current object name of the user.

Description

Since
5.x

Configuration File
webcomponent\config\admin\user\userrename_component.xml

Scope
All.

Elements
None.

userwhereused

Purpose
Finds where a selected user has activity, for example, all sysobjects owned by the user, groups in which
the user exists, and workflows for which the user is a designated performer.

Parameters

objectname (Required) Name of the user

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1533
assemblylist

Description
Since
5.x

Configuration File
webcomponent\config\admin\user\userwhereused_component.xml

Scope
All.

Elements
None.

Virtual document assemblies

assemblylist

Purpose
Displays the structure of a virtual document snapshot. The user can navigate to the different parts of
the virtual document snapshot by clicking on the breadcrumb or the child node. This component has
an extended version in Webtop called assemblylist.

Parameters
The parameters are inherited from vdmlist:webcomponent/config/navigation/vdm/vdmlist_
component.xml. See vdmlist, page 1560.

Description
Since
5.x

1534 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
assemblylist (Webtop)

Configuration File
webcomponent\config\navigation\vdm\assemblylist_component.xml

Parent Definition
vdmlist:webcomponent/config/navigation/vdm/vdmlist_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

default_binding_filter_values
See default_binding_filter_values, page 815.

dragdrop
See dragdrop, page 818.

preset_item
See preset_item, page 830.

assemblylist (Webtop)

Purpose
Displays the structure of a virtual document snapshot. The user can navigate to the different parts of
the virtual document snapshot by clicking on the breadcrumb or the child node.

Parameters
The parameters are inherited from vdmlist:webcomponent/config/navigation/vdm/vdmlist_
component.xml. See vdmlist, page 1560.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1535
assemblyliststreamline

Description
Since
6.0

Configuration File
webtop\config\assemblylist_component.xml

Parent Definition
assemblylist:webcomponent/config/navigation/vdm/assemblylist_component.xml

Scope
All.

Elements
dragdrop
See dragdrop, page 818.

assemblyliststreamline

Purpose
Displays a list of virtual document snapshots in drilldown (streamline) view.

Parameters
The parameters are inherited from vdmliststreamline:webcomponent/config/navigation/vdm/
vdmliststreamline_component.xml. See vdmliststreamline, page 1563.

Description
Since
5.x

Configuration File
webcomponent\config\navigation\vdm\assemblyliststreamline_component.xml

1536 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
assemblyliststreamline (Webtop)

Parent Definition
vdmliststreamline:webcomponent/config/navigation/vdm/vdmliststreamline_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

default_binding_filter_values
See default_binding_filter_values, page 815.

dragdrop
See dragdrop, page 818.

assemblyliststreamline (Webtop)

Purpose
Displays a list of virtual document snapshots in drilldown (streamline) view.

Parameters
The parameters are inherited from vdmliststreamline:webcomponent/config/navigation/vdm/
vdmliststreamline_component.xml. See vdmliststreamline, page 1563.

Description
Since
6.0

Configuration File
webtop\config\assemblyliststreamline_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1537
newassembly

Parent Definition
assemblyliststreamline:webcomponent/config/navigation/vdm/assemblyliststreamline_component.
xml

Scope
All.

Elements
dragdrop
See dragdrop, page 818.

newassembly

Purpose
Creates a new virtual document snapshot. The user must have a contributor role assigned in the
repository. The container extends newdoccontainer and contains the newassembly component as well
as the attributes and permissions components, to set attributes and permissions on the new snapshot.

Parameters

folderId (Optional) ID of the folder in which to create the


assembly
nodeId (Optional) ID of root node in the virtual
document
objectId (Required) ID of the virtual document.

Description
Since
5.x

Configuration File
webcomponent\config\library\vdm\newassembly\newassembly_component.xml

1538 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newassemblycontainer

Scope
All.

Elements
None.

newassemblycontainer

Purpose
Contains component used to create a new assembly and set its attributes and permissions.

Parameters
The parameters are inherited from newdoccontainer:webcomponent/config/library/create/
newdoccontainer_component.xml. See newdoccontainer, page 1061.

Description

Since
5.x

Configuration File
webcomponent\config\library\vdm\newassembly\newassemblycontainer_component.xml

Parent Definition
newdoccontainer:webcomponent/config/library/create/newdoccontainer_component.xml

Scope
All.

Elements
newcomponentname
See newcomponentname, page 825.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1539
viewassemblies

numberedtabs
See numberedtabs, page 827.

viewassemblies

Purpose
Displays a list of all assemblies that contain a specified object

Parameters

assembledFromId (Optional) ID of the virtual document from


which the assembly was assembled
folderId (Optional) Specifies the ID of the primary
location for the folder in which the assembly is
located
folderPath (Optional) Specifies the path to the folder in
which to start browsing. This path must be
a complete path from the Docbase root, for
example, /Documentation%20Library/subfolder
isVirtualDoc (Optional) Boolean flag that specifies whether
the object is a virtual document (required for
pre‑4.1 repository virtual documents)
linkCount (Optional) Number of links (child nodes) in a
document. If greater than 0, the document is a
virtual document.
objectId (Required) ID of the assembly to view

Description
Since
5.x

Configuration File
webcomponent\config\library\vdm\viewassemblies\viewassemblies_component.xml

1540 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
viewassemblies (Webtop)

Parent Definition
objectgrid:/webcomponent/config/navigation/objectgrid/objectgrid_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

header
See header, page 821.

nondocbasecolumns
See nondocbasecolumns, page 826.

viewassemblies (Webtop)

Purpose
Displays a list of all assemblies that contain a specified object.

Parameters
The parameters are inherited from viewassemblies:/webcomponent/config/library/vdm/
viewassemblies/viewassemblies_component.xml. See viewassemblies, page 1540.

Description
Since
5.x

Configuration File
webtop\config\viewassemblies_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1541
addchildsysobjectlocator

Parent Definition
viewassemblies:/webcomponent/config/library/vdm/viewassemblies/viewassemblies_component.xml

Scope
All.

Elements
None.

Virtual documents

addchildsysobjectlocator

Purpose
Locates sysobjects to add to a virtual document. Two types of views are supported: flatlist, in which
all selectable objects in the repository are shown, and hierarchical, in which the user can drill down
from a list of root container (cabinets).

Parameters

flatlist (Optional) Boolean: Set to true to display a flat


list of all selectable objects.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) Type of the selected object

Description
Since
5.x

1542 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
addchildsysobjectlocator

Configuration File
webcomponent\config\library\vdm\addcomponent\addchildsysobjectlocator_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>false</containerselectable>

1 See containerselectable, page 814.


contenttypepanelvisible
1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.

filenamefiltervisible
See filenamefiltervisible, page 819.

objecttype
<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to locate.

privatecabinetvisible
1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.


views
See views, page 839.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1543
addchildsysobjectlocatorcontainer

addchildsysobjectlocatorcontainer

Purpose
Locates sysobjects to add to a virtual document. Two types of views are supported: flatlist, in which
all selectable objects in the repository are shown, and hierarchical, in which the user can drill down
from a list of root container (cabinets).

Parameters

flatlist (Optional) Boolean: Set to true to list all objects in


a flat list, set to false to display a drop‑down list
multiselect (Required) Boolean. Set to true to support
multiple object selection.
objecttype (Optional) Type of the selected object

Description
Since
5.x

Configuration File
webcomponent\config\library\vdm\addcomponent\addchildsysobjectlocatorcontainer_
component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

1544 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
addnewvirtualdocumentnode (type dm_sysobject)

addnewvirtualdocumentnode (type dm_sysobject)

Purpose
Adds a new node to a virtual document, enabling the user to create the content of the node.

Parameters

lockOwner (Optional) Name of object owner


nodeId (Optional) Node ID of the parent node under
which to add the new content.
objectId (Required) Object ID of the parent object.
vdmRootObjectId (Optional) Object ID of the root of the virtual
document.

Description
Since
5.x

Configuration File
webcomponent\config\library\vdm\addcomponent\addnewvirtualdocumentnode_component.xml

Scope

type dm_sysobject

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1545
addvirtualdocumentnode (type dm_sysobject)

addvirtualdocumentnode (type dm_sysobject)

Purpose
Adds a node to a virtual document.

Parameters

insertAfterNodeId (Optional) Node ID of the virtual document


node after which to add the new node.
lockOwner (Optional) Name of object owner
newNodeIds (Optional)
newNodeObjectIds (Required) Comma‑delimited string of new
object IDs for the objects that are to be added to
the virtual document
newVDRootNodeIds (Optional)
nodeId (Optional) Node ID of the parent node for the
new node.
objectId (Required) Object ID of the parent node for the
new node.
vdmRootObjectId (Optional) Object ID of the root of the virtual
document.

Description
Since
5.x

Configuration File
webcomponent\config\library\vdm\addcomponent\addvirtualdocumentnode_component.xml

Scope

type dm_sysobject

1546 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
addvirtualdocumentnodefromclipboard (type dm_sysobject)

Elements
None.

addvirtualdocumentnodefromclipboard (type
dm_sysobject)

Purpose
Adds an object from the clipboard to a virtual document

Parameters

lockOwner (Optional) Name of the user who owns the root


node of the virtual document
nodeId (Optional) Node ID of the object to operate on,
when it is part of a virtual document.
objectId (Required) ID of the object being added to the
virtual document
vdmRootObjectId (Optional) Object ID of the root of a virtual
document (when operating on a child node).

Description
Since
5.x

Configuration File
webcomponent\config\library\vdm\addcomponent\addvirtualdocumentnodefromclipboard_
component.xml

Scope

type dm_sysobject

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1547
addvirtualdocumentnodefromfileselector (type dm_sysobject)

Elements
None.

addvirtualdocumentnodefromfileselector (type
dm_sysobject)

Purpose
Adds an object to a virtual document that is selected by the user. This component nests to the
addchildsysobjectlocatorcontainer component to make the object selection.

Parameters

lockOwner (Optional) Name of the owner of the virtual


document root node
nodeId (Optional) Node ID of the object to operate on,
when it is part of a virtual document.
objectId (Required) ID of the object to be added to the
virtual document
vdmRootObjectId (Optional) Object ID of the root of a virtual
document (when operating on a child node).

Description
Since
5.x

Configuration File
webcomponent\config\library\vdm\addcomponent\addvirtualdocumentnodefromfileselector_
component.xml

Scope

type dm_sysobject

1548 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
removevirtualdocumentnode

Elements
None.

removevirtualdocumentnode

Purpose
This component is used to remove a node from a virtual document.

Parameters

nodeId (Required) ID of the node to be removed from


the virtual document
vdmRootObjectId (Required) ID of the root document of the virtual
document from which the node is being removed

Description
Since
5.x

Configuration File
webcomponent\config\library\vdm\removecomponent\removevirtualdocumentnode_component.
xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1549
removevirtualdocumentnodecontainer

removevirtualdocumentnodecontainer

Purpose
This component displays the removevirtualdocumentnode component and allows the user to remove
a node from a virtual document.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class.) ID of the component
being displayed
componentArgs (Required) Supplied by the LaunchComponent
class.) List of arguments and values to pass
to each contained component.(Required) This
parameter is supplied by the LaunchComponent
class and consists of a list of arguments and
values to pass to each contained component.
nodeId (Required) ID of the node being removed from
the virtual document(Required) ID of the node
being removed from the virtual document
vdmRootObjectId (Required) ID of the root node of the virtual
document from which the node is being
removed(Required) ID of the root node of the
virtual document from which the node is being
removed

Description

Since
5.x

Configuration File
webcomponent\config\library\vdm\removecomponent\removevirtualdocumentnodecontainer_
component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

1550 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reordervirtualdocumentnodes

Scope
All.

Elements
failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

reordervirtualdocumentnodes

Purpose
This component is used to change the order of nodes in a virtual document.

Parameters

nodeId (Required) ID of node being reordered


vdmRootObjectId (Required) ID of root node

Description

Since
5.x

Configuration File
webcomponent\config\library\vdm\reordercomponents\reordervirtualdocumentnodes_
component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1551
repositionvirtualdocumentnode (type dm_sysobject)

Elements
None.

repositionvirtualdocumentnode (type dm_sysobject)

Purpose
Contains one or more components that move a virtual document node to a different part of the
virtual document tree

Parameters

insertAfterNodeId (Optional) Node ID of the node after which the


object should be added
nodeId (Required) Node ID of the object to operate on,
when it is part of a virtual document.
targetParentNodeId (Required) Node ID of the parent node to which
the object will be added
vdmRootObjectId (Required) Object ID of the root of a virtual
document (when operating on a child node).

Description
Since
5.x

Configuration File
webcomponent\config\library\vdm\repositionnode\repositionvirtualdocumentnode_component.
xml

Scope

type dm_sysobject

1552 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
savechanges

Elements
None.

savechanges

Purpose
Provides the UI and functionality for saving changes made to virtual document structures.

Parameters

closeUponCompletion (Optional) Set to true to close the virtual


document after changes are saved.
objectId (Optional) ID of the virtual document

Description
Since
5.x

Configuration File
webcomponent\config\library\vdm\savechanges\savechanges_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1553
savechanges (Webtop)

savechanges (Webtop)

Purpose
Provides the UI and functionality for saving changes made to virtual document structures.

Parameters

closeUponCompletion (Optional) Set to true to close the virtual


document after changes are saved.
objectId (Optional) ID of the virtual document

Description
Since
6.5

Configuration File
webtop\config\savechanges_component.xml

Scope
All.

Elements
None.

setbindingrule

Purpose
Launched by the setbindingrule action, this component extends checkout and allows the user to set a
binding rule on a virtual document node. Displays the binding rule and version for the selected node.
The container extends checkoutcontainer and performs the actual setting of the binding rule.

1554 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
vdm_preferences

Parameters

nodeId (Required) ID of the selected node for which to


display the binding rule
vdmRootObjectId (Required) ID of the root node of the virtual
document to which the node is bound

Description
Since
5.x

Configuration File
webcomponent\config\library\vdm\setbindingrule\setbindingrule_component.xml

Scope
All.

Elements
None.

vdm_preferences

Purpose
Enables the user to set preferences for Virtual Document Manager (VDM).

Parameters
None.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1555
vdm_preferences (Webtop)

Configuration File
webcomponent\config\environment\preferences\vdm\vdm_preferences_component.xml

Scope
All.

Elements
None.

vdm_preferences (Webtop)

Purpose
Enables the user to set display preferences for Virtual Document Manager (VDM).

Description
Since
5.x

Configuration File
webtop\config\vdm_preferences_component.xml

Parent Definition
vdm_preferences:webcomponent/config/environment/preferences/vdm/vdm_preferences_
component.xml

Scope
All.

Elements
None.

1556 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
vdmclickactionprompt

vdmclickactionprompt

Purpose
Displays a dialog when the user clicks a link to a virtual document that allows the user to open the
virtual document in an editing application or open the virtual document manager to edit the structure.

Parameters

contentSize (Optional) Size of the object in bytes.


contentType (Optional) File format to use when opening the
object (passed to the operating system)
isLaunchedFromDRL (Optional) Boolean: Whether the link to the
virtual document was a DRL (True) or not
(False).Since 5.3 SP5.
isReference (Optional) Boolean flag that indicates whether
the object is a reference object.
launchViewer (Optional) Boolean flag that indicates whether to
launch a viewing application.
nodeId (Optional) ID of the node in a virtual document
objectId (Required) ID of the object to be viewed.
pathInfo (Optional) Path to be displayed in the
breadcrumb
selectedNodeIds (Optional) Comma‑separated list of nodeIds that
should be initially selected when the vdmlist
component is first displayed
structureComponent (Optional) Name of the component that displays
virtual document structure
useAssembly (Optional) Set to true for virtual document
assembly objects

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1557
vdmclickactionprompt (Webtop)

Configuration File
webcomponent\config\navigation\vdm\vdmclickactionprompt_component.xml

Scope
All.

Elements
None.

vdmclickactionprompt (Webtop)

Purpose
Displays a dialog when the user clicks a link to a virtual document that allows the user to open the
virtual document in an editing application or open the virtual document manager to edit the structure.

Parameters
The parameters are inherited from vdmclickactionprompt:webcomponent/config/navigation/vdm/
vdmclickactionprompt_component.xml. See vdmclickactionprompt, page 1557.

Description
Since
5.x

Configuration File
webtop\config\vdmclickactionprompt_component.xml

Parent Definition
vdmclickactionprompt:webcomponent/config/navigation/vdm/vdmclickactionprompt_component.
xml

Scope
All.

1558 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
vdmclickactionpromptcontainer

Elements
None.

vdmclickactionpromptcontainer

Purpose
Contains one or more vdmclickactionprompt components

Parameters
The parameters are inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml. See
dialogcontainer, page 1185.

Description
Since
5.x

Configuration File
webcomponent\config\navigation\vdm\vdmclickactionpromptcontainer_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1559
vdmcopyoption

vdmcopyoption

Purpose
Launches the vdmcopyoption component in the dialogcontainer to present the user with options for
the type of copy operation on a virtual document.

Parameters

objectName (Required) Name of the object that will be copied.

Description
Since
5.x

Configuration File
webcomponent\config\library\vdm\copyoption\copyoption_component.xml

Scope
All.

Elements
None.

vdmlist

Purpose
Displays the structure of a virtual document. The user can navigate to the different parts of the
virtual document by clicking on the breadcrumb or the child node. This component has an extended
version in Webtop called vdmlist.

1560 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
vdmlist

Parameters

nodeId (Optional) ID of the node in a virtual document.


objectId (Required) ID of the virtual document.
pathInfo (Optional) Path to be displayed in the
breadcrumb.
selectedNodeIds (Optional) Comma‑separated list of nodeIds that
should be initially selected when the vdmlist
component is first displayed.

Description
Since
5.x

Configuration File
webcomponent\config\navigation\vdm\vdmlist_component.xml

Scope
All.

Usage
To make the late binding value display by default for each node, make the r_object_id column visible
in the component definition. Users who customize the column display can add this as the ʺFix to
Version column.

Elements
columns
See columns (for streamline view), page 811.
default_binding_filter_values
See default_binding_filter_values, page 815.
dragdrop
See dragdrop, page 818.

preset_item
See preset_item, page 830.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1561
vdmlist (Webtop)

vdmlist (Webtop)

Purpose
Extends the WDK vdmlist component and adds support for the classic view. Displays the structure of
a virtual document. The user can navigate to the different parts of the virtual document by clicking
on the breadcrumb or the child node.

Parameters
The parameters are inherited from vdmlist:webcomponent/config/navigation/vdm/vdmlist_
component.xml. See vdmlist, page 1560.

Description
Since
5.x

Configuration File
webtop\config\vdmlist_component.xml

Parent Definition
vdmlist:webcomponent/config/navigation/vdm/vdmlist_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

default_binding_filter_values
See default_binding_filter_values, page 815.
dragdrop
See dragdrop, page 818.
preset_item
See preset_item, page 830.

1562 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
vdmliststreamline

vdmliststreamline

Purpose
Provides a streamline view of virtual documents. Both the vdmlist components provide a UI that
displays the children and root in a virtual document, allows navigation through the virtual document’s
hierarchy, and displays menus to launch actions on selected items. Deprecated as of version 6.

Parameters

nodeId (Optional) ID of the node in a virtual document.


objectId (Required) ID of the virtual document.
pathInfo (Optional) Path to be displayed in the
breadcrumb.

Description
Since
5.x

Configuration File
webcomponent\config\navigation\vdm\vdmliststreamline_component.xml

Scope
All.

Usage
To make the late binding value display by default for each node, make the r_object_id column visible
in the component definition. Users who customize the column display can add this as the ʺFix to
Version column.

Elements
columns
See columns (for streamline view), page 811.

default_binding_filter_values
See default_binding_filter_values, page 815.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1563
vdmliststreamline (Webtop)

dragdrop
See dragdrop, page 818.

vdmliststreamline (Webtop)

Purpose
Provides a streamline view of virtual documents. Both the vdmlist components provide a UI that
displays the children and root in a virtual document, allows navigation through the virtual document’s
hierarchy, and displays menus to launch actions on selected items.

Parameters
The parameters are inherited from vdmliststreamline:webcomponent/config/navigation/vdm/
vdmliststreamline_component.xml. See vdmliststreamline, page 1563.

Description
Since
5.x

Configuration File
webtop\config\vdmliststreamline_component.xml

Parent Definition
vdmliststreamline:webcomponent/config/navigation/vdm/vdmliststreamline_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

default_binding_filter_values
See default_binding_filter_values, page 815.

1564 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
vdmvalidate

dragdrop
See dragdrop, page 818.

vdmvalidate

Purpose
Validates the XML of an XML virtual document node.

Parameters

maxDisplayError (Required) Maximum number of validation


errors to display.
nodeId (Required) Node ID of the node to validate.
objectId (Required) Object ID of node to validate.
vdmRootObjectId (Required) Object ID of the root of the virtual
document.

Description
Since
6.0

Configuration File
webcomponent\config\library\vdm\validate\vdmvalidate_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1565
vdmvalidate_container

vdmvalidate_container

Purpose
Container for the vdmvalidate, page 1565component.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description

Since
6.0

Configuration File
webcomponent\config\library\vdm\validate\vdmvalidatecontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.
propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

1566 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
historicalactivityreportresults

Workflow reporting

historicalactivityreportresults

Purpose
Displays the results of a historical activity report query.

Parameters

process_id (Required) ID of the workflow template (process)


on which to report
query (Required) When the querytype is string, this
value is the search string. If the querytype is not
string, this value is the query string.
title (Optional) Title to be displayed at the top of the
report

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\historicalreport\activityresults_component.xml

Scope
All.

Elements
columns_list
See columns_list, page 812.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1567
historicalprocessreport

failoverenabled
See failoverenabled, page 819.

historicalprocessreport

Purpose
This component displays a workflow process historical report.

Parameters
None.

Description

Since
5.x

Configuration File
webcomponent\config\library\workflow\historicalreport\processreport_component.xml

Scope
All.

Elements
cost_attribute_conditions
See cost_attribute_conditions, page 815.

duration_attribute_conditions
See duration_attribute_conditions, page 818.

failoverenabled
See failoverenabled, page 819.

showjobstatus
See showjobstatus, page 835.

1568 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
historicalprocessreportcontainer

historicalprocessreportcontainer

Purpose
This component is used to display historical workflow reports for processes and performers.

Parameters

component (Optional) ID of the component to be displayed

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\historicalreport\processreportcontainer_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

historicalprocessreportresults

Purpose
This component is used to display reports on workflow processes that have been completed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1569
historicalreportcolumnselector

Parameters

query (Required) When the querytype is string, this


value is the search string. If the querytype is not
string, this value is the query string.
title (Optional) The title that will appear at the top
of the report.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\historicalreport\processresults_component.xml

Scope
All.

Elements
columns_list
See columns_list, page 812.
failoverenabled
See failoverenabled, page 819.

historicalreportcolumnselector

Purpose
This component provides UI and behavior for selecting the columns and column order for view
components such as DocList and Drilldown.

1570 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
historicalreportcolumnselector

Parameters

baseType (Optional) Specifies the repository types, in


addition to the default option, to populate the
attribute selectors docbase types drop‑down list.
columns (Required) A serialized list of items to populate
the available items list box. See multiselector
control for details on the list format.
defaultSelectedColumns (Optional) A serialized list of items to populate
the selected items list box before the user
performs an initial selection.
selectedColumns (Optional) A serialized list of items to populate
the selected columns list box.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\historicalreport\columnselector_component.xml

Parent Definition
columnselector:webcomponent/config/environment/preferences/display/columnselector_component.
xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1571
historicaluserreport

historicaluserreport

Purpose
This component displays a workflow process historical report for a performer.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\historicalreport\userreport_component.xml

Scope
All.

Elements
cost_attribute_conditions
See cost_attribute_conditions, page 815.

duration_attribute_conditions
See duration_attribute_conditions, page 818.

failoverenabled
See failoverenabled, page 819.

showjobstatus
See showjobstatus, page 835.

1572 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
historicaluserreportcontainer

historicaluserreportcontainer

Purpose
This component is a container for components that display historical user reports.

Parameters

component (Optional) ID of the component to display

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\historicalreport\userreportcontainer_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

historicaluserreportresults

Purpose
This component displays the report results of a historical workflow process report for a performer.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1573
processdetailreportresults

Parameters

query (Required) When the querytype is string, this


value is the search string. If the querytype is not
string, this value is the querystring.
title (Optional) The title to display at the top of the
report.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\historicalreport\userresults_component.xml

Scope
All.

Elements
columns_list
See columns_list, page 812.
failoverenabled
See failoverenabled, page 819.

processdetailreportresults

Purpose
Displays the results of a workflow process

1574 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportdetailsauditclassic (type dm_workflow) (Webtop)

Parameters

process_id (Required) ID of the workflow process (template)


query (Required) When the querytype is string, this
value is the search string. If the querytype is not
string, this value is the query string.
title (Optional) Title for the report

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\historicalreport\processdetailresults_component.xml

Scope
All.

Elements
columns_list
See columns_list, page 812.
failoverenabled
See failoverenabled, page 819.

reportdetailsauditclassic (type dm_workflow)


(Webtop)

Purpose
Extends the WDK component reportdetailsauditlist to display the audit events of a workflow instance.
Called by the WDK action reportdetailsauditlist. The user will see no events if the workflow is not
audited.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1575
reportdetailsauditdrilldown

Parameters
The parameters are inherited from reportdetailsauditlist:webcomponent/config/library/workflow/
reportdetails/reportdetailsauditlist_component.xml. See reportdetailsauditlist, page 1577.

Description

Since
5.x

Configuration File
webtop\config\reportdetailsauditclassic_component.xml

Parent Definition
reportdetailsauditlist:webcomponent/config/library/workflow/reportdetails/reportdetailsauditlist_
component.xml

Scope

type dm_workflow

Elements
columns
See columns (for data columns), page 811.

hideEvents
See hideEvents, page 821.

reportdetailsauditdrilldown

Purpose
This component displays the audit events of a workflow instance. The user will see no events if
the workflow is not audited.

1576 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportdetailsauditlist

Parameters

eventFilter (Optional) Specifies the filter to use: 0 = show


workflow events | 1 = show workflow and doc
events
hideEvents (Optional) String of event names that should not
be displayed.
objectId (Required) ID of the selected workflow.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\reportdetails\reportdetailsauditdrilldown_component.
xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

reportdetailsauditlist

Purpose
This component displays the audit events of a workflow instance. The user will see no events if
the workflow is not audited.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1577
reportdetailsauditstreamline (type dm_workflow) (Webtop)

Parameters

eventFilter (Optional) Specifies the filter to use: 0 = show


workflow events | 1 = show workflow and doc
events
hideEvents (Optional) String of event names that should
not be displayed. Event names are listed in the
Content Server API Reference Manual.
objectId (Required) ID of the selected workflow.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\reportdetails\reportdetailsauditlist_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

reportdetailsauditstreamline (type dm_workflow)


(Webtop)

Purpose
Extends WDK reportdetailsauditdrilldown component to display the audit events of a workflow
instance. Called by the WDK action reportdetailsauditdrilldown. The user will see no events if the
workflow is not audited.

1578 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportdetailscontainerclassic (type dm_workflow) (Webtop)

Parameters
The parameters are inherited from reportdetailsauditdrilldown:webcomponent/config/
library/workflow/reportdetails/reportdetailsauditdrilldown_component.xml. See
reportdetailsauditdrilldown, page 1576.

Description
Since
5.x

Configuration File
webtop\config\reportdetailsauditstreamline_component.xml

Parent Definition
reportdetailsauditdrilldown:webcomponent/config/library/workflow/reportdetails/
reportdetailsauditdrilldown_component.xml

Scope

type dm_workflow

Elements
columns
See columns (for data columns), page 811.
hideEvents
See hideEvents, page 821.

reportdetailscontainerclassic (type dm_workflow)


(Webtop)

Purpose
Extends the WDK component reportdetailscontainerlist and contains report detail components on a
workflow.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1579
reportdetailscontainerdrilldown (type dm_workflow)

Parameters
The parameters are inherited from reportdetailscontainerlist:webcomponent/config/library/workflow/
reportdetailscontainer/reportdetailscontainerlist_component.xml. See reportdetailscontainerlist (type
dm_workflow), page 1581.

Description
Since
5.x

Configuration File
webtop\config\reportdetailscontainerclassic_component.xml

Parent Definition
reportdetailscontainerlist:webcomponent/config/library/workflow/reportdetailscontainer/
reportdetailscontainerlist_component.xml

Scope

type dm_workflow

Elements
None.

reportdetailscontainerdrilldown (type dm_workflow)

Purpose
Extends propertysheetcontainer, page 928 and contains report detail components on a workflow.
Deprecated as of version 6.

Parameters

component (Optional) The contained component.


objectId (Required) ID of the selected workflow.

1580 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportdetailscontainerlist (type dm_workflow)

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\reportdetailscontainer\reportdetailscontainerdrilldown_
component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope

type dm_workflow

Elements
failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

reportdetailscontainerlist (type dm_workflow)

Purpose
Extends propertysheetcontainer, page 928 and contains report detail components on a workflow.

Parameters

component (Optional) The contained component.


objectId (Required) ID of the selected workflow.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1581
reportdetailscontainerstreamline (type dm_workflow) (Webtop)

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\reportdetailscontainer\reportdetailscontainerlist_
component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope

type dm_workflow

Elements
failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

reportdetailscontainerstreamline (type dm_workflow)


(Webtop)

Purpose
Extends the WDK reportdetailscontainerdrilldown component and contains report detail components
on a workflow.

Parameters
The parameters are inherited from reportdetailscontainerdrilldown:webcomponent/config/
library/workflow/reportdetailscontainer/reportdetailscontainerdrilldown_component.xml. See
reportdetailscontainerdrilldown (type dm_workflow), page 1580.

1582 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportdetailsheader

Description
Since
5.x

Configuration File
webtop\config\reportdetailscontainerstreamline_component.xml

Parent Definition
reportdetailscontainerdrilldown:webcomponent/config/library/workflow/reportdetailscontainer/
reportdetailscontainerdrilldown_component.xml

Scope

type dm_workflow

Elements
None.

reportdetailsheader

Purpose
This component is included in the UI of reportdetailscontainerlist (type dm_workflow), page 1581 and
reportdetailscontainerdrilldown (type dm_workflow), page 1580. The header component displays a
different page depending on the active component in the container.

Parameters

component (Optional) Specifies the component for which to


display the header.
objectId (Required) ID of the selected workflow.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1583
reportdetailsmap

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\reportdetails\reportdetailsheader_component.xml

Scope
All.

Elements
None.

reportdetailsmap

Purpose
This component displays the map view of the workflow instance in the Web Workflow Manager.

Parameters
The parameters are inherited from webwfm:webcomponent/config/library/workflow/webwfm/
webwfm_component.xml. See webwfm, page 1659.

Description

Since
5.x

Configuration File
webcomponent\config\library\workflow\reportdetails\reportdetailsmap_component.xml

Parent Definition
webwfm_checkjvm:webcomponent/config/library/workflow/webwfm/webwfm_component.xml

1584 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportdetailssummaryclassic (type dm_workflow) (Webtop)

Scope
All.

Elements
None.

reportdetailssummaryclassic (type dm_workflow)


(Webtop)

Purpose
Extends the WDK component reportdetailssummarylist and displays the summary of a selected
workflow’s task and task attributes.

Parameters
The parameters are inherited from reportdetailssummarylist:webcomponent/config/library/workflow/
reportdetails/reportdetailssummarylist_component.xml. See reportdetailssummarylist, page 1587.

Description
Since
5.x

Configuration File
webtop\config\reportdetailssummaryclassic_component.xml

Parent Definition
reportdetailssummarylist:webcomponent/config/library/workflow/reportdetails/
reportdetailssummarylist_component.xml

Scope

type dm_workflow

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1585
reportdetailssummarydrilldown

Elements
columns
See columns (for data columns), page 811.
taskmgractionname
See taskmgractionname, page 837.

reportdetailssummarydrilldown

Purpose
Displays the summary of a selected workflow’s tasks and their attributes, such as task name, runtime
status, action, performer, comments, and receive/complete/overdue days. Deprecated as of version 6.

Parameters

objectId (Required) ID of the selected workflow.


showAttachment (Optional) Set to true to display attached
documents with tasks
taskFilter (Optional) Sets the selected filter. Valid values: 0
= all | 1 = current | 2 = overdue

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\reportdetails\reportdetailssummarydrilldown_
component.xml

Scope
All.

1586 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportdetailssummarylist

Elements
columns
See columns (for data columns), page 811.
taskmgractionname
See taskmgractionname, page 837.

reportdetailssummarylist

Purpose
Displays the summary of a selected workflow’s tasks and their attributes, such as task name, runtime
status, action, performer, comments, and receive/complete/overdue days.

Parameters

objectId (Required) ID of the selected workflow.


showAttachment (Optional) Set to true to display attached
documents with tasks
taskFilter (Optional) Sets the selected filter. Valid values: 0
= all | 1 = current | 2 = overdue

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\reportdetails\reportdetailssummarylist_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1587
reportdetailssummarystreamline (type dm_workflow) (Webtop)

Elements
columns
See columns (for data columns), page 811.
taskmgractionname
See taskmgractionname, page 837.

reportdetailssummarystreamline (type dm_workflow)


(Webtop)

Purpose
Extends the WDK component reportdetailssummarydrilldown and displays the summary of a
selected workflow’s task and its attributes, such as task name, runtime status, action, performer,
comments, and receive/complete/overdue days.

Parameters
The parameters are inherited from reportdetailssummarydrilldown:webcomponent/config/
library/workflow/reportdetails/reportdetailssummarydrilldown_component.xml. See
reportdetailssummarydrilldown, page 1586.

Description

Since
5.x

Configuration File
webtop\config\reportdetailssummarystreamline_component.xml

Parent Definition
reportdetailssummarydrilldown:webcomponent/config/library/workflow/reportdetails/
reportdetailssummarydrilldown_component.xml

1588 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportdql

Scope

type dm_workflow

Elements
columns
See columns (for data columns), page 811.

taskmgractionname
See taskmgractionname, page 837.

reportdql

Purpose
This component displays a workflow report based on a DQL query.

Parameters

query (Optional) When the querytype is string, this


value is the search string. If the querytype is not
string, this value is the query string.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\historicalreport\reportdql_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1589
reportmainclassic (Webtop)

Elements
None.

reportmainclassic (Webtop)

Purpose
Extends the WDK component reportmainlist and displays a list of workflow instances and their
attributes. This component is called by the component class.

Parameters
The parameters are inherited from reportmainlist:webcomponent/config/library/workflow/
reportmain/reportmainlist_component.xml. See reportmainlist, page 1592.

Description
Since
5.x

Configuration File
webtop\config\reportmainclassic_component.xml

Parent Definition
reportmainlist:webcomponent/config/library/workflow/reportmain/reportmainlist_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

savedetailsreport
See savedetailsreport, page 832.

1590 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportmaindrilldown

reportmaindrilldown

Purpose
Displays a list of workflow instances and its attributes. Deprecated as of version 6.

Parameters

overdueDays (Optional) Sets minimum number of days


overdue (default = 0)
workflowFilter (Optional) Sets the selected filter. Valid values: 0
= all | 1 = completed | 2 = running
workflowType (Optional) Type of workflow query. Valid values:
0 = general | 1 = supervisor | 2 = template ID
| 3 = workflow name | 4 = Document ID | 5 =
Workflow ID | 6 = all | 7 (default) = supervisor
and performer
workflowTypeParam (Optional) Second workflow type for query (see
workflowType for valid values)

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\reportmain\reportmaindrilldown_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

savedetailsreport
See savedetailsreport, page 832.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1591
reportmainlist

reportmainlist

Purpose
Displays a list of workflow instances and its attributes. This component is extended by the Webtop
reportmainclassic component.

Parameters

overdueDays (Optional) Sets minimum number of days


overdue (default = 0)
workflowFilter (Optional) Sets the selected filter. Valid values: 0
= all | 1 = completed | 2 = running
workflowType (Optional) Type of workflow query. Valid values:
0 = general | 1 = supervisor | 2 = template ID
| 3 = workflow name | 4 = Document ID | 5 =
Workflow ID | 6 = all | 7 (default) = supervisor
and performer
workflowTypeParam (Optional) Second workflow type for query (see
workflowType for valid values)

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\reportmain\reportmainlist_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

1592 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportmainsettings

savedetailsreport
See savedetailsreport, page 832.

reportmainsettings

Purpose
This component allows the user to set criteria for the workflow instances to be displayed in the
reportmain component.

Parameters

documentId (Optional) Specifies a document for which


workflows will be reported
filter (Required) Sets the selected filter. Valid values: 0
= all | 1 = completed | 2 = running
overdueDays (Optional) Specifies the minimum number of
days overdue for which to display a report
overdueOnly (Required) True to filter for overdue task status.
templateId (Optional) Specifies a template for which
workflows will be reported
userName (Required) Name of the user for which to display
workflows.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\reportmain\reportmainsettings_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1593
reportmainstreamline (Webtop)

Elements
None.

reportmainstreamline (Webtop)

Purpose
Extends the WDK component reportmaindrilldown and displays a list of workflow instances and their
attributes. This component is called by the component class in the WDK nestedcomponent container.

Parameters
The parameters are inherited from reportmaindrilldown:webcomponent/config/library/workflow/
reportmain/reportmaindrilldown_component.xml. See reportmaindrilldown, page 1591.

Description
Since
5.x

Configuration File
webtop\config\reportmainstreamline_component.xml

Parent Definition
reportmaindrilldown:webcomponent/config/library/workflow/reportmain/reportmaindrilldown_
component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

savedetailsreport
See savedetailsreport, page 832.

1594 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
reportsysobjectlocator

reportsysobjectlocator

Purpose
Extends sysobjectlocator, page 1091 and locates reports. This locator is nested to from the component
class reportmainsettings, page 1593. The container extends locatorcontainer, page 1081.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\reportsysobjectlocator_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>true</allversionsvisible>

1 See allversionsvisible, page 809.

columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1595
reportsysobjectlocatorcontainer

contenttypepanelvisible
1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.


filenamefiltervisible
See filenamefiltervisible, page 819.
objecttype
<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to locate.


privatecabinetvisible
1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.


views
See views, page 839.

reportsysobjectlocatorcontainer

Purpose
This component displays a simple list of sysobjects including the folder and the findtype.

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\reportsysobjectlocatorcontainer_component.xml

1596 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
savereportlocator

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

savereportlocator

Purpose
Extends folderlocatorcontainer, page 1075 and allows a user to locate a folder in which to save a report.
This locator is nested within the component class of several reporting components.

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\savereport\savereportlocator_component.xml

Parent Definition
folderlocatorcontainer:webcomponent/config/library/locator/folderlocators_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1597
savereportname

Elements
None.

savereportname

Purpose
This component is included in the component savereportlocator, page 1597 and allows the user to
specify a report name for a saved report.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\savereport\savereportlocator_component.xml

Scope
All.

Elements
None.

1598 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
abortworkflow (type dm_workflow)

Workflows

abortworkflow (type dm_workflow)

Purpose
Terminates Documentum workflows prematurely and then deletes them. This component is generally
used to abort obsolete workflows.

Parameters

objectId (Required) The ID of the workflow object to be


terminated.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\abort\abortworkflow_component.xml

Scope

type dm_workflow

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1599
addtaskattachmentlocatorcontainer

addtaskattachmentlocatorcontainer

Purpose
Adds an attachment to a task. Contains attachmentlocator, page 1604.

Parameters

formTemplateId (Optional) ID of the form template, if the


attachment is a form instance
objectId (Required) ID of the attachment
objecttype (Required) Attachment object type
packageName (Required) Name of the workflow package
versionlabel (Optional) Version label for the attachment

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\addattachment\addtaskattachmentlocatorcontainer_
component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

1600 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
alluserwftemplatelocator

alluserwftemplatelocator

Purpose
Lists all repository workflow templates that are not system‑generated.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\userwftemplatelocator_component.xml

Parent Definition
allwftemplatelocator:webcomponent/config/library/locator/wftemplatelocators_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>true</allversionsvisible>

1 See allversionsvisible, page 809.

breadcrumbiconwellmode
See breadcrumbiconwellmode, page 810.

columns
See columns (for data columns), page 811.
flatlist
1 <flatlist>true</flatlist>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1601
allwftemplatelocator

1 See flatlist, page 820.


iconwell_icon
See iconwell_icon, page 822.
objecttype
<objecttype>dm_process</objecttype>

Specifies the object type of the objects to locate.

preset_item
See preset_item, page 830.

views
See views, page 839.

allwftemplatelocator

Purpose
Locates dm_process objects (workflow templates) in a repository

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\wftemplatelocators_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

1602 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
allwftemplatelocator

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>true</allversionsvisible>

1 See allversionsvisible, page 809.


columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


contenttypepanelvisible
1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.

filenamefiltervisible
See filenamefiltervisible, page 819.

flatlist
1 <flatlist>true</flatlist>

1 See flatlist, page 820.


objecttype
<objecttype>dm_process</objecttype>

Specifies the object type of the objects to locate.

privatecabinetvisible
1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.


views
See views, page 839.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1603
attachmentlocator

attachmentlocator

Purpose
Locates object attachments, based on their type and required version label or labels.

Parameters

formTemplateId (Optional) ID for the XForm template


objecttype (Optional) Type of object to be located
versionlabel (Optional) Version label on attachment, for
example, CURRENT

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\attachmentlocator_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>true</containerselectable>

1604 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attachmentlocatorcontainer

1 See containerselectable, page 814.


contenttypepanelvisible
1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.


filenamefiltervisible
See filenamefiltervisible, page 819.
iconwell_icon
See iconwell_icon, page 822.
objecttype
<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to locate.

privatecabinetvisible
1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

views
See views, page 839.

attachmentlocatorcontainer

Purpose
Locates object attachments, based on their type and required version label or labels.

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
formTemplateId (Optional) ID of the form template, if the
attachment is a form instance

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1605
attachmentmyobjectlocator

multiselect (Optional) Boolean: Set to true to support


multiple object selection.
objecttype (Optional) Type of the selected object
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected
versionlabel (Optional) Version label on attachment; for
example, CURRENT

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\attachmentlocatorcontainer_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

attachmentmyobjectlocator

Purpose
Selects attachment objects from the user’s objects.

1606 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attachmentmyobjectlocator

Parameters

formTemplateId (Optional) ID for the XForm template


objecttype (Optional) Type of object to be located
versionlabel (Optional) Version label on attachment, for
example, CURRENT

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\attachmentmyobjectlocator_component.xml

Parent Definition
myobjectlocator:webcomponent/config/library/locator/myobjectlocator_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.


columns
See columns (for data columns), page 811.

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


flatlist
1 <flatlist>true</flatlist>

1 See flatlist, page 820.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1607
attachmentsubscriptionlocator

iconwell_icon
See iconwell_icon, page 822.

modifiedwithindays
See modifiedwithindays, page 825.
objecttype
<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to locate.

privatecabinetvisible
1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

views
See views, page 839.

attachmentsubscriptionlocator

Purpose
Selects attachment objects from the user’s subscriptions list.

Parameters

formTemplateId (Optional) ID for the XForm template


objecttype (Optional) Type of object to be located
versionlabel (Optional) Version label on attachment, for
example, CURRENT

Description

Since
5.x

1608 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
attachmentsubscriptionlocator

Configuration File
webcomponent\config\library\workflow\attachmentsubscriptionlocator_component.xml

Parent Definition
subscriptionlocator:webcomponent/config/library/locator/subscriptionlocator_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.

iconwell_icon
See iconwell_icon, page 822.

objecttype
<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to locate.

privatecabinet_visible
See privatecabinet_visible, page 831.

privatecabinetvisible
1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1609
changeperformer (type dm_task)

views
See views, page 839.

changeperformer (type dm_task)

Purpose
Allows the user to change the performer of a future task in a workflow.

Parameters

objectName (Required) Activity name of the future task.


taskRuntimeFlag (Required) State of the workflow task. Valid
values: 0=dormant | 1=acquired | 2=finished |
3 6 =paused | 7=ready
workflowId (Required) ID of the workflow.
workflowRuntimeState (Required) State of the workflow activity. Valid
values: 0=dormant | 1=running | 2=finished |
3=halted | 4=terminated

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\performers\changeperformer_component.xml

Scope

type dm_task

Elements
None.

1610 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
changeperformercontainer

changeperformercontainer

Purpose
Allows the user to change the performer of a future task in a workflow.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class.) The name of the
component to contain.
componentArgs (Required) Supplied by the LaunchComponent
action execution class.) List of arguments and
values to pass to each contained component.

Description

Since
5.x

Configuration File
webcomponent\config\library\workflow\performers\changeperformercontainer_component.xml

Scope
All.

Elements
None.

changesupervisor (type dm_workflow)

Purpose
This component is a container that extends locatorcontainer, page 1081. It allows the user to select a
new supervisor for a workflow. This container contains the component userorgrouplocator, page 1526.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1611
completefailedautoworkflowtask

Parameters

objectId (Required) ID of the workflow.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\changesupervisor\changesupervisor_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope

type dm_workflow

Elements
multidocbasesupport
See multidocbasesupport, page 825.

completefailedautoworkflowtask

Purpose
The completefailedautoworkflowtask component forces completion of a failed automatic workflow
task. It is invoked from the task manager component.

Parameters

objectId (Required) ID of the workflow task

1612 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delegateworkflowtask

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\completeautotask_component.xml

Scope
All.

Elements
None.

delegateworkflowtask

Purpose
The delegateworkflowtask component delegates workflow tasks.

Parameters

objectId (Required) ID of the task

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\delegateworkflowtask_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1613
delete (type dm_notification)

Elements
None.

delete (type dm_notification)

Purpose
The delete component deletes dm_folders and other dm_sysobjects, deletes inbox notifications
(dm_notification and dm_queued), and deletes folders (queries the user whether all objects should be
deleted from a folder selected for deletion). This component must be used within the deletecontainer
component.

Parameters

objectId (Required) ID of the object to be deleted. Applies


to all types.
objectName (Optional) Name of the object to be deleted.
Applies only to dm_notification and dm_queued
types.

Description
Since
5.x

Configuration File
webcomponent\config\library\delete\delete_notification_component.xml

Scope

type dm_notification

Elements
None.

1614 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
deleteworkflow (type dm_workflow)

deleteworkflow (type dm_workflow)

Purpose
The deleteworkflow component deletes aborted workflow objects.

Parameters

objectId (Required) ID of the workflow to be deleted

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\delete\deleteworkflow_component.xml

Scope

type dm_workflow

Elements
None.

deleteworkflowcalendar

Purpose
Enables deleting a workflow business calendar.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1615
editstartwfnote (type dmi_package)

Parameters

objectId (Required) Not used.


objectname (Optional) Object name of the workflow business
calendar.

Description
Since
6.0 SP1

Configuration File
webcomponent\config\library\workflow\calendar\deleteworkflowcalendar_component.xml

Scope
All.

Usage
A workflow business calendar object can be deleted only if it is not associated with a workflow object.

Elements
None.

editstartwfnote (type dmi_package)

Purpose
Adds, edits, and removes attachment notes from dmi_package objects during the workflow
initialization process.

1616 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
edittasknote (type dmi_package)

Parameters

operationType (Required) Type of operations to perform on a


note. Valid values: add | edit | remove.
packageName (Required) Name of the workflow package
processId (Required) ID of the workflow process

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\editnote\editstartwfnote_component.xml

Scope

type dmi_package

Elements
None.

edittasknote (type dmi_package)

Purpose
The edittasknote component adds, edits, and removes attachment notes. This component is defined
for dmi_package objects in edittasknote_component.xml.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1617
finishworkflowtask

Parameters

operationType (Required) Type of operations to perform on a


note. Valid values: add | edit | remove.
packageName (Required) Name of the workflow package
queueItemId (Required) ID of the queue item with which the
note is associated.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\editnote\edittasknote_component.xml

Scope

type dmi_package

Elements
None.

finishworkflowtask

Purpose
The finishworkflowtask component completes non‑manual workflow tasks (for which the user is
not expected to specify the next task).

1618 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
forwardroutertask

Parameters

objectId (Required) ID of the workflow task


userCost (Optional) Currency cost, such as dollars, euros,
or other type of cost defined by customer. Value
is stored as a double.
userTime (Optional) Time in units defined by the customer.
Value is stored as an integer.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\finishworkflowtask_component.xml

Scope
All.

Elements
None.

forwardroutertask

Purpose
Forwards router tasks. It is invoked from the taskmanager component.

Parameters

objectId (Required) ID of the router task

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1619
forwardworkflowtask

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\forwardroutertask_component.xml

Scope
All.

Elements
None.

forwardworkflowtask

Purpose
Forwards manual workflow tasks. It is invoked from the taskmanager component.

Parameters

objectId (Required) ID of the workflow task

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\forwardworkflowtask_component.xml

Scope
All.

1620 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
halttask (type dm_task)

Elements
None.

halttask (type dm_task)

Purpose
Halts (pauses) a task in a workflow. This component is defined for dm_task objects.

Parameters

objectId (Required) ID of the work item.


objectName (Required) Task name.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\halt\halttask_component.xml

Scope

type dm_task

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1621
haltworkflow (type dm_workflow)

haltworkflow (type dm_workflow)

Purpose
Halts (pauses) workflow objects. This component is defined for dm_workflow objects.

Parameters

objectId (Required) ID of the workflow

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\halt\haltworkflow_component.xml

Scope

type dm_workflow

Elements
None.

inboxlist

Purpose
Lists the user’s inbox tasks, using a classic‑style layout.

Parameters
None.

1622 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
inboxlist

Description
Since
5.x

Configuration File
webcomponent\config\navigation\inbox\inboxlist_component.xml

Scope
All.

Elements
autogettaskdefault
See autogettaskdefault, page 810.

columns
See columns (for streamline view), page 811.

failoverenabled
See failoverenabled, page 819.
preset_item
See preset_item, page 830.

showattachmentinfo
See showattachmentinfo, page 834.

showautogettask
See showautogettask, page 834.

showfilters
See showfilters, page 835.

taskmanagerid
See taskmanagerid, page 837.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1623
installedrecentwftemplatelocator

installedrecentwftemplatelocator

Purpose
Extends recentwftemplatelocator, page 1630 and allows the user to locate a recently used workflow
template that has been installed.

Parameters
The parameters are inherited from recentsysobjectlocator:webcomponent/config/library/locator/
recentsysobjectlocator_component.xml. See recentsysobjectlocator, page 1090.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\startworkflow\startworkflowtemplatelocatorcontainer_
component.xml

Parent Definition
recentwftemplatelocator:webcomponent/config/library/locator/wftemplatelocators_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

objecttype
<objecttype>dm_process</objecttype>

Specifies the object type of the objects to locate.

views
See views, page 839.

1624 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
installedwftemplatefolderlocator

installedwftemplatefolderlocator

Purpose
Extends unfilteredcontainersysobjectlocator, page 1093 and allows the user to locate a template folder.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\startworkflow\startworkflowtemplatelocatorcontainer_
component.xml

Parent Definition
unfilteredcontainersysobjectlocator:webcomponent/config/library/locator/
unfilteredcontainersysobjectlocator_component.xml

Scope
All.

Elements
None.

installedwftemplatesubscriptionlocator

Purpose
Extends wftemplatesubscriptionlocator, page 1670 and locates and displays installed workflow
templates to which the user has subscribed.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1625
installedwftemplatesubscriptionlocator

Parameters
The parameters are inherited from subscriptionlocator:webcomponent/config/library/locator/
subscriptionlocator_component.xml. See subscriptionlocator, page 1423.

Description

Since
5.x

Configuration File
webcomponent\config\library\workflow\startworkflow\startworkflowtemplatelocatorcontainer_
component.xml

Parent Definition
wftemplatesubscriptionlocator:webcomponent/config/library/locator/wftemplatelocators_component.
xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>true</allversionsvisible>

1 See allversionsvisible, page 809.

breadcrumbiconwellmode
See breadcrumbiconwellmode, page 810.
columns
See columns (for data columns), page 811.
flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.


iconwell_icon
See iconwell_icon, page 822.

1626 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
myuserwftemplatelocator

objecttype
<objecttype>dm_process</objecttype>

Specifies the object type of the objects to locate.

views
See views, page 839.

myuserwftemplatelocator

Purpose
Extends allwftemplatelocator, page 1602 and lists all non‑system workflow templates owned by
the current user.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\myuserwftemplatelocator_component.xml

Parent Definition
allwftemplatelocator:webcomponent/config/library/locator/wftemplatelocators_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>true</allversionsvisible>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1627
mywftemplatelocator

1 See allversionsvisible, page 809.


breadcrumbiconwellmode
See breadcrumbiconwellmode, page 810.
columns
See columns (for data columns), page 811.

flatlist
1 <flatlist>true</flatlist>

1 See flatlist, page 820.

iconwell_icon
See iconwell_icon, page 822.

objecttype
1 <objecttype>dm_process</objecttype>
Specifies the object type of the objects to locate.
views
See views, page 839.

mywftemplatelocator

Purpose
Extends myobjectlocator, page 1254 and displays a flat list of workflow templates that have been
checked out or recently modified by the current user.

Parameters
The parameters are inherited from myobjectlocator:webcomponent/config/library/locator/
myobjectlocator_component.xml. See myobjectlocator, page 1254.

1628 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
mywftemplatelocator

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\wftemplatelocators_component.xml

Parent Definition
myobjectlocator:webcomponent/config/library/locator/myobjectlocator_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>true</allversionsvisible>

1 See allversionsvisible, page 809.

columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>false</containerselectable>

1 See containerselectable, page 814.

flatlist
1 <flatlist>true</flatlist>

1 See flatlist, page 820.

modifiedwithindays
See modifiedwithindays, page 825.
objecttype
<objecttype>dm_process</objecttype>

Specifies the object type of the objects to locate.


privatecabinetvisible
1 <privatecabinetvisible>false</privatecabinetvisible>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1629
recentwftemplatelocator

1 See privatecabinetvisible, page 832.


views
See views, page 839.

recentwftemplatelocator

Purpose
Extends recentsysobjectlocator, page 1090 and locates workflow templates that were recently used by
the user. This component has no scope specified, but the <objecttype> element restricts the search to
objects of type dm_process (templates).

Parameters
The parameters are inherited from recentsysobjectlocator:webcomponent/config/library/locator/
recentsysobjectlocator_component.xml. See recentsysobjectlocator, page 1090.

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\wftemplatelocators_component.xml

Parent Definition
recentsysobjectlocator:webcomponent/config/library/locator/recentsysobjectlocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

1630 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
rejectroutertask

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


iconwell_icon
See iconwell_icon, page 822.
objecttype
<objecttype>dm_process</objecttype>

Specifies the object type of the objects to locate.


views
See views, page 839.

rejectroutertask

Purpose
Rejects router tasks.

Parameters

objectId (Required) ID of the router task

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\rejectroutertask_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1631
rejectworkflowtask

Elements
None.

rejectworkflowtask

Purpose
Displays a UI to allow the user to reject manual workflow tasks.

Parameters

objectId (Required) ID of the workflow task

Description

Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\rejectworkflowtask_component.xml

Scope
All.

Elements
None.

removeattachment

Purpose
Removes attached objects from a workflow. It is part of the task manager component group.

1632 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
removestartwfattachment

Parameters

attachmentName (Optional) Name of the workflow attachment


objectId (Required) ID of the attachment.
packageName (Required) Name of the workflow package.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\removeattachment\removeattachment_component.xml

Scope
All.

Elements
None.

removestartwfattachment

Purpose
Removes attached objects. It is part of the startworkflow container component.

Parameters

attachmentName (Optional) Name of the workflow attachment


objectId (Required) ID of the attachment.
packageName (Required) Name of the workflow package.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1633
removestartwfwfattachment

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\removeattachment\removeattachment_component.xml

Scope
All.

Elements
None.

removestartwfwfattachment

Purpose
This component is used with the startworkflow and taskmanager components. It is used to remove an
attachment from a workflow.

Parameters

attachmentName (Optional) Name of the attachment object being


removed from the workflow
docId (Required) ID of the attachment object being
removed from the workflow
objectId (Required) Process (template) ID

Description
Since
5.x

1634 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
removewfattachment

Configuration File
webcomponent\config\library\workflow\removeattachment\removewfattachment_component.xml

Scope
All.

Elements
None.

removewfattachment

Purpose
This component is used to remove an attachment from a workflow.

Parameters

attachmentName (Optional) Name of the attachment to be


removed from the workflow
objectId (Required) Workflow task ID
packageName (Optional) ID of the package associated with the
workflow from which the attachment is being
removed
wf_attachment_id (Required) ID of the attachment being removed
from the workflow

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\removeattachment\removewfattachment_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1635
reassignworkflowtask

Scope
All.

Elements
None.

reassignworkflowtask

Purpose
Delegate task in a workflow’s ReportDetailsSummary page.

Since
6.5

repeatworkflowtask

Purpose
Completes workflow tasks and assign repeat performers for them. You can use it only for repeatable
tasks.

Parameters

objectId (Required) ID of the workflow task to be


repeated.

Description

Since
5.x

1636 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
rerunfailedautoworkflowtask

Configuration File
webcomponent\config\library\workflow\taskmanager\repeatworkflowtask_component.xml

Scope
All.

Elements
None.

rerunfailedautoworkflowtask

Purpose
Retries failed automatic workflow tasks. You can use it only for failed automatic tasks. It is invoked
from the task manager.

Parameters

objectId (Required) ID of failed autoworkflow task.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\rerunautotask_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1637
resumetask (type dm_task)

resumetask (type dm_task)

Purpose
Resumes a task in a workflow that was previously halted. This component is defined for dm_task
objects.

Parameters

objectId (Required) ID of the work item.


objectName (Required) Task name.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\resume\resumetask_component.xml

Scope

type dm_task

Elements
None.

resumeworkflow (type dm_workflow)

Purpose
Resumes halted workflow objects.

1638 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
startwfattachment

Parameters

objectId (Required) ID of the workflow.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\resume\resumeworkflow_component.xml

Scope

type dm_workflow

Elements
None.

startwfattachment

Purpose
Manages the attachment information during the workflow initialization process. It is part of the
startworkflow container component.

Parameters

attachmentIds (Optional) IDs of attachments to workflow


objectId (Required) ID of the workflow process

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1639
startwfcomments

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\attachment\startwfattachment_component.xml

Scope
All.

Elements
None.

startwfcomments

Purpose
Manages the process of adding notes to attachments during the workflow initialization process. It
is part of the startworkflow component group.

Parameters

objectId (Required) ID of the workflow process

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\comments\startwfcomments_component.xml

Scope
All.

1640 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
startwfcontainer (type dm_process)

Elements
showheaderforsinglepackage
See showheaderforsinglepackage, page 835.

startwfcontainer (type dm_process)

Purpose
Extends propertysheetcontainer, page 928 and operates on dm_process (template) objects.

Parameters

attachmentIds (Optional) IDs of attachments to workflow


component (Optional) Start component
objectId (Required) ID of the workflow process
startworkflowId (Required) ID of the workflow
type (Required) Object type of the attachment, passed
to the contained components

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\startwfcontainer\startwfcontainer_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope

type dm_process

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1641
startwfperformers

Elements
asynchronous
See asynchronous, page 809.
failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

startwfperformers

Purpose
Manages the process of performer assignment. It is part of the startworkflow component group.

Parameters

objectId (Required) ID of the workflow process

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\performers\startwfperformers_component.xml

Scope
All.

Elements
None.

1642 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
startwfxformcontainer (type dm_process)

startwfxformcontainer (type dm_process)

Purpose
Container for the startwfperformers, page 1642 and the startwfcomments, page 1640 components.

Parameters
The parameters are inherited from startwfcontainer:webcomponent/config/library/workflow/
startwfcontainer/startwfcontainer_component.xml. See startwfcontainer (type dm_process), page
1641.

Description
Since
6.0

Configuration File
webcomponent\config\library\workflow\startworkflowxformcontainer\startworkflowxformcontainer_
component.xml

Parent Definition
startwfcontainer:webcomponent/config/library/workflow/startwfcontainer/startwfcontainer_
component.xml

Scope

type dm_process

Elements
asynchronous
See asynchronous, page 809.

formsavefolderpath
See formsavefolderpath, page 820.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1643
startworkflow

startworkflow

Purpose
Displays the info for a workflow. The component has a classic‑style layout. It is part of the group of
task manager components.

Parameters

objectId (Required) ID of the workflow process

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\startworkflow\startworkflow_component.xml

Scope
All.

Elements
defaultformacl
You must specify a default ACL.
Since 6.0 SP1.

formsavefolderpath
See formsavefolderpath, page 820.

1644 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
startworkflowdrilldown

startworkflowdrilldown

Purpose
Extends startworkflow, page 1644 and displays the Info tab on a workflow. The component has a
streamline‑style layout. It is part of the group of task manager components. Deprecated as of version 6.

Parameters
The parameters are inherited from startworkflow:/webcomponent/config/library/workflow/
startworkflow/startworkflow_component.xml. See startworkflow, page 1644.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\startworkflow\startworkflowdrilldown_component.xml

Parent Definition
startworkflow:/webcomponent/config/library/workflow/startworkflow/startworkflow_component.
xml

Scope
All.

Elements
formsavefolderpath
See formsavefolderpath, page 820.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1645
startworkflowtemplatelocatorcontainer

startworkflowtemplatelocatorcontainer

Purpose
Extends wftemplatelocatorcontainer, page 1669 and launches the workflow operation after the
user selects the workflow template. The contained components locate various kinds of workflows
and templates.

Parameters

componentArgs (Optional) Supplied by the LaunchComponent


class.) List of arguments and values to pass to
each contained component.
objectId (Optional) Attachment ID
startworkflowId (Required) ID of the workflow

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\startworkflow\startworkflowtemplatelocatorcontainer_
component.xml

Parent Definition
wftemplatelocatorcontainer:webcomponent/config/library/locator/wftemplatelocators_component.
xml

Scope
All.

Elements
None.

1646 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
startworkflowxforms

startworkflowxforms

Purpose
Starts a workflow using the xforms component.

Parameters

activityId (Optional) Object ID of the initial activity.


deleteOnCancel (Optional) Whether to delete the workflow
instance when the workflow instance is cancelled
(true) or not (false).
isactivityformtemplate (Optional) Whether the initial activity is a form
template (true) or not (false).
isNew (Optional) Whether the workflow is new (true)
or existing (false).
objectId (Required) Object ID of the workflow instance.
templateId (Optional) Object ID of the workflow template.

Description

Since
6.0

Configuration File
webcomponent\config\library\workflow\startworkflow\startworkflowxforms_component.xml

Parent Definition
xforms:webcomponent/config/xforms/xforms_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1647
taskattachment

taskattachment

Purpose
Manages the attachments to tasks in the inbox.

Parameters

objectId (Required) ID of the workflow process

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\attachment\taskattachment_component.xml

Scope
All.

Elements
None.

taskcomments

Purpose
Adds notes to inbox tasks. It is part of the task manager component.

Parameters

objectId (Required) ID of the workflow process

1648 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
taskcomponentcontainer

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\comments\taskcomments_component.xml

Scope
All.

Elements
showheaderforsinglepackage
See showheaderforsinglepackage, page 835.

taskcomponentcontainer

Purpose
Extends the component wizardcontainer, page 1201 and displays task components for workflows.

Parameters

component (Required) Start component.


objectId (Required) ID of the workflow process.
type (Required) Task type. Valid values:
dm_notification | dm_queued | dm_task. The
type is passed by the taskmanagercontainer
component to the contained components.
userCost (Optional) Currency cost, such as dollars, euros,
or other type of cost defined by customer. Value
is stored as a double.
userTime (Optional) Time in units defined by the customer.
Value is stored as an integer.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1649
taskheader

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\taskcomponentcontainer_component.xml

Parent Definition
wizardcontainer:wdk/config/wizardcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from wizardcontainer:wdk/config/wizardcontainer_component.
xml. See wizardcontainer, page 1201.

taskheader

Purpose
Displays header information for tasks. It is part of the task manager and start workflow component
groups.

Parameters

objectId (Required) ID of the task


taskName (Optional) Name of the task

Description

Since
5.x

1650 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
taskhistory

Configuration File
webcomponent\config\library\workflow\taskheader\taskheader_component.xml

Scope
All.

Elements
None.

taskhistory

Purpose
Displays runtime or audit history of a workflow that generated a specific task. It is part of the task
manager component group.

Parameters

objectId (Required) ID of the task

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskhistory\taskhistory_component.xml

Scope
All.

Elements
events
1 <events>
2<visibility name="dm_abortworkflow">true</visibility>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1651
taskinfo

...
</events>

1 Contains <visibility> elements which correspond to individual audit events.


2 Corresponds to an event. Set to true to display the specified event. Set the name attribute to
correspond to an audit type such as dm_signoff.
historytype
<historytype>runtime</historytype>

Specifies audit or runtime. Valid values: audit | auditorruntime (shows audit if available) | runtime
(default = runtime)

taskinfo

Purpose
Displays next and previous task information for specific tasks. It is part of the task manager.

Parameters

objectId (Required) ID of the task

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskinfo\taskinfo_component.xml

Scope
All.

Elements
showtaskinfo
1 <showtaskinfo>

1652 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
taskmanager

2<next>true</next>
3<previous>false</previous>
</showtaskinfo>

1 Whether to display or hide information about the previous and next tasks. Contains <next> and
<previous> elements.
2 True to display information about the next task.
3 True to display information about the previous task.

taskmanager

Purpose
Displays the info tab in the taskmanager component group. It is the main component in the group of
task manager components, which are contained in the taskmanagercontainer component.

Parameters

objectId (Required) ID of the task

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\taskmanager_component.xml

Scope
All.

Elements
defaultformacl
You must specify a default ACL.
Since 6.0 SP1

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1653
taskmanagercontainer (type dm_notification)

failoverenabled
See failoverenabled, page 819.

formsavefolderpath
See formsavefolderpath, page 820.
showusertimeandcost
See showusertimeandcost, page 836.

taskmanagercontainer (type dm_notification)

Purpose
Extends propertysheetcontainer, page 928. This component is defined for following scopes:
dm_notification, dm_queued, dm_router_task, and dm_task. The definitions for dm_notification,
dm_queued, and dm_router_task do not contain components.

Parameters

component (Optional) Specifies the ID of the component to


initialize
objectId (Required) Task ID
taskmanagerId (Required) ID of the taskmanager object
type (Required) Not used (any value can be inserted)

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmgrcontainer\taskmanagercontainer_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

1654 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
taskmanagercontainer (type dm_router_task)

Scope

type dm_notification

Elements
failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

taskmanagercontainer (type dm_router_task)

Purpose
Extends propertysheetcontainer, page 928. This component is defined for following scopes:
dm_notification, dm_queued, dm_router_task, and dm_task. The definitions for dm_notification,
dm_queued, and dm_router_task do not contain components.

Parameters

component (Optional) Specifies the ID of the component to


initialize
objectId (Required) Task ID
taskmanagerId (Required) ID of the taskmanager object
type (Required) Not Used (any value can be inserted)

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmgrcontainer\taskmanagercontainer_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1655
taskmanagercontainer (type dm_task)

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope

type dm_router_task

Elements
failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

taskmanagercontainer (type dm_task)

Purpose
Extends propertysheetcontainer, page 928. This component is defined for following scopes:
dm_notification, dm_queued, dm_router_task, and dm_task. The definitions for dm_notification,
dm_queued, and dm_router_task do not contain components.

Parameters

component (Optional) Specifies the ID of the component to


initialize
objectId (Required) Task ID
taskmanagerId (Required) ID of the taskmanager object
type (Required) Not used (any value can be inserted)

Description

Since
5.x

1656 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
taskmgrabortworkflow (type dm_task)

Configuration File
webcomponent\config\library\workflow\taskmgrcontainer\taskmanagercontainer_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope

type dm_task

Elements
failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

taskmgrabortworkflow (type dm_task)

Purpose
Extends the abortworkflow component and aborts workflows that generated failed automatic
workflow tasks. It is invoked from the taskmanager component.

Parameters
The parameters are inherited from abortworkflow:webcomponent/config/library/workflow/abort/
abortworkflow_component.xml. See abortworkflow (type dm_workflow), page 1599.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmanager\taskmgrabortworkflow_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1657
taskprocessvariables

Parent Definition
abortworkflow:webcomponent/config/library/workflow/abort/abortworkflow_component.xml

Scope

type dm_task

Elements
None.

taskprocessvariables

Purpose
Displays a workflow’s process variables (defined in Business Process Manager) for which a user can
specify values.

Parameters

objectId (Required) ID of the dm_workflow object.

Description
Since
6.0

Configuration File
webcomponent\config\library\workflow\taskprocessvariables\taskprocessvariables_component.
xml

Scope
All.

Elements
None.

1658 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
taskprogress

taskprogress

Purpose
Contains taskhistory and taskinfo components. It is part of the task manager component group.

Parameters

objectId (Required) ID of the workflow process

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskprogress\taskprogress_component.xml

Scope
All.

Elements
None.

webwfm

Purpose
Launches the Web workflow manager applet. This component is launched by the following actions:
new, view, editfile, and delete on a single object of type dm_process (template) objects, and the view
action on a single dm_workflow (template) object. The container extends combocontainer, page 1183.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1659
webwfm

Parameters

objectId (Required) ID of a process, a workflow, or a


folder or cabinet in which to create the workflow.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\webwfm\webwfm_component.xml

Scope
All.

Usage
The Web workflow manager applet requires the Sun virtual machine in the client browser. The user is
prompted to install the required VM when the workflow manager is called.
The Web workflow manager is called for a single object. If a workflow or template is edited, it must
be checked in through the Web workflow manager UI. Checkin for workflows and templates is
disabled in the Webtop UI.

Elements
helppath
See helppath, page 821.

map
See map, page 824.

maxidletime
See maxidletime, page 824.

1660 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
webwfm_checkjvm

webwfm_checkjvm

Purpose
This component is a container for the web workflow manager component that also checks the Java
Virtual Machine to ensure that it is compatible.

Parameters
The parameters are inherited from webwfm:webcomponent/config/library/workflow/webwfm/
webwfm_component.xml. See webwfm, page 1659.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\webwfm\webwfm_component.xml

Parent Definition
webwfm:webcomponent/config/library/workflow/webwfm/webwfm_component.xml

Scope
All.

Elements
helppath
See helppath, page 821.

map
See map, page 824.
maxidletime
See maxidletime, page 824.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1661
webwfmcontainer

webwfmcontainer

Purpose
Container component for the Workflow Manager.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\webwfm\webwfmcontainer_component.xml

Parent Definition
combocontainer:wdk/config/combocontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

propagatepreviouspagevalues
This element structure is inherited from combocontainer:wdk/config/combocontainer_component.xml.
See combocontainer, page 1183.

1662 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
webwfmeditcontainer

webwfmeditcontainer

Purpose
This component calls the component webwfm, page 1659 to launch the Web workflow manager applet
in editing mode. This container extends combocontainer, page 1183.

Parameters
The parameters are inherited from combocontainer:wdk/config/combocontainer_component.xml. See
combocontainer, page 1183.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\webwfm\webwfmeditcontainer_component.xml

Parent Definition
webwfmcontainer:webcomponent/config/library/workflow/webwfm/webwfmcontainer_component.
xml

Scope
All.

Elements
None.

wfgrouponlylocator

Purpose
Extends userorgrouplocator, page 1526 and selects groups in workflow operations. The container
component extends locatorcontainer, page 1081.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1663
wfgrouponlylocator

Parameters
The parameters are inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

Description

Since
5.x

Configuration File
webcomponent\config\library\workflow\wfgrouponlylocator_component.xml

Parent Definition
userorgrouplocator:webcomponent/config/library/locator/userorgrouplocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


failoverenabled
This element structure is inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.


iconwell_icon
See iconwell_icon, page 822.

objecttype
<objecttype>dm_group</objecttype>

1664 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
wfgrouponlylocatorcontainer

Specifies the object type of the objects to locate.


preset_item
See preset_item, page 830.
privategroupvisible
See privategroupvisible, page 832.

views
See views, page 839.

workqueuegroupvisible
See workqueuegroupvisible, page 841.

wfgrouponlylocatorcontainer

Purpose
This component is the container for the component wfgrouponlylocator, page 1663, which is used to
select groups in workflow operations.

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Optional) Boolean: Set to true to support
multiple selection.
repository (Optional) ID of the repository in which to search

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1665
wfrecentuseronlylocator

Configuration File
webcomponent\config\library\workflow\wfgrouponlylocator_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

wfrecentuseronlylocator

Purpose
This component is used to search for users who were recently selected or changed. It is used in
conjunction with workflow operations.

Parameters
The parameters are inherited from recentuserorgrouplocator:webcomponent/config/library/locator/
recentuserorgrouplocator_component.xml. See recentuserorgrouplocator, page 1509.

Description

Since
5.x

Configuration File
webcomponent\config\library\workflow\wfuseronlylocatorcontainer_component.xml

Parent Definition
recentuseronlylocator:webcomponent/config/library/locator/useronlylocator_component.xml

1666 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
wfsysobjectlocatorcontainer

Scope
All.

Elements
objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to locate.

useronly
See useronly, page 838.

wfsysobjectlocatorcontainer

Purpose
Contains sysobjectlocator, page 1091 and recentsysobjectlocator, page 1090.

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description

Since
5.x

Configuration File
webcomponent\config\library\workflow\wfsysobjectlocatorcontainer_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1667
wftemplatefolderlocator

Elements
multidocbasesupport
See multidocbasesupport, page 825.

wftemplatefolderlocator

Purpose
Locates folders containing dm_process objects (workflow templates) in a repository.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\wftemplatelocators_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>true</allversionsvisible>

1 See allversionsvisible, page 809.

1668 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
wftemplatelocatorcontainer

columns
See columns (for data columns), page 811.

containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


contenttypepanelvisible
1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.

filenamefiltervisible
<filenamefiltervisible>true</filenamefiltervisible>
See filenamefiltervisible, page 819.
flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.

objecttype
<objecttype>dm_process</objecttype>

Specifies the object type of the objects to locate.


privatecabinetvisible
1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

views
See views, page 839.

wftemplatelocatorcontainer

Purpose
Contains workflow template locators: allwftemplatelocator, page 1602, wftemplatesubscriptionlocator,
page 1670, mywftemplatelocator, page 1628, wftemplatefolderlocator, page 1668, and
recentwftemplatelocator, page 1630.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1669
wftemplatesubscriptionlocator

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description

Since
5.x

Configuration File
webcomponent\config\library\locator\wftemplatelocators_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

wftemplatesubscriptionlocator

Purpose
Locates and displays workflow templates to which the user has subscribed.

Parameters
The parameters are inherited from subscriptionlocator:webcomponent/config/library/locator/
subscriptionlocator_component.xml. See subscriptionlocator, page 1423.

1670 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
wftemplatesubscriptionlocator

Description
Since
5.x

Configuration File
webcomponent\config\library\locator\wftemplatelocators_component.xml

Parent Definition
subscriptionlocator:webcomponent/config/library/locator/subscriptionlocator_component.xml

Scope
All.

Elements
allversionsvisible
1 <allversionsvisible>true</allversionsvisible>

1 See allversionsvisible, page 809.

columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.

iconwell_icon
See iconwell_icon, page 822.
objecttype
<objecttype>dm_process</objecttype>

Specifies the object type of the objects to locate.


privatecabinet_visible
See privatecabinet_visible, page 831.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1671
wfuseronlylocator

views
See views, page 839.

wfuseronlylocator

Purpose
Contains workflow user locators useronlylocator, page 1523 and recentuseronlylocator, page 1507.

Parameters
The parameters are inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\wfuseronlylocatorcontainer_component.xml

Parent Definition
useronlylocator:webcomponent/config/library/locator/useronlylocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

containerselectable
1 <containerselectable>false</containerselectable>

1 See containerselectable, page 814.

1672 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
wfuseronlylocatorcontainer

objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to locate.

privategroupvisible
See privategroupvisible, page 832.

wfuseronlylocatorcontainer

Purpose
This component allows the selection of users for workflow operations. It displays the component
wfuseronlylocator, page 1672.

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) ID of the selected object
repository (Optional) ID of the repository in which to search

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\wfuseronlylocatorcontainer_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1673
wfuserorgroupfromgrouplocator

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

wfuserorgroupfromgrouplocator

Purpose
Locates users who are members of a specific group. It is used in workflow operations.

Parameters

groupName (Optional) Name of group from which to locate


users and groups
multiselect (Optional) Set to true to support multiple
selection.
objecttype (Optional) Type of object to locate

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\wfuserorgroupfromgrouplocator_component.xml

Parent Definition
userorgrouplocator:webcomponent/config/library/locator/userorgrouplocator_component.xml

Scope
All.

1674 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
wfuserorgroupfromgrouplocator

Elements
columns
See columns (for data columns), page 811.
containerselectable
1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.


failoverenabled
This element structure is inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.


iconwell_icon
See iconwell_icon, page 822.

objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to locate.

preset_item
See preset_item, page 830.
privategroupvisible
See privategroupvisible, page 832.
views
See views, page 839.

workqueuegroupvisible
See workqueuegroupvisible, page 841.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1675
wfuserorgroupfromgrouplocatorcontainer

wfuserorgroupfromgrouplocatorcontainer

Purpose
Contains the userorgrouplocator component used in the sendtodistributionlist component.

Parameters

arrangeselect (Optional) True to allow selection of workflow


performers in a sequential order.
groupName (Optional) Name of the group of which the listed
users/groups are to be members
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) Type of the selected object
repository (Optional) Repository in which to search
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs of the selected
recipients (users and groups).Since 6.0.

Description

Since
5.x

Configuration File
webcomponent\config\library\workflow\wfuserorgroupfromgrouplocator_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

1676 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
wfuserorgrouplocator

Elements
multidocbasesupport
See multidocbasesupport, page 825.

wfuserorgrouplocator

Purpose
This component is used to locate active users or groups in a repository. The component allows a user
navigate from usergroups to find a user or group.

Parameters
The parameters are inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\wfuserorgrouplocatorcontainer_component.xml

Parent Definition
userorgrouplocator:webcomponent/config/library/locator/userorgrouplocator_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

containerselectable
1 <containerselectable>true</containerselectable>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1677
wfuserorgrouplocatorcontainer

1 See containerselectable, page 814.


failoverenabled
This element structure is inherited from userorgrouplocator:webcomponent/config/library/locator/
userorgrouplocator_component.xml. See userorgrouplocator, page 1526.
flatlist
1 <flatlist>false</flatlist>

1 See flatlist, page 820.

iconwell_icon
See iconwell_icon, page 822.

includeunlisted
See includeunlisted, page 823.

objecttype
<objecttype>dm_user</objecttype>

Specifies the object type of the objects to locate.

preset_item
See preset_item, page 830.
privategroupvisible
See privategroupvisible, page 832.

views
See views, page 839.
workqueuegroupvisible
See workqueuegroupvisible, page 841.

wfuserorgrouplocatorcontainer

Purpose
Container for simple user‑or‑group locator used in sendtodistributionlist.

1678 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
wfuserorgrouplocatorcontainer

Parameters

arrangeselect (Optional) Boolean: Set to true to allow selection


of users in a sequential order.
flatlist (Optional) Boolean: Set to true to list objects in a
flat list.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Optional) The type of the selected object
repository (Optional) ID of the repository in which to search
selectedobjectids (Optional) IDs of objects that are selected when
the component is displayed

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\wfuserorgrouplocatorcontainer_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1679
workflowavailability

workflowavailability

Purpose
Launched by the action workflowavailability, page 754 in dialogcontainer, page 1185, this component
sets the user’s availability to receive workflows.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\availability\workflowavailability_component.xml

Scope
All.

Elements
None.

workflowcalendar

Purpose
Represents a workflow business calendar.

1680 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
workflowcalendarcontainer

Parameters

objectId (Required) Object ID of the workflow business


calendar.
objectname (Optional) Object name of the workflow business
calendar.

Description
Since
6.0 SP1

Configuration File
webcomponent\config\library\workflow\calendar\workflowcalendar_component.xml

Scope
All.

Elements
None.

workflowcalendarcontainer

Purpose
Displays the properties of a workflow business calendar.

Parameters

objectId (Required) Object ID of the workflow business


calendar.
objectname (Optional) Object name of the workflow business
calendar.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1681
workflowcalendardetails

actiontype (Optional) Not used.


component (Optional) Not used.

Description

Since
6.0 SP1

Configuration File
webcomponent\config\library\workflow\calendar\workflowcalendardetails_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope
All.

Elements
None.

workflowcalendardetails

Purpose
Displays detailed information about a workflow business calendar.

Parameters

objectId (Optional) Object ID of the workflow calendar.

1682 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
workflowcalendareditcontainer

Description
Since
6.0 SP1

Configuration File
webcomponent\config\library\workflow\calendar\workflowcalendardetails_component.xml

Scope
All.

Elements
None.

workflowcalendareditcontainer

Purpose
Displays and enables editing the properties of a workflow business calendar.

Parameters

objectId (Required) Object ID of the workflow business


calendar.
objectname (Optional) Object name of the workflow business
calendar.
actiontype (Optional) Not used.
component (Optional) Supplied by the LaunchComponent
action execution class.) The name of the
component to contain.

Description
Since
6.0 SP1

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1683
workflowcalendarevent

Configuration File
webcomponent\config\library\workflow\calendar\workflowcalendardetails_component.xml

Parent Definition
workflowcalendarcontainer:webcomponent/config/library/workflow/calendar/
workflowcalendarcontainer_component.xml

Scope
All.

Elements
None.

workflowcalendarevent

Purpose
Enables editing an existing or creating a new workflow business calendar event.

Parameters

objectId (Required) Object ID of the workflow business


calendar event.
objectname (Optional) Object name of the workflow business
calendar event.

Description
Since
6.0 SP1

Configuration File
webcomponent\config\library\workflow\calendar\workflowcalendarevent_component.xml

1684 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
workflowcalendarlist

Scope
All.

Elements
None.

workflowcalendarlist

Purpose
Displays a list of all workflow business calendars.

Parameters
None.

Description
Since
6.0 SP1

Configuration File
webcomponent\config\library\workflow\calendar\workflowcalendarlist_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1685
workflowstatusclassic (Webtop)

workflowstatusclassic (Webtop)

Purpose
Extends the WDK workflowstatuslist component and lists workflow objects and their statuses, using a
list layout. Reads in the user display preferences.

Parameters
The parameters are inherited from workflowstatuslist:webcomponent/config/library/workflow/status/
workflowstatuslist_component.xml. See workflowstatuslist, page 1687.

Description
Since
5.x

Configuration File
webtop\config\workflowstatusclassic_component.xml

Parent Definition
workflowstatuslist:webcomponent/config/library/workflow/status/workflowstatuslist_component.
xml

Scope
All.

Elements
None.

workflowstatusdrilldown

Purpose
Lists workflow objects and their statuses, using a streamline layout. Deprecated as of version 6.

1686 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
workflowstatuslist

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\status\workflowstatusdrilldown_component.xml

Scope
All.

Elements
None.

workflowstatuslist

Purpose
Lists workflow objects and their statuses, using a list layout.

Parameters

mode (Optional) Specifies the workflows to be


displayed. Valid values: all (shows all
workflows) | supervisor (shows workflows
supervised by the current user) | creator (shows
workflows created by the current user) |
supervisorcreator (shows workflows supervised
or created by the current user)

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1687
workflowstatusstreamline (Webtop)

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\status\workflowstatuslist_component.xml

Scope
All.

Elements
None.

workflowstatusstreamline (Webtop)

Purpose
Extends the WDK workflowstatusdrilldown component and lists workflow objects and their statuses,
using a streamline layout.

Parameters
None.

Description

Since
5.x

Configuration File
webtop\config\workflowstatusstreamline_component.xml

Parent Definition
workflowstatusdrilldown:webcomponent/config/library/workflow/status/workflowstatusdrilldown_
component.xml

1688 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
workflowxforms

Scope
All.

Elements
None.

workflowxforms

Purpose
Workflow that uses the xforms component.

Parameters
The parameters are inherited from xforms:webcomponent/config/xforms/xforms_component.xml.
See xforms, page 1761.

Description

Since
6.0

Configuration File
webcomponent\config\library\workflow\workflowxforms\workflowxforms_component.xml

Parent Definition
xforms:webcomponent/config/xforms/xforms_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1689
advanceprocessorqueuelist

Work queue management

advanceprocessorqueuelist

Purpose
List the work queues for an advanced queue processor.

Parameters

category_path (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
nodeIds (Optional) IDs of the nodes.
object_name (Optional) Name of the dm_user object with role
set to advance_queue_processor.
objectId (Optional) ID of the dm_user object with role set
to advance_queue_processor.

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\list\advanceprocessorqueuelist_component.xml

Scope
All.

Elements
wqlist

1690 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
allworkqueuecategorylocator

<wqlist>true</wqlist>

Whether to display (true) or hide (false) the work queue list.

columns
See columns (for data columns), page 811.

nodes
See nodes, page 825.

allworkqueuecategorylocator

Purpose
Lists all defined work queue categories.

Parameters

arrangeselect (Optional) Not used.


multiselect (Optional) Boolean: Set to true to support
multiple selection.
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\workqueuecategorylocators_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1691
allworkqueuecategorylocator

Scope
All.

Elements
iconwell_icon
See iconwell_icon, page 822.

objecttype

<objecttype>dmc_workqueue_category</objecttype>

Specifies the object type of the objects to locate.

containerselectable

1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

allversionsvisible

1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

views
See views, page 839.

columns
See columns (for data columns), page 811.

contenttypepanelvisible

1 <contenttypepanelvisible>false</contenttypepanelvisible>

1692 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
assignqueuedtask

1 See contenttypepanelvisible, page 815.

filenamefiltervisible
See filenamefiltervisible, page 819.

assignqueuedtask

Purpose
Assigns a task from a work queue to a processor.

Parameters

objectId (Required) ID of the task to assign


performer (Required) ID of the user to whom the task will
be assigned
queueName (Required) Name of the work queue

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\assignqueuedtask_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1693
assignqueuedtaskcontainer

assignqueuedtaskcontainer

Purpose
Container object for assigning tasks from a work queue to a processor. Contains the component
assignqueuedtask, page 1693.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class.) The name of the
component to contain.
componentArgs (Required) Supplied by the LaunchComponent
action execution class.) List of arguments and
values to pass to each contained component.

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\assignqueuedtaskcontainer_component.xml

Parent Definition
multiargdialogcontainer:webcomponent/config/library/multiargdialogcontainer/
multiargdialogcontainer_component.xml

Scope
All.

Elements
None.

1694 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (type dm_queued)

delete (type dm_queued)

Purpose
The delete component deletes dm_folders and other dm_sysobjects, deletes inbox notifications
(dm_notification and dm_queued), and deletes folders (queries the user whether all objects should be
deleted from a folder selected for deletion). This component must be used within the deletecontainer
component.

Parameters

objectId (Required) ID of the object to be deleted. Applies


to all types.
objectName (Optional) Name of the object to be deleted.
Applies only to dm_notification and dm_queued
types.

Description

Since
5.x

Configuration File
webcomponent\config\library\delete\delete_queued_component.xml

Scope

type dm_queued

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1695
delete (type dmc_workqueue_category)

delete (type dmc_workqueue_category)

Purpose
Deletes a work queue category. A work queue category can be deleted only if it does not contain
any work queues or other categories.

Parameters
The parameters are inherited from delete:webcomponent/config/library/queuemanagement/delete/
deleteworkqueueobject_component.xml. See delete, page 1118.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\delete\deleteworkqueuecategory_component.
xml

Parent Definition
delete:webcomponent/config/library/queuemanagement/delete/deleteworkqueueobject_component.
xml

Scope

type dmc_workqueue_category

Elements
None.

1696 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (type dmc_workqueue_doc_profile)

delete (type dmc_workqueue_doc_profile)

Purpose
Deletes a work queue document profile. A work queue document profile can be deleted only if
no work items reference it.

Parameters
The parameters are inherited from delete:webcomponent/config/library/queuemanagement/delete/
deleteworkqueueobject_component.xml. See delete, page 1118.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\delete\deleteworkqueuedocprofile_component.
xml

Parent Definition
delete:webcomponent/config/library/queuemanagement/delete/deleteworkqueueobject_component.
xml

Scope

type dmc_workqueue_doc_profile

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1697
delete (type dmc_workqueue_policy)

delete (type dmc_workqueue_policy)

Purpose
Deletes a work queue policy. A work queue policy can be deleted only if the work queue policy is not
referenced by any work item, work queue, or work queue document profile.

Parameters
The parameters are inherited from delete:webcomponent/config/library/queuemanagement/delete/
deleteworkqueueobject_component.xml. See delete, page 1118.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\delete\deleteworkqueuepolicy_component.xml

Parent Definition
delete:webcomponent/config/library/queuemanagement/delete/deleteworkqueueobject_component.
xml

Scope

type dmc_workqueue_policy

Elements
None.

delete (type dmc_workqueue)

Purpose
Deletes a work queue. A work queue can be deleted only if it contains no work items.

1698 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
delete (type dmc_wq_skill_info)

Parameters
The parameters are inherited from delete:webcomponent/config/library/queuemanagement/delete/
deleteworkqueueobject_component.xml. See delete, page 1118.

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\delete\deleteworkqueue_component.xml

Parent Definition
delete:webcomponent/config/library/queuemanagement/delete/deleteworkqueueobject_component.
xml

Scope

type dmc_workqueue

Elements
None.

delete (type dmc_wq_skill_info)

Purpose
Deletes dmc_wq_skill_info objects.

Parameters
The parameters are inherited from delete:webcomponent/config/library/queuemanagement/delete/
deleteworkqueueobject_component.xml. See delete, page 1118.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1699
docprofileadd

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\delete\deletewqskillinfo_component.xml

Parent Definition
delete:webcomponent/config/library/queuemanagement/delete/deleteworkqueueobject_component.
xml

Scope

type dmc_wq_skill_info

Elements
None.

docprofileadd

Purpose
Adds a work queue document profile.

Parameters

objectId (Optional) Not used.

Description

Since
5.x

1700 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
docprofileattributes

Configuration File
webcomponent\config\library\queuemanagement\docprofileadd_component.xml

Scope
All.

Elements
None.

docprofileattributes

Purpose
Edits the attributes of a work queue document profile.

Parameters

objectId (Required) ID of the document profile object for


which you want to set attributes.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\docprofileattributes_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1701
docprofilelist

docprofilelist

Purpose
Displays a list of the available queue management document profiles.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\list\docprofilelist_component.xml

Scope
All.

Elements
showbreadcrumb
See showbreadcrumb, page 835.

editprocessorauthentication

Purpose
Displays a page in the Properties component for a work queue processor, enabling the user to set the
processor’s skill level and available document profiles. The component does not save the work queue
processor profile, but passes any changes back to the calling component.

1702 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
managequeueinbox

Parameters

docprofile_enable (Optional) Boolean: set to true to enable the user


to change the work queue document profile
assigned to the processor. Default is false.
docprofile_name (Optional) Name of the work queue document
profile.
skill (Optional) Skill level of the user for this work
queue. Valid values are the skill level strings
from the data dictionary.
username (Required) User name of the work queue
processor.
wq_name (Required) Name of the work queue.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\editprocessorauthentication_component.xml

Scope
All.

Elements
None.

managequeueinbox

Purpose
Lists all uncompleted tasks in a work queue, both assigned and unassigned.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1703
managequeueinbox

Parameters

categoryPath (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
queuename (Required) Name of the work queue.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\managequeueinbox_component.xml

Scope
All.

Elements
showbreadcrumb
See showbreadcrumb, page 835.

showfilters
See showfilters, page 835.

failoverenabled
See failoverenabled, page 819.

useroptions
See useroptions, page 838.
columns
See columns (for streamline view), page 811.

1704 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
movetoqueue

movetoqueue

Purpose
Moves a task from one work queue to another.

Parameters
The parameters are inherited from assignqueuedtask:webcomponent/config/library/
queuemanagement/assignqueuedtask_component.xml. See assignqueuedtask, page 1693.

Description
Since
6.0

Configuration File
webcomponent\config\library\queuemanagement\movetoqueue_component.xml

Parent Definition
assignqueuedtask:webcomponent/config/library/queuemanagement/assignqueuedtask_component.
xml

Scope
All.

Elements
None.

movetoqueuecontainer

Purpose
Moves one or more selected queued tasks to another work queue.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1705
policyattributes

Parameters

component (Required) Supplied by the LaunchComponent


action execution class.) The name of the
component to contain.
componentArgs (Required) Supplied by the LaunchComponent
action execution class.) List of arguments and
values to pass to each contained component.

Description
Since
5.x

Configuration File
webcomponent\config\actions\movetoqueuecontainer_component.xml

Parent Definition
multiargdialogcontainer:webcomponent/config/library/multiargdialogcontainer/
multiargdialogcontainer_component.xml

Scope
All.

Elements
None.

policyattributes

Purpose
Sets the attributes for a work queue policy.

1706 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
policylist

Parameters

objectId (Required) ID of the work queue policy object


whose attributes to set.
selectPolicy (Optional) Boolean: Whether all policy attributes
are read‑only, so users can select an existing
policy only (True) or all fields are editable, so
users can create a new policy (False). Default is
false.Since 6.0.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\policyattributes_component.xml

Scope
All.

Elements
objecttype

<objecttype>dmc_workqueue_policy</objecttype>

Specifies the object type of the objects to modify.

policylist

Purpose
Displays a list of the available work queue policies.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1707
processorattributes

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\list\policylist_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

showbreadcrumb
See showbreadcrumb, page 835.

processorattributes

Purpose
Sets the queue‑related attributes for a work queue processor.

Parameters

objectId (Required) ID of the user acting as a work queue


processor.
objectname (Required) Name of the user.

1708 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
processorauthenticationlocatorcontainer

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\processorattributes_component.xml

Scope
All.

Elements
None.

processorauthenticationlocatorcontainer

Purpose
Container component for specifying the work queue document profile, skill level, and work queues
for a newly defined work queue processor.

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\processorauthenticationlocator_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1709
processorauthenticationselect

Parent Definition
workqueuelocatorcontainer:webcomponent/config/library/queuemanagement/workqueuelocator_
component.xml

Scope
All.

Elements
None.

processorauthenticationselect

Purpose
Sets the skill level and document profile settings as part of adding a new work queue processor. The
component saves the work queue processor profile.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\processorauthenticationlocator_component.xml

Scope
All.

Elements
None.

1710 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
processorinfo

processorinfo

Purpose
Displays processor information.

Parameters

objectId (Required) ID of the work queue processor.


objectname (Required) Name of the work queue processor.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\processorinfo_component.xml

Scope
All.

Elements
None.

processormember

Purpose
Displays the members of a work queue.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1711
processorprofilecontainer

Parameters

objectId (Required) ID of the work queue object.


objectname (Required) Name of the work queue object.

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\processormember_component.xml

Scope
All.

Elements
None.

processorprofilecontainer

Purpose
Container for the processor profile properties.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class.) The name of the
component to contain.(Required) Supplied by

1712 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
processorprofilelist

the LaunchComponent action execution class.)


The name of the component to contain.
objectId (Required) ID of the user object for the work
queue processor.(Required) ID of the user object
for the work queue processor.
objectname (Required) Name of the user object for the work
queue processor.(Required) Name of the user
object for the work queue processor.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\processorprofilecontainer_component.xml

Parent Definition
queuemgmtpropertycontainer:webcomponent/config/library/queuemanagement/
queuemgmtpropertycontainer_component.xml

Scope
All.

Elements
None.

processorprofilelist

Purpose
Searches for a work queue processor profile or pages through a list of all the work queue processor
profiles in the repository.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1713
processorproperties

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\list\processorprofilelist_component.xml

Parent Definition
userlist:webcomponent/config/admin/user/userlist_component.xml

Scope
All.

Elements
showbreadcrumb
See showbreadcrumb, page 835.

processorproperties

Purpose
Sets the properties for a work queue processor.

Parameters

component (Required) ID of the component to display


objectId (Required) ID of the user object for the work
queue processor.
objectname (Required) Name of the user

1714 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
processorqueueinbox

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\processorproperties_component.xml

Parent Definition
adminpropertycontainer:webcomponent/config/admin/container/adminpropertycontainer_
component.xml

Scope
All.

Elements
objecttype

<objecttype>dm_user</objecttype>

Specifies the object type of the objects to modify.

processorqueueinbox

Purpose
Work queue inbox for a work queue processor.

Parameters

categoryPath (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
queuename (Required) Name of the work queue to display.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1715
processorskill

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\processorqueueinbox_component.xml

Scope
All.

Elements
failoverenabled
See failoverenabled, page 819.

useroptions
See useroptions, page 838.

showfilters
See showfilters, page 835.
columns
See columns (for streamline view), page 811.

processorskill

Purpose
Enables creating and updating a processor’s skills.

Parameters

objectId (Optional) ID of a dmc_wq_user_skill object.


objectname (Required) Name of a dmc_wq_user_skill object.

1716 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
processorskillattributes

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\processorskill_component.xml

Scope
All.

Elements
None.

processorskillattributes

Purpose
Enables modification of a work queue processor’s skill attributes.

Parameters

skill_info_id (Optional) skill_info_id attribute of the


dmc_wq_user_skill object.
skill_values (Optional) Values of the dmc_wq_user_skill
object.
user_name (Required) Name of the user object for the
processor.

Description
Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1717
processorworkloadinbox

Configuration File
webcomponent\config\library\queuemanagement\processorskillattributes_component.xml

Scope
All.

Elements
None.

processorworkloadinbox

Purpose
Provides a queue manager with a list of the tasks awaiting a work queue processor.

Parameters

categoryPath (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
objectname (Required) ID of the user object for the work
queue processor.
queueName (Required) Name of the work queue.

Description

Since
5.x

Configuration File
webcomponent\config\actions\processorworkloadinbox_component.xml

Scope
All.

1718 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
pullqueuedtask

Elements
showfilters
See showfilters, page 835.
showattachmentinfo
See showattachmentinfo, page 834.
columns
See columns (for streamline view), page 811.

pullqueuedtask

Purpose
Enables users, who are in the advanced_queue_processor role, to assign unassigned tasks from work
queues to themselves.

Parameters

objectId (Required) ID of the dm_task object to pull.


queueName (Required) Name of the dmc_workqueue to from
which to assign the dm_task object.

Description
Since
6.0

Configuration File
webcomponent\config\library\queuemanagement\pullqueuedtask_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1719
pullqueuedtaskcontainer

Elements
openTaskManager

<openTaskManager>true</openTaskManager>

Whether to enable (true) or disable (false) opening the task manager from within this component.

pullqueuedtaskcontainer

Purpose
Container for the pullqueuedtask, page 1719 component.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class.) The name of the
component to contain.
componentArgs (Required) Supplied by the LaunchComponent
action execution class.) List of arguments and
values to pass to each contained component.

Description
Since
6.0

Configuration File
webcomponent\config\library\queuemanagement\pullqueuedtaskcontainer_component.xml

Parent Definition
multiargdialogcontainer:webcomponent/config/library/multiargdialogcontainer/
multiargdialogcontainer_component.xml

1720 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
qualifiedqueueprocessorslocator

Scope
All.

Elements
None.

qualifiedqueueprocessorslocator

Purpose
Displays a selection list of users who are qualified to process tasks from a specific work queue.

Parameters

groupName (Required) Name of the dm_group object


representing the work queue.
multiselect (Optional) Boolean: Set to true to enable users to
select multiple processors.
objecttype (Optional) Object type of the users to display in
the selection list; default is dm_user.

Description
Since
5.x

Configuration File
webcomponent\config\actions\qualifiedqueueprocessorslocator_component.xml

Parent Definition
wfuserorgroupfromgrouplocator:webcomponent/config/library/workflow/
wfuserorgroupfromgrouplocator_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1721
qualifiedqueueprocessorslocatorcontainer

Elements
columns
See columns (for data columns), page 811.

qualifiedqueueprocessorslocatorcontainer

Purpose
Container component for selecting qualified queue processors. Contains the component
qualifiedqueueprocessorslocator, page 1721.

Parameters

arrangeselect (Optional) Not used.


groupName (Required) Name of the group to which users
must belong to process tasks in the queue.
multiselect (Optional) Boolean: Set to true to enable users to
select multiple processors.
objecttype (Optional) Object type of the users to display in
the selection list.

Description
Since
5.x

Configuration File
webcomponent\config\actions\qualifiedqueueprocessorslocator_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

1722 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
queueattributes

Elements
multidocbasesupport
See multidocbasesupport, page 825.

queueattributes

Purpose
Sets the attributes for a work queue.

Parameters

categoryPath (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
objectId (Required) ID of the work queue object.
objectname (Optional) Name of the work queue object.

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\queueattributes_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1723
queueinfo

queueinfo

Purpose
Enables creating and updating work queues.

Parameters

categoryPath (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
objectId (Required) ID of the work queue object.
objectname (Required) Name of the work queue object.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\queueinfo_component.xml

Scope
All.

Elements
None.

queuelist

Purpose
Displays a navigable list of the work queues and work queue categories.

1724 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
queuelist (Webtop)

Parameters

category_path (Optional) Not used.


object_name (Optional) Not used.
objectId (Optional) ID of the work queue category to
display as the initial starting point for the list.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\list\queuelist_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

showbreadcrumb
See showbreadcrumb, page 835.

queuelist (Webtop)

Purpose
Displays a navigable list of the work queues and work queue categories.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1725
queuelist (Webtop)

Parameters

category_path (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
nodeIds (Optional) IDs of queue management nodes in
the browsertree.
object_name (Optional) Not used.
objectId (Optional) Queue ID.

Description
Since
6.0

Configuration File
webtop\config\queuelistclassic_component.xml

Parent Definition
queuelist:webcomponent/config/library/queuemanagement/list/queuelist_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.
showbreadcrumb
See showbreadcrumb, page 835.

1726 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
queuemanagement (Webtop)

queuemanagement (Webtop)

Purpose
Displays admin nodes in the browsertree that handle work items in the queue.

Parameters

nodeIds (Optional)IDs of queue management nodes in


the browsertree.

Description
Since
5.x

Configuration File
webtop\config\queuemanagement_component.xml

Parent Definition
nodemanagement:webcomponent/config/admin/nodemanagement/nodemanagement_component.
xml

Scope
All.

Elements
None.

queuemanagementclipboard

Purpose
Displays contents of the Queue Management clipboard.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1727
queuemember

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\queuemanagementclipboard_component.xml

Parent Definition
clipboard:webcomponent/config/environment/clipboard/clipboard_component.xml

Scope
All.

Elements
dragdrop
See dragdrop, page 818.

queuemember

Purpose
Enables displaying and updating members of a work queue.

Parameters

objectId (Required) ID of the work queue object..


objectname (Required) Name of the work queue object.

1728 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
queuemgmtpropertycontainer

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\queuemember_component.xml

Scope
All.

Elements
None.

queuemgmtpropertycontainer

Purpose
Enables updating work queue properties.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class. The name of the
component to contain.
objectId (Required) ID of the work queue object.
objectname (Required) Name of the work queue object.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\queuemgmtpropertycontainer_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1729
queuemonitorlist

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

queuemonitorlist

Purpose
Displays overview information for monitoring the contents of work queues.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\queuemonitor_component.xml

Scope
All.

Elements
columns
See columns (for streamline view), page 811.

1730 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
queuepolicy

showbreadcrumb
See showbreadcrumb, page 835.

queuepolicy

Purpose
Enables displaying and updating work queue policies.

Parameters

objectId (Required) ID of the work queue policy object.

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\queuepolicy_component.xml

Parent Definition
policyattributes:webcomponent/config/library/queuemanagement/policyattributes_component.xml

Scope
All.

Elements
objecttype

<objecttype>dmc_workqueue_policy</objecttype>

Specifies the object type of the objects to display.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1731
queuepropertiescontainer

queuepropertiescontainer

Purpose
Container for the work queue properties component.

Parameters

categoryPath (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
component (Required) Supplied by the LaunchComponent
action execution class.) The name of the
component to contain.
objectId (Required) ID of the work queue object.
objectname (Optional) Name of the work queue object.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\queuepropertiescontainer_component.xml

Parent Definition
queuemgmtpropertycontainer:webcomponent/config/library/queuemanagement/
queuemgmtpropertycontainer_component.xml

Scope
All.

Elements
None.

1732 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
queueskill

queueskill

Purpose
Enables creating and updating dmc_wq_skill_info objects.

Parameters

objectId (Required) ID of the dmc_wq_skill_info object.


objectname (Required) Name of the dmc_wq_skill_info
object.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\queueskill_component.xml

Scope
All.

Elements
None.

queueusersandgroups

Purpose
Displays the users and groups assigned to work on a work queue.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1733
recentworkqueuecategorylocator

Parameters

categoryPath (Optional) Navigation path through work queue


categories used to reach the current queue; used
for setting the breadcrumbs.
objectId (Required) ID of the work queue object.
queuename (Required) Name of the work queue.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\queueusersandgroups_component.xml

Scope
All.

Elements
showbreadcrumb
See showbreadcrumb, page 835.

recentworkqueuecategorylocator

Purpose
Lists work queue categories that the user has recently selected.

Parameters

arrangeselect (Optional) Not used.


multiselect (Optional) Boolean: Set to true to support
multiple selection.

1734 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
recentworkqueuecategorylocator

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\workqueuecategorylocators_component.xml

Parent Definition
recentsysobjectlocator:webcomponent/config/library/locator/recentsysobjectlocator_component.xml

Scope
All.

Elements
iconwell_icon
See iconwell_icon, page 822.

objecttype

<objecttype>dmc_workqueue_category</objecttype>

Specifies the object type of the objects to locate.

columns
See columns (for data columns), page 811.

containerselectable

1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

views
See views, page 839.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1735
skillinfolist

skillinfolist

Purpose
Displays a work queue’s skill info.

Parameters
None.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\list\skillinfolist_component.xml

Scope
All.

Elements
columns
See columns (for data columns), page 811.

showbreadcrumb
See showbreadcrumb, page 835.

suspendqueuedtask

Purpose
Puts a task from a work queue into a suspended state.

1736 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
taskmanagercontainer (type dm_queued)

Parameters

objectId (Required) ID of the task to suspend.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\suspendqueuedtask_component.xml

Scope
All.

Elements
None.

taskmanagercontainer (type dm_queued)

Purpose
Extends propertysheetcontainer, page 928. This component is defined for following scopes:
dm_notification, dm_queued, dm_router_task, and dm_task. The definitions for dm_notification,
dm_queued, and dm_router_task do not contain components.

Parameters

component (Optional) Specifies the ID of the component to


initialize.
objectId (Required) Task ID.
taskmanagerId (Required) ID of the taskmanager object.
type (Required) Not used (any value can be inserted).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1737
unassignqueuedtask

Description
Since
5.x

Configuration File
webcomponent\config\library\workflow\taskmgrcontainer\taskmanagercontainer_component.xml

Parent Definition
propertysheetcontainer:wdk/config/propertysheetcontainer_component.xml

Scope

type dm_queued

Elements
failoverenabled
This element structure is inherited from propertysheetcontainer:wdk/config/propertysheetcontainer_
component.xml. See propertysheetcontainer, page 928.

unassignqueuedtask

Purpose
Removes a work item from a particular work queue processor’s Inbox.

Parameters

objectId (Required) ID of the task to unassign.


queueName (Required) Name of the work queue containing
the task.

1738 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
unassignqueuedtaskcontainer

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\unassignqueuedtask_component.xml

Scope
All.

Elements
None.

unassignqueuedtaskcontainer

Purpose
Container component for removing work items from a particular work queue processor’s Inbox.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class.) The name of the
component to contain.
componentArgs (Required) Supplied by the LaunchComponent
action execution class.) List of arguments and
values to pass to each contained component.

Description

Since
5.x

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1739
unsuspendqueuedtask

Configuration File
webcomponent\config\library\queuemanagement\unassignqueuedtaskcontainer_component.xml

Parent Definition
multiargdialogcontainer:webcomponent/config/library/multiargdialogcontainer/
multiargdialogcontainer_component.xml

Scope
All.

Elements
None.

unsuspendqueuedtask

Purpose
Returns a suspended task in a work queue to active state.

Parameters

objectId (Required) ID of the suspended task.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\unsuspendqueuedtask_component.xml

Scope
All.

1740 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
updateprocessorauthentication

Elements
None.

updateprocessorauthentication

Purpose
Changes the skill level of a work queue processor or the work queue document profile that the
processor is authorized to process.

Parameters

docprofile_name (Optional) Name of a work queue document


profile
skill (Optional) Skill level of the user for this work
queue. Valid values are the skill level strings
from the data dictionary.
username (Required) Name of the user.
wq_name (Required) Name of the work queue.

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\updateprocessorauthentication_component.xml

Parent Definition
editprocessorauthentication:webcomponent/config/library/queuemanagement/
editprocessorauthentication_component.xml

Scope
All.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1741
updateprocessorskill

Elements
None.

updateprocessorskill

Purpose
Enables updating a work queue processor’s skills.

Parameters

objectId (Optional) ID of a dmc_wq_user_skill object.


objectname (Required) Name of a dmc_wq_user_skill object.
requiredSkillIds (Required) IDs of the required dmc_wq_skill_
info objects required by the work queue.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\updateprocessorskill_component.xml

Parent Definition
processorskill:webcomponent/config/library/queuemanagement/processorskill_component.xml

Scope
All.

Elements
None.

1742 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
workqueuecategorylocatorcontainer

workqueuecategorylocatorcontainer

Purpose
Container component for locating work queue categories.

Parameters

arrangeselect (Optional) Not used.


multiselect (Optional) Boolean: Set to true to support
multiple selection.
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\workqueuecategorylocators_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1743
workqueuecategoryproperties

workqueuecategoryproperties

Purpose
Sets the properties for a work queue category.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class. The name of the
component to contain.
objectId (Required) ID of the work queue category object.
objectname (Required) Name of the work queue category.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\workqueuecategoryproperties_component.xml

Parent Definition
queuemgmtpropertycontainer:webcomponent/config/library/queuemanagement/
queuemgmtpropertycontainer_component.xml

Scope
All.

Elements
None.

1744 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
workqueuedocprofileproperties

workqueuedocprofileproperties

Purpose
Sets the properties of a work queue document profile.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class. The name of the
component to contain.
objectId (Required) ID of the work queue document
profile object.
objectname (Required) Name of the work queue document
profile.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\workqueuedocprofileproperties_component.xml

Parent Definition
queuemgmtpropertycontainer:webcomponent/config/library/queuemanagement/
queuemgmtpropertycontainer_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1745
workqueuelocator

workqueuelocator

Purpose
Lists the available work queues.

Parameters
The parameters are inherited from persistentobjectlocator:webcomponent/config/library/locator/
persistentobjectlocator_component.xml. See persistentobjectlocator, page 1086.

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\workqueuelocator_component.xml

Parent Definition
persistentobjectlocator:webcomponent/config/library/locator/persistentobjectlocator_component.xml

Scope
All.

Elements
attributes
See attributes, page 810.

columns
See columns (for data columns), page 811.

objecttype

<objecttype>dm_group</objecttype>

Specifies the object type of the objects to locate.

1746 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
workqueuelocatorcontainer

views
See views, page 839.

iconwell_icon
See iconwell_icon, page 822.

workqueuelocatorcontainer

Purpose
Container component for locating available work queues.

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\workqueuelocator_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1747
workqueuepolicyproperties

workqueuepolicyproperties

Purpose
Sets the properties for a work queue policy.

Parameters

component (Required) Supplied by the LaunchComponent


action execution class. The name of the
component to contain.
objectId (Required) ID of the work queue policy object.
objectname (Required) Name of the work queue policy.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\workqueuepolicyproperties_component.xml

Parent Definition
queuemgmtpropertycontainer:webcomponent/config/library/queuemanagement/
queuemgmtpropertycontainer_component.xml

Scope
All.

Elements
None.

1748 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
workqueueproperties

workqueueproperties

Purpose
Sets the properties for a work queue.

Parameters

objectId (Required) ID of the work queue object.


objectname (Required) Name of the work queue.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\workqueueproperties_component.xml

Parent Definition
adminpropertycontainer:webcomponent/config/admin/container/adminpropertycontainer_
component.xml

Scope
All.

Elements
objecttype

<objecttype>dmc_workqueue</objecttype>

Specifies the object type of the objects to modify.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1749
wqpolicymanagement (Webtop)

wqpolicymanagement (Webtop)

Purpose
Displays work queue policy and queue management document profile nodes as a list in the content
area.

Parameters

nodeIds (Optional) Target nodes in the tree.

Description
Since
6.0

Configuration File
webtop\config\queuemanagement_component.xml

Parent Definition
nodemanagement:webcomponent/config/admin/nodemanagement/nodemanagement_component.
xml

Scope
All.

Elements
None.

wqskillinfoattributes

Purpose
Enables displaying and updating work queue skill attributes.

1750 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
wqskillinfolocator

Parameters

isNew (Optional) (Boolean) True, if the work queue is


new; False, if not..
objectId (Required) ID of the work queue object.
objectname (Optional) Name of the skill info object that is
not used by the component.
readOnly (Optional) (Boolean) True, if the attribute is
read‑only; False, if not.
templateId (Optional) ID of the work queue template.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\wqskillinfoattributes_component.xml

Parent Definition
xforms:webcomponent/config/xforms/xforms_component.xml

Scope
All.

Elements
None.

wqskillinfolocator

Purpose
Locates work queue skill information (dmc_wq_skill_info objects).

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1751
wqskillinfolocator

Parameters
The parameters are inherited from persistentobjectlocator:webcomponent/config/library/locator/
persistentobjectlocator_component.xml. See persistentobjectlocator, page 1086.

Description

Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\wqskillinfolocator_component.xml

Parent Definition
persistentobjectlocator:webcomponent/config/library/locator/persistentobjectlocator_component.xml

Scope
All.

Elements
attributes
See attributes, page 810.

columns
See columns (for data columns), page 811.

objecttype

<objecttype>dmc_wq_skill_info</objecttype>

Specifies the object type of the objects to locate.

iconwell_icon
See iconwell_icon, page 822.
views
See views, page 839.

1752 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
wqskillinfolocatorcontainer

wqskillinfolocatorcontainer

Purpose
Container for wqskillinfolocator, page 1751 component.

Parameters
The parameters are inherited from locatorcontainer:webcomponent/config/library/locator/
locatorcontainer_component.xml. See locatorcontainer, page 1081.

Description
Since
5.x

Configuration File
webcomponent\config\library\queuemanagement\wqskillinfolocator_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

wqskillmanagement (Webtop)

Purpose
Displays work queue skill info and work queue processor profile nodes as a list in the content area.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1753
editxforms

Parameters

nodeIds (Optional) Target nodes in the tree.

Description
Since
6.0

Configuration File
webtop\config\queuemanagement_component.xml

Parent Definition
nodemanagement:webcomponent/config/admin/nodemanagement/nodemanagement_component.
xml

Scope
All.

Elements
None.

XForms

editxforms

Purpose
Extends dialogcontainer to edit forms. Contains the component xforms, page 1761. If the user does
not have the form_user role, the form will be displayed as XML.

1754 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
editxforms

Parameters

deleteOnCancel (Optional) Specifies whether the new form


instance should be deleted when the user clicks
Cancel. The default is false; that is, the new
form instance is not deleted. This parameter
is set by the NewXFormsContainer. Because
XFormsComponent can be extended, you might
want to change this behavior.
isNew (Optional) Specifies whether the form is new.
objectId (Required) ID of the selected form.
readOnly (Optional) A value of true renders the form as
readonly (view mode).
templateId (Optional) ID of the associated form template. If
this parameter is not specified, the default form
template associated with the form instance is
used.

Description
Since
5.x

Configuration File
webcomponent\config\xforms\editxforms_component.xml

Parent Definition
dialogcontainer:wdk/config/dialogcontainer_component.xml

Scope
All.

Elements
lockInstance
See lockInstance, page 824.
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1755
editxformsproperties

editxformsproperties

Purpose
This component is used to edit a form component definition.

Parameters
The parameters are inherited from editxforms:webcomponent/config/xforms/editxforms_component.
xml. See editxforms, page 1754.

Description
Since
5.x

Configuration File
webcomponent\config\xforms\editxformsproperties_component.xml

Parent Definition
editxforms:webcomponent/config/xforms/editxforms_component.xml

Scope
All.

Elements
lockInstance
See lockInstance, page 824.

newprintforms

Purpose
Enables creating new printforms instance data.

1756 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
newprintformscontainer

Since
6.5

newprintformscontainer

Purpose
Container for the component.

Since
6.5

newxforms

Purpose
This component is used to create a new form. The user must have the role form_user.

Parameters

objectId (Required) Object ID of the current folder in


which the form will be created.

Description
Since
5.x

Configuration File
webcomponent\config\xforms\create\newxforms_component.xml

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1757
newxformscontainer

Scope
All.

Elements
None.

newxformscontainer

Purpose
Displays the component newxforms, page 1757 to create a new form. It extends wizardcontainer,
page 1201.

Parameters
The parameters are inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml. See
dialogcontainer, page 1185.

Description
Since
5.x

Configuration File
webcomponent\config\xforms\newxformscontainer_component.xml

Parent Definition
wizardcontainer:wdk/config/wizardcontainer_component.xml

Scope
All.

Elements
failoverenabled
This element structure is inherited from dialogcontainer:wdk/config/dialogcontainer_component.xml.
See dialogcontainer, page 1185.

1758 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
printformcheckin (type dm_sysobject)

printformcheckin (type dm_sysobject)

Purpose
Performs a check in from the HiFi form edit component.

Since
6.5

printformcheckout (type dm_sysobject)

Purpose
Performs a check out from the HiFi form edit component.

Since
6.5

printformedit (type dm_sysobject)

Purpose
The HiFi form edit component that enables editing objects in the repository. This component is same
as the normal edit component, but its processor extends from the print form check out processor.

Since
6.5

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1759
saveasxforms

saveasxforms

Purpose
Creates a new form from a current form. The user must have the role form_user.

Parameters

objectId (Required) Object ID of the current folder in


which the form will be created.

Description
Since
5.x

Configuration File
webcomponent\config\xforms\saveasxforms_component.xml

Scope
All.

Elements
None.

viewxforms

Purpose
Extends editxforms component to display forms. Contains the xforms, page 1761 component. If the
user does not have the form_user role, the form will be displayed as XML.

1760 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
xforms

Parameters

objectId (Required) ID of the selected form


templateId (Optional) ID of the associated form template

Description

Since
5.x

Configuration File
webcomponent\config\xforms\viewxforms_component.xml

Parent Definition
editxforms:webcomponent/config/xforms/editxforms_component.xml

Scope
All.

Elements
readOnly
See readOnly, page 832.

lockInstance
See lockInstance, page 824.

xforms

Purpose
Displays a form for viewing or editing a selected form object. The user must have the role form_user.
The component is launched within the editxforms container or the viewxforms container by the edit
or view actions, respectively. The component passes parameter values to the xforms control, which
renders the form.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1761
xformsattachmentimportlocatorcontainer

Parameters

lockInstance (Optional) Boolean: Whether the component is


to lock the form instance automatically when
the form is edited and release the lock when the
component is exited (by submitting or canceling)
(True) or not (False). Default is false.Since 6.0.
objectId (Required) Object ID of the form.
readOnly (Optional) Specifies whether the form should
be shown in edit or view mode. In edit mode,
WDK buttons are not hidden (form is modal).
In view mode, form buttons are disabled, and
WDK buttons are displayed (Close and Help).

Description
Since
5.x

Configuration File
webcomponent\config\xforms\xforms_component.xml

Scope
All.

Elements
None.

xformsattachmentimportlocatorcontainer

Purpose
This component is a locator container that contains a locator tab and an import tab. The user is able
to use the import tab to initiate an import action. After the import is completed, the corresponding
imported object will be included in the selected list.

1762 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
xformsattachmentimportlocatorcontainer

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
importlocation (Required) ID of the repository folder to which
the document will be imported
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Required) Type of the selected object
restrictformats (Optional) Specify the formats the locator will
display
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected
startinlocation (Optional) ID of the folder where the locator
should begin the search
whereclause (Optional) Specifies the where clause that will be
used to locate the selected objects

Description
Since
5.x

Configuration File
webcomponent\config\xforms\locator\xformsattachmentimportlocatorcontainer_component.xml

Parent Definition
xformsattachmentlocatorcontainer:webcomponent/config/xforms/locator/
xformsattachmentlocatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1763
xformsattachmentlocator

xformsattachmentlocator

Purpose
This component is a locator specialized for locating document attachments based on their type and
required version label(s).

Parameters

objecttype (Optional) Type of the selected object.

Description
Since
5.x

Configuration File
webcomponent\config\xforms\locator\xformsattachmentlocator_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
iconwell_icon
See iconwell_icon, page 822.

objecttype

<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to locate.

containerselectable

1 <containerselectable>true</containerselectable>

1764 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
xformsattachmentlocatorcontainer

1 See containerselectable, page 814.

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

allversionsvisible

1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

columns
See columns (for data columns), page 811.
contenttypepanelvisible

1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.

filenamefiltervisible
See filenamefiltervisible, page 819.

views
See views, page 839.

xformsattachmentlocatorcontainer

Purpose
This component displays the component xformsattachmentlocator, page 1764, which is used to locate
attachments in the repository based on type and required version labels.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1765
xformsattachmentlocatorcontainer

Parameters

flatlist (Optional) Boolean: Set to true to list all objects


in a flat list, set to false to display objects in a
drop‑down list.
multiselect (Optional) Boolean: Set to true to support
multiple object selection.
objecttype (Required) Type of the selected object
restrictformats (Optional) Specify the formats the locator will
display
selectedobjectids (Optional) Comma‑delimited or semicolon‑
delimited list of object IDs that are initially
selected
startinlocation (Optional) ID of folder in which to start the
search
whereclause (Optional) Specifies the where clause that will be
used to locate the selected objects

Description

Since
5.x

Configuration File
webcomponent\config\xforms\locator\xformsattachmentlocatorcontainer_component.xml

Parent Definition
locatorcontainer:webcomponent/config/library/locator/locatorcontainer_component.xml

Scope
All.

Elements
multidocbasesupport
See multidocbasesupport, page 825.

1766 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
xformsimportlocator

xformsimportlocator

Purpose
A dummy locator to be shown on an attachment locator container.

Parameters
The parameters are inherited from sysobjectlocator:webcomponent/config/library/locator/
sysobjectlocator_component.xml. See sysobjectlocator, page 1091.

Description
Since
5.x

Configuration File
webcomponent\config\xforms\locator\xformsimportlocator_component.xml

Parent Definition
sysobjectlocator:webcomponent/config/library/locator/sysobjectlocator_component.xml

Scope
All.

Elements
iconwell_icon
See iconwell_icon, page 822.

columns
See columns (for data columns), page 811.
objecttype

<objecttype>dm_sysobject</objecttype>

Specifies the object type of the objects to locate.

containerselectable

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1767
xformsproperties

1 <containerselectable>true</containerselectable>

1 See containerselectable, page 814.

privatecabinetvisible

1 <privatecabinetvisible>false</privatecabinetvisible>

1 See privatecabinetvisible, page 832.

allversionsvisible

1 <allversionsvisible>false</allversionsvisible>

1 See allversionsvisible, page 809.

contenttypepanelvisible

1 <contenttypepanelvisible>false</contenttypepanelvisible>

1 See contenttypepanelvisible, page 815.

filenamefiltervisible
See filenamefiltervisible, page 819.

views
See views, page 839.

xformsproperties

Purpose
This component displays the properties panel for an xform object.

1768 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
xformsproperties

Parameters
The parameters are inherited from xforms:webcomponent/config/xforms/xforms_component.xml.
See xforms, page 1761.

Description

Since
5.x

Configuration File
webcomponent\config\xforms\xformsproperties_component.xml

Parent Definition
xforms:webcomponent/config/xforms/xforms_component.xml

Scope
All.

Elements
None.

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1769
xformsproperties

1770 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Appendix A
Version 6.0: New Controls, Actions,
and Components

Controls
attachmenticon, page 64
authoringapplicationformatter, page 295
clustergroup, page 315
clustertree, page 317
datacolumnbeginswith, page 99
datagridRowBreak, page 107
datagridRowEvent, page 109
datagridRowModifier, page 109
datagridRowTd, page 110
datagridTh, page 111
datatablefield, page 69
datatablefieldpanel, page 122
datatablefieldPanel, page 71
datatablerowattributelist, page 123
dropdownorlabel, page 205
menuconfig, page 255
messageaddressformatter, page 279
messageimportanceformatter, page 74
msgattachmenticon, page 75
noopformatter, page 281
numberformatter, page 282
objectidformatter, page 283
pagenav, page 227
param, page 228
promptedtext, page 365
recurrexceptionicon, page 75
searchtemplatefreelist, page 340
searchtemplatehiddenfixedlist, page 341
sortableclustertreelist, page 342
sortablelistbox, page 344

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1771
Version 6.0: New Controls, Actions, and Components

strategyselector, page 346


tagpooldetector, page 242
webcontainerrequirements, page 242
xformsdatasortlink, page 235
xformslistvalueformatter, page 236

Actions
accessiblefolderbrowse (privilege sysadmin, type dm_user), page 631
addaccessortorevoke (type dm_common_restriction), page 602
addgroupmembership, page 604
addprocessorworkqueue, page 758
addrequiredgroupset, page 635
addtobrowserfavorites, page 532
auditimagingaction, page 463
changeprocessorworkqueuemember, page 763
copyhere (type dm_folder), page 419
createpreset (type dmc_preset_package), page 544
createrecordrelation (entitlement recordsmanager, type dm_sysobject not dm_folder), page 554
delete (type dm_smart_list), page 574
delete (type dmc_preset_package), page 545
deleteformatpref, page 541
deleterelation (type dm_document), page 559
dmc_prm_action_make_library_request (entitlement prm, role dmc_prm_library_user, type
dmc_prm_physical_container), page 537
dmc_prm_action_make_library_request (entitlement prm, role dmc_prm_library_user, type
dmc_prm_physical_document), page 538
dmc_prm_cancel_request (entitlement prm, role dmc_prm_library_user, type
dmc_prm_library_request), page 539
dmc_prm_user_request_list (entitlement prm, role dmc_prm_library_user), page 540
drledit (type dm_smart_list), page 576
drledit (type search_template), page 478
drlview (type dm_message_archive) (Webtop), page 480
drlview (type dm_smart_list), page 578
drlview (type search_template), page 483
editaceaction, page 608
editacepermitaction, page 610
editfile (type dmc_calendar_event), page 429
editfile (type dmc_datatable_row), page 430
editfile (type dmc_datatable), page 431
editformatpref, page 542

1772 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Version 6.0: New Controls, Actions, and Components

editpreset (type dmc_preset_package), page 546


editsearch, page 579
emailsupervisor (type dm_workflow), page 714
exporttocsv, page 462
import (type dmc_datatable), page 438
linkhere (type dm_folder), page 421
movehere (type dm_folder), page 423
nativeroombrowse (type dm_group), page 441
navigation (type dm_message_archive) (Webtop), page 1191
newcalendar (type dm_folder, entitlement collaboration6), page 441
newcalendarevent (type dmc_calendar), page 442
newtableentry (type dmc_datatable), page 447
presetgrouplocator, page 548
presetlocationlocator, page 549
presetobjectlocator, page 550
presetobjecttypelocator, page 551
presetpermissionlocator, page 552
presetuserorgrouplocator, page 553
processorskillattributes, page 784
properties (type dmc_preset_package), page 554
pull_queued_task (type dm_task), page 791
queuelist (Webtop), page 792
registerreadevent (type dm_sysobject), page 535
removeaccessor, page 616
removeaccessortorevoke (type dm_common_restriction), page 617
removerequiredgroup, page 650
revisesearchtemplate, page 590
rmaccessor, page 619
showallmessages, page 630
subscribeothers (type dm_sysobject), page 620
unregisterreadevent (type dm_sysobject), page 536
updateprocessorskill, page 802
vdmvalidate (type dm_sysobject), page 688
view_as_html_drilldown (type dm_message_archive) (Webtop), page 494
view_as_html (type dm_message_archive) (Webtop), page 495
view (type dm_message_archive) (Webtop), page 498
view (type dmc_calendar_event), page 459
view (type dmc_datatable_row), page 460
viewsavedresults (type dm_smart_list), page 600

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1773
Version 6.0: New Controls, Actions, and Components

Components
addroomusercontainer, page 980
appintginsertcabinetslocator, page 850
appintgxdql, page 878
assemblylist (type dmc_rm_formal_record) (Webtop), page 1308
assemblylist (Webtop), page 1535
assemblyliststreamline (type dmc_rm_formal_record) (Webtop), page 1309
assemblyliststreamline (Webtop), page 1537
attributes (type dmc_calendar_event), page 983
attributes (type dmc_datatable_row), page 984
attributes (type dmc_prm_library_request), page 1258
attributes (type dmc_rm_formal_record), page 1311
categoryclassic (Webtop), page 961
compiletest, page 1435
dceuserattributes, page 992
dceuserproperties, page 993
defineuifieldvalidation, page 1440
delete (type dm_sysobject) (Webtop), page 1120
delete (type dmc_calendar_event), page 994
delete (type dmc_calendar), page 995
deletepreset (type dmc_preset_package), page 1282
deletepresetcombocontainer (type dmc_preset_package), page 1283
deleterelation (type dm_document), page 1341
display_preferences (Webtop), page 1272
dmc_prm_address_locatorcontainer, page 1258
dmc_prm_addresslocator, page 1259
doclist (type dm_message_archive), page 1188
doclist (type dmc_calendar), page 999
export (type dmc_datatable), page 1005
exportcontainer (type dm_message_archive), page 1128
exporttocsv, page 1064
exportviewcontainer (type dm_message_archive), page 1131
format_pref_attr_selector, page 1273
format_preferences_summary, page 1274
formatpreferencescontainer, page 1275
general_preferences (Webtop), page 1278
homecabinet_classic (type dm_message_archive) (Webtop), page 1205
homecabinet_classic (type dmc_calendar) (Webtop), page 1007
homecabinet_classic (type dmc_datatable) (Webtop), page 1008
homecabinet_drilldown (type dm_message_archive), page 1209

1774 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Version 6.0: New Controls, Actions, and Components

homecabinet_list (type dm_message_archive), page 1211


homecabinet_list (type dmc_calendar), page 1010
homecabinet_streamline (type dm_message_archive) (Webtop), page 1213
homecabinet_streamline (Webtop), page 1214
import (type dmc_calendar_event), page 1011
import (type dmc_calendar), page 1013
importcsv, page 1065
importcsvcontainer, page 1066
inspector, page 1453
makelibraryrequest, page 1261
makelibraryrequestcontainer, page 1262
movetoqueue, page 1705
nativeroomobjectlocator, page 1019
nativeroomobjectlocatorcontainer, page 1020
newdocbaseobject, page 1059
newdocbaseobjectcontainer, page 1060
newinvitewindow (entitlement collaboration), page 1024
newrelation (type dm_document), page 1342
newrelationcontainer, page 1343
newtable, page 1031
newtablecontainer, page 1032
newtableentry, page 1033
newtableentrycontainer, page 1034
objectlist (type dm_message_archive) (Webtop), page 1215
objectlist (type dmc_calendar) (Webtop), page 1036
objectlist (type dmc_datatable) (Webtop), page 1038
pendingtargets, page 1263
presetactionitem, page 1285
presetautoattributesitem, page 1287
presetdocbasenamescope, page 1288
preseteditorcontainer, page 1288
presetformatitem, page 1289
presetgroupitem, page 1290
presetitems, page 1291
presetlifecycleitem, page 1292
presetlist, page 1293
presetlocationlocatorcontainer, page 1294
presetlocationscope, page 1295
presetnavigationitem, page 1295
presetobjectlocator, page 1296
presetobjectlocatorcontainer, page 1298

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1775
Version 6.0: New Controls, Actions, and Components

presetobjecttypelocator, page 1299


presetobjecttypelocatorcontainer, page 1300
presetpermissionitem, page 1301
presetscopes, page 1302
presettemplateitem, page 1303
presettypeitem, page 1304
presettypescope, page 1305
presetusergrouprolescope, page 1305
presetwizardcontainer, page 1306
presetworkflowitem, page 1307
printdocuments (type dm_sysobject), page 1103
properties (type dmc_calendar_event), page 1040
properties (type dmc_datatable), page 1041
properties (type dmc_prm_library_request), page 1263
pullqueuedtask, page 1719
pullqueuedtaskcontainer, page 1720
queuelist (Webtop), page 1725
recurrence, page 1043
requestedtargets, page 1264
resultshandling_preferences, page 1366
roominvite (entitlement collaboration), page 1048
savesearchtemplate, page 1371
search, page 1372
search_preferences, page 1380
search (Webtop), page 1378
searchitems, page 1381
searchmonitoring, page 1382
searchmonitoringcontainer, page 1386
searchstoreclassic, page 1389
searchstorestreamline, page 1390
searchstoretemplate, page 1391
searchtemplate, page 1393
searchtemplatecontainer, page 1394
selectlifecycle (type dm_sysobject), page 1234
selectmultipleuseridattributevalue, page 933
selectuseridattributevalue, page 939
sendemailcontainer, page 1172
smartnavigation_preferences, page 1395
startwfxformcontainer (type dm_process), page 1643
startworkflowxforms, page 1647
streamlineview (type dm_message_archive) (Webtop), page 1196

1776 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Version 6.0: New Controls, Actions, and Components

tablefields, page 1057


taborderoncomponentinclude, page 1459
taborderoncomponentincludetest, page 1460
taskprocessvariables, page 1658
unittestcase, page 1475
userrequestlist (entitlement prm, role dmc_prm_library_user), page 1265
vdmvalidate, page 1565
vdmvalidate_container, page 1566
viewContainedInFormalRecords (entitlement recordsmanager) (Webtop), page 1337
workflowxforms, page 1689
wqpolicymanagement (Webtop), page 1750
wqskillmanagement (Webtop), page 1753
xformsattachmentlocator (type rm_dod5015ch4record), page 1339

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1777
Version 6.0: New Controls, Actions, and Components

1778 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Appendix B
Version 6.0 SP1: New Controls, Actions,
and Components

Controls
None.

Actions
attributes (type workflow_calendar), page 697
delete (type workflow_calendar), page 708
drlview (type dmc_datatable_row), page 427
migratepresets (dmc_preset_package), page 547
newWorkflowCalendar (type workflow_calendar), page 723
presetdocbaseselector, page 547
tablefields (type dmc_datatable), page 456
workflowcalendarlist (type workflow_calendar), page 754

Components
deleteworkflowcalendar, page 1615
migratepresets, page 1284
presetallfolderlocator, page 1286
presetotherdocbaselocationeditor, page 1301
workflowcalendarcontainer, page 1681
workflowcalendarcontainer, page 1681
workflowcalendardetails, page 1682
workflowcalendareditcontainer, page 1683
workflowcalendarevent, page 1684

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1779
Version 6.0 SP1: New Controls, Actions, and Components

workflowcalendarlist, page 1685

1780 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Appendix C
Version 6.5: New Controls, Actions,
and Components

Controls
actionattachmenticon, page 65
datatablecelllist, page 122
datatablePagefieldpanel, page 123
duedate, page 126
searchicon, page 331
showhide, page 134
trafficlighticon, page 136
viewerframework, page 237
yesnovalueformatter, page 287

Actions
delete (type dmc_datatable), page 426
export (type dm_message_archive), page 486
JumpToBrowserTreeLocationAction (Webtop), page 533
messagearchiveattachviewproperties, page 493
newprintforms (type dm_folder), page 804
properties (entitlement collaboration, type dm_folder), page 450
properties (type dm_message_archive), page 407
properties (type dmc_rm_formal_record, dmc_rm_formal_rec_folder, dmc_rm_formal_rec_
cabinet), page 452
reassignworkflowtask (type dm_task), page 796
unhold_queued_task (type dm_task), page 800
view_as_outlook_mail_msg (type dm_message_archive), page 496
view (type dm_message_archive), page 498

Components
advsearch (clientenv portal, type dm_message_archive), page 1356

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1781
Version 6.5: New Controls, Actions, and Components

advsearch (type dm_message_archive), page 1356


advsearch (type dm_message_archive) (Webtop), page 1356
attachmentcheckin, page 1107
attachmentimport, page 1107
attachmentimportcontainer, page 1108
attachments, page 1068
attributes (type dm_message_archive), page 398
browsertree (version 6.0) (Webtop), page 1476
datatableentrypage (type dmc_datatable_row), page 991
datatableentrypage (type dmc_datatable_row) (Webtop), page 992
datatablerepeatingattreditcomponent, page 992
delete (type dmc_datatable), page 997
display_preferences (version 5.3) (Webtop), page 1271
doclist (type dmc_datatable), page 1000
editdatatableentry (type dmc_datatable_row), page 1001
editdatatableentrycontainer (type dmc_datatable_row), page 1001
emfimport, page 1125
general_preferences (version 5.3) (Webtop), page 1277
informinvalidaction, page 1483
informinvalidactionformessagearchive, page 1484
informinvalidactionformessagearchiveattach, page 1484
locateappviewer, page 1165
locateappviewercontainer, page 1166
login (version 6.0), page 893
login (version 6.0) (Webtop), page 893
main (version 5.3) (Webtop), page 898
messagearchiveattach (type dm_message_archive), page 1249
messagearchiveattachlocations, page 1249
messagearchiveattachlocations (Webtop), page 1250
multiobjectsselectuserorgroupattributevalue, page 924
multiobjectsselectuserorgroupidattributevalue, page 925
newprintforms, page 1756
newprintformscontainer, page 1757
printformcheckin (type dm_sysobject), page 1759
printformcheckout (type dm_sysobject), page 1759
printformedit (type dm_sysobject), page 1759
reassignworkflowtask, page 1636
residentucfinvoker, page 1166
savechanges (Webtop), page 1554
savedocument, page 1105
search (clientenv portal, type dm_message_archive), page 1374

1782 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Version 6.5: New Controls, Actions, and Components

search (type dm_message_archive), page 1374


search (type dm_message_archive) (Webtop), page 1375

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1783
Version 6.5: New Controls, Actions, and Components

1784 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Appendix D
Removed and Deprecated Controls,
Actions, and Components

Removed in 6.0

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1785
dqlsavesearchdelegate

dqlsavesearchdelegate

Purpose
Calls the WDK 5.2.x savesearch component. You can use this component to call the WDK 5.2.x
savesearch. Alternatively, you can call the new savesearch component without the queryId parameter
to use the 5.2.x savesearch component.

Description
Since
5.x

Configuration File
webcomponent\config\library\savesearch\savesearchex\dqlsavesearchdelegate_component.xml

Parent Definition
savesearch:webcomponent/config/library/savesearch/savesearch_component.xml

Scope
All.

Elements
None.

1786 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
dqlsearchdelegate (Webtop)

dqlsearchdelegate (Webtop)

Purpose
This component invokes the 5.2.x search component.

Parameters
The parameters are inherited from search:webcomponent/config/library/search/search_component.
xml. See .

Description
Since
5.x

Configuration File
webtop\config\dqlsearchdelegate_component.xml

Parent Definition
search:webtop/config/search_component.xml

Scope
All.

Elements
columns_list
See columns_list, page 812.

columns_drilldown
1 <columns_drilldown>
2<loadinvisibleattribute>true</loadinvisibleattribute>
3<column>
4<attribute>object_name</attribute>
5<label>
6<nlsid>MSG_NAME</nlsid>
</label>
7<visible>true</visible>

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1787
dqlsearchdelegate (Webtop)

</column>
...
</columns_drilldown>

1 Specifies the order and visibility of attribute columns in the search results.
2 Whether to load and calculate hidden columns (true) or not (false).
3 Corresponds to a column in the search results. Contains <attribute>, <label>, and <visible> elements.
4 Corresponds to an attribute of the search result. Must be a sysobject attribute.
5 Label for the column in the search results. Contains string or <nlsid>.
6 Specifies the NLS ID specified in the NLS file for the component.
7 Boolean flag that sets the visibility of the column in the search results.

Removed in 6.5

Controls
None.

Actions
None.

Components
exportcontainer (type dm_message_archive)

1788 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Index

A addchildsysobjectlocatorcontainer
abortfailedautoworkflowtask (type component, 1544
dm_task) action, 693 addgroupmembership (type
abortworkflow (type dm_workflow) dm_restriction) action, 633
action, 694 addnewvirtualdocumentnode (type
abortworkflow (type dm_workflow) dm_sysobject) component, 1545
component, 1599 addprocessorauthentication action, 634
about (Webtop) component, 881 addrequiredgroup action, 634
about component, 880 addrequiredgroupset action, 635
absolutefilepathvalidator control, 136 addroommembercontainer
acceptworkflowtask (type dm_task) component, 979
action, 695 addroomusercontainer component, 980
accessiblefolderbrowse (privilege addroomuserorgrouplocator
sysadmin, type dm_user) action, 631 component, 981
accessiblefolderbrowse (type addtaskattachmentlocatorcontainer
dm_member_user, entitlement component, 1600
collaboration6) action, 632 adduserorgroup (type grouplist)
accessiblefolderbrowser (entitlement action, 636
collaboration6, role dce_user_ addvirtualdocumentnode (type
manager) action, 424 dm_sysobject) component, 1546
action (control attribute), 16 addvirtualdocumentnodefromclipboard
actionbutton control, 18 (type dm_sysobject) component, 1547
actionbuttonlist control, 21 addvirtualdocumentnodefromfileselector
actiondispatcher component, 841 (type dm_sysobject) component, 1548
actionimage control, 22 addwfattachment action, 697
actionlink control, 25 adminbrowse (type dm_group)
actionlinklist control, 28 action, 637
actionmenuitem control, 30 administration (Webtop) component, 842
actionmultiselect control, 32 adminpropertycontainer component, 843
actionmultiselectcheckall control, 33 adminuserorgrouplocator
actionmultiselectcheckbox control, 34 component, 1496
actions adminuserorgrouplocatorcontainer
common attributes, 16 component, 1497
control attributes, 15 advsearch (Webtop) component, 1357
actiontable element, 809 advsearch component, 1354
addattachment (type dmi_package) advsearchcontainer (version 5.2.5)
action, 696 component, 1359
addchildsysobjectlocator advsearchcontainer component, 1358
component, 1542 alldocumentlocator component, 1067
allsavedsearches component, 1360

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1789
Index

alluserwftemplatelocator appintgsaveassubscriptions
component, 1601 component, 876
allversionsvisible element, 809 appintgxdql component, 878
allwftemplatelocator component, 1602 argument control, 288 to 289
api component, 881 assemblylist (Webtop) component, 1535
appintgcontroller (Webtop) assemblylist component, 1534
component, 846 assemblyliststreamline (Webtop)
appintgcontroller component, 844 component, 1537
appintgcontrollerlogin (Webtop) assemblyliststreamline component, 1536
component, 849 asynchronous element, 809
appintgcontrollerlogin component, 848 attachmenticon control, 64
appintghelp component, 850 attachmentlocator component, 1604
appintginsertcabinetslocator attachmentlocatorcontainer
component, 850 component, 1605
appintginsertcategorieslocator attachmentmyobjectlocator
component, 851 component, 1606
appintginsertlocatorcontainer attachmentsubscriptionlocator
component, 852 component, 1608
appintginsertmyfileslocator attributes
component, 853 input masks, 147
appintginsertobject action, 382 attributes (type dm_acl) action, 394
appintginsertobject component, 854 attributes (type dm_document)
appintginsertsubscriptionslocator component, 910
component, 855 attributes (type dm_externalresult)
appintginsertweblink action, 383 action, 395
appintginsertweblink component, 856 attributes (type dm_externalresult)
appintgnewfromtemplate action, 384 component, 1361
appintgnewfromtemplate attributes (type dm_group) action, 396
component, 857 attributes (type dm_member_group)
appintgopen component, 858 action, 396
appintgopenfrom action, 385 attributes (type dm_member_user,
appintgopenfrom component, 859 entitlement collaboration6)
appintgopenfromcabinetslocator action, 397
component, 860 attributes (type dm_sysobject) action, 398
appintgopenfromcategorieslocator attributes (type dm_sysobject)
component, 862 component, 912
appintgopenfromlocatorcontainer attributes (type dm_user) action, 400
component, 863 attributes (type dm_user, entitlement
appintgopenfrommyfileslocator collaboration6) action, 399
component, 865 attributes (type dm_workflow_calendar)
appintgopenfromrecentfileslocator action, 401
component, 867 attributes (type dmc_calendar_event)
appintgopenfromsubscriptionslocator component, 983
component, 868 attributes (type dmc_datatable_row)
appintgsaveas action, 386 component, 984
appintgsaveascabinets component, 870 attributes (type dmc_prm_library_
appintgsaveascategories component, 871 request) component, 1258
appintgsaveascontainer component, 872 attributes (type dmc_workqueue)
appintgsaveasmyfiles component, 874 action, 404
appintgsaveasrecentfiles component, 875

1790 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Index

attributes (type dmc_workqueue_ changeroommemberrolelocator


category) action, 401 component, 986
attributes (type dmc_workqueue_doc_ changeroommemberrolestep
profile) action, 402 component, 987
attributes (type dmc_workqueue_policy) changesearchsources component, 1362
action, 403 changesupervisor (type dm_workflow)
attributes (type workflow_calendar) action, 700
action, 697 changesupervisor (type dm_workflow)
attributes element, 810 component, 1611
authenticate (Webtop) component, 883 changeucfcheckoutlocation
authenticate component, 882 component, 1110
authenticateexternalsource checkin (type dm_sysobject) action, 466
component, 884 checkin (type dm_sysobject)
autogettaskdefault element, 810 component, 1111
checkincontainer component, 1113
checkout (type dm_sysobject) action, 467
B checkout (type dm_sysobject)
backdetector component, 885 component, 1114
bannerbox control, 66 checkoutbyother component, 1116
base_type element, 810 checkoutbyothercontainer
bindingcomponentversion element, 810 component, 1116
bookmarklink control, 261 checkoutcontainer component, 1117
breadcrumb control, 263 choosecontributors component, 988
breadcrumbiconwellmode element, 810 chooseowners component, 990
<breadcrumbiconwellmode>, 214 clientapplicationinstaller component, 878
browsertree (Webtop) control, 355 clientevent element, 811
clustergroup control, 315
C clustertree control, 317
columnpanel control, 99
cabinets element, 811
columns (for data columns) element, 811
cancelcheckout (type dm_process)
columns (for streamline view)
action, 698
element, 811
cancelcheckout (type dm_sysobject)
columns_all_saved_searches element, 812
action, 465
columns_drilldown element, 1787
cancelcheckout (type dm_sysobject)
columns_list element, 812
component, 1108
columns_my_saved_searches
cancelcheckoutcontainer
element, 813
component, 1109
columns_saved_search element, 813
category element, 811
columnselector component, 1266
celllist control, 96
columnselectorcontainer
celltemplate control, 97
component, 1267
changeperformer (type dm_task)
combocontainer component, 1183
action, 699
combocontainerpanel control, 361
changeperformer (type dm_task)
comment (type dm_process) action, 701
component, 1610
comment (type dm_sysobject) action, 561
changeperformercontainer
comment (type dm_task) action, 702
component, 1611
commentimage control, 66
changeroommemberrole component, 985
commentrow control, 68
changeroommemberrolecontainer
comments element, 814
component, 985

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1791
Index

commitchanges (type dm_sysobject) defaultaccounts element,


action, 702 common, 816
commitorder element, 814 defaultsources element, common, 816
comparevalidator control, 137 defaultview element, common, 816
completefailedautoworkflowtask (type displayresultspath element,
dm_task) action, 703 common, 817
completefailedautoworkflowtask docbase‑type‑mappings element,
component, 1612 common, 817
component_preferences component, 1268 document‑docbase‑base‑type element,
components common, 817
actiontable element, common, 809 document‑docbase‑type element,
allversionsvisible element, common, 817
common, 809 document_filter element,
asynchronous element, common, 809 common, 817
attributes element, common, 810 dragdrop element, common, 818
autogettaskdefault element, duration_attribute_conditions
common, 810 element, common, 818
base_type element, common, 810 enableShowAll element,
bindingcomponentversion element, common, 819
common, 810 entrypage element, common, 819
breadcrumbiconwellmode element, failoverenabled element,
common, 810 common, 819
cabinets element, common, 811 filenamefiltervisible element,
category element, common, 811 common, 819
clientevent element, common, 811 filter element, common, 820
columns (for data columns) element, flatlist element, common, 820
common, 811 folder‑docbase‑type element,
columns (for streamline view) common, 820
element, common, 811 folder_filter element, common, 820
columns_all_saved_searches element, formsavefolderpath element,
common, 812 common, 820
columns_drilldown element, header element, common, 821
common, 1787 help‑entries element, common, 821
columns_list element, common, 812 helppath element, common, 821
columns_my_saved_searches hideEvents element, common, 821
element, common, 813 highlight_matching_terms element,
columns_saved_search element, common, 822
common, 813 homecabinet element, common, 822
comments element, common, 814 homeURL element, common, 822
commitorder element, common, 814 iconwell_icon element, common, 822
common elements, 809 inbox element, common, 822
containerselectable element, includetypes element, common, 822
common, 814 includeunlisted element,
contenttypepanelvisible element, common, 823
common, 815 init‑controls element, common, 823
cost_attribute_conditions element, isIgnorePrefRenditions element,
common, 815 common, 823
default_binding_filter_values locator element, common, 824
element, common, 815 lockInstance element, common, 824
default_type element, common, 815 map element, common, 824

1792 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Index

maxidletime element, common, 824 showattachmentinfo element,


menugrouptarget element, common, 834
common, 824 showautogettask element,
modifiedwithindays element, common, 834
common, 825 showbreadcrumb element,
multidocbasesupport element, common, 835
common, 825 showfilters element, common, 835
myobjects element, common, 825 showfolderpath element,
navigationlinks element, common, 835
common, 825 showfolders element, common, 835
newcomponentname element, showheaderforsinglepackage element,
common, 825 common, 835
nodes element, common, 825 showjobstatus element, common, 835
nomaclsupport element, showoptions element, common, 836
common, 826 showpagesastabs element,
nondocbasecolumns element, common, 836
common, 826 showusertimeandcost element,
numberedtabs element, common, 827 common, 836
objectfilters element, common, 827 skipVersionCheck element,
pageTitle element, common, 827 common, 836
permissionsservice element, startComp element, common, 836
common, 828 startQueryString element,
preferencedisplaygroups element, common, 836
common, 828 subscriptions element, common, 837
preferences element, common, 828 taskmgractionname element,
preserve‑file‑extension element, common, 837
common, 829 transformation element, common, 837
preset_item_definition element, type element, common, 837
common, 831 ucfrequired element, common, 838
preset_scope_definitions element, updatereplicasource element,
common, 831 common, 838
privatecabinet_visible element, useronly element, common, 838
common, 831 useroptions element, common, 838
privatecabinetvisible element, views element, common, 839
common, 832 windowparams element,
privategroupvisible element, common, 840
common, 832 workflowstatusactionname element,
readOnly element, common, 832 common, 841
savedetailsreport element, workqueuegroupvisible element,
common, 832 common, 841
search_types element, common, 832 container component, 1184
searchtypes element, common, 833 containerselectable element, 814
selectedattribute element, contenttypepanelvisible element, 815
common, 833 controls
serveroptionenabled element, event attributes, 15
common, 834 set focus, 14
service element, common, 834 WDK, 13
setrepositoryfromobjectid element, cost_attribute_conditions element, 815
common, 834 createhtmlrendition (type dm_sysobject)
action, 562

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1793
Index

createhtmlrendition (type dmr_content) delegateworkflowtask component, 1613


action, 562 delete (entitlement collaboration, type
createhtmlrenditiongeneric (type dmc_notepage) action, 425
dm_sysobject) action, 563 delete (privilege sysadmin, type dm_user)
createhtmlrenditiongeneric (type action, 469
dmr_content) action, 564 delete (type dm_activity) action, 705
createpdfrendition (type dm_sysobject) delete (type dm_folder) action, 469
action, 565 delete (type dm_group) action, 470
createpdfrendition (type dmr_content) delete (type dm_notification) action, 471
action, 566 delete (type dm_notification)
createpdfrenditiongeneric (type component, 1614
dm_sysobject) action, 566 delete (type dm_process) action, 706
createpdfrenditiongeneric (type delete (type dm_smart_list) action, 574
dmr_content) action, 567 delete (type dm_sysobject) (Webtop)
createpreset (type dmc_preset_package) component, 1120
action, 544 delete (type dm_sysobject) action, 472
cssclass attribute, 13 delete (type dm_sysobject)
component, 1119
delete (type dm_workflow) action, 707
D delete (type dmc_calendar)
datacolumnbeginswith control, 99 component, 995
datagrid control, 102 delete (type dmc_calendar_event)
datagridRow control, 105 component, 994
datagridRowBreak control, 107 delete (type dmc_comment) action, 473
datagridRowEvent control, 109 delete (type dmc_comment)
datagridRowModifier control, 109 component, 996
datagridRowTd control, 110 delete (type dmc_notepage)
datagridTh control, 111 component, 997
dataoptionlist control, 113 delete (type dmc_preset_package)
datapagesize control, 114 action, 545
datapaging control, 116 delete (type dmc_room) component, 998
datasortimage control, 117 delete (type dmc_search_template)
datasortlink control, 119 action, 575
datatablefield control, 69 delete (type dmr_content) action, 474
datatablefieldpanel control, 122 delete (type job_request) action, 474
datatablefieldPanel control, 71 delete (type workflow_calendar)
datatablerowattributelist control, 123 action, 708
datetimevalidator control, 139 delete component, 1118
datevalidator control, 140 deletenotification (type dm_notification)
dceuserattributes component, 992 action, 709
dceuserproperties component, 993 deletepreset (type dmc_preset_package)
debug_preferences component, 1269 component, 1282
default_binding_filter_values deletepresetcombocontainer
element, 815 (type dmc_preset_package)
default_type element, common, 815 component, 1283
defaultaccounts element, common, 816 deletesmartlistcontainer (type
defaultsources element, common, 816 dm_smart_list) component, 1363
defaultview element, common, 816 deleteworkflow (type dm_workflow)
delegateworkflowtask (type dm_task) component, 1615
action, 704 deleteworkflowcalendar component, 1615

1794 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Index

dialogcontainer component, 1185 documentlocatorcontainer


disabledclass, 16 component, 1070
disabledstyle, 16 documentsubscriptionlocator
display_preferences (version 5.3) (Webtop) component, 1418
component, 1271 DONTSHOWAGAIN, 1491
display_preferences (Webtop) download component, 1121
component, 1272 downloadcontent (type dm_sysobject)
display_preferences component, 1270 action, 475
displayresultspath element, common, 817 downloadcontentcontainer (type
dmc_prm_address_locatorcontainer dm_sysobject) component, 1122
component, 1258 dql component, 886
dmc_prm_addresslocator dqleditor component, 887
component, 1259 dqlsavesearchdelegate component, 1786
dmr_contentlocator component, 1069 dqlsearchdelegate (Webtop)
dmr_contentlocatorcontainer component, 1787
component, 1070 dragdrop element, common, 818
docbase‑type‑mappings element, drilldown (type dm_message_archive)
common, 817 component, 1073
docbaseattribute control, 36 drilldown component, 1071
docbaseattributedelegate control, 38 drl component, 887
docbaseattributelabel control, 41 drlauthenticate component, 889
docbaseattributelist control, 42 drledit (type dm_smart_list) action, 576
docbaseattributeproxy control, 45 drledit (type dm_sysobject) (Webtop)
docbaseattributeseparator control, 46 action, 477
docbaseattributevalidator control, 141 drledit (type dm_sysobject) action, 476
docbaseattributevalue control, 47 drledit (type dmc_search_template)
docbaseattributevalueassistance action, 577
control, 50 drledit (type search_template) action, 478
docbaseattributevalueassistancevalue drlview (entitlement collaboration, type
control, 51 dmc_notepage) action, 426
docbasemultiobjects control, 53 drlview (type dm_folder) (Webtop)
docbasemultiobjectsvalidator control, 142 action, 479
docbaseobject control, 54 drlview (type dm_message_archive)
docbaseobjectattributevalidator (Webtop) action, 480
control, 143 drlview (type dm_process) action, 709
docbaseobjectvalidator control, 144 drlview (type dm_smart_list) action, 578
docbaserepeatingattribute drlview (type dm_sysobject) (Webtop)
component, 914 action, 481
docbasesingleattribute component, 915 drlview (type dm_sysobject) action, 480
doclist (type dm_message_archive) drlview (type dmc_datatable_row)
component, 1188 action, 427
doclist (type dmc_calendar) drlview (type dmc_search_template)
component, 999 action, 579
doclist component, 1187 drlview (type dmi_queue_item) (Webtop)
document‑docbase‑base‑type element, action, 482
common, 817 drlview (type search_template)
document‑docbase‑type element, action, 483
common, 817 duration_attribute_conditions element,
document_filter element, common, 817 common, 818
dynamic attribute, on action control, 16

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1795
Index

E er_properties (Webtop) component, 1004


edit (type dm_smart_list) action, 580 er_search (Webtop) action, 432
edit (type dm_sysobject) component, 1123 events
edit (type dmc_notepage) control, 15
component, 1000 export (type dm_message_archive)
editafternew (type dm_sysobject) action, 486
action, 484 export (type dm_sysobject) action, 487
editcontainer (type dm_sysobject) export (type dm_sysobject)
component, 1124 component, 1125
editfile (entitlement collaboration, type export (type dmc_datatable)
dmc_notepage) action, 428 component, 1005
editfile (type dm_process) action, 710 export (type dmr_content)
editfile (type dm_smart_list) action, 582 component, 1127
editfile (type dm_sysobject) action, 485 exportcontainer (type dm_message_
editfile (type dmc_calendar_event) archive) component, 1128
action, 429 exportcontainer (type dm_sysobject)
editfile (type dmc_datatable) action, 431 component, 1129
editfile (type dmc_datatable_row) exportcontainer (type dmr_content)
action, 430 component, 1130
editfile (type dmc_search_template) exportrendition (type dmr_content)
action, 584 action, 488
editpreset (type dmc_preset_package) exportviewcontainer (type dm_message_
action, 546 archive) component, 1131
editsearch action, 579 externalresultimportcontainer
editstartwfnote (type dmi_package) component, 1133
action, 711
editstartwfnote (type dmi_package) F
component, 1616 failoverenabled element, common, 819
edittasknote (type dmi_package) filenamefiltervisible element,
action, 712 common, 819
edittasknote (type dmi_package) filter element, common, 820
component, 1617 finishworkflowtask (type dm_task)
edittemplate (type dmc_search_template) action, 715
action, 585 finishworkflowtask component, 1618
edittemplatedefinition (type flatlist element, common, 820
dmc_search_template) action, 586 focus attribute, 14
elements folder‑docbase‑type element,
common component, 809 common, 820
emailperformers (type dm_workflow) folder_filter element, common, 820
action, 713 folderbrowse (entitlement collaboration6,
emailsupervisor (type dm_workflow) role dce_user_manager) action, 433
action, 714 folderbrowse (type dm_member_user,
embeddedtopic (type dmc_room) entitlement collaboration6)
component, 1003 action, 434
embeddedtopic component, 1001 folderlocatorcontainer component, 1075
enabled, 14 foldersubscriptionlocator
enableShowAll element, common, 819 component, 1419
entrypage element, common, 819 format_pref_attr_selector
er_properties (Webtop) action, 432 component, 1273

1796 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Index

format_preferences_summary H
component, 1274 halttask (type dm_task) action, 718
formatmessageparams control, 362 halttask (type dm_task) component, 1621
formatpreferencescontainer haltworkflow (type dm_workflow)
component, 1275 action, 719
formsavefolderpath element, haltworkflow (type dm_workflow)
common, 820 component, 1622
formurl control, 267 header element, common, 821
forwardroutertask (type dm_router_task) help‑entries element, common, 821
action, 716 helppath element, common, 821
forwardroutertask component, 1619 hideEvents element, common, 821
forwardworkflowtask (type dm_task) highlight_matching_terms element,
action, 717 common, 822
forwardworkflowtask component, 1620 historicalactivityreportresults
component, 1567
G historicalprocessreport action, 720
general_preferences (version 5.3) (Webtop) historicalprocessreport component, 1568
component, 1277 historicalprocessreportcontainer
general_preferences (Webtop) component, 1569
component, 1278 historicalprocessreportresults
general_preferences component, 1276 component, 1569
getcontent component, 1134 historicalreportcolumnselector
govern (entitlement collaboration) component, 1570
action, 435 historicaluserreport action, 721
govern (type dm_folder) component, 1006 historicaluserreport component, 1572
governedicon control, 72 historicaluserreportcontainer
governfolder (entitlement collaboration) component, 1573
action, 436 historicaluserreportresults
groupattributes component, 1498 component, 1573
groupbrowse (privilege sysadmin, type history (type dm_sysobject) action, 404
dm_user) action, 638 history (type dm_task) action, 721
groupbrowse (type dm_group) action, 639 history component, 916
groupbrowse (type dm_member_user, homecabinet element, common, 822
entitlement collaboration6) homecabinet_classic (type
action, 437 dm_message_archive) (Webtop)
groupdelete component, 1499 component, 1205
grouplist component, 1500 homecabinet_classic (type dmc_calendar)
grouplocator component, 1501 (Webtop) component, 1007
grouplocatorcontainer component, 1503 homecabinet_classic (type dmc_datatable)
groupproperties component, 1503 (Webtop) component, 1008
groupreassign (type dm_group) homecabinet_classic (type dmc_room)
action, 640 (Webtop) component, 1009
groupreassign (type dm_member_group) homecabinet_classic (Webtop)
action, 640 component, 1206
grouprename component, 1504 homecabinet_drilldown (type dm_
grouprenamelog (type dm_group) message_archive) component, 1209
action, 641 homecabinet_drilldown component, 1208
groupwhereused component, 1505 homecabinet_list (type dm_message_
archive) component, 1211

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1797
Index

homecabinet_list (type dmc_calendar) import (type dmc_calendar)


component, 1010 component, 1013
homecabinet_list component, 1210 import (type dmc_calendar_event)
homecabinet_streamline (type component, 1011
dm_message_archive) (Webtop) import (type dmc_datatable) action, 438
component, 1213 import component, 1159
homecabinet_streamline (type dmc_room) importcontainer component, 1161
(Webtop) component, 1011 importexternalresult (type
homecabinet_streamline (Webtop) dm_externalresult) action, 587
component, 1214 importrendition (type dm_sysobject)
homeURL element, common, 822 action, 490
httpcancelcheckout (type dm_sysobject) importrendition (type dmr_content)
component, 1135 action, 491
httpcancelcheckoutcontainer importrendition component, 1163
component, 1136 importrenditioncontainer
httpcheckin (type dm_sysobject) component, 1164
component, 1138 importrenditiongeneric (type
httpcheckincontainer component, 1139 dm_sysobject) action, 492
httpcheckout (type dm_sysobject) importrenditiongeneric (type
component, 1140 dmr_content) action, 492
httpcheckoutcontainer component, 1141 inbox element, common, 822
httpedit (type dm_sysobject) inboxclassic (Webtop) component, 1216
component, 1142 inboxdrilldown component, 1217
httpeditcontainer component, 1143 inboxlist component, 1622
httpexport (type dm_sysobject) inboxstreamline (Webtop)
component, 1144 component, 1218
httpexport (type dmr_content) includetypes element, common, 822
component, 1145 includeunlisted element, common, 823
httpexportcontainer component, 1146 index component, 890
httpimport component, 1148 init‑controls element, common, 823
httpimportcontainer component, 1149 input masks, 147
httpimportrendition component, 1150 inputmaskvalidator control, 146
httpimportrenditioncontainer installedrecentwftemplatelocator
component, 1151 component, 1624
httpmultifiledownload component, 1152 installedwftemplatefolderlocator
httpview (type dmr_content) (Webtop) component, 1625
component, 1156 installedwftemplatesubscriptionlocator
httpview (type dmr_content) component, 1625
component, 1155 isIgnorePrefRenditions element,
httpview (Webtop) component, 1157 common, 823
httpview component, 1153
httpviewcontainer component, 1158
L
label attribute
I controls, 14
iconwell_icon element, common, 822 label control, 348
id attribute listbox control, 127
controls, 14 locatecheckinlocalfile component, 1075
import (type dm_folder) action, 489 locatecheckinlocalfilecontainer
component, 1076

1798 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Index

locateimportlocalfile component, 1077 multiobjectsdocbaseattributevalue


locateimportlocalfilecontainer control, 60
component, 1078 multiobjectsdocbaserepeatingattribute
locatelocalfile component, 1079 component, 919
locatelocalfilecontainer component, 1080 multiobjectsdocbasesingleattribute
locator element, common, 824 component, 920
locatorcontainer component, 1081 multiobjectsproperties component, 921
lockInstance element, common, 824 multiobjectsselectsingleattributevalue
login (Webtop) component, 894 component, 922
login component, 891 multiobjectsselectuserattributevalue
logoff (Webtop) component, 896 component, 923
logoff component, 895 multiobjectsversionlabels component, 925
multiselector control, 129
multivaluesinputmaskvalidator
M control, 149
main (version 5.3) (Webtop) multivaluesrequiredfieldvalidator
component, 898 control, 150
main (Webtop) component, 900 myobjects element, common, 825
main component, 897 myobjects_list component, 1082
makelibraryrequest component, 1261 myrooms_classic (Webtop)
makelibraryrequestcontainer component, 1014
component, 1262 myrooms_drilldown component, 1015
map element, common, 824 myrooms_list component, 1017
markread (entitlement collaboration, type myrooms_streamline (Webtop)
dm_sysobject) action, 439 component, 1018
markunread (entitlement collaboration, mysavedsearches component, 1364
type dm_sysobject) action, 440 myuserwftemplatelocator
maxidletime element, common, 824 component, 1627
menugrouptarget element, common, 824 mywftemplatelocator component, 1628
messageimportanceformatter control, 74
migratepresets action, 547
migratepresets component, 1284 N
modifiedwithindays element, name attribute
common, 825 controls, 14
modifyversionlabels (type dm_sysobject) nativeroombrowse (type dm_group)
action, 405 action, 441
modifyversionlabels component, 917 nativeroomobjectlocator component, 1019
msgattachmenticon control, 75 nativeroomobjectlocatorcontainer
multiargdialogcontainer component, 1190 component, 1020
multidocbasesupport element, navigation (type dm_message_archive)
common, 825 (Webtop) component, 1191
multiobjectsattributes (type dm_sysobject) navigationcontainer (Webtop)
component, 918 component, 1193
multiobjectsdocbaseattribute control, 56 navigationcontainer component, 1192
multiobjectsdocbaseattributelabel navigationlinks element, common, 825
control, 57 nestedcomponentcontainer
multiobjectsdocbaseattributelist component, 1194
control, 58 newassembly component, 1538
multiobjectsdocbaseattributevalidator newassemblycontainer component, 1539
control, 148

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1799
Index

newcalendar (type dm_folder, entitlement newWorkflowCalendar (type


collaboration6) action, 441 workflow_calendar) action, 723
newcalendar component, 1021 nlsid attribute
newcalendarcontainer component, 1022 controls, 14
newcalendarevent (type dmc_calendar) nodataRow control, 132
action, 442 nodemanagement component, 844
newcalendarevent component, 1023 nodes element, common, 825
newcalendareventcontainer nomaclsupport element, common, 826
component, 1023 nondocbasecolumns element,
newcomponentname element, common, 826
common, 825 notepage (type dmc_notepage) (Webtop)
newgroup (privilege creategroup, type component, 1036
dm_group) action, 642 notepage (type dmc_notepage)
newinvitewindow (entitlement component, 1035
collaboration) component, 1024 numberedtabs element, common, 827
newinvitewindow (entitlement
collaboration6) action, 443
newnotepage (entitlement collaboration,
O
type dm_folder) action, 444 objectfilters element, common, 827
newnotepage component, 1025 objectgrid component, 1194
newnotepagecontainer component, 1026 objectlist (type dm_message_archive)
newprocess (type dm_folder) action, 722 (Webtop) component, 1215
newrole (privilege creategroup, type objectlist (type dmc_calendar) (Webtop)
dm_role) action, 643 component, 1036
newroom (entitlement collaboration, objectlist (type dmc_datatable) (Webtop)
privilege creategroup, type component, 1038
dm_folder) action, 445 objectlist (type dmc_room) (Webtop)
newroom component, 1027 component, 1039
newroomcontainer component, 1028 objectlist (Webtop) component, 1083
newroomgroup component, 1029 objectlocator component, 1085
newroomgroupcontainer onchange event, 15
component, 1030 onclick event, 15
newtable (type dm_folder, entitlement oncomplete, 16
collaboration6) action, 446 onselect event, 15
newtable component, 1031 options (type dmc_room) action, 450
newtablecontainer component, 1032 ownerbrowse (type dm_group)
newtableentry (type dmc_datatable) action, 645
action, 447
newtableentry component, 1033 P
newtableentrycontainer component, 1034 pageTitle element, common, 827
newuser (entitlement collaboration6, pendingtargets component, 1263
privilege sysadmin, type dm_user) permissions (type dm_sysobject)
action, 448 action, 406
newuser (entitlement collaboration6, role permissionsservice element, common, 828
dce_user_manager, type dm_user) persistentobjectlocator component, 1086
action, 449 portal_login component, 903
newuser (privilege sysadmin, type portal_preferences component, 1278
dm_user) action, 644 portalsearch component, 1364
newwindow (Webtop) component, 902 portalsearchcontainer component, 1365
newwindow component, 901

1800 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Index

portlet_preferences component, 1279 presetworkflowitem component, 1307


preferencedisplaygroups element, primaryfolderpathlink control, 268
common, 828 privatecabinet_visible element,
preferences component, 1280 common, 831
preferences element, common, 828 privatecabinetvisible element,
preserve‑file‑extension element, common, 832
common, 829 privategroupvisible element,
preset_item_definition element, common, 832
common, 831 processdetailreportresults
preset_scope_definitions element, component, 1574
common, 831 progressbar control, 364
presetactionitem component, 1285 progressbarupdater control, 365
presetallfolderlocator component, 1286 promptedtext control, 365
presetautoattributesitem properties (entitlement collaboration6,
component, 1287 type dm_user) action, 451
presetdocbasenamescope properties (type dm_externalresult)
component, 1288 action, 588
presetdocbaseselector action, 547 properties (type dm_externalresult)
preseteditorcontainer component, 1288 component, 927
presetformatitem component, 1289 properties (type dm_group) action, 645
presetgroupitem component, 1290 properties (type dm_member_group)
presetgrouplocator action, 548 action, 646
presetitems component, 1291 properties (type dm_member_user,
presetlifecycleitem component, 1292 entitlement collaboration6)
presetlist component, 1293 action, 647
presetlocationlocator action, 549 properties (type dm_message_archive)
presetlocationlocatorcontainer action, 407
component, 1294 properties (type dm_smart_list)
presetlocationscope component, 1295 action, 589
presetnavigationitem component, 1295 properties (type dm_sysobject) action, 407
presetobjectlocator action, 550 properties (type dm_user) action, 648
presetobjectlocator component, 1296 properties (type dmc_calendar_event)
presetobjectlocatorcontainer component, 1040
component, 1298 properties (type dmc_datatable)
presetobjecttypelocator action, 551 component, 1041
presetobjecttypelocator component, 1299 properties (type dmc_preset_package)
presetobjecttypelocatorcontainer action, 554
component, 1300 properties (type dmc_prm_library_
presetotherdocbaselocationeditor request) component, 1263
component, 1301 properties (type dmc_room)
presetpermissionitem component, 1301 component, 1042
presetpermissionlocator action, 552 properties component, 926
presetscopes component, 1302 propertysheetcontainer component, 928
presettemplateitem component, 1303 propertysheetwizardcontainer
presettypeitem component, 1304 component, 930
presettypescope component, 1305
presetusergrouprolescope
component, 1305
Q
presetuserorgrouplocator action, 553 quotevalidator control, 151
presetwizardcontainer component, 1306

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1801
Index

R removevirtualdocumentnodecontainer
rangevalidator control, 153 component, 1550
readOnly element, common, 832 removewfattachment (type
reassignuser (privilege superuser, type dmi_wf_attachment) action, 729
dm_user) action, 649 removewfattachment component, 1635
reassignuser (type dm_member_user) rename (type dm_sysobject) action, 409
action, 649 rename component, 931
recentdocumentlocator component, 1088 renamegrouplist component, 1510
recentfolderlocator component, 1089 renamereport component, 1511
recentgrouplocator component, 1506 renameuserlist component, 1512
recentsysobjectlocator component, 1090 renditions (type dm_sysobject) action, 568
recentuseronlylocator component, 1507 reordervirtualdocumentnodes
recentuserorgrouplocator component, 1551
component, 1509 repeatworkflowtask (type dm_task)
recentwftemplatelocator component, 1630 action, 730
recordsubscriptionlocator (entitlement repeatworkflowtask component, 1636
recordsmanager), 1334 reportdetailsauditclassic (type
recurrence component, 1043 dm_workflow) (Webtop) action, 731
recurrexceptionicon control, 75 reportdetailsauditclassic (type
regexpvalidator control, 154 dm_workflow) (Webtop)
rejectroutertask (type dm_router_task) component, 1575
action, 724 reportdetailsauditdrilldown (type
rejectroutertask component, 1631 dm_workflow) action, 732
rejectworkflowtask (type dm_task) reportdetailsauditdrilldown
action, 725 component, 1576
rejectworkflowtask component, 1632 reportdetailsauditlist (type dm_workflow)
relationships (type dm_sysobject) action, 733
action, 408 reportdetailsauditlist component, 1577
removeattachment (type dmi_package) reportdetailsauditstreamline (type
action, 726 dm_workflow) (Webtop) action, 733
removeattachment component, 1632 reportdetailsauditstreamline (type
removecredential component, 904 dm_workflow) (Webtop)
removerequiredgroup action, 650 component, 1578
removerequiredgroupset action, 651 reportdetailscontainerclassic (type
removestartwfattachment (type dm_workflow) (Webtop)
dmi_package) action, 727 component, 1579
removestartwfattachment reportdetailscontainerdrilldown (type
component, 1633 dm_workflow) component, 1580
removestartwfwfattachment (type reportdetailscontainerlist (type
dmi_wf_attachment) action, 728 dm_workflow) component, 1581
removestartwfwfattachment reportdetailscontainerstreamline
component, 1634 (type dm_workflow) (Webtop)
removeuserorgroup (type dm_member_ component, 1582
group) action, 652 reportdetailsheader component, 1583
removeuserorgroup (type dm_member_ reportdetailsmap (type dm_workflow)
user) action, 653 action, 734
removevirtualdocumentnode reportdetailsmap component, 1584
component, 1549 reportdetailssummaryclassic (type
dm_workflow) (Webtop)
component, 1585

1802 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Index

reportdetailssummarydrilldown (type richtextdisplay control, 77


dm_workflow) (Webtop) action, 736 richtextdocbaseattribute control, 79
reportdetailssummarydrilldown (type richtextdocbaseattributelabel control, 80
dm_workflow) action, 735 richtextdocbaseattributevalue control, 81
reportdetailssummarydrilldown richtexteditor control, 82
component, 1586 richtextimagepicker component, 1044
reportdetailssummarylist (type richtextinsertlink component, 1044
dm_workflow) (Webtop) action, 737 richtextpanel control, 85
reportdetailssummarylist (type roleattributes component, 1513
dm_workflow) action, 736 rolelist component, 1513
reportdetailssummarylist roleproperties component, 1514
component, 1587 roombanner control, 86
reportdetailssummarystreamline roomgrouplocator component, 1045
(type dm_workflow) (Webtop) roomgrouplocatorcontainer
component, 1588 component, 1047
reportdql component, 1589 roominvite (entitlement collaboration)
reportmainclassic (Webtop) action, 738 component, 1048
reportmainclassic (Webtop) roommembers (type dmc_room)
component, 1590 action, 452
reportmaindrilldown action, 739 roommembership component, 1049
reportmaindrilldown component, 1591 roomoptions component, 1049
reportmainlist component, 1592 roomuserorgrouplocator
reportmainsettings action, 739 component, 1050
reportmainsettings component, 1593 roomuserorgrouplocatorcontainer
reportmainstreamline (Webtop) component, 1052
action, 740 row control, 133
reportmainstreamline (Webtop) run time
component, 1594 attribute values resolved, 17
reportsysobjectlocator component, 1595 runatclient attribute, 15
reportsysobjectlocatorcontainer runsearchtemplate (type dmc_search_
component, 1596 template) action, 590
repositionvirtualdocumentnode (type
dm_sysobject) component, 1552
repositorysearch control, 320
S
requestedtargets component, 1264 savechanges (Webtop) component, 1554
requiredfieldvalidator control, 155 savechanges component, 1553
rerunfailedautoworkflowtask (type savecredential component, 905
dm_task) action, 741 savedetailsreport element, common, 832
rerunfailedautoworkflowtask savedsearches (version 5.2.5)
component, 1637 component, 1367
resultshandling_preferences savereportlocator component, 1597
component, 1366 savereportname component, 1598
resumetask (type dm_task) action, 742 savesearch (version 5.2.5)
resumetask (type dm_task) component, 1369
component, 1638 savesearch action, 591
resumeworkflow (type dm_workflow) savesearch component, 1368
action, 743 savesearchcontainer component, 1370
resumeworkflow (type dm_workflow) savesearchtemplate action, 592
component, 1638 savesearchtemplate component, 1371
revisesearchtemplate action, 590

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1803
Index

search (version 5.3) (Webtop) selectuseridattributevalue


component, 1377 component, 939
search (version 5.3) component, 1375 selectuserorgroupattributevalue
search (Webtop) component, 1378 component, 940
search action, 593 sendlocator (type dm_notification)
search component, 1372 action, 744
search_preferences component, 1380 sendlocator (type dm_router_task)
search_types element, common, 832 action, 745
searchattribute control, 321 sendlocator (type dm_task) action, 745
searchattributegroup control, 324 serveroptionenabled element,
searchcontainer component, 1381 common, 834
searchdateattribute control, 327 service element, common, 834
searchfulltext control, 329 setbindingrule component, 1554
searchitems component, 1381 setrepositoryfromobjectid element,
searchlocation control, 331 common, 834
searchmonitoring component, 1382 showattachmentinfo element,
searchmonitoringcontainer common, 834
component, 1386 showautogettask element, common, 834
searchobjecttypedropdownlist showbreadcrumb element, common, 835
control, 333 showfilters element, common, 835
searchscopecheckbox control, 336 showfolderpath element, common, 835
searchsizeattribute control, 338 showfolders element, common, 835
searchsources_preferences showheaderforsinglepackage element,
component, 1387 common, 835
searchstatus component, 1387 showifdisabled, 16
searchstatuscontainer component, 1388 showifinvalid, 16
searchstoreclassic component, 1389 showjobstatus element, common, 835
searchstorestreamline component, 1390 showoptions element, common, 836
searchstoretemplate component, 1391 showpagesastabs element, common, 836
searchtemplate component, 1393 showtopic (entitlement collaboration, type
searchtemplatecontainer dm_sysobject) action, 453
component, 1394 showtopic (Webtop) component, 1055
searchtemplatefreelist control, 340 showtopic component, 1054
searchtemplatehiddenfixedlist showtopicaction (entitlement
control, 341 collaboration, type dm_sysobject)
searchtypes element, common, 833 (Webtop) action, 455
searchuser (type dm_user) action, 594 showtopicaction (entitlement
selectedattribute element, common, 833 collaboration, type dm_sysobject)
selectmultipleuserattributevalue action, 454
component, 932 showtopicdocbaseattribute control, 86
selectmultipleuseridattributevalue showtopicdocbaseattributelabel
component, 933 control, 87
selectmultipleuserorgroupattributevalue showtopicdocbaseattributevalue
component, 934 control, 88
selectrepeatingattributevalue showusertimeandcost element,
component, 935 common, 836
selectsingleattributevalue component, 936 skipVersionCheck element, common, 836
selectuser (type selectuser) action, 654 smartnavigation_preferences
selectuserattributevalue component, 938 component, 1395
sortableclustertreelist control, 342

1804 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Index

sortablelistbox control, 344 tablefields (type dmc_datatable)


spellchecker component, 1056 action, 456
sso_login component, 906 tablefields component, 1057
startComp element, common, 836 taskattachment component, 1648
startQueryString element, common, 836 taskcomments component, 1648
startwfattachment component, 1639 taskcomponentcontainer
startwfcomments component, 1640 component, 1649
startwfcontainer (type dm_process) taskheader component, 1650
component, 1641 taskhistory component, 1651
startwfperformers component, 1642 taskinfo component, 1652
startwfxformcontainer (type dm_process) taskmanager component, 1653
component, 1643 taskmanagercontainer (type
startworkflow (type dm_process) dm_notification) component, 1654
action, 746 taskmanagercontainer (type
startworkflow component, 1644 dm_router_task) component, 1655
startworkflowdrilldown component, 1645 taskmanagercontainer (type dm_task)
startworkflowfromdoc (type component, 1656
dm_sysobject) action, 747 taskmgrabortworkflow (type dm_task)
startworkflownotemplate action, 748 component, 1657
startworkflowtemplatelocatorcontainer taskmgractionname element,
component, 1646 common, 837
startworkflowxforms component, 1647 taskprocessvariables component, 1658
strategyselector control, 346 taskprogress component, 1659
streamlineview (type dm_message_ text control, 350
archive) (Webtop) component, 1196 textarea control, 352
streamlineview (type dmc_room) titlebar (Webtop) component, 1200
(Webtop) component, 1056 toolbar (Webtop) component, 1200
streamlineview (Webtop) tooltip attribute, 14
component, 1197 tooltipdatafield attribute, 14
style attribute, 14 tooltipnlsid attribute, 14
subscribeotherslocator component, 1421 topic control, 90
subscribeotherslocatorcontainer topicpanel control, 91
component, 1422 topicstatus control, 92
subscriptionlocator component, 1423 transformation element, common, 837
subscriptions element, common, 837 tree control, 358
subscriptions_classic (Webtop) type element, common, 837
component, 1424
subscriptions_drilldown
component, 1426
U
subscriptions_list component, 1427 ucfinvoker component, 907
subscriptions_streamline (Webtop) ucfrequired element, common, 838
component, 1428 unfilteredcontainersysobjectlocator
symbolicversionlabelvalidator component, 1093
control, 157 ungovern (entitlement collaboration)
sysobjectlocator component, 1091 action, 457
ungovern (type dm_folder)
component, 1058
T ungovernfolder (entitlement
tabbar (Webtop) component, 1198 collaboration) action, 457

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1805
Index

updatereplicasource element, vdmlist (Webtop) component, 1562


common, 838 vdmlist component, 1560
useraclobjectlocator component, 1515 vdmliststreamline (Webtop)
useraclobjectlocatorcontainer component, 1564
component, 1517 vdmliststreamline component, 1563
userattributes component, 1518 vdmvalidate component, 1565
userbrowse (privilege sysadmin, type vdmvalidate_container component, 1566
dm_user) action, 654 versionlabels component, 941
userchangehomedblist component, 1518 versions (type dm_sysobject) (Webtop)
userchangestate component, 1519 component, 943
userdelete component, 1520 versions (type dm_sysobject) action, 410
userimport (privilege sysadmin, type versions (type dm_sysobject)
dm_user) action, 655 component, 942
userimport component, 1521 versions (type wdk5_testtype_1)
userlist component, 1522 component, 944
usermanagement component, 1522 versions (type wdk5_testtype_2)
useronly element, common, 838 component, 945
useronlylocator component, 1523 versions (type wdk5_testtype_3)
useronlylocatorcontainer component, 946
component, 1525 view (entitlement collaboration, type
useroptions element, common, 838 dmc_notepage) action, 458
userorgroupchooser action, 656 view (type dm_externalresult) action, 595
userorgrouplocator component, 1526 view (type dm_folder) (Webtop)
userorgrouplocatorcontainer action, 497
component, 1528 view (type dm_message_archive)
userorgroupmemberlocator (Webtop) action, 498
component, 1529 view (type dm_message_archive)
userorgroupmemberlocatorcontainer action, 498
component, 1530 view (type dm_notification) action, 749
userproperties component, 1531 view (type dm_process) action, 750
userrename component, 1532 view (type dm_query) action, 596
userrenamelog (type dm_user) action, 657 view (type dm_router_task) action, 751
userrequestlist (entitlement prm, view (type dm_smart_list) action, 598
role dmc_prm_library_user) view (type dm_sysobject) (Webtop)
component, 1265 action, 501
userwhereused component, 1533 view (type dm_sysobject) action, 500
utf8stringlengthvalidator control, 158 view (type dm_sysobject)
component, 1167
view (type dm_task) action, 752
V view (type dm_workflow) action, 753
validationsummary control, 159 view (type dmc_calendar_event)
vdm_preferences (Webtop) action, 459
component, 1556 view (type dmc_datatable_row)
vdm_preferences component, 1555 action, 460
vdmclickactionprompt (Webtop) view (type dmc_search_template)
component, 1558 action, 597
vdmclickactionprompt component, 1557 view (type dmr_content) action, 502
vdmclickactionpromptcontainer view (type dmr_content) component, 1168
component, 1559 view_as_html (type dm_message_archive)
vdmcopyoption component, 1560 (Webtop) action, 495

1806 EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide
Index

view_as_html_drilldown (type wfuseronlylocatorcontainer


dm_message_archive) (Webtop) component, 1673
action, 494 wfuserorgroupfromgrouplocator
view_as_outlook_mail_msg (type component, 1674
dm_message_archive) action, 496 wfuserorgroupfromgrouplocatorcontainer
viewassemblies (Webtop) component, 1676
component, 1541 wfuserorgrouplocator component, 1677
viewassemblies component, 1540 wfuserorgrouplocatorcontainer
viewcontainer (type dm_sysobject) component, 1678
component, 1169 windowparams element, common, 840
viewcontainer (type dmr_content) wizardcontainer component, 1201
component, 1170 workflowavailability action, 754
viewcontent (type dm_sysobject) workflowavailability component, 1680
action, 503 workflowcalendar component, 1680
viewexternalresult component, 1395 workflowcalendarcontainer
viewreport (type dm_rename_log) component, 1681
action, 657 workflowcalendardetails
views element, common, 839 component, 1682
viewsavedresults (type dm_smart_list) workflowcalendareditcontainer
action, 600 component, 1683
virtuallinkconnect component, 908 workflowcalendarevent component, 1684
visible attribute, 14 workflowcalendarlist (type
visiblerepository_preferences workflow_calendar) action, 754
component, 1281 workflowcalendarlist component, 1685
workflowstatusactionname element,
common, 841
W workflowstatusclassic (Webtop)
webwfm component, 1659 action, 755
webwfm_checkjvm component, 1661 workflowstatusclassic (Webtop)
webwfmcontainer component, 1662 component, 1686
webwfmeditcontainer component, 1663 workflowstatusdrilldown action, 756
wfgrouponlylocator component, 1663 workflowstatusdrilldown
wfgrouponlylocatorcontainer component, 1686
component, 1665 workflowstatuslist action, 756
wfrecentuseronlylocator component, 1666 workflowstatuslist component, 1687
wfsysobjectlocatorcontainer workflowstatusstreamline (Webtop)
component, 1667 action, 757
wftemplatefolderlocator component, 1668 workflowstatusstreamline (Webtop)
wftemplatelocatorcontainer component, 1688
component, 1669 workflowxforms component, 1689
wftemplatesubscriptionlocator workqueuegroupvisible element,
component, 1670 common, 841
wfuseronlylocator component, 1672

EMC Documentum Web Development Kit and Webtop Version 6.5 Reference Guide 1807

You might also like