Share via


extensionFunction object

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.

Required

Constraints
Maximum array items: 128.

Supported values

result

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.