Formularios
Alta de Campos del Formulario
Desde el listado de formularios, presionando el ícono 
Agregar Campos correspondiente al Formulario cuyos Campos se van a definir, se podrá agregar nuevos campos al mismo.
Si todavía el Formulario no tiene ningún campo cargado, el sistema iWF - Worklfow presentará la siguiente pantalla:
En los casos en que el Formulario que se está dando de alta sea similar a otro ya existente, iWF - Worklfow en la parte superior de la pantalla permite cargar sus campos, para luego sobre esa base poder hacer los ajustes.
Una vez seleccionado el Formulario base a clonar, presionando el botón 
, los campos de dicho Formulario base quedan cargados en el nuevo, pudiendo el Administrador agregar, eliminar o modificar alguno según el procedimiento habitual.
En el caso general de que se definan los campos del Formulario desde cero, se empieza con la carga del primer campo directamente desde la parte inferior de la pantalla.
Durante la carga de los campos de un Formulario, el usuario Administrador trabajará en una pantalla similar a la siguiente, donde en la parte superior se visualizan los campos ya cargados, y a continuación el área de carga del siguiente campo a cargar.
En un campo ya cargado, a la derecha se presentan las funcionalidades utilizables:
-
Editar Campo - permite editar y eventualmente realizar modificaciones en la definición del Campo.
-
Clonar Campo - permite definir un Campo en base a otro ya existente, pudiendo luego eventualmente editar el nuevo Campo y realizar los ajustes requeridos.
-
Borrar Campo - permite eliminar un Campo existente.
Ingreso de Campos del Formulario
Para facilitar la creación de campos, el sistema autocompleta la longitud y el tipo recomendado luego de indicar el campo vincular.
Tambien brinda una ayuda sobre que se debe completar en cada campo.
Como se ve en el ejemplo anterior, al ingresar un campo Vincular a "Calendario", autocompleta el Tipo de campo, la Longitud recomendada y la lista de valores.
-
Secuencia - indica el ordenamiento relativo del Campo en el Formulario; se recomienda en el alta numerar los campos de 10 en 10, para facilitar el eventual intercalado de nuevos campos sin necesidad de renumerar los existentes.
-
Nombre del Campo - el sistema iWF - Worklfow acepta nombrar a los campos con caracteres alfanuméricos, sin dejar espacio entre los mismos, y en minúscula. Los guiones medio y bajo se pueden emplear como separadores de palabra.
-
Tipo de Campo - el tipo de campo puede ser:
* Acción - se utiliza para indicarle al sistema que se inicia una nueva parte en un Formulario Multiparte.
* Numérico - se define para los Campos a ser completados con un valor numérico, ya sea entero o decimal.
* Fecha(yyyy-mm-dd) - es un campo tipo calendario, con formato año-mes-día:
* Fecha/Hora(yyyy-mm-dd hh:mm:ss) - es un campo tipo calendario, más información horaria:
* Caracteres - es un campo texto de extensión acotada:
o
* Texto extendido - es un campo texto de mayor extensión, aplicable para descripciones, observaciones o comentarios:
Texto enriquecido: Es similar al tipo "Texto extendido" con la diferencia que permite agregar formato al texto. Estilo de fuente, tamaño, color, subrayado, etc
Los campos Caracter y Texto extendido pueden tener asociado una tabla con opciones predefinidas para facilitarle al usuario el ingreso de datos y evitar tipeos erróneos:
Para asociar una Tabla vinculada a un campo Caracter o Texto extendido se debe incorporar a la definición del campo, en la opción Lista de Valores , una instrucción como la siguiente:
i:a0usr_nuke_archive_doc_ayuda:id:cod:des
Dicha instrucción está definida en 5 partes, separadas entre sí por el caracter ":", donde:
* "i" - indica búsqueda por palabras claves
* referencia a la Tabla en la cual se ingresa previamente el texto predefinido
* referencia a los campos de la Tabla a tener en cuenta; en general conviene definir campos id:cod:des para los correspondientes al Código y Descripción de los elementos de la Tabla
-
Longitud - a cada tipo de campo le corresponde una longitud:
* Texto extendido: 255
* Fecha: 12
* Campos con valores asociados con id de usuarios: Numérico (11,0)
* Campos tipo Link, Acción o Check Box: Caracter de 40
* Campos asociados a Lista de Opciones Menú o Radio Button: Caracter de 2,0
* Campos LOV, si se trata de tablas creadas en el mismo sistema: Numérico (11,0), si se trata de tablas externas: Caracter de 40
-
Etiqueta - es la leyenda con que se identifica el campo en la presentación del Formulario:
-
Ayuda contextual - permite definir una ayuda o aclaración, que puede definir el usuario para tomar la decisión correcta sobre lo que tiene que cargar, por ejemplo:
En el formulario, si un campo tiene ayuda contextual aparece indicado con el ícono 
:
Haciendo clic en el ícono , aparece desplegada en pantalla la ayuda contextual previamente cargada en la definición del formulario:
-
Condición NOTNULL - es un campo tipo Check Box que, si se lo marca, determina la obligatoriedad de ingresar un valor
-
Vincular a - en este campo se determina la forma de presentar la selección de valores:
* Calendario - iWF - Worklfow presenta a la derecha de este Campo el ícono calendario para seleccionar la fecha a ingresar en el registro (Dato de 12,0)
* Calendario con Hora - iWF - Worklfow presenta a la derecha de este Campo el ícono calendario para seleccionar la fecha, luego hora y minutos a ingresar en el registro (Dato de 20,0)
* Lista de usuarios del sistema - iWF - Worklfow muestra la lista de todos los usuarios del sistema. Al seleccionar un usuario, el sistema guardará el identificador de éste en el campo del Formulario (Dato numérico de 11,0)
* Lista de opciones list menu - permite al usuario definir opciones que se muestran en una lista desplegable. iWF - Worklfow toma los datos del campo lista y considera como opciones diferentes a los string separados por el caracter "." (Dato numérico de 1,0)
En ocasiones se recomienda que un campo de este tipo tenga como primera opción, por ejemplo -Selección-, o -Sin Datos-, o -S/D-, que le permita al Usuario explicitar la alternativa de que no exista selección, tanto para el alta como para la posterior edición y búsqueda.
* Lista de opciones rad - funciona en forma similar a la Lista de Valores, pero en esta alternativa iWF - Worklfow presenta radios de opción (Dato numérico de 1,0)
Los campos Lista de opciones list menu y Lista de opciones rad no permiten modificación del orden en que se crearon originalmente sin borrar la tabla. Es por ello que es necesario definir el mismo previamente.
* Bifurcación - iWF - Worklfow presenta al usuario una lista de las partes a las que puede dirigir el control del Formulario, para que continúen completando los diferentes usuarios
* Comunicar a un usuario - iWF - Worklfow permite que un usuario que está utilizando el Formulario pueda tomar la decisión, al momento de completar una parte del mismo, de dejar que la comunicación se le envíe a los usuarios preestablecidos en el diseño del formulario, o en su defecto ma otro usuario (Dato numérico de 11,0)
* Link - este tipo de campo permite la posibilidad de ingresar enlaces a otros documentos, planes, reportes y formularios, indicando el registro (Dato varchar de 40). Para settear que por defecto sea un formulario se debe ingresar "Form" en la lista de valores, para los documentos de debe ingresar "Docu" y para reportes "Repo". Además, para establecer por defecto un formulario particular se debe ingresar "Form:id_form" en la lista de valores, donde id_form es el id del formulario.
* Lista de Valores sobre Tabla (LOV) - induce al Usuario a seleccionar un registro de una Tabla definida como fuente de selección de opciones. Esa Tabla puede ser definida como otro formulario y utilizarlo para dar las altas, bajas y modificar sus registros u opciones. (Dato numérico de 11,0). Se facilita la búsqueda y acceso, permitiendo la estandarización de los valores cargados en el campo.
Un ejemplo de campo LOV sería la selección de un Tipo de Instalación, a partir de una tabla predefinida:
La estructura del campo será del tipo:
La primera parte corresponde al nombre de la Tabla: a0usr_dis_tm_tipos_instalacion
La segunda parte corresponde al valor que se guarda: id del registro (en general)
La tercera parte corresponde a los valores de los campos a mostrar para la selección: cod y des (en este ejemplo)
* Lista de Valores sobre Tabla (Largo LOL) - se aplica cuando se necesita ofrecer más campos de búsqueda para seleccionar un determinado registro, ampliando las opciones. Desde el punto de vista del Usuario, le permite seleccionar un registro de una Tabla definida, que además le muestra valores adicionales como fuente de referencia en la búsqueda. (Dato numérico de 11,0).
Un ejemplo de campo LOL podría ser la selección de modelos de equipos, agregando en la estructura un campo adicional de visualización (1:info), y a partir del símbolo "#" el resto de los campos que se incluyen en la búsqueda pero que no se muestran (lov_equipo y tipo)
La estructura en este ejemplo quedará definida así:
nuke_users:uid:uname:name:4:email:name:name:email
* Lista de Valores sobre Tabla (Relacionado LOVR) - este tipo de campo permite al usuario seleccionar un determinado registro de una Tabla, cuando dicha Tabla está relacionada con otra. (Dato numérico de 11,0). Así se logra acotar la búsqueda a los campos asociados.
Un ejemplo de campo LOVR sería el caso de tener definida una Tabla de Sectores y otra Tabla de Líneas de Producción; al estar cada Línea asociada a un Sector, si primero se selecciona éste, el campo Línea puede preseleccionar y presentar sólo aquellos correspondientes al Sector elegido:
La estructura de los campos será del tipo:
Hasta el caracter "#" la estructura es similar a un campo LOL; luego se debe ingresar el nombre del campo correspondiente a la tabla a comparar (en este ejemplo, sector), y el nombre del campo (zona_fisica) correspondiente a la segunda tabla (tm_equipos)
Así se logra que sólo se muestren las Líneas que pertenezcan al Sector seleccionado en el campo sector.
* Lista de Valores Inducción sobre texto (Relacionado LOVI) - este tipo de campo permite ingresar desde una tabla asociada, la cantidad de valores que se desee. No esta limitado a elegir un solo registro. El tipo de campo es "Texto extendido" y en Lista de valores se especifica la tabla y campos correspondientes.
Nota: Si se desea guardar un solo campo en el texto, este campo debe repetirse en la definición de la lista de valores.
A continuación, un ejemplo de la estructura de dicho campo:
Primero se ingresa la tabla, luego los campos.
El segundo y el tercero serán los campos que sólo se visualizarán, mientras que los últimos dos quedarán guardados en el campo texto.
Para desplegar la lista de valores basta con dar clic en 
y mostrara la siguiente pantalla:
* Imagen - iWF - Worklfow permite definir un campo tipo imagen seteando;
En el formulario aparecerá el ícono 
, que permite seleccionar y adjuntar una imagen guardada previamente en una carpeta;
* CheckBox (S/N) - iWF - Worklfow permite ingresar un tilde en este tipo de campo, dándolo por válido. Puede presentar opciones múltiples, en forma semejante a una Lista de opciones list menu (Dato numérico de 1,0).
* Multi Registro - permite al usuario generar registros de otro formulario, que quedarán asociados al registro del formulario actual. El registro que contiene el Multiregistro será el padre, y el generado en éste mismo será el hijo (Dato numérico de 1200).
Un ejemplo pueden ser las Acciones generadas a partir de un Acta de Reunión, donde el Multiregistro se define en el formulario padre (Acta), haciendo referencia al ID del formulario hijo. Los campos del formulario hijo (Acciones) se colocan separados por el caracter "|":
-
Visible - si se quita la tilde a este atributo, iWF - Worklfow seguirá guardando toda la información correspondiente al campo, pero éste dejará de estar visible para el Usuario.
-
Lista de Valores - cuando un campo puede adoptar un valor entre varias opciones posibles, como sucede en los casos de Vincular a Lista de opciones list menu, Lista de opciones rad o CheckBox múltiple, aquí es donde el Administrador debe cargar todas las opciones posibles a visualizar, separadas entre sí por el caracter ":". Internamente, iWF - Worklfow asumirá 0 como identificador de la primera opción, 1 para la segunda, etc.
En caso de Vincular a Lista de Valores sobre Tabla (LOV, LOL, LOVR), en este campo el Administrador debe identificar la Tabla de referencia.
-
Condición Edición - en caso de que este atributo esté tildado, iWF - Worklfow presentará al campo como filtro o parámetro de búsqueda de registros.
-
Campos Formulario Multiparte - cuando el Formulario diseñado es de tipo Multiparte, se debe definir al comienzo de cada parte un campo tipo Acción (Caracter de 40), y deben ser completados los siguientes datos:
* Nro.de Parte - se carga en el campo tipo Acción de cada Parte, y en todos los demás campos del Formulario para darles pertenencia a dicha Parte.
* Gr.Funcional Ingresa - indica el Grupo Funcional que deben poseer los Usuarios para acceder a la Parte.
* Gr.Funcional Comunicado - cada vez que un Usuario complete una parte del Formulario, iWF - Worklfow le puede enviar automáticamente un mail a los usuarios que posean el Grupo Funcional cargado en este campo.
En el Formulario se puede definir un campo vinculado a Comunicar a un Usuario, de tal forma que el operador de la Parte pueda definir de entre todos los usuarios que poseen el Grupo Funcional Comunicado a quién de ellos se le enviará la comunicación.
* Partes Bloqueadas - en este campo se indican las Partes del Formulario que quedarán bloqueadas una vez guardada cada una de las Partes.
Como ejemplo, en un Formulario de 3 Partes, en el campo Partes Bloqueadas correspondiente a cada uno de los 3 tipos de campo Acción se debe cargar:
En el ejemplo, esto se interpreta como que luego de cerrar la Parte 1 la única parte habilitada para continuar es la Parte 2 (las Partes 1 y 3 quedan bloqueadas), luego de cerrar la Parte 2 la parte habilitada es la Parte 3 (Partes 1 y 2 bloqueadas), y luego de cerrar la última parte el Formulario queda cerrado (con todas sus Partes bloqueadas).
Luego de ingresar cada Campos de un Formulario, se presiona el botón 
, y el sistema le indica al Administrador que el Campo ha sido guardado:
