Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Array of function object which defines function metadata.
Properties that reference this object type:
Syntax
{
"id": "{string}",
"name": "{string}",
"description": "{string}",
"helpUrl": "{string}",
"parameters": [
{
"name": "{string}",
"description": "{string}",
"type": "{string}",
"cellValueType": "cellvalue | booleancellvalue | doublecellvalue | entitycellvalue | errorcellvalue | formattednumbercellvalue | linkedentitycellvalue | localimagecellvalue | stringcellvalue | webimagecellvalue | ",
"dimensionality": "scalar | matrix",
"optional": {boolean},
"repeating": {boolean}
}
],
"result": {
"dimensionality": "scalar | matrix"
},
"stream": {boolean},
"volatile": {boolean},
"cancelable": {boolean},
"requiresAddress": {boolean},
"requiresParameterAddress": {boolean}
}
Properties
id
A unique ID for the function.
Type
string
Required
✅
Constraints
Minimum string length: 3. Maximum string length: 64.
Supported values
The string value must start with a letter and can contain only letters, numbers, periods, and underscores.
name
The name of the function that end users see in Excel. In Excel, this function name is prefixed by the custom functions namespace that's specified in the manifest file.
This property is localizable. For more information, see the localization schema.
Type
string
Required
✅
Constraints
Minimum string length: 3. Maximum string length: 64.
Supported values
The string value must start with a letter and can contain only letters, numbers, periods, and underscores.
description
The description of the function that end users see in Excel.
This property is localizable. For more information, see the localization schema.
Type
string
Required
—
Constraints
Minimum string length: 1. Maximum string length: 128.
Supported values
helpUrl
URL that provides information about the function. (It is displayed in a task pane.)
Type
string
Required
—
Constraints
Minimum string length: 1. Maximum string length: 2048.
Supported values
parameters
Array that defines the input parameters for the function.
Type
Array of extensionFunctionParameter
Required
✅
Constraints
Maximum array items: 128.
Supported values
result
Type
extensionResult
Required
✅
Constraints
Supported values
stream
If true, the function can output repeatedly to the cell even when invoked only once. This option is useful for rapidly-changing data sources, such as a stock price. The function should have no return statement. Instead, the result value is passed as the argument of the StreamingInvocation.setResult callback function.
Type
boolean
Required
—
Constraints
Supported values
Default value: False
.
volatile
If true, the function recalculates each time Excel recalculates, instead of only when the formula's dependent values have changed. A function can't use both the stream and volatile properties. If the stream and volatile properties are both set to true, the volatile property will be ignored.
Type
boolean
Required
—
Constraints
Supported values
Default value: False
.
cancelable
If true, Excel calls the CancelableInvocation handler whenever the user takes an action that has the effect of canceling the function; for example, manually triggering recalculation or editing a cell that is referenced by the function. Cancelable functions are typically only used for asynchronous functions that return a single result and need to handle the cancellation of a request for data. A function can't use both the stream and cancelable properties.
Type
boolean
Required
—
Constraints
Supported values
Default value: False
.
requiresAddress
If true, your custom function can access the address of the cell that invoked it. The address property of the invocation parameter contains the address of the cell that invoked your custom function. A function can't use both the stream and requiresAddress properties.
Type
boolean
Required
—
Constraints
Supported values
Default value: False
.
requiresParameterAddress
If true, your custom function can access the addresses of the function's input parameters. This property must be used in combination with the dimensionality property of the result object, and dimensionality must be set to matrix.
Type
boolean
Required
—
Constraints
Supported values
Default value: False
.