Agregar Formulario

Para agregar un formulario, haz clic en el botón “Agregar Formulario”, ubicado en la parte superior derecha del módulo Formularios Dinámicos.

Sagicc te llevará al formulario de creación de formularios dinámicos, en donde deberás digitar la siguiente información requerida:

• Nombre: Nombre del formulario.

• Descripción: Descripción u objetivo del formulario.

• Configuración Adicional:

  • Requerir observaciones: Especifica si el formulario deberá marcar el campo Observaciones como requerido al guardar una gestión.

  • Requerir próxima gestión: Especifica si el formulario deberá marcar el campo Próxima Gestión como requerido al guardar una gestión.

Luego de digitar la información del formulario, podrás comenzar a agregar campos al mismo. Al hacer clic en “Agregar Campo”, se mostrará un formulario adicional para configurar el nuevo campo:

• Etiqueta: Es la etiqueta que verá los usuarios verán asociada al campo. Por ejemplo, Fecha de Cita.

• Descripción: Es la descripción del campo. Por ejemplo, Fecha de la cita del cliente.

• Tipo de Campo: Es el tipo de campo que se mostrará en el formulario. Define el aspecto visual, el contenido y las reglas de validación del mismo. Por ejemplo, Campo para seleccionar fechas. Encuentra en la próxima sección la descripción detallada de cada uno de los tipos de campo disponibles y su configuración.

• Valor por Defecto: Es el valor que contendrá el campo por defecto al visualizar el formulario. Si no es editado al momento de la gestión, este valor será guardado como parte de la información de la gestión.

• Campo Requerido: Indica si el campo debe marcarse como requerido/obligatorio dentro del formulario. Los usuarios no podrán guardar una gestión sin digitar los campos requeridos del formulario.

Luego de agregar todos los campos necesarios para el formulario dinámico, verifica que la información sea correcta y que se encuentren en el orden correcto. Puedes reordenar los campos arrastrando y soltando cada uno en la posición correcta. Además, puedes quitar un campo específico haciendo clic en el botón “Eliminar”. 

Verifica la información ingresada tanto para el formulario como para los campos y haz clic en el botón “Guardar” para agregar el nuevo formulario dinámico. Si el proceso fue realizado correctamente, Sagicc te llevará nuevamente al módulo de Formularios Dinámicos, donde podrás ver en el listado el formulario recién agregado.

Tipos de Campo Dinámicos

A continuación, se detallan los diferentes tipos de campos dinámicos disponibles para los formularios dinámicos de gestión en Sagicc:

Tipo de Campo	Descripción	Vista Previa
Campo de texto corto	Campo que permite digitar textos cortos, como nombres o direcciones.
Campo de texto largo	Campo que permite digitar textos largos, como comentarios u observaciones.
Campo para seleccionar fechas	Campo que permite seleccionar una fecha a través de un selector de fechas.
Campo para seleccionar horas	Campo que permite seleccionar una hora a través de un selector de horas.
Campo para contraseñas	Campo que permite digitar una contraseña y ocultar su contenido.
Campo para correos electrónicos	Campo que permite digitar correos electrónicos. Incluye validaciones para correos electrónicos.
Campo para números	Campo que permite digitar valores numéricos.
Campo para seleccionar archivos	Campo que permite seleccionar y cargar archivos adjuntos.
Casillas para seleccionar una opción	Campo que permite seleccionar múltiples opciones entre varias casillas de opciones.
Casillas para seleccionar múltiples opciones	Campo que permite seleccionar una opción entre varias casillas de opciones.
Lista para seleccionar una opción	Lista que permite seleccionar una opción entre múltiples opciones.
Lista para seleccionar múltiples opciones	Lista que permite seleccionar múltiples opciones.
Lista enlazada para seleccionar opciones	Lista enlazada con múltiples subniveles que permite seleccionar una opción.
Lista para seleccionar opciones (ENDPOINT o API REST)	Lista que permite seleccionar una o múltiples opciones. Las opciones a seleccionar serán cargadas consumiendo una API REST previamente configurada en un servidor externo.
Campo Reutilizable	Lista que permite utilizar un campo reutilizable previamente configurado en el módulo Listas Reutilizables.

Lista para seleccionar una o múltiples opciones

Al agregar un campo de tipo Lista para seleccionar una opción o de tipo Lista para seleccionar múltiples opciones, se mostrará en el formulario una sección para agregar cada una de las opciones que tendrá el campo.

• Selecciona "Opciones" si quieres ingresar manualmente las opciones que contendrá la lista. O selecciona "Lista Reutilizable" si deseas utilizar una lista previamente configurada (a través del módulo Listas Reutilizable) para poblar el campo.

• Haz clic en el ícono “Agregar Opción”  para agregar una nueva opción al campo.

• Haz clic en el ícono “Quitar Opción”  ⛔ para quitar una de las opciones del campo.

• Habilita la casilla “Agregar opción ‘Otros’” para que el campo muestre automáticamente la opción “Otros” y los usuarios puedan digitar una opción alternativa a las configuradas.

• Las opciones del campo se mostrarán en el orden ingresado por defecto, pero puedes seleccionar Ordenar Alfabéticamente para mostrarlas en ese orden.

Lista enlazada para seleccionar opciones

Al agregar un campo de tipo Lista enlazada para seleccionar opciones se mostrará en el formulario una sección para agregar cada una de las opciones que tendrá el campo. En una lista enlazada, cada una de las opciones puede tener subniveles de opciones y estas, a su vez, tener subniveles. Esta estructura posibilita la creación de múltiples niveles y subniveles de opciones dentro de la lista enlazada.

• Selecciona "Opciones" si quieres ingresar manualmente las opciones que contendrá la lista. O selecciona "Lista Reutilizable" si deseas utilizar una lista previamente configurada (a través del módulo Listas Reutilizable) para poblar el campo.

• Haz clic en el ícono “Agregar Opción”   para agregar una nueva opción al campo.

• Haz clic en el ícono “Agregar Subnivel”  para agregar un nuevo subnivel de opciones.

• Haz clic en “Quitar Subnivel”  para quitar un subnivel específico de una opción.

• Haz clic en el ícono “Quitar Opción” ⛔  para quitar una de las opciones de alguno de los niveles del campo.

• Las opciones del campo se mostrarán en el orden ingresado por defecto, pero puedes seleccionar Ordenar Alfabéticamente para mostrarlas en ese orden.

• Marca la opción “Requerido” si requieres que este sea un campo obligatorio o requerido dentro del formulario.

Lista para seleccionar opciones (ENDPOINT o API REST)

Al agregar un campo de tipo Lista para seleccionar opciones (ENDPOINT o API Rest) se mostrarán en el formulario los siguientes campos necesarios para especificar la configuración del campo:

• Método: Selecciona el método HTTP que se debe utilizar para consumir el API REST.

• URL/Endpoint: Especifica la dirección para acceder al método de la API REST del cual se consultarán las opciones de la lista.

• Headers (Encabezados de la Petición): Aquí debes escribir, en formato JSON, los encabezados que deben agregarse a la petición para consumir el webservice (en caso de ser requeridos). Por ejemplo, { "Authentication": "Bearer aej3fsh2fg4ds"}.

• Body (Cuerpo de la Petición): Escribe aquí, en formato JSON, el cuerpo que debe contener la petición para obtener las opciones de la lista (en caso de ser requeridos). Por ejemplo, {"country":"Colombia"}.

• Autenticación: Marca esta casilla y especifica el usuario y contraseña requeridos para autenticar la petición al API REST (en caso de ser requeridos).

• Valores: Aquí debes especificar la estructura que se utilizará para extraer de la respuesta de la API REST los valores asociados a cada una de las opciones de la lista. Estos valores son los que se almacenarán en la gestión al utilizar el formulario para gestionar un caso. La estructura debe seguir el formato JSONPath. Puedes utilizar herramientas como JSONPath Online Evaluator para definir esta estructura de manera precisa.

• Etiquetas: Aquí debes especificar la estructura que se utilizará para extraer de la respuesta de la API REST las etiquetas asociadas a cada una de las opciones de la lista. Las etiquetas son los textos que se mostrarán en el campo para que los usuarios las seleccionen, mientras que los valores corresponden a lo que se almacenará en la gestión. En algunos casos, puedes utilizar la misma información tanto para las etiquetas como para los valores. Por ejemplo, si deseas mostrar un listado de ciudades en el campo y almacenar los nombres, la etiqueta y el valor podrían ser ambos "Bogotá". Sin embargo, si necesitas almacenar un código asociado a un servicio, la etiqueta podría ser "Servicios Técnicos Profesionales" mientras que el valor podría ser "443452". La etiqueta será lo que visualicen los usuarios, mientras que el valor será lo que se guarde al generar una gestión.

Asignar Formulario a una Campaña

Una vez configurado un formulario dinámico, puedes asociarlo a una o más campañas para que los usuarios puedan gestionar los casos utilizando el nuevo formulario. Ingresa al módulo de Campañas, busca la campaña en la que deseas asignar el formulario, y haz clic en el botó “Editar”. En la pestaña Campaña, busca el nuevo formulario en el campo Formularios. Selecciónalo y haz clic en el botón ”Guardar”. A partir de ese momento, todos los casos de la campaña tendrán asignado el formulario dinámico de gestión.