diff --git a/src/web/src/modules/app.dataset.ts b/src/web/src/modules/app.dataset.ts index c20c354..62b4256 100644 --- a/src/web/src/modules/app.dataset.ts +++ b/src/web/src/modules/app.dataset.ts @@ -3,12 +3,13 @@ import { VerticalXtype, HtapeXtype, LabelXtype, IconComboXtype, CodeEditorXtype, import { TableList } from './table_list/table_list'; import '../less/index.less'; import { DatabaseIndex } from './components/database_index/database_index'; -import { RedisDatasetModel } from './app.dataset.model'; +import { RedisModel, ParameterType } from './app.model'; +import { Preview } from './components/preview/preview'; import './app.less'; import { redisField } from './app.constant'; @shortcut() -@store(RedisDatasetModel) +@store(RedisModel) export class RedisDataset extends BI.Widget { static xtype = 'dec.dcm.connection.plugin.redis.dataset' private textWidth = 100; @@ -17,16 +18,19 @@ export class RedisDataset extends BI.Widget { queryCondition: any; tableList: TableList; parameterEditor: any; + previewButton: any; - store: RedisDatasetModel['store'] - model: RedisDatasetModel['model'] + store: RedisModel['store'] + model: RedisModel['model'] props = { value: { - database: '', - orderValue: '0', - query: '', - parameters: [], + datasetData: { + database: '', + orderValue: '0', + query: '', + parameters: [], + }, }, } @@ -34,10 +38,13 @@ export class RedisDataset extends BI.Widget { parameters: () => { this.parameterEditor.populate(this.renderItems(), [this.model.paramHeader]); }, + ablePreview: (ablePreview: boolean) => { + this.previewButton.setEnable(ablePreview); + }, } render() { - const { database, orderValue, query, parameters } = this.options.value; + const { database = '', orderValue = '0', query = '', parameters = [] } = this.options.value.datasetData || {}; this.store.setParameters(parameters); return { @@ -147,7 +154,7 @@ export class RedisDataset extends BI.Widget { text: BI.i18nText('Plugin-Redis_Refresh'), level: 'ignore', handler: () => { - Dec.Utils.getDataSetParameters(this.getValue(), res => { + Dec.Utils.getDataSetParameters(this.getParamSearchValue(), res => { const newParameters = BI.Services.getService('dec.service.data.set').getParameters(res.data, this.model.parameters); this.store.setParameters(newParameters); }); @@ -158,6 +165,13 @@ export class RedisDataset extends BI.Widget { el: { type: ButtonXtype, text: BI.i18nText('Plugin-Redis_Preview'), + disabled: !this.model.ablePreview, + handler: () => { + this.openPreview(); + }, + ref: (_ref: any) => { + this.previewButton = _ref; + }, }, width: 80, }], @@ -165,7 +179,7 @@ export class RedisDataset extends BI.Widget { type: ComponentsStyleTable, cls: 'param-table', height: 200, - columnSize: [250, 250, ''], + columnSize: [300, 300, ''], items: this.renderItems(), header: [this.model.paramHeader], ref: (_ref: any) => { @@ -197,13 +211,13 @@ export class RedisDataset extends BI.Widget { self.store.setParamType(index, this.getValue()[0]); }, }], - }, { - type: LabelXtype, - text: item.name, - textAlign: 'left', - height: 30, - lgap: 10, - }]); + }, this.createParameterValueItem(item, (value: string) => { + self.store.setParamValue(index, value); + })]); + } + + private createParameterValueItem(param: ParameterType, cb: Function) { + return BI.Services.getService('dec.service.data.set').createParameterValueItem(param, cb); } public getValue() { @@ -214,4 +228,25 @@ export class RedisDataset extends BI.Widget { parameters: this.model.parameters, }; } + + private getParamSearchValue() { + return { + datasetType: 'Redis', + datasetName: BI.get(this.model, 'dataSetName'), + datasetData: this.getValue(), + }; + } + + private openPreview() { + const id = BI.UUID(); + BI.Popovers.create(id, { + type: 'bi.popover', + width: 800, + height: 500, + body: { + type: Preview.xtype, + previewedDataSet: this.getParamSearchValue(), + }, + }).open(id); + } } diff --git a/src/web/src/modules/app.dataset.model.ts b/src/web/src/modules/app.model.ts similarity index 65% rename from src/web/src/modules/app.dataset.model.ts rename to src/web/src/modules/app.model.ts index c29f684..36fd240 100644 --- a/src/web/src/modules/app.dataset.model.ts +++ b/src/web/src/modules/app.model.ts @@ -1,30 +1,23 @@ import { model, Model } from './core/core'; import { redisParamHeader } from './app.constant'; @model() -export class RedisDatasetModel extends Model { - static xtype = 'dec.model.dcm.connection.plugin.redis.dataset' - +export class RedisModel extends Model { + static xtype = 'dec.model.dcm.connection.plugin.redis' context = ['dataSetName', 'ableSave'] state() { return { - parameters: [{ name: '123', type: 'String' }] as { - name: string; - type: string; - value: string; - }[], + parameters: [] as ParameterType[], + ablePreview: false, }; } actions = { setAbleSave(ableSave: boolean) { this.model.ableSave = ableSave; + this.model.ablePreview = ableSave; }, - setParameters: (parameters: { - name: string; - type: string; - value: string; - }[]) => { + setParameters: (parameters: ParameterType[]) => { this.model.parameters = parameters; }, setParamType: (index: number, type: string) => { @@ -34,6 +27,9 @@ export class RedisDatasetModel extends Model { this.model.parameters.splice(0, 0); } }, + setParamValue: (index: number, val: string) => { + this.model.parameters[index].value = val; + }, } computed = { @@ -44,3 +40,10 @@ export class RedisDatasetModel extends Model { }, item)), } } + + +export interface ParameterType { + name: string; + type: string; + value: string; +} diff --git a/src/web/src/modules/app.program.ts b/src/web/src/modules/app.program.ts index 7d4d6a6..5437b4d 100644 --- a/src/web/src/modules/app.program.ts +++ b/src/web/src/modules/app.program.ts @@ -3,12 +3,13 @@ import { VerticalXtype, HtapeXtype, LabelXtype, IconComboXtype, TextValueComboXt import { TableList } from './table_list/table_list'; import '../less/index.less'; import { DatabaseIndex } from './components/database_index/database_index'; -import { RedisDatasetModel } from './app.dataset.model'; +import { RedisModel, ParameterType } from './app.model'; import './app.less'; import { redisField } from './app.constant'; +import { Preview } from './components/preview/preview'; @shortcut() -@store(RedisDatasetModel) +@store(RedisModel) export class RedisProgram extends BI.Widget { static xtype = 'dec.dcm.connection.plugin.redis.program' private textWidth = 100; @@ -18,17 +19,21 @@ export class RedisProgram extends BI.Widget { tableList: TableList; parameterEditor: any; engineTypeSelect: any; + previewButton: any; - store: RedisDatasetModel['store'] - model: RedisDatasetModel['model'] + + store: RedisModel['store'] + model: RedisModel['model'] props = { value: { - database: '', - orderValue: '0', - script: '', - engineType: 0, - parameters: [], + datasetData: { + database: '', + orderValue: '0', + script: '', + engineType: 0, + parameters: [], + }, }, } @@ -36,10 +41,13 @@ export class RedisProgram extends BI.Widget { parameters: () => { this.parameterEditor.populate(this.renderItems(), [this.model.paramHeader]); }, + ablePreview: (ablePreview: boolean) => { + this.previewButton.setEnable(ablePreview); + }, } render() { - const { database, orderValue, script, parameters, engineType } = this.options.value; + const { database = '', orderValue = '0', script = '', parameters = [], engineType = 0 } = this.options.value.datasetData || {}; this.store.setParameters(parameters); return { @@ -174,7 +182,7 @@ export class RedisProgram extends BI.Widget { text: BI.i18nText('Plugin-Redis_Refresh'), level: 'ignore', handler: () => { - Dec.Utils.getDataSetParameters(this.getValue(), res => { + Dec.Utils.getDataSetParameters(this.getParamSearchValue(), res => { const newParameters = BI.Services.getService('dec.service.data.set').getParameters(res.data, this.model.parameters); this.store.setParameters(newParameters); }); @@ -185,6 +193,13 @@ export class RedisProgram extends BI.Widget { el: { type: ButtonXtype, text: BI.i18nText('Plugin-Redis_Preview'), + disabled: !this.model.ablePreview, + handler: () => { + this.openPreview(); + }, + ref: (_ref: any) => { + this.previewButton = _ref; + }, }, width: 80, }], @@ -192,7 +207,7 @@ export class RedisProgram extends BI.Widget { type: ComponentsStyleTable, cls: 'param-table', height: 200, - columnSize: [250, 250, ''], + columnSize: [300, 300, ''], items: this.renderItems(), header: [this.model.paramHeader], ref: (_ref: any) => { @@ -230,7 +245,13 @@ export class RedisProgram extends BI.Widget { textAlign: 'left', height: 30, lgap: 10, - }]); + }, this.createParameterValueItem(item, (value: string) => { + self.store.setParamValue(index, value); + })]); + } + + private createParameterValueItem(param: ParameterType, cb: Function) { + return BI.Services.getService('dec.service.data.set').createParameterValueItem(param, cb); } public getValue() { @@ -242,4 +263,25 @@ export class RedisProgram extends BI.Widget { parameters: this.model.parameters, }; } + + private getParamSearchValue() { + return { + datasetType: 'RedisScript', + datasetName: BI.get(this.model, 'dataSetName'), + datasetData: this.getValue(), + }; + } + + private openPreview() { + const id = BI.UUID(); + BI.Popovers.create(id, { + type: 'bi.popover', + width: 800, + height: 500, + body: { + type: Preview.xtype, + previewedDataSet: this.getParamSearchValue(), + }, + }).open(id); + } } diff --git a/src/web/src/modules/components/database_index/database_index.service.ts b/src/web/src/modules/components/database_index/database_index.service.ts new file mode 100644 index 0000000..577f0bb --- /dev/null +++ b/src/web/src/modules/components/database_index/database_index.service.ts @@ -0,0 +1,44 @@ +import { BarPopoverXtype } from 'ui'; +import { fetchFormulaConfig } from '../../crud/crud.request'; + +/** + * 打开公式编辑框 + */ +export function openFormulaPopover(value: T, inserterType: string = BI.RegularFormulaInserter.xtype): Promise { + return new Promise((resolve, reject) => { + const id = BI.UUID(); + + let formulaPane: typeof BI.FormulaOpeartingPanel; + + BI.Popovers.create(id, { + type: BarPopoverXtype, + width: 900, + height: 600, + header: BI.i18nText('Plugin-JSON_Function_Definition'), + body: { + type: BI.FormulaOpeartingPanel.xtype, + configLoader: fetchFormulaConfig, + ref: (_ref: typeof BI.FormulaOpeartingPanel) => { + formulaPane = _ref; + }, + inserterType, + value, + }, + listeners: [{ + eventName: BI.Popover.EVENT_CANCEL, + action: () => { + reject(); + + BI.Popovers.remove(id); + }, + }, { + eventName: BI.Popover.EVENT_CONFIRM, + action: () => { + resolve(formulaPane.getValue() as T); + + BI.Popovers.remove(id); + }, + }], + }).open(id); + }); +} diff --git a/src/web/src/modules/components/database_index/database_index.ts b/src/web/src/modules/components/database_index/database_index.ts index 4da437f..3538a97 100644 --- a/src/web/src/modules/components/database_index/database_index.ts +++ b/src/web/src/modules/components/database_index/database_index.ts @@ -1,6 +1,7 @@ import { shortcut, store } from '@core/core'; import { TabXtype, TextEditorXtype } from 'ui'; import { DatabaseIndexModel } from './database_index.model'; +import { openFormulaPopover } from './database_index.service'; @shortcut() @store(DatabaseIndexModel) @@ -9,6 +10,7 @@ export class DatabaseIndex extends BI.Widget { databaseIndexTab: any; textEditor: any; + formulaPane: typeof BI.FormulaOpeartingPanel; model: DatabaseIndexModel['model'] store: DatabaseIndexModel['store'] @@ -52,6 +54,9 @@ export class DatabaseIndex extends BI.Widget { type: TextEditorXtype, allowBlank: true, value: this.model.inputValue, + ref: (_ref: typeof BI.FormulaOpeartingPanel) => { + this.formulaPane = _ref; + }, }; }, }; @@ -62,6 +67,11 @@ export class DatabaseIndex extends BI.Widget { public setSelect(value: string) { this.databaseIndexTab.setSelect(value); + if (value === 'formula') { + openFormulaPopover({ + formula: '', + }, BI.ComplexFormulaInserter.xtype); + } } public getValue() { diff --git a/src/web/src/modules/components/preview/preview.model.ts b/src/web/src/modules/components/preview/preview.model.ts new file mode 100644 index 0000000..73e6ec9 --- /dev/null +++ b/src/web/src/modules/components/preview/preview.model.ts @@ -0,0 +1,20 @@ +import { model, Model } from '@core/core'; +@model() +export class PreviewModel extends Model { + static xtype = 'plugin.model.report.redis.components.preview'; + + childContext = ['previewAble', 'previewedDataSet']; + + state() { + return { + previewAble: true, + previewedDataSet: {}, + }; + } + + actions = { + setPreviewedDataSet: (value: any) => { + this.model.previewedDataSet = value; + }, + } +} diff --git a/src/web/src/modules/components/preview/preview.ts b/src/web/src/modules/components/preview/preview.ts new file mode 100644 index 0000000..9041396 --- /dev/null +++ b/src/web/src/modules/components/preview/preview.ts @@ -0,0 +1,31 @@ +import { shortcut, store } from '@core/core'; +import { PreviewModel } from './preview.model'; + +@shortcut() +@store(PreviewModel) +export class Preview extends BI.Widget { + static xtype = 'plugin.report.redis.components.preview' + + store: PreviewModel['store'] + model: PreviewModel['model'] + + previewPane: any + + props = { + previewedDataSet: {}, + } + + render() { + this.store.setPreviewedDataSet(this.options.previewedDataSet); + + return { + type: 'dec.data.set.preview', + ref: (_ref: any) => { + this.previewPane = _ref; + }, + }; + } + created() { + this.previewPane.previewData(); + } +} diff --git a/src/web/src/modules/crud/crud.request.ts b/src/web/src/modules/crud/crud.request.ts index c559a0a..a59498a 100644 --- a/src/web/src/modules/crud/crud.request.ts +++ b/src/web/src/modules/crud/crud.request.ts @@ -1,15 +1,51 @@ import { requestGet } from './crud.service'; +import { formulaData } from './formulaData'; export function getConnectionlist(): Promise<{data?: Connection[]}> { return requestGet('/v10/config/connection/list'); } export function getTableList(database: string, pattern = ''): Promise<{data?: string[]}> { - return requestGet('com.fr.solution.plugin.db.redis.v10/redis/keys', { + return requestGet('plugin/private/com.fr.solution.plugin.db.redis.v10/redis/keys', { database, pattern, }); } +/** + * 获取公式框基本配置信息 + */ +export function fetchFormulaConfig(): Promise<{ + vars: { + text: string; + value: string; + type: string; + def: string; + }[]; + JSONs: { + def: string; + name: string; + type: string; + }[]; +}> { + // TODO 后台接口待完成 + return new Promise(resolve => { + resolve(formulaData); + }); +} + +/** + * 校验公式 + * @param formulaStr 公式 + */ +export function validateForumula(formulaStr: string): Promise<{ + validation: boolean; +}> { + // TODO 后台接口待完成 + return new Promise(resolve => { + resolve({ validation: true }); + }); +} + export interface Connection { connectionId: string; connectionType: string; diff --git a/src/web/src/modules/crud/formulaData.ts b/src/web/src/modules/crud/formulaData.ts new file mode 100644 index 0000000..0edb86f --- /dev/null +++ b/src/web/src/modules/crud/formulaData.ts @@ -0,0 +1,549 @@ +// 后期统一放置公式数据 +export const formulaData = { + vars: [ + { + text: '$$page_number', + value: '$$page_number', + type: 'VARS', + def: '当前的页数。', + }, + { + text: '$$totalPage_number', + value: '$$totalPage_number', + type: 'VARS', + def: '总页数。', + }, + ], + JSONs: [ + { + def: 'ABS(number): 返回指定数字的绝对值。绝对值是指没有正负符号的数值。Number:需要求出绝对值的任意实数。示例:ABS(-1.5)等于1.5。ABS(0)等于0。ABS(2.5)等于2.5。', + name: 'ABS', + type: 'MATH', + }, + { + def: 'ABS(number): 返回指定数字的绝对值。绝对值是指没有正负符号的数值。Number:需要求出绝对值的任意实数。示例:ABS(-1.5)等于1.5。ABS(0)等于0。ABS(2.5)等于2.5。', + name: 'ABS', + type: 'COMMON', + }, + { + def: 'acc_sum(x_agg(array),range)根据横纵轴或行列维度添加的字段对指标进行跨行累计的计算。第一个参数为用户计算的指标，该指标必须为聚合函数或聚合指标；第二个参数range为用户设置计算的范围，0为对所有行进行累计，1为对组内所有行进行累计示例：acc_sum(sum_agg(array),0)用户横轴轴拖拽销售日期（年分组），则该指标计算结果为，根据销售日期（年）对销量进行分组汇总，然后根据对所有行从上到下进行累加，获得每年的累计销量', + name: 'ACC_SUM', + type: 'TABLE_CAL', + }, + { + def: 'ACOS(number): 返回指定数值的反余弦值。反余弦值为一个角度，返回角度以弧度形式表示。Number:需要返回角度的余弦值。备注: 函数的参数必须在-1和1之间，包括-1和1。 返回的角度值在0和Pi之间。 如果要把返回的角度用度数来表示，用180/PI()乘返回值即可。示例:ACOS(1)等于0（弧度）。ACOS(0.5)等于1.047197551（Pi/3弧度）。ACOS(0.5)*180/PI()等于60（度）。', + name: 'ACOS', + type: 'MATH', + }, + { + def: 'AND(logical1,logical2,…): 当所有参数的值为真时，返回TRUE；当任意参数的值为假时，返回FALSE。Logical1,logical2,…:指1到30个需要检验TRUE或FALSE的条件值。备注: 参数必须是逻辑值，或是含有逻辑值的数组或引用。 如果数组或引用中含有文本或空的单元格，则忽略其值。 如果在指定的单元格区域中没有逻辑值，AND函数将返回错误信息*NAME?。示例:AND(1+7=8,5+7=12)等于TRUE。AND(1+7=8,5+7=11)等于FALSE。如果单元格A1到A4的值分别为TRUE、TRUE、FALSE和TRUE，则:AND(A1:A4)等于FALSE。如果单元格A5的值在0~50之间，则: AND(0 0,b > 0 or a > 0, b < 0时，公式直接成立；a < 0,b > 0, ATAN2(a,b)=PI()-ABS(ATAN(b/a))a < 0,b < 0, ATAN2(a,b)=ABS(ATAN(b/a))-PI() 当x_num与y_num都为0时，ATAN2返回错误信息*DIV/0!。 用角度制显示返回数值时，把返回数值乘以180/PI()。 返回值以弧度表示（返回值大于-pi且小于等于pi）。示例:ATAN2(-2,2)等于2.356194490192345（弧度制的3*pi/4）。ATAN2(2,2)等于0.785398163（弧度制的pi/4）。ATAN2(-2,2)*180/PI()等于135（角度制）。', + name: 'ATAN2', + type: 'MATH', + }, + { + def: 'AVG_AGG(array): 根据当前分析维度，动态返回指标字段的汇总平均值，生成结果为一动态数据列，行数与当前分析维度行数一致。\n array必须为非聚合函数公式返回的结果，可以是某指标字段、维度或指标字段与普通公式的计算结果。 \n 示例：用户横轴为维度字段\'日\'时，纵轴的计算字段AVG_AGG(销量)返回的值为每日的平均销量；当用户横轴为维度字段\'月\'时，AVG_AGG(销量)返回的值为每月的平均销量。', + name: 'AVG_AGG', + type: 'AGG', + }, + { + def: 'CEILING(number): 将参数number沿绝对值增大的方向，舍入为最接近的整数Number:指待舍入的数值。CEILING(-2.5)等于-3。CEILING(0.5)等于1。', + name: 'CEILING', + type: 'MATH', + }, + { + def: 'CHAR(number): 根据指定数字返回对应的字符。CHAR函数可将计算机其他类型的数字代码转换为字符。Number:用于指定字符的数字，介于1~65535之间（包括1和65535）。示例:CHAR(88)等于“X”。CHAR(45)等于“-”。', + name: 'CHAR', + type: 'TEXT', + }, + { + def: 'CODE(text): 计算文本串中第一个字符的数字代码。返回的代码对应于计算机使用的字符集。Text:需要计算第一个字符代码的文本或单元格引用。示例:CODE("S")等于83。CODE("Spreadsheet")等于83。', + name: 'CODE', + type: 'TEXT', + }, + { + def: 'CONCATENATE(text1,text2,...): 将数个字符串合并成一个字符串。Text1,text2,...:需要合并成单个文本的文本项，可以是字符，数字或是单元格引用。示例:CONCATENATE("Average ","Price")等于“Average Price”。CONCATENATE("1","2")等于12。', + name: 'CONCATENATE', + type: 'TEXT', + }, + { + def: 'COS(number): 返回一个角度的余弦值。Number:以弧度表示的需要求余弦值的角度。备注: 要把一个角度转换成弧度值，将角度乘于PI()/180。 COS(n*2*PI()+number)=COS(number)（其中n为整数，number从-pi到pi）。示例:COS(0.5)等于0.877582562。COS(30*PI()/180)等于0.866025404。', + name: 'COS', + type: 'MATH', + }, + { + def: 'COUNTD_AGG(array): 根据当前分析维度，动态返回某字段的去重计数，生成结果为一动态数据列，行数与当前分析维度行数一致。\n "array必须为非聚合函数公式返回的结果，可以是某指标字段、维度或指标字段与普通公式的计算结果。\n "示例：用户横轴为维度字段\'日\'时，纵轴的计算字段COUNTD_AGG(销量)返回的值为每日的销量的去重个数；当用户横轴为维度字段\'月\'时，COUNTD_AGG(销量)返回的值为每月的销量的去重个数。"', + name: 'COUNTD_AGG', + type: 'AGG', + }, + { + def: 'COUNT_AGG(array): 根据当前分析维度，动态返回某字段的计数，生成结果为一动态数据列，行数与当前分析维度行数一致。\n array必须为非聚合函数公式返回的结果，可以是某指标字段、维度或指标字段与普通公式的计算结果。\n 示例：用户横轴为维度字段\'日\'时，纵轴的计算字段COUNT_AGG(销量)返回的值为每日的销量的个数；当用户横轴为维度字段\'月\'时，COUNT_AGG(销量)返回的值为每月的销量的个数。', + name: 'COUNT_AGG', + type: 'AGG', + }, + { + def: 'DATE(year,month,day): 返回一个表示某一特定日期的系列数。Year:代表年，可为一到四位数。Month:代表月份。若1 month 12，则函数把参数值作为月。若month>12，则函数从年的一月份开始往上累加。例如: DATE(2000,25,2)等于2002年1月2日的系列数。Day:代表日。若日期小于等于某指定月的天数，则函数将此参数值作为日。若日期大于某指定月的天数，则函数从指定月份的第一天开始往上累加。若日期大于两个或多个月的总天数，则函数把减去两个月或多个月的余数加到第三或第四个月上，依此类推。例如:DATE(2000,3,35)等于2000年4月4日的系列数。备注: 若需要处理公式中日期的一部分，如年或月等，则可用此公式。 若年，月和日是函数而不是函数中的常量，则此公式最能体现其作用。示例:DATE(1978, 9, 19) 等于1978-09-19.DATE(1211, 12, 1) 等于1211-12-01. ', + name: 'DATE', + type: 'DATETIME', + }, + { + def: 'DATEDELTA(date, deltadays):返回一个日期date后deltadays的日期。deltaDays可以为正值，负值，零。示例：DATEDELTA("2008-08-08", -10)等于2008-07-29。DATEDELTA("2008-08-08", 10)等于2008-08-18。', + name: 'DATEDELTA', + type: 'DATETIME', + }, + { + def: 'DATEDIF(start_date,end_date,unit):返回两个指定日期间的天数、月数或年数。Start_date:代表所指定时间段的初始日期。End_date:代表所指定时间段的终止日期。Unit:函数返回信息的类型。若unit=“Y”，则DATEDIF返回指定时间段的年差数。若unit=“M”，则DATEDIF返回指定时间段的月差数。若unit=“D”，则DATEDIF返回指定时间段的日差数。若unit=“MD”，则DATEDIF忽略年和月，返回指定时间段的日差数。若unit=“YM”，则DATEDIF忽略年和日，返回指定时间段的月差数。若unit=“YD”，则DATEDIF忽略年，返回指定时间段的日差数。示例:DATEDIF("2001/2/28","2004/3/20","Y")等于3，即在2001年2月28日与2004年3月20日之间有3个整年。DATEDIF("2001/2/28","2004/3/20","M")等于37，即在2001年2月28日与2004年3月20日之间有36个整月。DATEDIF("2001/2/28","2004/3/20","D")等于1116，即在2001年2月28日与2004年3月20日之间有1116个整天。DATEDIF("2001/2/28","2004/3/20","MD")等于8，即忽略月和年后，2001年2月28日与2004年3月20日的差为8天。DATEDIF("2001/1/28","2004/3/20","YM")等于2，即忽略日和年后，2001年1月28日与2004年3月20日的差为2个月。DATEDIF("2001/2/28","2004/3/20","YD")等于21，即忽略年后，2001年2月28日与2004年3月20日的差为21天。', + name: 'DATEDIF', + type: 'DATETIME', + }, + { + def: 'DATESUBDATE(date1, date2, op):返回两个日期之间的时间差。op表示返回的时间单位："s"，以秒为单位。"m"，以分钟为单位。"h"，以小时为单位。"d"，以天为单位。"w"，以周为单位。示例：DATESUBDATE("2008-08-08", "2008-06-06","h")等于1512。', + name: 'DATESUBDATE', + type: 'DATETIME', + }, + { + def: 'DATETONUMBER(date):返回自 1970 年 1 月 1 日 00:00:00 GMT 经过的毫秒数。示例：DATETONUMBER("2008-08-08")等于1218124800000。', + name: 'DATETONUMBER', + type: 'DATETIME', + }, + { + def: 'DAY:(serial_number)返回日期中的日。DAY是介于1和31之间的一个数。Serial_number:含有所求的年的日期.备注:FineReport将日期保存为系列数，一个系列数代表一个与之匹配的日期，以方便用户对日期进行数值式计算。在1900年日期系统中，FineReport电子表格将1900年1月1日保存为系列数2，将1900年1月2日保存为系列数3，将1900年1月3日保存为系列数4……依此类推。如在1900年日期系统，1998年1月1日存为系列数35796。示例:DAY("2000/1/1")等于1。DAY("2006/05/05")等于5。DAY("1997/04/20")等于20。DAY("2000-1-1", "yyyy-MM-dd")等于1。DAY("2006-05-05", "yyyy-MM-dd")等于5。DAY("1997-04-20", "yyyy-MM-dd")等于20。DAY(35796)等于1。', + name: 'DAY', + type: 'DATETIME', + }, + { + def: 'DAYS360(start_date,end_date,method):按照一年 360 天的算法（每个月以 30 天计，一年共计 12 个月），返回两日期间相差的天数，这在会计计算中将会用到。如果财务系统是基于一年 12 个月，每月 30 天，可用此函数帮助计算支付款项。Start_date 和 end_date :是用于计算期间天数的起止日期。Method : 它指定了在计算中是采用欧洲方法还是美国方法。Method 定义 :FALSE或忽略 美国方法 (NASD)。如果起始日期是一个月的 31 号，则等于同月的 30 号。如果终止日期是一个月的31号，并且起始日期早于 30 号，则终止日期等于下一个月的 1 号，否则，终止日期等于本月的 30 号。TRUE 欧洲方法。无论是起始日期还是终止日期为一个月的 31 号，都将等于本月的 30 号。备注:FineReport将日期保存为系列数，一个系列数代表一个与之匹配的日期，以方便用户对日期进行数值式计算。在1900年日期系统中，FineReport电子表格将1900年1月1日保存为系列数2，将1900年1月2日保存为系列数3，将1900年1月3日保存为系列数4……依此类推。如在1900年日期系统，1998年1月1日存为系列数35796。示例:DAYS360("1998/1/30", "1998/2/1") 等于 1', + name: 'DAYS360', + type: 'DATETIME', + }, + { + def: 'DAYSOFMONTH(date):返回从1900年1月后某年某月包含的天数。示例：DAYSOFMONTH("1900-02-01")等于28。DAYSOFMONTH("2008/04/04")等于30。', + name: 'DAYSOFMONTH', + type: 'DATETIME', + }, + { + def: 'DAYSOFQUARTER(date): 返回从1900年1月后某年某季度的天数。示例：DAYSOFQUARTER("2009-02-01")等于90。DAYSOFQUARTER("2009/05/05")等于91。', + name: 'DAYSOFQUARTER', + type: 'DATETIME', + }, + { + def: 'DAYSOFYEAR(year):返回某年包含的天数。示例：DAYSOFYEAR(2008)等于365，等价于DAYSOFYEAR("2008-01-01")。', + name: 'DAYSOFYEAR', + type: 'DATETIME', + }, + { + def: 'DAYVALUE(date):返回1900年至 date日期所经历的天数。示例：DAYVALUE("2008/08/08")等于39669。', + name: 'DAYVALUE', + type: 'DATETIME', + }, + { + def: 'DEGREES(angle): 将弧度转化为度。angle:待转换的弧度角。示例:DEGREES(PI()/2)等于90。DEGREES(3.1415926)等于179.9999969。', + name: 'DEGREES', + type: 'MATH', + }, + { + def: 'ENDWITH(str1，str2):判断字符串str1是否以str2结束。备注: str1和str2都是大小写敏感的。示例:ENDWITH("FineReport","Report")等于true。ENDWITH("FineReport","Fine")等于false。ENDWITH("FineReport","report")等于false。', + name: 'ENDWITH', + type: 'TEXT', + }, + { + def: 'EXACT(text1,text2): 检测两组文本是否相同。如果完全相同，EXACT函数返回TRUE；否则，返回FALSE。EXACT函数可以区分大小写，但忽略格式的不同。同时也可以利用EXACT函数来检测输入文档的文字。Text1:需要比较的第一组文本。Text2:需要比较的第二组文本。示例:EXACT("Spreadsheet","Spreadsheet")等于TRUE。EXACT("Spreadsheet","S preadsheet")等于FALSE。EXACT("Spreadsheet","spreadsheet")等于FALSE。', + name: 'EXACT', + type: 'TEXT', + }, + { + def: 'EXP(number): 返回e的n次幂。常数e为自然对数的底数，等于2.71828182845904。Number:为任意实数，作为常数e的指数。备注: 如果要返回其他常数作为底数的幂，可以使用指数运算符（^）。例如: 在4^2中，4是底数，而2是指数。 EXP函数与LN函数互为反函数。示例:EXP(0)等于1。EXP(3)等于20.08553692。EXP(LN(2))等于2。', + name: 'EXP', + type: 'MATH', + }, + { + def: 'FACT(number):返回数的阶乘，一个数的阶乘等于 1*2*3*...*该数。number:要计算其阶乘的非负数。如果输入的 number 不是整数，则截尾取整。示例:FACT(1) 等于 1FACT(1.9) 等于 FACT(1) 等于 1FACT(0) 等于 1FACT(5) 等于 1*2*3*4*5 等于 120', + name: 'FACT', + type: 'MATH', + }, + { + def: 'FIND(find_text,within_text,start_num):从指定的索引(start_num)处开始，返回第一次出现的指定子字符串(find_text)在此字符串(within_text)中的索引。Find_text:需要查找的文本或包含文本的单元格引用。Within_text:包含需要查找文本的文本或单元格引用。Start_num:指定进行查找字符的索引位置。within_text里的索引从1开始。如果省略start_num，则假设值为1。备注: 如果find_text不在within_text中，FIND函数返回值为0。 如果start_num不大于0，FIND函数返回错误信息*VALUE!。 如果start_num大于within_text的长度，FIND函数返回值为0。 如果find_text是空白文本，FIND函数将在搜索串中匹配第一个字符（即编号为start_num或1的字符）。示例:FIND("I","Information")等于1。FIND("i","Information")等于9。FIND("o","Information",2)等于4。FIND("o","Information",12)等于0。FIND("o","Information",-1)等于*VALUE!。', + name: 'FIND', + type: 'TEXT', + }, + { + def: 'FLOOR(number): 将参数number沿绝对值减小的方向去尾舍入。Number:待舍入的数值。示例:FLOOR(-2.5)等于-2。FLOOR(2.5)等于2。', + name: 'FLOOR', + type: 'MATH', + }, + { + def: 'FORMAT(object,format) : 返回object的format格式。object 需要被格式化对象，可以是String，数字，Object(常用的有Date, Time)。format 格式化的样式。示例FORMAT(1234.5, "#,##0.00") => 1234.50FORMAT(1234.5, "#,##0") => 1234FORMAT(1234.5, "￥#,##0.00") => ￥1234.50FORMAT(1.5, "0%") => 150%FORMAT(1.5, "0.000%") => 150.000%FORMAT(6789, "##0.0E0") => 6.789E3FORMAT(6789, "0.00E00") => 6.79E03FORMAT(date(2007,1,1), "EEEEE, MMMMM dd, yyyy") => 星期一，一月 01，2007FORMAT(date(2007,1,13), "MM/dd/yyyy") => 01/13/2007FORMAT(date(2007,1,13), "M-d-yy") => 1-13-07FORMAT(time(16,23,56), "h:mm:ss a") => 4:23:56 下午', + name: 'FORMAT', + type: 'TEXT', + }, + { + def: 'HOUR(serial_number):返回某一指定时间的小时数。函数指定HOUR为0（0:00）到23（23:00)之间的一个整数。Serial_number:包含所求小时的时间。示例:HOUR("11:32:40")等于11。HOUR("11:32:40", "HH:mm:ss")等于11。', + name: 'HOUR', + type: 'DATETIME', + }, + { + def: 'IF(boolean,number1/string1,number2/string2):判断函数,boolean为true时返回第二个参数,为false时返回第三个。boolean: 用于判断的布尔值,true或者false。number1/string1: 第一个参数，如果boolean为ture,返回这个值。number2/string2: 第二个参数，如果boolean为false,返回这个值。示例:IF(true,2,8)等于2IF(false,"first","second")等于secondIF(true,"first",7)等于first', + name: 'IF', + type: 'LOGIC', + }, + { + def: 'IF(boolean,number1/string1,number2/string2):判断函数,boolean为true时返回第二个参数,为false时返回第三个。boolean: 用于判断的布尔值,true或者false。number1/string1: 第一个参数，如果boolean为ture,返回这个值。number2/string2: 第二个参数，如果boolean为false,返回这个值。示例:IF(true,2,8)等于2IF(false,"first","second")等于secondIF(true,"first",7)等于first', + name: 'IF', + type: 'COMMON', + }, + { + def: 'INDEXOF(str1，index):返回字符串str1在index位置上的字符。备注: index是从0开始计数的。示例:INDEXOF("FineReport",0)等于\'F\'。INDEXOF("FineReport",2)等于\'n\'。INDEXOF("FineReport",9)等于\'t\'。INDEXOF(array, index):返回数组在index位置上的元素。备注： index是从1开始计数的。示例：String[] array = {"a", "b", "c"}INDEXOF(array, 1)等于"a".', + name: 'INDEXOF', + type: 'TEXT', + }, + { + def: 'INT(number): 返回数字下舍入（数值减小的方向）后最接近的整数值。Number:需要下舍入为整数的实数。示例:INT(4.8)等于4。INT(-4.8)等于-5。INT(4.3)等于4。INT(-4.3)等于-5。公式INT(A1)将返回A1单元格中的一个正实数的整数数部分。', + name: 'INT', + type: 'MATH', + }, + { + def: 'INT(number): 返回数字下舍入（数值减小的方向）后最接近的整数值。Number:需要下舍入为整数的实数。示例:INT(4.8)等于4。INT(-4.8)等于-5。INT(4.3)等于4。INT(-4.3)等于-5。公式INT(A1)将返回A1单元格中的一个正实数的整数数部分。', + name: 'INT', + type: 'COMMON', + }, + { + def: 'ISNULL(object):判断对象中所有的值是否全部都是NULL或者为空字符串。', + name: 'ISNULL', + type: 'OTHER', + }, + { + def: 'LEFT(text,num_chars): 根据指定的字符数返回文本串中的第一个或前几个字符。Text:包含需要选取字符的文本串或单元格引用。Num_chars:指定返回的字符串长度。备注: Num_chars的值必须等于或大于0。 如果num_chars大于整个文本的长度，LEFT函数将返回所有的文本。 如果省略num_chars，则默认值为1。示例:LEFT("Fine software",8)等于“Fine sof”。LEFT("Fine software")等于“F”。如果单元格A3中含有“China”，则LEFT(A3,2)等于“Ch”。', + name: 'LEFT', + type: 'TEXT', + }, + { + def: 'LEN(args): 返回文本串中的字符数或者数组的长度。需要注意的是：参数args为文本串时，空格也计为字符。参数args为数组时，直接返回数组长度。示例:LEN("Evermore software")等于17。LEN(" ")等于1。LEN([\'a\',\'b\'])等于2。', + name: 'LEN', + type: 'TEXT', + }, + { + def: 'LN(number):返回一个数的自然对数。自然对数以常数项 e（2.71828182845904）为底。number:是用于计算其自然对数的正实数。示例:LN(86) 等于 4.45437LN(2.7182818) 等于 1LN(EXP(3)) 等于 3EXP(LN(4)) 等于 4', + name: 'LN', + type: 'MATH', + }, + { + def: 'LOG(number,base): 按指定的任意底数，返回数值的对数。Number:需要求对数的正实数。Base:对数的底数。如果省略底数，默认值为10。示例:LOG(16,2)等于4。LOG(10)等于1。LOG(24,3)等于2.892789261。', + name: 'LOG', + type: 'MATH', + }, + { + def: 'LOG10(number):返回以 10 为底的对数。number: 用于常用对数计算的正实数。示例:LOG10(86) 等于 1.934498451LOG10(10) 等于 1LOG10(1E5) 等于 5', + name: 'LOG10', + type: 'MATH', + }, + { + def: 'LOWER(text): 将所有的大写字母转化为小写字母。Text:需要转化为小写字母的文本串。LOWER函数不转化文本串中非字母的字符。示例:LOWER("A.M.10:30")等于“a.m.10:30”。LOWER("China")等于“china”。', + name: 'LOWER', + type: 'TEXT', + }, + { + def: 'LUNAR(year,day,month): 返回当前日期对应的农历时间。year,month,day:分别对应年月日。示例:如果需要查询2011年7月21日对应的农历时间，则只需输入LUNAR(2011,7,21)结果将显示为：辛卯年六月廿一同样，如输入LUNAR(2001,7,21)，则显示：辛巳年六月初一 。本公式支持的时间段为1900-2100年。', + name: 'LUNAR', + type: 'DATETIME', + }, + { + def: 'MAX(number1,number2,…): 返回参数列表中的最大值。Number1,number2,…:1到30个需要找出最大值的参数。备注: 参数可以是数字、空白单元格、逻辑值或数字的文本表达式。 如果数组或引用参数中包含可解析文本值，逻辑值，零值或空白单元格，这些值都将参与计算，而不可解析的文本值忽略不计。 如果参数中没有任何数字，MAX将返回0。示例:MAX(0.1,0,1.2)等于1.2。', + name: 'MAX', + type: 'MATH', + }, + { + def: 'MAX_AGG(array): 根据当前分析维度，动态返回指标字段的最大值，生成结果为一动态数据列，行数与当前分析维度行数一致。\n "array必须为非聚合函数公式返回的结果，可以是某指标字段、维度或指标字段与普通公式的计算结果。\n "示例：用户横轴为维度字段\'日\'时，纵轴的计算字段MAX_AGG(销量)返回的值为每日的最大值销量；当用户横轴为维度字段\'月\'时，MAX_AGG(销量)返回的值为每月的最大值销量。', + name: 'MAX_AGG', + type: 'AGG', + }, + { + def: 'MEDIAN_AGG(array): 根据当前分析维度，动态返回指标字段的中位数，生成结果为一动态数据列，行数与当前分析维度行数一致。\n "array必须为非聚合函数公式返回的结果，可以是某指标字段、维度或指标字段与普通公式的计算结果。\n "示例：用户横轴为维度字段\'日\'时，纵轴的计算字段MEDIAN_AGG(销量)返回的值为每日的中位数销量；当用户横轴为维度字段\'月\'时，MEDIAN_AGG(销量)返回的值为每月的中位数销量。', + name: 'MEDIAN_AGG', + type: 'AGG', + }, + { + def: 'MID(text,start_num,num_chars): 返回文本串中从指定位置开始的一定数目的字符，该数目由用户指定。Text:包含要提取字符的文本串。Start_num:文本中需要提取字符的起始位置。文本中第一个字符的start_num为1，依此类推。Num_chars:返回字符的长度。备注: 如果start_num大于文本长度，MID函数返回“”（空文本）。 如果start_num小于文本长度，并且start_num加上num_chars大于文本长度，MID函数将从start_num指定的起始字符直至文本末的所有字符。 如果start_num小于1，MID函数返回错误信息*VALUE!。 如果num_chars是负数，MID函数返回错误信息*VALUE!。示例:MID("Finemore software",10,8)返回“software”。MID("Finemore software",30,5)返回“”（空文本）。MID("Finemore software",0,8)返回*VALUE!。MID("Finemore software",5,-1)返回*VALUE!。', + name: 'MID', + type: 'TEXT', + }, + { + def: 'MIN(number1,number2,…): 返回参数列表中的最小值。Number1,number2,…:1到30个需要找出最小值的参数。备注: 若参数中没有数字，函数MIN将返回0。 参数应为数字、空白单元格、逻辑值或是表示数值的文本串。如果参数是错误值时，MIN将返回错误信息。 如果数组或引用参数中包含可解析文本值，逻辑值，零值或空白单元格，这些值都将参与计算，而不可解析的文本值忽略不计。示例:如果B1:B4包含3，6，9，12，则:MIN(B1:B4)等于3。MIN(B1:B4,0)等于0。', + name: 'MIN', + type: 'MATH', + }, + { + def: 'MINUTE(serial_number):返回某一指定时间的分钟数，其值是介于0与59之间的一个整数。serial_number:包含所求分钟数的时间。示例:MINUTE("15:36:25")等于36。MINUTE("15:36:25", "HH:mm:ss")等于36。', + name: 'MINUTE', + type: 'DATETIME', + }, + { + def: 'MIN_AGG(array): 根据当前分析维度，动态返回指标字段的最小值，生成结果为一动态数据列，行数与当前分析维度行数一致。\n "array必须为非聚合函数公式返回的结果，可以是某指标字段、维度或指标字段与普通公式的计算结果。\n "示例：用户横轴为维度字段\'日\'时，纵轴的计算字段MIN_AGG(销量)返回的值为每日的最小值销量；当用户横轴为维度字段\'月\'时，MIN_AGG(销量)返回的值为每月的最小值销量。', + name: 'MIN_AGG', + type: 'AGG', + }, + { + def: 'MOD(number,divisor):返回两数相除的余数。结果的正负号与除数相同。number:为被除数。divisor:为除数。示例:MOD(3, 2) 等于 1MOD(-3, 2) 等于 1MOD(3, -2) 等于 -1MOD(-3, -2) 等于 -1', + name: 'MOD', + type: 'MATH', + }, + { + def: 'MONTH:(serial_number)返回日期中的月。月是介于1和12之间的一个数。Serial_number:含有所求的月的日期.备注:FineReport将日期保存为系列数，一个系列数代表一个与之匹配的日期，以方便用户对日期进行数值式计算。在1900年日期系统中，FineReport电子表格将1900年1月1日保存为系列数2，将1900年1月2日保存为系列数3，将1900年1月3日保存为系列数4……依此类推。如在1900年日期系统，1998年1月1日存为系列数35796。示例:MONTH("2000/1/1")等于1。MONTH("2006/05/05")等于5。MONTH("1997/04/20")等于4。MONTH("2000-1-1", "yyyy-MM-dd")等于1。MONTH("2006-05-05", "yyyy-MM-dd")等于5。MONTH("1997-04-20", "yyyy-MM-dd")等于4。MONTH(35796)等于1。', + name: 'MONTH', + type: 'DATETIME', + }, + { + def: 'MONTHDELTA(date,delta):返回指定日期date后delta个月的日期。示例：MONTHDELTA("2008-08-08", 4)等于2008-12-08。', + name: 'MONTHDELTA', + type: 'DATETIME', + }, + { + def: 'NOW():获取当前时间。示例：如果系统时间是2012年5月12日 15点18分38秒则NOW()等于2012-05-12 15:18:36。', + name: 'NOW', + type: 'DATETIME', + }, + { + def: 'NUMTO(number,bool)或NUMTO(number):返回number的中文表示。其中bool用于选择中文表示的方式，当没有bool时采用默认方式显示。示例：NUMTO(2345,true)等于二三四五。示例：NUMTO(2345,false)等于二千三百四十五。示例：NUMTO(2345)等于二千三百四十五。', + name: 'NUMTO', + type: 'TEXT', + }, + { + def: 'NVL(value1,value2,value3,...):在所有参数中返回第一个不是null的值value1:可以为任意数，也可以为null。value2:可以为任意数，也可以为null。当字符串长度为0时, 返回也为null示例:NVL(12,20)等于12。NVL(null,12)等于12。NVL(null,null)等于null。NVL(20,null)等于20。NVL(null,null,10)等于10。', + name: 'NVL', + type: 'OTHER', + }, + { + def: 'OR(logical1,logical2,…): 当所有参数的值为假时，返回FALSE；当任意参数的值为真时，返回TRUE。Logical1,logical2,…:指1到30个需要检验TRUE或FALSE的条件值。备注: 参数必须是逻辑值，或是含有逻辑值的数组或引用。 如果数组或引用中含有文本或空的单元格，则忽略其值。 如果在指定的单元格区域中没有逻辑值，AND函数将返回错误信息*NAME?。示例:OR(1+7=9,5+7=11)等于FALSE。OR(1+7=8,5+7=11)等于TRUE。', + name: 'OR', + type: 'LOGIC', + }, + { + def: 'period_anls(x_agg(array)，datepart)根据横纵轴或行列维度添加的日期字段进行上期末的计算。第一个参数为用于计算的指标，该指标必须为聚合函数或聚合指标；第二个参数用于配置计算的上期末为上年期末或者上月期末。横纵轴拖拽的字段不满足函数的计算要求时，该指标会标红。示例：period_anls(sum_agg(amount),"Y") 用户横纵轴拖拽销售日期（年月日分组），则该指标计算结果为，根据年月日对销量进行分组汇总，然后计算出该日数据上年年末的销量；如果参数2为“M”，则计算结果为该日销量上月月末的销量。', + name: 'PERIOD_ANLS', + type: 'TABLE_CAL', + }, + { + def: 'PI(number): 是一个数学常量函数，当number为空时，函数返回精确到15位的数值3.141592653589793；当参数不为空时，number表示PI的倍数。示例:SIN(PI()/2)等于1。计算圆的面积的公式: S=PI()*(r^2)，其中S为圆的面积，R为圆的半径。PI(3)等于9.42477796076938。', + name: 'PI', + type: 'MATH', + }, + { + def: 'POWER(number,power): 返回指定数字的乘幂。Number:底数，可以为任意实数。Power:指数。参数number按照该指数次幂乘方。备注: 可以使用符号“^”代替POWER，如: POWER(5,2)等于5^2。示例:POWER(6,2)等于36。POWER(14,5)等于537824。POWER(4,2/3)等于2.519842100。POWER(3,-2.3)等于0.079913677。', + name: 'POWER', + type: 'MATH', + }, + { + def: 'previous_period(x_agg(array))根据横纵轴或行列维度添加的日期字段进行环期值的计算。参数为用于计算的指标，该指标必须为聚合函数或聚合指标。横纵轴拖拽的字段不满足函数的计算要求时，该指标会标红。示例：previous_period(sum_agg(amount)) 用户横纵轴拖拽销售日期（年月日分组），则该指标计算结果为，根据年月日对销量进行分组汇总，然后计算出该日数据上一日的销量。', + name: 'PREVIOUS_PERIOD', + type: 'TABLE_CAL', + }, + { + def: 'PROMOTION(value1,value2):返回value2在value1上提升的比例。示例：PROMOTION(12, 14)等于0.166666666，即提升了16.6666666%.PROMOTION(-12, 14)等于2.166666666，即提升了216.6666666%.', + name: 'PROMOTION', + type: 'MATH', + }, + { + def: 'PROPER(text): 将文本中的第一个字母和所有非字母字符后的第一个字母转化成大写，其他字母变为小写。Text:需要转化为文本的公式、由双引号引用的文本串或是单元格引用。示例:PROPER("Finemore Integrated Office")等于“Finemore Integrated Office”。PROPER("100 percent")等于“100 Percent”。PROPER("SpreaDSheEt")等于“Spreadsheet”。', + name: 'PROPER', + type: 'TEXT', + }, + { + def: 'RADIANS(angle): 将角度转换成弧度。Angle:需要转换为弧度的角度。示例:RADIANS(90)等于1.570796327。', + name: 'RADIANS', + type: 'MATH', + }, + { + def: 'RAND(): 返回均匀分布的随机数。每计算一次工作表，函数都会返回一个新的随机数值。备注: 要生成一个位于a和b之间的随机数，可以使用以下的公式: C=RAND()*(b-a)+a。 如果要使一个随机产生的数值不随单元格的重计算而改变，可以在编辑框中输入=RAND()并保持编辑状态，然后按F9，将公式永久性地改为随机数。示例:假如需要生成一个大于等于0，小于60的随机数，使用公式: =RAND()*60。假如需要生成一个大于等于0，小于19的随机数，使用公式: =RAND()*19。假如需要生成一个大于等于0，小于50的随机数，使用公式: =RAND()*50。', + name: 'RAND', + type: 'MATH', + }, + { + def: 'RANDBETWEEN(value1,value2):返回value1和value2之间的一个随机整数。示例：RANDBETWEEN(12.333, 13.233)只会返回13。RANDBETWEEN(11.2, 13.3)有可能返回12或者13。', + name: 'RANDBETWEEN', + type: 'MATH', + }, + { + def: 'rank_anls(x_agg(array),range,order)根据横纵轴或行列维度添加的字段对指标进行跨行排名的计算。第一个参数为用户计算的指标，该指标必须为聚合函数或聚合指标；第二个参数range为用户设置计算的范围，0为对所有行进行排名，1为对组内所有行进行排名；第三个参数order为排名的计算规则，"asc"为升序排名，"desc"为降序排名。示例：rank_anls(sum_agg(amount),0,"asc")用户横轴轴拖拽省份，则该指标计算结果为，根据省份对销量进行分组汇总，然后计算每个省份的销量在所有省份中的升序排名情况。', + name: 'RANK_ANLS', + type: 'TABLE_CAL', + }, + { + def: 'REGEXP(str, pattern):字符串str是否与正则表达式pattern相匹配。示例：REGEXP("aaaaac","a*c")等于true。REGEXP("abc","a*c")等于false。REGEXP(str, pattern, intNumber):字符串str是否与具有给定模式 intNumber的正则表达式pattern相匹配。示例：CASE_INSENSITIVE = 0 启用不区分大小写的匹配。 默认情况下，不区分大小写的匹配假定仅匹配 US-ASCII 字符集中的字符。可以通过指 定 UNICODE_CASE 标志连同此标志来启用 Unicode 感知的、不区分大小写的匹配。 MULTILINE = 1 启用多行模式。DOTALL = 2 启用 dotall 模式。在 dotall 模式中，表达式 . 可以匹配任何字符，包括行结束符。默认情况下，此表达式不匹配行 结束符。UNICODE_CASE = 3 启用 Unicode 感知的大小写折叠。指定此标志后，由 CASE_INSENSITIVE 标志启用时，不区分大小写的匹配将以 符合 Unicode Standard 的方式完成。CANON_EQ = 4 启用规范等价。 指定此标志后，当且仅当其完整规范分解匹配时，两个字符才可视为匹配。UNIX_LINES = 5 启用 Unix 行模式。 在此模式中，.、^ 和 $ 的行为中仅识别 \'\n\' 行结束符。LITERAL = 6 启用模式的字面值解析。 指定此标志后，指定模式的输入字符串就会作为字面值字符序列来对待。输入序列中的 元字符或转义序列不具有任何特殊意义。 标志 CASE_INSENSITIVE 和 UNICODE_CASE 在与此标志一起使用时将 对匹配产生影响。其他标志都变得多余了。COMMENTS = 7 模式中允许空白和注释。 此模式将忽略空白和在结束行之前以 # 开头的嵌入式注释。 REGEXP("Aaaaabbbbc","a*b*c", 3)等于true。REGEXP("Aaaaabbbbc","a*b*c", 1)等于false。', + name: 'REGEXP', + type: 'TEXT', + }, + { + def: 'REPEAT(text,number_times): 根据指定的次数重复显示文本。REPEAT函数可用来显示同一字符串，并对单元格进行填充。Text:需要重复显示的文本或包含文本的单元格引用。Number_times:指定文本重复的次数，且为正数。如果number_times为0，REPEAT函数将返回“”（空文本）。如果number_times不是整数，将被取整。REPEAT函数的最终结果通常不大于32767个字符。备注: 该函数可被用于在工作表中创建简单的直方图。示例:REPEAT("$",4)等于“$$$$”。如果单元格B10的内容为“你好”，REPEAT(B10,3)等于“你好你好你好”。', + name: 'REPEAT', + type: 'TEXT', + }, + { + def: 'REPLACE(text, texttoreplace, replacetext):根据指定字符串，用其他文本来代替原始文本中的内容。text：需要被替换部分字符的文本或单元格引用。texttoreplace：指定的字符串。replacetext:需要替换部分旧文本的文本。示例：REPLACE("abcd", "a", "re")等于"rebcd"。REPLACE("a**d", "**d", "rose")等于"arose"。REPLACE(old_text,start_num,num_chars,new_text): 根据指定的字符数，用其他文本串来替换某个文本串中的部分内容。Old_text:需要被替换部分字符的文本或单元格引用。Start_num:需要用new_text来替换old_text中字符的起始位置。Num_chars:需要用new_text来替换old_text中字符的个数。New_text:需要替换部分旧文本的文本。示例:REPLACE("0123456789",5,4,"*")等于“0123*89”。REPLACE("1980",3,2,"99")等于“1999”。', + name: 'REPLACE', + type: 'TEXT', + }, + { + def: 'RIGHT(text,num_chars): 根据指定的字符数从右开始返回文本串中的最后一个或几个字符。Text:包含需要提取字符的文本串或单元格引用。Num_chars:指定RIGHT函数从文本串中提取的字符数。Num_chars不能小于0。如果num_chars大于文本串长度，RIGHT函数将返回整个文本。如果不指定num_chars，则默认值为1。示例:RIGHT("It is interesting",6)等于“esting”。RIGHT("Share Holder")等于“r”。RIGHT("Huge sale",4)等于“sale”。', + name: 'RIGHT', + type: 'TEXT', + }, + { + def: 'ROUND(number,num_digits):返回某个数字按指定位数舍入后的数字。number:需要进行舍入的数字。num_digits:指定的位数，按此位数进行舍入。如果 num_digits 大于 0，则舍入到指定的小数位。如果 num_digits 等于 0，则舍入到最接近的整数。如果 num_digits 小于 0，则在小数点左侧进行舍入。示例:ROUND(2.15, 1) 等于 2.2ROUND(2.149, 1) 等于 2.1ROUND(-1.475, 2) 等于 -1.48ROUND(21.5, -1) 等于 20因浮点数存在精度计算丢失问题, 导致计算结果里可能带上9999, 0000这些, 因此加入第三个参数来控制是否需要去除9999. true表示需要过滤9999, 0000这些数据.', + name: 'ROUND', + type: 'MATH', + }, + { + def: 'ROUND(number,num_digits):返回某个数字按指定位数舍入后的数字。number:需要进行舍入的数字。num_digits:指定的位数，按此位数进行舍入。如果 num_digits 大于 0，则舍入到指定的小数位。如果 num_digits 等于 0，则舍入到最接近的整数。如果 num_digits 小于 0，则在小数点左侧进行舍入。示例:ROUND(2.15, 1) 等于 2.2ROUND(2.149, 1) 等于 2.1ROUND(-1.475, 2) 等于 -1.48ROUND(21.5, -1) 等于 20因浮点数存在精度计算丢失问题, 导致计算结果里可能带上9999, 0000这些, 因此加入第三个参数来控制是否需要去除9999. true表示需要过滤9999, 0000这些数据.', + name: 'ROUND', + type: 'COMMON', + }, + { + def: 'same_period(x_agg(array)，datepart)根据横纵轴或行列维度添加的日期字段进行同期值的计算。第一个参数为用于计算的指标，该指标必须为聚合函数或聚合指标；第二个参数用于配置计算同期时计算某日的年同期或者某日的月同期。横纵轴拖拽的字段不满足函数的计算要求时，该指标会标红。示例：same_period(sum_agg(amount),"Y") 用户横纵轴拖拽销售日期（年月日分组），则该指标计算结果为，根据年月日对销量进行分组汇总，然后计算出该日数据上年同日的销量；如果参数2为“M”，则计算结果为该日销量上月同日的销量。', + name: 'SAME_PERIOD', + type: 'TABLE_CAL', + }, + { + def: 'SECOND(serial_number):返回某一指定时间的秒数，其值是介于0与59之间的一个整数。Serial_number:包含所求秒数的时间。示例:SECOND("15:36:25")等于25。SECOND("15:36:25", "HH:mm:ss")等于25。', + name: 'SECOND', + type: 'DATETIME', + }, + { + def: 'SIGN(number):返回数字的符号。当数字为正数时返回 1，为零时返回 0，为负数时返回 -1。Number:为任意实数。示例:SIGN(10) 等于 1SIGN(4-4) 等于 0SIGN(-0.00001) 等于 -1', + name: 'SIGN', + type: 'MATH', + }, + { + def: 'SIN(number): 计算给定角度的正弦值。Number:待求正弦值的以弧度表示的角度。备注: 如果参数的单位是度，将其乘以PI()/180即可转换成弧度。示例:SIN(10)等于-0.5440211108893698。SIN(45*PI()/180)等于0.707106781。', + name: 'SIN', + type: 'MATH', + }, + { + def: 'SPLIT(String1,String2)：返回由String2分割String1组成的字符串数组。String1：以双引号表示的字符串。String2：以双引号表示的分隔符。例如逗号","示例:SPLIT("hello,world,yes",",") = ["hello","world","yes"]。SPLIT("this is very good"," ") = ["this","is","very","good"]。备注：如果只有一个参数，则返回一个错误。如果有多个参数，则只有前两个起作用。', + name: 'SPLIT', + type: 'TEXT', + }, + { + def: 'SQRT(number): 返回一个正数的平方根。Number:要求其平方根的任一正数。备注:Number必须是一个正数，否则函数返回错误信息*NUM!。示例:SQRT(64)等于8。SQRT(-64)返回*NUM!。', + name: 'SQRT', + type: 'MATH', + }, + { + def: 'STARTWITH(str1，str2):判断字符串str1是否以str2开始。备注: str1和str2都是大小写敏感的。示例:STARTWITH("FineReport","Fine")等于true。STARTWITH("FineReport","Report")等于false。STARTWITH("FineReport","fine")等于false。', + name: 'STARTWITH', + type: 'TEXT', + }, + { + def: 'STDEV_AGG(array): 根据当前分析维度，动态返回指标字段的标准差，生成结果为一动态数据列，行数与当前分析维度行数一致。\n "array必须为非聚合函数公式返回的结果，可以是某指标字段、维度或指标字段与普通公式的计算结果。\n "示例：用户横轴为维度字段\'日\'时，纵轴的计算字段STDEV_AGG(销量)返回的值为每日的销量标准差；当用户横轴为维度字段\'月\'时，STDEV_AGG(销量)返回的值为每月的销量标准差。', + name: 'STDEV_AGG', + type: 'AGG', + }, + { + def: 'SUBSTITUTE(text,old_text,new_text,instance_num): 用new_text替换文本串中的old_text。Text:需要被替换字符的文本，或含有文本的单元格引用。Old_text:需要被替换的部分文本。New_text:用于替换old_text的文本。Instance_num:指定用new_text来替换第几次出现的old_text。如果指定了instance_num，则只有指定位置上的old_text被替换，否则文字串中出现的所有old_text都被new_text替换。备注: 如果需要替换文本串中的指定文本，则使用SUBSTITUTE函数；如果需要替换文本串中指定位置上的任意文本，则使用REPLACE函数。示例:SUBSTITUTE("data base","base","model")等于“data model”。SUBSTITUTE("July 28, 2000","2","1",1)等于“July 18, 2000”。SUBSTITUTE("July 28, 2000","2","1")等于“July 18, 1000”。SUBSTITUTE("July 28, 2000","2","1",2)等于“July 28, 1000”。 ', + name: 'SUBSTITUTE', + type: 'TEXT', + }, + { + def: 'SUM_AGG(array):根据当前分析维度，动态返回指标字段的汇总求和值，生成结果为一动态数据列，行数与当前分析维度行数一致。\n array必须为非聚合函数公式返回的结果，可以是某指标字段、维度或指标字段与普通公式的计算结果。\n 示例：用户横轴为维度字段\'日\'时，纵轴的计算字段SUM_AGG(销量)返回的值为每日的汇总销量；当用户横轴为维度字段\'月\'时，SUM_AGG(销量)返回的值为每月的汇总销量。', + name: 'SUM_AGG', + type: 'AGG', + }, + { + def: 'switch(表达式, 值1, 结果1, 值2, 结果2, ...)如果表达式的结果是值1，整个函数返回结果1如果表达式的结果是值2，整个函数返回结果2如果表达式的结果是值3，整个函数返回结果3等等', + name: 'SWITCH', + type: 'LOGIC', + }, + { + def: 'TAN(number): 返回指定角度的正切值。Number:待求正切值的角度，以弧度表示。如果参数是以度为单位的，乘以Pi()/180后转换为弧度。示例:TAN(0.8)等于1.029638557。TAN(45*Pi()/180)等于1。', + name: 'TAN', + type: 'MATH', + }, + { + def: 'TIME(hour,minute,second): 返回代表指定时间的小数。介于0:00:00（12:00:00 A.M.）与23:59:59（11:59:59 P.M.）之间的时间可返回0到0.99999999之间的对应数值。Hour:介于0到23之间的数。Minute:介于0到59之间的数。Second:介于0到59之间的数。示例:TIME(14,40,0)等于2:40 PM。TIME(19,43,24)等于7:43 PM。', + name: 'TIME', + type: 'DATETIME', + }, + { + def: 'TODATE()函数可以将各种日期形式的参数转换为日期类型。它有三种参数的形式：1 参数是一个日期型的参数，那么直接将这个参数返回。示例：TODATE(DATE(2007,12,12))返回2007年12月12日组成的日期。2 参数是以从1970年1月1日0时0分0秒开始的毫秒数，返回对应的时间。示例：TODATE(1023542354746)返回2002年6月8日。3 参数是日期格式的文本，那么返回这个文本对应的日期。示例：TODATE("2007/10/15")返回2007年10月5日组成的日期。TODATE("2007-6-8")返回2007年6月8日组成的日期。4 有两个参数，第一个参数是一个日期格式的文本，第二个参数是用来解析日期的格式。示例：TODATE("1/15/07","mm/dd/yy")返回07年1月15日组成的日期。特别的，"yyyyMMdd"是用来解析形如“20081230”之类的日期格式的。比如TODATE("20110830","yyyyMMdd")返回11年08月30日组成的日期5 有三个参数，第一个参数是一个日期格式的文本，第二个参数是用来解析日期的格式，第三个参数为解析日期的语言，如：zh（中文），en（英文）。示例：TODATE("星期三 1/15/07","EEE mm/dd/yy", "zh")返回07年1月15日组成的日期，使用“zh（中文）”才能够正常解析“星期三”这个字符串。', + name: 'TODATE', + type: 'DATETIME', + }, + { + def: 'TODAY():获取当前日期。示例：如果系统日期是2005年9月10日则TODAY()等于2005-9-10。', + name: 'TODAY', + type: 'DATETIME', + }, + { + def: 'TODOUBLE(text): 将文本转换成Double对象。Text:需要转换的文本。示例:TODOUBLE("123.21")等于 new Double(123.21)。', + name: 'TODOUBLE', + type: 'TEXT', + }, + { + def: 'TOINTEGER(text): 将文本转换成Integer对象。Text:需要转换的文本。示例:TOINTEGER("123")等于 new Integer(123)。', + name: 'TOINTEGER', + type: 'TEXT', + }, + { + def: 'total(x_agg(array),range,agg)根据横纵轴或行列维度添加的字段对指标进行跨行汇总的计算。第一个参数为用户计算的指标，该指标必须为聚合函数或聚合指标；第二个参数range为用户设置计算的范围，0为对所有行进行汇总，1为对组内所有行进行汇总；第三个参数agg为汇总的计算规则，"sum"为求和；"avg"为求平均，"max"为求最大值，"min"为求最小值示例：total(sum_agg(array),0,"avg")用户横纵轴拖拽省份，则该指标计算结果为，根据省份对销量进行分组汇总，然后计算平均每个省份的销量', + name: 'TOTAL', + type: 'TABLE_CAL', + }, + { + def: 'TRIM(text): 清除文本中所有空格，单词间的单个空格除外，也可用于带有不规则空格的文本。Text:需要清除空格的文本。示例:TRIM(" Monthly Report")等于Monthly Report。', + name: 'TRIM', + type: 'TEXT', + }, + { + def: 'TRUNC(number,num_digits):将数字的小数部分截去，返回整数。number:需要截尾取整的数字。num_digits:用于指定取整精度的数字。示例:TRUNC(8.9) 等于 8TRUNC(-8.9) 等于 -8TRUNC(PI()) 等于 3', + name: 'TRUNC', + type: 'MATH', + }, + { + def: 'UPPER(text): 将文本中所有的字符转化为大写。Text:需要转化为大写字符的文本，或是包含文本的单元格引用。示例:UPPER("notes")等于“NOTES”。如果单元格E5的值为“Examples”，则UPPER(E5)等于“EXAMPLES”。', + name: 'UPPER', + type: 'TEXT', + }, + { + def: 'VAR_AGG(array): 根据当前分析维度，动态返回指标字段的方差，生成结果为一动态数据列，行数与当前分析维度行数一致。\n "array必须为非聚合函数公式返回的结果，可以是某指标字段、维度或指标字段与普通公式的计算结果。\n "示例：用户横轴为维度字段\'日\'时，纵轴的计算字段VAR_AGG(销量)返回的值为每日的销量方差；当用户横轴为维度字段\'月\'时，VAR_AGG(销量)返回的值为每月的销量方差。', + name: 'VAR_AGG', + type: 'AGG', + }, + { + def: 'WEEK(serial_num):返回一个代表一年中的第几周的数字。Serial_num:表示输入的日期。备注:FineReport将日期保存为系列数，一个系列数代表一个与之匹配的日期，以方便用户对日期进行数值式计算。在1900年日期系统中，FineReport电子表格将1900年1月1日保存为系列数2，将1900年1月2日保存为系列数3，将1900年1月3日保存为系列数4……依此类推。如在1900年日期系统，1998年1月1日存为系列数35796。示例:WEEK("2010/1/1")等于52。WEEK("2010/1/6")等于1。WEEK(35796)等于1。', + name: 'WEEK', + type: 'DATETIME', + }, + { + def: 'weekdate(year,month,weekOfMonth,dayOfWeek): 返回指定年月的指定周的周几的具体日期。示例：weekdate(2009,10,2,1)返回的是2009年的10月的第二个周的第一天即星期天的日期，返回的是2009-10-04最后一个参数dayOfWeek为-1时，表示这个周的最后一天示例：weekdate(2009,12,1,-1)返回的是2009年的12月的第一个周的最后一天即星期六的日期，返回的是2009-12-05', + name: 'WEEKDATE', + type: 'DATETIME', + }, + { + def: 'WEEKDAY(Serial_number):获取日期并返回星期数。返回值为介于0到6之间的某一整数，分别代表星期中的某一天（从星期日到星期六）。Serial_number:输入的日期备注:FineReport将日期保存为系列数，一个系列数代表一个与之匹配的日期，以方便用户对日期进行数值式计算。在1900年日期系统中，FineReport电子表格将1900年1月1日保存为系列数2，将1900年1月2日保存为系列数3，将1900年1月3日保存为系列数4……依此类推。如在1900年日期系统，1998年1月1日存为系列数35796。举例:WEEKDAY("2005/9/10")等于6（星期六）。WEEKDAY("2005/9/11")等于0（星期日）。WEEKDAY(35796)等于4（星期四）。', + name: 'WEEKDAY', + type: 'DATETIME', + }, + { + def: 'YEAR:(serial_number)返回日期中的年。Year是介于1900和9999之间的一个数。Serial_number:含有所求的年的日期.备注:FineReport将日期保存为系列数，一个系列数代表一个与之匹配的日期，以方便用户对日期进行数值式计算。在1900年日期系统中，FineReport电子表格将1900年1月1日保存为系列数2，将1900年1月2日保存为系列数3，将1900年1月3日保存为系列数4……依此类推。如在1900年日期系统，1998年1月1日存为系列数35796。示例:YEAR("2000/1/1")等于2000。YEAR("2006/05/05")等于2006。YEAR("1997/04/20")等于1997。YEAR("2000-1-1", "yyyy-MM-dd")等于2000。YEAR("2006-05-05", "yyyy-MM-dd")等于2006。YEAR("1997-04-20", "yyyy-MM-dd")等于1997。YEAR(35796)等于1998。', + name: 'YEAR', + type: 'DATETIME', + }, + { + def: 'YEARDELTA(date, delta):返回指定日期后delta年的日期。示例：YEARDELTA("2008-10-10",10)等于2018-10-10。', + name: 'YEARDELTA', + type: 'DATETIME', + }, + ], +}; diff --git a/src/web/src/ui/fineui.ts b/src/web/src/ui/fineui.ts index 760af2b..5c1fa2e 100644 --- a/src/web/src/ui/fineui.ts +++ b/src/web/src/ui/fineui.ts @@ -56,6 +56,8 @@ export const NumberEditorXtype = 'bi.number_editor'; export const CodeEditorXtype = 'bi.code_editor'; export const ComponentsStyleTable = 'bi.components.style_table'; export const IconTextValue_Combo = 'bi.icon_text_value_combo'; +export const BarPopoverXtype = 'bi.bar_popover'; + // 布局 export const VerticalAdaptXtype = 'bi.vertical_adapt'; export const VtapeXtype = 'bi.vtape';