Pivot Table

import { LocaleType, merge, Univer } from '@univerjs/core';
import { defaultTheme } from "@univerjs/design";
import { UniverSheetsPivotTablePlugin } from '@univerjs-pro/sheets-pivot';
import SheetsPivotTableEnUS from '@univerjs-pro/sheets-pivot/locale/en-US';
import { UniverSheetsPivotTableUIPlugin } from '@univerjs-pro/sheets-pivot-ui';
import SheetsPivotTableUIEnUS from '@univerjs-pro/sheets-pivot-ui/locale/en-US';
 
import '@univerjs-pro/sheets-pivot-ui/lib/index.css';
 
import '@univerjs-pro/sheets-pivot/facade';
 
const univer = new Univer({
  theme: defaultTheme,
  locale: LocaleType.EN_US,
  locales: {
    [LocaleType.EN_US]: merge(
      SheetsPivotTableEnUS,
      SheetsPivotTableUIEnUS
    ),
  },
});
 

univer.registerPlugin(UniverSheetsPivotTablePlugin);
univer.registerPlugin(UniverSheetsPivotTableUIPlugin);

// main process file
// Setting notExecuteFormula to true indicates that the main process does not perform calculations. It is only responsible for data distribution, synchronization, and rendering.
univer.registerPlugin(UniverSheetsPivotTablePlugin, { notExecuteFormula: true });
univer.registerPlugin(UniverSheetsPivotTableUIPlugin);
 
// web worker process file
// Setting notExecuteFormula to false indicates that the worker process performs the calculations.
univer.registerPlugin(UniverSheetsPivotTablePlugin, { notExecuteFormula: false });

import { LocaleType, merge, Univer } from '@univerjs/core';
import { defaultTheme } from "@univerjs/design";
import { UniverSheetsPivotTablePlugin } from '@univerjs-pro/sheets-pivot';
import SheetsPivotTableEnUS from '@univerjs-pro/sheets-pivot/locale/en-US';
 
import '@univerjs-pro/sheets-pivot/facade';
 
const univer = new Univer({
  theme: defaultTheme,
  locale: LocaleType.EN_US,
  locales: {
    [LocaleType.EN_US]: merge(
      SheetsPivotTableEnUS,
    ),
  },
});
 
univer.registerPlugin(UniverSheetsPivotTablePlugin, { notExecuteFormula: false });

// should ensure the sheet range A1:G9 is not empty
const fWorkbook = univerAPI.getActiveWorkbook();
const unitId = fWorkbook.getId();
const fSheet = fWorkbook.getActiveSheet();
const subUnitId = fSheet.getSheetId();
const sheetName = fSheet.getSheetName();
const sourceInfo = {
  unitId,
  subUnitId,
  sheetName,
  range: {
    startRow: 0,
    startColumn: 0,
    endRow: 8,
    endColumn: 5,
  },
}
const anchorCellInfo = {
  unitId,
  subUnitId,
  row: 20,
  col: 8
};
const fPivotTable = await fWorkbook.addPivotTable(sourceInfo, univerAPI.Enum.PositionTypeEnum.Existing, anchorCellInfo);
const pivotTableId = fPivotTable.getPivotTableId();
//add flag to avoid add pivot fields multiple times
let hasAdded = false;
// the addPivotTable is async, you can add pivot fields after the pivot table is added
univerAPI.addEvent(univerAPI.Event.PivotTableRendered, (params) => {
  if (!hasAdded && params.pivotTableId === pivotTableId) {
    fPivotTable.addField(1, univerAPI.Enum.PivotTableFiledAreaEnum.Row, 0);
    fPivotTable.addField(1, univerAPI.Enum.PivotTableFiledAreaEnum.Value, 0);
    hasAdded = true;
  }
});

const fWorkbook = univerAPI.getActiveWorkbook();
const unitId = fWorkbook.getId();
const fSheet = fWorkbook.getActiveSheet();
const subUnitId = fSheet.getSheetId();
 
// get pivot table by the cell in FWorkbook.
const fPivotTable =  fWorkbook.getPivotTableByCell(unitId, subUnitId, 0, 8)
 
// get pivot table by the cell in FWorksheet.
const pivotTable2 = fSheet.getPivotTableByCell(0, 8);

/**
 * @description Get the pivot table config by the pivot table id.
 * @typedef PivotTableConfig
 * @property {TargetInfo} targetCellInfo  The target cell info of the pivot table.
 * @property {SourceInfo} sourceRangeInfo The source data range info of the pivot table.
 * @property {boolean} isEmpty The pivot table is empty or not.
 * @property {object} fieldsConfig The snapshot of the pivot table fields config.
 * @returns {PivotTableConfig|undefined} The pivot table config or undefined.
 */
getConfig():IPivotTableConfig;
/**
 * @description Remove a pivot table from the workbook by pivot table id
 */
async remove():void;
/**
 *@description Add a pivot field to the pivot table.
  * @param {string|number} dataFieldIdOrIndex The data field id.
  * @param {PivotTableFiledAreaEnum} fieldArea The area of the field.
  * @param {number} index The index of the field in the target area.
  * @returns {boolean} Whether the pivot field is added successfully.
  */
async addField(dataFieldIdOrIndex: string | number, fieldArea: PivotTableFiledAreaEnum, index: number): Promise<boolean>;
/**
 * @description Remove a pivot field from the pivot table
 * @param {string[]} fieldIds The deleted field ids.
 * @returns {boolean} Whether the pivot field is removed successfully.
 */
async removeField(fieldIds: string[]): Promise<boolean>;
/**
 * @description Update the pivot table field position.
 * @param {string} fieldId - The moved field id.
 * @param {PivotTableFiledAreaEnum} area - The target area of the field.
 * @param {number} index - The target index of the field, if the index is bigger than the field count in the target area, the field will be moved to the last, if the index is smaller than 0, the field will be moved to the first.
 * @returns {boolean} Whether the pivot field is moved successfully.
 */
async updateFieldPosition(fieldId: string, area: PivotTableFiledAreaEnum, index: number): Promise<boolean>;
/**
 * @description If there are multiple value fields in the pivot table, you can update the position of the value field, which only can be position in row or column.
 * @param {PivotTableValuePositionEnum} position - The position of the value field.
 * @param {number} index - The index of the value field.
 * @returns {boolean} Whether the pivot value field is moved successfully.
 */
async updateValuePosition(position: PivotTableValuePositionEnum, index: number): Promise<boolean>;
/**
 * @description Set the pivot table subtotal type for value field, it only works for the value field.
 * @param {string} fieldId - The field id.
 * @param {PivotSubtotalTypeEnum} subtotalType - The subtotal type of the field.
 * @returns {boolean} Whether the pivot table subtotal type is set successfully.
 */
async setSubtotalType(fieldId: string, subtotalType: PivotSubtotalTypeEnum): Promise<boolean>;
/**
 * @description Set the pivot table sort info.
 * @param {string} tableFieldId - The field id of the sort.
 * @param {PivotTableSortInfo} info - The sort info.
 * @typedef PivotTableSortInfo
 * @property {PivotDataFieldSortOperatorEnum} type The sort operator of the field items.
 * @returns {boolean} Whether the pivot table sort info is set successfully.
 */
async setLabelSort(tableFieldId: string, info: IPivotTableSortInfo): Promise<boolean>;
/**
 * @description Set the pivot table filter.
 * @param {string} tableFieldId - The field id of the filter.
 * @param {string[]} items - The items of the filter.
 * @returns {boolean} Whether the pivot table filter is set successfully.
 */
async setLabelFilter(tableFieldId: string, items: string[], isAll?: boolean): Promise<boolean>;
/**
 * @description Rename the pivot table field.
 * @param {string} fieldId - The field id. 
 * @param {string} name - The new name of the field.
 * @returns {boolean} Whether the pivot table field is renamed successfully.
 */
async renameField(fieldId: string, name: string): Promise<boolean>;
/**
 * @description Set the pivot table value filter. A value filter is used to filter the data based on the value of a field.
 * @param {string} fieldId - The field id of the filter. Only one value filer can be set for a field.
 * @param {Omit<IPivotTableValueFilter, 'type'>} filterInfo - The filter info. The undefined value will be removed from the old filter.
 * @typedef filterInfo
 * @property {valueGreaterThan} operator - The filter operator is used to compare the value of the field with the expected value.Currently, The following operators are supported: valueBetween, valueEqual, valueGreaterThan, valueGreaterThanOrEqual, valueLessThan, valueLessThanOrEqual,valueNotBetween,valueNotEqual.
 * @property {number} expected - The expected value.
 * @property {string} valueFieldId - The value field id.
 * @returns {boolean} Whether the pivot table value filter is set successfully.
 */
async setValueFilter(fieldId: string, filterInfo: Omit<IPivotTableValueFilter, 'type'>): Promise<boolean>;
/**
 * @description Clear the fields by provided field area or clear all fields.
 * @param {PivotTableFiledAreaEnum} [resetArea] The area of the field to reset or undefined to reset all fields.
 * @returns {Promise<boolean>} Whether the pivot table fields are reset successfully.
 */
reset(resetArea?: PivotTableFiledAreaEnum): Promise<boolean>;
/**
 * @description Set the pivot table fields config.It will add fields to the pivot table from provided config.Before setting the fields config, you should ensure the pivot table is empty to avoid the conflict.
 * @param {IPivotTableConfig['fieldsConfig']} config The pivot table fields config.
 * @returns {Promise<boolean>} Whether the pivot table fields config is set successfully.
 */
setFieldsConfig(config: IPivotTableConfig['fieldsConfig']): Promise<boolean>; 
/**
 * Get all value filters of the pivot table. In pivot table, the value filter must be applied in order.So the order of the value filter is important.
 * @returns {IValueFilterInfoItem[]} The value filter info list.
 */
getValueFilters(): IValueFilterInfoItem[];

const disposable = univerAPI.addEvent(univerAPI.Event.BeforePivotTableAdd, (params) => {
  const { positionType, targetCellInfo } = params;
  if (positionType === univerAPI.Enum.PositionTypeEnum.Existing && targetCellInfo.sheetName === 'Sheet 1') {
    // Cancel the pivot table adding operation
    params.cancel = true;
    console.log(`The pivot table can't be added to the sheet ${targetCellInfo.sheetName}`);
  }
});
 
// Remove the event listener, use `disposable.dispose()`

const disposable = univerAPI.addEvent(univerAPI.Event.PivotTableAdded, (params) => {
  const { positionType, targetCellInfo } = params;
  if (positionType === univerAPI.Enum.PositionTypeEnum.Existing) {
    console.log('A pivot table created in an existing sheet');
    console.log(`
      The target sheet name is ${targetCellInfo.sheetName},
      the target row is ${targetCellInfo.row}, the target column is ${targetCellInfo.column}
    `);
  } else {
    console.log('A pivot table created in a new sheet');
  }
});
 
// Remove the event listener, use `disposable.dispose()`

const disposable = univerAPI.addEvent(univerAPI.Event.BeforePivotTableMove, (params) => {
  const { pivotTableId, targetCellInfo } = params;
  if (pivotTableId === 'pivotTable1' && targetCellInfo.sheetName === 'Sheet 1') {
    // Cancel the move pivot table operation
    params.cancel = true;
    console.log(`The pivot table can't be moved to the sheet ${targetCellInfo.sheetName}`);
  }
});
 
// Remove the event listener, use `disposable.dispose()`

const disposable = univerAPI.addEvent(univerAPI.Event.PivotTableMoved, (params) => {
  const { pivotTableId, targetCellInfo, originTargetInfo } = params;
  if (pivotTableId === 'pivotTable1') {
    console.log(`
      The pivot table moved from row: ${originTargetInfo.row} & column: ${originTargetInfo.column}
      to the sheet ${targetCellInfo.sheetName} row: ${targetCellInfo.row} & column: ${targetCellInfo.column}
    `);
  }
});
 
// Remove the event listener, use `disposable.dispose()`

// import { unionPivotViewRange } from '@univerjs-pro/sheets-pivot';
const disposable = univerAPI.addEvent(univerAPI.Event.PivotTableRendered, (params) => {
  const { pivotTableId, rangeInfo } = params;
  console.log(`The pivot table ${pivotTableId} has been rendered`);
  if (rangeInfo) {
    console.log(unionPivotViewRange(rangeInfo));
  }
});
 
// Remove the event listener, use `disposable.dispose()`

const disposable = univerAPI.addEvent(univerAPI.Event.PivotTableRemoved, (params) => {
  const { pivotTableId } = params;
  console.log(`The pivot table ${pivotTableId} has been removed`);
});
 
// Remove the event listener, use `disposable.dispose()`

const fWorkbook = univerAPI.getActiveWorkbook();
const disposable = univerAPI.addEvent(univerAPI.Event.PivotTableFieldAdded, (params) => {
  const { pivotTableId, fieldId, fieldArea, fieldIndex } = params;
  const pivotTable = fWorkbook.getPivotTableById(pivotTableId);
  const fieldSetting = pivotTable.getFieldSetting('fieldId');
  console.log(fieldSetting);
});
 
// Remove the event listener, use `disposable.dispose()`

const fWorkbook = univerAPI.getActiveWorkbook();
const disposable = univerAPI.addEvent(univerAPI.Event.PivotTableFieldRemoved, (params) => {
  const { pivotTableId, fieldId } = params;
  const pivotTable = fWorkbook.getPivotTableById(pivotTableId);
  const fieldSetting = pivotTable.getFieldSetting(fieldId);
  console.log(fieldSetting);
});
 
// Remove the event listener, use `disposable.dispose()`

const fWorkbook = univerAPI.getActiveWorkbook();
const disposable = univerAPI.addEvent(univerAPI.Event.PivotTableFieldMoved, (params) => {
  const { pivotTableId, fieldId, fieldArea, fieldIndex } = params;
  const pivotTable = fWorkbook.getPivotTableById(pivotTableId);
  const fieldSetting = pivotTable.getFieldSetting(fieldId);
  console.log(`The source name ${fieldSetting.sourceName} the display name ${fieldSetting.displayName}`);
});
 
// Remove the event listener, use `disposable.dispose()`

const fWorkbook = univerAPI.getActiveWorkbook();
const disposable = univerAPI.addEvent(univerAPI.Event.PivotTableFieldCollapseChanged, (params) => {
  const { pivotTableId, fieldId, isCollapsed } = params;  
  const pivotTable = fWorkbook.getPivotTableById(pivotTableId);
  const fieldSetting = pivotTable.getFieldSetting(fieldId);
  console.log(`The source name ${fieldSetting.sourceName} the display name ${fieldSetting.displayName}`);
});
 
// Remove the event listener, use `disposable.dispose()`

const fWorkbook = univerAPI.getActiveWorkbook();
const disposable = univerAPI.addEvent(univerAPI.Event.PivotTableFieldFilterChanged, (params) => {
  const { pivotTableId, fieldId, filter } = params;
  const pivotTable = fWorkbook.getPivotTableById(pivotTableId);
  const fieldSetting = pivotTable.getFieldSetting(fieldId);
  console.log(`The Checklist filter value is ${fieldSetting.filterInfo.checklist}`);
});
 
// Remove the event listener, use `disposable.dispose()`

const fWorkbook = univerAPI.getActiveWorkbook();
const disposable = univerAPI.addEvent(univerAPI.Event.PivotTableFieldSortChanged, (params) => {
  const { pivotTableId, fieldId, sort } = params;
  const pivotTable = fWorkbook.getPivotTableById(pivotTableId);
  const fieldSetting = pivotTable.getFieldSetting(fieldId);
  console.log(`The sort info is ${fieldSetting.sortInfo}`);
});
 
// Remove the event listener, use `disposable.dispose()`

const fWorkbook = univerAPI.getActiveWorkbook();
const disposable = univerAPI.addEvent(univerAPI.Event.PivotTableFieldSettingChanged, (params) => {
  const { pivotTableId, fieldId, setting } = params;
  const pivotTable = fWorkbook.getPivotTableById(pivotTableId);
  const fieldSetting = pivotTable.getFieldSetting(fieldId);
  console.log(`The source name ${fieldSetting.sourceName} the display name ${fieldSetting.displayName}`);
});
 
// Remove the event listener, use `disposable.dispose()`

const fWorkbook = univerAPI.getActiveWorkbook();
const disposable = univerAPI.addEvent(univerAPI.Event.PivotTableValuePositionChanged, (params) => {
  const { pivotTableId, valueId, position } = params;
  const pivotTable = fWorkbook.getPivotTableById(pivotTableId);
  const valueSetting = pivotTable.getValueSetting(valueId);
  console.log(`The source name ${valueSetting.sourceName} the display name ${valueSetting.displayName}`);
});
 
// Remove the event listener, use `disposable.dispose()`