> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Поля

> Разберитесь в роли полей и в том, как ими управлять.

export const VimeoEmbed = ({videoId, title = 'Video'}) => <div style={{
  padding: '69.01% 0 0 0',
  position: 'relative',
  margin: '32px 0px',
  borderRadius: '16px',
  overflow: 'hidden',
  border: '2px solid black'
}}>
    <iframe src={`https://player.vimeo.com/video/${videoId}?autoplay=1&loop=1&autopause=0&background=1&app_id=58479`} frameBorder="0" allow="autoplay; fullscreen; picture-in-picture; clipboard-write" style={{
  position: 'absolute',
  top: 0,
  left: 0,
  width: '100%',
  height: '100%',
  transform: 'scale(1.1)'
}} title={title} />
  </div>;

## О полях

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

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

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

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

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

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

<img src="https://mintcdn.com/twenty/JIRRbviz5phT8G2L/images/user-guide/fields/standard-fields.png?fit=max&auto=format&n=JIRRbviz5phT8G2L&q=85&s=5741af255052b4b1ee935bff2064bf90" style={{width:'100%'}} width="1600" height="555" data-path="images/user-guide/fields/standard-fields.png" />

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

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

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

<img src="https://mintcdn.com/twenty/JIRRbviz5phT8G2L/images/user-guide/fields/custom-fields.png?fit=max&auto=format&n=JIRRbviz5phT8G2L&q=85&s=517a43935d9f9ff14ab32927b206ea41" style={{width:'100%'}} width="1600" height="554" data-path="images/user-guide/fields/custom-fields.png" />

## Типы полей

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

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

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

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

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

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

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

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

<img src="https://mintcdn.com/twenty/JIRRbviz5phT8G2L/images/user-guide/fields/quick-new-field.png?fit=max&auto=format&n=JIRRbviz5phT8G2L&q=85&s=e15093ad2a3e746c0dbe688135bc1790" style={{width:'100%'}} width="1600" height="1000" data-path="images/user-guide/fields/quick-new-field.png" />

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

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

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

1. Найдите поле, которое вы хотите деактивировать, в настройках вашего объекта.

2. Щелкните на три точки `⋮` рядом с полем, чтобы открыть меню.

3. Выберите `Деактивировать` из выпадающего списка.

<img src="https://mintcdn.com/twenty/JIRRbviz5phT8G2L/images/user-guide/fields/deactivate-field.png?fit=max&auto=format&n=JIRRbviz5phT8G2L&q=85&s=c846ffa5fc15a19acbbde969fe920a55" style={{width:'100%'}} width="1600" height="728" data-path="images/user-guide/fields/deactivate-field.png" />

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

1. **В приложении:** Поле исчезает, и вы не можете добавлять в него новые значения.

2. **Существующие связи:** Если это реляционное поле, существующие связи остаются, но вы не можете создавать новые.

3. **Доступ по API:** Вы все еще можете получить доступ к полю и его данным через API.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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