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 |
![]() |
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.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
String | DEFAULT_STYLE | Denotes constant for getting prompt's default style name. | |||||||||
int | MODE_ALL | Indicates that all prompts should be displayed in one page. | |||||||||
int | MODE_ONE_BY_ONE | Indicates that one prompt per page should be displayed. | |||||||||
String | PROMPT_LOADED_ARG | Constant denoting argument for prompt loaded first time. | |||||||||
String | STYLE_NAME_PROPERTY | Denotes constant for getting prompt's style name. |
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
protected String | _1ptransImage | Constant indicating source path to a transparent image. | |||||||||
protected PromptObject | _firstPrompt | Reference to first prompt in collection. | |||||||||
protected String | _imagesFolder | Constant indicating source path to a Folder image. | |||||||||
protected PromptObject | _lastPrompt | Reference to last prompt in collection. | |||||||||
protected 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 String | _upperCornerImage | ||||||||||
public FormalParameter | blockCount | Specifies the number of prompts are displayed per block in report page. | |||||||||
public FormalParameter | canCancelPrompt | Indicates whether the cancel prompt button is displayed | |||||||||
public FormalParameter | displayMode | Specifies how multiple prompts will be displayed in report layout. | |||||||||
public FormalParameter | executeButtonLabel | Specifies the ID of the descriptor to use on the button for continue with document processing. | |||||||||
public FormalParameter | exportDocumentLabel | This field is deprecated. Instead, executeButtonLabel will be used. | |||||||||
public FormalParameter | exportReportLabel | This field is deprecated. Instead, executeButtonLabel will be used. | |||||||||
public FormalParameter | firstIncFecthImage | This field is deprecated. This formal parameter is not used anymore. Images can be changed using the css | |||||||||
public FormalParameter | formID | Specifies the name and Id of the HTML form tag in report page. | |||||||||
public FormalParameter | incrementalAttrElemBlockCount | Specifies the maximum number of attribute elements to be displayed in available list when incremental fetch is available. | |||||||||
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. | |||||||||
public FormalParameter | indexContentPostfixImage | This field is deprecated. This formal parameter is not used anymore. Images can be changed using the css | |||||||||
public FormalParameter | indexListPostfixImage | This field is deprecated. This formal parameter is not used anymore. Images can be changed using the css | |||||||||
protected boolean | isDhtmlMode | Returns true if using DHTML. | |||||||||
public FormalParameter | lastIncFecthImage | This field is deprecated. This formal parameter is not used anymore. Images can be changed using the css | |||||||||
public FormalParameter | levelFlag | Specifies what prompt region is displayed in report layout. | |||||||||
public FormalParameter | lowerCornerImage | This field is deprecated. No replacement. | |||||||||
public FormalParameter | multiplePromptCssFile | Specifies the css file to use if it's multiple prompt information that requires to be rendered. | |||||||||
public FormalParameter | nextIncFecthImage | This field is deprecated. This formal parameter is not used anymore. Images can be changed using the css | |||||||||
public FormalParameter | previousIncFecthImage | This field is deprecated. This formal parameter is not used anymore. Images can be changed using the css | |||||||||
public FormalParameter | promptQuestionLevelFlag | Specifies what sections are displayed in prompt question layout. | |||||||||
public FormalParameter | renderForm | Indicates wheteher the transform will render its own form | |||||||||
protected 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. | |||||||||
public FormalParameter | showMatchCase | This field is deprecated. since preference value can be read by accessing getPreferenceValue() method | |||||||||
public FormalParameter | showRequired | Specifies whether or not to show required message in prompt question title. | |||||||||
public FormalParameter | showRequiredFirst | This field is deprecated. because preferences are read from Preferences object itself, and FP isn't necessary. | |||||||||
public FormalParameter | summaryImage | This field is deprecated. This formal parameter is not used anymore. Images can be changed using the css | |||||||||
public FormalParameter | upperCornerImage | This field is deprecated. No replacement. |
[Expand]
Inherited Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
PromptsClassicTransform()
Default no-args constructor.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
boolean |
canDisplaySaveButton()
Indicates whether or not 'Save' button can be displayed.
| ||||||||||
boolean |
displayPromptOneByOne()
Indicates whether or not to display prompts one by one.
| ||||||||||
AnchorTag |
generateIndexLink(PromptObject prompt)
Creates a
AnchorTag object (URL link) for invoking JS 'BuildUserSelections' method. | ||||||||||
String |
getDescription()
Returns description for this Transform.
| ||||||||||
String |
getExecuteButtonLabel()
Specifies label to be displayed in 'Execute' button.
| ||||||||||
ArrayList |
getPromptsList()
Returns current list of prompts.
| ||||||||||
ArrayList |
getPromptsListForIndexSection()
Returns list of prompts determined by block count settings.
| ||||||||||
ArrayList |
getPromptsListForSummary()
Returns list of prompts to be displayed in Summary mode.
| ||||||||||
ArrayList |
getPromptsListOneByOne()
Returns list of prompts sorted by 'one by one' mode.
| ||||||||||
String | getSaveButtonLabel() | ||||||||||
Class |
getSupportedBeanType()
Returns bean type class.
| ||||||||||
void |
initializeImages()
Initializes images to be used by this transform.
| ||||||||||
void |
initializeTransform(Transformable data)
Initializes transform formal parameters.
| ||||||||||
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.
| ||||||||||
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.
| ||||||||||
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()
This method is 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.
| ||||||||||
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 HTML
| ||||||||||
void |
renderFormStart(MarkupOutput out)
Renders opening HTML
| ||||||||||
void |
renderGenericErrorMessage(MarkupOutput out)
Renders generic error message.
| ||||||||||
void |
renderImage(MarkupOutput out, String image)
Renders an HTML image tag.
| ||||||||||
void |
renderImage(String image, MarkupOutput out)
This method is deprecated.
This method cannot be used in a layout-xml.
Instead, use
renderImage(MarkupOutput, String)
| ||||||||||
void |
renderIncrementalFetch(int blockInit, int iblockCount, MarkupOutput out)
This method is deprecated.
call
renderFirstPreviousIncrementalFetch and renderNextLastIncrementalFetch methods
instead.
| ||||||||||
void |
renderIncrementalFetchImage(MarkupOutput out, String cssClass, String name, String title)
Renders image for incremental fetch feature.
| ||||||||||
void |
renderIndexImage(int index, String postFix, PromptObject prompt, MarkupOutput out)
This method is 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.
| ||||||||||
void |
renderIndexLinkEnd(int index, PromptObject prompt, MarkupOutput out)
This method is deprecated.
use
generateIndexLink instead
| ||||||||||
void |
renderIndexLinkStart(int index, PromptObject prompt, MarkupOutput out)
This method is deprecated.
use
generateIndexLink instead
| ||||||||||
void |
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, String forValue)
Renders HTML label around localized message denoted by given descriptor ID.
| ||||||||||
void |
renderLabel(MarkupOutput out, String labelName, String forValue)
Renders HTML label around given text.
| ||||||||||
void |
renderMultiplePromptCssLink(MarkupOutput out)
Renders a css file link corresponding to the file specified on the
multiplePromptCssFile 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(PromptObject prompt, MarkupOutput out)
This method is deprecated.
call
renderPrompt(MarkupOutput, PromptObject) instead.
| ||||||||||
void |
renderPrompt(MarkupOutput out, PromptObject prompt, String styleName)
Renders content for a single prompt object by applying given Style.
| ||||||||||
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 |
renderPromptAnchor(MarkupOutput out, PromptObject prompt)
Renders an anchor for each prompt so it is easily accessible from the Summary Section.
| ||||||||||
void |
renderPromptAnchor(MarkupOutput out, int index)
Renders an individual prompt anchor using the specified index.
| ||||||||||
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, PromptObject prompt)
Renders the prompt number which is displayed along each prompt question.
| ||||||||||
void |
renderPromptNumber(MarkupOutput out, int index)
Renders Prompt number based on given index.
| ||||||||||
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 |
renderPromptsContainer(MarkupOutput out)
This method is deprecated.
Function not being used anymore. Instead,
transformForRequestSuccessful(MarkupOutput) is invoked. | ||||||||||
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 | 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, String postFix, PromptObject prompt, MarkupOutput out)
This method is 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.
| ||||||||||
void |
renderWarnigHeaderMessage(MarkupOutput out)
This method is deprecated.
use
renderWarningHeaderMessage instead.
| ||||||||||
void |
renderWarningHeaderMessage(MarkupOutput out)
Renders any warning mesage before rendering prompts forms and prompt index.
| ||||||||||
boolean | shouldDisplayRenameMessage() | ||||||||||
boolean |
showPromptSummary()
Determines whether or not the Prompt Summary header should be visible.
| ||||||||||
void |
transformForRequestSuccessful(MarkupOutput out)
Executes transform on
PromptsBean when the status is "Successful". |
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
boolean |
areRequiredPromptsShownFirst()
Initializes property indicating whether or not Required prompts are displayed first.
| ||||||||||
boolean |
canCancelPrompt()
This method is deprecated.
The isRWDatasetAdded formal parameter has been removed so this method is no longer called.
| ||||||||||
boolean |
canSavePrompt()
Indicates whether or not end-user is enabled to save given Prompted Report.
| ||||||||||
boolean |
checkLevel(int iLevelConst)
Indicates if the level parameter value contains this flag.
| ||||||||||
AnchorTag |
generateAnchor(WebEvent event)
Generates an
AnchorTag from given event instance. | ||||||||||
String |
getAnchorPinFromRequest()
Indicates prompt position based on GUI action.
| ||||||||||
WebEvent |
getAnswerEvent()
Returns Prompt's answer event.
| ||||||||||
int |
getBlockEnd()
Indicates block ending index.
| ||||||||||
int |
getBlockInit()
Determines block initial index.
| ||||||||||
WebEvent |
getCancelEvent()
Returns Prompt's cancel event.
| ||||||||||
int |
getCurrentIndex()
Determines current prompt index.
| ||||||||||
int |
getCurrentPromptDisplayPosition()
Returns current prompt's display position.
| ||||||||||
String |
getDecimalSeparator()
Indicates current decimal separator for active Locale.
| ||||||||||
String |
getDefaultStyleName(PromptObject prompt)
Return the DefaultStyle names to use to render a prompt.
| ||||||||||
String |
getIsDatasetAddedArgumentName()
Indicates Argument name for specifying whether or not 'Adding Dataset' functionality was executed.
| ||||||||||
String |
getNavigationArgument(int position)
Returns argument name for indicating prompt's navigation.
| ||||||||||
int |
getPromptDisplayPosition(PromptObject prompt)
Indicates prompt's display position.
| ||||||||||
Transform |
getPromptTransformByStyle(String style)
Indicates corresponding prompt question transform associated to given style name.
| ||||||||||
AppContext |
getPromptsAppContext()
Returns instance of AppContext.
| ||||||||||
PromptsBean |
getPromptsBean()
Returns instance of
PromptsBean to be transformed. | ||||||||||
String |
getRePromptArgumentName()
Returns the argument name for reprompt action.
| ||||||||||
String | getRenameMessageLabel() | ||||||||||
WebEvent |
getSaveEvent()
Returns an event for saving prompted report or RWD or HTML document.
| ||||||||||
String |
getStyleName(PromptObject prompt)
Determines style name associated to given prompt object.
| ||||||||||
int |
getTotalOpenPrompts()
Initializes property indicating total number of Open prompts in PromptsBean.
| ||||||||||
void |
initializePromptQuestionProperties(int promptPosition, Transform promptTransform)
Initializes given prompt transform properties before transform given prompt object.
| ||||||||||
boolean |
isAddDatasetInRequest()
Indicates if in the request is an 'Add dataset' request.
| ||||||||||
boolean | isForDefinition() | ||||||||||
boolean |
isMultipartRequestEnabled()
Indicates whether or not to enable Multipart request as encode type content.
| ||||||||||
boolean |
isTreeRequest()
Indicates if the request is an action performed in the hierarchical tree prompt.
| ||||||||||
void |
processPromptedMetricAdded(MarkupOutput out)
Process action from Report where user added a prompted metric to Filter.
| ||||||||||
boolean |
promptsLoadedFirstTime()
Indicates whether or not, prompts are loaded for the first time.
| ||||||||||
void |
setIncrementalFetchPrompts(int index, int blockInit, int blockEnd, int current, PromptObject prompt)
Specifies incremental fetch properties.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() |
Denotes constant for getting prompt's default style name.
Indicates that all prompts should be displayed in one page.
Indicates that one prompt per page should be displayed.
Constant denoting argument for prompt loaded first time.
Denotes constant for getting prompt's style name.
Constant indicating source path to a transparent image.
Constant indicating source path to a Folder image.
Reference to next prompt in block.
Instance used in Incremental fetch when prompts are
displayed each one in different page.
Reference to previous prompt in block.
Instance used in Incremental fetch when prompts are
displayed each one in different page.
Indicates total of prompts defined in give prompted report.
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.
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:
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 form mstrWeb.3649
This field is 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.
This field is 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.
This field is deprecated.
This formal parameter is not used anymore. Images can be changed using the css
The name of the image for the first block in incremental fetching.
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.
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".
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".
This field is deprecated.
This formal parameter is not used anymore. Images can be changed using the css
The name of each image on the Prompt's content must be its position and this postfix, i.e. 1 + "_white.gif".
This field is deprecated.
This formal parameter is not used anymore. Images can be changed using the css
The name of each image on the Prompt's index must be its position and this postfix, i.e. 1 + "_white.gif".
Returns true if using DHTML. This values is initialized based on the
getPromptsBean().getOutputFormat()
method.
This field is deprecated.
This formal parameter is not used anymore. Images can be changed using the css
The name of the image for the last block in incremental fetching.
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:
EnumPromptLevelFlags
This field is deprecated.
No replacement.
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 the renderPromptsContainer(MarkupOutput)
method
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 the cssFile
formal parameter.
This field is deprecated.
This formal parameter is not used anymore. Images can be changed using the css
The name of the image for the next block in incremental fetching.
This field is deprecated.
This formal parameter is not used anymore. Images can be changed using the css
The name of the image for the previous block in incremental fetching.
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:
EnumPromptLevelFlags
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:
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:
This field is deprecated.
since preference value can be read by accessing getPreferenceValue() method
Specifies 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.
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.
This field is 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.
This field is deprecated.
This formal parameter is not used anymore. Images can be changed using the css
The name of the image for displaying the summary item.
This field is deprecated.
No replacement.
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 the renderPromptsContainer(MarkupOutput)
method
Default no-args constructor.
Initialize all Formal Parameters.
Indicates whether or not 'Save' button can be displayed.
Level flag is checked in order to determine this condition.
Indicates whether or not to display prompts one by one.
Creates a AnchorTag
object (URL link) for invoking JS 'BuildUserSelections' method.
prompt | PromptObject prompt object being parsed. |
---|
Returns description for this Transform.
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 the executeButtonLabel
formal parameter. If a value has been specified, this method will return the corresponding
string from the Resources-Bundle.
Returns current list of prompts.
Returns list of prompts determined by block count settings.
Returns list of prompts to be displayed in Summary mode.
Returns list of prompts sorted by 'one by one' mode.
Returns bean type class.
Initializes images to be used by this transform.
Parent method gets invoked so all shared images get initialized as well.
Initializes transform formal parameters.
data | Transformable object to be transformed.
|
---|
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:
Determines whether or not DHTML mode is on.
Indicates whether or not 'Execute' section is viewable.
Checks the level flags to find out whether or not the execute buttons should be displayed.
Indicates property value for whether or not selected item in cart's 'From' list should be removed.
Value is read from Preference object.
Indicates property value for whether or not match case should be shown.
Value is read from Preference object.
Indicates whether or not given report is consisted of more than one prompt.
Indicates whether or not prompts should be rendered on the same page.
Indicates whether or not 'Prompt index' section can be rendered.
Uses Level flag to determine if this section is to be rendered.
This method is 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.
Indicates whether or not prompt questions are enabled.
It checkes level flag to see if LEVEL_SHOW_PROMPT_QUESTIONS
is enabled.
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'.
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.
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:
Renders Calendar component.
It only generates minimal HTML and JS code necessary for toggling
Calendar component in current Prompt's page.
out | MarkupOutput where the contents to be rendered. |
---|
Renders the 'cancel' button on the prompt page.
out | MarkupOutput where to write output. |
---|
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:
renderExecuteButtons(MarkupOutput)
. This function will render remaining buttons that
complement this execution bar. out | MarkupOutput where to write the output of the method.
|
---|
Renders the 'Execute' button on the prompt page.
out | MarkupOutput where to write output. |
---|
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'.
out | MarkupOutput where to write the output of the method. |
---|
Renders the first/previous incremental fetch buttons.
It determines values for blockEnd and blockInit which are passed
as parameters when invoking method renderFirstPreviousIncrementalFetch(MarkupOutput, int, int)
.
These values are calculated by this transform.
out | MarkupOutput instance where to write the output of the method. |
---|
Renders the first/previous incremental fetch buttons.
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. |
Renders any mesage before rendering prompts forms and prompt index.
out | MarkupOutput where the contents to render will be saved |
---|
Renders closing HTML
out | where to write the output of the method. |
---|
Renders opening HTML
out | where to write the output of the method. |
---|
Renders generic error message.
It'll display localized message 'Error in prompts'.
out | MarkupOutput where to write the message. |
---|
Renders an HTML image tag.
out | where to write the output of the method. |
---|---|
image | the image soruce name. |
This method is deprecated.
This method cannot be used in a layout-xml.
Instead, use renderImage(MarkupOutput, String)
Renders an HTML image tag.
image | the image soruce name. |
---|---|
out | where to write the output of the method. |
This method is deprecated.
call renderFirstPreviousIncrementalFetch
and renderNextLastIncrementalFetch
methods
instead.
Renders incremental fetch section.
Incremental section where First, Previous, Next and Last incremental fetch
buttons are organized. It invokes corresponding render methods.
blockInit | starting point in incremental fetch |
---|---|
iblockCount | page size |
out | where to write the output of the method. |
Renders image for incremental fetch feature.
It is specified CSS, argument name and title.
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. |
This method is 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.
index | int the index associated with the prompt, this is the index used to render the image. |
---|---|
postFix | String text indicating extra arguments. |
prompt | PromptObject the Prompt object to render the link of |
out | MarkupOutput where to write the output of the method. |
This method is deprecated.
use generateIndexLink
instead
Renders a closing HTML tag for an anchor pointing to given Prompt.
Render the start of the A tag (Link) for the Prompts Index.
index | the index associated with the prompt |
---|---|
prompt | the Prompt object to render the link of |
out | where to write the output of the method. |
This method is deprecated.
use generateIndexLink
instead
Renders an opening HTML tag for an anchor pointing to given Prompt.
index | the index associated with the prompt |
---|---|
prompt | the Prompt object to render the link of |
out | where to write the output of the method. |
Renders javascript variables at the bottom of the page to be used in DHTML mode.
out | where to write the output of the method. |
---|
Renders javascript variables on top of the page to be used in DHTML mode.
out | where to write the output of the method. |
---|
Renders HTML label around localized message denoted by given descriptor ID.
out | MarkupOutput instance where to write the output of the method. |
---|---|
descriptorId | int descriptor id |
forValue | String HTML attribute indicating which HTML object is associated to. |
Renders HTML label around given text.
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. |
Renders a css file link corresponding to the file specified on the
multiplePromptCssFile
formal parameter.
If applicable (multiple prompt being rendered), these CSS links will be generated.
out | MarkupOutput instance where to write the output of the method. |
---|
Renders the 'Next' button on the prompt page.
Available only when 'one prompt per page' is rendered.
out | MarkupOutput where to write output. |
---|
Renders the next/last incremental fetch buttons.
It determines values for blockEnd and blockInit which are passed
as parameters when invoking method renderNextLastIncrementalFetch(MarkupOutput, int, int)
.
These values are calculated by this transform.
out | MarkupOutput instance where to write the output of the method. |
---|
Renders the next/last incremental fetch buttons.
out | MarkupOutput instance where to write the output of the method. |
---|---|
blockInit | next index |
iblockCount | last index |
Renders the 'Previous' button on the prompt page.
Available only when 'one prompt per page' is rendered.
out | MarkupOutput where to write output. |
---|
This method is deprecated.
call renderPrompt(MarkupOutput, PromptObject)
instead.
Renders an individual prompt.
prompt | PromptObject instance to render |
---|---|
out | MarkupOutput where the contents to render will be saved |
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.
out | MarkupOutput where the contents to render will be saved |
---|---|
prompt | PromptObject instance for the prompt to display |
styleName | the name of the style to be used for a particular prompt |
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 method renderPrompt(MarkupOutput, PromptObject)
is
invoked.
out | MarkupOutput where the contents to render will be saved |
---|---|
index | integer number indicating which prompt should be displayed. |
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.
out | MarkupOutput where the contents to render will be saved |
---|---|
prompt | the PromptObject instance of the prompt information to display |
Renders an anchor for each prompt so it is easily accessible from the Summary Section.
out | MarkupOutput where the contents to be rendered. |
---|---|
prompt | PromptObject current prompt being rendered. |
Renders an individual prompt anchor using the specified index.
out | MarkupOutput where the contents to be rendered. |
---|---|
index | integer with the index of the prompt being displayed. |
Renders Incremental fetch buttons for paginating Prompts being displayed each one in different page.
out | MarkupOutput where to write the output of the method. |
---|
Renders an individual prompt index.
It generates an HTML anchor formatted with CSS classes.
out | MarkupOutput where to write prompt index. |
---|---|
prompt | PromptObject index will point to this instance in Prompt's page. |
Renders the prompt number which is displayed along each prompt question.
out | MarkupOutput where the contents to render will be rendered. |
---|---|
prompt | PromptObject current prompt being rendered. |
Renders Prompt number based on given index.
out | MarkupOutput where the contents to be rendered. |
---|---|
index | integer with the index of the prompt being displayed. |
Renders Prompt's 'Back to Prompts' button in Summary mode(if available).
out | MarkupOutput where to write output. |
---|
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.
out | where to write the output of the method. |
---|
This method is deprecated.
Function not being used anymore. Instead, transformForRequestSuccessful(MarkupOutput)
is invoked.
Renders prompts area that defines main Prompt's container layout.
out | MarkupOutput where to write the output |
---|
Renders content for area designated to show all Prompt questions.
It will iterate prompt list and will render each one of them by calling
renderPrompt(MarkupOutput, PromptObject)
method.
out | MarkupOutput instance where to write Prompt questions.
|
---|
Renders Prompt index section.
It parses Prompt's collection and for each prompt in it, an HTML formatted
index is generated. Function renderPromptIndex(MarkupOutput, PromptObject)
is invoked. Also,
At the end of this section, an Incremental fetch section gets rendered as well
by calling renderNextLastIncrementalFetch(MarkupOutput)
.
out | MarkupOutput instance where to write the output of the method. |
---|
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.
out | MarkupOutput where to write the output |
---|
IllegalArgumentException | |
---|---|
UnmodifiableException |
Renders Prompt's container in Summary mode.
All prompt answers are summarize in this method. No prompt question gets rendered.
out | MarkupOutput where the contents to render will be rendered.
|
---|
Renders hidden input values for all hierarchical prompts specifying a folder Id.
out | MarkupOutput where to write output. |
---|
Renders the Save button (if available).
out | MarkupOutput where to write output. |
---|
This method is 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.
index | the index associated with the prompt, this is the index used to render the image. |
---|---|
postFix | String indicating extra arguments. |
prompt | the Prompt object to render the link of |
out | where to write the output of the method. |
This method is deprecated.
use renderWarningHeaderMessage
instead.
Renders any warning mesage before rendering prompts forms and prompt index.
This warning message is
out | MarkupOutput where the contents to render will be saved |
---|
Renders any warning mesage before rendering prompts forms and prompt index.
This warning message is available in current prompt definition.
out | MarkupOutput where the contents to render will be saved |
---|
Determines whether or not the Prompt Summary header should be visible.
Reads from the levelFlag
formal parameter to determine if it should be shown or not
when Prompt page is in 'Summary' mode (see isPromptSummaryViewable()
method's description.
Executes transform on PromptsBean
when the status is "Successful".
out | MarkupOutput instance where to write the output of the method. |
---|
Initializes property indicating whether or not Required prompts are displayed first.
Value is read from Preference object.
This method is 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.
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.
Indicates if the level parameter value contains this flag.
iLevelConst | level flag |
---|
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 Prompt's answer event.
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.
Determines block initial index.
If prompts are displayed in one page and prompts collection doesn't
exceed block count, then 0 is returned.
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.
Determines current prompt index.
It takes current prompt object and by parsing collection of
prompts, it determines corresponding index.
Returns current prompt's display position.
Indicates current decimal separator for active Locale.
Return the DefaultStyle names to use to render a prompt. This correspond to the same default values used in Microstrategy 7i.
prompt | the prompt for which to get it's style |
---|
Indicates Argument name for specifying whether or not 'Adding Dataset' functionality was executed.
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
position | the position you want to travel to |
---|
Indicates prompt's display position.
The display position is different from the PromptPosition.
This function properly calculates this value.
prompt | Prompt object instance |
---|
Indicates corresponding prompt question transform associated to given style name.
It will return prompt transform defined in StyleCatalog.
style | String |
---|
IllegalArgumentException | |
WebTransformException | |
IllegalArgumentException | |
WebTransformException |
Returns instance of AppContext.
AppContext instance is derived from existing Prompt's bean context.
Returns instance of PromptsBean
to be transformed.
PromptsBean
instance.
Returns the argument name for reprompt action.
Returns an event for saving prompted report or RWD or HTML document.
Determines style name associated to given prompt object.
It searchs for a prompt's displayProperty called STYLE_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.
prompt | the prompt to transform |
---|
Initializes property indicating total number of Open prompts in PromptsBean.
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.
promptTransform | Transform |
---|
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.
Indicates whether or not to enable Multipart request as encode type content.
Indicates if the request is an action performed in the hierarchical tree prompt.
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.
out | MarkupOutput where to write output |
---|
IllegalStateException | if any |
---|---|
IllegalArgumentException | if any. |
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.
Specifies incremental fetch properties.
Initializes transform's properties for first, next and last prompts.
index | prompt position |
---|---|
blockInit | starting point in incremental fetch |
blockEnd | ending point in incremental fetch |
current | current prompt index |
prompt | prompt object instance |