Félix Malfait
5d438bb70c
## Summary - **New Getting Started section** with quickstart guide and restructured navigation - **Halftone-style illustrations** for User Guide and Developer introduction cards using a Canvas 2D filter script - **Removed hero images** (`image:` frontmatter + `<Frame><img>` blocks) from all user-guide article pages - **Cleaned up translations** (13 languages): removed hero images and updated introduction cards to use halftone style - **Cleaned up twenty-ui pages**: removed outdated hero images from component docs - **Deleted orphaned images**: `table.png`, `kanban.png` - **Developer page**: fixed duplicate icon, switched to 3-column layout ## Test plan - [ ] Verify docs site builds without errors - [ ] Check User Guide introduction page renders halftone card images in both light and dark mode - [ ] Check Developer introduction page renders 3-column layout with distinct icons - [ ] Confirm article pages no longer show hero images at the top - [ ] Spot-check a few translated pages to ensure hero images are removed 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com> Co-authored-by: github-actions <github-actions@twenty.com>
85 lines
4.5 KiB
Plaintext
85 lines
4.5 KiB
Plaintext
---
|
|
title: Migração de dados
|
|
description: Importe e exporte os seus dados de CRM através de ficheiros CSV ou da API.
|
|
---
|
|
|
|
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
|
|
|
|
|
## Métodos de importação
|
|
|
|
A Twenty suporta dois métodos principais para importar dados:
|
|
|
|
| Método | Melhor para | Limite de volume |
|
|
| ---------------------- | ----------------------------------------- | ---------------------------- |
|
|
| **Importação de CSV** | Migrações padrão, atualizações regulares | 10 000 registos por ficheiro |
|
|
| **Importação via API** | Migrações em grande escala, automatização | Sem limite |
|
|
|
|
<Note>Para conjuntos de dados muito grandes (centenas de milhares de registos), utilize a API. Os nossos [parceiros de implementação](/l/pt/user-guide/getting-started/capabilities/implementation-services) podem ajudar a executar estes scripts, se necessário.</Note>
|
|
|
|
## Noções básicas da importação de CSV
|
|
|
|
Pode importar dados para qualquer objeto utilizando ficheiros CSV, XLSX ou XLS. Cada ficheiro deve conter **apenas um tipo de objeto** (por exemplo, apenas registos de Pessoas).
|
|
|
|
<Note>**Os campos têm de existir antes da importação.** Carregar um CSV cria registos, mas não cria campos. Se precisar de campos personalizados, crie-os primeiro em **Definições → Modelo de dados**.</Note>
|
|
|
|
### Passos
|
|
|
|
1. Navegue até ao objeto onde pretende importar dados
|
|
2. Clique no ícone **⋮** no canto superior direito (este é o Menu de Comandos) e clique em **Importar registos**
|
|
3. Descarregue o ficheiro de modelo para garantir que os seus dados estão no formato esperado
|
|
4. Carregue o seu ficheiro CSV formatado
|
|
5. Mapeie as suas colunas para os campos da Twenty
|
|
6. Revise os erros (realçados a amarelo) e corrija-os, editando diretamente na interface
|
|
7. Confirme a importação
|
|
|
|
### Importar relações entre objetos
|
|
|
|
Pode importar relações entre objetos utilizando a função de importação de CSV. Tem de referenciar o objeto relacionado utilizando um campo único desse objeto: o `id`, o `email` para Pessoas e Membros do espaço de trabalho, o `domain` para empresas, ou qualquer outro campo definido como único no modelo de dados para qualquer outro objeto.
|
|
|
|
<Note>**Os registos eliminados contam para a unicidade.** Os registos eliminados logicamente (visíveis no Menu de Comandos → Ver registos eliminados) são incluídos nas verificações de unicidade. Se importar um registo com o mesmo valor único que um registo eliminado, o registo eliminado será restaurado.</Note>
|
|
|
|
<Warning>
|
|
**A ordem de importação é importante!**
|
|
|
|
Ao importar objetos relacionados, carregue os ficheiros por esta ordem:
|
|
1. **Empresas** primeiro (o lado "um" das relações)
|
|
2. **Pessoas** em segundo (ligadas às empresas via companyId)
|
|
3. **Oportunidades** em terceiro (ligadas a empresas/pessoas)
|
|
4. **Objetos personalizados** com relações por último
|
|
|
|
Porquê? O lado "um" de uma relação um-para-muitos tem de existir antes de o poder referenciar. Por exemplo, o registo da Empresa tem de existir antes de importar uma Pessoa com o ID dessa empresa.
|
|
</Warning>
|
|
|
|
Consulte [este artigo](/l/pt/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) para um guia passo a passo sobre como proceder.
|
|
|
|
## Exportar Dados
|
|
|
|
Exporte os dados do seu espaço de trabalho para cópias de segurança, relatórios ou migração.
|
|
|
|
### Passos
|
|
|
|
1. Navegue até ao objeto que pretende exportar
|
|
2. Configure a visualização com as colunas de que necessita
|
|
3. Clique em **⋮** → **Exportar visualização**
|
|
4. Guarde o ficheiro CSV
|
|
|
|
<Note>**Apenas as colunas visíveis são exportadas.** O ficheiro CSV conterá apenas as colunas apresentadas na sua visualização atual. Adicione ou oculte colunas antes de exportar para controlar que dados são incluídos.</Note>
|
|
|
|
<Note>**Limites de exportação**: Até 20 000 registos por exportação.</Note>
|
|
|
|
## Permissões
|
|
|
|
A importação e a exportação de dados requerem permissões específicas:
|
|
|
|
* **Importar**: Requer a permissão "Import CSV"
|
|
* **Exportar**: Requer a permissão "Export CSV"
|
|
|
|
Contacte o administrador do seu espaço de trabalho se não tiver estas permissões.
|
|
|
|
## Próximos Passos
|
|
|
|
* [Prepare os seus ficheiros CSV](/l/pt/user-guide/data-migration/how-tos/prepare-your-csv-files)
|
|
* [Importar relações entre objetos](/l/pt/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
|
|
* [Importar via API para conjuntos de dados de grande dimensão](/l/pt/user-guide/data-migration/how-tos/import-data-via-api)
|