Front-End • Programación Variables – Recepción de variables vía GET

Recepción de variables vía GET en Aplicaciones de Tipo Formulario

Enviar como parámetro una variable a una aplicación es fácil siempre que sea dentro del Entorno Scriptcase, pero cuando se trabaja con aplicaciones externas no es posible realizarlo de la misma forma. Es por eso que, para realizar la interconexión entre aplicaciones, una buena opción para recibir datos externos dentro de un Formulario Scriptcase es utilizar las variables del tipo GET.

Al momento de declarar una variable dentro de Scriptcase se tienen tres opciones SESSION, POST y GET, al tildar la opción GET le permitimos a la aplicación recibir el valor de la variable por medio de la URL de nuestro Formulario. Gracias a ello podremos realizar las tareas que queramos dentro del Formulario, desde setear valores iniciales en la carga de un nuevo registro (de forma a evitar que el usuario vuelva a tipear datos que ya facilitó en la aplicación externa) hasta complejos procesos que requieren valores iniciales para ser iniciados (ej.: Cierre del mes donde se precisa el Mes y Año a ser procesado dentro de los eventos de nuestro Formulario).

Toda la información necesaria para comprender más acerca de la utilización de variables dentro de Scriptcase la pueden hallar en la documentación: http://www.scriptcase.net/docs/es_es/v81/manual_mp.htm#aplicaciones-de-formulario/aplicacion/variable-global

A continuación el ejemplo muestra la declaración de una variable y codificación en Eventos Scriptcase para actuar de una manera distinta a la predeterminada al recibir la variable. Pueden encontrar más información respecto a Eventos en el enlace: http://www.scriptcase.net/docs/es_es/v81/manual_mp.htm#aplicaciones-de-formulario/formularios/event/vision-general

Declaración de la Variable “Documento”

Ámbito -> GET

Configuración -> Opcional (en caso que siempre se espere recibir la variable, esta opción debe quedar destildada)

Tipo -> Entrada

Evento onApplicationInit

Dentro del Evento se valida si la variable “Documento” es distinta a vacío. De ser verdadero, se inicia el Formulario para la carga de un nuevo registro. Este seteo lo realizamos utilizando la macro SC_APL_CONF (Documentación: http://www.scriptcase.net/docs/es_es/v81/scriptcase-macros/scriptcase-macros#sc_apl_conf) a la cual precisamos indicarle el nombre de la Aplicación, la propiedad a ser seteada y el valor deseado para dicha propiedad.

Evento onLoad

Dentro del Evento se valida si la variable “Documento” es distinta a vacío. De ser verdadero, se asigna al campo {Documento} el valor de la variable [Documento] y se setea dicho campo como sólo lectura de forma a no permitir editar el valor recibido. Este seteo lo realizamos utilizando la macro SC_FIELD_READONLY (Documentación: http://www.scriptcase.net/docs/es_es/v81/scriptcase-macros/scriptcase-macros#sc_field_readonly) a la cual debemos indicarle el campo de nuestra aplicación a ser seteada como solo lectura.

Al dar clic en “Ejecutar Aplicación” desde el Scriptcase nos mostrará la siguiente ventana donde permite ingresar la variable que seteamos, si dejamos en blanco y damos clic en “form_cliente” el Formulario se ejecutará normalmente mostrando los registros que contiene la Tabla relacionada a la misma.

Para realizar las pruebas debemos modificar la URL que vemos en el navegador borrando todo lo que precede al nombre de nuestro formulario y agregando nuestra variable y el valor deseado anteponiendo el símbolo “?” tal y como muestra la siguiente imagen.

Se observa que al recibir la variable un valor, además de ingresar en modo “nuevo registro”, se setea como sólo lectura el campo “Documento” y asigna el valor que enviamos.

Check out more content on our blog.