Formulario ECM

1. Vaya a Senior X Platform > senior X > BPM > Configuración > Formularios;
2. La primera pantalla presenta la lista de formularios ya registrados que se pueden editar y también el botón Agregar para crear uno nuevo;
3. Al agregar uno nuevo, complete el título del formulario, a Entidad en la base de datos y haga clic Agregue campo;
4. En la pestaña general, complete los campos a continuación. A medida que se configuran los campos, se presenta una vista previa en tiempo real de cómo se verá el formulario para los usuarios:
   • Etiqueta: informar la etiqueta que se mostrará en el formulario;
   • Descripción: permite incluir una nota que ayudará al usuario (opcional);
   • Tipo de campo: permite seleccionar las opciones que definirán el tipo de campo y los datos que se insertarán. Dependiendo del tipo elegido, se habilita otro campo donde se deben insertar los valores del campo;
   • Atributo en la base de datos: define un alias para el campo y cómo se escribirá internamente;
   • Tamaño del campo: define el espacio que ocupará el campo en la pantalla.

Vaya a Senior X Platform > senior X > BPM > Configuración > Formularios y haga clic en Agregue campo. Elegir la Tipo de campo (la lista de campos, el enlace y el archivo adjunto no admiten este tipo de configuración), seleccione la opción campo calculado que aparecerá al final de la pantalla e informará la expresión deseada. Para acceder al valor de un campo dentro de la expresión, use la notación PlaceHolder ${<nombre_del_campo>}. En el caso de un campo calculado de tipo Fecha, siempre es necesario informar y devolver un objeto de tipo Fecha.

Vaya a Senior X Platform > senior X > BPM > Configuración > Formularios, haga clic en Agregue campo, es en Tipo de campo Seleccionar opción Enlace e informar al URL de destino. Para pasar el valor de otros campos al enlace, utilice la notación PlaceHolder. Ejemplo: https://mysite.com.br?param1=${field_1}&param2=${field_2}.

Enlaces autenticados

Para acceder a un enlace autenticado, siga el estándar G5 para pasar la autenticación. Por lo general, es necesario utilizar un integrador, que reconocerá el mecanismo y manejará la autenticación para el modelo de sistema al que se hace referencia en el enlace. Las integraciones con HCM de G5 funcionan así, un ejemplo de un enlace válido es:

https://www2.senior.com.br/rubisenior/integration.htm?url=<url del informe>

En el ejemplo anterior, el archivo Integration.htm es responsable de esta tarea. Si no tiene un integrador, a continuación se muestra un fragmento de un código que leería los datos de autenticación:

if (ventana.nombre.indexOf("SENIOR_CREDENCIALES") != 0) { // Autenticación no encontrada; retorno; } var data = JSON.parse(window.name.substring(" SENIOR_CREDENCIALES ".longitud));

Dado que el objeto fecha tiene la siguiente estructura:

{ "simbólico": Objeto de token de Senior, "URL de servicios": url para servicios para personas mayores }

En el código anterior, al nombre de la ventana abierta se le pasa una cadena que contiene el prefijo SENIOR_CREDENTIALS, seguida de un objeto JSON codificado en cadena que contiene los datos de autenticación G7.

Vaya a Senior X Platform > senior X > BPM > Configuración > Formularios, haga clic enReglas de consistencia y luego enCrear una nueva regla. La opciónCuando define cuándo deben ejecutarse las reglas. Hay tres tiempos: Abrir formulario, Enviar formulario y La condición es verdadera.

Abrir el formulario

En este momento, se muestran dos campos: Acción y campos aplicados. En el campo Acción, puedes elegir entre cinco acciones: Habilitar, Deshabilitar, Monitor, Esconder, Hacer obligatorio.

• Habilitar: habilita un campo que está deshabilitado cuando se abre el formulario;
• Deshabilitar: deshabilita un campo que está habilitado cuando se abre el formulario. Esta opción no oculta el campo, solo lo bloquea para editarlo;
• Monitor: muestra un campo que antes estaba oculto cuando se abre el formulario;
• Esconder: oculta un campo que se mostraba previamente en la pantalla, cuando se abre el formulario. Esta acción hará que el campo no esté disponible para edición y visualización;
• Hacer obligatorio: alerta al usuario que el campo no puede estar vacío.

El campo Campos aplicados informa en qué campos se aplicará la acción (habilitar, deshabilitar, mostrar, ocultar y hacer obligatorio). Se puede ingresar más de un campo. El botón Añadir acción, se puede usar para crear una acción más, que se puede crear según sea necesario.

Enviar el formulario

Esta vez tiene 4 campos: Validar, Acción, campos aplicados y Mensaje (solo se muestra al seleccionar la acción Consistir).

En el campo Acción, solo queda la opción consistir. En el campo campos aplicados, informar a los campos que, al ser cambiados, harán la condición escrita en el campoValidar ser realizado. Ejemplo: si el valor del campoValidar let ${name} == '123' y el campo de nombre se informa en el campocampos aplicados, debe considerar la expresión "Al enviar el formulario, valide si el nombre es igual a 123", y luego ejecute la acción consistir campo de nombre.

la condición es verdadera

Esta vez tiene 3 campos:Validar,Acción y consisten en campos. El botónañadir acción permite agregar más de una acción.

En el campoValidar, introduzca la condición que se ejecutará cuando la condición sea verdadera. En el campoAcción, seleccione la acción que se realizará en el(los) campo(s) informado(s) encampos aplicados. En esta pantalla, el campoAcción tiene 6 opciones:

• Habilitar: habilita un campo que se deshabilita cada vez que la condición informada en el campoValidar es verdad;
• deshabilitar: deshabilita un campo que se habilita siempre que la condición informada en el campoValidar es verdad. Esta opción no oculta el campo, solo lo bloquea para editarlo;
• Monitor: muestra un campo que antes estaba oculto, siempre que la condición informada en el campoValidar es verdad;
• Esconder: oculta un campo que se mostró previamente en la pantalla, siempre que la condición informada en el campoValidar es verdad. Esta acción hará que el campo no esté disponible para edición y visualización;
• hacer obligatorio: alerta al usuario que el campo no puede estar vacío, siempre que la condición informada en el campoValidar es verdad;
• consistir: el campoMensaje aparecerá cuando seleccione esta opción. Siempre que la condición informada en el campoValidar es verdadero, el campo no será válido y el mensaje definido se mostrará al usuario.

Condiciones - Validar campo

Las condiciones presentadas siempre deben ser informadas en el campoValidar y debe estar escrito utilizando la sintaxis del lenguaje Javascript.

operadores de comparación

Operador	Descripción	Ejemplos que devuelven verdadero
Igual (==)	Devuelve verdadero si los operandos son iguales	${nombre} == 'Marcelo' ${nombre} == 'Ana' 'Marcelo' == ${nombre}
A diferencia de (!=)	Devuelve verdadero si los operandos son diferentes	${nombre} != ” ${nombre} != 'Ana' 'Marcelo' != ${nombre}
Estrictamente igual (===)	Devuelve verdadero si los operandos tienen el mismo valor y el mismo tipo (Entero, Texto, Fecha, etc.)	${nombre} === ${apellido} ${nombre} === ${nombre_madre} ${nombre} === ${nombre_del_padre}
Estrictamente diferente (!==)	Devuelve verdadero si los operandos tienen valores diferentes y/o tipos diferentes.	${nombre} !== 123 ${nombre} !== ${fecha_de_nacimiento}
Mayor que (>)	Devuelve verdadero si el operando izquierdo es mayor que el derecho.	${edad} > 17 ${edad} > '0'
Mayor que o igual (>=)	Devuelve verdadero si el operando de la izquierda es mayor o igual que el de la derecha.	${edad} >= 18 ${edad} >= 1
menos que (<)	Devuelve verdadero si el operando izquierdo es menor que el operando derecho.	17 < ${edad} ${total_dependientes} < 3
Menor o igual (<=)	Devuelve verdadero si el operando de la izquierda es menor o igual que el de la derecha.	${edad} <= 18 2 <= ${total_dependientes}

operadores logicos

Operador	Descripción	Exemplos
Es lógico (&&)	(Y lógico): agrega una nueva expresión a una condición, que debe ser verdadera para que la expresión completa sea verdadera. La lectura se vería así: si la edad es mayor de 17 años y (&&) la edad es menor de 60 años, entonces es cierto. Para la condición mencionada, ambas expresiones deben ser verdaderas para que la condición sea verdadera: la edad debe ser mayor de 17 años y menor de 60.	${edad} >= 17 && ${edad} < 60
O lógico (||)	(O lógico): agrega una nueva expresión a una condición, pero eso no necesariamente tiene que ser cierto para que toda la condición sea cierta. La lectura sería la siguiente: Si el nombre es Ana o (||) el nombre es María, entonces es verdadero. Para esta condición, las dos expresiones son independientes: Si el nombre es Ana, la condición es verdadera. Si el nombre es María, la condición también será verdadera.	${nombre} == 'Ana' || ${nombre} == 'María'
No es lógico (!)	(Negación lógica) - convierte una expresión verdadera en falsa; si no, si la expresión es falsa, la hace verdadera. La lectura sería así: Si la edad no (!) es mayor de 17 años, entonces es cierto.	!(${edad} > 17)

Comparación de campos de tipo texto

Como ejemplo, se tratarán dos campos: nombre y apellido. Para verificar si ambos campos fueron informados por el usuario, es necesario escribir una condición que verifique si ambos están diferentes a vacíos. Para ello, utilice el operador !.

!${nombre} || !${apellido}

La expresión anterior niega el nombre y el apellido. Es decir, consiste siempre que el nombre y apellido no existan.

La regla anterior se leerá de la siguiente manera: Al enviar el formulario, valide si el nombre o apellido no existe, luego realice la acción de constar de los campos de nombre y apellido, mostrando el mensaje Requerido.

También puede comparar campos de tipo texto con otros campos de tipo texto y con textos estáticos. Usando los campos anteriores, se puede hacer la siguiente comparación:

${nombre} == 'Facebook' || ${apellido} == ${nombre}

La regla anterior se leería de la siguiente manera: al enviar el formulario, valide si el nombre es igual a Facebook o si el apellido es igual a nombre, luego ejecute la acción.

comparando numeros

La forma de comparar números es similar a la que se presentó en los textos de comparación. Para números, debe usar el &gt; (mayor que), &gt;= (mayor o igual que), &lt; (menor que), &lt;= (menor o igual que).

Considere los campos: age y age_spouse.

${edad} &lt; 18 || ${cónyuge_edad} &lt; 18

La condición anterior haría la consistencia si las edades reportadas fueran menores de 18 años. Es posible escribir las mismas expresiones, de la siguiente manera:

${edad} &lt;= 17 || ${cónyuge_edad} &lt;= 17

comparando fechas

Todos los campos de fecha en un formulario de ECM se convierten automáticamente a un valor entero. Para comparar dos campos de fecha, utilice las mismas condiciones de ejemplo utilizadas para los números enteros. Por lo tanto:

Considere los campos: fecha_nacimiento, fecha_muerte.

${fecha_muerte} &gt;= ${fecha_nacimiento}

La condición anterior dice que se realizará consistencia si la fecha de muerte es mayor que la fecha de nacimiento.

Para comparar una fecha estática, debe convertir una fecha en un número entero. En el lenguaje Javascript, es posible acceder a la fecha actual a través del nuevo objeto Date(). Para convertir esta fecha a un número entero, debemos llamar a un método de este objeto, llamado getTime().

Considere el siguiente ejemplo:

${fecha_nacimiento} > nueva Fecha().getTime()

La expresión anterior tendrá coherencia si la fecha de nacimiento es posterior a la fecha actual.

Si hay necesidad de comparar con una fecha específica, podemos pasar los parámetros al objeto Fecha, siguiendo el orden: año, mes, día, hora, minuto, segundos. Considere la siguiente expresión:

${fecha_nacimiento} > nueva fecha (2009, 11, 31). getTime ()

La expresión anterior consistirá si la fecha de nacimiento es mayor al 31/12/2019. Observe que como segundo parámetro, el mes, se pasó el valor 11 en lugar de 12. Esto se debe a que en Javascript el conteo de meses comienza desde 0. Es decir, 0 es enero y 11 es diciembre.

Vaya a Senior X Platform > senior X > BPM > Configuración > Fuente de datos. Puede editar una fuente existente que aparecerá en la lista o crear una nueva.

Para configurar, por ejemplo, una fuente de datos que enumere las ciudades de Santa Catarina (sc-cities), use un sitio que proporcione una serie de datos geográficos de todo el mundo, como geonames.org. Usando este sitio, para devolver las ciudades en el estado usaremos esta URL: http://www.geonames.org/childrenJSON?geonameId=3450387.

Al colocar esta URL en el navegador, es posible verificar el JSON devuelto.

Ejemplo:

{ "TotalResultsCount”: 295, “geonombres”: [{“adminCódigo1":"26”, “largo":"-51.04023”, “ ID de nombre geográfico”: 6323039, “ topónimoNombre":"Abdón Batista”, “id del país ":"3469034”, “FCL":" LA”, “población”: 2653, “ código de país ":"BR”, “nombre ":" Abdón Batista ”, “ fclNombre ":" país, estado, región,…”, “ adminCodes1 ”: { “ISO3166_2":"CAROLINA DEL SUR”}, “ nombre del país ":" Brasil ”},…

El servicio devuelve mucha información. Hacer que los campos estén disponibles en la fuente de datosID de nombre geográfico ynombre que están dentro de geonames, que es el elemento raíz en el JSON. Puede hacer que la información sobre el tamaño de la población (población) esté disponible en el servicio si es relevante para el uso de la fuente de datos. Solo es necesario ingresar al campoelemento raíz si la respuesta del servicio JSON tiene un elemento raíz.

Haga que dos piezas de información estén disponibles en el servicio en el DataSource. Por lo tanto, al usar el DataSource en un campo ECM, al seleccionar un registro, puede optar por usar el campoIDENTIFICACIÓN oNombre de la ciudad para llenar el campo.

Ahora solo configure el campo de formulario. Seleccione la fuente de datos en la pestañaConfiguraciones avanzadasy también el campo de fuente de datos que se usará para completar el campo.

Ejemplo de fuente de datos:

JSON

{ "filas”: [{“ID de usuario":"d1c040b3-943a-4be8-9343-61ee69cc2754”, “Nombre":"administración”, “ nombre completo ":"administrador de sistema”, “Email":" noreply@senior.com.br” },..