upstream-twenty/packages/twenty-docs/l/pt/developers/contribute/capabilities/backend-development/custom-objects.mdx

---
title: Objetos personalizados
---

Os objetos são estruturas que permitem armazenar dados (registros, atributos e valores) específicos de uma organização. O Twenty vem com objetos padrão e personalizados.

Objetos padronizados são objetos embutidos com um conjunto de atributos disponíveis para todos os usuários. Exemplos de objetos padronizados na Twenty incluem Empresa e Pessoa. Os objetos padrão têm campos padrão que também estão disponíveis para todos os usuários do Twenty, como Company.displayName.

Objetos personalizados são objetos que você pode criar para armazenar informações exclusivas de sua organização. Eles não são embutidos; membros do seu espaço de trabalho podem criar e personalizar objetos personalizados para armazenar informações que os objetos padrão não são adequados.

## Esquema de alto nível

<div style={{textAlign: 'center'}}>
    <img src="/images/docs/server/custom-object-schema.png" alt="Esquema de alto nível" />
</div>

<br />

## Como Funciona

Objetos personalizados vêm de tabelas de metadados que determinam a forma, nome e tipo dos objetos. Todas essas informações estão presentes no banco de dados do esquema de metadados, consistindo em tabelas:

* **DataSource**: Detalha onde os dados estão presentes.
* **Object**: Descreve o objeto e conecta-se a um DataSource.
* **Field**: Delimita os campos de um objeto e conecta-se ao objeto.

Para adicionar um objeto personalizado, o workspaceMember consultará a API /metadata. Isso atualiza os metadados de acordo e calcula um esquema GraphQL baseado nos metadados, armazenando-o em um cache GQL para uso posterior.

<div style={{textAlign: 'center'}}>
    <img src="/images/docs/server/add-custom-objects.jpeg" alt="Consultar a API /metadata para adicionar objetos personalizados" />
</div>

<br />

Para buscar dados, o processo envolve fazer consultas através do endpoint /graphql e passá-las pelo Query Resolver.

<div style={{textAlign: 'center'}}>
    <img src="/images/docs/server/custom-object-schema.png" alt="Consultar o endpoint /graphql para buscar dados" />
</div>