psdi.app.appsetup

Class MaxMenu

  • All Implemented Interfaces:
    java.rmi.Remote, MaxMenuRemote, MboConstants, MboRemote, MaxRemoteProxy


    public class MaxMenu
    extends Mbo
    implements MaxMenuRemote
    Mbo object to represent MaxMenu. It specifies menu-related information needed for the main Start Center and GoTo menus, and for menu options and toolbar options within Maximo applications.

    This is a system level object.

    The key attributes for this object are MenuType, ModuleApp, Position, and SubPosition.

    The attributes in this object are as follows:

    Attribute NameDescription
    AccessKeyThis can contain a keyboard shortcut for accessing this element from the UI. For example, the "Clear" function could be accessed via CTRL+ALT+C as well as by clicking a toolbar button.
    ElementTypeSpecifies whether this record describes a module, application, option, header, or separator.
    • MODULE is used for MenuType MODULE to indicate that this record describes a module. In this case, ModuleApp is the foreign key to MaxModules.
    • APP is used for MenuType MODULE to indicate that this record describes an application. In this case, ModuleApp is the foreign key to MaxApps.
    • OPTION is used for MenuType APPMENU and APPTOOL to indicate that this record describes an option. In this case, ModuleApp + Key compose the foreign key to SigOption.
    • OTHER can be used for MenuType MODULE to indicate a third-party (non-Maximo) application. This element type will have non-null values for HeaderDescription and URL.
    • HEADER indicates that this is a header, under which there will be other options and separators. For headers, Key = null, SubPosition = 0, and HeaderDescription = freeform value. Headers can be used for any MenuType.
    • SEP indicates that this is a separator. For separators, Key = null. Separators can be used for any MenuType.
    HeaderDescriptionIf this is a header (ElementType = HEADER) or this is a third-party program (ElementType = OTHER), this is the label that will appear in the UI.
    ImageThis can contain a filename for an image which can be displayed in the UI.
    KeyValue
    • For MenuType MODULE, if ElementType = MODULE, this specifies a module name. It will be the foreign key to MaxModules.
    • For MenuType MODULE, if ElementType = APP, this specifies an application name. It will be the foreign key to MaxApps.
    • For MenuType APPMENU and APPTOOL, if ElementType = OPTION, this specifies an optionname. ModuleApp + Key will be the foreign key to SigOption.
    • For separators and headers, Key will be null.
    MenuTypeSpecifies whether this record pertains to the main menu, an application menu, or an application toolbar.
    • MODULE indicates that this pertains to the main Start Center and GoTo menus. Records of this type specify the applications within a module.
    • APPMENU indicates that this pertains to the menu options within an application.
    • APPTOOL indicates that this pertains to the toolbar options within an application.
    ModuleAppWhen MenuType is MODULE, this is a module name; foreign key to MaxModules. For menu types APPMENU and APPTOOL, this is an application name; foreign key to MaxApps.
    PositionIndicates the position of this element within the menu or toolbar.
    SubPositionIf this element appears under a header, SubPosition represents its sequence within this header, and will be > 0. Any element not under a header will have SubPosition = 0.
    TabDisplayFor menu and toolbar options, TabDisplay identifies the tabs in the UI where the option can be displayed.
    • ALL indicates that this option is available on all tabs.
    • LIST indicates that this option is available only on the List tab.
    • MAIN indicates that this option is available only on the Main tab.
    URLWhen ElementType is OTHER, this is the URL for accessing that third-party application.
    VisibleThis flag indicates whether this element should be displayed in the UI. If Visible is No, the element will not be displayed.

    Below is a partial example of data pertaining to the Assets application's menu options, shown in the sequence they would appear on the menu. (Toolbar options would have the same format, but with MenuType = APPTOOL.)

    MenuTypeModuleAppPositionSubPositionElementTypeKeyValueComment
    APPMENUASSET20OPTIONSTATUSThis indicates the SigOption STATUS (Change Status).
    APPMENUASSET40OPTIONVIEWHISTThis indicates the SigOption VIEWHIST (View Status History).
    APPMENUASSET60OPTIONMETREADThis indicates the SigOption METREAD (Enter Meter Readings).
    APPMENUASSET80SEP(null)This indicates a separator.
    APPMENUASSET100OPTIONDRILLDOWNThis indicates the SigOption DRILLDOWN (Open Drilldown).
    APPMENUASSET120SEP(null)This indicates a separator.
    APPMENUASSET140HEADER(null)This indicates a header. The label for the header will be stored in HeaderDescription, which for this example would equal "Documents".
    APPMENUASSET142OPTIONDFDOCTYPThis indicates the SigOption DFDOCTYP (Manage All Document Folders), which appears under the "Documents" header.
    APPMENUASSET144OPTIONREGISDOCThis indicates the SigOption REGISDOC (Manage Document Library), which appears under the "Documents" header.

    Below is a partial example of the first two modules in Maximo (Assets and Inventory).

    MenuTypeModuleAppPositionSubPositionElementTypeKeyValueComment
    MODULESAFETY100MODULEASSETThis indicates the Safety module.
    MODULESAFETY200APPHAZARDSThis indicates the Hazards application within the Safety module.
    MODULESAFETY300APPPRECAUTNThis indicates the Precautions application within the Safety module.
    MODULESAFETY400APPTAGLOCKThis indicates the Taglock application within the Safety module.
    MODULESETUP100MODULESETUPThis indicates the Setup module.
    MODULESETUP200APPMULTISITEThis indicates the Organizations (Multisite) application within the Setup module.
    MODULESETUP300APPCALENDRThis indicates the Calendar application within the Setup module.
    MODULESETUP400APPSETSThis indicates the Sets application within the Setup module.
    MODULESETUP500HEADER(none)Maxmenu description = "Reconciliation." This is a header for apps to be grouped under the Reconciliation nested menu.
    MODULESETUP501APPRECONTASKThis indicates the Reconciliation Tasks application within the Reconciliation group of the Setup module.
    MODULESETUP502APPRCNLNKRULEThis indicates the Link Rules application within the Reconciliation group of the Setup module.
    • Constructor Detail

      • MaxMenu

        public MaxMenu(MboSet ms)
                throws MXException,
                       java.rmi.RemoteException
        Construct the MaxMenu object
        Throws:
        MXException
        java.rmi.RemoteException
    • Method Detail

      • skipCopyField

        protected boolean skipCopyField(MboValueInfo mvi)
                                 throws MXException,
                                        java.rmi.RemoteException
        Overrides the skipCopyField() in the Mbo. The following field(s) will be skipped without being copied to the newly duplicated MaxMenu:
        1. moduleapp
        Overrides:
        skipCopyField in class Mbo
        Parameters:
        mvi - The MboValueInfo object of the MboValue that needs to be copied.
        Returns:
        true If the field does not need to be copied, in all other cases return false.
        Throws:
        MXException
        java.rmi.RemoteException