upstream-twenty/packages/twenty-docs/l/ru/user-guide/data-model/capabilities/fields.mdx

---
title: Поля
description: Разберитесь в роли полей и в том, как ими управлять.
---

import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';

## О полях

Поля похожи на столбцы в электронной таблице. Они хранят различные типы данных, такие как текст, числа или даты. Поля могут быть стандартными (встроенными) или пользовательскими (те, которые вы создаете).

### Стандартные Поля

Стандартные поля встроены в Twenty для решения общих бизнес-задач.

Например, `Имя` и `Фамилия` являются стандартными полями в объекте `Люди`. Они хранят текстовые данные для отдельных имен.

Вы не можете удалить стандартные поля, но можете деактивировать их, если они вам не нужны.

Вы также можете настраивать параметры стандартных полей типа `SELECT`, например параметры для поля `Stage` в «Сделках».

<img src="/images/user-guide/fields/standard-fields.png" style={{width:'100%'}} />

### Пользовательские Поля

Пользовательские поля можно добавлять к любому объекту. Вы можете хранить текст, числа, даты, выпадающие списки и многое другое. Используйте пользовательские поля для отслеживания информации, специфичной для вашего бизнеса.

Например, пользовательское поле для SpaceX может быть `Статус Активности Ракеты`, указывающее, работает ли ракета.

<img src="/images/user-guide/fields/custom-fields.png" style={{width:'100%'}} />

## Типы полей

Twenty поддерживает различные типы полей:

| Тип                 | Описание                                                                                | Пример                      |
| ------------------- | --------------------------------------------------------------------------------------- | --------------------------- |
| Адрес               | Структурированный адрес с улицей, городом, штатом/регионом, страной и почтовым индексом | Адрес офиса                 |
| Массив              | Список текстовых значений                                                               | Теги                        |
| Булево              | Флажок «истина/ложь»                                                                    | Активен                     |
| Валюта              | Денежное значение с кодом валюты                                                        | Сумма сделки (USD)          |
| Дата                | Значения дат                                                                            | Дата закрытия               |
| Дата и время        | Дата со временем                                                                        | Время встречи               |
| Домен               | Домен сайта (используется для компаний)                                                 | acme.com                    |
| Электронная почта   | Адреса электронной почты (основной + дополнительные)                                    | Электронная почта контакта  |
| JSON                | Структурированные данные JSON                                                           | Пользовательские метаданные |
| Ссылки              | URL-адреса с метками (основной + дополнительный)                                        | Веб-сайт, LinkedIn          |
| Длинный текст       | Многострочный текст                                                                     | Описание, примечания        |
| Множественный выбор | Несколько вариантов из предопределенного списка                                         | Теги, категории             |
| Число               | Числовые значения (целые или десятичные)                                                | Количество, оценка          |
| Телефон             | Телефонные номера с кодом страны                                                        | Рабочий телефон             |
| Рейтинг             | Рейтинг в звездах (1–5)                                                                 | Приоритет, оценка           |
| Связь               | Ссылки на записи в других объектах                                                      | Компания → Люди             |
| Выбрать             | Один вариант из предопределенного списка                                                | Этап, статус                |
| Текст               | Однострочный текст                                                                      | Имя, должность              |

## Создать пользовательское поле

Чтобы добавить пользовательское поле к любому объекту, выполните следующие шаги:

1. Перейдите в `Настройки` в левой боковой панели.
2. Перейдите в `Модель Данных`, затем выберите объект, который хотите настроить.
3. Продолжайте, нажав `+ Новое Поле`.
4. Выберите имя и тип поля, которые подходят вашим требованиям. Рассмотрите возможность добавления описания поля для лучшего понимания.

Ваше новосозданное поле теперь доступно в приложении среди других полей. Чтобы отобразить его в конкретном представлении, откройте меню параметров, затем выберите `Поля`.

<VimeoEmbed videoId="927628219" title="Видеодемонстрация" />

**Быстрый способ:** Нажмите кнопку **+** в верхнем правом углу любой таблицы объектов, затем выберите `Настроить поля`. Это автоматически откроет настройки Модели Данных.

<img src="/images/user-guide/fields/quick-new-field.png" style={{width:'100%'}} />

## Деактивировать поле

Вы можете деактивировать поле, чтобы скрыть его из приложения, не потеряв ваши данные. Считайте, что это что-то вроде скрытия поля, а не его удаления.

Вот как это можно сделать:

1. Найдите поле, которое вы хотите деактивировать, в настройках вашего объекта.
2. Щелкните на три точки `⋮` рядом с полем, чтобы открыть меню.
3. Выберите `Деактивировать` из выпадающего списка.

<img src="/images/user-guide/fields/deactivate-field.png" style={{width:'100%'}} />

Что происходит, когда вы деактивируете поле?

1. **В приложении:** Поле исчезает, и вы не можете добавлять в него новые значения.
2. **Существующие связи:** Если это реляционное поле, существующие связи остаются, но вы не можете создавать новые.
3. **Доступ по API:** Вы все еще можете получить доступ к полю и его данным через API.

Вы можете реактивировать Стандартные и Пользовательские Поля или выбрать их окончательное удаление.

## Сделать поля уникальными

Уникальность поля гарантирует, что разные записи не могут иметь одно и то же значение. Например, адреса электронной почты уникальны для каждого человека.

Если вы получаете ошибку при установке уникальности, проверьте дублирующиеся значения в ваших данных (включая удаленные записи).

## Индексы (расширенный режим)

Индексы базы данных управляются автоматически — добавлять собственные почти никогда не требуется и при этом легко допустить ошибку. При включенном расширенном режиме у каждого объекта есть раздел **Индексы** в `Settings → Data Model → <object>` для случаев, когда вы знаете, что вам нужен индекс.

## Лучшие практики в настройке полей

### Именование и ограничения

* **Имена в единственном и множественном числе должны различаться**: наш GraphQL API требует различных имен для мутаций
* **Защищенные имена полей**: некоторые имена зарезервированы для использования системой (например, `Type`, `Application`)

### Поля для валюты и телефона

* **Валюта по умолчанию**: может быть настроена через модель данных
* **Коды стран по умолчанию**: можно настроить для телефонных полей через модель данных

### Выбор полей

* **Можно выбрать стандартный вариант** для каждого поля Select

### Записать текстовые поля

* **Каждый объект имеет одно основное поле отображения**: Это поле отображается в крайнем левом столбце и представляет запись при ее связи с другими объектами. Это должно быть текстовое поле. Например, Люди используют `Имя` как основное поле, поэтому при связи человека с компанией вы увидите его имя во встраивании компании.