mirror of
https://github.com/ONLYOFFICE/onlyoffice.github.io.git
synced 2026-04-07 14:04:30 +08:00
125 lines
4.1 KiB
JavaScript
125 lines
4.1 KiB
JavaScript
/*
|
|
* (c) Copyright Ascensio System SIA 2010-2025
|
|
*
|
|
* This program is a free software product. You can redistribute it and/or
|
|
* modify it under the terms of the GNU Affero General Public License (AGPL)
|
|
* version 3 as published by the Free Software Foundation. In accordance with
|
|
* Section 7(a) of the GNU AGPL its Section 15 shall be amended to the effect
|
|
* that Ascensio System SIA expressly excludes the warranty of non-infringement
|
|
* of any third-party rights.
|
|
*
|
|
* This program is distributed WITHOUT ANY WARRANTY; without even the implied
|
|
* warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. For
|
|
* details, see the GNU AGPL at: http://www.gnu.org/licenses/agpl-3.0.html
|
|
*
|
|
* You can contact Ascensio System SIA at 20A-6 Ernesta Birznieka-Upish
|
|
* street, Riga, Latvia, EU, LV-1050.
|
|
*
|
|
* The interactive user interfaces in modified source and object code versions
|
|
* of the Program must display Appropriate Legal Notices, as required under
|
|
* Section 5 of the GNU AGPL version 3.
|
|
*
|
|
* Pursuant to Section 7(b) of the License you must retain the original Product
|
|
* logo when distributing the program. Pursuant to Section 7(e) we decline to
|
|
* grant you any rights under trademark law for use of our trademarks.
|
|
*
|
|
* All the Product's GUI elements, including illustrations and icon sets, as
|
|
* well as technical writing content are licensed under the terms of the
|
|
* Creative Commons Attribution-ShareAlike 4.0 International. See the License
|
|
* terms at http://creativecommons.org/licenses/by-sa/4.0/legalcode
|
|
*
|
|
*/
|
|
|
|
(function(){
|
|
|
|
let func = new RegisteredFunction({
|
|
"name": "addAboveAverage",
|
|
"description": "Highlights cells that contain values above or below the average of all values in the range. This is useful for identifying data points that deviate significantly from the typical values in your dataset.",
|
|
"parameters": {
|
|
"type": "object",
|
|
"properties": {
|
|
"range": {
|
|
"type": "string",
|
|
"description": "Cell range to apply condition (e.g., 'A1:D10'). If omitted, uses active/selected range."
|
|
},
|
|
"aboveBelow": {
|
|
"type": "boolean",
|
|
"description": "True for above average, false for below average (default: true).",
|
|
"default": true
|
|
},
|
|
"numStdDev": {
|
|
"type": "number",
|
|
"description": "Number of standard deviations from average (default: 0 for simple average).",
|
|
"default": 0
|
|
},
|
|
"fillColor": {
|
|
"type": "object",
|
|
"description": "Background color {r: 255, g: 0, b: 0}.",
|
|
"properties": {
|
|
"r": { "type": "number" },
|
|
"g": { "type": "number" },
|
|
"b": { "type": "number" }
|
|
}
|
|
}
|
|
},
|
|
"required": []
|
|
},
|
|
"examples": [
|
|
{
|
|
"prompt": "Highlight cells above average with default color",
|
|
"arguments": {}
|
|
},
|
|
{
|
|
"prompt": "Highlight cells below average with red background",
|
|
"arguments": { "aboveBelow": false, "fillColor": { "r": 255, "g": 0, "b": 0 } }
|
|
},
|
|
{
|
|
"prompt": "When user asks to highlight above/below average values",
|
|
"arguments": { "aboveBelow": true }
|
|
}
|
|
]
|
|
});
|
|
|
|
func.call = async function(params) {
|
|
Asc.scope.range = params.range;
|
|
Asc.scope.aboveBelow = params.aboveBelow !== false; // default true
|
|
Asc.scope.numStdDev = params.numStdDev || 0;
|
|
Asc.scope.fillColor = params.fillColor;
|
|
|
|
await Asc.Editor.callCommand(function() {
|
|
let ws = Api.GetActiveSheet();
|
|
let range;
|
|
if (Asc.scope.range) {
|
|
range = ws.GetRange(Asc.scope.range);
|
|
} else {
|
|
range = ws.GetSelection();
|
|
}
|
|
|
|
if (!range) {
|
|
return;
|
|
}
|
|
|
|
let formatConditions = range.GetFormatConditions();
|
|
let condition = formatConditions.AddAboveAverage();
|
|
|
|
if (condition) {
|
|
condition.SetAboveBelow(Asc.scope.aboveBelow);
|
|
|
|
if (Asc.scope.numStdDev !== 0) {
|
|
condition.SetNumStdDev(Asc.scope.numStdDev);
|
|
}
|
|
|
|
if (Asc.scope.fillColor) {
|
|
let fillColor = Api.CreateColorFromRGB(Asc.scope.fillColor.r, Asc.scope.fillColor.g, Asc.scope.fillColor.b);
|
|
condition.SetFillColor(fillColor);
|
|
} else {
|
|
let defaultFillColor = Api.CreateColorFromRGB(255, 165, 0);
|
|
condition.SetFillColor(defaultFillColor);
|
|
}
|
|
}
|
|
});
|
|
};
|
|
|
|
return func;
|
|
})();
|