i18n - docs translations (#17434)
Created by Github action Co-authored-by: github-actions <github-actions@twenty.com>
This commit is contained in:
github-actions[bot]
committed by
GitHub
GitHub
parent
2353bc62cc
commit
e0d4492013
@@ -1,122 +1,122 @@
|
||||
---
|
||||
title: Fields
|
||||
description: Understand the role of fields and how to manage them.
|
||||
title: Campos
|
||||
description: Compreenda o papel dos campos e como geri-los.
|
||||
---
|
||||
|
||||
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
||||
|
||||
## About Fields
|
||||
## Sobre Campos
|
||||
|
||||
Fields are like columns in a spreadsheet. They store different types of data like text, numbers, or dates. Fields can be standard (built-in) or custom (the ones you create).
|
||||
Os campos são como colunas em uma planilha. Eles armazenam diferentes tipos de dados como texto, números ou datas. Os campos podem ser padrão (incorporados) ou personalizados (os que você cria).
|
||||
|
||||
### Standard Fields
|
||||
### Campos Padrão
|
||||
|
||||
Standard fields come built-in with Twenty to handle common business needs.
|
||||
Campos padrão vêm incorporados no Twenty para atender necessidades comuns de negócios.
|
||||
|
||||
For example, `First Name` and `Last Name` are standard fields in the `People` object. They store text data for individual names.
|
||||
Por exemplo, `Nome` e `Sobrenome` são campos padrão no objeto `Pessoas`. Eles armazenam dados de texto para nomes individuais.
|
||||
|
||||
You cannot delete standard fields, but you can deactivate them if you don't need them.
|
||||
Você não pode excluir campos padrão, mas pode desativá-los se não precisar deles.
|
||||
|
||||
You can also customize the options of the standard `SELECT` type fields, for example the options for the `Stage` on Opportunities.
|
||||
Também pode personalizar as opções dos campos padrão do tipo `SELECT`, por exemplo, as opções para o `Stage` em Oportunidades.
|
||||
|
||||
<img src="/images/user-guide/fields/standard-fields.png" style={{width:'100%'}} />
|
||||
|
||||
### Custom Fields
|
||||
### Campos Personalizados
|
||||
|
||||
Custom fields can be added to any object. You can store text, numbers, dates, dropdown selections, and more. Use custom fields to track information that's specific to your business.
|
||||
Campos personalizados podem ser adicionados a qualquer objeto. Você pode armazenar texto, números, datas, seleções suspensas e mais. Use campos personalizados para rastrear informações específicas do seu negócio.
|
||||
|
||||
For instance, a custom field for SpaceX could be `Rocket Active Status`, indicating if a rocket is operational.
|
||||
Por exemplo, um campo personalizado para a SpaceX pode ser `Status Ativo do Foguete`, indicando se um foguete está operacional.
|
||||
|
||||
<img src="/images/user-guide/fields/custom-fields.png" style={{width:'100%'}} />
|
||||
|
||||
## Field Types
|
||||
## Tipos de campo
|
||||
|
||||
Twenty supports various field types:
|
||||
A Twenty suporta vários tipos de campo:
|
||||
|
||||
| Type | Description | Example |
|
||||
| ------------ | ----------------------------------------------------------------- | ------------------ |
|
||||
| Address | Structured address with street, city, state, country, postal code | Office Address |
|
||||
| Array | List of text values | Tags |
|
||||
| Boolean | True/false checkbox | Is Active |
|
||||
| Currency | Monetary value with currency code | Deal Amount (USD) |
|
||||
| Date | Date values | Close Date |
|
||||
| Date & Time | Date with time | Meeting Time |
|
||||
| Domain | Website domain (used for Companies) | acme.com |
|
||||
| Email | Email addresses (with primary + additional) | Contact Email |
|
||||
| JSON | Structured JSON data | Custom metadata |
|
||||
| Links | URLs with labels (primary + secondary) | Website, LinkedIn |
|
||||
| Long Text | Multi-line text | Description, Notes |
|
||||
| Multi-Select | Multiple choices from a predefined list | Tags, Categories |
|
||||
| Number | Numeric values (integers or decimals) | Quantity, Score |
|
||||
| Phone | Phone numbers with country code | Work Phone |
|
||||
| Rating | Star rating (1-5) | Priority, Score |
|
||||
| Relation | Links to records in other objects | Company → People |
|
||||
| Select | Single choice from a predefined list | Stage, Status |
|
||||
| Text | Single line of text | Name, Title |
|
||||
| Tipo | Descrição | Exemplo |
|
||||
| ---------------- | ----------------------------------------------------------------- | ------------------------ |
|
||||
| Endereço | Endereço estruturado com rua, cidade, estado, país, código postal | Endereço do escritório |
|
||||
| Matriz | Lista de valores de texto | Etiquetas |
|
||||
| Booleano | Caixa de seleção verdadeiro/falso | Está ativo |
|
||||
| Moeda | Valor monetário com código de moeda | Valor do negócio (USD) |
|
||||
| Data | Valores de data | Data de Fecho |
|
||||
| Data e hora | Data com hora | Hora da reunião |
|
||||
| Domínio | Domínio do website (usado para Empresas) | acme.com |
|
||||
| E-mail | Endereços de e-mail (com principal + adicionais) | E-mail do contacto |
|
||||
| JSON | Dados JSON estruturados | Metadados personalizados |
|
||||
| Links | URLs com rótulos (principal + secundário) | Website, LinkedIn |
|
||||
| Texto longo | Texto com várias linhas | Descrição, Notas |
|
||||
| Seleção Múltipla | Várias escolhas de uma lista predefinida | Etiquetas, Categorias |
|
||||
| Número | Valores numéricos (inteiros ou decimais) | Quantidade, Pontuação |
|
||||
| Telefone | Números de telefone com código do país | Telefone do trabalho |
|
||||
| Avaliação | Classificação por estrelas (1-5) | Prioridade, Pontuação |
|
||||
| Relação | Ligações para registos noutros objetos | Empresa → Pessoas |
|
||||
| Selecionar | Escolha única de uma lista predefinida | Fase, Estado |
|
||||
| Texto | Uma única linha de texto | Nome, Título |
|
||||
|
||||
## Create a Custom Field
|
||||
## Criar um Campo Personalizado
|
||||
|
||||
To add a custom field to any object, follow these steps:
|
||||
Para adicionar um campo personalizado a qualquer objeto, siga estas etapas:
|
||||
|
||||
1. Go to `Settings` in the left sidebar.
|
||||
2. Go to `Data Model`, then select the object you wish to customize.
|
||||
3. Proceed by clicking on `Add Field`.
|
||||
4. Choose a field name and type that suits your requirements. Consider adding a field description for better understanding.
|
||||
1. Acesse `Configurações` na barra lateral esquerda.
|
||||
2. Acesse `Modelo de Dados`, depois selecione o objeto que você deseja personalizar.
|
||||
3. Prossiga clicando em `Adicionar Campo`.
|
||||
4. Escolha um nome e tipo de campo que atenda aos seus requisitos. Considere adicionar uma descrição do campo para um melhor entendimento.
|
||||
|
||||
Your newly created field is now available within the application's fields. To display it on a specific view, click on the options menu, then select `Fields`.
|
||||
Seu novo campo agora está disponível dentro dos campos do aplicativo. Para exibi-lo em uma vista específica, clique no menu de opções e selecione `Campos`.
|
||||
|
||||
<VimeoEmbed videoId="927628219" title="Video demonstration" />
|
||||
<VimeoEmbed videoId="927628219" title="Demonstração em vídeo" />
|
||||
|
||||
**Quick way:** Click the **+** button at the top right of any object table, then select `Customize fields`. This takes you directly to the Data Model settings.
|
||||
**Modo rápido:** Clique no botão **+** no canto superior direito de qualquer tabela de objeto e selecione `Personalizar campos`. Isso leva você diretamente para as configurações do Modelo de Dados.
|
||||
|
||||
<img src="/images/user-guide/fields/quick-new-field.png" style={{width:'100%'}} />
|
||||
|
||||
## Deactivate a Field
|
||||
## Desativar um campo
|
||||
|
||||
You can deactivate a field to hide it from the app without losing your data. Think of it as hiding the field rather than deleting it.
|
||||
Você pode desativar um campo para ocultá-lo no aplicativo sem perder seus dados. Pense nisso como esconder o campo em vez de excluí-lo.
|
||||
|
||||
Here's how you can do it:
|
||||
Veja como você pode fazer isso:
|
||||
|
||||
1. Find the field you want to deactivate in your object settings.
|
||||
1. Encontre o campo que deseja desativar nas configurações do seu objeto.
|
||||
|
||||
2. Click the three dots `⋮` next to the field to open the menu.
|
||||
2. Clique nos três pontos `⋮` ao lado do campo para abrir o menu.
|
||||
|
||||
3. Select `Deactivate` from the dropdown.
|
||||
3. Selecione `Desativar` no menu suspenso.
|
||||
|
||||
<img src="/images/user-guide/fields/deactivate-field.png" style={{width:'100%'}} />
|
||||
|
||||
What happens when you deactivate a field?
|
||||
O que acontece quando você desativa um campo?
|
||||
|
||||
1. **In the app:** The field disappears and you can't add new values to it.
|
||||
1. **No aplicativo:** O campo desaparece e você não pode adicionar novos valores a ele.
|
||||
|
||||
2. **Existing relationships:** If it's a relation field, existing connections stay but you can't create new ones.
|
||||
2. **Relações existentes:** Se for um campo de relação, conexões existentes permanecem, mas não é possível criar novas.
|
||||
|
||||
3. **API access:** You can still access the field and its data through the API.
|
||||
3. **Acesso API:** Você ainda pode acessar o campo e seus dados através da API.
|
||||
|
||||
You can reactivate Standard and Custom Fields or have the option to permanently delete them.
|
||||
Você pode reativar Campos Padrão e Personalizados ou ter a opção de excluí-los permanentemente.
|
||||
|
||||
## Make Fields Unique
|
||||
## Tornar Campos Únicos
|
||||
|
||||
Make a field unique to ensure distinct records cannot have the same value. For example, email addresses are unique for each person.
|
||||
Torne um campo único para garantir que registros distintos não possam ter o mesmo valor. Por exemplo, endereços de e-mail são únicos para cada pessoa.
|
||||
|
||||
If you get an error when setting uniqueness, check for duplicate values in your data (including deleted records).
|
||||
Se você receber um erro ao definir exclusividade, verifique se há valores duplicados nos seus dados (incluindo registros excluídos).
|
||||
|
||||
## Field Configuration Best Practices
|
||||
## Melhores Práticas de Configuração de Campos
|
||||
|
||||
### Naming Conventions and Limitations
|
||||
### Convenções de Nomeação e Limitações
|
||||
|
||||
* **Singular and plural named must be distinct**: Our GraphQL API needs distinct names for mutations
|
||||
* **Protected field names**: some names are reserved for system usage (e.g., `Type`, `Application`)
|
||||
* **Os nomes singular e plural devem ser distintos**: Nosso API GraphQL precisa de nomes distintos para mutações.
|
||||
* **Nomes de campo protegidos**: alguns nomes são reservados para utilização do sistema (por exemplo, `Type`, `Application`)
|
||||
|
||||
### Currency and Phone Fields
|
||||
### Campos de Moeda e Telefone
|
||||
|
||||
* **Default currency**: can be configured via the data model
|
||||
* **Default country codes**: can be configured for phone fields via the data model
|
||||
* **Moeda padrão**: pode ser configurada através do modelo de dados.
|
||||
* **Códigos de país padrão**: podem ser configurados para campos de telefone através do modelo de dados.
|
||||
|
||||
### Select Fields
|
||||
### Campos de Seleção
|
||||
|
||||
* **A default option can be selected** for each Select field
|
||||
* **Uma opção padrão pode ser selecionada** para cada campo de Seleção.
|
||||
|
||||
### Record Text Fields
|
||||
### Campos de Texto do Registro
|
||||
|
||||
* **Each object has one main display field**: This field appears in the leftmost column and represents the record when linked to other objects. It must be a text field. For example, People uses `Name` as the main field, so when you link a person to a company, you'll see their name in the company's view.
|
||||
* **Cada objeto tem um campo principal de exibição**: Este campo aparece na coluna mais à esquerda e representa o registro quando vinculado a outros objetos. Ele deve ser um campo de texto. Por exemplo, `Pessoas` usa `Nome` como campo principal, então quando você vincula uma pessoa a uma empresa, verá seu nome na visão da empresa.
|
||||
|
||||
@@ -1,91 +1,91 @@
|
||||
---
|
||||
title: Objects
|
||||
description: Learn about standard and custom objects in Twenty.
|
||||
title: Objetos
|
||||
description: Saiba mais sobre objetos padrão e personalizados no Twenty.
|
||||
---
|
||||
|
||||
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
||||
|
||||
## Standard Objects
|
||||
## Objetos Padrão
|
||||
|
||||
Standard objects are predefined entities in your workspace to help you get started. They're part of a shared data model accessible to all users of Twenty. You can use them as-is, customize them or deactivate them.
|
||||
Objetos padrão são entidades predefinidas no seu espaço de trabalho para ajudar você a começar. Eles fazem parte de um modelo de dados compartilhado acessível a todos os usuários do Twenty. Você pode usá-los como estão, personalizá-los ou desativá-los.
|
||||
|
||||
<img src="/images/user-guide/objects/standard-objects.png" style={{width:'100%'}} />
|
||||
|
||||
### People
|
||||
### Pessoas
|
||||
|
||||
The `People` object stores your contacts. It includes contact details and interaction history, so you can see all your customer interactions in one place.
|
||||
O objeto `Pessoas` armazena seus contatos. Inclui detalhes de contato e histórico de interação, para que você possa ver todas as interações com seus clientes em um só lugar.
|
||||
|
||||
### Company
|
||||
### Empresa
|
||||
|
||||
The `Companies` object stores your business accounts. It includes details like industry, size and location. Companies connect to both `People` and `Opportunities` objects.
|
||||
O objeto `Empresas` armazena suas contas comerciais. Inclui detalhes como setor, tamanho e localização. Empresas conectam-se tanto aos objetos `Pessoas` quanto `Oportunidades`.
|
||||
|
||||
### Opportunities
|
||||
### Oportunidades
|
||||
|
||||
The `Opportunities` object stores deal-related data. It tracks the progression of potential sales, from prospecting to closure, recording stages, deal sizes, associated account, and expected close date. You can view your sales pipeline in a kanban layout.
|
||||
O objeto `Oportunidades` armazena dados relacionados a negócios. Acompanha o progresso das vendas potenciais, da prospecção ao fechamento, registrando etapas, tamanhos de negócios, conta associada e data prevista de fechamento. Você pode visualizar seu pipeline de vendas em um layout kanban.
|
||||
|
||||
### Notes
|
||||
### Notas
|
||||
|
||||
The `Notes` object stores free-form notes that can be attached to People, Companies, Opportunities, and other records. Use notes to capture meeting summaries, important details, or any contextual information.
|
||||
O objeto `Notes` armazena anotações em formato livre que podem ser anexadas a Pessoas, Empresas, Oportunidades e outros registros. Use anotações para registrar resumos de reuniões, detalhes importantes ou qualquer informação contextual.
|
||||
|
||||
### Tasks
|
||||
### Tarefas
|
||||
|
||||
The `Tasks` object stores to-dos and action items. Tasks can be linked to People, Companies, Opportunities, and other records. Track due dates, assignees, and completion status to stay on top of your follow-ups.
|
||||
O objeto `Tasks` armazena tarefas e itens de ação. As tarefas podem ser vinculadas a Pessoas, Empresas, Oportunidades e outros registros. Acompanhe prazos, responsáveis e status de conclusão para manter o controle dos seus acompanhamentos.
|
||||
|
||||
## Custom Objects
|
||||
## Objetos personalizados
|
||||
|
||||
Custom objects let you store information that's unique to your organization and that standard objects can't handle. For example, if you're SpaceX, you may want to create a custom object for Rockets and Launches.
|
||||
Objetos personalizados permitem armazenar informações únicas para sua organização que os objetos padrão não podem acomodar. Por exemplo, se você é a SpaceX, pode querer criar um objeto personalizado para Foguetes e Lançamentos.
|
||||
|
||||
<img src="/images/user-guide/objects/custom-objects.png" style={{width:'100%'}} />
|
||||
|
||||
### Creating a New Custom Object
|
||||
### Criando um novo objeto personalizado
|
||||
|
||||
To create a new custom object:
|
||||
Para criar um novo objeto personalizado:
|
||||
|
||||
1. Go to Settings in the sidebar on the left.
|
||||
2. Under Workspace, go to Data model. Here you'll be able to see an overview of all your existing Standard and Custom objects (both active and disabled).
|
||||
1. Vá para Configurações na barra lateral esquerda.
|
||||
2. Em Espaço de Trabalho, vá para Modelo de Dados. Aqui você poderá ver uma visão geral de todos os seus objetos Padrão e Personalizados (ativos e desativados).
|
||||
|
||||
<VimeoEmbed videoId="926288174" title="Video demonstration" />
|
||||
<VimeoEmbed videoId="926288174" title="Demonstração em vídeo" />
|
||||
|
||||
3. Click on `+ New object` at the top. Enter the name (both singular and plural), choose an icon, and add a description for your custom object and hit Save (at the top right). Using Listing as an example of custom object, the singular would be "listing" and the plural would be "listings" along with a description like "Listings that hosts created to showcase their property."
|
||||
3. Clique em `+ Novo objeto` no topo. Digite o nome (tanto no singular quanto no plural), escolha um ícone e adicione uma descrição para o seu objeto personalizado e clique em Salvar (no canto superior direito). Usando Listagem como exemplo de objeto personalizado, o singular seria "listagem" e o plural seria "listagens", juntamente com uma descrição como "Listagens que anfitriões criaram para exibir sua propriedade."
|
||||
|
||||
4. Your custom object is now created and will appear in your sidebar. You can start adding records to it right away.
|
||||
4. Seu objeto personalizado foi criado e aparecerá na sua barra lateral. Você já pode começar a adicionar registros a ele.
|
||||
|
||||
## Managing Objects
|
||||
## Gerenciando objetos
|
||||
|
||||
### Deactivating Objects
|
||||
### Desativando objetos
|
||||
|
||||
If you don't need a standard or custom object:
|
||||
Se você não precisar de um objeto padrão ou personalizado:
|
||||
|
||||
1. Go to Settings → Data Model
|
||||
2. Find the object you want to deactivate
|
||||
3. Click the toggle to deactivate it
|
||||
4. The object will be hidden from your workspace but data is preserved
|
||||
1. Vá para Configurações → Modelo de Dados
|
||||
2. Encontre o objeto que você deseja desativar
|
||||
3. Clique no botão de alternância para desativá-lo
|
||||
4. O objeto ficará oculto no seu espaço de trabalho, mas os dados serão preservados
|
||||
|
||||
### Reactivating Objects
|
||||
### Reativando objetos
|
||||
|
||||
To bring back a deactivated object:
|
||||
Para restaurar um objeto desativado:
|
||||
|
||||
1. Go to Settings → Data Model
|
||||
2. Look for deactivated objects (they'll be grayed out)
|
||||
3. Click the toggle to reactivate it
|
||||
4. The object and all its data will be restored
|
||||
1. Vá para Configurações → Modelo de Dados
|
||||
2. Procure por objetos desativados (eles aparecerão acinzentados)
|
||||
3. Clique no botão de alternância para reativá-lo
|
||||
4. O objeto e todos os seus dados serão restaurados
|
||||
|
||||
## Best Practices
|
||||
## Melhores Práticas
|
||||
|
||||
### When to Create Custom Objects
|
||||
### Quando criar objetos personalizados
|
||||
|
||||
* **Unique business entities**: Things specific to your industry or process
|
||||
* **Complex relationships**: When you need to track connections between multiple entities
|
||||
* **Scalable data**: When you might have many instances of something
|
||||
* **Entidades de negócio exclusivas**: Itens específicos do seu setor ou processo
|
||||
* **Relações complexas**: Quando você precisa acompanhar conexões entre várias entidades
|
||||
* **Dados escaláveis**: Quando você pode ter muitas instâncias de algo
|
||||
|
||||
### When to Use Fields Instead
|
||||
### Quando usar campos em vez de objetos
|
||||
|
||||
* **Simple attributes**: Properties that describe existing objects
|
||||
* **Categories or labels**: Ways to classify existing records
|
||||
* **Single values**: Information that doesn't need its own lifecycle
|
||||
* **Atributos simples**: Propriedades que descrevem objetos existentes
|
||||
* **Categorias ou rótulos**: Formas de classificar registros existentes
|
||||
* **Valores únicos**: Informações que não precisam de um ciclo de vida próprio
|
||||
|
||||
### Object Naming
|
||||
### Nomenclatura de objetos
|
||||
|
||||
* **Use clear, descriptive names**: Make it obvious what the object represents
|
||||
* **Follow conventions**: Use singular for the object name, plural for the collection
|
||||
* **Consider your team**: Choose names everyone will understand
|
||||
* **Use nomes claros e descritivos**: Torne óbvio o que o objeto representa
|
||||
* **Siga convenções**: Use singular para o nome do objeto e plural para a coleção
|
||||
* **Considere sua equipe**: Escolha nomes que todos entendam
|
||||
|
||||
@@ -1,92 +1,96 @@
|
||||
---
|
||||
title: Relation Fields
|
||||
description: Connect records across different objects using relation fields.
|
||||
title: Campos de Relação
|
||||
description: Ligue registos entre diferentes objetos usando campos de relação.
|
||||
---
|
||||
|
||||
## Types of Relations
|
||||
## Tipos de Relações
|
||||
|
||||
### One-to-Many
|
||||
### Um-para-Muitos
|
||||
|
||||
One record in Object A can be linked to many records in Object B.
|
||||
Um registo no Objeto A pode estar ligado a muitos registos no Objeto B.
|
||||
|
||||
**Example:** One Company can have many People (employees).
|
||||
**Exemplo:** Uma Empresa pode ter muitas Pessoas (colaboradores).
|
||||
|
||||
### Many-to-One
|
||||
### Muitos-para-Um
|
||||
|
||||
Many records in Object A can be linked to one record in Object B.
|
||||
Muitos registos no Objeto A podem estar ligados a um registo no Objeto B.
|
||||
|
||||
**Example:** Many People can belong to one Company.
|
||||
**Exemplo:** Muitas Pessoas podem pertencer a uma Empresa.
|
||||
|
||||
### Relations to Multiple Object Types
|
||||
### Relações com Múltiplos Tipos de Objeto
|
||||
|
||||
Some objects can link to multiple object types on one side of the relation.
|
||||
Alguns objetos podem ligar-se a vários tipos de objeto de um dos lados da relação.
|
||||
|
||||
**Example:** A Note can be attached to one Person AND one Company AND one Opportunity simultaneously. The Note is on the "many" side, connecting to multiple "one" sides.
|
||||
**Exemplo:** Uma Nota pode ser anexada a uma Pessoa E a uma Empresa E a uma Oportunidade em simultâneo. A Nota está no lado "muitos", ligando-se a vários lados "um".
|
||||
|
||||
<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
|
||||
|
||||
Similarly, a Project (on the "one" side) could receive links from multiple People, multiple Companies, and multiple Notes.
|
||||
De forma semelhante, um Projeto (do lado "um") pode receber ligações de várias Pessoas, várias Empresas e várias Notas.
|
||||
|
||||
<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
|
||||
|
||||
<Warning>
|
||||
**Import/Export limitation**: Relations pointing to multiple object types are not yet supported for CSV import/export. This is on our roadmap.
|
||||
**Limitação de Importação/Exportação**: Relações que apontam para vários tipos de objeto ainda não são suportadas para importação/exportação CSV. Isto está no nosso roadmap.
|
||||
</Warning>
|
||||
|
||||
### Many-to-Many
|
||||
### Muitos-para-Muitos
|
||||
|
||||
Many records in Object A can be linked to many records in Object B.
|
||||
Muitos registos no Objeto A podem estar ligados a muitos registos no Objeto B.
|
||||
|
||||
**Example:** Many People can be linked to many Projects, and vice versa.
|
||||
**Exemplo:** Muitas Pessoas podem estar ligadas a muitos Projetos e vice-versa.
|
||||
|
||||
As relações muitos-para-muitos utilizam um padrão de **objeto de junção**: um objeto intermediário que conecta ambos os lados. Com o recurso de relação de junção, Twenty exibe diretamente os registros finais vinculados, ocultando o objeto intermediário da IU.
|
||||
|
||||
<img src="/images/user-guide/fields/junction-relation-diagram.png" style={{width:'100%'}} />
|
||||
|
||||
<Warning>
|
||||
**Many-to-Many is not yet supported.**
|
||||
|
||||
This relation type is planned for H1 2026. As a workaround, create an intermediate "junction" object (e.g., "Project Assignments") that has Many-to-One relations to both objects.
|
||||
**Recurso de laboratório**: As relações de junção devem ser ativadas em **Configurações → Atualizações → Lab** antes do uso.
|
||||
</Warning>
|
||||
|
||||
## Creating a Relation Field
|
||||
Consulte [Como criar relações muitos-para-muitos](/l/pt/user-guide/data-model/how-tos/create-many-to-many-relations) para um guia passo a passo completo.
|
||||
|
||||
1. Go to **Settings → Data Model**
|
||||
2. Select the object where you want to add the relation
|
||||
3. Click **+ Add Field**
|
||||
4. Select **Relation** as the field type
|
||||
5. Choose the target object(s) to relate to
|
||||
6. Configure the relation settings:
|
||||
* **Field name on source object**: The name of the relation field on the object you're editing
|
||||
* **Field name on destination object**: The name of the relation field that will appear on the target object
|
||||
* Relation type (one-to-many, many-to-one)
|
||||
7. Click **Save**
|
||||
## Criar um Campo de Relação
|
||||
|
||||
## Standard Relations
|
||||
1. Vá a **Definições → Modelo de Dados**
|
||||
2. Selecione o objeto onde pretende adicionar a relação
|
||||
3. Clique em **+ Adicionar campo**
|
||||
4. Selecione **Relação** como o tipo de campo
|
||||
5. Escolha o(s) objeto(s) de destino a relacionar
|
||||
6. Configure as definições da relação:
|
||||
* **Nome do campo no objeto de origem**: O nome do campo de relação no objeto que está a editar
|
||||
* **Nome do campo no objeto de destino**: O nome do campo de relação que aparecerá no objeto de destino
|
||||
* Tipo de relação (um-para-muitos, muitos-para-um)
|
||||
7. Clique em **Salvar**
|
||||
|
||||
Twenty comes with pre-built relations between standard objects:
|
||||
## Relações Padrão
|
||||
|
||||
| From Object | To Object | Relation Type |
|
||||
| ------------- | --------- | ------------- |
|
||||
| People | Companies | Many-to-One |
|
||||
| Opportunities | Companies | Many-to-One |
|
||||
| Opportunities | People | Many-to-One |
|
||||
O Twenty inclui relações pré-criadas entre objetos padrão:
|
||||
|
||||
## Best Practices
|
||||
| Objeto de Origem | Objeto de Destino | Tipo de Relação |
|
||||
| ---------------- | ----------------- | --------------- |
|
||||
| Pessoas | Empresas | Muitos-para-Um |
|
||||
| Oportunidades | Empresas | Muitos-para-Um |
|
||||
| Oportunidades | Pessoas | Muitos-para-Um |
|
||||
|
||||
### Planning Relations
|
||||
## Melhores Práticas
|
||||
|
||||
* **Map your data model**: Plan relations before creating them
|
||||
* **Consider direction**: Think about which object "owns" the relationship
|
||||
* **Avoid circular dependencies**: Keep your data model clean
|
||||
### Planear Relações
|
||||
|
||||
### Naming Relations
|
||||
* **Mapeie o seu modelo de dados**: Planeie as relações antes de as criar
|
||||
* **Considere a direção**: Pense em que objeto "detém" a relação
|
||||
* **Evite dependências circulares**: Mantenha o seu modelo de dados limpo
|
||||
|
||||
* **Use clear names**: Make it obvious what the relation represents
|
||||
* **Be consistent**: Use similar naming patterns across relations
|
||||
* **Consider both sides**: Name both sides of the relation appropriately
|
||||
### Nomear Relações
|
||||
|
||||
### Performance
|
||||
* **Use nomes claros**: Torne óbvio o que a relação representa
|
||||
* **Seja consistente**: Utilize padrões de nomenclatura semelhantes em todas as relações
|
||||
* **Considere ambos os lados**: Nomeie adequadamente ambos os lados da relação
|
||||
|
||||
* **Don't over-relate**: Too many relations can slow down your workspace
|
||||
### Desempenho
|
||||
|
||||
## Limitations
|
||||
* **Não exagere nas relações**: Relações em excesso podem abrandar o seu espaço de trabalho
|
||||
|
||||
* **Deleting relations** removes the link but not the related records
|
||||
* **Circular relations** should be avoided for data integrity
|
||||
## Limitações
|
||||
|
||||
* **Eliminar relações** remove a ligação mas não os registos relacionados
|
||||
* **Relações circulares** devem ser evitadas para garantir a integridade dos dados
|
||||
|
||||
@@ -1,72 +1,72 @@
|
||||
---
|
||||
title: Create Custom Fields
|
||||
description: Step-by-step guide to adding custom fields to any object.
|
||||
title: Criar Campos Personalizados
|
||||
description: Guia passo a passo para adicionar campos personalizados a qualquer objeto.
|
||||
---
|
||||
|
||||
Custom fields let you capture information specific to your business. Add them to any object—standard or custom.
|
||||
Os campos personalizados permitem capturar informações específicas do seu negócio. Adicione-os a qualquer objeto — padrão ou personalizado.
|
||||
|
||||
## Steps
|
||||
## Etapas
|
||||
|
||||
1. Go to **Settings → Data Model**
|
||||
2. Select the object you want to add a field to
|
||||
3. Click **+ Add Field**
|
||||
4. Choose a **field type** (see [Fields](/l/pt/user-guide/data-model/capabilities/fields) for all types)
|
||||
5. Enter the **field name** and optional description
|
||||
6. Configure field-specific settings (see below)
|
||||
7. Click **Save**
|
||||
1. Vá a **Definições → Modelo de Dados**
|
||||
2. Selecione o objeto ao qual pretende adicionar um campo
|
||||
3. Clique em **+ Adicionar campo**
|
||||
4. Escolha um **tipo de campo** (consulte [Campos](/l/pt/user-guide/data-model/capabilities/fields) para ver todos os tipos)
|
||||
5. Introduza o **nome do campo** e uma descrição opcional
|
||||
6. Configure definições específicas do campo (ver abaixo)
|
||||
7. Clique em **Salvar**
|
||||
|
||||
**Quick method:** Click the **+** at the end of column headers in any table view → **Customize fields**.
|
||||
**Método rápido:** Clique em **+** no final dos cabeçalhos de coluna em qualquer visualização de tabela → **Personalizar campos**.
|
||||
|
||||
## Show the Field in Views
|
||||
## Mostrar o campo nas visualizações
|
||||
|
||||
New fields aren't automatically visible. To display:
|
||||
Novos campos não são visíveis automaticamente. Para exibir:
|
||||
|
||||
1. Open the object's table view
|
||||
2. Click **Options → Fields**
|
||||
3. Click the **eye icon** next to your field to show it
|
||||
4. Drag to reorder
|
||||
1. Abra a visualização de tabela do objeto
|
||||
2. Clique em **Opções → Campos**
|
||||
3. Clique no **ícone de olho** ao lado do seu campo para mostrá-lo
|
||||
4. Arraste para reordenar
|
||||
|
||||
## Configuration Options
|
||||
## Opções de Configuração
|
||||
|
||||
### For Select / Multi-Select
|
||||
### Para Seleção / Seleção múltipla
|
||||
|
||||
1. Click **+ Add option** to create choices
|
||||
2. Set a **default option** if desired
|
||||
3. Drag to reorder options
|
||||
1. Clique em **+ Adicionar opção** para criar opções
|
||||
2. Defina uma **opção predefinida** se desejar
|
||||
3. Arraste para reordenar as opções
|
||||
|
||||
<Note>
|
||||
**Use API names for imports.** Enable **Advanced mode** in Settings to see API names. See [Field Mapping](/l/pt/user-guide/data-migration/capabilities/field-mapping).
|
||||
**Use nomes de API para importações.** Ative o **modo Avançado** em Definições para ver os nomes de API. Consulte [Mapeamento de Campos](/l/pt/user-guide/data-migration/capabilities/field-mapping).
|
||||
</Note>
|
||||
|
||||
### For Currency Fields
|
||||
### Para Campos de Moeda
|
||||
|
||||
Set the **default currency** (USD, EUR, etc.) for new records.
|
||||
Defina a **moeda predefinida** (USD, EUR, etc.) para novos registos.
|
||||
|
||||
### For Phone Fields
|
||||
### Para Campos de Telefone
|
||||
|
||||
Set the **default country code** to pre-fill for new phone numbers.
|
||||
Defina o **código de país predefinido** para preencher automaticamente novos números de telefone.
|
||||
|
||||
### Making a Field Unique
|
||||
### Tornar um Campo Único
|
||||
|
||||
Toggle **Unique** to prevent duplicate values across records.
|
||||
Ative a opção **Único** para impedir valores duplicados entre registos.
|
||||
|
||||
<Note>
|
||||
If duplicates exist (including in deleted records), you'll get an error. Clean up duplicates first.
|
||||
Se existirem duplicados (incluindo em registos eliminados), ocorrerá um erro. Elimine os duplicados primeiro.
|
||||
</Note>
|
||||
|
||||
### Setting Default Values
|
||||
### Definir Valores Predefinidos
|
||||
|
||||
For Select fields, you can choose which option is pre-selected for new records. For Checkbox fields, set whether it's checked or unchecked by default.
|
||||
Para campos de Seleção, pode escolher qual opção é pré-selecionada para novos registos. Para campos de Caixa de seleção, defina se fica marcado ou desmarcado por predefinição.
|
||||
|
||||
## Deactivating a Field
|
||||
## Desativar um Campo
|
||||
|
||||
1. Go to **Settings → Data Model**
|
||||
2. Find the field
|
||||
3. Click **⋮ → Deactivate**
|
||||
1. Vá a **Definições → Modelo de Dados**
|
||||
2. Localize o campo
|
||||
3. Clique em **⋮ → Desativar**
|
||||
|
||||
Data is preserved. You can reactivate or permanently delete later.
|
||||
Os dados são preservados. Pode reativar ou eliminar permanentemente mais tarde.
|
||||
|
||||
## Related
|
||||
## Relacionados
|
||||
|
||||
* [Fields](/l/pt/user-guide/data-model/capabilities/fields) — all field types explained
|
||||
* [Data Model FAQ](/l/pt/user-guide/data-model/how-tos/data-model-faq) — common questions
|
||||
* [Campos](/l/pt/user-guide/data-model/capabilities/fields) — todos os tipos de campo explicados
|
||||
* [Perguntas frequentes sobre o modelo de dados](/l/pt/user-guide/data-model/how-tos/data-model-faq) — perguntas comuns
|
||||
|
||||
@@ -1,51 +1,51 @@
|
||||
---
|
||||
title: Create Custom Objects
|
||||
description: Step-by-step guide to creating custom objects in Twenty.
|
||||
title: Criar Objetos Personalizados
|
||||
description: Guia passo a passo para criar objetos personalizados no Twenty.
|
||||
---
|
||||
|
||||
Custom objects let you store information unique to your business that standard objects don't cover. For example: Projects, Products, Tickets, or Listings.
|
||||
Objetos personalizados permitem armazenar informações exclusivas do seu negócio que os objetos padrão não cobrem. Por exemplo: Projetos, Produtos, Tickets ou Listagens.
|
||||
|
||||
<Note>
|
||||
**Not sure if you need an object or a field?** See [Understanding Your Data Model](/l/pt/user-guide/data-model/overview) for guidance.
|
||||
**Não tem a certeza se precisa de um objeto ou de um campo?** Consulte [Compreender o seu modelo de dados](/l/pt/user-guide/data-model/overview) para orientação.
|
||||
</Note>
|
||||
|
||||
## Steps
|
||||
## Etapas
|
||||
|
||||
1. Go to **Settings → Data Model**
|
||||
2. Click **+ New object**
|
||||
3. Fill in:
|
||||
* **Singular name** (e.g., "Listing")
|
||||
* **Plural name** (e.g., "Listings")
|
||||
* **Icon**
|
||||
* **Description** (optional)
|
||||
4. Click **Save**
|
||||
1. Vá a **Definições → Modelo de Dados**
|
||||
2. Clique em **+ Novo objeto**
|
||||
3. Preencha:
|
||||
* **Nome no singular** (por exemplo, "Listagem")
|
||||
* **Nome no plural** (por exemplo, "Listagens")
|
||||
* **Ícone**
|
||||
* **Descrição** (opcional)
|
||||
4. Clique em **Salvar**
|
||||
|
||||
Your object appears in the sidebar immediately.
|
||||
O seu objeto aparece imediatamente na barra lateral.
|
||||
|
||||
## Next: Add Fields
|
||||
## A seguir: Adicionar campos
|
||||
|
||||
New objects start with basic fields. Add custom fields to capture the data you need:
|
||||
Novos objetos começam com campos básicos. Adicione campos personalizados para capturar os dados de que precisa:
|
||||
|
||||
1. In **Settings → Data Model**, select your object
|
||||
2. Click **+ Add Field**
|
||||
3. Choose a field type, configure, and save
|
||||
1. Em **Definições → Modelo de Dados**, selecione o seu objeto
|
||||
2. Clique em **+ Adicionar campo**
|
||||
3. Escolha um tipo de campo, configure e guarde
|
||||
|
||||
See [How to Create Custom Fields](/l/pt/user-guide/data-model/how-tos/create-custom-fields) for details on field types and configuration.
|
||||
Consulte [Como criar campos personalizados](/l/pt/user-guide/data-model/how-tos/create-custom-fields) para obter detalhes sobre os tipos de campo e a configuração.
|
||||
|
||||
## Connecting to Other Objects
|
||||
## Ligar a outros objetos
|
||||
|
||||
To link your object to People, Companies, or other objects, create a relation field. See [How to Create Relation Fields](/l/pt/user-guide/data-model/how-tos/create-relation-fields).
|
||||
Para ligar o seu objeto a Pessoas, Empresas ou outros objetos, crie um campo de relação. Consulte [Como criar campos de relação](/l/pt/user-guide/data-model/how-tos/create-relation-fields).
|
||||
|
||||
## Deactivating an Object
|
||||
## Desativar um objeto
|
||||
|
||||
If you no longer need an object:
|
||||
Se já não precisar de um objeto:
|
||||
|
||||
1. Go to **Settings → Data Model**
|
||||
2. Toggle the object off
|
||||
1. Vá a **Definições → Modelo de Dados**
|
||||
2. Desative o objeto
|
||||
|
||||
The object is hidden but data is preserved. You can reactivate or permanently delete later.
|
||||
O objeto fica oculto, mas os dados são preservados. Pode reativar ou eliminar permanentemente mais tarde.
|
||||
|
||||
## Related
|
||||
## Relacionados
|
||||
|
||||
* [Objects](/l/pt/user-guide/data-model/capabilities/objects) — standard vs custom objects
|
||||
* [Data Model FAQ](/l/pt/user-guide/data-model/how-tos/data-model-faq) — common questions
|
||||
* [Objetos](/l/pt/user-guide/data-model/capabilities/objects) — objetos padrão vs. personalizados
|
||||
* [Perguntas frequentes sobre o modelo de dados](/l/pt/user-guide/data-model/how-tos/data-model-faq) — perguntas comuns
|
||||
|
||||
+180
@@ -0,0 +1,180 @@
|
||||
---
|
||||
title: Criar Relações Muitos-para-muitos
|
||||
description: Conecte registros em que muitos itens de ambos os lados podem ser vinculados usando objetos de junção.
|
||||
---
|
||||
|
||||
Relações muitos-para-muitos permitem conectar vários registros em ambos os lados. Por exemplo: muitas Pessoas podem trabalhar em muitos Projetos, e cada Projeto pode ter muitas Pessoas.
|
||||
|
||||
<Warning>
|
||||
**Recurso de Laboratório**: As relações de junção estão atualmente no Lab. Ative-as em **Settings → Updates → Lab** antes de seguir este guia.
|
||||
</Warning>
|
||||
|
||||
<Note>
|
||||
Este recurso também requer que o **Modo Avançado** esteja ativado (alternador no canto inferior direito de Settings).
|
||||
</Note>
|
||||
|
||||
## Quando Usar Muitos-para-Muitos
|
||||
|
||||
Use muitos-para-muitos quando ambos os lados de uma relação podem ter múltiplas conexões:
|
||||
|
||||
| Relação | Exemplo |
|
||||
| -------------------- | ------------------------------------------------------------------------------------- |
|
||||
| Pessoas ↔ Projetos | Uma pessoa trabalha em vários projetos; um projeto tem vários membros da equipe |
|
||||
| Empresas ↔ Etiquetas | Uma empresa pode ter várias etiquetas; uma etiqueta pode se aplicar a várias empresas |
|
||||
| Produtos ↔ Pedidos | Um produto pode estar em vários pedidos; um pedido contém vários produtos |
|
||||
|
||||
## Como Funciona
|
||||
|
||||
A Twenty usa um padrão de **objeto de junção** para relações muitos-para-muitos. Um objeto de junção fica entre dois objetos e mantém as conexões:
|
||||
|
||||
```
|
||||
People ←→ Project Assignments ←→ Projects
|
||||
```
|
||||
|
||||
O objeto **Atribuições de Projeto** (junção) tem:
|
||||
|
||||
* Uma relação com Pessoas (muitos-para-um)
|
||||
* Uma relação com Projetos (muitos-para-um)
|
||||
|
||||
Ao ativar o alternador de relação de junção, a Twenty exibe os registros vinculados diretamente em vez de mostrar os registros intermediários de junção.
|
||||
|
||||
## Pré-requisitos
|
||||
|
||||
1. **Ative Relações de Junção no Lab**: Vá para **Settings → Updates → Lab** e ative **Junction Relations**
|
||||
2. **Ative o Modo Avançado**: Ative o **Modo Avançado** no canto inferior direito da barra lateral de Settings
|
||||
3. Planeje seu modelo de dados:
|
||||
* Quais dois objetos você está conectando?
|
||||
* Qual deve ser o nome do objeto de junção?
|
||||
|
||||
## Etapa 1: Criar o Objeto de Junção
|
||||
|
||||
Primeiro, crie o objeto intermediário que manterá as conexões.
|
||||
|
||||
1. Vá a **Definições → Modelo de Dados**
|
||||
2. Clique em **+ Novo objeto**
|
||||
3. Dê um nome descritivo (por exemplo, "Atribuição de Projeto", "Membro da Equipe", "Pedido de Produto")
|
||||
4. Clique em **Salvar**
|
||||
|
||||
<Tip>
|
||||
**Convenção de nomenclatura**: Use um nome que descreva a relação, como "Atribuição de Projeto" ou "Participação na Equipe". Isso torna o modelo de dados mais fácil de entender.
|
||||
</Tip>
|
||||
|
||||
## Etapa 2: Criar Relações a partir do Objeto de Junção
|
||||
|
||||
Adicione campos de relação do objeto de junção para ambos os objetos que deseja conectar.
|
||||
|
||||
### Primeira Relação (Junção → Objeto A)
|
||||
|
||||
1. Selecione seu objeto de junção em **Settings → Data Model**
|
||||
2. Clique em **+ Adicionar campo**
|
||||
3. Escolha **Relação** como o tipo de campo
|
||||
4. Selecione o primeiro objeto (por exemplo, "Pessoas")
|
||||
5. Defina o tipo de relação como **Muitos-para-um** (muitas atribuições podem se vincular a uma pessoa)
|
||||
6. Nomeie os campos:
|
||||
* Campo na junção: por exemplo, "Pessoa"
|
||||
* Campo em Pessoas: por exemplo, "Atribuições de Projeto"
|
||||
7. Clique em **Salvar**
|
||||
|
||||
### Segunda Relação (Junção → Objeto B)
|
||||
|
||||
1. Ainda no objeto de junção, clique em **+ Add Field**
|
||||
2. Escolha **Relação** como o tipo de campo
|
||||
3. Selecione o segundo objeto (por exemplo, "Projetos")
|
||||
4. Defina o tipo de relação como **Muitos-para-um**
|
||||
5. Nomeie os campos:
|
||||
* Campo na junção: por exemplo, "Projeto"
|
||||
* Campo em Projetos: por exemplo, "Membros da Equipe"
|
||||
6. Clique em **Salvar**
|
||||
|
||||
## Etapa 3: Configurar a Exibição da Relação de Junção
|
||||
|
||||
Agora configure os objetos de origem para exibir diretamente os registros vinculados, ignorando o objeto de junção intermediário.
|
||||
|
||||
1. Vá a **Definições → Modelo de Dados**
|
||||
2. Selecione o primeiro objeto (por exemplo, "Pessoas")
|
||||
3. Encontre o campo de relação apontando para o objeto de junção (por exemplo, "Atribuições de Projeto")
|
||||
4. Clique para editar o campo
|
||||
5. Ative **"Esta é uma relação com um objeto de junção"**
|
||||
6. Selecione a **Relação de destino** (por exemplo, "Projeto" — o campo na junção que aponta para o outro lado)
|
||||
7. Clique em **Salvar**
|
||||
|
||||
{/* TODO: Add image
|
||||
<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}}/>
|
||||
*/}
|
||||
|
||||
Repita para o outro objeto:
|
||||
|
||||
1. Selecione "Projetos" em Data Model
|
||||
2. Edite o campo de relação "Membros da Equipe"
|
||||
3. Ative o alternador de junção
|
||||
4. Selecione "Pessoa" como a relação de destino
|
||||
5. Salvar
|
||||
|
||||
## Resultado
|
||||
|
||||
Após a configuração:
|
||||
|
||||
* Em um registro de **Pessoa**, o campo "Atribuições de Projeto" exibe **Projetos** diretamente (não registros de atribuição)
|
||||
* Em um registro de **Projeto**, o campo "Membros da Equipe" exibe **Pessoas** diretamente
|
||||
|
||||
O objeto de junção ainda existe e armazena as conexões, mas a interface apresenta uma visualização muitos-para-muitos mais limpa.
|
||||
|
||||
## Exemplo: Pessoas ↔ Projetos
|
||||
|
||||
Aqui está um passo a passo completo:
|
||||
|
||||
### Criar o Objeto de Junção
|
||||
|
||||
* Nome: **Atribuição de Projeto**
|
||||
* Descrição: "Vincula pessoas aos projetos em que trabalham"
|
||||
|
||||
### Adicionar Relações
|
||||
|
||||
1. **Atribuição de Projeto → Pessoas**
|
||||
* Tipo: Muitos-para-um
|
||||
* Campo em Atribuição: "Pessoa"
|
||||
* Campo em Pessoas: "Atribuições de Projeto"
|
||||
|
||||
2. **Atribuição de Projeto → Projetos**
|
||||
* Tipo: Muitos-para-um
|
||||
* Campo em Atribuição: "Projeto"
|
||||
* Campo em Projetos: "Membros da Equipe"
|
||||
|
||||
### Configurar Exibição de Junção
|
||||
|
||||
1. No objeto **Pessoas**:
|
||||
* Edite o campo "Atribuições de Projeto"
|
||||
* Ative o alternador de junção
|
||||
* Destino: "Projeto"
|
||||
|
||||
2. No objeto **Projetos**:
|
||||
* Edite o campo "Membros da Equipe"
|
||||
* Ative o alternador de junção
|
||||
* Destino: "Pessoa"
|
||||
|
||||
### Use
|
||||
|
||||
* Abra um registro de Pessoa → Veja seus Projetos diretamente
|
||||
* Abra um registro de Projeto → Veja os membros da equipe diretamente
|
||||
* Crie novas conexões de qualquer um dos lados
|
||||
|
||||
## Adicionando Dados Extras às Conexões
|
||||
|
||||
Como o objeto de junção é um objeto real, você pode adicionar campos personalizados para armazenar informações sobre a relação:
|
||||
|
||||
* **Função**: "Desenvolvedor", "Designer", "Gerente"
|
||||
* **Data de Início**: Quando começaram no projeto
|
||||
* **Horas Alocadas**: Horas semanais neste projeto
|
||||
|
||||
Para acessar esses dados, navegue diretamente até o objeto de junção ou consulte-o via API.
|
||||
|
||||
## Limitações
|
||||
|
||||
* **Importação/Exportação CSV**: A importação de relações muitos-para-muitos diretamente não é suportada. Em vez disso, importe registros para o objeto de junção.
|
||||
* **Filtros**: A filtragem por relações muitos-para-muitos pode ter opções limitadas.
|
||||
|
||||
## Relacionados
|
||||
|
||||
* [Campos de Relação](/l/pt/user-guide/data-model/capabilities/relation-fields) — tipos de relação explicados
|
||||
* [Criar Objetos Personalizados](/l/pt/user-guide/data-model/how-tos/create-custom-objects) — como criar objetos
|
||||
* [Criar Campos de Relação](/l/pt/user-guide/data-model/how-tos/create-relation-fields) — configuração básica de relação
|
||||
+37
-37
@@ -1,60 +1,60 @@
|
||||
---
|
||||
title: Create Relation Fields
|
||||
description: Step-by-step guide to connecting objects with relation fields.
|
||||
title: Criar Campos de Relação
|
||||
description: Guia passo a passo para conectar objetos com campos de relação.
|
||||
---
|
||||
|
||||
Relation fields connect records from different objects—for example, linking People to Companies.
|
||||
Campos de relação conectam registros de objetos diferentes — por exemplo, vinculando Pessoas a Empresas.
|
||||
|
||||
<Note>
|
||||
**Relation names cannot be changed after creation** (they affect the API). Plan your names carefully.
|
||||
**Os nomes das relações não podem ser alterados após a criação** (eles afetam a API). Planeje os nomes com cuidado.
|
||||
</Note>
|
||||
|
||||
## Before You Start
|
||||
## Antes de Começar
|
||||
|
||||
Decide:
|
||||
Decida:
|
||||
|
||||
* Which objects are you connecting? (e.g., People → Companies)
|
||||
* Which is the "one" side? (e.g., Company)
|
||||
* Which is the "many" side? (e.g., People — many people work at one company)
|
||||
* What should the field be named on each side?
|
||||
* Quais objetos você está conectando? (por exemplo, Pessoas → Empresas)
|
||||
* Qual é o lado "um"? (por exemplo, Empresa)
|
||||
* Qual é o lado "muitos"? (por exemplo, Pessoas — muitas pessoas trabalham em uma empresa)
|
||||
* Como o campo deve ser nomeado em cada lado?
|
||||
|
||||
See [Relation Fields](/l/pt/user-guide/data-model/capabilities/relation-fields) for relation types explained.
|
||||
Veja [Campos de relação](/l/pt/user-guide/data-model/capabilities/relation-fields) para entender os tipos de relação.
|
||||
|
||||
## Steps
|
||||
## Etapas
|
||||
|
||||
1. Go to **Settings → Data Model**
|
||||
2. Select the object where you want the relation (typically the "many" side)
|
||||
3. Click **+ Add Field**
|
||||
4. Select **Relation** as the field type
|
||||
5. Choose the **target object**
|
||||
6. Select **One-to-Many** or **Many-to-One**
|
||||
7. Enter field names for **both sides** of the relation
|
||||
8. Click **Save**
|
||||
1. Vá para **Configurações → Modelo de Dados**
|
||||
2. Selecione o objeto no qual você deseja a relação (normalmente o lado "muitos")
|
||||
3. Clique em **+ Adicionar campo**
|
||||
4. Selecione **Relação** como o tipo de campo
|
||||
5. Escolha o **objeto de destino**
|
||||
6. Selecione **Um-para-muitos** ou **Muitos-para-um**
|
||||
7. Insira os nomes dos campos para **ambos os lados** da relação
|
||||
8. Clique em **Salvar**
|
||||
|
||||
## Example: People → Companies
|
||||
## Exemplo: Pessoas → Empresas
|
||||
|
||||
* Go to **Settings → Data Model → People**
|
||||
* Add a Relation field
|
||||
* Target: **Companies**
|
||||
* Type: **Many-to-One**
|
||||
* Field on People: **Company**
|
||||
* Field on Companies: **Employees**
|
||||
* Vá para **Configurações → Modelo de Dados → Pessoas**
|
||||
* Adicione um campo de Relação
|
||||
* Destino: **Empresas**
|
||||
* Tipo: **Muitos-para-um**
|
||||
* Campo em Pessoas: **Empresa**
|
||||
* Campo em Empresas: **Funcionários**
|
||||
|
||||
Now each Person can be linked to a Company, and each Company shows its People.
|
||||
Agora, cada Pessoa pode ser vinculada a uma Empresa, e cada Empresa mostra suas Pessoas.
|
||||
|
||||
## Deleting a Relation
|
||||
## Excluindo uma Relação
|
||||
|
||||
1. Go to **Settings → Data Model**
|
||||
2. Find the relation field
|
||||
3. Click **⋮ → Deactivate**
|
||||
1. Vá para **Configurações → Modelo de Dados**
|
||||
2. Encontre o campo de relação
|
||||
3. Clique em **⋮ → Desativar**
|
||||
|
||||
Links are preserved but hidden. Reactivate to restore.
|
||||
Os vínculos são preservados, mas ficam ocultos. Reative para restaurar.
|
||||
|
||||
<Note>
|
||||
**Deleting a relation doesn't delete records.** Only the link between them is removed.
|
||||
**Excluir uma relação não exclui registros.** Apenas o vínculo entre eles é removido.
|
||||
</Note>
|
||||
|
||||
## Related
|
||||
## Relacionados
|
||||
|
||||
* [Relation Fields](/l/pt/user-guide/data-model/capabilities/relation-fields) — types and limitations
|
||||
* [How to Import Relations](/l/pt/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) — bulk import linked records
|
||||
* [Campos de relação](/l/pt/user-guide/data-model/capabilities/relation-fields) — tipos e limitações
|
||||
* [Como importar relações](/l/pt/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) — importar em massa registros vinculados
|
||||
|
||||
+15
-15
@@ -1,22 +1,22 @@
|
||||
---
|
||||
title: Customize Your Data Model
|
||||
description: Overview of data model customization options.
|
||||
title: Personalize seu modelo de dados
|
||||
description: Visão geral das opções de personalização do modelo de dados.
|
||||
---
|
||||
|
||||
Twenty's data model is fully customizable. Create objects, fields, and relations to match your business.
|
||||
O modelo de dados da Twenty é totalmente personalizável. Crie objetos, campos e relações para se adequar à sua empresa.
|
||||
|
||||
## Quick Links
|
||||
## Links rápidos
|
||||
|
||||
| I want to... | Guide |
|
||||
| ------------------------ | -------------------------------------------------------------------------------------- |
|
||||
| Create a new object | [How to Create Custom Objects](/l/pt/user-guide/data-model/how-tos/create-custom-objects) |
|
||||
| Add fields to an object | [How to Create Custom Fields](/l/pt/user-guide/data-model/how-tos/create-custom-fields) |
|
||||
| Connect objects together | [How to Create Relation Fields](/l/pt/user-guide/data-model/how-tos/create-relation-fields) |
|
||||
| Eu quero... | Guia |
|
||||
| ---------------------------- | ----------------------------------------------------------------------------------------- |
|
||||
| Criar um novo objeto | [Como criar objetos personalizados](/l/pt/user-guide/data-model/how-tos/create-custom-objects) |
|
||||
| Adicionar campos a um objeto | [Como criar campos personalizados](/l/pt/user-guide/data-model/how-tos/create-custom-fields) |
|
||||
| Conectar objetos entre si | [Como criar campos de relação](/l/pt/user-guide/data-model/how-tos/create-relation-fields) |
|
||||
|
||||
## Learn More
|
||||
## Saiba mais
|
||||
|
||||
* [Understanding Your Data Model](/l/pt/user-guide/data-model/overview) — key concepts and planning tips
|
||||
* [Objects](/l/pt/user-guide/data-model/capabilities/objects) — standard vs custom objects
|
||||
* [Fields](/l/pt/user-guide/data-model/capabilities/fields) — all field types
|
||||
* [Relation Fields](/l/pt/user-guide/data-model/capabilities/relation-fields) — connecting objects
|
||||
* [Data Model FAQ](/l/pt/user-guide/data-model/how-tos/data-model-faq) — common questions
|
||||
* [Compreendendo seu modelo de dados](/l/pt/user-guide/data-model/overview) — conceitos-chave e dicas de planejamento
|
||||
* [Objetos](/l/pt/user-guide/data-model/capabilities/objects) — objetos padrão vs. personalizados
|
||||
* [Campos](/l/pt/user-guide/data-model/capabilities/fields) — todos os tipos de campo
|
||||
* [Campos de relação](/l/pt/user-guide/data-model/capabilities/relation-fields) — conectando objetos
|
||||
* [Perguntas frequentes sobre o modelo de dados](/l/pt/user-guide/data-model/how-tos/data-model-faq) — perguntas comuns
|
||||
|
||||
@@ -1,155 +1,155 @@
|
||||
---
|
||||
title: Data Model FAQ
|
||||
description: Frequently asked questions about Twenty's data model.
|
||||
title: Modelo de Dados FAQ
|
||||
description: Perguntas frequentes sobre o modelo de dados do Twenty.
|
||||
---
|
||||
|
||||
## Object Management
|
||||
## Gestão de Objetos
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Can I delete a custom object?">
|
||||
Yes, custom objects can be deleted. You can also deactivate them first, which hides the object and its data from the interface while preserving the data.
|
||||
<Accordion title="Posso excluir um objeto personalizado?">
|
||||
Sim, objetos personalizados podem ser excluídos. Você também pode desativá-los primeiro, o que oculta o objeto e seus dados da interface, preservando os dados.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Can I delete standard objects (People, Companies, etc.)?">
|
||||
No, standard objects cannot be deleted. You can only deactivate them, which hides them from the interface but preserves the data.
|
||||
<Accordion title="Posso excluir objetos padrão (Pessoas, Empresas, etc.)?">
|
||||
Não, os objetos padrão não podem ser excluídos. Você só pode desativá-los, o que os oculta da interface, mas preserva os dados.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="How many custom objects can I create?">
|
||||
You can create as many custom objects and fields as you need — the price doesn't change.
|
||||
<Accordion title="Quantos objetos personalizados posso criar?">
|
||||
Você pode criar quantos objetos e campos personalizados precisar — o preço não muda.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Can I rename a standard object?">
|
||||
You can rename the label of standard objects (People, Companies, Opportunities), but not their API names. The API names are fixed for consistency across all Twenty workspaces.
|
||||
<Accordion title="Posso renomear um objeto padrão?">
|
||||
Você pode renomear o rótulo dos objetos padrão (Pessoas, Empresas, Oportunidades), mas não seus nomes de API. Os nomes de API são fixos para manter a consistência em todos os espaços de trabalho do Twenty.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Can I change an object's icon?">
|
||||
Yes, you can change the icon for both standard and custom objects in **Settings → Data Model**.
|
||||
<Accordion title="Posso alterar o ícone de um objeto?">
|
||||
Sim, você pode alterar o ícone tanto de objetos padrão quanto personalizados em **Settings → Data Model**.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Can I reorder objects in the left navigation bar?">
|
||||
Not yet. Object ordering in the navigation is currently fixed, but this feature is planned for a future release.
|
||||
<Accordion title="Posso reordenar objetos na barra de navegação esquerda?">
|
||||
Ainda não. A ordenação de objetos na navegação é atualmente fixa, mas esse recurso está previsto para uma versão futura.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Can I hide objects from the left navigation bar?">
|
||||
All active objects appear in the navigation. You can deactivate objects you don't need under **Settings → Data Model**.
|
||||
<Accordion title="Posso ocultar objetos da barra de navegação esquerda?">
|
||||
Todos os objetos ativos aparecem na navegação. Você pode desativar objetos que não precisa em **Configurações → Modelo de Dados**.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Field Capabilities
|
||||
## Capacidades de Campos
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Can I change a field type after creation?">
|
||||
No, field types cannot be changed after creation. If you need a different type, create a new field with the correct type, migrate your data, then deactivate the old field.
|
||||
<Accordion title="Posso alterar o tipo de um campo após a criação?">
|
||||
Não, os tipos de campo não podem ser alterados após a criação. Se você precisar de um tipo diferente, crie um novo campo com o tipo correto, migre seus dados e, em seguida, desative o campo antigo.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Why do I need different singular and plural names?">
|
||||
Our GraphQL API uses both forms for different operations:
|
||||
<Accordion title="Por que preciso de nomes diferentes no singular e plural?">
|
||||
Nossa API GraphQL usa ambas as formas para diferentes operações:
|
||||
|
||||
* `createPerson` (singular) for single record actions
|
||||
* `createPeople` (plural) for bulk operations
|
||||
* `createPerson` (singular) para ações de registro único
|
||||
* `createPeople` (plural) para operações em massa
|
||||
|
||||
This creates limitations when singular and plural forms are the same, but it improves the developer experience.
|
||||
Isto cria limitações quando as formas singular e plural são as mesmas, mas melhora a experiência do desenvolvedor.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Why are some field names protected?">
|
||||
Certain field names like `Type` or `Application` are reserved for system use. Choose alternative names like `Category` or `Classification` instead.
|
||||
<Accordion title="Por que alguns nomes de campos são protegidos?">
|
||||
Certos nomes de campos como `Tipo` ou `Aplicação` são reservados para uso do sistema. Escolha nomes alternativos como `Categoria` ou `Classificação`.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="What happens when I deactivate a field?">
|
||||
* The field is hidden from the interface
|
||||
* Existing data is preserved
|
||||
* You can still access the field via API
|
||||
* Existing relations remain but you can't create new ones
|
||||
* You can reactivate the field later
|
||||
<Accordion title="O que acontece quando eu desativo um campo?">
|
||||
* O campo fica oculto na interface
|
||||
* Os dados existentes são preservados
|
||||
* Você ainda pode acessar o campo via API
|
||||
* As relações existentes permanecem, mas você não pode criar novas
|
||||
* Você pode reativar o campo mais tarde
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Can I make a field required?">
|
||||
Currently, you cannot make custom fields required. All fields accept empty values. You can use workflows to enforce required fields by sending alerts or blocking actions when fields are empty.
|
||||
<Accordion title="Posso tornar um campo obrigatório?">
|
||||
Atualmente, não é possível tornar campos personalizados obrigatórios. Todos os campos aceitam valores vazios. Você pode usar fluxos de trabalho para impor campos obrigatórios, enviando alertas ou bloqueando ações quando os campos estiverem vazios.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="What's the difference between unique and required?">
|
||||
* **Unique**: No two records can have the same value in this field
|
||||
* **Required**: The field must have a value (not currently supported for custom fields)
|
||||
<Accordion title="Qual é a diferença entre único e obrigatório?">
|
||||
* **Único**: dois registros não podem ter o mesmo valor neste campo
|
||||
* **Obrigatório**: o campo deve ter um valor (atualmente não é suportado para campos personalizados)
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Can I create formula fields?">
|
||||
Formula fields are coming in **Q1 2026**. In the meantime, you can use workflows to calculate and update field values automatically.
|
||||
<Accordion title="Posso criar campos de fórmula?">
|
||||
Campos de fórmula estarão disponíveis em **Q1 2026**. Enquanto isso, você pode usar fluxos de trabalho para calcular e atualizar valores de campos automaticamente.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Can I have nested fields in my objects?">
|
||||
Nested fields are coming in **Q1 2026**. Currently, you can use workflows to bring field values from related objects. For example, to display a company's industry on a Person record, create a custom field on People and use a workflow to synchronize the value.
|
||||
<Accordion title="Posso ter campos aninhados nos meus objetos?">
|
||||
Campos aninhados estarão disponíveis em **Q1 2026**. Atualmente, você pode usar fluxos de trabalho para trazer valores de campos de objetos relacionados. Por exemplo, para exibir a indústria de uma empresa em um registro de Pessoa, crie um campo personalizado em Pessoas e use um fluxo de trabalho para sincronizar o valor.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Can I reorder fields in objects?">
|
||||
Field reordering will be available with custom layouts in **Q4 2025**. Currently, fields appear in alphabetical order.
|
||||
<Accordion title="Posso reordenar campos em objetos?">
|
||||
A reordenação de campos estará disponível com layouts personalizados em **Q4 2025**. Atualmente, os campos aparecem em ordem alfabética.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Relations
|
||||
## Relações
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Can I have a relation pointing to the same object?">
|
||||
Yes! Self-referencing relations are supported and recommended for use cases like account hierarchies. For example, create a relation from Companies to Companies to track parent/child accounts.
|
||||
<Accordion title="Posso ter uma relação apontando para o mesmo objeto?">
|
||||
Sim! Relações autorreferenciadas são suportadas e recomendadas para casos de uso como hierarquias de contas. Por exemplo, crie uma relação de Empresas para Empresas para acompanhar contas pai/filho.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Can I create many-to-many relationships?">
|
||||
Many-to-many relationships are coming in **H1 2026**. Currently, create an intermediate object with two one-to-many relationships as a workaround.
|
||||
<Accordion title="Posso criar relacionamentos muitos-para-muitos?">
|
||||
Relacionamentos muitos-para-muitos estarão disponíveis no **H1 2026**. Atualmente, crie um objeto intermediário com dois relacionamentos de um-para-muitos como uma solução alternativa.
|
||||
|
||||
For example, to link People and Projects (many-to-many), create a "Project Assignments" object with:
|
||||
Por exemplo, para vincular Pessoas e Projetos (muitos-para-muitos), crie um objeto "Atribuições de Projeto" com:
|
||||
|
||||
* A relation to People (many assignments → one person)
|
||||
* A relation to Projects (many assignments → one project)
|
||||
* Uma relação com Pessoas (muitas atribuições → uma pessoa)
|
||||
* Uma relação com Projetos (muitas atribuições → um projeto)
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="What are relations to multiple object types (Morph relationships)?">
|
||||
These allow one object to relate to multiple different object types through a single field. For example, Notes can be attached to People AND Companies AND Opportunities simultaneously.
|
||||
<Accordion title="O que são relações com múltiplos tipos de objeto (relações Morph)?">
|
||||
Essas relações permitem que um objeto se relacione com vários tipos de objeto diferentes por meio de um único campo. Por exemplo, Notas podem ser anexadas a Pessoas E Empresas E Oportunidades simultaneamente.
|
||||
|
||||
Each Note links to one Person, one Company, and one Opportunity at the same time.
|
||||
Cada Nota está vinculada a uma Pessoa, uma Empresa e uma Oportunidade ao mesmo tempo.
|
||||
|
||||
Learn more in [Relation Fields](/l/pt/user-guide/data-model/capabilities/relation-fields).
|
||||
Saiba mais em [Campos de relação](/l/pt/user-guide/data-model/capabilities/relation-fields).
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Can I have multiple relations between the same objects?">
|
||||
Yes, you can create multiple relations between the same two objects. For example, a Company could have both a "Primary Contact" and "Billing Contact" relation to People.
|
||||
<Accordion title="Posso ter várias relações entre os mesmos objetos?">
|
||||
Sim, você pode criar várias relações entre os mesmos dois objetos. Por exemplo, uma Empresa poderia ter tanto uma relação "Contato Principal" quanto "Contato de Cobrança" com Pessoas.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="What happens to relations when I delete a record?">
|
||||
When you delete a record, the relation link is removed from the related records. The related records themselves are not deleted.
|
||||
<Accordion title="O que acontece com as relações quando eu excluo um registro?">
|
||||
Quando você exclui um registro, o vínculo da relação é removido dos registros relacionados. Os próprios registros relacionados não são excluídos.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Can I create circular relations?">
|
||||
While technically possible, circular relations (A → B → C → A) should be avoided as they can cause confusion and potential performance issues.
|
||||
<Accordion title="Posso criar relações circulares?">
|
||||
Apesar de tecnicamente possíveis, relações circulares (A → B → C → A) devem ser evitadas, pois podem causar confusão e possíveis problemas de desempenho.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Access and Permissions
|
||||
## Acesso e Permissões
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Where can I see and edit my data model?">
|
||||
Go to **Settings → Data Model** to view and edit all your objects and fields.
|
||||
<Accordion title="Onde posso ver e editar meu modelo de dados?">
|
||||
Acesse **Settings → Data Model** para visualizar e editar todos os seus objetos e campos.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Why can't I see the Data Model under Settings?">
|
||||
Reach out to your workspace administrator. Data model access is usually restricted to administrators only.
|
||||
<Accordion title="Por que não posso ver o Modelo de Dados em Configurações?">
|
||||
Entre em contato com o administrador do seu espaço de trabalho. O acesso ao modelo de dados é geralmente restrito apenas aos administradores.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Data Management
|
||||
## Gerenciamento de dados
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Is there a limit to how many records I can have?">
|
||||
There's no hard limit on record counts. However, very large datasets may impact performance in some views. Use filters and views to manage large datasets effectively.
|
||||
<Accordion title="Existe um limite para quantos registros posso ter?">
|
||||
Não há um limite rígido para a quantidade de registros. No entanto, conjuntos de dados muito grandes podem impactar o desempenho em algumas visualizações. Use filtros e visualizações para gerenciar grandes conjuntos de dados com eficiência.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Can I import data into custom objects?">
|
||||
Yes, you can import CSV data into any object, including custom objects. The import process supports field mapping for custom fields. See [How to Prepare Your CSV Files](/l/pt/user-guide/data-migration/how-tos/prepare-your-csv-files).
|
||||
<Accordion title="Posso importar dados para objetos personalizados?">
|
||||
Sim, você pode importar dados CSV para qualquer objeto, incluindo objetos personalizados. O processo de importação oferece suporte ao mapeamento de campos para campos personalizados. Consulte [Como preparar seus arquivos CSV](/l/pt/user-guide/data-migration/how-tos/prepare-your-csv-files).
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Can I export my data model configuration?">
|
||||
Currently, there's no built-in export for data model configuration. Contact support if you need to migrate your data model between workspaces.
|
||||
<Accordion title="Posso exportar minha configuração do modelo de dados?">
|
||||
Atualmente, não há exportação nativa para a configuração do modelo de dados. Entre em contato com o suporte se você precisar migrar seu modelo de dados entre espaços de trabalho.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Need More Help?
|
||||
## Precisa de mais ajuda?
|
||||
|
||||
Check our [Implementation Services](/l/pt/user-guide/getting-started/capabilities/implementation-services) for help with complex data model design.
|
||||
Confira nossos [Serviços de implementação](/l/pt/user-guide/getting-started/capabilities/implementation-services) para obter ajuda com o design de modelos de dados complexos.
|
||||
|
||||
@@ -1,180 +1,180 @@
|
||||
---
|
||||
title: Data Model
|
||||
description: Learn what a data model is and how to design one that fits your business.
|
||||
title: Modelo de dados
|
||||
description: Saiba o que é um modelo de dados e como projetar um que se ajuste ao seu negócio.
|
||||
image: /images/user-guide/fields/custom_data_model.png
|
||||
---
|
||||
|
||||
<Frame>
|
||||
<img src="/images/user-guide/fields/custom_data_model.png" alt="Data Model" />
|
||||
<img src="/images/user-guide/fields/custom_data_model.png" alt="Modelo de dados" />
|
||||
</Frame>
|
||||
|
||||
## What is a Data Model?
|
||||
## O que é um modelo de dados?
|
||||
|
||||
A data model is the structure that defines how information is organized in your CRM. Think of it as the **blueprint** of your customer data — you design it once, then fill it with your actual data.
|
||||
Um modelo de dados é a estrutura que define como as informações são organizadas em seu CRM. Pense nisso como a **planta** dos dados dos seus clientes — você o projeta uma vez e depois o preenche com seus dados reais.
|
||||
|
||||
## Key Concepts
|
||||
## Conceitos principais
|
||||
|
||||
### Objects
|
||||
### Objetos
|
||||
|
||||
**Objects** are the main categories of data in your CRM. Each object represents a type of thing you want to track.
|
||||
**Objetos** são as principais categorias de dados no seu CRM. Cada objeto representa um tipo de coisa que você quer acompanhar.
|
||||
|
||||
Twenty comes with standard objects:
|
||||
O Twenty vem com objetos padrão:
|
||||
|
||||
* **People** — individuals (contacts, leads, partners)
|
||||
* **Companies** — organizations
|
||||
* **Opportunities** — deals or sales
|
||||
* **Notes** — attached notes on records
|
||||
* **Tasks** — to-dos linked to records
|
||||
* **Pessoas** — indivíduos (contatos, leads, parceiros)
|
||||
* **Empresas** — organizações
|
||||
* **Oportunidades** — negócios ou vendas
|
||||
* **Notas** — notas anexadas aos registros
|
||||
* **Tarefas** — afazeres vinculados aos registros
|
||||
|
||||
You can also create **custom objects** for anything specific to your business (e.g., Projects, Subscriptions, Events).
|
||||
Você também pode criar **objetos personalizados** para qualquer coisa específica do seu negócio (por exemplo, Projetos, Assinaturas, Eventos).
|
||||
|
||||
### Fields
|
||||
### Campos
|
||||
|
||||
**Fields** are the properties or attributes that describe each object. They store the actual information.
|
||||
**Campos** são as propriedades ou atributos que descrevem cada objeto. Eles armazenam as informações reais.
|
||||
|
||||
For example, the **People** object has fields like:
|
||||
Por exemplo, o objeto **Pessoas** tem campos como:
|
||||
|
||||
* Name
|
||||
* Email
|
||||
* Phone
|
||||
* Job Title
|
||||
* Company (a relation to the Companies object)
|
||||
* Nome
|
||||
* E-mail
|
||||
* Telefone
|
||||
* Título do Emprego
|
||||
* Empresa (uma relação com o objeto Empresas)
|
||||
|
||||
Fields have different **types**: text, number, date, select, multi-select, relation, and more. You can add custom fields to any object.
|
||||
Os campos têm diferentes **tipos**: texto, número, data, seleção, seleção múltipla, relação e muito mais. Você pode adicionar campos personalizados a qualquer objeto.
|
||||
|
||||
### Records
|
||||
### Registros
|
||||
|
||||
**Records** are the individual entries within an object — the actual data you create and manage.
|
||||
**Registros** são as entradas individuais dentro de um objeto — os dados reais que você cria e gerencia.
|
||||
|
||||
For example:
|
||||
Por exemplo:
|
||||
|
||||
* "John Smith" is a **record** in the People object
|
||||
* "Acme Corp" is a **record** in the Companies object
|
||||
* "John Smith" é um **registro** no objeto Pessoas
|
||||
* "Acme Corp" é um **registro** no objeto Empresas
|
||||
|
||||
**An analogy:**
|
||||
**Uma analogia:**
|
||||
|
||||
| Data Model Concept | Real-World Analogy |
|
||||
| ------------------ | ------------------------------------------ |
|
||||
| **Objects** | Sections in a book (the categories) |
|
||||
| **Fields** | Columns in a spreadsheet (the properties) |
|
||||
| **Records** | Rows in a spreadsheet (the actual entries) |
|
||||
| Conceito do Modelo de Dados | Analogia do mundo real |
|
||||
| --------------------------- | ------------------------------------------ |
|
||||
| **Objetos** | Seções em um livro (as categorias) |
|
||||
| **Campos** | Colunas em uma planilha (as propriedades) |
|
||||
| **Registros** | Linhas em uma planilha (as entradas reais) |
|
||||
|
||||
You design the data model (objects + fields) once, then create many records within that structure.
|
||||
Você projeta o modelo de dados (objetos + campos) uma vez e, em seguida, cria muitos registros dentro dessa estrutura.
|
||||
|
||||
## Why Customize Your Data Model?
|
||||
## Por que personalizar seu modelo de dados?
|
||||
|
||||
Every business works differently. Customizing your data model means you can shape Twenty around **your** processes instead of forcing yours into a rigid system.
|
||||
Cada empresa trabalha de maneira diferente. Personalizar seu modelo de dados significa que você pode moldar o Twenty em torno dos **seus** processos, em vez de forçar os seus a caber em um sistema rígido.
|
||||
|
||||
Twenty offers full flexibility:
|
||||
O Twenty oferece total flexibilidade:
|
||||
|
||||
* Create as many custom objects as you need
|
||||
* Add unlimited custom fields
|
||||
* The price doesn't change based on customization
|
||||
* Crie quantos objetos personalizados precisar
|
||||
* Adicione um número ilimitado de campos personalizados
|
||||
* O preço não muda com base na personalização
|
||||
|
||||
## Tips to Design Your Data Model
|
||||
## Dicas para projetar seu modelo de dados
|
||||
|
||||
### 1. Start with Your Core Objects
|
||||
### 1. Comece com seus objetos principais
|
||||
|
||||
Identify the main concepts you work with. Twenty already provides:
|
||||
Identifique os principais conceitos com os quais você trabalha. O Twenty já oferece:
|
||||
|
||||
* **People** — your contacts
|
||||
* **Companies** — your accounts
|
||||
* **Opportunities** — your deals
|
||||
* **Pessoas** — seus contatos
|
||||
* **Empresas** — suas contas
|
||||
* **Oportunidades** — seus negócios
|
||||
|
||||
Think about what else you might need:
|
||||
Pense no que mais você pode precisar:
|
||||
|
||||
* Stripe would need a `Subscriptions` object
|
||||
* Airbnb would need a `Trips` object
|
||||
* An accelerator would need a `Batches` object
|
||||
* Stripe precisaria de um objeto `Subscriptions`
|
||||
* Airbnb precisaria de um objeto `Trips`
|
||||
* Uma aceleradora precisaria de um objeto `Batches`
|
||||
|
||||
### 2. Use Fields for Variations, Not New Objects
|
||||
### 2. Use campos para variações, não novos objetos
|
||||
|
||||
If something is just a characteristic of an existing object, make it a **field**.
|
||||
Se algo for apenas uma característica de um objeto existente, faça dele um **campo**.
|
||||
|
||||
**Use fields for:**
|
||||
**Use campos para:**
|
||||
|
||||
* Categories and labels (e.g., `Industry` for Companies)
|
||||
* Status values (e.g., `Stage` for Opportunities)
|
||||
* Attributes and properties
|
||||
* Categorias e rótulos (por exemplo, `Industry` para Empresas)
|
||||
* Valores de status (por exemplo, `Stage` para Oportunidades)
|
||||
* Atributos e propriedades
|
||||
|
||||
### 3. Create an Object When It Stands on Its Own
|
||||
### 3. Crie um objeto quando ele se sustentar por si só
|
||||
|
||||
If the concept has its own lifecycle, properties, or relationships, it deserves an object.
|
||||
Se o conceito tem seu próprio ciclo de vida, propriedades ou relacionamentos, ele merece um objeto.
|
||||
|
||||
**Create an object for:**
|
||||
**Crie um objeto para:**
|
||||
|
||||
* **Projects** — have deadlines, owners, and tasks
|
||||
* **Subscriptions** — connect companies, products, and invoices
|
||||
* **Events** — involve attendees and follow-up actions
|
||||
* **Projetos** — têm prazos, responsáveis e tarefas
|
||||
* **Assinaturas** — conectam empresas, produtos e faturas
|
||||
* **Eventos** — envolvem participantes e ações de acompanhamento
|
||||
|
||||
These go beyond a single field because they carry their own data and relationships.
|
||||
Estes vão além de um único campo, pois carregam seus próprios dados e relações.
|
||||
|
||||
### 4. Create an Object When Records Are Open-Ended
|
||||
### 4. Crie um objeto quando os registros forem em quantidade indefinida
|
||||
|
||||
If something can be linked multiple times and you don't know how many, use an object.
|
||||
Se algo puder ser vinculado várias vezes e você não souber quantas vezes, use um objeto.
|
||||
|
||||
**Bad approach:**
|
||||
Creating fields like `Product 1`, `Product 2`, `Product 3`...
|
||||
**Abordagem ruim:**
|
||||
Criar campos como `Product 1`, `Product 2`, `Product 3`...
|
||||
|
||||
**Good approach:**
|
||||
Create a `Products` object and relate it to records. This supports one, two, or a hundred products without changing your model.
|
||||
**Boa abordagem:**
|
||||
Crie um objeto `Products` e relacione-o aos registros. Dessa forma, você pode suportar um, dois ou cem produtos sem alterar seu modelo.
|
||||
|
||||
### 5. Keep It Simple First
|
||||
### 5. Mantenha simples no início
|
||||
|
||||
Start with fields. Move to new objects only when you feel the limits:
|
||||
Comece pelos campos. Passe para novos objetos apenas quando perceber as limitações:
|
||||
|
||||
* Too many fields on one object
|
||||
* Repeated records that should be separate
|
||||
* Relationships that don't fit neatly
|
||||
* Muitos campos em um único objeto
|
||||
* Registros repetidos que deveriam ser separados
|
||||
* Relacionamentos que não se encaixam bem
|
||||
|
||||
## Special Note on People, Companies, and Opportunities
|
||||
## Nota especial sobre Pessoas, Empresas e Oportunidades
|
||||
|
||||
<Warning>
|
||||
**Email and calendar sync only works with People, Companies, and Opportunities.**
|
||||
**A sincronização de e-mail e calendário funciona apenas com Pessoas, Empresas e Oportunidades.**
|
||||
|
||||
These are the only objects where you can access synchronized emails and meetings from your mailbox/calendar. We recommend using them as much as possible.
|
||||
Estes são os únicos objetos nos quais você pode acessar e-mails e reuniões sincronizados da sua caixa de entrada/calendário. Recomendamos usá-los o máximo possível.
|
||||
</Warning>
|
||||
|
||||
**Best practices:**
|
||||
**Melhores Práticas:**
|
||||
|
||||
* If you need categories of People, use fields (not new objects)
|
||||
* Example: Use a `Person Type` field with values "Prospect" and "Partner" instead of creating separate objects
|
||||
* Create different **views** to filter: one showing partners, another showing prospects
|
||||
* Se você precisar de categorias de Pessoas, use campos (não novos objetos)
|
||||
* Exemplo: Use um campo `Person Type` com os valores "Prospecto" e "Parceiro" em vez de criar objetos separados
|
||||
* Crie **exibições** diferentes para filtrar: uma mostrando parceiros, outra mostrando prospectos
|
||||
|
||||
**It's okay to have fields that don't apply to every record.** For example, a `Referral Link` field on People that only applies when `Person Type = Partner`. Hide this field from views where it's not relevant.
|
||||
**Não há problema em ter campos que não se apliquem a todos os registros.** Por exemplo, um campo `Referral Link` em Pessoas que só se aplica quando `Person Type = Partner`. Oculte esse campo das exibições onde ele não for relevante.
|
||||
|
||||
## Questions to Guide Your Choice
|
||||
## Perguntas para guiar sua escolha
|
||||
|
||||
Ask yourself:
|
||||
Pergunte a si mesmo:
|
||||
|
||||
<Check>Is this just a property of something I already have, or does it need its own properties?</Check>
|
||||
<Check>Will I ever need to track multiple of these per record, without knowing how many?</Check>
|
||||
<Check>Does this concept connect to several different objects, not just one?</Check>
|
||||
<Check>Will it have its own lifecycle (stages, start/end dates)?</Check>
|
||||
<Check>É apenas uma propriedade de algo que já tenho, ou precisa ter suas próprias propriedades?</Check>
|
||||
<Check>Alguma vez precisarei acompanhar vários desses por registro, sem saber quantos de antemão?</Check>
|
||||
<Check>Este conceito se conecta a vários objetos diferentes, não apenas a um?</Check>
|
||||
<Check>Terá seu próprio ciclo de vida (estágios, datas de início/fim)?</Check>
|
||||
|
||||
If the answer is "yes" to one or more, it's probably time for a new object.
|
||||
Se a resposta for "sim" para uma ou mais dessas, provavelmente é hora de um novo objeto.
|
||||
|
||||
## Accessing Your Data Model
|
||||
## Acessando seu Modelo de Dados
|
||||
|
||||
1. Go to **Settings** in the left sidebar
|
||||
2. Click **Data Model**
|
||||
3. View all your objects (standard and custom)
|
||||
4. Click any object to see and edit its fields
|
||||
1. Acesse **Configurações** na barra lateral esquerda
|
||||
2. Clique em **Modelo de Dados**
|
||||
3. Veja todos os seus objetos (padrões e personalizados)
|
||||
4. Clique em qualquer objeto para ver e editar seus campos
|
||||
|
||||
<Note>
|
||||
**Don't see Data Model in Settings?**
|
||||
**Não vê o Modelo de Dados em Configurações?**
|
||||
|
||||
Access to the data model is usually restricted to administrators. Contact your workspace admin if you need access.
|
||||
O acesso ao modelo de dados é geralmente restrito apenas aos administradores. Entre em contato com o administrador do seu espaço de trabalho se precisar de acesso.
|
||||
</Note>
|
||||
|
||||
## Next Steps
|
||||
## Próximos Passos
|
||||
|
||||
Once you've planned your data model:
|
||||
Depois de planejar seu modelo de dados:
|
||||
|
||||
* [How to Create Custom Objects](/l/pt/user-guide/data-model/how-tos/create-custom-objects)
|
||||
* [How to Create Custom Fields](/l/pt/user-guide/data-model/how-tos/create-custom-fields)
|
||||
* [How to Create Relation Fields](/l/pt/user-guide/data-model/how-tos/create-relation-fields)
|
||||
* [Como criar objetos personalizados](/l/pt/user-guide/data-model/how-tos/create-custom-objects)
|
||||
* [Como criar campos personalizados](/l/pt/user-guide/data-model/how-tos/create-custom-fields)
|
||||
* [Como criar campos de relação](/l/pt/user-guide/data-model/how-tos/create-relation-fields)
|
||||
|
||||
## Need Help?
|
||||
## Precisa de ajuda?
|
||||
|
||||
Our team can help you design and create the data model you need. Discover our [Implementation Services](/l/pt/user-guide/getting-started/capabilities/implementation-services).
|
||||
Nossa equipe pode ajudar você a projetar e criar o modelo de dados de que você precisa. Descubra nossos [serviços de implementação](/l/pt/user-guide/getting-started/capabilities/implementation-services).
|
||||
|
||||
Reference in New Issue
Block a user