Перейти к основному содержанию

О полях

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

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

Стандартные поля встроены в 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

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

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