Saltar a contenido

Importar datos

La página Importar datos te permite subir datos de forma masiva en un form schema desde un archivo .xls, .xlsx o .csv. Un asistente de tres pasos — Subir archivo, Asignar campos, Resultado — te guía a través de la carga del archivo, la asignación de sus columnas a los campos del form y la revisión del resultado.

Vista principal de la página Importar datos

Acceder a la página de importación

  1. Ve a la lista Formularios y selecciona un form schema.
  2. Desde la vista de datos del form, haz clic en Importar formularios en la barra de herramientas.

Paso 1 — Subir archivo

El primer paso muestra una zona de arrastrar y soltar o un selector de archivos.

  • Formatos aceptados: .xls, .xlsx, .csv
  • Tamaño máximo del archivo: 20 MB

Para subir un archivo:

  1. (Opcional) Deja marcada la opción Reutilizar métricas existentes con el mismo nombre (valor predeterminado) para que cualquier métrica del archivo cuyo nombre coincida con una métrica ya existente en el sistema se vincule a esa métrica existente en lugar de crear un duplicado. Desmárcala para crear siempre métricas nuevas.
  2. Arrastra un archivo a la zona punteada o haz clic en Elegir un archivo para buscarlo.
  3. Una vez leído el archivo, el asistente pasa por sí solo a Asignar campos.

Dar formato al archivo de importación

Consulta la descripción en la sección más abajo

Formatos de archivo sencillos

Dino acepta el mismo archivo que se obtiene durante la exportación. Por lo tanto, la forma más sencilla de obtener un archivo con el formato adecuado para la importación es exportar primero algunos datos del mismo esquema y luego eliminar las filas que contienen los datos exportados, conservando solo los encabezados de columna. En cualquier caso, asegúrate de que los encabezados de columna sean claros: se usarán como sugerencias durante la asignación.

Métricas identificadas por ID

Si una columna de métrica de tu archivo proporciona el ID (UUID) de la métrica, esa fila se vincula a la métrica existente con ese ID y no se crea ninguna métrica nueva. El ID tiene prioridad sobre el nombre de la métrica, por lo que esto ocurre independientemente de la opción Reutilizar métricas existentes con el mismo nombre (que solo se aplica a la coincidencia por nombre).

Paso 2 — Asignar campos

Tras la carga, verás una tabla con todas las columnas de tu archivo. Cada fila tiene tres columnas:

  • Columna del archivo – el encabezado original de tu archivo.
  • Campo – un menú desplegable donde seleccionas el campo del form correspondiente.
  • Estado – muestra si la columna está asignada, ignorada o tiene un error.

Acciones de asignación

  • Seleccionar un campo del form – abre el menú desplegable de una columna y elige el campo correcto. Puedes buscar dentro del menú desplegable.
  • Ignorar una columna – selecciona la opción — Ignorar esta columna — en el menú desplegable, o haz clic en el botón Ignorar de la columna de estado. Las columnas ignoradas aparecen atenuadas.
  • Restaurar una columna ignorada – haz clic en el botón Restaurar de la columna de estado.

Coincidencia automática

Cuando se lee el archivo, Dino asigna cada columna cuyo encabezado sea exactamente el nombre de un campo del form, o el nombre de un campo repetible seguido de __N (consulta Diapositivas repetibles). Las demás columnas quedan pendientes de que las asignes tú.

Haz clic en Reasociar todo para restablecer todas las columnas y dejar que Dino las asocie de nuevo, esta vez emparejando también las columnas con campos cuyos nombres o etiquetas sean similares. Revisa el resultado y ajusta las asignaciones según sea necesario.

La coincidencia funciona mejor con encabezados que son los nombres de los campos, como en un archivo exportado.

Repetición

Si el campo del form seleccionado es un campo repetible (por ejemplo, varios números de teléfono), aparece un campo Repetición debajo del menú desplegable. Introduce el índice de repetición (0, 1, 2, …) para asignar esta columna del archivo a una ocurrencia del grupo repetible.

Resumen de la barra de herramientas

En la parte superior del área de asignación puedes ver tres indicadores:

  • Total de columnas – número de columnas del archivo.
  • Asignado – columnas que se han asignado a un campo del form.
  • Ignorado – columnas que decidiste ignorar.

Usa el campo Buscar columnas… para filtrar la tabla por el nombre de la columna del archivo.

Haz clic en Atrás para volver al paso de carga: el archivo y las asignaciones se descartan, y debes elegir el archivo de nuevo.

Cuando todas las columnas deseadas estén asignadas y no existan errores, el botón Aplicar importación se activa. Haz clic en él para iniciar la importación. Mientras se procesa, aparece un indicador de carga.

Asignación duplicada

Si asignas el mismo campo del form a más de una columna del archivo, se muestra un error de validación (Campo asignado a más de una columna) y el botón Aplicar importación permanece deshabilitado hasta que se corrija.

Paso 3 — Resultado

El último paso informa de lo que ha ocurrido:

  • Un aviso te indica si la importación fue correcta, parcial (algunas filas fueron rechazadas) o terminó con un ERROR (no se importó nada).
  • Los contadores muestran Filas importadas, Filas rechazadas, Filas del archivo y Métricas creadas.
  • Las listas de incidencias muestran las filas del archivo afectadas y el motivo. Usa Buscar por fila o error para filtrar listas largas.

Haz clic en Cerrar para volver a la lista de datos del form, donde aparecen los nuevos datos. Tras un error, Atrás te lleva de nuevo al paso de asignación para corregir los problemas.

Formato del archivo

Describimos el procedimiento para importar datos de forma masiva usando un archivo Excel generado a partir de una hoja de Google. El mismo procedimiento sirve para archivos CSV o si trabajas directamente con Excel.

Supongamos que quieres importar datos en un form llamado Projects que tiene 2 diapositivas, una de las cuales es una diapositiva repetible:

El form Projects, con dos diapositivas, una de las cuales es repetible

El form Projects se creó con el siguiente XLSForm. La hoja "survey" es

type name label
begin group start Start
select_one countries country Country
select_multiple countries country_other Other Countries
text title Project Title
date project_date_start Start date
select_one donors selected_donor Donor
integer budget Budget
boolean isleader Leading applicant
end group
begin repeat indicators Indicators
text indic Indicator description
integer value_indic Value reached
end repeat

y la de "choices" es

list_name name label
donors ue UE
donors govita ITALIAN GOVERNMENT
donors un UN
donors pub ALTRI DONATORI PUBBLICI
donors la ENTI LOCALI
donors priv DONATORI PRIVATI
donors other Others
countries AFG Afghanistan
countries ALB Albania
countries DZA Algeria
countries ASM American Samoa

Sigue estos pasos:

  1. Crea un archivo vacío con una sola hoja (los nombres del archivo y de la hoja no importan).
  2. En la primera fila debes poner los nombres de los campos del form y de los campos específicos de DINO. En este ejemplo, los campos del form pueden ser:
  3. country
  4. country_other
  5. title
  6. project_date_start
  7. selected_donor
  8. budget
  9. isleader
  10. indic (*)
  11. value_indic (*)

ten en cuenta que los campos que están dentro de diapositivas repetibles deben tratarse de forma diferente (por eso hemos puesto un asterisco). Consulta la sección específica más abajo.

Los campos específicos de DINO pueden ser:

  1. created_at. La fecha de creación del form. Especifica esto solo si quieres que tus forms tengan una fecha de creación distinta a la fecha de importación;
  2. user_data_ref_id. El ID del usuario que se asociará al form. Solo se aplica cuando importa un administrador; para los demás usuarios el valor se ignora y los forms se asignan al usuario que los está importando;
  3. area_id. El ID de la métrica AREA que se asociará al form;
  4. [area_name]
  5. case_id. El ID de la métrica CASE que se asociará al form;
  6. [case_name]
  7. project_id. El ID de la métrica PROJECT que se asociará al form;
  8. [project_name]
  9. [project_code]
  10. location_id. El ID de la métrica LOCATION que se asociará al form;
  11. [location_name]
  12. organization_id. El ID de la métrica ORGANISATION que se asociará al form;
  13. [organization_name]
  14. form_status_name. El nombre de uno de los estados del form schema. Las filas sin este valor reciben el primer estado del esquema. Si algún valor no coincide con un nombre de estado existente, el archivo no se importa (Estado del form no válido);
  15. dinoinvalid. Marca el form como no válido. Usa true, 1, yes, y o x; cualquier otro valor o una celda vacía deja el form como válido.

  16. cada fila corresponderá a un form nuevo diferente. Así, si creamos un archivo con un encabezado más, digamos, 5 filas de datos, si la carga se realiza correctamente, crearemos 5 forms nuevos en DINO.

  17. No es necesario tener una columna para cada campo del form; no es necesario rellenar todas las filas de una columna determinada, pero si un campo está vacío en todas las filas, se puede omitir.
  18. Los campos de fecha deben tener el formato AAAA-MM-DD como texto (ten cuidado).
  19. Los campos de opción única deben contener una de las opciones aceptadas según lo especificado en "choices" (consulta el form builder o el archivo XLSForm).
  20. Los campos de opción múltiple deben tener el siguiente formato: [opt1, opt2] (es decir, una lista de opciones entre corchetes).

Por ejemplo, un archivo válido podría ser el siguiente:

country country_other title project_date_start budget isleader area_id
ALB [AFG,DZA] Human rights in education 2022-01-28 120000 true 81387ff7-5c7d-44e7-9dc6-76b8d09265ac
ASM A new approach to social justice 2022-02-14 20000 81387ff7-5c7d-44e7-9dc6-76b8d09265ac

En este caso estamos importando 2 forms; para ambos seleccionamos solo la métrica AREA. Además, fíjate en que no proporcionamos todos los campos del form para todos los forms, pero para los campos en los que sí proporcionamos un valor, seguimos estrictamente las indicaciones descritas arriba.

Gestionar las métricas durante la importación

Durante la importación de datos de un form, en lo que a métricas se refiere, puede que quieras:

  • crear métricas nuevas durante la importación
  • reutilizar métricas ya creadas

Las reglas que hay que seguir para gestionar correctamente las métricas son las siguientes:

MÉTRICA CREAR DESDE LA UI CREAR DESDE LA IMPORTACIÓN CREAR + ASIGNAR DESDE LA IMPORTACIÓN USAR DESDE LA IMPORTACIÓN CREAR + ASIGNAR DESDE LA IMPORTACIÓN (padre) USAR COMO PADRE
Caso name name name id, o name (con la opción de reutilización), o ambos name, en otra fila del mismo archivo id o name
Organización name name name id, o name (con la opción de reutilización), o ambos name, en otra fila del mismo archivo id o name
Ubicación name name name id, o name (con la opción de reutilización), o ambos name, en otra fila del mismo archivo id o name
Área name name name id, o name (con la opción de reutilización), o ambos name, en otra fila del mismo archivo id o name
Proyecto name, code name, code name, code id, o name (con la opción de reutilización), o ambos name y code, en otra fila del mismo archivo id o name

Cuando una fila tiene tanto el id como el name de una métrica, prevalece el id y el name se ignora. Solo se crea una métrica nueva cuando se indica el name y el id está vacío.

Los padres se establecen con las columnas <metric>_parent_id y <metric>_parent_name (por ejemplo location_parent_name), y solo se aplican a las métricas creadas por la importación. El padre debe ser del mismo tipo de métrica, y debe existir ya o ser creado por otra fila del mismo archivo, en cualquier orden. Un padre que no coincide con nada no se crea: esa métrica se informa como métrica con padre no válido.

Diapositivas repetibles

Si tienes campos en diapositivas repetibles, deben nombrarse de forma diferente. Cada campo de la diapositiva repetible debe llamarse \<field_name>__X, donde X es el número de repetición, de 0 (correspondiente a una repetición) a N-1, donde N es el número total de repeticiones de la diapositiva en ese form.
Por ejemplo, supongamos que tienes solo 1 repetición de la diapositiva repetible y quieres añadir los campos "Indicator description" y "Value reached". Tendrías que añadir estas dos columnas a tu archivo de importación:

indic__0 value_indic__0
Number of children 100

Así, por ejemplo, podríamos tener:

country budget indic__0 value_indic__0 indic__1 value_indic__1 isleader
ALB 120000 Children 100 true
ASM 20000
AFG 15000 Parents 45 Schools 34 true

Errores

  • IDs desconocidos – si una columna hace referencia a un usuario o a una métrica mediante un ID que no existe en Dino, el archivo completo no se importa (¡Archivo no importado!), y el resultado muestra los IDs de usuario no válidos o los IDs de métrica no válidos. Comprueba los IDs de tu archivo antes de importar.
  • Estado del form desconocido – un form_status_name que no coincide con ningún estado del esquema también detiene la importación (Estado del form no válido).
  • Métricas que no se pueden vincular – una fila que nombra una métrica que Dino no puede crear o encontrar se rechaza, y el resultado muestra el motivo; las demás filas se importan.