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]
2026-01-26 09:06:17 +01:00
committed by GitHub
parent 2353bc62cc
commit e0d4492013
651 changed files with 37463 additions and 32557 deletions
@@ -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.