--- title: Поля description: Разберитесь в роли полей и в том, как ими управлять. --- import { VimeoEmbed } from '/snippets/vimeo-embed.mdx'; ## О полях Поля похожи на столбцы в электронной таблице. Они хранят различные типы данных, такие как текст, числа или даты. Поля могут быть стандартными (встроенными) или пользовательскими (те, которые вы создаете). ### Стандартные Поля Стандартные поля встроены в Twenty для решения общих бизнес-задач. Например, `Имя` и `Фамилия` являются стандартными полями в объекте `Люди`. Они хранят текстовые данные для отдельных имен. Вы не можете удалить стандартные поля, но можете деактивировать их, если они вам не нужны. Вы также можете настраивать параметры стандартных полей типа `SELECT`, например параметры для поля `Stage` в «Сделках». ### Пользовательские Поля Пользовательские поля можно добавлять к любому объекту. Вы можете хранить текст, числа, даты, выпадающие списки и многое другое. Используйте пользовательские поля для отслеживания информации, специфичной для вашего бизнеса. Например, пользовательское поле для SpaceX может быть `Статус Активности Ракеты`, указывающее, работает ли ракета. ## Типы полей Twenty поддерживает различные типы полей: | Тип | Описание | Пример | | ------------------- | --------------------------------------------------------------------------------------- | --------------------------- | | Адрес | Структурированный адрес с улицей, городом, штатом/регионом, страной и почтовым индексом | Адрес офиса | | Массив | Список текстовых значений | Теги | | Булево | Флажок «истина/ложь» | Активен | | Валюта | Денежное значение с кодом валюты | Сумма сделки (USD) | | Дата | Значения дат | Дата закрытия | | Дата и время | Дата со временем | Время встречи | | Домен | Домен сайта (используется для компаний) | acme.com | | Электронная почта | Адреса электронной почты (основной + дополнительные) | Электронная почта контакта | | JSON | Структурированные данные JSON | Пользовательские метаданные | | Ссылки | URL-адреса с метками (основной + дополнительный) | Веб-сайт, LinkedIn | | Длинный текст | Многострочный текст | Описание, примечания | | Множественный выбор | Несколько вариантов из предопределенного списка | Теги, категории | | Число | Числовые значения (целые или десятичные) | Количество, оценка | | Телефон | Телефонные номера с кодом страны | Рабочий телефон | | Рейтинг | Рейтинг в звездах (1–5) | Приоритет, оценка | | Связь | Ссылки на записи в других объектах | Компания → Люди | | Выбрать | Один вариант из предопределенного списка | Этап, статус | | Текст | Однострочный текст | Имя, должность | ## Создать пользовательское поле Чтобы добавить пользовательское поле к любому объекту, выполните следующие шаги: 1. Перейдите в `Настройки` в левой боковой панели. 2. Перейдите в `Модель Данных`, затем выберите объект, который хотите настроить. 3. Продолжайте, нажав `Добавить Поле`. 4. Выберите имя и тип поля, которые подходят вашим требованиям. Рассмотрите возможность добавления описания поля для лучшего понимания. Ваше новосозданное поле теперь доступно в приложении среди других полей. Чтобы отобразить его в конкретном представлении, откройте меню параметров, затем выберите `Поля`. **Быстрый способ:** Нажмите кнопку **+** в верхнем правом углу любой таблицы объектов, затем выберите `Настроить поля`. Это автоматически откроет настройки Модели Данных. ## Деактивировать поле Вы можете деактивировать поле, чтобы скрыть его из приложения, не потеряв ваши данные. Считайте, что это что-то вроде скрытия поля, а не его удаления. Вот как это можно сделать: 1. Найдите поле, которое вы хотите деактивировать, в настройках вашего объекта. 2. Щелкните на три точки `⋮` рядом с полем, чтобы открыть меню. 3. Выберите `Деактивировать` из выпадающего списка. Что происходит, когда вы деактивируете поле? 1. **В приложении:** Поле исчезает, и вы не можете добавлять в него новые значения. 2. **Существующие связи:** Если это реляционное поле, существующие связи остаются, но вы не можете создавать новые. 3. **Доступ по API:** Вы все еще можете получить доступ к полю и его данным через API. Вы можете реактивировать Стандартные и Пользовательские Поля или выбрать их окончательное удаление. ## Сделать поля уникальными Уникальность поля гарантирует, что разные записи не могут иметь одно и то же значение. Например, адреса электронной почты уникальны для каждого человека. Если вы получаете ошибку при установке уникальности, проверьте дублирующиеся значения в ваших данных (включая удаленные записи). ## Лучшие практики в настройке полей ### Именование и ограничения * **Имена в единственном и множественном числе должны различаться**: наш GraphQL API требует различных имен для мутаций * **Защищенные имена полей**: некоторые имена зарезервированы для использования системой (например, `Type`, `Application`) ### Поля для валюты и телефона * **Валюта по умолчанию**: может быть настроена через модель данных * **Коды стран по умолчанию**: можно настроить для телефонных полей через модель данных ### Выбор полей * **Можно выбрать стандартный вариант** для каждого поля Select ### Записать текстовые поля * **Каждый объект имеет одно основное поле отображения**: Это поле отображается в крайнем левом столбце и представляет запись при ее связи с другими объектами. Это должно быть текстовое поле. Например, Люди используют `Имя` как основное поле, поэтому при связи человека с компанией вы увидите его имя во встраивании компании.