# EvaluateStandardExpressionRequest

Canonical page: https://www.adaptabletools.com/docs/reference/evaluatestandardexpressionrequest

Request for `evaluateStandardExpression`.
A row target is required: pass exactly one of `rowNode` / `primaryKeyValue` / `data`.

```ts title="TypeScript"
export interface EvaluateStandardExpressionRequest extends EvaluateExpressionOptions 
```

###### Extends

[`EvaluateExpressionOptions`](https://www.adaptabletools.com/docs/reference/evaluateexpressionoptions.md)

## Properties

| Property | Type | Description |
| --- | --- | --- |
| [cellValueOverride](https://www.adaptabletools.com/docs/reference/evaluatestandardexpressionrequest.md#cellvalueoverride) | [`CellValueOverride`](https://www.adaptabletools.com/docs/reference/cellvalueoverride.md) | What-if override: substitute this column&#39;s value on the row being<br/>evaluated, without mutating data. |
| [columns](https://www.adaptabletools.com/docs/reference/evaluatestandardexpressionrequest.md#columns) | [`ExternalDataColumn`](https://www.adaptabletools.com/docs/reference/externaldatacolumn.md)`[]` | dataType metadata for keys on `data` that are not grid columns.<br/>Ignored unless `data` is provided. |
| [columnScope](https://www.adaptabletools.com/docs/reference/evaluatestandardexpressionrequest.md#columnscope) | `string` | Column id substituted for `$SCOPE` references. `$SCOPE` expressions fail<br/>with an evaluation error when this is not provided. |
| [data](https://www.adaptabletools.com/docs/reference/evaluatestandardexpressionrequest.md#data) | `Record<string, unknown>` | A plain-object row, evaluated via the external-data host (no AG Grid<br/>`valueGetter`s — values are whatever the object contains). Mutually<br/>exclusive with `rowNode` / `primaryKeyValue`. |
| [dataChangedEvent](https://www.adaptabletools.com/docs/reference/evaluatestandardexpressionrequest.md#datachangedevent) | [`CellDataChangedInfo`](https://www.adaptabletools.com/docs/reference/celldatachangedinfo.md) | Cell change consumed by the data-change functions (`ANY_CHANGE`,<br/>`CHANGED_COLUMN`, …). Those functions fail with an evaluation error when<br/>this is not provided. |
| [expression](https://www.adaptabletools.com/docs/reference/evaluatestandardexpressionrequest.md#expression) | `string` | Standard AdaptableQL Expression to evaluate. |
| [primaryKeyValue](https://www.adaptabletools.com/docs/reference/evaluatestandardexpressionrequest.md#primarykeyvalue) | `unknown` | Alternative row target: resolved via the grid&#39;s primary key. |
| [rowNode](https://www.adaptabletools.com/docs/reference/evaluatestandardexpressionrequest.md#rownode) | `IRowNode` | The grid row to evaluate against. |

## Property Details

### cellValueOverride

What-if override: substitute this column&#39;s value on the row being
evaluated, without mutating data.

```ts title="TypeScript"
cellValueOverride?: CellValueOverride;
```

###### Property Value

[`CellValueOverride`](https://www.adaptabletools.com/docs/reference/cellvalueoverride.md)

### columns

dataType metadata for keys on `data` that are not grid columns.
Ignored unless `data` is provided.

```ts title="TypeScript"
columns?: ExternalDataColumn[];
```

###### Property Value

[`ExternalDataColumn`](https://www.adaptabletools.com/docs/reference/externaldatacolumn.md)`[]`

### columnScope

Column id substituted for `$SCOPE` references. `$SCOPE` expressions fail
with an evaluation error when this is not provided.

```ts title="TypeScript"
columnScope?: string;
```

###### Property Value

`string`

### data

A plain-object row, evaluated via the external-data host (no AG Grid
`valueGetter`s — values are whatever the object contains). Mutually
exclusive with `rowNode` / `primaryKeyValue`.

```ts title="TypeScript"
data?: Record<string, unknown>;
```

###### Property Value

`Record<string, unknown>`

### dataChangedEvent

Cell change consumed by the data-change functions (`ANY_CHANGE`,
`CHANGED_COLUMN`, …). Those functions fail with an evaluation error when
this is not provided.

```ts title="TypeScript"
dataChangedEvent?: CellDataChangedInfo;
```

###### Property Value

[`CellDataChangedInfo`](https://www.adaptabletools.com/docs/reference/celldatachangedinfo.md)

### expression

Standard AdaptableQL Expression to evaluate.

```ts title="TypeScript"
expression: string;
```

###### Property Value

`string`

### primaryKeyValue

Alternative row target: resolved via the grid&#39;s primary key.

```ts title="TypeScript"
primaryKeyValue?: unknown;
```

###### Property Value

`unknown`

### rowNode

The grid row to evaluate against.

```ts title="TypeScript"
rowNode?: IRowNode;
```

###### Property Value

`IRowNode`