Class AddressListTransform

    • Field Detail

      • cssHeader

        protected java.lang.String cssHeader
        Deprecated.
        This CSS is no longer required as we use new styles for this purpose rather than nested tables.
        Variable to hold the CSS class for the header cells of the outer table for rendering addresses
      • cssContent

        protected java.lang.String cssContent
        Deprecated.
        This CSS is no longer required as we use new styles for this purpose rather than nested tables.
        Variable to hold the CSS class for the content cells of the outer table for rendering addresses
      • cssFooter

        protected java.lang.String cssFooter
        Deprecated.
        This CSS is no longer required as we use new styles for this purpose rather than nested tables.
        Variable to hold the CSS class for the footer cells of the outer table for rendering addresses
      • cssTableHeader

        protected java.lang.String cssTableHeader
        Variable to hold the CSS class for the headers of the listed addresses
      • cssItem

        protected java.lang.String cssItem
        Variable to hold the CSS class for the each of the individual address items
      • cssSelectedItem

        protected java.lang.String cssSelectedItem
        Variable to hold the CSS class for the individual items of a selected address or for editing or a new address
      • LEVEL_DISPLAY_NAME

        public static final int LEVEL_DISPLAY_NAME
        LEVEL parameter that specifies to include the address display name
        See Also:
        Constant Field Values
      • LEVEL_PHYSICAL_ADDRESS

        public static final int LEVEL_PHYSICAL_ADDRESS
        LEVEL parameter that specifies to include the address physical address
        See Also:
        Constant Field Values
      • LEVEL_DEVICE_NAME

        public static final int LEVEL_DEVICE_NAME
        LEVEL parameter that specifies to include the address device name
        See Also:
        Constant Field Values
      • LEVEL_REMOVE

        public static final int LEVEL_REMOVE
        LEVEL parameter that specifies to include a link to remove the address
        See Also:
        Constant Field Values
      • LEVEL_EDIT

        public static final int LEVEL_EDIT
        LEVEL parameter that specifies to include a link to edit the address.
        See Also:
        Constant Field Values
      • LEVEL_ADD

        public static final int LEVEL_ADD
        LEVEL parameter that specifies to include a link to add new addresses
        See Also:
        Constant Field Values
      • LEVEL_SET_DEFAULT

        public static final int LEVEL_SET_DEFAULT
        LEVEL parameter that specifies to include a link to set any of the addresses as default
        See Also:
        Constant Field Values
      • LEVEL_COLUMN_HEADERS

        public static final int LEVEL_COLUMN_HEADERS
        LEVEL parameter that specifies to include the column headers
        See Also:
        Constant Field Values
      • LEVEL_OUTER_FRAME

        public static final int LEVEL_OUTER_FRAME
        LEVEL parameter that specifies to include the address list within another frame This frame is the one used by other sections in Preferences page.
        See Also:
        Constant Field Values
      • LEVEL_ALL

        public static final int LEVEL_ALL
        LEVEL parameter that includes all LEVEL parameters.
        See Also:
        Constant Field Values
      • FP_IMG_CHECK

        public static final java.lang.String FP_IMG_CHECK
        Constant for the name of the checkImage Formal Parameter.
        See Also:
        checkImage, Constant Field Values
      • FP_IMG_UPPER_LEFT

        public static final java.lang.String FP_IMG_UPPER_LEFT
        Deprecated.
        This image is no longer required, the header of the preferences page is defined with css styles
        Constant for the name of the upperLeftCornerImage Formal Parameter.
        See Also:
        upperLeftCornerImage, Constant Field Values
      • FP_IMG_UPPER_RIGHT

        public static final java.lang.String FP_IMG_UPPER_RIGHT
        Deprecated.
        This image is no longer required, the header of the preferences page is defined with css styles
        Constant for the name of the upperRightCornerImage Formal Parameter.
        See Also:
        upperRightCornerImage, Constant Field Values
      • FP_LEVEL_FLAG

        public static final java.lang.String FP_LEVEL_FLAG
        Constant for the name of the levelFlag Formal Parameter.
        See Also:
        levelFlag, Constant Field Values
      • FP_MAX_ITEMS_COUNT

        public static final java.lang.String FP_MAX_ITEMS_COUNT
        Constant for the name of the maxItemCount Formal Parameter.
        See Also:
        maxItemCount, Constant Field Values
      • FP_CONFIRM_DELETE

        public static final java.lang.String FP_CONFIRM_DELETE
        Constant for the name of the confirmDelete Formal Parameter.
        See Also:
        confirmDelete, Constant Field Values
      • checkImage

        public FormalParameter checkImage
        The name of the image used to indicate the default address.
        When editing an address or when adding a new address we use this image to indicate the default address among the list of addresses.
        Usage:
        "Check.gif"
      • upperLeftCornerImage

        public FormalParameter upperLeftCornerImage
        Deprecated.
        This image is no longer required, the header of the preferences page is defined with css styles
        The name of the image used for rendering the upper left corner of the Address List widget.
      • upperRightCornerImage

        public FormalParameter upperRightCornerImage
        Deprecated.
        This image is no longer required, the header of the preferences page is defined with css styles
        The name of the image used for rendering the upper right corner of the Address List widget.
      • levelFlag

        public FormalParameter levelFlag
        Specifies what information is displayed for each address.
        The information may include address name, device name, edit link, delete link and other information. Multiple fields may be displayed at the same time. Which fields to show is indicated by a bitwise flag.
        Allowed Values:
        • Display Name = 1
        • Physical Address = 2
        • Device Name = 4
        • Delete Link = 16
        • Edit Link = 32
        • Add Link = 64
        • Set Default Address = 128
        • Show column headers = 256
        • Show address list with in the outer preferences frame = 512
        • Show every thing = 65535

        Usage:
        For example, if you want to specify display name and device name only, then you would specify (1 + 4 = 5).
      • _levelFlag

        protected int _levelFlag
        Variable to hold the value of the levelFlag Formal Parameter
        See Also:
        levelFlag
      • maxItemCount

        public FormalParameter maxItemCount
        Indicates how many addresses will be displayed in the address list.
        This value will determine the number of addresses rendered in the address list. Any negative value would display the entire list of addresses.
      • _maxItemCount

        protected int _maxItemCount
        Variable to hold the value of the maxItemCount Formal Parameter
        See Also:
        maxItemCount
      • confirmDelete

        public FormalParameter confirmDelete
        Indicates whether to confirm or not before deleting an address.
        Setting this value to true will render a address deletion confirmation page before deleting the address. If confirming is set to true, we would use the event from the servlet to go to the confirmation page. If not, we will just ask the AddressListBean to remove the address.
    • Constructor Detail

      • AddressListTransform

        public AddressListTransform()
        Default no argument constructor. Initialize formal parameters.
    • Method Detail

      • getDescription

        public java.lang.String getDescription()
        Returns the description of this transform.
        This is used in the style catalog editor.
        Returns:
        The description of this transform.
      • initializeTransform

        public void initializeTransform​(Transformable data)
        This method initialize the private and protected fields of the transform.
        It also invokes the initializeTransform method of the parent. It retrieves the list of addresses from the bean.
        Specified by:
        initializeTransform in interface AppTransform
        Overrides:
        initializeTransform in class AbstractAppTransform
        Parameters:
        data - The bean to transform
      • getAddresses

        protected SimpleList getAddresses()
        Since:
        MicroStrategy Web 9.0.0
      • setAddresses

        protected void setAddresses​(SimpleList addresses)
        Since:
        MicroStrategy Web 9.0.0
      • transformHeader

        protected void transformHeader​(MarkupOutput out)
        Generates the Header of the Address List dialog.
        Parameters:
        out - The transform's output.
      • getTitle

        public java.lang.String getTitle()
        Retrieves the Title for the dialog.
        Returns:
        The Title for the dialog. By default it is the current group, "Email Addresses" in this case.
      • transformFooter

        protected void transformFooter​(MarkupOutput out)
        Generates the Footer of the Address List dialog.
        Parameters:
        out - The transform's output.
      • renderSetDefaultButton

        protected void renderSetDefaultButton​(MarkupOutput out)
        Since:
        MicroStrategy Web 9.0.0
      • isNewAvailable

        protected boolean isNewAvailable()
        Since:
        MicroStrategy Web 9.0.0
      • isEditMode

        protected boolean isEditMode()
        Since:
        MicroStrategy Web 9.0.0
      • renderAddressesTable

        protected void renderAddressesTable​(MarkupOutput out)
        Since:
        MicroStrategy Web 9.0.0
      • canDisplayNewAddressLink

        protected boolean canDisplayNewAddressLink()
        Since:
        MicroStrategy Web 9.0.0
      • transformBody

        protected void transformBody​(MarkupOutput out)
        This is called to generate the main body of the Address List dialog.
        This method calls other methods to render the entire address list and links for edit, delete, add and set default address.
        Parameters:
        out - The transform's output.
      • renderNewLink

        protected void renderNewLink​(MarkupOutput out)
        Since:
        MicroStrategy Web 9.0.0
      • generateAnchor

        protected AnchorTag generateAnchor​(WebEvent event)
        Overwrites parent method by testing if anchor should be enabled for iframe environment
        Overrides:
        generateAnchor in class AbstractAppTransform
        Parameters:
        event - WebEvent
        Returns:
        AnchorTag
        Since:
        MicroStrategy Web 8.0.0
      • renderColgroups

        public void renderColgroups​(MarkupOutput out)
        Renders all column headers for the address list.
        Parameters:
        out - The transform's output.
        Since:
        MicroStrategy Web 9.0.0
      • renderHeaders

        public void renderHeaders​(MarkupOutput out)
        Renders all column headers for the address list.
        Parameters:
        out - The transform's output.
      • renderHeaderContent

        protected void renderHeaderContent​(MarkupOutput out,
                                           int column)
        Since:
        MicroStrategy Web 9.0.0
      • renderEmtpyList

        public void renderEmtpyList​(MarkupOutput out)
        Renders an empty list of addresses.
        It would render the form to create a new address if there are no addresses in the list. This new address is also set as the derfault address.
        Parameters:
        out - The transform's output.
      • renderEmptyAddress

        public void renderEmptyAddress​(MarkupOutput out)
        Renders an empty address when there is addresses available for that delivery mode
        Parameters:
        out -
        Throws:
        WebBeanException
        Since:
        MicroStrategy Web 8.0.1
      • renderList

        public void renderList​(MarkupOutput out,
                               SimpleList list)
        Renders a non-empty list of addresses.
        Parameters:
        out - The transform's output.
        list - The list of addresses to render
      • isAddressInEditMode

        protected boolean isAddressInEditMode​(WebSubscriptionAddress address)
        Since:
        MicroStrategy Web 9.0.0
      • renderAddress

        public void renderAddress​(MarkupOutput out,
                                  WebSubscriptionAddress address,
                                  boolean edit)
        Renders a single address.
        Parameters:
        out - The transform's output.
        address - The address to render
        edit - Indicates whether to show the address in edit mode.
      • renderAddress

        public void renderAddress​(MarkupOutput out,
                                  WebSubscriptionAddress address,
                                  boolean edit,
                                  int bandOn)
        overloaded version - to add banding effect and remove deprecated code Renders a single address.
        Parameters:
        out - The transform's output.
        address - The address to render
        edit - Indicates whether to show the address in edit mode.
        bandOn - flat to indicate where set bandOn effect to this TR 0 - off; 1 - on
        Since:
        MicroStrategy Web 9.0.0
      • renderSetDefaultInfo

        public void renderSetDefaultInfo​(MarkupOutput out,
                                         WebSubscriptionAddress address,
                                         boolean edit)
        Renders the default column of an address.
        In the list mode it would render the radio button and in the edit mode it would render the check box next to the defaul address.
        Parameters:
        out - The transform's output.
        address - the address to render
        edit - indicates whether to show the address in edit mode.
      • renderDisplayNameInfo

        public void renderDisplayNameInfo​(MarkupOutput out,
                                          WebSubscriptionAddress address,
                                          boolean edit)
        Renders the address name column of an address.
        Parameters:
        out - The transform's output.
        address - The address to render
        edit - Indicates whether to show the address in edit mode.
      • renderPhysicalAddressInfo

        public void renderPhysicalAddressInfo​(MarkupOutput out,
                                              WebSubscriptionAddress address,
                                              boolean edit)
        Renders the physical address column of an address.
        Parameters:
        out - The transform's output.
        address - The address to render.
        edit - Indicates whether to show the address in edit mode.
      • renderPhysicalAddressField

        public void renderPhysicalAddressField​(MarkupOutput out,
                                               WebSubscriptionAddress address,
                                               boolean edit)
        Since:
        MicroStrategy Web 9.0.0
      • renderDeviceInfo

        public void renderDeviceInfo​(MarkupOutput out,
                                     WebSubscriptionAddress address,
                                     boolean edit)
        Renders the device column of an address.
        Parameters:
        out - The transform's output.
        address - The address to render.
        edit - Indicates whether to show the address in edit mode.
      • getSelectedDeviceId

        protected java.lang.String getSelectedDeviceId​(WebSubscriptionAddress address)
        Since:
        MicroStrategy Web 9.0.0
      • renderSaveButton

        protected boolean renderSaveButton​(MarkupOutput out)
        Since:
        MicroStrategy Web 9.0.0
      • renderCancelInputButton

        protected boolean renderCancelInputButton​(MarkupOutput out)
        Since:
        MicroStrategy Web 9.0.0
      • addAttributesToLinkAnchor

        protected void addAttributesToLinkAnchor​(Tag anchor)
        Since:
        MicroStrategy Web 9.0.0
      • renderEditInfo

        public void renderEditInfo​(MarkupOutput out,
                                   WebSubscriptionAddress address,
                                   boolean edit)
        Renders the edit/remove column of an address.
        It also renders the save/cancel buttons if editing an address.
        Parameters:
        out - The transform's output.
        address - the address to render.
        edit - Indicates whether to show the address in edit mode.
      • renderImage

        public void renderImage​(MarkupOutput out,
                                java.lang.String image)
        Renders an image in the transform.
        Overrides:
        renderImage in class AbstractAppTransform
        Parameters:
        out - The transform's output.
        image - The image name.
      • renderFormStart

        public void renderFormStart​(MarkupOutput out)
        Renders the FORM start tag.
        Parameters:
        out - The transform's output.
      • renderFormEnd

        public void renderFormEnd​(MarkupOutput out)
        Renders the FORM end tag.
        Parameters:
        out - The transform's output.
      • checkLevel

        public boolean checkLevel​(int column)
        Checks the level flag with the level of a column to decide if we want to render a particular column.
        Parameters:
        column - The ID of the column to use. The level is determined by the levelFlag FormalParameter Possible values are the LEVEL_ fieds, i.e: LEVEL_DISPLAY_NAME
        Returns:
        true If the given level is included in the levelFlag.
      • getEventCancel

        public WebEvent getEventCancel()
        Returns the event to cancel editing or saving an address.
        Returns:
        The EnumServletEvents.WebEventCancel event.
      • getEventSetDefault

        public WebEvent getEventSetDefault()
        Returns the event to change the current default address.
        Returns:
        The EnumAddressListBeanEvents.ADDRESS_LIST_EVENT_CHANGE_DEFAULT event.
      • getEventEdit

        public WebEvent getEventEdit​(WebSubscriptionAddress address)
        Returns the event to edit an existing address.
        Parameters:
        address - The address to edit.
        Returns:
        The EnumAddressListBeanEvents.ADDRESS_LIST_EVENT_INIT_ADDRESS event.
      • getEventAdd

        public WebEvent getEventAdd()
        Returns the event to add a new address.
        Returns:
        The EnumAddressListBeanEvents.ADDRESS_LIST_EVENT_CREATE_NEW_ADDRESS event.
      • getEventRemove

        public WebEvent getEventRemove​(WebSubscriptionAddress address)
        Returns the event to delete an existing address.
        Parameters:
        address - The address to remove.
        Returns:
        The EnumAddressListBeanEvents.ADDRESS_LIST_EVENT_DELETE event.
      • getEventSave

        public WebEvent getEventSave()
        Returns the event to save the address currently being editing
        Returns:
        The EnumAddressListBeanEvents.ADDRESS_LIST_EVENT_SAVE event.
      • getAvailableDevices

        protected SimpleList getAvailableDevices()
        Returns the list of supported devices for email addresses.
        Returns:
        The SimpleList supported devices for email addresses.
        Since:
        MicroStrategy Web 7.5.1
      • getAddressListBean

        protected AddressListBean getAddressListBean()
        Returns the list of supported devices for email addresses.
        Returns:
        The SimpleList supported devices for email addresses.
        Since:
        MicroStrategy Web 7.5.1