ExportOptions

Options regarding Exporting data from AdapTable

TypeScript
export interface

Properties

PropertyTypeDescriptionDefault
appendFileTimestampbooleanWhether to add a timestamp as a suffix to exported file namefalse
csvSeparatorstring | ((csvSeparatorContext:BaseExportContext) => string)Separator for CSV exports','
customDestinationsCustomDestination[] | ((context:CustomDestinationsContext) =>CustomDestination[])User-provided Report Destinations (in addition to those shipped in AdapTable)
excelSheetNamestring | ((excelSheetNameContext:BaseExportContext) => string)Provides a custom name for the Excel sheet when exporting to Excel'Sheet 1'
exportDataFormatDataFormatType|DataFormatDataType| ((context:ExportDataFormatContext<TData>) =>DataFormatType)Sets 'rawValue' or 'formattedValue' as Data format in Reports; can be set for whole grid, per Data Type, or per Column (via a function)rawValue
exportDateFormatstring | ((context:ExportDateFormatContext<TData>) => string)Optional custom format for Date columns when exportingundefined
getDetailRows(context:GetDetailRowsContext<TData>) => CsvDetailRow[] | ExcelDetailRow[] | undefinedFunction to provide the Detail Rows when exporting in Master-Detail grids. This function will be invoked for each master row node.
isColumnExportable(context:AdaptableColumnContext) => booleanWhether a Column is included in System Reports and available in UI for selectiontrue
processExport(processExportContext:ProcessExportContext) => Promise<ExportResultData | boolean>Provides custom handling of the Export process before the default export is executed.
reportFilename(reportFileNameContext:ReportFileNameContext) => stringProvide a bespoke file name for the Report
skipColumnHeadersboolean | ((skipColumnHeadersContext:BaseExportContext) => boolean)Whether to exclude Column Headers from the exported datafalse
systemExportDestinationsSystemExportDestination[] | ((context:SystemExportDestinationsContext) =>SystemExportDestination[])Export destinations to use; leave unset for all, empty array for none'Download', 'Clipboard'
systemReportFormatsSystemReportFormat[] | ((context:SystemReportFormatsContext) =>SystemReportFormat[])System Report Formats to use; leave unset for all, empty array for none'Excel', 'VisualExcel', 'CSV', 'JSON'
systemReportNamesSystemReportName[] | ((context:SystemReportNamesContext) =>SystemReportName[])System Reports to use; leave unset for all, empty array for none'All Data', 'Current Layout', 'Selected Data',

Property Details

appendFileTimestamp

Whether to add a timestamp as a suffix to exported file name

TypeScript
appendFileTimestamp?: boolean;
Default Value

false

Property Value

boolean

csvSeparator

Separator for CSV exports

TypeScript
csvSeparator?: string | ((csvSeparatorContext: BaseExportContext) => string);
Default Value

','

Property Value

string | ((csvSeparatorContext:BaseExportContext) => string)

customDestinations

User-provided Report Destinations (in addition to those shipped in AdapTable)

TypeScript
customDestinations?: CustomDestination[] | ((context: CustomDestinationsContext) => CustomDestination[]);
Property Value

CustomDestination[] | ((context:CustomDestinationsContext) =>CustomDestination[])

excelSheetName

Provides a custom name for the Excel sheet when exporting to Excel

TypeScript
excelSheetName?: string | ((excelSheetNameContext: BaseExportContext) => string);
Default Value

'Sheet 1'

Property Value

string | ((excelSheetNameContext:BaseExportContext) => string)

exportDataFormat

Sets 'rawValue' or 'formattedValue' as Data format in Reports; can be set for whole grid, per Data Type, or per Column (via a function)

TypeScript
exportDataFormat?: DataFormatType | DataFormatDataType | ((context: ExportDataFormatContext<TData>) => DataFormatType);
Default Value

rawValue

Property Value

DataFormatType|DataFormatDataType| ((context:ExportDataFormatContext<TData>) =>DataFormatType)

exportDateFormat

Optional custom format for Date columns when exporting

TypeScript
exportDateFormat?: string | ((context: ExportDateFormatContext<TData>) => string);
Default Value

undefined

Property Value

string | ((context:ExportDateFormatContext<TData>) => string)

getDetailRows

Function to provide the Detail Rows when exporting in Master-Detail grids. This function will be invoked for each master row node.

TypeScript
getDetailRows?: (context: GetDetailRowsContext<TData>) => CsvDetailRow[] | ExcelDetailRow[] | undefined;
Property Value

(context:GetDetailRowsContext<TData>) => CsvDetailRow[] | ExcelDetailRow[] | undefined

isColumnExportable

Whether a Column is included in System Reports and available in UI for selection

TypeScript
isColumnExportable?: (context: AdaptableColumnContext) => boolean;
Default Value

true

Property Value

(context:AdaptableColumnContext) => boolean

processExport

Provides custom handling of the Export process before the default export is executed.

TypeScript
processExport?: (processExportContext: ProcessExportContext) => Promise<ExportResultData | boolean>;
Property Value

(processExportContext:ProcessExportContext) => Promise<ExportResultData | boolean>

reportFilename

Provide a bespoke file name for the Report

TypeScript
reportFilename?: (reportFileNameContext: ReportFileNameContext) => string;
Property Value

(reportFileNameContext:ReportFileNameContext) => string

skipColumnHeaders

Whether to exclude Column Headers from the exported data

TypeScript
skipColumnHeaders?: boolean | ((skipColumnHeadersContext: BaseExportContext) => boolean);
Default Value

false

Property Value

boolean | ((skipColumnHeadersContext:BaseExportContext) => boolean)

systemExportDestinations

Export destinations to use; leave unset for all, empty array for none

TypeScript
systemExportDestinations?: SystemExportDestination[] | ((context: SystemExportDestinationsContext) => SystemExportDestination[]);
Default Value

'Download', 'Clipboard'

Property Value

SystemExportDestination[] | ((context:SystemExportDestinationsContext) =>SystemExportDestination[])

systemReportFormats

System Report Formats to use; leave unset for all, empty array for none

TypeScript
systemReportFormats?: SystemReportFormat[] | ((context: SystemReportFormatsContext) => SystemReportFormat[]);
Default Value

'Excel', 'VisualExcel', 'CSV', 'JSON'

Property Value

SystemReportFormat[] | ((context:SystemReportFormatsContext) =>SystemReportFormat[])

systemReportNames

System Reports to use; leave unset for all, empty array for none

TypeScript
systemReportNames?: SystemReportName[] | ((context: SystemReportNamesContext) => SystemReportName[]);
Default Value

'All Data', 'Current Layout', 'Selected Data',

Property Value

SystemReportName[] | ((context:SystemReportNamesContext) =>SystemReportName[])