Перейти к основному содержанию
Объекты - это структуры, которые позволяют хранить данные (записи, атрибуты и значения), специфичные для организации. В Twenty предусмотрены как стандартные, так и пользовательские объекты. Стандартные объекты - это встроенные объекты с набором атрибутов, доступных для всех пользователей. В Twenty к стандартным объектам относятся Company и Person. Стандартные объекты имеют стандартные поля, которые также доступны всем пользователям Twenty, например, Company.displayName. Пользовательские объекты - это объекты, которые вы можете создать для хранения уникальной информации для вашей организации. Они не являются встроенными; участники вашего рабочего пространства могут создавать и настраивать пользовательские объекты для хранения информации, для которой стандартные объекты не подходят.

Схема высокого уровня

Схема высокого уровня

Как это работает

Пользовательские объекты происходят из таблиц метаданных, определяющих форму, имя и тип объектов. Вся эта информация присутствует в базе данных схемы метаданных, состоящей из таблиц:
  • DataSource: Указывает, где находятся данные.
  • Объект: Описывает объект и связывается с DataSource.
  • Поле: Описывает поля объекта и соединяет с объектом.
Чтобы добавить пользовательский объект, участник рабочего пространства сделает запрос к /metadata API. Это обновляет метаданные соответствующим образом и создает схему GraphQL на основе метаданных, храня их в кэше GQL для дальнейшего использования.
Запросите API /metadata для добавления пользовательских объектов

Для извлечения данных процесс включает выполнение запросов через конечную точку /graphql и их передачу через Query Resolver.
Запросите конечную точку /graphql для получения данных