Formularios

Cuando los campos estándar de Zauru no alcanzan para registrar todo lo que su negocio necesita, un formulario personalizado es la solución: fichas clínicas para pacientes, seguimiento de garantías o instrumentos de control propios de su empresa. Los formularios le permiten capturar esa información adicional directamente sobre los documentos del sistema, con los campos y grupos que usted diseñe.

Nuevo Formulario

Los pasos para crear un nuevo Formularios son:

Ir a “Configuraciones”.
Seleccionar “Formularios”.
Seleccionar “Nuevo Formulario”

Formularios

A continuación, se detallan los pasos para crear un nuevo formulario, destacando los campos esenciales a completar:

Nuevo formulario

Variables de impresión editables: En la mayoría de los casos, esta opción permanecerá desmarcada, siendo seleccionada únicamente cuando sea necesario asignar un nombre a la variable generada al crear un campo (Paso No. 4).
Tipo de Documento: Indique el módulo para el cual se va a crear el formulario. Es posible generar formularios para todos los módulos disponibles en Zauru.
Nombre del Formulario: Complete el nombre del formulario.
Descripción (Opcional): Ingrese una descripción del formulario (opcional).
Campos del Formulario:

4.1 Nombre del Campo: Defina el nombre del campo tal como aparecerá en el formulario.

4.2 Tipo de Campo: Seleccione el tipo de campo entre las opciones disponibles, que incluyen texto, número, correo electrónico, nacionalidades, tablas y filas con columnas fijas, entre otros.

4.3 Obligatorio: Marque esta opción para hacer obligatorio el llenado del campo.

4.4 Opciones: Habilitado según el Tipo de Campo seleccionado.

4.5 Predefinido: Permita la inclusión de un texto que se mostrará automáticamente como predeterminado en el formulario.

4.6 Pista: Proporcione información adicional o ayuda que aparecerá como una pista en el campo del formulario.

4.7 Grupo: Es factible crear grupos con el propósito de organizar la información de manera estructurada..

4.8 .+.: Posibilita la adición de filas adicionales al formulario.

4.9 Insertar en Posición: Permite la inserción de filas en la siguiente posición o en una ubicación específica.

4.10 Crear Formulario: Presione este botón para finalizar y crear el formulario.

Versiones de Formularios

Cuando modifica un formulario que ya está en uso, las versiones le dan tranquilidad: si un cambio no funciona como esperaba, puede volver atrás con facilidad. Zauru maneja un sistema de versiones para formularios. Cada vez que edita un formulario existente, se crea una nueva versión del mismo, manteniendo el historial completo de cambios. Esto permite:

Mantener un historial de todas las modificaciones realizadas a un formulario.
Restaurar una versión anterior del formulario si es necesario.
Comparar cambios entre versiones.

Ver Historial de Versiones

Para ver el historial de versiones de un formulario:

Ir a "Configuraciones".
Seleccionar "Formularios".
En el listado, seleccionar "Versiones" en el formulario deseado.

Versiones de formulario

Aparecerá un listado con todas las versiones del formulario, mostrando el número de versión, la fecha de creación y el usuario que la creó. Desde aquí usted puede:

Ver una versión específica: Haga click en "Ver" para ver el detalle de esa versión.
Restaurar una versión: Haga click en "Hacer versión actual" para crear una nueva versión basada en la versión seleccionada, restaurando efectivamente esa configuración.

Duplicar un Formulario

Zauru le permite duplicar un formulario existente para crear uno nuevo basado en él sin afectar el original. La forma de duplicar es:

Ir a "Configuraciones".
Seleccionar "Formularios".
En el listado, seleccionar "Duplicar" en el formulario deseado.

Zauru creará un nuevo formulario con un ZID diferente, permitiéndole modificarlo independientemente del original.

Vista Previa del Formulario

Zauru le permite previsualizar cómo se verá un formulario antes de usarlo. Esta funcionalidad es útil para verificar que la disposición de los campos y grupos es la correcta.

Para previsualizar un formulario:

Ir a "Configuraciones".
Seleccionar "Formularios".
En el listado, seleccionar "Vista Previa" en el formulario deseado.

La vista previa mostrará el formulario tal como lo verán los usuarios, con todos los campos, grupos, validaciones y valores predeterminados configurados.

Grupos en Formularios

Los formularios pueden tener grupos que organizan los campos en secciones lógicas. Los grupos pueden ser:

Grupos estáticos: Agrupan campos relacionados visualmente.
Grupos dinámicos: Permiten agrupar campos que se repiten según una variable. Por ejemplo, un grupo "Dirección" que contenga los campos "Dirección", "Ciudad" y "Código Postal", y que se repita si el formulario tiene una variable de grupo dinámico.

Su formulario está listo para usarse. Puede previsualizarlo, duplicarlo o seguir ajustándolo con la seguridad de que el historial de versiones guarda cada cambio; cuando esté conforme, quedará disponible para llenarse desde los documentos asociados.

API (llamadas desde sistemas externos)

Obtener listado de formularios

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/forms.json

Esto devolverá un JSON similar a este:

[]

Obtener detalle de un formulario

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/forms/1.json

Esto devolverá un JSON similar a este:

{}

Crear formulario

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "settings_form": {
      "name": "Ficha de Cliente",
      "document_type": "payee",
      "description": "Formulario para capturar datos adicionales del cliente",
      "active": true,
      "editable_print_var_names": false,
      "form_fields_attributes": [
        {
          "name": "Nombre Completo",
          "field_type": "text",
          "required": true,
          "position": 1
        }
      ]
    }
  }' \
  https://app.zauru.com/settings/forms.json

Esto devolverá un JSON similar a este:

{
  "errors": "[\"Form fields print var name no puede estar en blanco\"]"
}

Ver versiones de un formulario

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/forms/1/versions.json

Duplicar formulario

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  https://app.zauru.com/settings/forms/1/duplicate.json

Esto devolverá un JSON similar a este:

{
  "errors": []
}

Restaurar versión de un formulario

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  https://app.zauru.com/settings/forms/1/make_it_current_version.json

Esto devolverá un JSON similar a este:

{
  "errors": []
}

Eliminar formulario

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X DELETE \
  https://app.zauru.com/settings/forms/1.json

En caso de exito, retorna un codigo HTTP 204 No Content (sin cuerpo).

API de Envíos de Formularios (Form Submissions)

Obtener listado de envíos de un formulario

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/forms/form_submissions.json?f=1

Esto devolverá un JSON similar a este:

[
  {}
]

Obtener detalle de un envío de formulario

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/forms/form_submissions/1.json

Esto devolverá un JSON similar a este:

{}

Crear envío de formulario

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "settings_form_submission": {
      "form_id": "1",
      "document_type": "payee",
      "document_id": "1",
      "form_submission_values_attributes": [
        {
          "form_field_id": "1",
          "value": "valor del campo",
          "groups_path": "[1]"
        }
      ]
    }
  }' \
  https://app.zauru.com/settings/forms/form_submissions.json

Esto devolverá un JSON similar a este:

{}

Anular envío de formulario

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X DELETE \
  https://app.zauru.com/settings/forms/form_submissions/1.json

En caso de exito, retorna un codigo HTTP 204 No Content (sin cuerpo).

Duplicar envío de formulario

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  https://app.zauru.com/settings/forms/form_submissions/1/duplicate.json

Esto devolverá un JSON similar a este:

{
  "errors": []
}

Restaurar versión de un envío de formulario

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  https://app.zauru.com/settings/forms/form_submissions/1/make_it_current_version.json

Esto devolverá un JSON similar a este:

{
  "errors": []
}

Ver versiones de un envío de formulario

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/settings/forms/form_submissions/1/versions.json

Nuevo Formulario​

Versiones de Formularios​

Ver Historial de Versiones​

Duplicar un Formulario​

Vista Previa del Formulario​

Grupos en Formularios​

API (llamadas desde sistemas externos)​

Obtener listado de formularios​

Obtener detalle de un formulario​

Crear formulario​

Ver versiones de un formulario​

Duplicar formulario​

Restaurar versión de un formulario​

Eliminar formulario​

API de Envíos de Formularios (Form Submissions)​

Obtener listado de envíos de un formulario​

Obtener detalle de un envío de formulario​

Crear envío de formulario​

Anular envío de formulario​

Duplicar envío de formulario​

Restaurar versión de un envío de formulario​

Ver versiones de un envío de formulario​

Nuevo Formulario

Versiones de Formularios

Ver Historial de Versiones

Duplicar un Formulario

Vista Previa del Formulario

Grupos en Formularios

API (llamadas desde sistemas externos)

Obtener listado de formularios

Obtener detalle de un formulario

Crear formulario

Ver versiones de un formulario

Duplicar formulario

Restaurar versión de un formulario

Eliminar formulario

API de Envíos de Formularios (Form Submissions)

Obtener listado de envíos de un formulario

Obtener detalle de un envío de formulario

Crear envío de formulario

Anular envío de formulario

Duplicar envío de formulario

Restaurar versión de un envío de formulario

Ver versiones de un envío de formulario