---
url: /process-functions/workview-definitionget.md
description: Returns a workview's definition.
---

# workview.definitionGet

Returns a workview's definition, such as its cube, sets and titles.

```js
workview.definitionGet(workview)
```

## Parameters

| Parameter | Type | Description |
|---|---|---|
| `workview` | `string` | The workview's name or id. |

## Returns

The definition, as a JSON string. Use `JSON.parse()` to read it. Returns `"Error: workview not found"` when the workview can't be found.

## Examples

```js
const def = JSON.parse(workview.definitionGet("Monthly P&L"));
```

## Related

* [workview.execute](/process-functions/workview-execute)
