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

# Пользовательские объекты

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

Стандартные объекты - это встроенные объекты с набором атрибутов, доступных для всех пользователей. В Twenty к стандартным объектам относятся Company и Person. Стандартные объекты имеют стандартные поля, которые также доступны всем пользователям Twenty, например, Company.displayName.

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

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

<div style={{textAlign: 'center'}}>
  <img src="https://mintcdn.com/twenty/atnwUMW3i9uFeVTX/images/docs/server/custom-object-schema.png?fit=max&auto=format&n=atnwUMW3i9uFeVTX&q=85&s=28186ce159ac3476d7d7a8fa71da77ef" alt="Схема высокого уровня" width="1024" height="730" data-path="images/docs/server/custom-object-schema.png" />
</div>

<br />

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

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

* **DataSource**: Указывает, где находятся данные.
* **Объект**: Описывает объект и связывается с DataSource.
* **Поле**: Описывает поля объекта и соединяет с объектом.

Чтобы добавить пользовательский объект, участник рабочего пространства сделает запрос к /metadata API. Это обновляет метаданные соответствующим образом и создает схему GraphQL на основе метаданных, храня их в кэше GQL для дальнейшего использования.

<div style={{textAlign: 'center'}}>
  <img src="https://mintcdn.com/twenty/atnwUMW3i9uFeVTX/images/docs/server/add-custom-objects.jpeg?fit=max&auto=format&n=atnwUMW3i9uFeVTX&q=85&s=39b15781ffc3e4b80db9ce704ca17253" alt="Запросите API /metadata для добавления пользовательских объектов" width="1024" height="730" data-path="images/docs/server/add-custom-objects.jpeg" />
</div>

<br />

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

<div style={{textAlign: 'center'}}>
  <img src="https://mintcdn.com/twenty/atnwUMW3i9uFeVTX/images/docs/server/custom-object-schema.png?fit=max&auto=format&n=atnwUMW3i9uFeVTX&q=85&s=28186ce159ac3476d7d7a8fa71da77ef" alt="Запросите конечную точку /graphql для получения данных" width="1024" height="730" data-path="images/docs/server/custom-object-schema.png" />
</div>