| java.lang.Object | |||||
| ↳ | com.microstrategy.web.transform.AbstractTransform | ||||
| ↳ | com.microstrategy.web.transform.AbstractLayoutTransform | ||||
| ↳ | com.microstrategy.web.app.transforms.AbstractAppTransform | ||||
| ↳ | com.microstrategy.web.app.transforms.AddressTransform | ||||
| ↳ | com.microstrategy.web.app.transforms.AddressListTransform | ||||
Known Direct Subclasses
|
This transform is used to list and edit Narrowcast Addresses. It also allows to add new addresses and set default addresses.
| Constants | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| String | FP_CONFIRM_DELETE | Constant for the name of the confirmDelete Formal Parameter. |
|||||||||
| String | FP_IMG_CHECK | Constant for the name of the checkImage Formal Parameter. |
|||||||||
| String | FP_IMG_UPPER_LEFT | This constant is deprecated. This image is no longer required, the header of the preferences page is defined with css styles | |||||||||
| String | FP_IMG_UPPER_RIGHT | This constant is deprecated. This image is no longer required, the header of the preferences page is defined with css styles | |||||||||
| String | FP_LEVEL_FLAG | Constant for the name of the levelFlag Formal Parameter. |
|||||||||
| String | FP_MAX_ITEMS_COUNT | Constant for the name of the maxItemCount Formal Parameter. |
|||||||||
| int | LEVEL_ADD | LEVEL parameter that specifies to include a link to add new addresses | |||||||||
| int | LEVEL_ALL | LEVEL parameter that includes all LEVEL parameters. | |||||||||
| int | LEVEL_COLUMN_HEADERS | LEVEL parameter that specifies to include the column headers | |||||||||
| int | LEVEL_DEVICE_NAME | LEVEL parameter that specifies to include the address device name | |||||||||
| int | LEVEL_DISPLAY_NAME | LEVEL parameter that specifies to include the address display name | |||||||||
| int | LEVEL_EDIT | LEVEL parameter that specifies to include a link to edit the address. | |||||||||
| 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. | |||||||||
| int | LEVEL_PHYSICAL_ADDRESS | LEVEL parameter that specifies to include the address physical address | |||||||||
| int | LEVEL_REMOVE | LEVEL parameter that specifies to include a link to remove the address | |||||||||
| int | LEVEL_SET_DEFAULT | LEVEL parameter that specifies to include a link to set any of the addresses as default | |||||||||
|
[Expand]
Inherited Constants | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
com.microstrategy.web.app.transforms.AbstractAppTransform
| |||||||||||
| Fields | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| protected int | _levelFlag | Variable to hold the value of the levelFlag Formal Parameter |
|||||||||
| protected int | _maxItemCount | Variable to hold the value of the maxItemCount Formal Parameter |
|||||||||
| public FormalParameter | checkImage | The name of the image used to indicate the default address. | |||||||||
| public FormalParameter | confirmDelete | Indicates whether to confirm or not before deleting an address. | |||||||||
| protected String | cssContent | This field is deprecated. This CSS is no longer required as we use new styles for this purpose rather than nested tables. | |||||||||
| protected String | cssFooter | This field is deprecated. This CSS is no longer required as we use new styles for this purpose rather than nested tables. | |||||||||
| protected String | cssHeader | This field is deprecated. This CSS is no longer required as we use new styles for this purpose rather than nested tables. | |||||||||
| protected String | cssItem | Variable to hold the CSS class for the each of the individual address items | |||||||||
| protected String | cssSelectedItem | Variable to hold the CSS class for the individual items of a selected address or for editing or a new address | |||||||||
| protected String | cssTableHeader | Variable to hold the CSS class for the headers of the listed addresses | |||||||||
| public FormalParameter | levelFlag | Specifies what information is displayed for each address. | |||||||||
| public FormalParameter | maxItemCount | Indicates how many addresses will be displayed in the address list. | |||||||||
| public FormalParameter | upperLeftCornerImage | This field is deprecated. This image is no longer required, the header of the preferences page is defined with css styles | |||||||||
| public FormalParameter | upperRightCornerImage | This field is deprecated. This image is no longer required, the header of the preferences page is defined with css styles | |||||||||
|
[Expand]
Inherited Fields | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
com.microstrategy.web.app.transforms.AbstractAppTransform
| |||||||||||
| Public Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
AddressListTransform()
Default no argument constructor.
| |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| boolean |
checkLevel(int column)
Checks the level flag with the level of a column to decide if we want to render a particular column.
| ||||||||||
| String |
getDescription()
Returns the description of this transform.
| ||||||||||
| InputTag | getEditDisplayNameField(WebSubscriptionAddress address) | ||||||||||
| InputTag | getEditPhysicalAddressInput(WebSubscriptionAddress address) | ||||||||||
| WebEvent |
getEventAdd()
Returns the event to add a new address.
| ||||||||||
| WebEvent |
getEventCancel()
Returns the event to cancel editing or saving an address.
| ||||||||||
| WebEvent |
getEventEdit(WebSubscriptionAddress address)
Returns the event to edit an existing address.
| ||||||||||
| WebEvent |
getEventRemove(WebSubscriptionAddress address)
Returns the event to delete an existing address.
| ||||||||||
| WebEvent |
getEventSave()
Returns the event to save the address currently being editing
| ||||||||||
| WebEvent |
getEventSetDefault()
Returns the event to change the current default address.
| ||||||||||
| Class |
getSupportedBeanType()
Returns the supported bean type for the transform.
| ||||||||||
| String |
getTitle()
Retrieves the Title for the dialog.
| ||||||||||
| void |
initializeCss()
Initialize the css classes to be used by this transform.
| ||||||||||
| void |
initializeImages()
Initialize the images to be used by this transform.
| ||||||||||
| void |
initializeTransform(Transformable data)
This method initialize the private and protected fields of the transform.
| ||||||||||
| void |
renderAddress(MarkupOutput out, WebSubscriptionAddress address, boolean edit)
Renders a single address.
| ||||||||||
| void |
renderAddress(MarkupOutput out, WebSubscriptionAddress address, boolean edit, int bandOn)
overloaded version - to add banding effect and remove deprecated code
Renders a single address.
| ||||||||||
| void |
renderColgroups(MarkupOutput out)
Renders all column headers for the address list.
| ||||||||||
| void | renderDeviceField(MarkupOutput out, WebSubscriptionAddress address, boolean edit) | ||||||||||
| void |
renderDeviceInfo(MarkupOutput out, WebSubscriptionAddress address, boolean edit)
Renders the device column of an address.
| ||||||||||
| void | renderDisplayNameField(MarkupOutput out, WebSubscriptionAddress address, boolean edit) | ||||||||||
| void |
renderDisplayNameInfo(MarkupOutput out, WebSubscriptionAddress address, boolean edit)
Renders the address name column of an address.
| ||||||||||
| void |
renderEditInfo(MarkupOutput out, WebSubscriptionAddress address, boolean edit)
Renders the edit/remove column of an address.
| ||||||||||
| void |
renderEmptyAddress(MarkupOutput out)
Renders an empty address when there is addresses available for that delivery mode
| ||||||||||
| void |
renderEmtpyList(MarkupOutput out)
Renders an empty list of addresses.
| ||||||||||
| void |
renderFormEnd(MarkupOutput out)
Renders the FORM end tag.
| ||||||||||
| void |
renderFormStart(MarkupOutput out)
Renders the FORM start tag.
| ||||||||||
| void |
renderHeader(MarkupOutput out, int column)
Renders a single column header for the Address List.
| ||||||||||
| void |
renderHeaders(MarkupOutput out)
Renders all column headers for the address list.
| ||||||||||
| void |
renderImage(MarkupOutput out, String image)
Renders an image in the transform.
| ||||||||||
| void |
renderList(MarkupOutput out, SimpleList list)
Renders a non-empty list of addresses.
| ||||||||||
| void | renderPhysicalAddressField(MarkupOutput out, WebSubscriptionAddress address, boolean edit) | ||||||||||
| void |
renderPhysicalAddressInfo(MarkupOutput out, WebSubscriptionAddress address, boolean edit)
Renders the physical address column of an address.
| ||||||||||
| void | renderSetDefaultField(MarkupOutput out, WebSubscriptionAddress address, boolean edit) | ||||||||||
| void |
renderSetDefaultInfo(MarkupOutput out, WebSubscriptionAddress address, boolean edit)
Renders the default column of an address.
| ||||||||||
| void |
transformForRequestInError(MarkupOutput out)
Transform when the status is
In Error. | ||||||||||
| void |
transformForRequestNotInited(MarkupOutput out)
Transform when the status is
Not initialized. | ||||||||||
| void |
transformForRequestSuccessful(MarkupOutput out)
Generates the graphical output for the AddressListBean when the bean is
succesfull.
| ||||||||||
| void |
transformForRequestWaitingForUserInput(MarkupOutput out)
Transform when the status is
WaitingForUserInputessful. | ||||||||||
| Protected Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| void | addAttributesToLinkAnchor(Tag anchor) | ||||||||||
| boolean | canDisplayNewAddressLink() | ||||||||||
| AnchorTag |
generateAnchor(WebEvent event)
Overwrites parent method by testing if anchor should be enabled for iframe environment
| ||||||||||
| AddressListBean |
getAddressListBean()
Returns the list of supported devices for email addresses.
| ||||||||||
| SimpleList | getAddresses() | ||||||||||
| SimpleList |
getAvailableDevices()
Returns the list of supported devices for email addresses.
| ||||||||||
| String | getSelectedDeviceId(WebSubscriptionAddress address) | ||||||||||
| boolean | isAddressInEditMode(WebSubscriptionAddress address) | ||||||||||
| boolean | isEditMode() | ||||||||||
| boolean | isNewAddress(WebSubscriptionAddress address, SimpleList addresses) | ||||||||||
| boolean | isNewAvailable() | ||||||||||
| void | renderAddressesTable(MarkupOutput out) | ||||||||||
| boolean | renderCancelInputButton(MarkupOutput out) | ||||||||||
| boolean | renderDeleteLink(MarkupOutput out, WebSubscriptionAddress address) | ||||||||||
| boolean | renderEditLink(MarkupOutput out, WebSubscriptionAddress address) | ||||||||||
| void | renderHeaderContent(MarkupOutput out, int column) | ||||||||||
| void | renderNewLink(MarkupOutput out) | ||||||||||
| boolean | renderSaveButton(MarkupOutput out) | ||||||||||
| void | renderSetDefaultButton(MarkupOutput out) | ||||||||||
| void | setAddresses(SimpleList addresses) | ||||||||||
| void |
transformBody(MarkupOutput out)
This is called to generate the main body of the Address List dialog.
| ||||||||||
| void |
transformFooter(MarkupOutput out)
Generates the Footer of the Address List dialog.
| ||||||||||
| void |
transformHeader(MarkupOutput out)
Generates the Header of the Address List dialog.
| ||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
com.microstrategy.web.app.transforms.AddressTransform
| |||||||||||
From class
com.microstrategy.web.app.transforms.AbstractAppTransform
| |||||||||||
From class
com.microstrategy.web.transform.AbstractLayoutTransform
| |||||||||||
From class
com.microstrategy.web.transform.AbstractTransform
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
com.microstrategy.web.app.transforms.AppTransform
| |||||||||||
From interface
com.microstrategy.web.transform.Transform
| |||||||||||
Constant for the name of the confirmDelete Formal Parameter.
Constant for the name of the checkImage Formal Parameter.
This constant is 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.
This constant is 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.
Constant for the name of the levelFlag Formal Parameter.
Constant for the name of the maxItemCount Formal Parameter.
LEVEL parameter that specifies to include a link to add new addresses
LEVEL parameter that includes all LEVEL parameters.
LEVEL parameter that specifies to include the column headers
LEVEL parameter that specifies to include the address device name
LEVEL parameter that specifies to include the address display name
LEVEL parameter that specifies to include a link to edit the address.
LEVEL parameter that specifies to include the address list within another frame This frame is the one used by other sections in Preferences page.
LEVEL parameter that specifies to include the address physical address
LEVEL parameter that specifies to include a link to remove the address
LEVEL parameter that specifies to include a link to set any of the addresses as default
Variable to hold the value of the levelFlag Formal Parameter
Variable to hold the value of the maxItemCount Formal Parameter
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"
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.
This field is 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
This field is 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
This field is 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
Variable to hold the CSS class for the each of the individual address items
Variable to hold the CSS class for the individual items of a selected address or for editing or a new address
Variable to hold the CSS class for the headers of the listed addresses
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:
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.
This field is 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.
This field is 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.
Default no argument constructor. Initialize formal parameters.
Checks the level flag with the level of a column to decide if we want to render a particular column.
| 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 the description of this transform.
This is used in the style catalog editor.
Returns the event to add a new address.
EnumAddressListBeanEvents.ADDRESS_LIST_EVENT_CREATE_NEW_ADDRESS event.
Returns the event to cancel editing or saving an address.
EnumServletEvents.WebEventCancel event.
Returns the event to edit an existing address.
| address | The address to edit. |
|---|
EnumAddressListBeanEvents.ADDRESS_LIST_EVENT_INIT_ADDRESS event.
Returns the event to delete an existing address.
| address | The address to remove. |
|---|
EnumAddressListBeanEvents.ADDRESS_LIST_EVENT_DELETE event.
Returns the event to save the address currently being editing
EnumAddressListBeanEvents.ADDRESS_LIST_EVENT_SAVE event.
Returns the event to change the current default address.
EnumAddressListBeanEvents.ADDRESS_LIST_EVENT_CHANGE_DEFAULT event.
Returns the supported bean type for the transform.
AddressListBean bean for this transform.
Retrieves the Title for the dialog.
Initialize the css classes to be used by this transform.
Initialize the images to be used by this transform.
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.
| data | The bean to transform |
|---|
Renders a single address.
| out | The transform's output. |
|---|---|
| address | The address to render |
| edit | Indicates whether to show the address in edit mode. |
overloaded version - to add banding effect and remove deprecated code
Renders a single address.
| 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 |
Renders all column headers for the address list.
| out | The transform's output. |
|---|
Renders the device column of an address.
| out | The transform's output. |
|---|---|
| address | The address to render. |
| edit | Indicates whether to show the address in edit mode. |
Renders the address name column of an address.
| out | The transform's output. |
|---|---|
| address | The address to render |
| edit | Indicates whether to show the address in edit mode. |
Renders the edit/remove column of an address.
It also renders the save/cancel buttons if editing an address.
| out | The transform's output. |
|---|---|
| address | the address to render. |
| edit | Indicates whether to show the address in edit mode. |
Renders an empty address when there is addresses available for that delivery mode
| WebBeanException |
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.
| out | The transform's output. |
|---|
Renders the FORM end tag.
| out | The transform's output. |
|---|
Renders the FORM start tag.
| out | The transform's output. |
|---|
Renders a single column header for the Address List. Calls
renderHeaderContent(MarkupOutput, int) for displaying the text and other
content related with the header.
| out | The transform's output. |
|---|---|
| column | The column to render |
Renders all column headers for the address list.
| out | The transform's output. |
|---|
Renders an image in the transform.
| out | The transform's output. |
|---|---|
| image | The image name. |
Renders a non-empty list of addresses.
| out | The transform's output. |
|---|---|
| list | The list of addresses to render |
Renders the physical address column of an address.
| out | The transform's output. |
|---|---|
| address | The address to render. |
| edit | Indicates whether to show the address in edit mode. |
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.
| out | The transform's output. |
|---|---|
| address | the address to render |
| edit | indicates whether to show the address in edit mode. |
Transform when the status is In Error.
Overwrites transformForRequestInError by showing a "The email subscriptions feature is currently unavailable"
message.
| out | the transform's output |
|---|
Transform when the status is Not initialized.
It invokes the transformForRequestNotInited method on the parent and then invokes the
transformForRequestWaitingForUserInput method on itself.
| out | Output by this transform |
|---|
Generates the graphical output for the AddressListBean when the bean is
succesfull. It calls transformForRequestWaitingForUserInput so the user
might edit or view Address Values.
| out | The transform's output. |
|---|
Transform when the status is WaitingForUserInputessful.
Overwrites by showing the Preferences form. It paints the address list form.
| out | the transform's output |
|---|
Overwrites parent method by testing if anchor should be enabled for iframe environment
| event | WebEvent |
|---|
Returns the list of supported devices for email addresses.
SimpleList supported devices for email addresses.Returns the list of supported devices for email addresses.
SimpleList supported devices for email addresses.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.
| out | The transform's output. |
|---|
Generates the Footer of the Address List dialog.
| out | The transform's output. |
|---|
Generates the Header of the Address List dialog.
| out | The transform's output. |
|---|