© 2006 EMC Corporation. All rights reserved. Grokking the Paradigm Modifying Menus Dennis Dawson...

© 2006 EMC Corporation. All rights reserved.

Grokking the ParadigmModifying MenusDennis Dawson

Principal Technical Writer

EMC/Documentum

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

Ten Minutes’ Worth of Stuff

• Here’s what I’m gonna talk about:– Adding a menu command– Rearranging commands– Removing a menu command


Remember...

Magic is easy, once YOU

know the secret!

Marshall Brodien


Overview

• To modify menu commands we need to:– Identify the configuration file and JSP to modify– Copy the file to the custom/config directory– Edit the dmfx:actionmenuitem elements and attributes– Refresh the configuration

• Similar to customizing the toolbar


Adding a Menu CommandIdentifying the Files to Modify

• The “obvious” place to start is /webtop/config/menubar_component.xml

• Copy to /custom/config/menubar_component.xml



Note the location of the menubar.jsp (so we can copy it) <component id="menubar"

extends="menubar:/webcomponent/config/library/menubar/menubar_component.xml">

... <pages> <start> /webtop/classic/menubar/menubar.jsp </start> </pages>...</component>



• Change the extends attribute to point to the Webtop file we just copied.

• Change the <start> page to a new custom page we’ll modify<component id="menubar"

extends="menubar:/webtop/config/menubar_component.xml">... <pages> <start> /custom/menubar/menubar.jsp </start> </pages>...</component>



• Copy /webtop/classic/menubar to the /custom directory



• menubar.jsp includes menubar_body.jsp

<%@ page contentType="text/html; charset=UTF-8" %>

<%@ page errorPage="/wdk/errorhandler.jsp" %>

<%@ taglib uri="/WEB-INF/tlds/dmform_1_0.tld" prefix="dmf" %>

<%@ taglib uri="/WEB-INF/tlds/dmformext_1_0.tld" prefix="dmfx" %>

<%@ include file='/webcomponent/library/menubar/menubar_body.jsp' %>



• Menubar.jsp includes menubar_body.jsp• Copy the file from /webcomponent/library/menubar to

/custom/menubar



• Edit /custom/menubar/menubar.jsp to include our custom menubar_body.jsp (same directory)

<%@ page contentType="text/html; charset=UTF-8" %>

<%@ page errorPage="/wdk/errorhandler.jsp" %>

<%@ taglib uri="/WEB-INF/tlds/dmform_1_0.tld" prefix="dmf" %>

<%@ taglib uri="/WEB-INF/tlds/dmformext_1_0.tld" prefix="dmfx" %>

<%@ include file="menubar_body.jsp" %>


Adding a Menu Command

• Adding a command to a menu (actionmenuitem) follows the same paradigm as adding an actionlink to the toolbar

<dmfx:actionmenuitem

dynamic="multiselect"

name="file_rename"

value="Rename"

action="rename"

/>

• Slip the new item between the file_saveas command and file_checkin

<dmfx:actionmenuitem dynamic='singleselect' id='file_saveas' name='file_saveas' nlsid='MSG_SAVE_AS' action='saveasxforms' showifinvalid='true'/>



<dmfx:actionmenuitem dynamic="multiselect" id = "file_rename" name = "file_rename" value = "Rename" action = "rename" />

<dmfx:actionmenuitem dynamic='multiselect' name='file_checkin' nlsid='MSG_CHECKIN' action='checkin' showifinvalid='true'/>



• The Rename command added to the File menu



• Enabled when one or more items are selected

Moving a Menu Command

• To move a menu command, change its position in the JSP

<dmfx:actionmenuitem dynamic='singleselect' id='file_view' name='file_view' nlsid='MSG_VIEW_FILE' action='view' showifinvalid='true'/>



<dmfx:actionmenuitem dynamic="multiselect" id = "file_rename" name = "file_rename" value = "Rename" action = "rename" />

<dmfx:actionmenuitem dynamic='singleselect' id='file_saveas' name='file_saveas' nlsid='MSG_SAVE_AS' action='saveasxforms' showifinvalid='true'/>


Moving a Menu Command

• The Rename command in its new position


Removing a Menu Command

• Comment out a command to remove it from the menu

<% /* Removed by Dennis Dawson 11-16-06

<dmfx:actionmenuitem dynamic='multiselect' name='file_cancelcheckout' nlsid='MSG_CANCEL_CHECKOUT' action='cancelcheckout' showifinvalid='true'/>

*/ %>


Removing a Menu Command

• The Cancel Checkout command removed


Multiplicitas Componatis Res Simplex

• Taken as a whole, Webtop and WDK-based applications are intricate, multifaceted feats of programming

• When you focus on any one element of the application, it’s easy to follow the logic and duplicate its behavior

• Once you grok the paradigm, enhancing and customizing complex applications becomes a series of simple steps

© 2006 EMC Corporation. All rights reserved. Grokking the Paradigm Modifying Menus Dennis Dawson...

Documents

Transcript of © 2006 EMC Corporation. All rights reserved. Grokking the Paradigm Modifying Menus Dennis Dawson...