import {ApiError} from 'app/common/ApiError'; import {buildColFilter} from 'app/common/ColumnFilterFunc'; import {TableDataAction} from 'app/common/DocActions'; import {DocumentSettings} from 'app/common/DocumentSettings'; import * as gristTypes from 'app/common/gristTypes'; import * as gutil from 'app/common/gutil'; import {nativeCompare} from 'app/common/gutil'; import {isTableCensored} from 'app/common/isHiddenTable'; import {buildRowFilter} from 'app/common/RowFilterFunc'; import {schema, SchemaTypes} from 'app/common/schema'; import {SortFunc} from 'app/common/SortFunc'; import {Sort} from 'app/common/SortSpec'; import {MetaRowRecord, MetaTableData} from 'app/common/TableData'; import {ActiveDoc} from 'app/server/lib/ActiveDoc'; import {RequestWithLogin} from 'app/server/lib/Authorizer'; import {docSessionFromRequest} from 'app/server/lib/DocSession'; import {optIntegerParam, optJsonParam, stringParam} from 'app/server/lib/requestUtils'; import {ServerColumnGetters} from 'app/server/lib/ServerColumnGetters'; import * as express from 'express'; import * as _ from 'underscore'; // Helper type for Cell Accessor type Access = (row: number) => any; // Helper interface with information about the column interface ExportColumn { id: number; colId: string; label: string; type: string; widgetOptions: any; parentPos: number; } // helper for empty column const emptyCol: ExportColumn = { id: 0, colId: '', label: '', type: '', widgetOptions: null, parentPos: 0 }; /** * Bare data that is exported - used to convert to various formats. */ export interface ExportData { /** * Table name or table id. */ tableName: string; /** * Document name. */ docName: string; /** * Row ids (filtered and sorted). */ rowIds: number[]; /** * Accessor for value in a column. */ access: Access[]; /** * Columns information (primary used for formatting). */ columns: ExportColumn[]; /** * Document settings */ docSettings: DocumentSettings; } /** * Export parameters that identifies a section, filters, sort order. */ export interface ExportParameters { tableId: string; viewSectionId: number | undefined; sortOrder: number[]; filters: Filter[]; } /** * Options parameters for CSV and XLSX export functions. */ export interface DownloadOptions { filename: string; tableId: string; viewSectionId: number | undefined; filters: Filter[]; sortOrder: number[]; } interface FilteredMetaTables { [tableId: string]: TableDataAction; } /** * Gets export parameters from a request. */ export function parseExportParameters(req: express.Request): ExportParameters { const tableId = stringParam(req.query.tableId, 'tableId'); const viewSectionId = optIntegerParam(req.query.viewSection); const sortOrder = optJsonParam(req.query.activeSortSpec, []) as number[]; const filters: Filter[] = optJsonParam(req.query.filters, []); return { tableId, viewSectionId, sortOrder, filters, }; } // Helper for getting filtered metadata tables. async function getMetaTables(activeDoc: ActiveDoc, req: express.Request): Promise { const docSession = docSessionFromRequest(req as RequestWithLogin); return safe(await activeDoc.fetchMetaTables(docSession), "No metadata available in active document"); } // Makes assertion that value does exist or throws an error function safe(value: T, msg: string) { if (!value) { throw new ApiError(msg, 404); } return value as NonNullable; } // Helper for getting table from filtered metadata. function safeTable(metaTables: FilteredMetaTables, tableId: TableId) { const table = safe(metaTables[tableId], `No table '${tableId}' in document`); const colTypes = safe(schema[tableId], `No table '${tableId}' in document schema`); return new MetaTableData(tableId, table, colTypes); } // Helper for getting record safely: it throws if the record is missing. function safeRecord(table: MetaTableData, id: number) { return safe(table.getRecord(id), `No record ${id} in table ${table.tableId}`); } // Check that tableRef points to an uncensored table, or throw otherwise. function checkTableAccess(tables: MetaTableData<"_grist_Tables">, tableRef: number): void { if (isTableCensored(tables, tableRef)) { throw new ApiError(`Cannot find or access table`, 404); } } /** * Builds export for all raw tables that are in doc. * @param activeDoc Active document * @param req Request */ export async function exportDoc( activeDoc: ActiveDoc, req: express.Request) { const metaTables = await getMetaTables(activeDoc, req); const tables = safeTable(metaTables, '_grist_Tables'); // select raw tables const tableRefs = tables.filterRowIds({ summarySourceTable: 0 }); const tableExports = await Promise.all( tableRefs .filter(tId => !isTableCensored(tables, tId)) // Omit censored tables .map(tId => exportTable(activeDoc, tId, req, {metaTables})) ); return tableExports; } /** * Builds export data for section that can be used to produce files in various formats (csv, xlsx). */ export async function exportTable( activeDoc: ActiveDoc, tableRef: number, req: express.Request, {metaTables}: {metaTables?: FilteredMetaTables} = {}, ): Promise { metaTables = metaTables || await getMetaTables(activeDoc, req); const tables = safeTable(metaTables, '_grist_Tables'); checkTableAccess(tables, tableRef); const table = safeRecord(tables, tableRef); const tableColumns = safeTable(metaTables, '_grist_Tables_column') .getRecords() // sort by parentPos and id, which should be the same order as in raw data .sort((c1, c2) => nativeCompare(c1.parentPos, c2.parentPos) || nativeCompare(c1.id, c2.id)) // remove manual sort column .filter(col => col.colId !== gristTypes.MANUALSORT); // Produce a column description matching what user will see / expect to export const tableColsById = _.indexBy(tableColumns, 'id'); const columns = tableColumns.map(tc => { // remove all columns that don't belong to this table if (tc.parentId !== tableRef) { return emptyCol; } // remove all helpers if (gristTypes.isHiddenCol(tc.colId)) { return emptyCol; } // for reference columns, return display column, and copy settings from visible column const displayCol = tableColsById[tc.displayCol || tc.id]; const colOptions = gutil.safeJsonParse(tc.widgetOptions, {}); const displayOptions = gutil.safeJsonParse(displayCol.widgetOptions, {}); const widgetOptions = Object.assign(displayOptions, colOptions); return { id: displayCol.id, colId: displayCol.colId, label: tc.label, type: displayCol.type, widgetOptions, parentPos: tc.parentPos }; }).filter(tc => tc !== emptyCol); // fetch actual data const data = await activeDoc.fetchTable(docSessionFromRequest(req as RequestWithLogin), table.tableId, true); const rowIds = data[2]; const dataByColId = data[3]; // sort rows const getters = new ServerColumnGetters(rowIds, dataByColId, columns); // create cell accessors const access = columns.map(col => getters.getColGetter(col.id)!); let tableName = table.tableId; // since tables ids are not very friendly, borrow name from a primary view if (table.primaryViewId) { const viewId = table.primaryViewId; const views = safeTable(metaTables, '_grist_Views'); const view = safeRecord(views, viewId); tableName = view.name; } const docInfo = safeRecord(safeTable(metaTables, '_grist_DocInfo'), 1); const docSettings = gutil.safeJsonParse(docInfo.documentSettings, {}); return { tableName, docName: activeDoc.docName, rowIds, access, columns, docSettings }; } /** * Builds export data for section that can be used to produce files in various formats (csv, xlsx). */ export async function exportSection( activeDoc: ActiveDoc, viewSectionId: number, sortSpec: Sort.SortSpec | null, filters: Filter[] | null, req: express.Request, {metaTables}: {metaTables?: FilteredMetaTables} = {}, ): Promise { metaTables = metaTables || await getMetaTables(activeDoc, req); const viewSections = safeTable(metaTables, '_grist_Views_section'); const viewSection = safeRecord(viewSections, viewSectionId); safe(viewSection.tableRef, `Cannot find or access table`); const tables = safeTable(metaTables, '_grist_Tables'); checkTableAccess(tables, viewSection.tableRef); const table = safeRecord(tables, viewSection.tableRef); const columns = safeTable(metaTables, '_grist_Tables_column') .filterRecords({parentId: table.id}); const viewSectionFields = safeTable(metaTables, '_grist_Views_section_field'); const fields = viewSectionFields.filterRecords({parentId: viewSection.id}); const savedFilters = safeTable(metaTables, '_grist_Filters') .filterRecords({viewSectionRef: viewSection.id}); const tableColsById = _.indexBy(columns, 'id'); const fieldsByColRef = _.indexBy(fields, 'colRef'); const savedFiltersByColRef = _.indexBy(savedFilters, 'colRef'); const unsavedFiltersByColRef = _.indexBy(filters ?? [], 'colRef'); // Produce a column description matching what user will see / expect to export const viewify = (col: GristTablesColumn, field?: GristViewsSectionField) => { const displayCol = tableColsById[field?.displayCol || col.displayCol || col.id]; const colWidgetOptions = gutil.safeJsonParse(col.widgetOptions, {}); const fieldWidgetOptions = field ? gutil.safeJsonParse(field.widgetOptions, {}) : {}; const filterString = unsavedFiltersByColRef[col.id]?.filter || savedFiltersByColRef[col.id]?.filter; const filterFunc = buildColFilter(filterString, col.type); return { filterFunc, id: displayCol.id, colId: displayCol.colId, label: col.label, type: col.type, parentPos: col.parentPos, widgetOptions: Object.assign(colWidgetOptions, fieldWidgetOptions), }; }; const tableColumns = columns .filter(column => !gristTypes.isHiddenCol(column.colId)) .map(column => viewify(column, fieldsByColRef[column.id])); const viewColumns = _.sortBy(fields, 'parentPos') .map((field) => viewify(tableColsById[field.colRef], field)); // The columns named in sort order need to now become display columns sortSpec = sortSpec || gutil.safeJsonParse(viewSection.sortColRefs, []); sortSpec = sortSpec!.map((colSpec) => { const colRef = Sort.getColRef(colSpec); const col = tableColsById[colRef]; if (!col) { return 0; } const effectiveColRef = viewify(col, fieldsByColRef[colRef]).id; return Sort.swapColRef(colSpec, effectiveColRef); }); // fetch actual data const data = await activeDoc.fetchTable(docSessionFromRequest(req as RequestWithLogin), table.tableId, true); let rowIds = data[2]; const dataByColId = data[3]; // sort rows const getters = new ServerColumnGetters(rowIds, dataByColId, columns); const sorter = new SortFunc(getters); sorter.updateSpec(sortSpec); rowIds.sort((a, b) => sorter.compare(a, b)); // create cell accessors const tableAccess = tableColumns.map(col => getters.getColGetter(col.id)!); // create row filter based on all columns filter const rowFilter = tableColumns .map((col, c) => buildRowFilter(tableAccess[c], col.filterFunc)) .reduce((prevFilter, curFilter) => (id) => prevFilter(id) && curFilter(id), () => true); // filter rows numbers rowIds = rowIds.filter(rowFilter); const docInfo = safeRecord(safeTable(metaTables, '_grist_DocInfo'), 1); const docSettings = gutil.safeJsonParse(docInfo.documentSettings, {}); return { rowIds, docSettings, tableName: table.tableId, docName: activeDoc.docName, access: viewColumns.map(col => getters.getColGetter(col.id)!), columns: viewColumns }; } type GristViewsSectionField = MetaRowRecord<'_grist_Views_section_field'> type GristTablesColumn = MetaRowRecord<'_grist_Tables_column'> // Type for filters passed from the client export interface Filter { colRef: number, filter: string }