--- title: Importar/Exportar Dados info: "Aprenda como importar e exportar dados." image: /images/user-guide/import-export-data/cloud.png sectionInfo: Descubra o Twenty, um CRM de código aberto. --- import { VimeoEmbed } from '/snippets/vimeo-embed.mdx'; Header ## Importar Dados - Você pode importar dados para qualquer objeto usando um arquivo .csv, .xlsx, ou .xls. - Cada arquivo que você enviar deve conter **apenas um tipo de objeto** (por exemplo, somente registros de Pessoas). - You can use the Import to **create or update records**. ### Baixe um arquivo de amostra para corresponder ao formato esperado. 1. Vá para uma visualização com o objeto que você está prestes a importar. 2. Clique no ícone `⋮` no canto superior direito e selecione `Importar registros`. 3. Clique em `Baixar arquivo de amostra`. ### Prepare seu csv Abaixo estão alguns itens a verificar antes de enviar seu arquivo. - Limite o número de registros a **10.000 por arquivo**. - **Remova duplicados** do seu arquivo. - A unicidade em `Pessoas` é definida por padrão pelo `id` e o `email`. Você também tem a capacidade de definir campos personalizados de `Pessoas` como únicos ao configurar seu modelo de dados. - A unicidade em `Empresas` é definida por padrão pelo `id` e o `domínio`. Você também tem a capacidade de definir campos personalizados de `Empresas` como únicos ao configurar seu modelo de dados. - Para qualquer outro objeto, incluindo objetos personalizados, você tem a capacidade de definir alguns campos como únicos. Certifique-se de não incluir duplicados ao preparar seus arquivos. - Recomendamos usar a sintaxe `https://dominio.com` ao enviar seus domínios, pois esta é a utilizada pelo nosso conector com a sua caixa de correio e calendário. - Você pode **importar as relações entre objetos** fornecendo um dos campos únicos do registro associado. - Exemplo: Você quer anexar uma pessoa a uma empresa. Adicione uma coluna no arquivo contendo todos os registros de `Pessoas` que contenham o `id` da empresa -- ou seu `domínio`. Você poderá mapear este campo durante o envio do arquivo. **Nota importante:** - As relações entre objetos no Twenty são "Um para Muitos". Isso significa que cada registro do objeto A pode ser anexado a vários registros do objeto B. Mas cada registro do objeto B pode pertencer a apenas um registro do objeto A. _Por exemplo, uma empresa pode ser anexada a várias pessoas. E uma pessoa pode pertencer a apenas uma empresa._ - Para carregar relações via a função de Importação, é necessário fornecer o `id` (ou qualquer outro campo único) do objeto anexado no arquivo que contém os registros do lado "Muitos" da relação. _Por exemplo, você fornece o `id` ou `domínio` da empresa ao enviar registros de pessoas. \*Por exemplo, você fornece o `id` ou `domínio` da empresa ao enviar registros de pessoas. Você não fornece o `id` (ou `email`) das pessoas ao enviar o arquivo com empresas._ ### Enviar seu arquivo 1. Vá para uma visualização com o objeto que você está prestes a importar. 2. Clique no ícone `⋮` no canto superior direito e selecione `Importar registros`. 3. Clique em `Selecionar arquivo`. 4. Valide o mapeamento dos campos. - Você não precisa importar todos, pode escolher a opção "Não mapear". - Para relações, é recomendado mapear apenas um dos campos únicos. - Você pode precisar também mapear os valores dos seus campos de tipo de seleção e multi-seleção. 5. Clique em `Próximos Passos` e `Revisar as linhas com erros`. Células com problema são destacadas. **Você pode remover a linha ou atualizar a célula diretamente ali**. 6. Quando terminar, clique em `Confirmar` ### Import FAQ
Vejo problemas de duplicados ao enviar meu arquivo, o que devo fazer? Por favor, consulte a seção **Prepare seu csv** acima neste artigo, que contém diretrizes sobre o que será considerado um duplicado.
Posso importar relações entre objetos? Sim, consulte a seção **Prepare seu csv** acima neste artigo, que contém uma seção sobre a importação de relações.
Posso atualizar registros existentes usando a função de Importação? Sim, você pode atualizar registros existentes usando a função de Importação. Certifique-se de fornecer o id (ou qualquer outro campo único) ao reenviar seus registros.
Posso migrar o `id` das minhas outras ferramentas? Sim. Você precisa criar um campo que você define como único em seu modelo de dados que conterá o `id` de suas outras ferramentas. Note que o nome `id` é protegido pois é usado para o id do Twenty. Se você quiser criar relações entre objetos usando este campo, consulte a seção **Prepare seu csv** acima neste artigo. Ela contém uma seção sobre a importação de relações.
## Exportar Dados Você pode baixar dados da maioria dos seus objetos e até 20.000 registros por exportação. Para exportar dados de um objeto: 1. Visite o índice do objeto. 2. Escolha a visualização para exportação de dados. Configure as colunas que você deseja baixar ocultando ou adicionando colunas e encontre os registros que você precisa filtrando sua visualização. 3. Acesse o painel lateral através do ícone `⋮` no canto superior direito. 4. Clique em `Exportar visualização`. 5. Selecione o local para salvar os dados CSV. Observe que a exportação pode demorar com um grande número de registros.