Creación de encuestas para CareSuite

La creación de encuestas es un requisito fundamental para operacionalizar tanto las aplicaciones Contact como Care. CareSuite trabaja con Kobotoolbox como un complemento de creación de formularios para permitir a los usuarios

Guía para la creación de encuestas en CareSuite

Esta guía proporciona las mejores prácticas completas y los anti-patróns para crear encuestas en CareSuite

Tipos de encuestas en CareSuite

CareSuite admite cuatro tipos principales de encuestas:

1. Encuesta de ingreso

Propósito: Recopilación de datos para la creación de casos en un proyecto
Alcance: A nivel de proyecto (cada proyecto tiene una encuesta de ingreso)
Uso: Se utiliza al crear o actualizar casos
Almacenamiento: Las respuestas de la encuesta se almacenan en la entidad Caso
Características clave: Requerida para todos los proyectos, utilizada para la creación de casos

2. Encuesta demográfica

Propósito: Recopilación de información demográfica a nivel de perfil
Alcance: A nivel de organización (cada organización tiene una encuesta demográfica)
Uso: Utilizada para recopilar y actualizar los datos demográficos del perfil
Almacenamiento: Las respuestas de la encuesta se almacenan en la entidad Perfil (profile.survey)
Características clave: Utilizada para la búsqueda global de perfiles y la recopilación de datos demográficos

3. Encuesta de seguimiento

Propósito: Recopilación de datos de seguimiento posterior a la derivación
Alcance: A nivel de proyecto (opcional, cada proyecto puede tener una encuesta de seguimiento)
Uso: Completada por los gestores de casos después de la prestación del servicio
Almacenamiento: Las respuestas de la encuesta se almacenan como respuestas de encuesta de seguimiento por derivación

4. Encuestas adicionales

Propósito: Recopilación de datos complementaria y personalizada
Alcance: A nivel de proyecto (se permiten múltiples encuestas adicionales por proyecto)
Uso: Encuestas personalizadas para necesidades específicas de recopilación de datos
Almacenamiento: Las respuestas de la encuesta se almacenan en additionalSurveyResponse tabla
Características clave: Admite respuestas únicas y múltiples por caso por encuesta

Requisitos de formato de la encuesta

Formato de archivo

Tipo de archivo: XML (.xml extensión)
Tipo MIME: text/xml
Tamaño máximo de archivo: 10 MB (MAX_SURVEY_FILESIZE = 10 * 1024 * 1024)
Estándar de formato: Formato XForms/ODK (Open Data Kit)
Compatibilidad: Debe ser compatible con el formato Kobo Toolbox

Requisitos de estructura XML

Las encuestas deben seguir la estructura XML XForms/ODK:

<?xml version="1.0"?>
<h:html xmlns="http://www.w3.org/2002/xforms" 
        xmlns:ev="http://www.w3.org/2001/xml-events" 
        xmlns:h="http://www.w3.org/1999/xhtml" 
        xmlns:jr="http://openrosa.org/javarosa" 
        xmlns:odk="http://www.opendatakit.org/xforms" 
        xmlns:orx="http://openrosa.org/xforms" 
        xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <h:head>
    <h:title>Título de la encuesta</h:title>
    <model odk:xforms-version="1.0.0">
      <itext>
        <translation default="true()" lang="English (en)">
          <!-- Traducciones de texto para etiquetas, pistas y etiquetas de opciones -->
        </translation>
      </itext>
      <instance>
        <!-- Estructura de datos del formulario -->
      </instance>
      <bind>
        <!-- Enlaces de campos con tipos y validación -->
      </bind>
    </model>
  </h:head>
  <h:body>
    <!-- Cuerpo del formulario con campos de entrada -->
  </h:body>
</h:html>

Espacios de nombres requeridos

http://www.w3.org/2002/xforms
http://www.w3.org/2001/xml-events
http://www.w3.org/1999/xhtml
http://openrosa.org/javarosa
http://www.opendatakit.org/xforms
http://openrosa.org/xforms
http://www.w3.org/2001/XMLSchema

Tipos de datos compatibles

Para un desglose más detallado de los tipos de datos vea Tipos de datos compatibles

✅ Tipos totalmente compatibles

1. string (Texto)

Tipo XML: type="string"
Uso: Campos de entrada de texto, nombres, descripciones, notas
Operadores de consulta: Igual, No igual, Comienza con, Termina con, Contiene, No contiene, Está vacío, No está vacío, En, No en

Ejemplo:

<bind nodeset="/form/field_name" type="string"/>
<input ref="/form/field_name">
  <label>Etiqueta del campo</label>
</input>

2. int (Entero)

Tipo XML: type="int"
Uso: Números enteros (edad, conteos, puntuaciones)
Operadores de consulta: Igual, No igual, Mayor que, Menor que

Ejemplo:

<bind nodeset="/form/caller_age" type="int"/>
<input ref="/form/caller_age">
  <label>Edad</label>
</input>

3. date (Fecha)

Tipo XML: type="date"
Uso: Campos de fecha (sin componente de hora)
Operadores de consulta: Igual a, Después, Antes, Entre
Formato: Formato de fecha ISO (AAAA-MM-DD)

Ejemplo:

<bind nodeset="/form/BTS_Date" type="date"/>
<input ref="/form/BTS_Date">
  <label>Fecha</label>
</input>

4. select1 (Selección única)

Tipo XML: type="string" con <select1> entrada
Uso: Menú desplegable de opción única / botones de opción
Operadores de consulta: Igual, No igual, Está vacío, No está vacío

Ejemplo:

<bind nodeset="/form/gender" type="string"/>
<select1 ref="/form/gender">
  <label>¿Cuál es su género?</label>
  <item>
    <label>Mujer</label>
    <value>female</value>
  </item>
  <item>
    <label>Hombre</label>
    <value>male</value>
  </item>
</select1>

5. select (Selección múltiple)

Tipo XML: type="string" con <select> entrada
Uso: Casillas/listas de opciones múltiples
Almacenamiento: Valores almacenados como cadena separada por espacios (por ejemplo, "value1 value2 value3")
Operadores de consulta: Igual, No igual, Está vacío, No está vacío

Ejemplo:

<bind nodeset="/form/race" type="string"/>
<select ref="/form/race">
  <label>Seleccione todos los que correspondan</label>
  <item>
    <label>Hispano o latino</label>
    <value>hispanic_or_latino</value>
  </item>
  <item>
    <label>Blanco</label>
    <value>white</value>
  </item>
</select>

❌ Tipos no compatibles

Los siguientes tipos de datos no están compatibleS y deben evitarse:

time - Campos solo de hora (use string o un campo de fecha separado)
dateTime - Fecha y hora combinadas (use date como tipo y almacene la hora por separado si es necesario)
decimal - Números decimales (pueden funcionar como int, pero no son explícitamente compatibles)
boolean - Valores booleanos (use select1 con opciones "yes"/"no" en su lugar)
geopoint - Coordenadas geográficas (almacenar como lat/lng separados string o int campos)
geotrace - Rutas geográficas
geoshape - Formas/polígonos geográficos
binary - Cargas de archivos (no compatibles en encuestas)
barcode - Escaneo de códigos de barras
intent - Intenciones de aplicaciones externas

Mejores prácticas

1. Nomenclatura de campos

✅ HACER:

Use nombres de campo descriptivos, en minúsculas y con guiones bajos: caller_age, first_time_caller, hear_about_211
Use convenciones de nombres consistentes en toda la encuesta
Mantenga los nombres de campo concisos pero significativos
Use snake_case para nombres de campo con varias palabras

❌ NO HAGA:

Usar espacios en los nombres de campo
Usar caracteres especiales (excepto guiones bajos)
Usar camelCase (use snake_case en su lugar)
Usar nombres de campo extremadamente largos

Ejemplo:

<!-- Bueno -->
<bind nodeset="/form/caller_frequency" type="string"/>

<!-- Malo -->
<bind nodeset="/form/CallerFrequency" type="string"/>
<bind nodeset="/form/caller frequency" type="string"/>

2. Organización de campos con grupos

✅ HACER:

Organice campos relacionados usando <group> elementos
Use nombres de grupo descriptivos: group_AARP_careprovider, group_kick_it
Anide grupos cuando sea necesario para crear jerarquías lógicas

Ejemplo:

<bind nodeset="/form/group_callback_contact" relevant="..." required="false()"/>
<bind nodeset="/form/group_callback_contact/given_familyName" required="false()" type="string"/>
<bind nodeset="/form/group_callback_contact/telephone_001" required="false()" type="string"/>

3. Use itext para todo el contenido de texto

✅ HACER:

Siempre use <itext> traducciones para etiquetas, pistas y etiquetas de opciones
Referencia el texto usando jr:itext() función
Mantenga el contenido de texto real en la sección itext, no en línea

Ejemplo:

<itext>
  <translation default="true()" lang="English (en)">
    <text id="/form/gender:label">
      <value>¿Cuál es su género?</value>
    </text>
    <text id="/form/gender/hint">
      <value>Pregunte solo si no está seguro</value>
    </text>
    <text id="/form/gender/female:label">
      <value>Mujer</value>
    </text>
  </translation>
</itext>

<select1 ref="/form/gender">
  <label ref="jr:itext('/form/gender:label')"/>
  <hint ref="jr:itext('/form/gender:hint')"/>
  <item>
    <label ref="jr:itext('/form/gender/female:label')"/>
    <value>female</value>
  </item>
</select1>

4. Lógica condicional (atributos relevant)

✅ HACER:

Use relevant atributos para la visualización condicional de campos
Use expresiones XPath claras y legibles
Pruebe todas las rutas de lógica condicional

Ejemplo:

<bind nodeset="/form/smoke_cigarettes" type="string"/>
<bind nodeset="/form/group_kick_it" 
      relevant="/form/smoke_cigarettes = 'yes'" 
      required="false()"/>

5. Campos obligatorios

✅ HACER:

Use required atributos con condiciones XPath claras
Considere usar lógica condicional de obligatoriedad cuando sea apropiado
Permita que los campos sean opcionales cuando los datos puedan no estar disponibles

Ejemplo:

<!-- Obligatorio cuando otro campo está vacío -->
<bind nodeset="/form/gender" 
      required="/form/Incomplete_General_Screener = ''" 
      type="string"/>

<!-- Siempre opcional -->
<bind nodeset="/form/other_race" 
      relevant="/form/race = 'other'" 
      required="false()" 
      type="string"/>

6. Validación y restricciones

✅ HACER:

Use restricciones regex para la validación de formatos (números de teléfono, correos electrónicos, etc.)
Proporcione mensajes de restricción claros usando jr:constraintMsg
Valide los datos a nivel de campo cuando sea posible

Ejemplo:

<!-- Validación de número de teléfono -->
<bind nodeset="/form/telephone" 
      constraint="regex(.,'^[0-9]{10}$')" 
      jr:constraintMsg="Formato: xxxxxxxxxx (Por favor no agregue caracteres de formato)" 
      required="false()" 
      type="string"/>

<!-- Validación de correo electrónico -->
<bind nodeset="/form/email" 
      constraint="regex(., '^[A-Za-z0-9._%+-]+@[A-Za-z0-9-]+[.][A-Za-z.]{2,}$')" 
      required="false()" 
      type="string"/>

7. Campos calculados

✅ HACER:

Use calculate atributos para valores computados
Marque los campos calculados como readonly="true()"
Incluya restricciones que impidan la modificación manual si es necesario

Ejemplo:

<bind nodeset="/form/isolation_score" 
      calculate="/form/group_xe5xh95/score_calc" 
      constraint="regex(., /form/group_xe5xh95/score_calc)" 
      jr:constraintMsg="Por favor no modifique" 
      readonly="true()" 
      type="int"/>

8. Valores precargados

✅ HACER:

Use jr:preload para valores auto-poblados (marcas de tiempo, IDs de instancia)
Use parámetros de preload apropiados

Ejemplo:

<!-- Marca de tiempo de inicio -->
<bind jr:preload="timestamp" 
      jr:preloadParams="start" 
      nodeset="/form/start" 
      type="dateTime"/>

<!-- Marca de tiempo de fin -->
<bind jr:preload="timestamp" 
      jr:preloadParams="end" 
      nodeset="/form/end" 
      type="dateTime"/>

<!-- ID de instancia -->
<bind jr:preload="uid" 
      nodeset="/form/meta/instanceID" 
      readonly="true()" 
      type="string"/>

9. Manejo de fechas

✅ HACER:

Use date() función para valores de fecha por defecto
Establezca fechas por defecto usando <setvalue> eventos cuando sea apropiado
Use restricciones de fecha para la validación

Ejemplo:

<bind nodeset="/form/BTS_Date" 
      constraint=". = date('today()')" 
      relevant="..." 
      required="false()" 
      type="date"/>
<setvalue event="odk-instance-first-load" 
          ref="/form/BTS_Date" 
          value="today()"/>

10. Manejo de datos incompletos

✅ HACER:

Incluya opciones para manejar la recopilación de datos incompleta
Proporcione opciones estándar: "No se preguntó", "Se negó a responder", "Llamada terminada temprano", "Llamada de crisis - No se preguntó"
Haga que los campos sean condicionalmente obligatorios según el estado de finalización

Ejemplo:

<select ref="/form/Incomplete_General_Screener">
  <label>Recopilación de datos incompleta</label>
  <item>
    <label>No se preguntó</label>
    <value>did_not_ask</value>
  </item>
  <item>
    <label>Se negó a responder</label>
    <value>declined_to_answer</value>
  </item>
  <item>
    <label>Llamada terminada temprano</label>
    <value>call_terminated_early</value>
  </item>
</select>

<!-- Hacer que otros campos sean obligatorios solo cuando no esté incompleto -->
<bind nodeset="/form/gender" 
      required="/form/Incomplete_General_Screener = ''" 
      type="string"/>

Anti-patrones comunes y cosas a evitar

1. ❌ Uso de tipos de datos no compatibles

Problema: El uso de tipos de datos que no son compatibles (dateTime, time, binary, etc.) causará problemas con el almacenamiento de datos, las consultas y la visualización.

Solución:

Use date en lugar de dateTime (almacenar la hora por separado si es necesario)
Use string para valores booleanos con opciones select1
Use string o campos separados int para coordenadas geográficas

2. ❌ Nomenclatura de campos inconsistente

Problema: La nomenclatura inconsistente (mezclar camelCase, snake_case, espacios) hace que las encuestas sean más difíciles de mantener y consultar.

Solución:

Use siempre snake_case para los nombres de campo
Establezca y siga un documento de convenciones de nomenclatura
Use nombres descriptivos que indiquen el propósito del campo

3. ❌ Texto en línea en lugar de itext

Problema: Incrustar texto directamente en las definiciones de campos dificulta las traducciones y el mantenimiento.

Solución:

Siempre use <itext> traducciones
Referencia el texto usando jr:itext()
Mantenga todo el texto visible por el usuario en la sección itext

4. ❌ Espacios de nombres XML faltantes o incorrectos

Problema: Los espacios de nombres faltantes o incorrectos pueden causar errores de análisis.

Solución:

Incluya todos los espacios de nombres requeridos en el <h:html> elemento raíz
Use las URIs de espacios de nombres exactas especificadas en los requisitos de formato

5. ❌ Lógica condicional demasiado compleja

Problema: Expresiones muy complejas son difíciles de mantener y depurar. relevant o required Divida las condiciones complejas en expresiones más simples y comprobables

Solución:

Use campos calculados intermedios cuando sea necesario
Documente la lógica compleja con comentarios (si los comentarios XML son compatibles)
6. ❌ Enlaces de campo faltantes

Los campos definidos en el cuerpo sin las correspondientes

Problema: declaraciones pueden no funcionar correctamente. <bind> Cree siempre un

Solución:

elemento para cada campo en el cuerpo del formulario <bind> Asegúrese de que las rutas nodeset coincidan exactamente entre los elementos bind y input
Incluya atributos apropiados de tipo, required y relevant
7. ❌ Almacenamiento incorrecto de valores de selección múltiple

Esperar que los valores de selección múltiple se almacenen como matrices cuando en realidad son cadenas separadas por espacios.

Problema: Recuerde que

Solución:

(selección múltiple) los valores se almacenan como cadenas separadas por espacios <select> Al consultar, use operadores de cadena apropiados
Al mostrar, divida la cadena para obtener valores individuales
// Valor de selección múltiple: "value1 value2 value3"

Ejemplo:

const selections = value.split(' '); // Dividir en matriz
8. ❌ Tamaño de archivo que excede los límites

Las encuestas que excedan los 10 MB serán rechazadas durante la carga.

Problema: Mantenga las encuestas enfocadas y evite campos innecesarios

Solución:

Optimice el contenido itext (evite texto duplicado)
Elimine campos y grupos no utilizados
Considere dividir encuestas muy grandes en varias encuestas adicionales
9. ❌ Falta de validación para campos críticos

Los campos críticos (números de teléfono, correos electrónicos, etc.) sin validación pueden conducir a mala calidad de datos.

Problema: Agregue siempre restricciones regex para números de teléfono, correos electrónicos, códigos postales

Solución:

Proporcione mensajes de restricción claros y útiles
Pruebe la validación con diversas entradas válidas e inválidas
10. ❌ Uso del tipo dateTime para fechas

Usar

Problema: el tipo no es compatible y puede causar errores. dateTime para campos de fecha

Solución:

Siempre use type="date" Si se necesita la hora, almacénela en un
campo separado string Nota: El sistema puede aceptar
en declaraciones bind para campos de metadatos (como marcas de tiempo de inicio/fin), pero use dateTime para fechas ingresadas por el usuario date 11. ❌ Falta de opciones para datos incompletos

No proporcionar opciones para la recopilación de datos incompleta dificulta el seguimiento de por qué las encuestas están incompletas.

Problema: Incluya un campo "Incomplete General Screener" o similar al inicio

Solución:

Proporcione opciones estándar para escenarios incompletos
Haga que otros campos sean condicionalmente obligatorios según el estado de finalización
12. ❌ Valores de opción codificados en duro

Usar las etiquetas de opción como valores dificulta el análisis de datos y es propenso a errores.

Problema: Use siempre valores en minúsculas y separados por guiones bajos

Solución:

Mantenga las etiquetas legibles para humanos pero valores consistentes
Ejemplo: label="Female", value="female" (no "Female" como valor)
13. ❌ No usar grupos para campos relacionados

Las estructuras de campos planas hacen que las encuestas sean más difíciles de navegar y comprender.

Problema: Agrupe campos relacionados usando

Solución:

Cree jerarquías lógicas (por ejemplo, <group> elementos
group_callback_contact/telephone_001 group_callback_contact/telephone_001)
Use nombres de grupo descriptivos

14. ❌ Falta el ID de instancia en Meta

Problema: No incluir un campo meta/instanceID dificulta rastrear instancias de encuestas.

Solución:

Incluya siempre una sección meta con instanceID
Use jr:preload="uid" para generar automáticamente IDs únicos
Mantenlo de solo lectura

Ejemplo:

<bind jr:preload="uid" 
      nodeset="/form/meta/instanceID" 
      readonly="true()" 
      type="string"/>

Convenciones de nomenclatura de campos

Patrones de nomenclatura recomendados

Use snake_case: caller_age, first_time_caller, hear_about_211
Sea descriptivo: caller_frequency no freq
Use prefijos para grupos: group_AARP_careprovider, group_kick_it
Use sufijos para campos relacionados: telephone_001, email_001, givenName, familyName
Mantenga los nombres concisos: Evite nombres extremadamente largos, pero priorice la claridad

Ejemplos de encuestas en producción

✅ Buenos ejemplos:

Incomplete_General_Screener
caller_frequency
caller_age
BTS_Date
group_kick_it
group_callback_contact

❌ Evitar:

Mayúsculas y minúsculas mezcladas sin separación: callerAge, CallerFrequency
Espacios: caller age, first time caller
Caracteres especiales: caller-age, caller.age
Demasiado genérico: field1, data, value

Directrices de estructura de la encuesta

1. Flujo lógico

Comience con opciones de filtro/incompletas
Agrupe las preguntas relacionadas
Use lógica condicional para mostrar/ocultar secciones
Finalice con campos de metadatos opcionales

2. Campos obligatorios vs opcionales

Haga que los campos sean obligatorios solo cuando sea absolutamente necesario
Use lógica condicional de obligatoriedad cuando corresponda
Considere escenarios de recopilación de datos (llamadas incompletas, respuestas rechazadas)

3. Organización de grupos

Use grupos para organizar campos relacionados
Cree grupos anidados para subsecciones
Nombre los grupos de forma descriptiva

4. Orden de los campos

Ordene los campos lógicamente (de general a específico, de obligatorios a opcionales)
Mantenga los campos condicionales cerca de sus campos principales
Agrupe tipos de campo similares cuando sea posible

Pruebas y validación

Antes de subir

Validar la estructura XML
- Compruebe que el XML esté bien formado
- Verifique que todos los espacios de nombres estén presentes
- Asegúrese de que todos los campos tengan declaraciones bind correspondientes
Pruebe en Kobo Toolbox (Requerido)
- Construya/pruebe encuestas en Kobo Toolbox primero
- Verifique que toda la lógica condicional funcione correctamente
- Pruebe con varios datos de entrada
Revisar nombres de campos
- Asegure una convención de nombres consistente
- Verifique errores tipográficos en las rutas nodeset
- Verifique que las rutas bind coincidan con las rutas ref de entrada
Probar lógica condicional
- Pruebe todas las condiciones relevantes/obligatorias
- Verifique que los campos calculados funcionen correctamente
- Compruebe que los valores precargados se llenen
Comprobar tamaño de archivo
- Asegúrese de que el archivo esté por debajo de 10 MB
- Optimice si es necesario

Después de subir

Probar el flujo de la encuesta
- Complete una respuesta de prueba de la encuesta
- Verifique que todos los campos aparezcan/desaparezcan correctamente
- Compruebe los mensajes de validación
Verificar almacenamiento de datos
- Envíe una respuesta de prueba
- Compruebe que los datos se almacenen correctamente
- Verifique que los valores de selección múltiple se guarden correctamente
Probar consultas
- Pruebe búsquedas avanzadas con campos de la encuesta
- Verifique que las consultas de fecha funcionen correctamente
- Compruebe el filtrado de campos de selección

Solución de problemas

Errores comunes

1. "Solo se permite archivo xml"

Causa: El archivo no se reconoce como XML
Solución: Asegúrese de que el archivo tenga .xml extensión y el tipo MIME correcto (text/xml)

2. "Se debe proporcionar el archivo de la encuesta"

Causa: No se cargó ningún archivo
Solución: Asegúrese de que el input de archivo tenga un archivo válido seleccionado

3. "El tamaño del archivo excede el límite"

Causa: El archivo es mayor de 10 MB
Solución: Reduzca el tamaño del archivo eliminando campos no utilizados, optimizando el contenido de texto o dividiéndolo en varias encuestas

4. Los campos de la encuesta no aparecen en la búsqueda

Causa: El tipo de campo puede no ser compatible o los metadatos no se han analizado correctamente
Solución: Verifique que el campo use un tipo compatible (string, int, date, select1, select)

5. Valores de selección múltiple que no se muestran correctamente

Causa: Se espera un arreglo cuando los valores son cadenas separadas por espacios
Solución: Divida la cadena separada por espacios al procesar: value.split(' ')

6. Campos de fecha que no se pueden consultar

Causa: Uso del tipo dateTime en lugar de date
Solución: Cambiar a type="date" en la declaración bind

Consejos de depuración

Descargar encuesta existente
- Use el botón "Descargar encuesta" para ver el XML de la encuesta actual
- Compare con su nueva encuesta para identificar diferencias
Comprobar metadatos de la encuesta
- Vea los metadatos de la encuesta en la configuración del proyecto
- Verifique que todos los campos estén listados con los tipos correctos
Probar de forma incremental
- Comience con una encuesta simple y agregue complejidad gradualmente
- Pruebe después de cada cambio importante
Revisar registros
- Compruebe los registros del servidor en busca de errores de análisis XML
- Busque errores específicos de campos o de espacios de nombres

Recursos adicionales

Kobo Toolbox: https://kobotoolbox.org (Herramienta recomendada para construir y probar encuestas)
Especificación ODK XForms: https://getodk.github.io/xforms-spec/
Documentación XForms: https://www.w3.org/TR/xforms/

Lista de verificación resumida

Al construir una encuesta, asegúrese de:

AnteriorEncuestas de recolección de datos SiguienteTipos de datos compatibles

Última actualización hace 1 mes

¿Te fue útil?

Buenas noches

hashtagGuía para la creación de encuestas en CareSuite

hashtagTipos de encuestas en CareSuite

hashtag1. Encuesta de ingreso

hashtag2. Encuesta demográfica

hashtag3. Encuesta de seguimiento

hashtag4. Encuestas adicionales

hashtagRequisitos de formato de la encuesta

hashtagFormato de archivo

hashtagRequisitos de estructura XML

hashtagEspacios de nombres requeridos

hashtagTipos de datos compatibles

hashtag✅ Tipos totalmente compatibles

hashtag❌ Tipos no compatibles

hashtagMejores prácticas

hashtag1. Nomenclatura de campos

hashtag2. Organización de campos con grupos

hashtag3. Use itext para todo el contenido de texto

hashtag4. Lógica condicional (atributos relevant)

hashtag5. Campos obligatorios

hashtag6. Validación y restricciones

hashtag7. Campos calculados

hashtag8. Valores precargados

hashtag9. Manejo de fechas

hashtag10. Manejo de datos incompletos

hashtagAnti-patrones comunes y cosas a evitar

hashtag1. ❌ Uso de tipos de datos no compatibles

hashtag2. ❌ Nomenclatura de campos inconsistente

hashtag3. ❌ Texto en línea en lugar de itext

hashtag4. ❌ Espacios de nombres XML faltantes o incorrectos

hashtag5. ❌ Lógica condicional demasiado compleja

hashtagLos campos definidos en el cuerpo sin las correspondientes

hashtagEsperar que los valores de selección múltiple se almacenen como matrices cuando en realidad son cadenas separadas por espacios.

hashtagLas encuestas que excedan los 10 MB serán rechazadas durante la carga.

hashtagLos campos críticos (números de teléfono, correos electrónicos, etc.) sin validación pueden conducir a mala calidad de datos.

hashtagUsar

hashtagNo proporcionar opciones para la recopilación de datos incompleta dificulta el seguimiento de por qué las encuestas están incompletas.

hashtagUsar las etiquetas de opción como valores dificulta el análisis de datos y es propenso a errores.

hashtagLas estructuras de campos planas hacen que las encuestas sean más difíciles de navegar y comprender.

hashtag14. ❌ Falta el ID de instancia en Meta

hashtagConvenciones de nomenclatura de campos

hashtagPatrones de nomenclatura recomendados

hashtagEjemplos de encuestas en producción

hashtagDirectrices de estructura de la encuesta

hashtag1. Flujo lógico

hashtag2. Campos obligatorios vs opcionales

hashtag3. Organización de grupos

hashtag4. Orden de los campos

hashtagPruebas y validación

hashtagAntes de subir

hashtagDespués de subir

hashtagSolución de problemas

hashtagErrores comunes

hashtagConsejos de depuración

hashtagRecursos adicionales

hashtagLista de verificación resumida

Guía para la creación de encuestas en CareSuite

Tipos de encuestas en CareSuite

1. Encuesta de ingreso

2. Encuesta demográfica

3. Encuesta de seguimiento

4. Encuestas adicionales

Requisitos de formato de la encuesta

Formato de archivo

Requisitos de estructura XML

Espacios de nombres requeridos

Tipos de datos compatibles

✅ Tipos totalmente compatibles

❌ Tipos no compatibles

Mejores prácticas

1. Nomenclatura de campos

2. Organización de campos con grupos

3. Use itext para todo el contenido de texto

4. Lógica condicional (atributos relevant)

5. Campos obligatorios

6. Validación y restricciones

7. Campos calculados

8. Valores precargados

9. Manejo de fechas

10. Manejo de datos incompletos

Anti-patrones comunes y cosas a evitar

1. ❌ Uso de tipos de datos no compatibles

2. ❌ Nomenclatura de campos inconsistente

3. ❌ Texto en línea en lugar de itext

4. ❌ Espacios de nombres XML faltantes o incorrectos

5. ❌ Lógica condicional demasiado compleja

Los campos definidos en el cuerpo sin las correspondientes

Esperar que los valores de selección múltiple se almacenen como matrices cuando en realidad son cadenas separadas por espacios.

Las encuestas que excedan los 10 MB serán rechazadas durante la carga.

Los campos críticos (números de teléfono, correos electrónicos, etc.) sin validación pueden conducir a mala calidad de datos.

Usar

No proporcionar opciones para la recopilación de datos incompleta dificulta el seguimiento de por qué las encuestas están incompletas.

Usar las etiquetas de opción como valores dificulta el análisis de datos y es propenso a errores.

Las estructuras de campos planas hacen que las encuestas sean más difíciles de navegar y comprender.

14. ❌ Falta el ID de instancia en Meta

Convenciones de nomenclatura de campos

Patrones de nomenclatura recomendados

Ejemplos de encuestas en producción

Directrices de estructura de la encuesta

1. Flujo lógico

2. Campos obligatorios vs opcionales

3. Organización de grupos

4. Orden de los campos

Pruebas y validación

Antes de subir

Después de subir

Solución de problemas

Errores comunes

Consejos de depuración

Recursos adicionales

Lista de verificación resumida