Search the knowledge base, browse our resources, and visit our forum for more detailed information
Read in English | Lire en français | اقرأ باللغة العربية Última actualización: 15 Oct 2025
La vinculación dinámica te permite usar datos de un proyecto principal dentro de proyectos secundarios, simplificando el manejo de la recolección de datos longitudinales. Este artículo explica cómo vincular dinámicamente datos entre proyectos de KoboToolbox.
Nota: Los adjuntos de datos dinámicos funcionan de manera similar a la función pulldata(), pero eliminan la necesidad de archivos CSV separados, ya que los datos de un proyecto principal vinculado sirven como fuente de datos.
Puedes recuperar varias respuestas que no sean multimedia de un proyecto principal y realizar cálculos sobre estos datos vinculados en un proyecto secundario. Esto puede ser útil para recuperar datos de línea base, información de contacto o registros de salud en estudios de cohorte, o para confirmar o verificar datos recolectados previamente.
Recomendamos usar XLSForm para configurar adjuntos de datos dinámicos. Para ejemplos de proyectos principales y secundarios, descarga archivos de muestra aquí y aquí.
Vincular proyectos dinámicamente requiere un proyecto principal y al menos un proyecto secundario. El proyecto principal no requiere modificación de un XLSForm normal. Sin embargo, configurar el/los proyecto(s) secundario(s) implica los siguientes pasos:
En la hoja de cálculo survey de tu XLSForm, agrega una fila y establece el tipo de pregunta como xml-external.
En la columna name, proporciona un nombre corto para el formulario principal. Este nombre puede consistir en caracteres del alfabeto latino, guiones bajos y números.
Hoja de cálculo survey
type |
name |
label |
|---|---|---|
xml-external |
parent |
|
survey |
A lo largo del formulario, puedes recuperar valores del proyecto principal creando una nueva pregunta e incluyendo la expresión apropiada en la columna calculation (ver tabla a continuación). Puedes usar los siguientes tipos de pregunta para recuperar datos:
Usa un tipo de pregunta calculate para recuperar y almacenar valores para uso futuro dentro del formulario o conjunto de datos (por ejemplo, para cálculos o etiquetas de preguntas dinámicas).
Usa tipos de pregunta text, integer, decimal, select_one o select_multiple para incluir valores recuperados como respuestas predeterminadas en campos editables. Los datos editados en el proyecto secundario no cambiarán los datos originales en el proyecto principal.
Hoja de cálculo survey
type |
name |
label |
calculation |
|---|---|---|---|
xml-external |
parent |
||
text |
participant_id |
¿Cuál es el ID del/de la participante? |
|
integer |
age |
Confirma la edad del/de la participante |
instance(“parent”)/root/data[enrollment_id = current()/../participant_id]/age |
survey |
Nota:
Para mostrar datos vinculados sin permitir que los/as usuarios/as editen el campo, usa una pregunta calculate seguida de una pregunta note que muestre el valor calculado. Alternativamente, usa preguntas text, integer, decimal, select_one o select_multiple con la columna read_only establecida en TRUE.
En la columna calculation de la fila donde se recuperarán los datos vinculados, incluye una de las expresiones en la tabla a continuación. Estas expresiones se llaman XPaths.
Para cada expresión en la tabla a continuación:
parent es el nombre único asignado al formulario principal (por ejemplo, en la pregunta xml-external del formulario secundario).
parent_question se refiere al name de una pregunta del formulario principal.
child_question se refiere al name de una pregunta del formulario secundario.
parent_index_question es la pregunta identificadora del formulario principal que lo vincula al formulario secundario (por ejemplo, ID único, nombre de organización).
child_index_question es la pregunta identificadora del formulario secundario que lo vincula al formulario principal (por ejemplo, ID único, nombre de organización).
parent_group se refiere al name del grupo en el formulario principal en el que se encuentra la parent_question.
parent_index_group se refiere al name del grupo en el formulario principal en el que se encuentra la parent_index_question.
XPath |
Descripción |
|---|---|
|
Devuelve el número total de filas en el proyecto principal. |
|
Devuelve el número total de filas en el proyecto principal donde |
|
Devuelve el recuento total de instancias donde el valor de |
|
Devuelve el valor de |
|
Igual que arriba, pero especifica que solo se deben devolver datos de la primera instancia de |
|
Devuelve la suma de valores de |
|
Devuelve el valor máximo ingresado en |
|
Devuelve el valor mínimo ingresado en |
Nota: Si la pregunta principal no está incluida en ningún grupo, omite parent_group de la expresión.
Una vez que tus XLSForms estén configurados, inicia sesión en tu cuenta de KoboToolbox y sigue estos pasos:
Carga y despliega el proyecto principal, si aún no está desplegado. Asegúrate de que el proyecto principal tenga al menos un envío.
Habilita el intercambio de datos para el proyecto principal:
En la pestaña SETTINGS > Connect Projects del proyecto principal, activa el interruptor Data sharing (deshabilitado por defecto) y haz clic en ACKNOWLEDGE AND CONTINUE en la ventana de confirmación.
Todos los datos se comparten por defecto, pero puedes restringir variables específicas para compartir con proyectos secundarios haciendo clic en «Select specific questions to share».
Nota: Si los proyectos tienen diferentes propietarios/as, el/la propietario/a del proyecto principal debe compartir el proyecto con el/la propietario/a del proyecto secundario. Los permisos mínimos requeridos para que funcionen los adjuntos de datos dinámicos son View form y View submissions. Ten en cuenta que esto permite a los/as administradores/as del proyecto secundario ver todos los datos del proyecto principal.
Carga y despliega el proyecto secundario.
Conecta el proyecto secundario al proyecto principal:
En la pestaña SETTINGS > Connect Projects del proyecto secundario, haz clic en «Select a different project to import data from». Un menú desplegable te permitirá seleccionar un proyecto principal para vincular.
Renombra el proyecto principal vinculado al nombre de la pregunta xml-external definido en el XLSForm y haz clic en IMPORT.
Luego puedes seleccionar preguntas específicas del proyecto principal para compartir con el proyecto secundario, o seleccionar todas las preguntas.
Si agregas nuevos campos al formulario principal y deseas usarlos en el proyecto secundario, vuelve a importar el proyecto principal en la configuración del proyecto secundario.
Nota: Los formularios solo pueden vincularse entre sí si están en el mismo servidor de KoboToolbox.
Es posible que un proyecto principal y secundario sean el mismo proyecto. Los pasos son los mismos que los descritos anteriormente. Ejemplos de casos de uso incluyen:
Monitoreo diario: Si un formulario se usa para encuestar a la misma persona a lo largo del tiempo, puedes vincularlo a sí mismo para contar envíos anteriores. Esto puede permitirte mostrar un mensaje (por ejemplo, «el monitoreo está completo») después de un cierto número de entradas o informar al/a la encuestador/a del número de formularios enviados, como se muestra en el ejemplo a continuación.
Hoja de cálculo survey
type |
name |
label |
calculation |
|---|---|---|---|
xml-external |
monitoring |
||
text |
participant_id |
¿Cuál es el ID del/de la participante? |
|
calculate |
count |
count(instance(“monitoring”)/root/ data[monitoring/participant_id = current()/../participant_id]) |
|
note |
monitoring_note |
Este/a participante ha sido encuestado/a ${count} veces. |
|
survey |
Formulario de registro: Al vincular un formulario de registro a sí mismo, puedes verificar si un/a usuario/a ya ha sido registrado/a. Esto puede permitirte generar un mensaje de error o agregar una restricción si ya está registrado/a, previniendo registros duplicados, como se muestra en el ejemplo a continuación.
Hoja de cálculo survey
type |
name |
label |
calculation |
relevant |
|---|---|---|---|---|
xml-external |
registration |
|||
text |
customer_id |
¿Cuál es el número de ID del/de la cliente? |
||
calculate |
count |
count(instance(“registration”)/root/ data[registration/customer_id = current()/../customer_id]) |
||
note |
already_registered |
Este/a cliente ya está registrado/a. Por favor cierra este formulario. |
${count} > 0 |
|
survey |
Los datos para proyectos vinculados dinámicamente pueden recolectarse usando la aplicación de Android de KoboCollect o formularios web de Enketo.
Al recolectar datos, ten en cuenta lo siguiente:
El proyecto principal debe tener al menos un envío para que el proyecto secundario funcione correctamente.
Al recolectar datos en línea, hay un retraso de cinco minutos en la sincronización de nuevos datos del proyecto principal con el proyecto secundario.
En modo sin conexión, descarga frecuentemente el proyecto secundario para asegurar la sincronización de datos con el proyecto principal.
Nota: Puedes configurar la aplicación de Android de KoboCollect para actualizar automáticamente los datos del proyecto principal cuando haya una conexión a internet disponible. Ve a Settings > Form management > Blank form update mode y selecciona Previously downloaded forms only o Exactly match server. Puedes establecer la frecuencia de descarga automática para que ocurra cada 15 minutos, cada hora, cada seis horas o cada 24 horas. Ten en cuenta que habilitar esta configuración puede aumentar el consumo de batería.
[position()=1], como se muestra a continuación:
instance('parent')/root/data[parent_index_group/parent_index_question = current()/../child_index_question][position()=1]/parent_group/parent_question
Did you find what you were looking for? Was the information clear? Was anything missing?
Share your feedback to help us improve this article!
KoboToolbox is maintained by Kobo Inc.