Importar registros para varios objetos

Sí se puede importar más de un tipo de objeto —el tipo de registro: Contactos, Compañías, Negocios— en una sola carga. Un archivo Excel se compone de hojas, las pestañas de la parte inferior. La hoja datamap de la plantilla es la que le dice al importador qué hoja corresponde a qué objeto, y por defecto trae una sola fila. Para cargar dos objetos, basta con sumar una hoja y una fila en datamap.

Qué trae la plantilla por defecto

La plantilla que se descarga desde Más acciones → Descargar plantilla trae tres hojas (README, datamap y una hoja con el nombre del objeto), que se explican en Generar un archivo de importación de ejemplo. Aquí importa datamap, el mapa de qué hoja corresponde a qué objeto.

La hoja datamap tiene esta forma:

sheetName	objectType	from	to	skip
Contact	Contact			false

Cada fila le dice al importador: “procesa la hoja sheetName como registros del objeto objectType”. Por defecto solo hay una fila — la del módulo desde el que descargaste la plantilla.

Agregar un segundo objeto a la misma carga

Para importar, por ejemplo, Contactos y Compañías juntos:

1. Abre Directorio → Contactos, pulsa el menú de tres puntos (⋮) (Más acciones) y elige Descargar plantilla. Ábrela en Excel. Si ya tienes un archivo con tus contactos, puedes usar ese.
2. Abre Directorio → Compañías y descarga también su plantilla, con el mismo menú. Ábrela en otra ventana de Excel.
3. Copia la hoja de compañías al primer archivo. En la plantilla de Compañías, haz clic derecho en la pestaña Company (abajo), elige Mover o copiar…, en Al libro selecciona el primer archivo, marca Crear una copia y pulsa Aceptar. La hoja llega con todas sus columnas. Si usas otro programa de hojas de cálculo, crea en el primer archivo una hoja nueva llamada Company y pega ahí todo el contenido de la hoja Company de la otra plantilla, fila 1 incluida.
4. En el primer archivo, abre la hoja datamap y escribe una segunda fila: en sheetName, Company; en objectType, Company. Deja from y to vacías y skip en false.
5. Rellena los datos de cada hoja, un registro por fila desde la fila 2, y guarda el archivo como .xlsx.
6. En Directorio → Contactos o en Directorio → Compañías, abre Más acciones → Importar y elige el archivo. Solo se sube una vez.

7. Sigue el panel Importar datos, en la esquina inferior derecha. Cuando ambos objetos aparecen en Completado, la carga terminó.

La hoja datamap queda así:

sheetName	objectType	from	to	skip
Contact	Contact			false
Company	Company			false

Prolibu procesa cada hoja declarada como una importación independiente, pero dentro de la misma carga: el panel Importar datos muestra un contador combinado (2 Total, 2 Importados en este ejemplo) con una barra de progreso propia por objeto.

Si los registros no necesitan enlazarse entre sí, que es el caso más común, con esto basta: dos objetos, un archivo, una sola carga.

Enlazar los registros: la compañía tiene que existir primero

La columna company del contacto apunta a la compañía a la que pertenece. Solo la encuentra si esa compañía ya existe en el momento en que se procesa la fila del contacto; no la encuentra si viene más abajo en el mismo archivo. Eso da dos caminos válidos, y en los dos el dato que asocia es el mismo: company debe llevar el companyCode de la compañía, no su refId ni su nombre.

En la misma carga, con el orden correcto en datamap

Si Contactos y Compañías van en el mismo archivo, el importador procesa las hojas en el orden de las filas de datamap. Para que la compañía exista antes que el contacto, sube la fila de Company por encima de la de Contact:

sheetName	objectType	from	to	skip
Company	Company			false
Contact	Contact			false

Con ese orden, cuando le toca a la hoja Contact la compañía ya existe y la columna company la encuentra: al abrir la ficha del contacto, el campo Compañía queda enlazado de verdad al registro, no solo con el nombre suelto que muestra la tabla. Si lo inviertes (Contact antes que Company), la carga del contacto falla fila por fila con “Documento no encontrado por la llave primaria ‘‹código›’ en ‘company’”, porque en ese punto del proceso la compañía todavía no existe.

En dos cargas separadas

Si prefieres no depender del orden de las hojas, o si la compañía ya existía de antes, haz dos cargas:

1. Primero las compañías. Rellena la hoja Company, dale a cada compañía su companyCode (un código propio que te inventas, por ejemplo ACME-01) y súbela con Más acciones → Importar.
2. Después los contactos. Cuando el panel marque Completado, rellena la columna company de la hoja Contact con ese mismo companyCode y súbela.

El companyCode funciona además como clave única, así que volver a subir la misma hoja Company actualiza la compañía en vez de duplicarla.