---
title: "Entenda atributos e relacionamentos"
category: "Spryx 101"
updatedAt: "2026-10-23T01:46:47Z"
url: "https://spryx.ai/help/primeiros-passos/entenda-atributos-e-relacionamentos"
---

# Entenda atributos e relacionamentos

Aprenda a escolher e configurar atributos para guardar os dados de cada Record e use relacionamentos para conectar Objects sem duplicar informações.

Os **atributos** são os campos que descrevem cada Record. No Object **Deal**, por exemplo, o nome, o valor, a previsão de fechamento, a pessoa responsável e a empresa relacionada são atributos.

**Pré-requisitos**

- **Permissão:** Admins e Builders podem criar e configurar atributos. Gestores e Atendentes podem visualizar e preencher os atributos dos Records aos quais têm acesso.

## Atributos de sistema e personalizados {#atributos-de-sistema-e-personalizados}

Cada Object possui **atributos de sistema**, usados pela Spryx para identificar e controlar seus Records. Eles aparecem como **Sistema** e não podem ser alterados ou arquivados.

Os **atributos personalizados** guardam as informações específicas da sua operação. Eles podem vir de um modelo do **Catálogo de Objects** ou ser criados manualmente. Na aba **Atributos**, você vê o nome, o tipo, as restrições e a origem de cada atributo.

![Aba Atributos do Object Deal, com atributos de sistema e personalizados, seus tipos, restrições e propriedades.](https://cdn.sanity.io/images/qbc9enz0/production/b6e8ad301fd67adfe742215826c4decd09ddbfda-2560x1480.png?w=1600&fit=max&auto=format)

_A aba Atributos separa os campos de sistema dos campos personalizados._

## Escolha o tipo pelo valor que será guardado {#escolha-o-tipo-pelo-valor-que-sera-guardado}

O tipo controla como o valor é preenchido, validado e exibido. Escolha de acordo com a informação, não apenas com a aparência que você quer na tabela.

- **Texto curto**, **Texto longo** e **URL** guardam conteúdo textual.
- **Número** e **Moeda** guardam valores numéricos e permitem configurar a exibição.
- **Data** guarda apenas o dia; **Data e hora** inclui horário.
- **Seleção única**, **Seleção múltipla** e **Status** trabalham com opções predefinidas.
- **Checkbox** representa uma condição marcada ou desmarcada.
- **Usuário** aponta para uma pessoa do workspace.
- **Telefone** e **E-mail** guardam dados de contato em formatos próprios.
- **Referência a record** aponta para Records de outro Object em uma única direção.
- **Relacionamento** conecta dois Objects e cria atributos nos dois lados.

![Janela Criar atributo com o seletor de tipos aberto, mostrando opções como Checkbox, Data, E-mail, Moeda, Número, Referência a record e Relacionamento.](https://cdn.sanity.io/images/qbc9enz0/production/67af7265f5f6621c6d3d67edb7fb8a0fb01964ab-2560x1600.png?w=1600&fit=max&auto=format)

_O seletor reúne os tipos disponíveis e permite buscar pelo nome._

## Crie um atributo {#crie-um-atributo}

1. Abra **Configurações do workspace → Objetos**.
2. Escolha o Object e abra a aba **Atributos**.
3. Clique em **Criar atributo**.
4. Escolha o **Tipo do atributo**.
5. Preencha **Nome** e, se ajudar o time, **Descrição (opcional)**.
6. Configure as opções específicas do tipo. Uma moeda, por exemplo, pede a moeda e o formato; uma seleção pede as opções disponíveis.
7. Defina um valor padrão e marque **Obrigatório** quando isso fizer sentido para todos os novos valores.
8. Clique em **Criar atributo**.

![Janela Criar atributo configurada para uma moeda chamada Custo estimado, em Real brasileiro, com formato de exibição, casas decimais, valor padrão e restrições.](https://cdn.sanity.io/images/qbc9enz0/production/ab1751cb6c5f42d85f7ac7c0e1627cce658d8976-2560x1600.png?w=1600&fit=max&auto=format)

_Tipos como Moeda mostram configurações próprias antes da criação._

Nem todo tipo aceita valor padrão. A restrição **Único** ainda não está disponível para atributos personalizados.

## Conecte Objects com relacionamentos {#conecte-objects-com-relacionamentos}

Use **Relacionamento** quando um Record precisa estar ligado a Records de outro Object. Essa ligação evita copiar a mesma informação em vários lugares.

Ao criar o relacionamento, escolha:

- o Object de destino;
- a cardinalidade entre os dois lados;
- o nome do atributo que aparecerá em cada Object.

As cardinalidades disponíveis são **Um para um**, **Um para muitos**, **Muitos para um** e **Muitos para muitos**. Um Deal ligado a uma Empresa, por exemplo, normalmente usa **Muitos para um**: vários Deals podem pertencer à mesma Empresa, e cada Deal aponta para uma Empresa.

![Criação de um atributo de Relacionamento entre Deals e Empresas com cardinalidade Muitos para um e os atributos Empresa e Deals nas duas pontas.](https://cdn.sanity.io/images/qbc9enz0/production/b8c19994cb3836501fd820cfb5af9fec499b0c67-2560x1600.png?w=1600&fit=max&auto=format)

_Um relacionamento cria um atributo em cada Object e mantém as duas pontas conectadas._

As duas pontas são atualizadas juntas. Arquivar ou restaurar um dos atributos do relacionamento afeta também o outro lado.

## Saiba o que pode ser alterado depois {#saiba-o-que-pode-ser-alterado-depois}

Depois da criação, você pode renomear um atributo, ajustar sua descrição e editar as configurações permitidas pelo tipo. Em atributos de seleção e status, também pode adicionar, reordenar, renomear, colorir e arquivar opções.

![Janela Editar atributo do campo Valor, com o tipo Moeda bloqueado e nome, descrição, exibição, casas decimais, valor padrão e restrições disponíveis para ajuste.](https://cdn.sanity.io/images/qbc9enz0/production/28910b0db51513470eccb16c47f0f41e359dea10-2560x1600.png?w=1600&fit=max&auto=format)

_Na edição, o tipo permanece fixo enquanto nome e configurações permitidas podem ser ajustados._

> **Atenção**
>
> **Estrutura fixa depois da criação.** O tipo, o Identifier, o Object proprietário e a cardinalidade de um relacionamento não podem ser trocados. Se essa estrutura estiver errada, crie outro atributo e migre os valores antes de arquivar o antigo.

## Arquive sem apagar os valores existentes {#arquive-sem-apagar-os-valores-existentes}

Arquivar um atributo impede novos valores em Records e formulários, mas preserva o histórico dos Records que já usam o campo. O atributo fica na área de arquivados e pode ser restaurado depois.

![Janela Arquivar atributo para o atributo Valor do Deal, informando que novos valores serão bloqueados e os valores existentes serão preservados.](https://cdn.sanity.io/images/qbc9enz0/production/998671042c8c3471e1722508b6eb5e5333bc2be0-2560x1600.png?w=1600&fit=max&auto=format)

_O arquivamento bloqueia novos valores sem apagar os dados existentes._

## A seguir {#a-seguir}

Na próxima página, vamos mostrar como os Records usam esses atributos e relacionamentos no trabalho diário.

[Entenda Records](https://spryx.ai/help/primeiros-passos/entenda-records) — Aprenda a criar, preencher, editar, relacionar e arquivar os itens concretos que sua operação acompanha na Spryx.

## Perguntas frequentes

### Qual é a diferença entre Relacionamento e Referência a record?

**Relacionamento** cria e mantém atributos nas duas pontas. **Referência a record** aponta para outro Object em uma única direção.

### Posso mudar o tipo de um atributo depois?

Não. Crie um atributo do tipo correto, transfira os valores necessários e arquive o campo antigo.

### Arquivar um atributo apaga os valores?

Não. Os valores existentes são preservados, mas o atributo deixa de aceitar novos valores até ser restaurado.