Class AbstractReportTransform

    • Field Detail

      • cssUseFileContent

        protected FormalParameter cssUseFileContent
        This is the flag used in the transform to specify whether to show a link to the CSS file or the whole CSS file content.
        Allowed Values: TRUE/FALSE.
      • useBuiltInFormatPara

        protected FormalParameter useBuiltInFormatPara
        This is the flag used in the transform to specify whether to use the formatting info from the report definition.
        Out of box, we map the first preference in Grid preferences section to this formal parameter.
        If it's TRUE, WebCSSHelper.getCSS() will give the css class definitions, which is from report formatting defintion.
        If it's FALSE, a specified css file will give the css class definitions, which is what formal paramter cssFile means.
        Allowed Values: TRUE/FALSE.
      • iFramePara

        protected FormalParameter iFramePara
        This is the flag used to indicate wheter the transform will use iframes.
        Allowed Values: TRUE/FALSE.
      • imgError

        protected FormalParameter imgError
        This is the Image to display when there bean is in Error status.
        Allowed Values: The value to indicate should be a valid image file name, with any necessary path information not included already on the resourcesFolderImage application configuration parameter.
      • cssErrorTitle

        protected FormalParameter cssErrorTitle
        Deprecated.
        There are no references to this formal parameter anymore
        This is the css name for the error title.
        Allowed Values: String value representing a css class name. It should be defined in a css file included in the page.
      • cssErrorMessage

        protected FormalParameter cssErrorMessage
        Deprecated.
        There are no references to this formal parameter in the application
        This is the css name for the error message.
        Allowed Values: String value representing a css class name. It should be defined in a css file included in the page.
      • showScroller

        protected FormalParameter showScroller
        Indicates if the transform will render navigation scrollers along with the graph image.
        Allowed Values: TRUE/FALSE
        Since:
        MicroStrategy Web 9.0.0
      • generateJSForDrillCheckBoxesForIncFetch

        protected FormalParameter generateJSForDrillCheckBoxesForIncFetch
        This is the flag which will decide if we need to generate the javascript code required to preserve check boxes for drilling in incremental fetch.
        Allowed Values: TRUE/FALSE.
        Since:
        MicroStrategy Web 9.0.0
      • BLANK_XDA_REPORT_ID

        protected static final java.lang.String BLANK_XDA_REPORT_ID
        See Also:
        Constant Field Values
      • BLANK_SUBSET_REPORT_ID

        protected static final java.lang.String BLANK_SUBSET_REPORT_ID
        See Also:
        Constant Field Values
    • Constructor Detail

      • AbstractReportTransform

        public AbstractReportTransform()
        default no-args constructor.
    • Method Detail

      • initializeTransform

        public void initializeTransform​(Transformable data)
        This method initialize the private and protected fields of the transform. After calling the initializeTransform on super, it calls initializeProperties if the XMLStatus of the reportBean is WebBeanRequestSuccessful
        Specified by:
        initializeTransform in interface AppTransform
        Overrides:
        initializeTransform in class AbstractAppTransform
        Parameters:
        data - the bean to transform.
      • renderContinueFormForRequestInError

        protected void renderContinueFormForRequestInError​(Tag container,
                                                           int errorCode)
        Render the continue form when the status is In Error
      • generateErrorForIframe

        public void generateErrorForIframe​(MarkupOutput out,
                                           int errorCode,
                                           java.lang.String message)
        Method that generates the error contents when they have to be rendered to the user with an IFrame component. (This will render a hidden DIV for the IFRAME)
        Parameters:
        out - MarkupOutput instance where to save the HTML output of this method
        errorCode - identifier of the error to be rendered
        message - String with the message to display by default
      • generateErrorForIframe

        public void generateErrorForIframe​(MarkupOutput out,
                                           java.lang.String title,
                                           java.lang.String message,
                                           java.lang.String errorInfo,
                                           java.lang.String contactInfo,
                                           Tag extra)
        Method that generates the error contents when they have to be rendered to the user with an IFrame component. (This will render a hidden DIV for the IFRAME)
        Overrides:
        generateErrorForIframe in class AbstractWebBeanTransform
        Parameters:
        out - MarkupOutput instance where to save the HTML output of this method
        title - String with the title of the error message
        message - String with the content of the message
        errorInfo - String with details of the error
        contactInfo - String with the contact information
        extra - Tag instance with any other extra content to render to the user as part of the message.
        Since:
        MicroStrategy Web 8.0.0
      • renderErrorInfo

        public void renderErrorInfo​(MarkupOutput out,
                                    int errorCode,
                                    java.lang.String message)
        Deprecated.
        This method is no longer used by the Transform, all the logic is now in the transformForRequestInError
        Render the message to display to the user in case there is an error.
        Parameters:
        out - the transform's output
        errorCode - the error's id
        message - the error's message
      • renderErrorButtons

        public void renderErrorButtons​(MarkupOutput out,
                                       int errorCode,
                                       java.lang.String message)
        Deprecated.
        This method is no longer used by the Transform, all the logic is now in the transformForRequestInError
        Renders a "continue" or "re-execute" buttons for the user to continue working.
        Parameters:
        out - the transform's output
        errorCode - the error's id
        message - the error's message
      • generateAnchor

        protected AnchorTag generateAnchor​(WebEvent event)
        Overwrites the parent method by setting special attributes if the event is not provided
        Overrides:
        generateAnchor in class AbstractAppTransform
        Parameters:
        event - WebEvent
        Returns:
        AnchorTag
        Since:
        MicroStrategy Web 8.0.0
      • getJobExpiredMessage

        public java.lang.String getJobExpiredMessage()
        Returns the job expired message
        Overrides:
        getJobExpiredMessage in class AbstractWebBeanTransform
        Returns:
        the job expired message.
        Since:
        MicroStrategy Web 8.0.1
      • getContinueEvent

        protected WebEvent getContinueEvent()
        Returns a WebEvent instance corresponding to the continue event
        Returns:
        a WebEvent instance to continue browsing if an error happened.
        Since:
        MicroStrategy Web 8.0.0
      • getRepromptEvent

        protected WebEvent getRepromptEvent()
        Returns a WebEvent instance corresponding to the reprompt event
        Returns:
        a WebEvent instance to reprompt the report if an error happened.
        Since:
        MicroStrategy Web 9.0.0
      • getErrorTitle

        public java.lang.String getErrorTitle​(int errorCode)
        Returns the error title for the transform, overwrites by returning title specific about report execution.
        Overrides:
        getErrorTitle in class AbstractAppTransform
        Parameters:
        errorCode - the error's id
        Returns:
        The title for the error message.
      • getErrorMessage

        public java.lang.String getErrorMessage​(int errorCode,
                                                java.lang.String defaultMessage)
        Returns the error message for the transform, based on the exception.
        Overwrites by returning either the original message, or if none was provided, an "Error in report results".
        Overrides:
        getErrorMessage in class AbstractAppTransform
        Parameters:
        errorCode - the error's id
        defaultMessage - the error's default message
        Returns:
        The error message to render to the user
      • renderProcessingInfoDetails

        protected void renderProcessingInfoDetails​(MarkupOutput out)
        Called by renderProcessingInfo(com.microstrategy.web.beans.MarkupOutput), it renders the detailed information about the report that is being processed, including name, status and description.
        Parameters:
        out - MarkupOutput instance where the HTML contents will be saved.
        Since:
        MicroStrategy Web 8.0.2
      • getHistoryListEvent

        protected WebEvent getHistoryListEvent()
        Returns a WebEvent instance corresponding to the go to history list event
        Returns:
        WebEvent instance initialized with the information for going to the History List (Inbox)
        Since:
        MicroStrategy Web 8.0.0
      • getViewDetailsEvent

        protected WebEvent getViewDetailsEvent()
        Returns:
        WebEvent instance initialized with the information for viewing the details of the report.
        Since:
        MicroStrategy Web 8.0.0
      • getReportStatus

        public java.lang.String getReportStatus​(int status)
        get the report's status as a string representation.
        Parameters:
        status - the status as an integer
        Returns:
        the status string
      • getReportStatusDescriptorKey

        public static int getReportStatusDescriptorKey​(int status)
        get the descriptor key for the report status.
        Parameters:
        status - the status as an integer
        Returns:
        the descriptor key as in integer
      • generateIncFetchAnchor

        protected AnchorTag generateIncFetchAnchor​(WebEvent event,
                                                   boolean generateJSForDrillCheckBoxesForIncFetch)
        generate the anchor the the incremental fetch in report page.
        Parameters:
        event - the WebEvent object
        generateJSForDrillCheckBoxesForIncFetch - whether the javascript code is generated
        Returns:
        an AnchorTag instance initialized with the information for requesting an incremental fetch manipulation.
        Since:
        MicroStrategy Web 8.0.0
      • generateIncFetchOpenAnchor

        protected void generateIncFetchOpenAnchor​(MarkupOutput mo,
                                                  WebEvent event,
                                                  boolean generateJSForDrillCheckBoxesForIncFetch)
        Deprecated.
        Please use generateIncFetchAnchor(WebEvent event, boolean generateJSForDrillCheckBoxesForIncFetch) instead
        generate the open anchor the the incremental fetch in report page.
        Parameters:
        mo - the MarkupOutput object
        event - the WebEvent object
        generateJSForDrillCheckBoxesForIncFetch - whether the javascript code is generated
      • getReportBean

        protected ReportBean getReportBean()
        return the current report bean.
        Returns:
        the current report bean
      • getInboxSource

        protected WebInboxSource getInboxSource()
        return the WebInboxSource of this session.
        Returns:
        the WebInboxSource of this session.
      • initializeProperties

        public void initializeProperties()
        Initialize the Transform's properties based on Formal Parameters, Bean status, features, etc..
        This method is only invoked when the Bean is ready to display (i.e., it's XMLStatus is succesfull).
      • isIFrameEnabled

        protected boolean isIFrameEnabled()
        whether iframe feature is enabled.
        Overrides:
        isIFrameEnabled in class AbstractAppTransform
        Returns:
        whether iframe feature is enabled
      • renderImage

        public void renderImage​(MarkupOutput out,
                                java.lang.String image)
        Renders a transform's image. Extends by including images of this transform.
        Overrides:
        renderImage in class AbstractAppTransform
        Parameters:
        out - where to write the output of the method.
        image - the image name
      • useBuiltInFormat

        protected boolean useBuiltInFormat()
        Check whether the formal parameter "useBuiltInFormatPara" is true or false.
        If it's true, the transform uses built-in format of the report;
        If it's false, the transform uses some css file specified in another formal parameter "cssFile".
        Returns:
        the boolean value of the formal parameter
      • getReexecuteButtonDescription

        public java.lang.String getReexecuteButtonDescription()
        Returns the description of the reexecute button
        Overrides:
        getReexecuteButtonDescription in class AbstractWebBeanTransform
        Returns:
        the description of the reexecute button
        Since:
        MicroStrategy Web 8.0.1
      • isDesignMode

        protected boolean isDesignMode()
        This methods allows the transform to identify if concrete subclasses are designed to work in design mode, or in execute mode.
        Returns:
        false by default. Any inherting class should override to implement its own version.
        Since:
        MicroStrategy Web 9.0.0
      • renderColumnsIncrementalFetchPrevious

        public void renderColumnsIncrementalFetchPrevious​(MarkupOutput out)
        Generates the arrow for the previous set of columns.
        Parameters:
        out - MarkupOutput to generate the HTML.
        Since:
        MicroStrategy Web 9.0.0
      • renderColumnsIncrementalFetchNext

        public void renderColumnsIncrementalFetchNext​(MarkupOutput out)
        Generates the arrow for the next set of columns.
        Parameters:
        out - MarkupOutput to generate the HTML.
        Since:
        MicroStrategy Web 9.0.0
      • renderColumnsIncrementalFetch

        protected void renderColumnsIncrementalFetch​(MarkupOutput out,
                                                     WebEvent event,
                                                     java.lang.String imgCss)
        Since:
        MicroStrategy Web 9.0.0
      • getNextColumnsEvent

        protected WebEvent getNextColumnsEvent()
        Since:
        MicroStrategy Web 9.0.0
      • getPreviousColumnsEvent

        protected WebEvent getPreviousColumnsEvent()
        Since:
        MicroStrategy Web 9.0.0
      • isNonViewableReport

        public boolean isNonViewableReport()
        Since:
        MicroStrategy Web 9.0.0
      • isDatamart

        public boolean isDatamart()
        Returns true if the report's objectSubType is EnumDSSXMLObjectSubTypes.DssXmlSubTypeReportDatamart
        Since:
        MicroStrategy Web 9.0.0
      • isCubeReport

        public boolean isCubeReport()
        Returns true if the report's objectSubType is EnumDSSXMLObjectSubTypes.DssXmlSubTypeReportCube
        Since:
        MicroStrategy Web 9.0.0
      • isIncRefreshReport

        public boolean isIncRefreshReport()