Este es el manual para administradores de la extensión Forms.
La extensión crea y gestiona formularios para otras aplicaciones que utilizan los Legajos.
Puede generar formularios de autocompletado y formularios que almacenan datos.
Los formularios pueden contener marcadores de autocompletado y elementos de formulario.
Los marcadores de formulario servirán para volcar datos en estos. A la hora de imprimir un formulario, los marcadores son reemplazados por un valor. El formato del marcador debe ser del tipo {{ mustache }}.
Los elementos de formulario permiten al usuario ingresar datos. Esos datos deberán ser almacenados y puestos a disposición de la administración para su uso.
Los formularios de autocompletado sólo contienen etiquetas. No almacenan datos, ni se guarda registro de su uso.
En este sentido, los formularios de autocompletado, utilizan sólo el sistema de formularios maestros. Sirven como comprobantes de la realización de un acto administrativo.
Los formularios de que guardan datos o, simplemente, formularios, contienen elementos de formularios que permiten al usuario ingresar datos. Estos formularios, se almacenan, tienen un estado, pueden o no ser reemplazados por otros, entre muchas otras posibilidades.
Los formularios maestros almacenan todas las configuraciones necesarias para construir un formulario. La más importante, es la plantilla html que servirá como diseño. También, configura el tipo de formulario, los elementos que contendrá, los estilos, entre otros.
Los Formularios Maestros contienen los datos necesarios para crear y gestionar los Formularios que serán entregados en la aplicación.
Un Formulario maestro es, en principio, una plantilla html. Dentro de dicha plantilla, se pueden escribir marcadores que, llegado el momento, serán remplazados por datos o elementos de formularios. Los marcadores se escriben con el nombre del campo a rellenar envuelto en doble llaves, por ejemplo: {{ fecha }}.
Cada aplicación controlante de un formulario define la lista de campos posibles. A su vez, existen otras funciones que ayudarán a mejorar la experiencia y la seguridad, como por ejemplo: la definición de tipo de formulario y los plugins.
Para crear un Formulario Maestro, lo primero que debemos hacer es definir su clave. La clave nos indica para qué aplicación se va a crear ese Formulario Maestro, y su uso dentro de la misma. A su vez, la aplicación podrá sugerir o forzar algunas configuraciones.
Una vez definida la clave, para agregar un Formulario Maestro debemos tener en cuenta tres bloques: Principal, Configuraciones y Plugins.
Elija un nombre significativo, tanto para el administrador, como para los usuarios.
El cuerpo del Formulario, el resultado final dependerá de la creatividad y del conocimiento que se tenga sobre html.
El Tipo de Formulario indica cómo el sistema tratará al mismo. Las opciones pueden ser:
Estático: el Formulario Maestro se utiliza para autocompletar datos. Algunos ejemplos pueden ser: un certificado, una plantilla o un acta donde se visualicen datos, resúmenes o estadísticas de una aplicación.
Único: el sistema almacenará un único Formulario por usuario, con todos los datos que éste haya completado.
Reemplazable: el sistema almacenará varios Formularios por usuario, con todos los datos que éste haya completado. Cada nuevo Formulario reemplazará al anterior. Se utiliza para tener un histórico de un mismo Formulario, por ejemplo, para una Ficha de Salud.
Una clase que represente un ícono. Actualmente el framework utiliza íconos de fontawesome.
Esto creará en el documento una etiqueta <style></style>.
Estos plugins permiten agregar funcionalidades. Algunas aplicaciones suelen sugerir opciones de plugins para sus formularios.
Se ejecuta justo antes de cargar el formulario.
Se ejecuta justo antes de que un usuario guarde un formulario.
Se ejecuta luego de que un usuario guarde un formulario.
Los Formularios Maestros pueden ser editados sin restricciones.
Un Formulario Maestro se puede eliminar siempre que no esté siendo utilizado.
Los Elementos de formulario se utilizan para ingresar y almacenar datos de los usuarios. Teniendo un Formulario Maestro, le podrá crear Elementos presionando en el ícono .
El número de orden se utiliza internamente a la hora de mostrar tablas con los datos de los usuarios.
El encabezado se utiliza a la hora de mostrar tablas con los datos de los usuarios.
El nombre con el que se insertará en el cuerpo del formulario.
El tipo de elemento que desea crear. Actualmente, las opciones son:
Este valor depende del tipo de elemento. Algunos valores posibles son:
Si el elemento es un Selector, aquí se guardan las opcioones separadas por una barra vertical |.
Si el elemento es un Boolean, es posible ingresar un selector css, que será visible u oculto dependiendo del valor del elemento.
Opcionalmente, puede obligar a que el usuario complete el valor del elemento.
En caso de que el valor del elemento sea requerido, aquí puede colocar un mensaje personalizado.
Los Elemento de formularios pueden ser editados sin restricciones.
Los Elementos de formulario se puede eliminar sin restricciones.