MenuItem DTD and XML definitions

The MenuItem has the following entry in the DTD file:
Table 1. MenuItem definition
Line entry in the DTD file Description
<!ELEMENT MenuItem EMPTY> A MenuItem does not contain any sub-elements
<!ATTLIST MenuItem
    label CDATA #REQUIRED
    operation CDATA #IMPLIED
    process CDATA #IMPLIED
    application CDATA #IMPLIED
    operationPanel CDATA #IMPLIED
    name CDATA #IMPLIED
    code CDATA #IMPLIED
    parameters CDATA #IMPLIED
    yNavigationArea CDATA #IMPLIED
    xNavigationArea CDATA #IMPLIED
    heightNavigationArea CDATA #IMPLIED
    widthNavigationArea CDATA #IMPLIED
    shortDescription CDATA #IMPLIED
    longDescription CDATA #IMPLIED
    executeOperation CDATA #IMPLIED
    errorMessageOnInstantiateOperation CDATA "OperationerrorMessage"
    mnemonic CDATA #IMPLIED
    taskName CDATA #REQUIRED
    toolTipText CDATA #IMPLIED>
Attribute list
Table 2. MenuItem attributes
Attribute Description
label Label of the menu item (mandatory)
operation Name of the operation that launches when the menu item is clicked. This name must match an operation name in any of the operation files handled by the toolkit. The operation is instantiated using the standard toolkit mechanism (DSEOperation.readObject(operation)).
process Name of the process to be instantiated by the Navigation Controller when the menu item is clicked
application Name of the application that launches when the menu item is clicked. The name must include the name of the package where the Java class is defined.
operationPanel Identifier (id) of the operation panel defined in the view definition file (view.xml) that is associated with the panel. If instantiation using the definition file fails, then the panel will be instantiated using this value directly as the classname for instantiation.
name Name used by the Desktop to identify this component
code Code by which the task will be identified by the system. Applications or operations can request a task with a specific code or taskName from the Desktop.
parameters String representing the list of parameters accepted by the operation. Any operation that accepts parameters must define a format named fastPathInputFormat that describes the format that the string should have. If the parameters attribute is specified, its value will be unformatted in the process context before launching the task.
yNavigationArea Default vertical coordinate on the workspace where the panel will be opened
xNavigationArea Default horizontal coordinate on the workspace where the panel will be opened
heightNavigationArea Default height for the panel when it is first opened
widthNavigationArea Default width for the panel when it is first opened
shortDescription Text that is shown as the label of the launched task in the TaskArea
longDescription Text that is shown when the mouse cursor is moved over the launched task in the TaskArea
executeOperation Whether the operation will be executed before displaying the operation panel
errorMessageOn InstantiateOperation Text that is shown if an error occurs when launching the task
mnemonic Letter used as a mnemonic in the menu item label. Pressing the letter when the menu item is visible on the Desktop is equivalent to clicking the button.
taskName Name of the task to launch (mandatory)
toolTipText Text that is shown when the mouse cursor is moved over the button
The following is an example of an XML definition for a MenuItem:
<MenuItem taskName="TX01" label="Withdrawal"
  mnemonic="W" operation="withdrawalOperation" 
  operationPanel="WithdrawalView" 
  shortDescription="Withdrawal" 
  longDescription="Cash Withdrawal Operation" 
  code="WTHD03" />