> ## 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

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

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.