Importar datos a través de la interfaz

Una vez creada su tabla personalizada, tiene la posibilidad de importar datos para rellenarla.

Para ello, vaya a la aplicación «Importaciones» (Aplicaciones > Datos > Importaciones) y haga clic en «Crear una importación».

Tenga en cuenta que también hay un acceso directo a través del botón «Más» en el módulo Perfiles (Perfiles > Perfiles de la tabla X).

A savoir

La importación de datos también es posible a través de las API dedicadas a las tablas personalizadas.

Elija el tipo de tabla personalizada en la que desea importar los datos.

A continuación, elija si desea iniciar la importación desde una página en blanco o si desea utilizar una configuración guardada con parámetros predefinidos.

tip

Haga clic en el pequeño icono de información para ver los detalles de la configuración (tipo de archivo, asignación, parámetros de carga, etc.).

A continuación, se le redirigirá al asistente de importación.

astuce

También es posible iniciar una importación desde la aplicación «Tablas de datos» seleccionando una tabla y haciendo clic en «Más» y luego en «Importar datos».

Crear una importación

Datos generales

En primer lugar, asigne un nombre a la importación. Le ayudará a encontrar la ejecución de la importación en las pestañas «En curso» y «Finalizadas». Por lo tanto, este nombre debe ser único.

A continuación, seleccione la entidad de la tabla personalizada en la que importará los datos. Esta será también la entidad de la importación.

Por último, seleccione la tabla en la que desea importar los datos. Solo se muestran en la lista desplegable las tablas almacenadas en la entidad seleccionada anteriormente.

Parámetros de carga

A continuación, deberá especificar los parámetros de importación, lo que equivale a definir el tratamiento de las coincidencias con los registros ya existentes.

• Modificación/Creación: Se tienen en cuenta todas las líneas del archivo. Si se encuentra una línea correspondiente en la tabla, se actualiza. Si no se encuentra ninguna correspondencia, se crea una nueva línea en la tabla.
• Solo creación: solo se tienen en cuenta las líneas del archivo que dan lugar a la creación de una nueva línea en la tabla. De este modo, solo se añaden nuevos registros a la base de datos.
• Solo modificación: solo se tienen en cuenta las líneas del archivo que provocan la actualización de una línea existente de la tabla. Este modo se puede utilizar para las tablas en las que es relevante la actualización de los datos.
• Solo eliminación: solo se tendrán en cuenta las líneas del archivo que provocan la eliminación de una línea existente de la tabla.

Carga de archivos

Deberá cargar un archivo de importación que contenga los datos que desea importar a su tabla.

El archivo puede ser un archivo .csv o Excel de un máximo de 100 MB. Se puede cargar desde su ordenador o desde una ubicación en la nube configurada en su licencia, como Transferbox o un FTP. Hay diferentes separadores y formatos disponibles, pero deben especificarse:

info

Para eliminar datos, el archivo puede ser un archivo .csv, Excel o de texto.

• Compresión: ZIP, GZIP o Ninguna

consejo

La compresión del archivo no es obligatoria, pero permite contener más datos. Intente comprimir su archivo si su CSV supera el límite de 100 MB.

• Formato: seleccione si importa un archivo Excel o CSV con separador de punto y coma, coma o tabulación (o un archivo de texto para la eliminación de datos).
• Codificación: las codificaciones admitidas son UTF-8, UTF 16 Little Endian, ISO-8859-1 y CP1252.
• Archivo con encabezado: este botón (marcado por defecto) indica si la primera línea del archivo corresponde a los encabezados de las columnas. Un archivo con encabezados facilita la asignación de datos. Si no contiene encabezados, el siguiente paso tendrá en cuenta el orden de las columnas.

Especificaciones del archivo

Su archivo deberá cumplir con ciertos requisitos específicos para ser aceptado.

• El archivo debe tener un tamaño máximo de 100 MB (en el caso de archivos comprimidos, solo cuenta el tamaño del ZIP).
• El orden de las columnas no importa.
• Las columnas obligatorias deben estar presentes. Las columnas no obligatorias pueden omitirse.
• Una misma columna no puede aparecer dos veces en el archivo.

Consejo

Haga clic en el botón «Descargar un ejemplo» para descargar un archivo ilustrativo con la estructura de su tabla y el tipo de valores de cada una de las columnas.

De este modo, tendrá un ejemplo concreto del formato que debe tener este archivo.

info

Las columnas correspondientes a los atributos técnicos «creationMoment», «updateMoment» e «id» se ignorarán durante la importación.

Esto significa que, si desea migrar datos de una tabla a otra, puede exportar los datos de la tabla e importarlos de nuevo sin tener que modificar el archivo.

Asignación de atributos

Este paso le permite establecer la correspondencia entre las columnas de su archivo (a la izquierda) y los atributos de la tabla (a la derecha).

tip

Si su archivo contiene encabezados, la inteligencia artificial de Actito realizará automáticamente la asignación entre la columna y el campo correspondiente.

El logotipo AIO indica los campos asignados automáticamente. Estos pueden modificarse manualmente.

• Si el encabezado de una columna no se corresponde con un atributo de la tabla, deberá realizar la asignación manualmente seleccionando el campo correspondiente en el menú desplegable.
  Se muestra una muestra de valores debajo del título de la columna.
• Si votre fichier ne contient pas d'en-tête, il faudra effectuer le mapping sur base de l'ordre des colonnes et l'échantillon de valeurs servant d'exemple.
• Si une colonne de votre fichier ne doit pas être importée, gardez l'option «Ignorer la colonne».
  El recuadro de la parte superior derecha indica todos los campos obligatorios (y únicos) que aún no se han asignado.
  

Todos los atributos obligatorios deben asignarse para permitir la creación de nuevas líneas, mientras que las claves permiten identificar las líneas existentes en los modos «Modificación/creación» y «Solo modificación».

Preparación de datos

En este paso, tiene varias opciones:

• Transformar: le permite aplicar reglas de transformación a los valores presentes en el archivo para limpiarlos o reformatearlos de modo que se ajusten a los valores esperados en Actito.
• Explorar las opciones avanzadas: le permite definir el método de carga de cada campo.
• Simular: le permite simular la importación del archivo e identificar posibles errores.

Transformar

Esta pantalla le permite:

• Visualizar las columnas del archivo y la asignación con los atributos de Actito realizada en el paso anterior.
• Consultar algunos valores presentes en el archivo para cada campo.
• Definir reglas de transformación que se pueden aplicar a sus campos.
• Previsualizar el resultado de estas transformaciones, aplicadas a los valores del archivo ya mostrados.
• Ignorar los valores no válidos:
• Si la casilla está desmarcada, en caso de que haya un valor no válido para este campo, la línea del archivo se rechazará por completo, incluso si los demás campos contienen valores válidos.
• Si la casilla está marcada, un valor no válido simplemente se ignorará y se dejará vacío en Actito, mientras que el resto de la línea se importará. Cabe señalar que, en el caso de un campo obligatorio, el resto de la línea se rechazará de todos modos.

Las reglas de transformación disponibles dependen del formato del campo. Para todos los campos:

• Posibilidad de definir una asignación entre los valores del archivo y los que se insertarán en Actito. Para los campos de tipo String (texto):
• Limpieza de texto
  • Escapar caracteres especiales
  • Cancelar el escape de caracteres especiales
  • Eliminar acentos (por ejemplo, convertirá «é» en «e»)
  • Eliminar caracteres
  • Reemplazar texto
• Formateo de texto
• Convertir a minúsculas
• Convertir a mayúsculas las iniciales
• Convertir a mayúsculas todos los caracteres
• Poner en mayúscula solo la primera letra
• Recorte de texto
• Eliminar los espacios al principio y al final de la cadena de caracteres
• Conservar los N primeros caracteres
• Conservar los N últimos caracteres
• Eliminar los N primeros caracteres
• Eliminar los N últimos caracteres

Para los campos de tipo Fecha o Timestamp:

• Formatear el formato de la fecha (y, en su caso, la hora para un timestamp)
• Eliminar los N últimos caracteres Para los campos de tipo Fecha o Timestamp:
• Formatear el formato de la fecha (y, en su caso, la hora para un timestamp)

Explorar las opciones avanzadas

Aquí puede definir dos comportamientos principales:

• Gestión de valores vacíos: la casilla de verificación permite definir cómo se tratan los posibles valores vacíos del archivo
• Si está marcada, se importará un valor vacío del archivo y podrá sobrescribir un valor no vacío previamente presente en Actito.
• Si está desmarcada, se ignorará un valor vacío en el archivo para evitar sobrescribir el valor ya existente en Actito.
• El tratamiento de los valores actualmente en la base: permite definir el comportamiento de la importación si ya hay valores en la base.
• Reemplazar los valores por los del archivo sobrescribirá los valores ya existentes en la base.
• Conservar los valores existentes solo permitirá añadir valores en lugar de los valores actualmente vacíos, pero no actualizar un valor existente.

Puede elegir el comportamiento deseado campo por campo o aplicar la misma regla a todos los campos a través de la primera línea.

Simular

Esta opción permite simular la carga del archivo (sin importar realmente los datos a la tabla correspondiente) e identificar de antemano los posibles problemas.

Se muestran todas las líneas del archivo, junto con su estado. Si no hay ninguna alerta en el campo, significa que no se ha identificado ningún error. Además, es posible filtrar mediante el botón «Mostrar solo advertencias» para mostrar solo los campos problemáticos.

Tiene acceso a todas las posibilidades de la opción «Transformar» descrita anteriormente, con el uso de reglas de transformación y la opción de ignorar los valores no válidos si es necesario.

En cualquier momento puede volver a iniciar una simulación que tendrá en cuenta las posibles reglas de transformación adaptadas y/o descargar el archivo corregido.

Si se vuelve a iniciar una simulación, la pantalla se actualizará con el resultado de esta nueva simulación, con la posibilidad de definir una nueva ronda de transformaciones. De este modo, es posible aplicar varias reglas de transformación consecutivas en el mismo campo si es necesario para que este tenga el formato adecuado en Actito.

Las opciones avanzadas también están disponibles, con las mismas posibilidades que se han explicado anteriormente.

Resumen

Este último paso le ofrece un resumen de los pasos anteriores. De este modo, puede comprobar dónde se cargarán los datos, en qué modo de importación, los parámetros de los archivos y la asignación de los campos con los atributos de Actito. Si se utilizan reglas de transformación y opciones avanzadas de carga, la interfaz lo indica con una cruz verde.

precaución

Las reglas de transformación no se conservan en esta configuración guardada de importación.

Guardar una configuración de importación

Si desea reutilizar sus parámetros de importación para futuras importaciones manuales, también puede guardar una configuración de importación antes de iniciarla.

Una configuración de importación guarda todos los detalles importantes:

• el nombre de la importación (se añadirá un sufijo incremental cuando cree nuevas importaciones basadas en la configuración)
• la tabla de destino y la entidad
• el tipo de archivo y su compresión
• la asignación de atributos
• los parámetros de carga.

Para crear una, haga clic en «Guardar como configuración».

A continuación, debe asignar un nombre a la configuración para poder encontrarla cuando seleccione un tipo de tabla en el paso 0.

info

Para eliminar una configuración guardada, seleccione «Crear una importación» para acceder a la pantalla de selección de configuraciones y cambie al «Modo de edición» en la esquina superior derecha.

Comprobar los resultados de la importación

Una vez iniciada la importación, esta aparecerá en la pestaña «En curso» hasta que finalice. Esto puede tardar entre unos segundos y unos minutos, dependiendo del volumen de datos importados.

Para comprobar los resultados de la importación y analizar los posibles archivos de error, consulte las secciones Ejecuciones completadas en la sección «Importación de datos».