java.lang.Object | ||
↳ | com.microstrategy.utils.config.AbstractConfigurationElement | |
↳ | com.microstrategy.web.app.ExportFormat |
Defines the properties of a single export format supported by the application. The application presents this export-format to the user when the export functionality is used.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
String | ATT_BEAN_TYPE | ||||||||||
String | ATT_CHARSET | ||||||||||
String | ATT_CODEPAGE | ||||||||||
String | ATT_DESCRIPTION | ||||||||||
String | ATT_DESC_ID | ||||||||||
String | ATT_EXECUTION_MODE | ||||||||||
String | ATT_EXPORT_FORMAT_TYPE | ||||||||||
String | ATT_FEATURE | ||||||||||
String | ATT_FILE_EXTENSION | ||||||||||
String | ATT_FORCE_DOWNLOAD | ||||||||||
String | ATT_MIME_TYPE | ||||||||||
String | ATT_NAME | ||||||||||
String | ATT_PAGE_NAME | ||||||||||
String | ATT_SAVE_REPORT_PROPS | This constant is deprecated. we now save properties for all formats | |||||||||
String | ATT_STYLE | ||||||||||
String | ATT_VIEW_MODE | ||||||||||
String | NODE_EXPORT_FORMAT |
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
ExportFormat()
Class constructor.
| |||||||||||
ExportFormat(Node root)
Class constructor.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
String |
getBeanType()
Returns the bean to which the export format belongs.
| ||||||||||
String | getCharset(AppContext appContext) | ||||||||||
int | getCodepage(AppContext appContext) | ||||||||||
String |
getDescription()
Returns a description that the application should use
to display the export format if the desc-id attribute is missing.
| ||||||||||
String |
getDescriptorID()
Returns the Resource Bundle item id that the application should use
to display the export format in the language of the user's locale.
| ||||||||||
String |
getExecutionMode()
Returns the execution mode that the export format uses.
| ||||||||||
String |
getExportFormatType()
Returns the type of this export format.
| ||||||||||
String |
getFeature()
Returns the id of a feature that is evaluated to determine whether the
export-format should be displayed as an option.
| ||||||||||
String |
getFileExtension()
Returns the extension that the application gives to the file that is created
when exporting using the export format.
| ||||||||||
boolean | getForceDownload() | ||||||||||
String | getMessage(Messages messages) | ||||||||||
String |
getMimeType()
Returns the mime-type that the export format uses.
| ||||||||||
String |
getName()
Returns the export-format's name, a unique identifier for the export-format.
| ||||||||||
String |
getPageName()
Returns the page's name that the application
uses when exporting using the specified export format.
| ||||||||||
boolean |
getSaveReportProps()
This method is deprecated.
we now save properties for all formats
| ||||||||||
String |
getStyle()
Returns the name of a style (from the Style Catalog) that is
used to transform the corresponding bean when exporting using the
export format.
| ||||||||||
String |
getViewMode()
Returns the view mode that the export format uses.
| ||||||||||
String |
getViewModeName()
This method is deprecated.
use getViewMode()
| ||||||||||
boolean | isCsvOrExcelWithPlaintext(AppContext appContext) | ||||||||||
boolean |
isExcel()
Whether the export format is for Excel with plaintext or Excel with formatting
Determined based on the export format type property | ||||||||||
boolean |
isExportFormatAvailable(String beanType, String viewMode, WebComponent baseBean)
Utility method to determine if an export format is available based on the bean type, view mode and feature-id if present.
| ||||||||||
boolean |
isPlainText()
Whether the export format is plaintext (Excel with plaintext, CSV or Plaintext)
Determined based on the export format type property. | ||||||||||
boolean |
isRealPlainText(AppContext appContext)
Whether the export format is plaintext.
| ||||||||||
void |
setBeanType(String beanType)
Indicates the bean to which the export format belongs.
| ||||||||||
void |
setCharset(boolean charset)
Set the charset to use when exporting.
| ||||||||||
void |
setCodepage(boolean codepage)
Set the codepage to use on ASP.NET when exporting.
| ||||||||||
void |
setDescription(String description)
Provides a descriptor that the application should use
to display the export format if the desc-id attribute is missing.
| ||||||||||
void |
setDescriptorID(String descriptorID)
Indicates the Resource Bundle item id that the application should use
to display the export format in the language of the user's locale.
| ||||||||||
void |
setExecutionMode(String executionMode)
Indicates the execution mode that the export format uses.
| ||||||||||
void |
setExportFormatType(String exportFormatType)
Sets the type of this export format.
| ||||||||||
void |
setFeature(String feature)
Sets the name of a feature that is evaluated to determine whether the
export-format should be displayed as an option.
| ||||||||||
void |
setFileExtension(String fileExtension)
Sets the extension that the application will give to the file that is
created when exporting using the export format.
| ||||||||||
void |
setForceDownload(boolean forceDownload)
Set whether to force the browser to download the file by adding "attachment" to the Content-Disposition HTTP header
| ||||||||||
void |
setMimeType(String mimeType)
Indicates the mime-type that the export format should use.
| ||||||||||
void |
setName(String exportFormatName)
Sets the export-format's name, which needs to be a unique identifier for the export-format.
| ||||||||||
void |
setPageName(String pageName)
Indicates the page that the application
will use when exporting using this ExportFormat.
| ||||||||||
void |
setSaveReportProps(boolean saveReportProps)
This method is deprecated.
we now save properties for all formats
| ||||||||||
void |
setStyle(String style)
Indicatges the name of a style (from the Style Catalog) that is
used to transform the corresponding bean when exporting using the
export format.
| ||||||||||
void |
setViewMode(String viewMode)
Indicates the view mode that the export format uses.
| ||||||||||
void |
setViewModeName(String viewModeName)
This method is deprecated.
use setViewMode()
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
String |
getKeyAttribute()
This method must return the attribute that uniquely identifies this element among its siblings;
if no single attribute can be used, return null and override the
getKey and
setKey methods. | ||||||||||
void |
initDefaultAttributes()
This method can be overridden to set default values for attributes.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() |
This constant is deprecated.
we now save properties for all formats
Class constructor. Initializes a new -empty- instance of the exportFormat class.
Class constructor. Initializes an Export format instance based on the information included on the XML Node
root | Node instance representing the export format information. |
---|
Returns the bean to which the export format belongs. In the export dialog this attributes dictactes which format to display depending on the object being exported (report, document or HTML Document).
appContext | the application's context |
---|
appContext | the application's context |
---|
Returns a description that the application should use to display the export format if the desc-id attribute is missing.
Returns the Resource Bundle item id that the application should use to display the export format in the language of the user's locale.
Returns the execution mode that the export format uses.
It returns the actual (resolved) value from the
EnumRWExecutionModes
enumeration, or null
if the value is underined.
Returns the type of this export format.
It returns the actual (resolved) value from the
EnumExportFormats
enumeration or
null
if the value is undefined.
Returns the id of a feature that is evaluated to determine whether the export-format should be displayed as an option.
Returns the extension that the application gives to the file that is created when exporting using the export format.
messages | the messages l10n object. |
---|
Returns the mime-type that the export format uses. This type is used by the browser to identify the type of content being sent.
Returns the export-format's name, a unique identifier for the export-format.
Returns the page's name that the application uses when exporting using the specified export format.
This method is deprecated.
we now save properties for all formats
Returns whether the options selected by the user in the export dialog should be saved back as part of the report-properties.
Returns the name of a style (from the Style Catalog) that is used to transform the corresponding bean when exporting using the export format. It only applies in export-formats that are used for reports
Returns the view mode that the export format uses.
It returns the actual (resolved) value from the ReportViewModeGrid
enumeration.
If the view mode is not defined, it returns null
.
This method is deprecated.
use getViewMode()
Whether the export format is for Excel with plaintext or Excel with formatting
Determined based on the export format type property
Utility method to determine if an export format is available based on the bean type, view mode and feature-id if present.
beanType | The Export Format's bean type |
---|---|
viewMode | The report's view mode |
baseBean | The base bean used to solve the feature-id on the export format if any. |
Whether the export format is plaintext (Excel with plaintext, CSV or Plaintext)
Determined based on the export format type property.
Whether the export format is plaintext.
appContext | the application's context |
---|
Indicates the bean to which the export format belongs. In the export dialog this attributes dictactes which format to display depending on the object being exported (report, document or HTML Document). Possible values are:
ReportBean
DocumentBean
RWBean
Set the charset to use when exporting.
If not specified we read this from the value specified on the locales.xml like this:
charset | the charset to use when exporting. |
---|
Set the codepage to use on ASP.NET when exporting.
If not specified we read this from the value specified on the locales.xml like this:
codepage | the codepage to use on ASP.NET when exporting. |
---|
Provides a descriptor that the application should use to display the export format if the desc-id attribute is missing.
Indicates the Resource Bundle item id that the application should use to display the export format in the language of the user's locale.
Indicates the execution mode that the export format uses.
This execution-mode applies only to export formats
that are used for documents, that is their bean-type is "RWBean".
The values of the attribute are expressed using the fully-qualified
name of the constants defined in the
EnumRWExecutionModes
enumeration
for example, "com.microstrategy.web.objects.rw.EnumRWExecutionModes.RW_MODE_PDF".
Sets the type of this export format.
The value must be a valid fully-qualified name of the values defined in this EnumExportFormats
internface, for example,
"com.microstrategy.web.app.beans.EnumExportFormats.ExportFormatExcelWithPlaintext".
exportFormatType | the export format type to be used on this export format. |
---|
Sets the name of a feature that is evaluated to determine whether the export-format should be displayed as an option.
Sets the extension that the application will give to the file that is created when exporting using the export format.
Set whether to force the browser to download the file by adding "attachment" to the Content-Disposition HTTP header
forceDownload | whether to force the browser to download the file by adding "attachment" to the Content-Disposition HTTP header |
---|
Indicates the mime-type that the export format should use. This type is used by the browser to identify the type of content being sent.
Sets the export-format's name, which needs to be a unique identifier for the export-format.
Indicates the page that the application will use when exporting using this ExportFormat.
This method is deprecated.
we now save properties for all formats
Indicates whether the options selected by the user in the export dialog should be saved back as part of the report-properties.
Indicatges the name of a style (from the Style Catalog) that is used to transform the corresponding bean when exporting using the export format. This attribute applies only to export formats that are used for reports (i.e. their beantype is ReportBean) , but in this case it is always required to have a valid value.
Indicates the view mode that the export format uses. The values of the attribute are expressed using the fully-qualified name of the constants defined in the EnumWebReportViewMode interface for example, "com.microstrategy.web.objects.EnumWebReportViewMode.ReportViewModeGrid").
This method is deprecated.
use setViewMode()
Set the view mode name of this export format to the given parameter
viewModeName | the view mode used on this export format. |
---|
This method must return the attribute that uniquely identifies this element among its siblings;
if no single attribute can be used, return null and override the getKey
and
setKey
methods.
This method can be overridden to set default values for attributes. Simply
extend this method and call setAttribute(String, Object)