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>
86 lines
4.6 KiB
Plaintext
86 lines
4.6 KiB
Plaintext
---
|
|
title: Migración de datos
|
|
description: Importe y exporte sus datos de CRM mediante archivos CSV o la API.
|
|
---
|
|
|
|
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
|
|
|
|
|
## Métodos de importación
|
|
|
|
Twenty admite dos métodos principales para importar datos:
|
|
|
|
| Método | Ideal para | Límite de volumen |
|
|
| ---------------------------- | ------------------------------------------------ | ---------------------------- |
|
|
| **Importación CSV** | Migraciones estándar, actualizaciones periódicas | 10.000 registros por archivo |
|
|
| **Importación mediante API** | Migraciones a gran escala, automatización | Ilimitado |
|
|
|
|
<Note>Para conjuntos de datos muy grandes (cientos de miles de registros), use la API. Nuestros [socios de implementación](/l/es/user-guide/getting-started/capabilities/implementation-services) pueden ayudar a ejecutar estos scripts si es necesario.</Note>
|
|
|
|
## Conceptos básicos de la importación CSV
|
|
|
|
Puede importar datos de cualquier objeto mediante archivos CSV, XLSX o XLS. Cada archivo debe contener **solo un tipo de objeto** (por ejemplo, solo registros de Personas).
|
|
|
|
<Note>**Los campos deben existir antes de la importación.** Cargar un CSV crea registros, pero no crea campos. Si necesita campos personalizados, créelos primero en **Configuración → Modelo de datos**.</Note>
|
|
|
|
### Pasos
|
|
|
|
1. Vaya al objeto en el que desea importar datos
|
|
2. Haga clic en el icono **⋮** en la esquina superior derecha (este es el Menú de comandos) y haga clic en **Importar registros**
|
|
3. Descargue el archivo de plantilla para asegurarse de que sus datos estén en el formato esperado
|
|
4. Cargue su archivo CSV con el formato correcto
|
|
5. Asigne sus columnas a los campos de Twenty
|
|
6. Revise los errores (resaltados en amarillo) y corríjalos, editando directamente en la interfaz de usuario
|
|
7. Confirme la importación
|
|
|
|
### Importación de relaciones entre objetos
|
|
|
|
Puede importar relaciones entre objetos utilizando la función de importación CSV. Debe hacer referencia al objeto relacionado utilizando un campo único de ese objeto: el `id`, el `email` para Personas y Miembros del espacio de trabajo, el `domain` para empresas, cualquier otro campo establecido como único en el modelo de datos para cualquier otro objeto.
|
|
|
|
<Note>**Los registros eliminados cuentan para la unicidad.** Los registros eliminados lógicamente (visibles en Menú de comandos → Ver registros eliminados) se incluyen en las comprobaciones de unicidad. Si importa un registro con el mismo valor único que un registro eliminado, el registro eliminado se restaurará.</Note>
|
|
|
|
<Warning>
|
|
**¡Importa el orden de importación!**
|
|
|
|
Al importar objetos relacionados, cargue los archivos en este orden:
|
|
|
|
1. **Empresas** primero (el lado "uno" de las relaciones)
|
|
2. **Personas** segundo (vinculadas a empresas mediante companyId)
|
|
3. **Oportunidades** tercero (vinculadas a empresas/personas)
|
|
4. **Objetos personalizados** con relaciones al final
|
|
|
|
¿Por qué? El lado "uno" de una relación de uno a muchos debe existir antes de que pueda hacer referencia a él. Por ejemplo, el registro de Empresa debe existir antes de importar una Persona con el ID de esa empresa.
|
|
</Warning>
|
|
|
|
Consulte [este artículo](/l/es/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) para ver una guía paso a paso sobre cómo proceder.
|
|
|
|
## Exportar Datos
|
|
|
|
Exporte los datos de su espacio de trabajo para copias de seguridad, informes o migración.
|
|
|
|
### Pasos
|
|
|
|
1. Vaya al objeto que desea exportar
|
|
2. Configure la vista con las columnas que necesita
|
|
3. Haga clic en **⋮** → **Exportar vista**
|
|
4. Guarde el archivo CSV
|
|
|
|
<Note>**Solo se exportan las columnas visibles.** El archivo CSV contendrá únicamente las columnas que se muestran en su vista actual. Agregue u oculte columnas antes de exportar para controlar qué datos se incluyen.</Note>
|
|
|
|
<Note>**Límites de exportación**: hasta 20.000 registros por exportación.</Note>
|
|
|
|
## Permisos
|
|
|
|
La importación y exportación de datos requieren permisos específicos:
|
|
|
|
* **Importación**: requiere el permiso "Importar CSV"
|
|
* **Exportación**: requiere el permiso "Exportar CSV"
|
|
|
|
Póngase en contacto con el administrador de su espacio de trabajo si no tiene estos permisos.
|
|
|
|
## Próximos Pasos
|
|
|
|
* [Prepare sus archivos CSV](/l/es/user-guide/data-migration/how-tos/prepare-your-csv-files)
|
|
* [Importe relaciones entre objetos](/l/es/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
|
|
* [Importe mediante API para conjuntos de datos grandes](/l/es/user-guide/data-migration/how-tos/import-data-via-api)
|