Class PromptsClassicTransform
- java.lang.Object
-
- com.microstrategy.web.transform.AbstractTransform
-
- com.microstrategy.web.transform.AbstractLayoutTransform
-
- com.microstrategy.web.app.transforms.AbstractAppTransform
-
- com.microstrategy.web.app.transforms.PromptsClassicTransform
-
- All Implemented Interfaces:
AppTransform
,LayoutTransform
,Transform
- Direct Known Subclasses:
PromptsCreateReportTransform
,PromptsIFrameTransform
,PromptsSubscriptionTransform
public class PromptsClassicTransform extends AbstractAppTransform implements LayoutTransform
Title: PromptsClassicTransform
Description: The PromptsClassicTransform is respinsible of creating a container where all of the Prompt's page components will be rendered. It defines areas to render in container and if layouts aren't used then transform itself divides the rendering of the prompts container into several methods responsible of rendering such Prompt content, Prompt summary, Prompt Index, Execution bar, Generic Error, etc. Also, it is responsible of propagating generic properties to all prompts to be rendered in Page.
Company: Microstrategy, Inc.
- Since:
- MicroStrategy Web 7.3.1 or earlier
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class com.microstrategy.web.app.transforms.AbstractAppTransform
AbstractAppTransform.Context
-
-
Field Summary
Fields Modifier and Type Field Description protected java.lang.String
_1ptransImage
Constant indicating source path to a transparent image.protected PromptObject
_firstPrompt
Reference to first prompt in collection.protected java.lang.String
_imagesFolder
Constant indicating source path to a Folder image.protected PromptObject
_lastPrompt
Reference to last prompt in collection.protected java.lang.String
_lowerCornerImage
protected PromptObject
_nextBlockPrompt
Reference to next prompt in block.protected PromptObject
_nextPrompt
Reference to next prompt in collection of prompts.protected PromptsBean
_pb
Current Prompt bean.protected PromptObject
_previousBlockPrompt
Reference to previous prompt in block.protected PromptObject
_previousPrompt
Reference to previous prompt in collection of prompts.protected int
_totalPrompts
Indicates total of prompts defined in give prompted report.protected java.lang.String
_upperCornerImage
FormalParameter
blockCount
Specifies the number of prompts are displayed per block in report page.FormalParameter
canCancelPrompt
Indicates whether the cancel prompt button is displayedprotected static java.lang.String
DEFAULT_STYLE
Denotes constant for getting prompt's default style name.FormalParameter
displayMode
Specifies how multiple prompts will be displayed in report layout.FormalParameter
executeButtonLabel
Specifies the ID of the descriptor to use on the button for continue with document processing.FormalParameter
exportDocumentLabel
Deprecated.Instead, executeButtonLabel will be used.FormalParameter
exportReportLabel
Deprecated.Instead, executeButtonLabel will be used.FormalParameter
firstIncFecthImage
Deprecated.This formal parameter is not used anymore.FormalParameter
formID
Specifies the name and Id of the HTML form tag in report page.FormalParameter
incrementalAttrElemBlockCount
Specifies the maximum number of attribute elements to be displayed in available list when incremental fetch is available.FormalParameter
incrementalObjectsBlockCount
Specifies the maximum number of objects (attributes, attribute forms and metrics) to be displayed in available list when incremental fetch is available.FormalParameter
indexContentPostfixImage
Deprecated.This formal parameter is not used anymore.FormalParameter
indexListPostfixImage
Deprecated.This formal parameter is not used anymore.protected boolean
isDhtmlMode
Returns true if using DHTML.FormalParameter
lastIncFecthImage
Deprecated.This formal parameter is not used anymore.FormalParameter
levelFlag
Specifies what prompt region is displayed in report layout.FormalParameter
lowerCornerImage
Deprecated.static int
MODE_ALL
Indicates that all prompts should be displayed in one page.static int
MODE_ONE_BY_ONE
Indicates that one prompt per page should be displayed.FormalParameter
multiplePromptCssFile
Specifies the css file to use if it's multiple prompt information that requires to be rendered.FormalParameter
nextIncFecthImage
Deprecated.This formal parameter is not used anymore.FormalParameter
previousIncFecthImage
Deprecated.This formal parameter is not used anymore.protected static java.lang.String
PROMPT_LOADED_ARG
Constant denoting argument for prompt loaded first time.FormalParameter
promptQuestionLevelFlag
Specifies what sections are displayed in prompt question layout.FormalParameter
renderForm
Indicates wheteher the transform will render its own formprotected FormalParameter
showExecuteAtBottom
Specifies whether or not to show an 'Execute' button at the bottom of the list of Prompts.protected FormalParameter
showExecuteAtTop
Specifies whether or not to show an 'Execute' button at the top of the list of Prompts.FormalParameter
showMatchCase
Deprecated.since preference value can be read by accessing getPreferenceValue() methodFormalParameter
showRequired
Specifies whether or not to show required message in prompt question title.FormalParameter
showRequiredFirst
Deprecated.because preferences are read from Preferences object itself, and FP isn't necessary.protected static java.lang.String
STYLE_NAME_PROPERTY
Denotes constant for getting prompt's style name.FormalParameter
summaryImage
Deprecated.This formal parameter is not used anymore.FormalParameter
upperCornerImage
Deprecated.-
Fields inherited from class com.microstrategy.web.app.transforms.AbstractAppTransform
_bean, _componentBlock, _cssPrefix, _imgBlank, _imgWait, _selfOutput, _subOutput, appliesTo, CLASS_INPUT, CLASS_MESSAGE, contextMenus, cssFile, cssPrefix, debugErrorFlags, debugFlags, dragMode, extraInput, extraUrl, FP_APPLIES_TO, FP_CONTEXT_MENUS, FP_CSS_ERROR_MESSAGE, FP_CSS_ERROR_TITLE, FP_CSS_FILE, FP_CSS_PREFIX, FP_DEBUG_ERROR_FLAGS, FP_DEBUG_FLAGS, FP_DRAG_MODE, FP_EXTRA_INPUT, FP_EXTRA_URL, FP_HEIGHT, FP_IFRAME_ENABLED, FP_IMG_WAIT, FP_INITIAL_INDENT, FP_ORIENTATION, FP_ORIENTATIONS_ALLOWED, FP_PARTIAL_IFRAME_UPDATE, FP_PROCESSING_BUTTONS_FLAGS, FP_PROCESSING_INFO_FLAGS, FP_RESIZE_LEVEL, FP_SCRIPT_CLASS, FP_TYPE, FP_USE_DHTML, FP_WIDTH, globalCssErrorMessage, globalCssErrorTitle, height, iframeEnabled, imgWait, indent, initialIndent, isDHTML, orientation, orientationsAllowed, partialIframeUpdate, PROCESSING_BUTTONS_ALL, PROCESSING_BUTTONS_CANCEL, PROCESSING_BUTTONS_HISTORY_LIST, PROCESSING_BUTTONS_REFRESH, PROCESSING_BUTTONS_VIEW_DETAILS, PROCESSING_INFO_ALL, PROCESSING_INFO_DESCRIPTION, PROCESSING_INFO_LAST_UPDATE, PROCESSING_INFO_NAME, PROCESSING_INFO_NONE, PROCESSING_INFO_STATUS, processingButtonsFlags, processingInfoFlags, RESIZE_ALL, RESIZE_HORIZONTAL, RESIZE_NONE, RESIZE_VERTICAL, resizeLevel, scriptClass, scriptEndTagEncoder, type, useDHTML, width
-
-
Constructor Summary
Constructors Constructor Description PromptsClassicTransform()
Default no-args constructor.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description protected boolean
areRequiredPromptsShownFirst()
Initializes property indicating whether or not Required prompts are displayed first.protected boolean
canCancelPrompt()
Deprecated.The isRWDatasetAdded formal parameter has been removed so this method is no longer called.boolean
canDisplaySaveButton()
Indicates whether or not 'Save' button can be displayed.protected boolean
canSavePrompt()
Indicates whether or not end-user is enabled to save given Prompted Report.protected boolean
checkLevel(int iLevelConst)
Indicates if the level parameter value contains this flag.boolean
displayPromptOneByOne()
Indicates whether or not to display prompts one by one.protected AnchorTag
generateAnchor(WebEvent event)
Generates anAnchorTag
from given event instance.AnchorTag
generateIndexLink(PromptObject prompt)
Creates aAnchorTag
object (URL link) for invoking JS 'BuildUserSelections' method.protected java.lang.String
getAnchorPinFromRequest()
Indicates prompt position based on GUI action.protected WebEvent
getAnswerEvent()
Returns Prompt's answer event.protected int
getBlockEnd()
Indicates block ending index.protected int
getBlockInit()
Determines block initial index.protected WebEvent
getCancelEvent()
Returns Prompt's cancel event.protected int
getCurrentIndex()
Determines current prompt index.protected int
getCurrentPromptDisplayPosition()
Returns current prompt's display position.protected java.lang.String
getDecimalSeparator()
Indicates current decimal separator for active Locale.protected java.lang.String
getDefaultStyleName(PromptObject prompt)
Return the DefaultStyle names to use to render a prompt.java.lang.String
getDescription()
Returns description for this Transform.java.lang.String
getExecuteButtonLabel()
Specifies label to be displayed in 'Execute' button.protected java.lang.String
getIsDatasetAddedArgumentName()
Indicates Argument name for specifying whether or not 'Adding Dataset' functionality was executed.protected java.lang.String
getNavigationArgument(int position)
Returns argument name for indicating prompt's navigation.protected int
getPromptDisplayPosition(PromptObject prompt)
Indicates prompt's display position.protected AppContext
getPromptsAppContext()
Returns instance of AppContext.protected PromptsBean
getPromptsBean()
Returns instance ofPromptsBean
to be transformed.java.util.ArrayList
getPromptsList()
Returns current list of prompts.java.util.ArrayList
getPromptsListForIndexSection()
Returns list of prompts determined by block count settings.java.util.ArrayList
getPromptsListForSummary()
Returns list of prompts to be displayed in Summary mode.java.util.ArrayList
getPromptsListOneByOne()
Returns list of prompts sorted by 'one by one' mode.protected Transform
getPromptTransformByStyle(java.lang.String style)
Indicates corresponding prompt question transform associated to given style name.protected java.lang.String
getRenameMessageLabel()
protected java.lang.String
getRePromptArgumentName()
Returns the argument name for reprompt action.java.lang.String
getSaveButtonLabel()
protected WebEvent
getSaveEvent()
Returns an event for saving prompted report or RWD or HTML document.protected java.lang.String
getStyleName(PromptObject prompt)
Determines style name associated to given prompt object.java.lang.Class
getSupportedBeanType()
Returns bean type class.protected int
getTotalOpenPrompts()
Initializes property indicating total number of Open prompts in PromptsBean.void
initializeImages()
Initializes images to be used by this transform.protected void
initializePromptQuestionProperties(int promptPosition, Transform promptTransform)
Initializes given prompt transform properties before transform given prompt object.void
initializeTransform(Transformable data)
Initializes transform formal parameters.protected boolean
isAddDatasetInRequest()
Indicates if in the request is an 'Add dataset' request.boolean
isBottomExecuteButtonViewable()
Determines whether or not, top bottom buttons bar is viewable or not.boolean
isDhtmlMode()
Determines whether or not DHTML mode is on.boolean
isExecuteSectionAvailable()
Indicates whether or not 'Execute' section is viewable.protected boolean
isForDefinition()
boolean
isItemKeptInCartAvailable()
Indicates property value for whether or not selected item in cart's 'From' list should be removed.boolean
isMatchCaseShown()
Indicates property value for whether or not match case should be shown.protected boolean
isMultipartRequestEnabled()
Indicates whether or not to enable Multipart request as encode type content.boolean
isMultiplePrompt()
Indicates whether or not given report is consisted of more than one prompt.boolean
isOneByOneDisplayMode()
Indicates whether or not prompts should be rendered on the same page.boolean
isPromptIndexAvailable()
Indicates whether or not 'Prompt index' section can be rendered.boolean
isPromptIndexViewable()
Deprecated.Use isMultiplePrompt() method instead.boolean
isPromptQuestionsAvailable()
Indicates whether or not prompt questions are enabled.boolean
isPromptSummaryViewable()
Indicates whether or not the Prompt container is Summary mode.boolean
isReprompted()
Retrieves the value 'isReprompted' from the WebResultSetInstance This allows us to read the reprompt propery from an SDK object rather than passing a property in the request.boolean
isTopExecuteButtonViewable()
Determines whether or not, top execution buttons bar is viewable or not.protected boolean
isTreeRequest()
Indicates if the request is an action performed in the hierarchical tree prompt.protected void
processPromptedMetricAdded(MarkupOutput out)
Process action from Report where user added a prompted metric to Filter.protected boolean
promptsLoadedFirstTime()
Indicates whether or not, prompts are loaded for the first time.void
renderCalendar(MarkupOutput out)
Renders Calendar component.void
renderCancelButton(MarkupOutput out)
Renders the 'cancel' button on the prompt page.void
renderExecuteBar(MarkupOutput out)
Renders Prompt's execution bar.void
renderExecuteButton(MarkupOutput out)
Renders the 'Execute' button on the prompt page.void
renderExecuteButtons(MarkupOutput out)
Renders execution buttons for processing Prompts.void
renderFirstPreviousIncrementalFetch(MarkupOutput out)
Renders the first/previous incremental fetch buttons.void
renderFirstPreviousIncrementalFetch(MarkupOutput out, int blockInit, int iblockCount)
Renders the first/previous incremental fetch buttons.void
renderFormContent(MarkupOutput out)
Renders any mesage before rendering prompts forms and prompt index.void
renderFormEnd(MarkupOutput out)
Renders closing HTMLvoid
renderFormStart(MarkupOutput out)
Renders opening HTMLvoid
renderGenericErrorMessage(MarkupOutput out)
Renders generic error message.void
renderImage(MarkupOutput out, java.lang.String image)
Renders an HTML image tag.void
renderImage(java.lang.String image, MarkupOutput out)
Deprecated.This method cannot be used in a layout-xml.void
renderIncrementalFetch(int blockInit, int iblockCount, MarkupOutput out)
Deprecated.callrenderFirstPreviousIncrementalFetch
andrenderNextLastIncrementalFetch
methods instead.void
renderIncrementalFetchImage(MarkupOutput out, java.lang.String cssClass, java.lang.String name, java.lang.String title)
Renders image for incremental fetch feature.void
renderIndexImage(int index, java.lang.String postFix, PromptObject prompt, MarkupOutput out)
Deprecated.This method cannot be used in a layout-xml and it's not used by the application anymore.void
renderIndexLinkEnd(int index, PromptObject prompt, MarkupOutput out)
Deprecated.usegenerateIndexLink
insteadvoid
renderIndexLinkStart(int index, PromptObject prompt, MarkupOutput out)
Deprecated.usegenerateIndexLink
insteadvoid
renderJavaScriptFooter(MarkupOutput out)
Renders javascript variables at the bottom of the page to be used in DHTML mode.void
renderJavaScriptHeader(MarkupOutput out)
Renders javascript variables on top of the page to be used in DHTML mode.void
renderLabel(MarkupOutput out, int descriptorId, java.lang.String forValue)
Renders HTML label around localized message denoted by given descriptor ID.void
renderLabel(MarkupOutput out, java.lang.String labelName, java.lang.String forValue)
Renders HTML label around given text.void
renderMultiplePromptCssLink(MarkupOutput out)
Renders a css file link corresponding to the file specified on themultiplePromptCssFile
formal parameter.void
renderNextButton(MarkupOutput out)
Renders the 'Next' button on the prompt page.void
renderNextLastIncrementalFetch(MarkupOutput out)
Renders the next/last incremental fetch buttons.void
renderNextLastIncrementalFetch(MarkupOutput out, int blockInit, int iblockCount)
Renders the next/last incremental fetch buttons.void
renderPreviousButton(MarkupOutput out)
Renders the 'Previous' button on the prompt page.void
renderPrompt(MarkupOutput out, int index)
Renders content for a single prompt object denoted by given index.void
renderPrompt(MarkupOutput out, PromptObject prompt)
Renders content for a single prompt object.void
renderPrompt(MarkupOutput out, PromptObject prompt, java.lang.String styleName)
Renders content for a single prompt object by applying given Style.void
renderPrompt(PromptObject prompt, MarkupOutput out)
Deprecated.callrenderPrompt(MarkupOutput, PromptObject)
instead.void
renderPromptAnchor(MarkupOutput out, int index)
Renders an individual prompt anchor using the specified index.void
renderPromptAnchor(MarkupOutput out, PromptObject prompt)
Renders an anchor for each prompt so it is easily accessible from the Summary Section.void
renderPromptIncrementalFetchButtons(MarkupOutput out)
Renders Incremental fetch buttons for paginating Prompts being displayed each one in different page.void
renderPromptIndex(MarkupOutput out, PromptObject prompt)
Renders an individual prompt index.void
renderPromptNumber(MarkupOutput out, int index)
Renders Prompt number based on given index.void
renderPromptNumber(MarkupOutput out, PromptObject prompt)
Renders the prompt number which is displayed along each prompt question.void
renderPromptsContainer(MarkupOutput out)
Deprecated.Function not being used anymore.void
renderPromptsContent(MarkupOutput out)
Renders content for area designated to show all Prompt questions.void
renderPromptsIndex(MarkupOutput out)
Renders Prompt index section.void
renderPromptsNonLayoutContainer(MarkupOutput out)
Renders prompts area that defines out-of-box Prompt's container layout.void
renderPromptsSummary(MarkupOutput out)
Renders Prompt's container in Summary mode.void
renderPromptSummaryButton(MarkupOutput out)
Renders Prompt's 'Back to Prompts' button in Summary mode(if available).void
renderPromptSummaryIndexSection(MarkupOutput out)
Renders 'Prompts summary' toggle area.void
renderRenameMessage(MarkupOutput out)
void
renderRootFolderBrowserHiddenValue(MarkupOutput out)
Renders hidden input values for all hierarchical prompts specifying a folder Id.void
renderSaveButton(MarkupOutput out)
Renders the Save button (if available).void
renderTitleImage(int index, java.lang.String postFix, PromptObject prompt, MarkupOutput out)
Deprecated.This method cannot be used in a layout-xml and it's not used by the application anymore.void
renderWarnigHeaderMessage(MarkupOutput out)
Deprecated.userenderWarningHeaderMessage
instead.void
renderWarningHeaderMessage(MarkupOutput out)
Renders any warning mesage before rendering prompts forms and prompt index.protected void
setIncrementalFetchPrompts(int index, int blockInit, int blockEnd, int current, PromptObject prompt)
Specifies incremental fetch properties.boolean
shouldDisplayRenameMessage()
boolean
showPromptSummary()
Determines whether or not the Prompt Summary header should be visible.void
transformForRequestSuccessful(MarkupOutput out)
Executes transform onPromptsBean
when the status is "Successful".-
Methods inherited from class com.microstrategy.web.app.transforms.AbstractAppTransform
addContactInfo, addDynamicScriptClass, addDynamicScriptFile, addFormalParameter, checkLevel, checkProcessingButtonsFlag, checkProcessingInfoFlag, checkStatus, displayError, displayError, displayError, emptyCell, excludeStaticTags, generateAnchorForExport, generateHiddenInputsForEvent, generateIFrameTag, getAppContext, getArgumentName, getAttributesShellDiv, getBeanPath, getBoneId, getClientSideHelper, getContainerServices, getContext, getContextMenu, getContextMenuManager, getContextMenuManagerName, getContextMenusDefinition, getCssPrefix, getDateFormat, getDebugOut, getDescriptor, getDescriptor, getDescriptor, getDescriptor, getDisplayMode, getDisplayName, getErrorMessage, getErrorMessage, getErrorTitle, getErrorTitle, getEventManager, getFirstDayOfWeek, getFloatValue, getHelpPath, getID, getIntValue, getJSNameSpace, getLayoutContext, getLocale, getLocale, getPreferenceValue, getProjectID, getRefreshEvent, getRequestKeys, getResourcesFolder, getScriptClass, getStringValue, getStyleRequestContext, getStyleShellDiv, getTagsFactory, getTimeFormat, getUnitsLabel, getWebBeanErrorInfo, hasSubBlock, initHeightAndWidthFromPreferences, initializeCss, initializeWebComponent, is508, isBlockMode, isContextMenusEnabled, isDhtml, isDialog, isDormant, isFeatureAvailable, isIFrameDisplayMode, isIFrameEnabled, isIFrameRequest, isJobExpired, isModal, isOpen, isPortlet, isTrue, localIsIFrameDisplayMode, newContext, newHiddenInputBuilder, newNamespaceEncoder, newURIBuilder, redirectToDisplayError, renderBean, renderBean, renderBean, renderBean, renderContextMenus, renderCssLink, renderDescriptor, renderDescriptor, renderErrorButton, renderHiddenInputFromRequest, renderLayout, renderProcessingButton, renderProcessingButton, renderProcessingButton, renderProcessingButtonForGet, renderProcessingButtonForGet, renderProcessingButtons, renderProcessingInfo, renderProcessingInfoData, renderProcessingInfoImage, renderProcessingInfoSubtitle, renderProcessingInfoTitle, renderProcessingObjectName, renderRefreshButton, renderRegisterBone, renderSelf, renderShell, renderSubBlock, renderUserHelpAnchor, setBoneProperties, setDisplayMode, setHasSubBlock, setHeight, setIFrameDisplayMode, setIsDormant, setRenderSubBlock, setShellAttributeOnClosedComponent, setWidth, shouldDisplay, transform, transformForRequestCanceled, transformForRequestInError, transformForRequestNotInited, transformForRequestProcessing, transformForRequestWaitingForUserInput
-
Methods inherited from class com.microstrategy.web.transform.AbstractLayoutTransform
getLayoutDefinition, setLayoutDefinition, transformUsingLayout
-
Methods inherited from class com.microstrategy.web.transform.AbstractTransform
addFormalParam, canTransform, getEvents, getFormalParams, getPreview, isPreviewAvailable, isResolved, removeFormalParam, setAnnotation, setDeprecated, supports, supports
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface com.microstrategy.web.transform.LayoutTransform
getLayoutDefinition, setLayoutDefinition
-
Methods inherited from interface com.microstrategy.web.transform.Transform
canTransform, getFormalParams, getID, getPreview, isPreviewAvailable, isResolved, supports, supports, transform
-
-
-
-
Field Detail
-
_pb
protected PromptsBean _pb
Current Prompt bean.
-
_totalPrompts
protected int _totalPrompts
Indicates total of prompts defined in give prompted report.
-
STYLE_NAME_PROPERTY
protected static final java.lang.String STYLE_NAME_PROPERTY
Denotes constant for getting prompt's style name.- See Also:
- Constant Field Values
-
DEFAULT_STYLE
protected static final java.lang.String DEFAULT_STYLE
Denotes constant for getting prompt's default style name.- See Also:
- Constant Field Values
-
isDhtmlMode
protected boolean isDhtmlMode
Returns true if using DHTML. This values is initialized based on thegetPromptsBean().getOutputFormat()
method.
-
formID
public FormalParameter formID
Specifies the name and Id of the HTML form tag in report page.
All prompts are part of one HTML form, which is submitted as request in order to be processed. This form has a unique name and id for indentifying it when prompt answers are processed. This value is also referenced from the Javascript files
This flag is used as text value.
-
upperCornerImage
public FormalParameter upperCornerImage
Deprecated.The Image for the upper corner of the frame for multi-prompted reports.
As of version 8.0, these formal parameters are not directly used by the application. They are still referenced by therenderPromptsContainer(MarkupOutput)
method
-
_upperCornerImage
protected java.lang.String _upperCornerImage
-
lowerCornerImage
public FormalParameter lowerCornerImage
Deprecated.The image for the lower corner of the frame for multi-prompted reports.
As of version 8.0, these formal parameters are not directly used by the application. They are still referenced by therenderPromptsContainer(MarkupOutput)
method
-
_lowerCornerImage
protected java.lang.String _lowerCornerImage
-
indexListPostfixImage
public FormalParameter indexListPostfixImage
Deprecated.This formal parameter is not used anymore. Images can be changed using the cssThe name of each image on the Prompt's index must be its position and this postfix, i.e. 1 + "_white.gif".
-
indexContentPostfixImage
public FormalParameter indexContentPostfixImage
Deprecated.This formal parameter is not used anymore. Images can be changed using the cssThe name of each image on the Prompt's content must be its position and this postfix, i.e. 1 + "_white.gif".
-
previousIncFecthImage
public FormalParameter previousIncFecthImage
Deprecated.This formal parameter is not used anymore. Images can be changed using the cssThe name of the image for the previous block in incremental fetching.
-
nextIncFecthImage
public FormalParameter nextIncFecthImage
Deprecated.This formal parameter is not used anymore. Images can be changed using the cssThe name of the image for the next block in incremental fetching.
-
firstIncFecthImage
public FormalParameter firstIncFecthImage
Deprecated.This formal parameter is not used anymore. Images can be changed using the cssThe name of the image for the first block in incremental fetching.
-
lastIncFecthImage
public FormalParameter lastIncFecthImage
Deprecated.This formal parameter is not used anymore. Images can be changed using the cssThe name of the image for the last block in incremental fetching.
-
summaryImage
public FormalParameter summaryImage
Deprecated.This formal parameter is not used anymore. Images can be changed using the cssThe name of the image for displaying the summary item.
-
displayMode
public FormalParameter displayMode
Specifies how multiple prompts will be displayed in report layout.
This only applies when there are multiple prompts defined in given report. Prompts can be shown all or, one by one.
This flag is used as int value.
Allowed Values:
- MODE_ALL = 1
- MODE_ONE_BY_ONE = 2
-
MODE_ALL
public static final int MODE_ALL
Indicates that all prompts should be displayed in one page.- See Also:
- Constant Field Values
-
MODE_ONE_BY_ONE
public static final int MODE_ONE_BY_ONE
Indicates that one prompt per page should be displayed.- See Also:
- Constant Field Values
-
levelFlag
public FormalParameter levelFlag
Specifies what prompt region is displayed in report layout.
In order to allow prompt customization, report layout is broken into 6 displayable prompt regions: Execute buttons, prompt index, prompt summary, prompt question, prompt position and generic error.
This flag is used as bit-wise value.
Allowed Values:
- LEVEL_SHOW_EXECUTE_BUTTONS = 0x001
- LEVEL_SHOW_PROMPT_INDEX = 0x002
- LEVEL_SHOW_PROMPT_SUMMARY = 0x004
- LEVEL_SHOW_PROMPT_QUESTIONS = 0x008
- LEVEL_SHOW_PROMPT_POSITION = 0x010
- LEVEL_SHOW_GENERIC_ERROR = 0x020
- LEVEL_SHOW_EXECUTE_BUTTONS_TOP = 0x040
- LEVEL_SHOW_EXECUTE_BUTTONS_BOTTOM = 0x080
- LEVEL_SHOW_SAVE_BUTTON = 0x100
- LEVEL_SHOW_WARNING_HEADER_MSSG = 0x200
- LEVEL_SHOW_ALL = 0xfff
Default value is denoted by: EnumPromptLevelFlags.LEVEL_SHOW_ALL & ~ EnumPromptLevelFlags.LEVEL_SHOW_SAVE_BUTTON & ~ EnumPromptLevelFlags.LEVEL_SHOW_WARNING_HEADER_MSSG which indicates to display everything but 'Save' button and 'Warning Header Message' area.
For complete list, refer toEnumPromptLevelFlags
-
promptQuestionLevelFlag
public FormalParameter promptQuestionLevelFlag
Specifies what sections are displayed in prompt question layout.
In order to allow prompt customization, prompt question layout is broken into 4 displayable sections: Prompt title, prompt meaning, restriction, prompt content, prompt error and default answer. This value is propagated to corresponding prompt transform(s), meaning that will affect all prompts in a given report.
This flag is used as bit-wise value.
Allowed Values:
- LEVEL_SHOW_TITLE = 0x001
- LEVEL_SHOW_MEANING = 0x002
- LEVEL_SHOW_RESTRICTION = 0x004
- LEVEL_SHOW_CONTENT = 0x008
- LEVEL_SHOW_ERROR = 0x010
- LEVEL_SHOW_DEFAULT_ANSWER = 0x020
- LEVEL_SHOW_TITLE_BACKTOTOP = 0x040
For complete list, refer toEnumPromptLevelFlags
-
showRequired
public FormalParameter showRequired
Specifies whether or not to show required message in prompt question title.
Per default, all prompts defined as required, display a "Required" message at the end of the prompt title. This flag will overrule this layout requirement by not displaying this message even though prompt is required. This value is propagated to corresponding prompt transform(s), meaning that will affect all prompts in a given report.
This flag is used as boolean value.
-
showRequiredFirst
public FormalParameter showRequiredFirst
Deprecated.because preferences are read from Preferences object itself, and FP isn't necessary.Specifies whether prompts defined as required will be rendered first or not.
Applies only when prompts are displayed in one page. Prompts can be sorted by priority. Important: This FP is directly associated to a Project preference; this means that it can't be modified in StyleCatalog because it's a Transform property.
This flag is used as boolean value.
-
showMatchCase
public FormalParameter showMatchCase
Deprecated.since preference value can be read by accessing getPreferenceValue() methodSpecifies whether a match case checkbox is displayed at the end of a given search form within prompt question.
Not all prompt types support searching for elements or objects, so it could be ignored. A match case checkbox is normally displayed next to this search section. This value is propagated to corresponding prompt transform(s), meaning that will affect all prompts in a given report.
This flag is used as boolean value.
-
blockCount
public FormalParameter blockCount
Specifies the number of prompts are displayed per block in report page.
Only applies when there are multiple prompts defined in given report and when display mode is set to display all prompts in one page. It indicates the number of prompts per block being displayed in page.
This flag is used as int value.
-
incrementalAttrElemBlockCount
public FormalParameter incrementalAttrElemBlockCount
Specifies the maximum number of attribute elements to be displayed in available list when incremental fetch is available.
Only applies in Element prompts. Prompt styles, such as list and radio button, are governed by this flag, even though they don't provide any incremental fetch functionality. This value is ignored by other prompt types and it gets by a Web preference end-user can edit. This value is propagated to corresponding prompt transform(s), meaning that will affect all prompts in a given report.
This flag is used as int value.
For more detailed information, please refer to Web preferences documentation. See Project defaults/General section, at Incremental fetch preference: "Maximum number of report objects per block".
-
incrementalObjectsBlockCount
public FormalParameter incrementalObjectsBlockCount
Specifies the maximum number of objects (attributes, attribute forms and metrics) to be displayed in available list when incremental fetch is available.
Only applies in Object and Expression prompts. Prompt styles, such as list and radio button, are governed by this flag, even though they don't provide any incremental fetch functionality. This value is ignored by other prompt types and it gets set by a Web preference end-user can edit. This value is propagated to corresponding prompt transform(s), meaning that will affect all prompts in a given report.
This flag is used as int value.
For more detailed information, please refer to Web preferences documentation. See Project defaults/General section, at Incremental fetch preference: "Maximum number of attributes per block".
-
exportReportLabel
public FormalParameter exportReportLabel
Deprecated.Instead, executeButtonLabel will be used.Specifies the ID of the descriptor to use on the button for continue with report processing.
Default value is for displaying 'Execute Report'.
This flag is used as string value.
-
exportDocumentLabel
public FormalParameter exportDocumentLabel
Deprecated.Instead, executeButtonLabel will be used.Specifies the ID of the descriptor to use on the button for continue with document processing.
Default value is for displaying 'Execute Document'.
This flag is used as string value.
-
executeButtonLabel
public FormalParameter executeButtonLabel
Specifies the ID of the descriptor to use on the button for continue with document processing. The id should be a valid ID in the Resources Bundle.
The default value is empty, in which case the Transform will use a predetermined value (which might be different between reports and documents). The string value for the formal parameter takes the formmstrWeb.3649
- Since:
- MicroStrategy Web 8.0.0
-
showExecuteAtTop
protected FormalParameter showExecuteAtTop
Specifies whether or not to show an 'Execute' button at the top of the list of Prompts.
This flag is used as int value. Possible values are defined in EnumPromptLevelFlags enumeration.
Allowed Values:
- LEVEL_DISPLAY_ELEMENT_YES = 1
- LEVEL_DISPLAY_ELEMENT_NO = 2
- LEVEL_DISPLAY_ELEMENT_USE_DEFAULT = 3
- Since:
- MicroStrategy Web 7.5.0
-
showExecuteAtBottom
protected FormalParameter showExecuteAtBottom
Specifies whether or not to show an 'Execute' button at the bottom of the list of Prompts.
This flag is used as int value. Possible values are defined in EnumPromptLevelFlags enumeration.
Allowed Values:
- LEVEL_DISPLAY_ELEMENT_YES = 1
- LEVEL_DISPLAY_ELEMENT_NO = 2
- LEVEL_DISPLAY_ELEMENT_USE_DEFAULT = 3
- Since:
- MicroStrategy Web 7.5.0
-
multiplePromptCssFile
public FormalParameter multiplePromptCssFile
Specifies the css file to use if it's multiple prompt information that requires to be rendered.
This css file will be used together with the one indicated on thecssFile
formal parameter.- Since:
- MicroStrategy Web 8.0.0
-
renderForm
public FormalParameter renderForm
Indicates wheteher the transform will render its own form- Since:
- MicroStrategy Web 8.0.0
-
_1ptransImage
protected java.lang.String _1ptransImage
Constant indicating source path to a transparent image.
-
_imagesFolder
protected java.lang.String _imagesFolder
Constant indicating source path to a Folder image.
-
_firstPrompt
protected PromptObject _firstPrompt
Reference to first prompt in collection.
-
_lastPrompt
protected PromptObject _lastPrompt
Reference to last prompt in collection.
-
_nextBlockPrompt
protected PromptObject _nextBlockPrompt
Reference to next prompt in block.
Instance used in Incremental fetch when prompts are displayed each one in different page.
-
_previousBlockPrompt
protected PromptObject _previousBlockPrompt
Reference to previous prompt in block.
Instance used in Incremental fetch when prompts are displayed each one in different page.
-
_nextPrompt
protected PromptObject _nextPrompt
Reference to next prompt in collection of prompts.
-
_previousPrompt
protected PromptObject _previousPrompt
Reference to previous prompt in collection of prompts.
-
PROMPT_LOADED_ARG
protected static final java.lang.String PROMPT_LOADED_ARG
Constant denoting argument for prompt loaded first time.- Since:
- MicroStrategy Web 7.5.4
- See Also:
- Constant Field Values
-
canCancelPrompt
public FormalParameter canCancelPrompt
Indicates whether the cancel prompt button is displayed- Since:
- MicroStrategy Web 8.1.0
-
-
Method Detail
-
getDescription
public java.lang.String getDescription()
Returns description for this Transform.- Specified by:
getDescription
in interfaceTransform
- Returns:
- "This is the Transform that renders Prompts in the Application."
-
getPromptsBean
protected PromptsBean getPromptsBean()
Returns instance ofPromptsBean
to be transformed.- Returns:
PromptsBean
instance.
-
renderMultiplePromptCssLink
public void renderMultiplePromptCssLink(MarkupOutput out)
Renders a css file link corresponding to the file specified on themultiplePromptCssFile
formal parameter.
If applicable (multiple prompt being rendered), these CSS links will be generated.- Parameters:
out
-MarkupOutput
instance where to write the output of the method.- Since:
- MicroStrategy Web 8.0.0
-
isForDefinition
protected boolean isForDefinition()
- Since:
- MicroStrategy Web 9.0.0
-
transformForRequestSuccessful
public void transformForRequestSuccessful(MarkupOutput out)
Executes transform onPromptsBean
when the status is "Successful".- Specified by:
transformForRequestSuccessful
in classAbstractAppTransform
- Parameters:
out
-MarkupOutput
instance where to write the output of the method.- See Also:
AbstractAppTransform.checkStatus(com.microstrategy.web.beans.MarkupOutput)
-
renderPromptsNonLayoutContainer
public void renderPromptsNonLayoutContainer(MarkupOutput out) throws java.lang.IllegalArgumentException, UnmodifiableException
Renders prompts area that defines out-of-box Prompt's container layout.
This function gets executed when not XML layout is defined for given Prompt container.- Parameters:
out
-MarkupOutput
where to write the output- Throws:
java.lang.IllegalArgumentException
UnmodifiableException
- Since:
- MicroStrategy Web 8.0.1
-
getTotalOpenPrompts
protected int getTotalOpenPrompts()
Initializes property indicating total number of Open prompts in PromptsBean.- Since:
- MicroStrategy Web 8.0.1
-
processPromptedMetricAdded
protected void processPromptedMetricAdded(MarkupOutput out) throws java.lang.IllegalStateException, java.lang.IllegalArgumentException
Process action from Report where user added a prompted metric to Filter.
Event is generated within Executed report. Most likely, end-user added a metric associated with a prompt. This required to execute given prompt.- Parameters:
out
- MarkupOutput where to write output- Throws:
java.lang.IllegalStateException
- if anyjava.lang.IllegalArgumentException
- if any.- Since:
- MicroStrategy Web 8.0.1
-
renderGenericErrorMessage
public void renderGenericErrorMessage(MarkupOutput out)
Renders generic error message.
It'll display localized message 'Error in prompts'.- Parameters:
out
- MarkupOutput where to write the message.- Since:
- MicroStrategy Web 8.0.0
-
isBottomExecuteButtonViewable
public boolean isBottomExecuteButtonViewable()
Determines whether or not, top bottom buttons bar is viewable or not.
Reads formal parameter "showExecuteAtBottom' that indicates to display this bar which has higher precedence over Level flag.
This formal parameter might take following values:
Allowed Values:
- LEVEL_DISPLAY_ELEMENT_YES = Indicates that manually display this bar.
- LEVEL_DISPLAY_ELEMENT_NO = Indicates not to display the bar.
- LEVEL_DISPLAY_ELEMENT_USE_DEFAULT = Indicates to determine whether or not to display bar based on default value.
- Returns:
- true if viewable.
- Since:
- MicroStrategy Web 8.0.0
-
isTopExecuteButtonViewable
public boolean isTopExecuteButtonViewable()
Determines whether or not, top execution buttons bar is viewable or not.
Reads formal parameter "showExecuteAtTop' that indicates to display this bar which will be displayed only if there are more than 1 prompt displayed in page and Prompt summary isn't displayed either. This FP has higher precedence over Level flag.
This formal parameter might take following values:
Allowed Values:
- LEVEL_DISPLAY_ELEMENT_YES = Indicates that manually display this bar.
- LEVEL_DISPLAY_ELEMENT_NO = Indicates not to display the bar.
- LEVEL_DISPLAY_ELEMENT_USE_DEFAULT = Indicates to determine whether or not to display bar based on default value.
- Returns:
- true if viewable.
- Since:
- MicroStrategy Web 8.0.0
-
showPromptSummary
public boolean showPromptSummary()
Determines whether or not the Prompt Summary header should be visible.
Reads from thelevelFlag
formal parameter to determine if it should be shown or not when Prompt page is in 'Summary' mode (seeisPromptSummaryViewable()
method's description.- Returns:
- true if it is specified in Level flag as to be displayed.
- Since:
- MicroStrategy Web 8.0.0
-
isPromptSummaryViewable
public boolean isPromptSummaryViewable()
Indicates whether or not the Prompt container is Summary mode.
Prompt summary page is rendered if user has requested it. This transform has a request property which indicates what mode Prompt container should be rendered like, either 'Summary' or 'Questions'.- Returns:
- true if current prompt page is 'Summary' mode.
- Since:
- MicroStrategy Web 8.0.0
-
isPromptIndexViewable
public boolean isPromptIndexViewable()
Deprecated.Use isMultiplePrompt() method instead.Indicates whether or not prompt Index is viewable.
Only condition to enble prompt Index is to have multiple prompts in current page.- Returns:
- true if vieweable.
- Since:
- MicroStrategy Web 8.0.0
-
isMultiplePrompt
public boolean isMultiplePrompt()
Indicates whether or not given report is consisted of more than one prompt.- Returns:
- true when collection of prompts exceeds more than one.
- Since:
- MicroStrategy Web 8.0.0
-
renderPromptsIndex
public void renderPromptsIndex(MarkupOutput out)
Renders Prompt index section.
It parses Prompt's collection and for each prompt in it, an HTML formatted index is generated. FunctionrenderPromptIndex(MarkupOutput, PromptObject)
is invoked. Also, At the end of this section, an Incremental fetch section gets rendered as well by callingrenderNextLastIncrementalFetch(MarkupOutput)
.- Parameters:
out
- MarkupOutput instance where to write the output of the method.
-
isPromptIndexAvailable
public boolean isPromptIndexAvailable()
Indicates whether or not 'Prompt index' section can be rendered.
Uses Level flag to determine if this section is to be rendered.- Returns:
- boolean true whether the prompt index section is viewable.
- Since:
- MicroStrategy Web 8.0.0
-
renderPromptIndex
public void renderPromptIndex(MarkupOutput out, PromptObject prompt)
Renders an individual prompt index.
It generates an HTML anchor formatted with CSS classes.- Parameters:
out
- MarkupOutput where to write prompt index.prompt
- PromptObject index will point to this instance in Prompt's page.- Since:
- MicroStrategy Web 8.0.0
-
setIncrementalFetchPrompts
protected void setIncrementalFetchPrompts(int index, int blockInit, int blockEnd, int current, PromptObject prompt)
Specifies incremental fetch properties.
Initializes transform's properties for first, next and last prompts.- Parameters:
index
- prompt positionblockInit
- starting point in incremental fetchblockEnd
- ending point in incremental fetchcurrent
- current prompt indexprompt
- prompt object instance
-
renderPromptsContainer
public void renderPromptsContainer(MarkupOutput out)
Deprecated.Function not being used anymore. Instead,transformForRequestSuccessful(MarkupOutput)
is invoked.Renders prompts area that defines main Prompt's container layout.- Parameters:
out
-MarkupOutput
where to write the output- Since:
- MicroStrategy Web 7.5.1
-
renderPromptsContent
public void renderPromptsContent(MarkupOutput out)
Renders content for area designated to show all Prompt questions.
It will iterate prompt list and will render each one of them by callingrenderPrompt(MarkupOutput, PromptObject)
method.- Parameters:
out
-MarkupOutput
instance where to write Prompt questions.
-
isDhtmlMode
public boolean isDhtmlMode()
Determines whether or not DHTML mode is on.- Returns:
- boolean true if DHTML is on.
- Since:
- MicroStrategy Web 8.0.0
-
getCurrentIndex
protected int getCurrentIndex()
Determines current prompt index.
It takes current prompt object and by parsing collection of prompts, it determines corresponding index.- Returns:
- int index
- Since:
- MicroStrategy Web 7.5.4
-
getBlockInit
protected int getBlockInit()
Determines block initial index.
If prompts are displayed in one page and prompts collection doesn't exceed block count, then 0 is returned.- Returns:
- int current init index for given block.
- Since:
- MicroStrategy Web 8.0.0
-
getBlockEnd
protected int getBlockEnd()
Indicates block ending index.
If prompts are displayed in one page and prompts collection doesn't exceed block count, then size of block is returned.- Returns:
- int ending index.
- Since:
- MicroStrategy Web 8.0.0
-
getPromptsListForIndexSection
public java.util.ArrayList getPromptsListForIndexSection()
Returns list of prompts determined by block count settings.- Returns:
- ArrayList collection of prompts.
- Since:
- MicroStrategy Web 8.0.0
-
getPromptsList
public java.util.ArrayList getPromptsList()
Returns current list of prompts.- Returns:
- an
ArrayList
instance with all the different prompts that should be rendered. Layout files use this funtion to loop through a collection of prompts. - Since:
- MicroStrategy Web 8.0.0
-
renderPromptNumber
public void renderPromptNumber(MarkupOutput out, PromptObject prompt)
Renders the prompt number which is displayed along each prompt question.- Parameters:
out
-MarkupOutput
where the contents to render will be rendered.prompt
-PromptObject
current prompt being rendered.- Since:
- MicroStrategy Web 8.0.0
-
renderPromptNumber
public void renderPromptNumber(MarkupOutput out, int index)
Renders Prompt number based on given index.- Parameters:
out
-MarkupOutput
where the contents to be rendered.index
- integer with the index of the prompt being displayed.- Since:
- MicroStrategy Web 8.0.0
-
renderPromptAnchor
public void renderPromptAnchor(MarkupOutput out, PromptObject prompt)
Renders an anchor for each prompt so it is easily accessible from the Summary Section.- Parameters:
out
-MarkupOutput
where the contents to be rendered.prompt
-PromptObject
current prompt being rendered.- Since:
- MicroStrategy Web 8.0.0
-
renderPromptAnchor
public void renderPromptAnchor(MarkupOutput out, int index)
Renders an individual prompt anchor using the specified index.- Parameters:
out
-MarkupOutput
where the contents to be rendered.index
- integer with the index of the prompt being displayed.- Since:
- MicroStrategy Web 8.0.0
-
isPromptQuestionsAvailable
public boolean isPromptQuestionsAvailable()
Indicates whether or not prompt questions are enabled.
It checkes level flag to see ifEnumPromptLevelFlags.LEVEL_SHOW_PROMPT_QUESTIONS
is enabled.- Returns:
- whether the prompt question section is accessible
- Since:
- MicroStrategy Web 8.0.0
-
renderCalendar
public void renderCalendar(MarkupOutput out)
Renders Calendar component.
It only generates minimal HTML and JS code necessary for toggling Calendar component in current Prompt's page.- Parameters:
out
-MarkupOutput
where the contents to be rendered.- Since:
- MicroStrategy Web 8.0.0
-
displayPromptOneByOne
public boolean displayPromptOneByOne()
Indicates whether or not to display prompts one by one.- Returns:
- true when only one prompt is to be displayed in a page.
- Since:
- MicroStrategy Web 8.0.0
-
getPromptsListOneByOne
public java.util.ArrayList getPromptsListOneByOne()
Returns list of prompts sorted by 'one by one' mode.- Returns:
- the elements to be displayed when the "Each on a separate page"
preference is selected.
- Since:
- MicroStrategy Web 8.0.0
-
renderPromptsSummary
public void renderPromptsSummary(MarkupOutput out)
Renders Prompt's container in Summary mode.
All prompt answers are summarize in this method. No prompt question gets rendered.- Parameters:
out
-MarkupOutput
where the contents to render will be rendered.
-
getPromptsListForSummary
public java.util.ArrayList getPromptsListForSummary()
Returns list of prompts to be displayed in Summary mode.- Returns:
- an
ArrayList
instance initialized with the prompt information to use for the summary display. - Since:
- MicroStrategy Web 8.0.0
-
renderWarnigHeaderMessage
public void renderWarnigHeaderMessage(MarkupOutput out)
Deprecated.userenderWarningHeaderMessage
instead.Renders any warning mesage before rendering prompts forms and prompt index.
This warning message is- Parameters:
out
-MarkupOutput
where the contents to render will be saved
-
renderWarningHeaderMessage
public void renderWarningHeaderMessage(MarkupOutput out)
Renders any warning mesage before rendering prompts forms and prompt index.
This warning message is available in current prompt definition.- Parameters:
out
-MarkupOutput
where the contents to render will be saved- Since:
- MicroStrategy Web 8.0.0
-
renderFormContent
public void renderFormContent(MarkupOutput out)
Renders any mesage before rendering prompts forms and prompt index.- Parameters:
out
-MarkupOutput
where the contents to render will be saved- Since:
- MicroStrategy Web 8.0.0
-
renderPrompt
public void renderPrompt(MarkupOutput out, PromptObject prompt)
Renders content for a single prompt object.
Wrapper method which invokes method renderPrompt that takes an extra parameter denoting styleName. It passes 'null' value for this parameter which forces renderPrompt method to use prompt's designated style.- Parameters:
out
-MarkupOutput
where the contents to render will be savedprompt
- thePromptObject
instance of the prompt information to display- Since:
- MicroStrategy Web 8.0.0
-
renderPrompt
public void renderPrompt(MarkupOutput out, PromptObject prompt, java.lang.String styleName)
Renders content for a single prompt object by applying given Style.
Based on the xsl name, this method gets a TransformInstance from the style catalog and calls the transform method of that transform. The Transform returned by the style catalog should be an instance of WebPromptTransform. If styleName is empty or null, then prompt's default style (defined in StyleCatalog.xml) gets used.- Parameters:
out
-MarkupOutput
where the contents to render will be savedprompt
-PromptObject
instance for the prompt to displaystyleName
- the name of the style to be used for a particular prompt- Since:
- MicroStrategy Web 8.0.0
-
getPromptTransformByStyle
protected Transform getPromptTransformByStyle(java.lang.String style) throws java.lang.IllegalArgumentException, WebTransformException
Indicates corresponding prompt question transform associated to given style name.
It will return prompt transform defined in StyleCatalog.- Parameters:
style
- String- Returns:
- Transform null if not found in styleCatalog.xml
- Throws:
java.lang.IllegalArgumentException
WebTransformException
- Since:
- MicroStrategy Web 8.0.1
-
initializePromptQuestionProperties
protected void initializePromptQuestionProperties(int promptPosition, Transform promptTransform)
Initializes given prompt transform properties before transform given prompt object.
All generic properties that Container needs to inform to each prompt object are specified in this function.- Parameters:
promptPosition
-promptTransform
- Transform- Since:
- MicroStrategy Web 8.0.1
-
renderPrompt
public void renderPrompt(MarkupOutput out, int index)
Renders content for a single prompt object denoted by given index.
It parses prompts collection and if an instance of PromptObject is defined at given index, then methodrenderPrompt(MarkupOutput, PromptObject)
is invoked.- Parameters:
out
-MarkupOutput
where the contents to render will be savedindex
- integer number indicating which prompt should be displayed.- Since:
- MicroStrategy Web 8.0.0
-
renderPrompt
public void renderPrompt(PromptObject prompt, MarkupOutput out)
Deprecated.callrenderPrompt(MarkupOutput, PromptObject)
instead.Renders an individual prompt.- Parameters:
out
-MarkupOutput
where the contents to render will be savedprompt
-PromptObject
instance to render
-
getDecimalSeparator
protected java.lang.String getDecimalSeparator()
Indicates current decimal separator for active Locale.- Returns:
- String decimal separator.
- Since:
- MicroStrategy Web 7.5.4
-
renderExecuteBar
public void renderExecuteBar(MarkupOutput out)
Renders Prompt's execution bar.
This function will be responsible of rendering if neccessary, those prompt navigation buttons.
These navigations buttons are consisted of the following:- 'Back to Prompt' - displayed only when summary mode is displayed.
- 'Previous' - Displayed only when prompts are displayed in separate pages and there are more than 1 prompt defined.
- 'Next' - Displayed only when prompts are displayed in separate pages and there are more than 1 prompt defined.
renderExecuteButtons(MarkupOutput)
. This function will render remaining buttons that complement this execution bar.- Parameters:
out
-MarkupOutput
where to write the output of the method.
-
renderPromptIncrementalFetchButtons
public void renderPromptIncrementalFetchButtons(MarkupOutput out)
Renders Incremental fetch buttons for paginating Prompts being displayed each one in different page.- Parameters:
out
- MarkupOutput where to write the output of the method.- Since:
- MicroStrategy Web 8.0.1
-
renderExecuteButtons
public void renderExecuteButtons(MarkupOutput out)
Renders execution buttons for processing Prompts.
This buttons are different to those for navigation in terms of functionality. Pretty much, these buttons are used for executing and canceling prompts. Buttons displayed are for 'Execute Report' or 'Execute Document', 'Save' and 'Cancel'.- Parameters:
out
- MarkupOutput where to write the output of the method.
-
canDisplaySaveButton
public boolean canDisplaySaveButton()
Indicates whether or not 'Save' button can be displayed.
Level flag is checked in order to determine this condition.- Returns:
- boolean true if it is displayed.
- Since:
- MicroStrategy Web 8.0.1
-
canSavePrompt
protected boolean canSavePrompt()
Indicates whether or not end-user is enabled to save given Prompted Report.
Useful to determine whether or not to displaye 'Save' button in Prompt page.- Returns:
- true if user has proper permissions.
- Since:
- MicroStrategy Web 8.0.0
-
canCancelPrompt
protected boolean canCancelPrompt()
Deprecated.The isRWDatasetAdded formal parameter has been removed so this method is no longer called.Indicates whether or not given prompted report can be cancelled.
A prompted report can be cancelled by end-user if re-prompt is enabled or it isn't a dataset being added to a RW document.- Returns:
- true if cancelling prompted report is enabled.
- Since:
- MicroStrategy Web 8.0.0
-
renderPromptSummaryIndexSection
public void renderPromptSummaryIndexSection(MarkupOutput out)
Renders 'Prompts summary' toggle area.
Generates display output that denotes an HTML anchor and label to allow end-users to toggle between 'Summary' and 'Questions' prompt's page mode.- Parameters:
out
- where to write the output of the method.
-
renderIncrementalFetch
public void renderIncrementalFetch(int blockInit, int iblockCount, MarkupOutput out)
Deprecated.callrenderFirstPreviousIncrementalFetch
andrenderNextLastIncrementalFetch
methods instead.Renders incremental fetch section.
Incremental section where First, Previous, Next and Last incremental fetch buttons are organized. It invokes corresponding render methods.- Parameters:
blockInit
- starting point in incremental fetchiblockCount
- page sizeout
- where to write the output of the method.
-
renderIncrementalFetchImage
public void renderIncrementalFetchImage(MarkupOutput out, java.lang.String cssClass, java.lang.String name, java.lang.String title)
Renders image for incremental fetch feature.
It is specified CSS, argument name and title.- Parameters:
out
- MarkupOutput where to write image.cssClass
- String CSS class associated to image.name
- String unique id for image.title
- String Label to be displayed along with image.- Since:
- MicroStrategy Web 8.0.0
-
renderFirstPreviousIncrementalFetch
public void renderFirstPreviousIncrementalFetch(MarkupOutput out)
Renders the first/previous incremental fetch buttons.
It determines values for blockEnd and blockInit which are passed as parameters when invoking methodrenderFirstPreviousIncrementalFetch(MarkupOutput, int, int)
. These values are calculated by this transform.- Parameters:
out
-MarkupOutput
instance where to write the output of the method.- Since:
- MicroStrategy Web 8.0.0
-
renderFirstPreviousIncrementalFetch
public void renderFirstPreviousIncrementalFetch(MarkupOutput out, int blockInit, int iblockCount)
Renders the first/previous incremental fetch buttons.- Parameters:
out
-MarkupOutput
instance where to write the output of the method.blockInit
- int value pointing to initial index of current block.iblockCount
- int size of current block.- Since:
- MicroStrategy Web 8.0.0
-
renderNextLastIncrementalFetch
public void renderNextLastIncrementalFetch(MarkupOutput out)
Renders the next/last incremental fetch buttons.
It determines values for blockEnd and blockInit which are passed as parameters when invoking methodrenderNextLastIncrementalFetch(MarkupOutput, int, int)
. These values are calculated by this transform.- Parameters:
out
-MarkupOutput
instance where to write the output of the method.- Since:
- MicroStrategy Web 8.0.0
-
renderNextLastIncrementalFetch
public void renderNextLastIncrementalFetch(MarkupOutput out, int blockInit, int iblockCount)
Renders the next/last incremental fetch buttons.- Parameters:
out
-MarkupOutput
instance where to write the output of the method.blockInit
- next indexiblockCount
- last index- Since:
- MicroStrategy Web 8.0.0
-
renderJavaScriptHeader
public void renderJavaScriptHeader(MarkupOutput out)
Renders javascript variables on top of the page to be used in DHTML mode.- Parameters:
out
- where to write the output of the method.
-
renderJavaScriptFooter
public void renderJavaScriptFooter(MarkupOutput out)
Renders javascript variables at the bottom of the page to be used in DHTML mode.- Parameters:
out
- where to write the output of the method.
-
getAnchorPinFromRequest
protected java.lang.String getAnchorPinFromRequest()
Indicates prompt position based on GUI action.
There are actions specific to GUI and not to Prompt's events such as switching from 'Qualify' to 'Select' in Hierarchical prompts. For such cases, prompt position remains the last one which couldn't be the prompt being edited.
This function will get prompt position being edited from request by looking up any of the GUI specific actions.- Returns:
- String prompt position.
- Since:
- MicroStrategy Web 7.5.4
-
renderFormStart
public void renderFormStart(MarkupOutput out)
Renders opening HTML- Parameters:
out
- where to write the output of the method.
-
isMultipartRequestEnabled
protected boolean isMultipartRequestEnabled()
Indicates whether or not to enable Multipart request as encode type content.- Returns:
- boolean true if there's a prompt whose style requires uploading functionality.
- Since:
- MicroStrategy Web 7.5.0
-
renderFormEnd
public void renderFormEnd(MarkupOutput out)
Renders closing HTML- Parameters:
out
- where to write the output of the method.
-
renderRootFolderBrowserHiddenValue
public void renderRootFolderBrowserHiddenValue(MarkupOutput out)
Renders hidden input values for all hierarchical prompts specifying a folder Id.- Parameters:
out
- MarkupOutput where to write output.- Since:
- MicroStrategy Web 7.5.1
-
generateIndexLink
public AnchorTag generateIndexLink(PromptObject prompt)
Creates aAnchorTag
object (URL link) for invoking JS 'BuildUserSelections' method.- Parameters:
prompt
- PromptObject prompt object being parsed.- Returns:
- AnchorTag instance.
- Since:
- MicroStrategy Web 8.0.0
-
renderIndexLinkStart
public void renderIndexLinkStart(int index, PromptObject prompt, MarkupOutput out)
Deprecated.usegenerateIndexLink
insteadRenders an opening HTML tag for an anchor pointing to given Prompt.- Parameters:
out
- where to write the output of the method.prompt
- the Prompt object to render the link ofindex
- the index associated with the prompt
-
renderIndexImage
public void renderIndexImage(int index, java.lang.String postFix, PromptObject prompt, MarkupOutput out)
Deprecated.This method cannot be used in a layout-xml and it's not used by the application anymore. It will be removed in future versions of the product.Renders an HTML image TAG for the Prompts Index.- Parameters:
out
- MarkupOutput where to write the output of the method.prompt
- PromptObject the Prompt object to render the link ofindex
- int the index associated with the prompt, this is the index used to render the image.postFix
- String text indicating extra arguments.
-
renderTitleImage
public void renderTitleImage(int index, java.lang.String postFix, PromptObject prompt, MarkupOutput out)
Deprecated.This method cannot be used in a layout-xml and it's not used by the application anymore. It will be removed in future versions of the product.Renders an HTML image TAG for the Prompts Index.- Parameters:
out
- where to write the output of the method.prompt
- the Prompt object to render the link ofindex
- the index associated with the prompt, this is the index used to render the image.postFix
- String indicating extra arguments.
-
renderIndexLinkEnd
public void renderIndexLinkEnd(int index, PromptObject prompt, MarkupOutput out)
Deprecated.usegenerateIndexLink
insteadRenders a closing HTML tag for an anchor pointing to given Prompt.
Render the start of the A tag (Link) for the Prompts Index.- Parameters:
out
- where to write the output of the method.prompt
- the Prompt object to render the link ofindex
- the index associated with the prompt
-
renderLabel
public void renderLabel(MarkupOutput out, int descriptorId, java.lang.String forValue)
Renders HTML label around localized message denoted by given descriptor ID.- Parameters:
out
-MarkupOutput
instance where to write the output of the method.descriptorId
- int descriptor idforValue
- String HTML attribute indicating which HTML object is associated to.- Since:
- MicroStrategy Web 8.0.0
-
renderLabel
public void renderLabel(MarkupOutput out, java.lang.String labelName, java.lang.String forValue)
Renders HTML label around given text.- Parameters:
out
-MarkupOutput
instance where to write the output of the method.labelName
- String label text.forValue
- String HTML attribute indicating which HTML object is associated to.- Since:
- MicroStrategy Web 8.0.0
-
getStyleName
protected java.lang.String getStyleName(PromptObject prompt)
Determines style name associated to given prompt object.
It searchs for a prompt's displayProperty calledSTYLE_NAME_PROPERTY
. This property corresponds to the name of the xsl set in Microstrategy Desktop. If found the name of the file (without the extension) is returned.
If not found, it calls getDefaultStyleName and return the Default style name.- Parameters:
prompt
- the prompt to transform- Returns:
- the name of the style to use to transform the Prompt
-
getDefaultStyleName
protected java.lang.String getDefaultStyleName(PromptObject prompt)
Return the DefaultStyle names to use to render a prompt. This correspond to the same default values used in Microstrategy 7i.- Parameters:
prompt
- the prompt for which to get it's style- Returns:
- the default style for the propmt depending on it's prompt type
-
renderImage
public void renderImage(java.lang.String image, MarkupOutput out)
Deprecated.This method cannot be used in a layout-xml. Instead, userenderImage(MarkupOutput out, String image)
Renders an HTML image tag.- Parameters:
out
- where to write the output of the method.image
- the image soruce name.
-
renderImage
public void renderImage(MarkupOutput out, java.lang.String image)
Renders an HTML image tag.- Overrides:
renderImage
in classAbstractAppTransform
- Parameters:
out
- where to write the output of the method.image
- the image soruce name.- Since:
- MicroStrategy Web 8.0.1
-
promptsLoadedFirstTime
protected boolean promptsLoadedFirstTime()
Indicates whether or not, prompts are loaded for the first time. It looks for any 'prompt' hidden value in request indicating there was a prompt request to be processed. This means, user has started editing any prompt in report.- Returns:
- boolean true if there's no prompt request values.
- Since:
- MicroStrategy Web 7.5.3
-
getPromptDisplayPosition
protected int getPromptDisplayPosition(PromptObject prompt)
Indicates prompt's display position.
The display position is different from the PromptPosition. This function properly calculates this value.- Parameters:
prompt
- Prompt object instance- Returns:
- current prompt position
-
initializeTransform
public void initializeTransform(Transformable data)
Initializes transform formal parameters.- Specified by:
initializeTransform
in interfaceAppTransform
- Overrides:
initializeTransform
in classAbstractAppTransform
- Parameters:
data
-Transformable
object to be transformed.
-
isReprompted
public boolean isReprompted()
Retrieves the value 'isReprompted' from the WebResultSetInstance This allows us to read the reprompt propery from an SDK object rather than passing a property in the request.- Returns:
- boolean
- Since:
- MicroStrategy Web 8.0.1
-
initializeImages
public void initializeImages()
Initializes images to be used by this transform.
Parent method gets invoked so all shared images get initialized as well.- Overrides:
initializeImages
in classAbstractAppTransform
-
getNavigationArgument
protected java.lang.String getNavigationArgument(int position)
Returns argument name for indicating prompt's navigation.
When showing prompts one by one, the name of the argument to navigate through prompts is special, it's always the name of the argument _ the position you want- Parameters:
position
- the position you want to travel to- Returns:
- arg_position
-
getPromptsAppContext
protected AppContext getPromptsAppContext()
Returns instance of AppContext.
AppContext instance is derived from existing Prompt's bean context.- Returns:
- instance of AppContext
-
getAnswerEvent
protected WebEvent getAnswerEvent()
Returns Prompt's answer event.- Returns:
- WebEvent instance for Answer
-
getCancelEvent
protected WebEvent getCancelEvent()
Returns Prompt's cancel event.
This event will be determined based on parent Bean type. Cancel event will be obtained from either a DocumentBean or RWBean or ReportBean instance.
Cancel event will be either one for canceling Re-prompting or regular Prompted execution.- Overrides:
getCancelEvent
in classAbstractAppTransform
- Returns:
- WebEvent for cancel event.
-
getIsDatasetAddedArgumentName
protected java.lang.String getIsDatasetAddedArgumentName()
Indicates Argument name for specifying whether or not 'Adding Dataset' functionality was executed.- Returns:
- String argument found in request.
- Since:
- MicroStrategy Web 8.0.0
-
getRePromptArgumentName
protected java.lang.String getRePromptArgumentName()
Returns the argument name for reprompt action.- Returns:
- String argument name for reprompt
- Since:
- MicroStrategy Web 7.5.2
-
getSupportedBeanType
public java.lang.Class getSupportedBeanType()
Returns bean type class.- Specified by:
getSupportedBeanType
in interfaceTransform
- Overrides:
getSupportedBeanType
in classAbstractAppTransform
- Returns:
- Class current transform instance
-
checkLevel
protected boolean checkLevel(int iLevelConst)
Indicates if the level parameter value contains this flag.- Parameters:
iLevelConst
- level flag- Returns:
- true means the level flag is included in the level parameter value
-
isTreeRequest
protected boolean isTreeRequest()
Indicates if the request is an action performed in the hierarchical tree prompt.- Returns:
- true if request is an action performed in the hierarchical tree prompt.
- Since:
- MicroStrategy Web 7.5.0
-
isAddDatasetInRequest
protected boolean isAddDatasetInRequest()
Indicates if in the request is an 'Add dataset' request.
Likely, this prompt was induced by adding a prompted dataset in a running RW document.- Returns:
- true if request is an action performed in the hierarchical tree prompt.
- Since:
- MicroStrategy Web 8.0.0
-
getSaveEvent
protected WebEvent getSaveEvent()
Returns an event for saving prompted report or RWD or HTML document.- Returns:
- WebEvent where to write the output of the method.
- Since:
- MicroStrategy Web 7.5.1
-
getExecuteButtonLabel
public java.lang.String getExecuteButtonLabel()
Specifies label to be displayed in 'Execute' button.
By default there are two possible labels: 'Run Report' or 'Run Document', based on the PromptsBean parent bean type.
However, the label to use can be controlled through theexecuteButtonLabel
formal parameter. If a value has been specified, this method will return the corresponding string from the Resources-Bundle.- Returns:
- String localized message.
- Since:
- MicroStrategy Web 7.5.1
-
generateAnchor
protected AnchorTag generateAnchor(WebEvent event)
Generates anAnchorTag
from given event instance.
Overwrites the parent method by setting special attributes if the event is not provided- Overrides:
generateAnchor
in classAbstractAppTransform
- Parameters:
event
-WebEvent
instance from where the anchor will be constructed- Returns:
AnchorTag
initialized instance with the information as provided- Since:
- MicroStrategy Web 8.0.0
-
isExecuteSectionAvailable
public boolean isExecuteSectionAvailable()
Indicates whether or not 'Execute' section is viewable.
Checks the level flags to find out whether or not the execute buttons should be displayed.- Returns:
- boolean true if viewable.
- Since:
- MicroStrategy Web 8.0.0
-
renderPromptSummaryButton
public void renderPromptSummaryButton(MarkupOutput out)
Renders Prompt's 'Back to Prompts' button in Summary mode(if available).- Parameters:
out
- MarkupOutput where to write output.- Since:
- MicroStrategy Web 8.0.0
-
isOneByOneDisplayMode
public boolean isOneByOneDisplayMode()
Indicates whether or not prompts should be rendered on the same page.- Returns:
- boolean true indicating all prompts are to be rendered in same page.
- Since:
- MicroStrategy Web 8.0.0
-
getCurrentPromptDisplayPosition
protected int getCurrentPromptDisplayPosition()
Returns current prompt's display position.- Returns:
- int current prompt's position.
- Since:
- MicroStrategy Web 8.0.0
-
renderPreviousButton
public void renderPreviousButton(MarkupOutput out)
Renders the 'Previous' button on the prompt page.
Available only when 'one prompt per page' is rendered.- Parameters:
out
- MarkupOutput where to write output.- Since:
- MicroStrategy Web 8.0.0
-
renderNextButton
public void renderNextButton(MarkupOutput out)
Renders the 'Next' button on the prompt page.
Available only when 'one prompt per page' is rendered.- Parameters:
out
- MarkupOutput where to write output.- Since:
- MicroStrategy Web 8.0.0
-
renderExecuteButton
public void renderExecuteButton(MarkupOutput out)
Renders the 'Execute' button on the prompt page.- Parameters:
out
- MarkupOutput where to write output.- Since:
- MicroStrategy Web 8.0.0
-
renderSaveButton
public void renderSaveButton(MarkupOutput out)
Renders the Save button (if available).- Parameters:
out
- MarkupOutput where to write output.- Since:
- MicroStrategy Web 8.0.0
-
getSaveButtonLabel
public java.lang.String getSaveButtonLabel()
- Since:
- MicroStrategy Web 9.0.0
-
renderCancelButton
public void renderCancelButton(MarkupOutput out)
Renders the 'cancel' button on the prompt page.- Overrides:
renderCancelButton
in classAbstractAppTransform
- Parameters:
out
- MarkupOutput where to write output.- Since:
- MicroStrategy Web 8.0.0
-
isItemKeptInCartAvailable
public boolean isItemKeptInCartAvailable()
Indicates property value for whether or not selected item in cart's 'From' list should be removed.
Value is read from Preference object.- Returns:
- boolean, true if item is to be removed.
- Since:
- MicroStrategy Web 8.0.1
-
isMatchCaseShown
public boolean isMatchCaseShown()
Indicates property value for whether or not match case should be shown.
Value is read from Preference object.- Returns:
- boolean, true if match case is to be shown.
- Since:
- MicroStrategy Web 8.0.1
-
areRequiredPromptsShownFirst
protected boolean areRequiredPromptsShownFirst()
Initializes property indicating whether or not Required prompts are displayed first.
Value is read from Preference object.- Since:
- MicroStrategy Web 8.0.1
-
shouldDisplayRenameMessage
public boolean shouldDisplayRenameMessage()
- Since:
- MicroStrategy Web 9.0.0
-
renderRenameMessage
public void renderRenameMessage(MarkupOutput out)
- Since:
- MicroStrategy Web 9.0.0
-
getRenameMessageLabel
protected java.lang.String getRenameMessageLabel()
- Since:
- MicroStrategy Web 9.0.0
-
-