Package com.microstrategy.web.app
Class ShortcutList
- java.lang.Object
-
- com.microstrategy.utils.config.AbstractConfigurationElement
-
- com.microstrategy.utils.config.AbstractConfigurationElementList
-
- com.microstrategy.web.app.ShortcutList
-
- All Implemented Interfaces:
ConfigurationElement
,ConfigurationElementList
,ConfigurationFile
,java.lang.Cloneable
public class ShortcutList extends AbstractConfigurationElementList
The ShortcutList class is a multipurpose class that represents a list ofShortcut
objects. This objects can be used to display links, menus, toolbars and pickers.ShortcutList objects are the in memory representation of the <shortcut-list> elements from the pageConfig.xml file and menus, toolbars and pickers definition files. The properties of this object map directly the attributes of the configuration tag
The following list explains the different types of ShortcutList objects/tag elements used throughout the applicattion:
- <template><shortcut-list-set><shortcut-list>... represents a list of links that can be displayed in the application using the <web:shortcutOptions> tag library.
- <menus><shortcut-list-set><shortcut-list>...
represents a menu block that can be display using the
Menu
GUI Element. - <toolbars><shortcut-list-set><shortcut-list>...
represents a toolbar that can be display using the
Toolbar
GUI Element. - <system-pickers><shortcut-list-set><shortcut-list>... represents the list of options that appear inside a system picker, like those used in toolbars.
- Since:
- MicroStrategy Web 7.3.1 or earlier
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class com.microstrategy.utils.config.AbstractConfigurationElement
AbstractConfigurationElement.FilteredList
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
ATT_BASE_BEAN
xml attribute name for the base bean property of the shortcut liststatic java.lang.String
ATT_DESC
xml attribute name for the description of the shortcut liststatic java.lang.String
ATT_DESC_ID
xml attribute name for the descriptor ID of the shortcut liststatic java.lang.String
ATT_ENABLE_FEATURE_ID
xml attribute name for the enable feature associated with this shortcut liststatic java.lang.String
ATT_FEATURE_ID
xml attribute name for the feature associated with this shortcut liststatic java.lang.String
ATT_NAME
xml attribute name for the name of the shortcut liststatic java.lang.String
ATT_TYPE
xml attribute name for the type associated with this shortcut liststatic java.lang.String
NODE_SHORTCUTS
constant for the shorcut list node namestatic int
TYPE_DEFAULT
static int
TYPE_STYLES
-
Fields inherited from class com.microstrategy.utils.config.AbstractConfigurationElementList
ATT_VERSION
-
Fields inherited from class com.microstrategy.utils.config.AbstractConfigurationElement
ATT_CONFIG_SRC, ATT_DELETED, ATT_POSITION, ATT_PROTOTYPE, ATT_USE_DEFAULT
-
-
Constructor Summary
Constructors Constructor Description ShortcutList()
Class constructor.ShortcutList(org.w3c.dom.Document doc)
Class constructor.ShortcutList(org.w3c.dom.Node root)
Class constructor.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description WebAttributeList
getAttributeList()
Get the attribute list for the instanceWebAttributeList
getAttributeList(boolean createElement)
java.lang.String
getBaseBean()
Returns the bean from the pages bean hierarchy associated with the shortcut list.java.lang.String
getDescriptor()
Returns a descriptor that the application should use to display the shortcut list if the desc-id attribute is missing.java.lang.String
getDescriptorID()
Returns the Resource Bundle item id that the application should use to display the shortcut list in the language of the user's locale.java.lang.String
getEnableFeatureId()
Represents a feature that is evaluated to determine whether the shortcut list object should appear enabled or disabled when it is rendered.java.lang.String
getFeatureID()
Returns the id of a feature that is evaluated to determine whether the shortcut list object should be displayed.protected java.lang.String
getKeyAttribute()
This method must return the attribute that uniquely identifies this element among its siblings; if no single attribute can be used, return null and override thegetKey
andsetKey
methods.java.lang.String
getName()
Returns the name for this shortcut list, a unique identifier of the ShortcutList instance.Shortcut
getShortcut(java.lang.String name)
Shortcut
getShortcutByFeatureId(java.lang.String featureId)
java.lang.String
getString(Messages messages)
Returns the object's localized descriptor.int
getType()
Returns the ShortcutList's type.void
setBaseBean(java.lang.String value)
Indicates the bean from the pages bean hierarchy associated with the shortcut list.void
setDescriptor(java.lang.String descriptor)
Provides a descriptor that the application should use to display the shortcut list if the desc-id attribute is missing.void
setDescriptorID(java.lang.String descriptorID)
Provides the Resource Bundle item id that the application should use to display the shortcut list in the language of the user's locale.void
setEnableFeatureId(java.lang.String value)
Returns the ID of the enable feature associated with the ShortcutList.void
setFeatureID(java.lang.String value)
Indicates a feature-id that is evaluated to determine whether the shortcut list object should be displayed.void
setName(java.lang.String name)
Set the name of the ShortcutList instance, a unique identifier of the ShortcutList instance.void
setType(int type)
Sets the type property value of the instance.-
Methods inherited from class com.microstrategy.utils.config.AbstractConfigurationElementList
clear, clone, get, get, getFilteredList, getKey, getList, getValues, getVersion, init, isEmpty, put, put, registerElementInList, remove, setVersion, size, sort
-
Methods inherited from class com.microstrategy.utils.config.AbstractConfigurationElement
addFileSource, applyCustomization, applyCustomizations, cleanUpDeletedElements, delete, deltas, deltas, equalAtts, equalElements, equalNodeValues, equals, equalsIncludingDeletedElements, exportAttributesToXML, exportElementsToXML, exportNodeValueToXML, getAttribute, getAttributes, getBoolAttribute, getChildKey, getConfigSrc, getDTDFileName, getElement, getElement, getElements, getFileLoader, getIntAttribute, getIntAttribute, getKey, getLineNumber, getList, getNextKey, getNodeName, getNodeValue, getNodeValue, getOrCreateElement, getParent, getPosition, getPrototype, getRegisteredClass, getSelfInitPath, getSource, getStrAttribute, getUseDefault, getXMLParserParameters, getXMLSerializerParameters, hashCode, hashCodeAtts, hashCodeElements, hashCodeNodeValues, hasRegisteredClass, initAttributesFromXML, initDefaultAttributes, initElementFromXML, initElementsFromXML, initFromFile, initFromResource, initFromXML, initFromXML, initNodeValueFromXML, initPrototype, isActive, isCustomized, isDeleted, isDirty, isInSource, isKeyAttribute, load, mergeChanges, newChildInstance, newSource, original, populate, printAttributes, printElements, printNodeValue, refreshLists, registerClass, registerElement, registerElement, registerElementList, reload, reloadPrototype, removeAttribute, removeDefaults, replaceList, restore, save, save, saveChangesAs, saveConfig, saveFlatXML, saveNode, saveSource, setAttribute, setBoolAttribute, setChildOriginals, setConfigSrc, setCustomized, setElement, setFileLoader, setIntAttribute, setKey, setLineNumber, setNodeName, setNodeValue, setPosition, setPrototype, setSelfInitPath, setStrAttribute, setUseDefault, setUseValidation, throwConfigParseException, toString, toXML, toXML, toXML, toXML, useNodeValue, useValidation
-
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface com.microstrategy.utils.config.ConfigurationElement
getAttribute, getAttributes, getElement, getElements, getKey, getNodeName, getStrAttribute, initFromXML, reload, toXML
-
-
-
-
Field Detail
-
NODE_SHORTCUTS
public static final java.lang.String NODE_SHORTCUTS
constant for the shorcut list node name- See Also:
- Constant Field Values
-
ATT_NAME
public static final java.lang.String ATT_NAME
xml attribute name for the name of the shortcut list- See Also:
- Constant Field Values
-
ATT_DESC
public static final java.lang.String ATT_DESC
xml attribute name for the description of the shortcut list- See Also:
- Constant Field Values
-
ATT_DESC_ID
public static final java.lang.String ATT_DESC_ID
xml attribute name for the descriptor ID of the shortcut list- See Also:
- Constant Field Values
-
ATT_BASE_BEAN
public static final java.lang.String ATT_BASE_BEAN
xml attribute name for the base bean property of the shortcut list- See Also:
- Constant Field Values
-
ATT_FEATURE_ID
public static final java.lang.String ATT_FEATURE_ID
xml attribute name for the feature associated with this shortcut list- See Also:
- Constant Field Values
-
ATT_ENABLE_FEATURE_ID
public static final java.lang.String ATT_ENABLE_FEATURE_ID
xml attribute name for the enable feature associated with this shortcut list- Since:
- MicroStrategy Web 8.0.0
- See Also:
- Constant Field Values
-
ATT_TYPE
public static final java.lang.String ATT_TYPE
xml attribute name for the type associated with this shortcut list- Since:
- MicroStrategy Web 8.0.0
- See Also:
- Constant Field Values
-
TYPE_DEFAULT
public static final int TYPE_DEFAULT
- Since:
- MicroStrategy Web 8.0.0
- See Also:
- Constant Field Values
-
TYPE_STYLES
public static final int TYPE_STYLES
- Since:
- MicroStrategy Web 8.0.0
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
ShortcutList
public ShortcutList()
Class constructor. Initializes a new -empty- instance of the EventMapList class.
-
ShortcutList
public ShortcutList(org.w3c.dom.Node root)
Class constructor. Initializes a ShortcutList instance based on the information included in the XML Node- Parameters:
root
- Node instance representing the shortcut list information.
-
ShortcutList
public ShortcutList(org.w3c.dom.Document doc)
Class constructor. Initializes a ShortcutList instance based on the information included in the DOM Document- Parameters:
doc
- Document instance representing the shortcut list information.
-
-
Method Detail
-
getKeyAttribute
protected java.lang.String getKeyAttribute()
Description copied from class:AbstractConfigurationElement
This method must return the attribute that uniquely identifies this element among its siblings; if no single attribute can be used, return null and override thegetKey
andsetKey
methods.- Overrides:
getKeyAttribute
in classAbstractConfigurationElementList
- Since:
- MicroStrategy Web 9.0.0
-
getType
public int getType()
Returns the ShortcutList's type. When the ShortcutList is used to define a drop-down list, this property controls which class is used to render the ShortcutList:
- if type ==
TYPE_DEFAULT
, then the ShortcutList is rendered using aShortcutListPicker
- if type ==
TYPE_STYLES
then the ShortcutList is rendered using aShortcutListStyles
- Returns:
- the
int
value of the type property. - Since:
- MicroStrategy Web 8.0.0
- if type ==
-
setType
public void setType(int type)
Sets the type property value of the instance. Defines which class is used to render ShortcutList when used as a drop-down definition.- Since:
- MicroStrategy Web 8.0.0
- See Also:
getType()
-
getShortcut
public Shortcut getShortcut(java.lang.String name)
- Parameters:
name
- string representing the name of the shortcut to return- Returns:
- a
Shortcut
by its name.
-
getShortcutByFeatureId
public Shortcut getShortcutByFeatureId(java.lang.String featureId)
- Parameters:
featureId
- string representing the feature identifier of the shortcut to return- Returns:
- a
Shortcut
by its feature Id.
-
setName
public void setName(java.lang.String name)
Set the name of the ShortcutList instance, a unique identifier of the ShortcutList instance.
-
getName
public java.lang.String getName()
Returns the name for this shortcut list, a unique identifier of the ShortcutList instance.
-
getDescriptor
public java.lang.String getDescriptor()
Returns a descriptor that the application should use to display the shortcut list if the desc-id attribute is missing.
-
setDescriptor
public void setDescriptor(java.lang.String descriptor)
Provides a descriptor that the application should use to display the shortcut list if the desc-id attribute is missing.
-
getDescriptorID
public java.lang.String getDescriptorID()
Returns the Resource Bundle item id that the application should use to display the shortcut list in the language of the user's locale.
-
setDescriptorID
public void setDescriptorID(java.lang.String descriptorID)
Provides the Resource Bundle item id that the application should use to display the shortcut list in the language of the user's locale.
-
setBaseBean
public void setBaseBean(java.lang.String value)
Indicates the bean from the pages bean hierarchy associated with the shortcut list. If a shortcut object inside the shortcut list does not define a base bean attribute, the value of this base-bean attribute is used in tasks such as resolving features for the shortcut. (If this attribute is not set, the application tries to use the base-bean attribute from theelement.)
-
getBaseBean
public java.lang.String getBaseBean()
Returns the bean from the pages bean hierarchy associated with the shortcut list.- See Also:
setBaseBean(java.lang.String)
-
setFeatureID
public void setFeatureID(java.lang.String value)
Indicates a feature-id that is evaluated to determine whether the shortcut list object should be displayed.
-
getFeatureID
public java.lang.String getFeatureID()
Returns the id of a feature that is evaluated to determine whether the shortcut list object should be displayed.- Returns:
- String
-
setEnableFeatureId
public void setEnableFeatureId(java.lang.String value)
Returns the ID of the enable feature associated with the ShortcutList. If this feature is disabled, then the ShortcutList should be presented but disabled.- Since:
- MicroStrategy Web 8.0.0
-
getEnableFeatureId
public java.lang.String getEnableFeatureId()
Represents a feature that is evaluated to determine whether the shortcut list object should appear enabled or disabled when it is rendered.- Since:
- MicroStrategy Web 8.0.0
-
getAttributeList
public WebAttributeList getAttributeList()
Get the attribute list for the instance- Returns:
- attribute list for this style
- Since:
- MicroStrategy Web 8.0.0
-
getAttributeList
public WebAttributeList getAttributeList(boolean createElement)
-
getString
public java.lang.String getString(Messages messages)
Returns the object's localized descriptor.- Parameters:
messages
- the messages l10n object.- Returns:
- the
String
representing the object's localized descriptor.
-
-