# Формулы

- Human documentation: [https://docs.univer.ai/ru-RU/guides/bases/features/core/formulas](https://docs.univer.ai/ru-RU/guides/bases/features/core/formulas)

- Agent Markdown: [https://docs.univer.ai/ru-RU/guides/bases/features/core/formulas.md](https://docs.univer.ai/ru-RU/guides/bases/features/core/formulas.md)

- Requested language: `ru-RU`

- Content language: `ru-RU`

- Documentation version: `1.2.0`

- Source: [bases/features/core/formulas.ru-RU.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/bases/features/core/formulas.ru-RU.mdx)

---

Поля формул в Bases вычисляют значения записей по данным таблицы. `UniverBasesPlugin` автоматически регистрирует зависимость от механизма формул .

## Регистрация поддержки формул

```ts
import { UniverBasesPlugin } from '@univerjs-pro/bases'
import { UniverBasesUIPlugin } from '@univerjs-pro/bases-ui'

univer.registerPlugin(UniverBasesPlugin)
univer.registerPlugin(UniverBasesUIPlugin)
```

## Создание поля формулы

```ts
const formulaTableName = table.getFormulaName()
const total = table.addField('Total', univerAPI.Enum.BaseFieldType.Formula, {
  field: {
    config: {
      formula: `=SUM(${formulaTableName}[[#This Row],[Price]],${formulaTableName}[[#This Row],[Tax]])`,
    },
  },
  externalReferences: [],
})
```

При каждой записи поля формулы параметр `externalReferences` обязателен. Используйте `[]` только для формул, которые ссылаются на поля в основной Base. Для формул между юнитами используйте [`buildReference`](https://docs.univer.ai/ru-RU/reference/facade/formula.md#buildreference) и передавайте в массиве все стабильные привязки источников.

## Примечания

* Значения полей формул вычисляются автоматически, поэтому не записывайте данные напрямую в такие ячейки из кода приложения.
* В формулах используются структурированные ссылки на поля, например `Table[[#This Row],[Price]]`.
* После импорта больших снимков данных пересчитайте формулы, прежде чем показывать результаты пользователям.