Grokking the Paradigm Quickie Configurations

© 2006 EMC Corporation. All rights reserved.

Grokking the ParadigmQuickie ConfigurationsDennis Dawson

Principal Technical Writer

EMC/Documentum

Grokking the Paradigm 2© 2006 EMC Corporation. All rights reserved.

Fifteen Minutes’ Worth of Stuff

• Here’s what I’m gonna talk about:– Webtop Configuration– Adding an Action Link– Removing an Action Link


Which Files Should I Fiddle Around With?

• All of the files you need to fiddle with are in the <application root>/webtop directory

• Copy files to /webtop/custom to modify them

• Do not modify any of the files in place – only modify copies you have created in your custom directory


Webtop/WDK Layers

“Ogres are like onions – they have layers.”- Shrek

wdk – app.xml


Webtop/WDK Layers


wdk – app.xmlwdk – app.xml

webcomponent – app.xml


Webtop/WDK Layers


wdk – app.xmlwdk – app.xml


webtop – app.xml


Webtop/WDK Layers

“You know what else everybody likes? Parfaits.”

- Donkey

wdk – app.xml


webtop – app.xml

custom – app.xml


Tweaking WebtopSelecting a document

• Clicking a checkbox to select one document in a list sets off an interesting chain of events in and of itself.

• Consider if you had to code by hand not only the decision tree to determine which commands should be available but also the ones that should be disabled


The Magic Behind the Scenes

• When the multiselect object is rendered, the table multiselectActionIdTbl stores Boolean values used to manage which dynamic commands are available

Doc1.htmDoc2.htmDoc3.htmDoc4.xmlDoc5.htmDoc6.htm. . .

checkout checkin cancelco . . .

001111

110000

110000


Simple Configurations Have High Value

• The most elaborate, complex behavior is pretty much handled for you

• As a result, the only thing you really need to do is reference a control and action on the JSP, and leave the “work” to the server at runtime


Adding an Action LinkCopying toolbar.jsp

• In unstripped.jar, locate toolbar.jsp and copy it to the /custom/toolbar directory


Adding an Action LinkCopying toolbar_component.xml

• Locate the /webtop/config/toolbar_component.xml configuration file and copy it to the custom/config directory


Adding an Action LinkConfiguration

• Reconfigure the toolbar component to look for our custom page

...<pages> <start>/custom/toolbar/toolbar.jsp</start></pages>...


Adding an Action LinkModifying toolbar.jsp

• Note the script calls at the top of toolbar.jsp.

• These provide access to the utility scripts that support common form behaviors and dynamic actions

<dmf:webform/>

<script

language="JavaScript1.2"

src='<%=Form.makeUrl(request,

"/wdk/include/dynamicAction.js")%>'

/>


Adding an Action Linkfor the Rename command

• To add the Rename command to the toolbar, I can add another cell to the HTML table and insert this minimal code:

<td nowrap> <dmfx:actionlink action="rename" dynamic="multiselect" label="Rename" /></td>



• Here’s the Rename action link we just added:



We can add more attributes to improve the look and feel

<td nowrap> <dmfx:actionlink action="rename" dynamic="multiselect" label="Rename" cssclass="toolbaractions" src="icons/toolbar/icon_checkout_16.gif" srcdisabled= "icons/toolbar/icon_checkout_disabled_16.gif" linkspacer="10" /></td>



• Here’s the Rename action link with formatting:


Adding an Action Linkfor the History command

<td nowrap> <dmfx:actionlink dynamic="singleselect" label="History" action="history"

cssclass="toolbaractions" src="icons/toolbar/icon_checkout_16.gif" srcdisabled= "icons/toolbar/icon_checkout_disabled_16.gif" /></td>


Adding an Action Linkfor the History command

• Here is the new History action link. Note that when multiple objects are selected, Rename is active, but History is not


Removing an Action Link

• You can remove an action link from the interface by commenting out its code




Removing an Action Link

• Here is the toolbar with the Add to Clipboard command removed:

© 2006 EMC Corporation. All rights reserved.

Clarifications/comments?Please send them to:

[email protected]

WDK Questions? Please visit:http://developer.emc.com/developer/

Documents

Grokking the Paradigm Quickie Configurations