---
title: Пользовательские объекты
---

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

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

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

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

<div style={{textAlign: 'center'}}>
    <img src="/images/docs/server/custom-object-schema.png" alt="Схема высокого уровня" />
</div>

<br />

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

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

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

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

<div style={{textAlign: 'center'}}>
    <img src="/images/docs/server/add-custom-objects.jpeg" alt="Запросите API /metadata для добавления пользовательских объектов" />
</div>

<br />

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

<div style={{textAlign: 'center'}}>
    <img src="/images/docs/server/custom-object-schema.png" alt="Запросите конечную точку /graphql для получения данных" />
</div>