Formularios - comandos
Grupo de comandos de interfaz que permiten interactuar con formularios.
Alta de ficha de maestro con formulario
Comando de instrucción del grupo que permite dar de alta una ficha de una tabla maestra.
Origen de la instrucción: ficha de la tabla en curso.
Destino del subproceso: ficha de la tabla maestra creada.
Parámetros
Identificador de campo
Campo enlazado en la que queremos crear la ficha.
Identificador de formulario
Tendrá que ser un formulario asociado a la tabla elegida en el parámetro anterior.
Funcionalidad
Este comando permite dar de alta una ficha de una tabla maestra de la ficha en curso, usando para ello un formulario para que el usuario pueda cumplimentar los campos. La ficha quedará automáticamente enlazada con el registro creado. Este comando de instrucción genera un subproceso cuyo origen será la ficha generada.
Comentarios
El subproceso es ejecutado una vez la ficha haya sido guardada en disco. Si por el motivo que sea la ficha no ha podido se grabada o el usuario cancela el alta, el subproceso no será ejecutado.
El proceso quedará paralizado mientras el formulario permanezca abierto. Una vez haya sido cerrado, el proceso continuará su ejecución.
Este comando solamente podrá ser usado en procesos ejecutados en primer plano. No es funcional el procesos ejecutados en 2º plano (multitarea) ni en tercer plano (en el servidor) ni en 4º plano (en el servidor, asíncrono).
Ejemplo
En la ficha en curso de un formulario de pedidos, por ejemplo, damos de alta un cliente quedando vinculado éste a la ficha del pedido.
Interfaz: aceptar
Comando de instrucción del grupo Interfaz que permite guardar los cambios realizados en la ficha y finalizar su edición.
Este comando, al igual que el resto de los comandos de interfaz, solamente puede ser usado en manejadores de eventos.
Origen de la instrucción: cualquiera.
Destino del subproceso: ninguno.
Parámetros
No tiene.
Funcionalidad
Este comando de instrucción permite guardar los cambios realizados en una ficha que está siendo creada/modificada y finalizar su edición.
Comentarios
Este comando solamente puede ser usado en manejadores de eventos de objetos.
Si es usado en un evento de un formulario cerrará el formulario tras guardar los cambios. Dado que este comando guarda cambios, solamente puede ser usado en formularios de alta y modificación de ficha, nunca en formularios de baja.
Este comando también finaliza el evento, por lo que no podremos incluir más líneas en el mismo posteriores a la que use este comando, pues no serán ejecutadas.
Ejemplo
En un manejador de eventos ejecutado por un botón pedimos conformidad para aceptar el registro.
Interfaz: cancelar
Comando de instrucción del grupo Interfaz que cancela los cambios realizados en la ficha y finaliza su edición.
Este comando, al igual que el resto de los comandos de interfaz, solamente puede ser usado en manejadores de eventos.
Origen de la instrucción: cualquiera.
Destino del subproceso: ninguno.
Parámetros
No tiene.
Funcionalidad
Este comando de instrucción permite cancelar los cambios realizados en la ficha que está siendo editada y finalizar su edición.
Comentarios
Este comando solamente puede ser usado en manejadores de eventos de objetos.
Si el evento es disparado desde un formulario, su ejecución además cerrará el formulario.
Este comando también finaliza el evento, por lo que no podremos incluir más líneas en el mismo posteriores a la que use este comando, pues no serán ejecutadas.
Ejemplo
En el manejador de eventos ejecutado mediante un botón en un formulario de altas, comprobamos el contenido del campo #CLIENTES y actuamos aceptando o cancelando.
Interfaz: guardar ficha en alta o modificación
Comando de instrucción del grupo Interfaz que guarda los cambios realizados en la ficha sin finalizar su edición.
Este comando, al igual que el resto de los comandos de interfaz, solamente puede ser usado en manejadores de eventos de objetos.
Origen de la instrucción: cualquiera.
Destino del subproceso: ninguno.
Parámetros
No tiene.
Funcionalidad
Este comando de instrucción guarda los cambios realizados en una ficha sin finalizar su edición.
Comentarios
Este comando solamente puede ser usado en manejadores de eventos, la ficha será guardada pero el formulario seguirá abierto para que el usuario pueda seguir editando la ficha.
Este comando abre y cierra transacción. Esto quiere decir que, si en el manejador de evento en el que se usa este comando , se usa algún comando que genere transacción, ser generarán dos transacciones diferentes.
Si en un manejador de evento se ha disparado una vez este comando, no se podrá volver a ejecutar otro comando de guardado de ficha en ese mismo manejador de evento (ni este mismo comando ni el comando interfaz: aceptar.
Ejemplo
En un formulario de pedidos guardamos la ficha ante posibles cambios y posteriormente imprimimos un informe.
Modificar ficha seleccionada con formulario
Comando de instrucción del grupo Listas: ficha seleccionada que permite modificar la ficha seleccionada de la lista en curso con un formulario.
Origen de la instrucción: lista de la tabla en curso.
Destino del subproceso: ninguno.
Parámetros
Formulario
Formulario de la tabla en curso con el que el usuario modificará el registro.
Identificador de variable local booleana de retorno de ok
Variable local de tipo booleano en la que se recibirá la confirmación de la modificación (1) o que el usuario ha cancelado (0).
Funcionalidad
Modificar la ficha seleccionada de la lista en curso con un formulario de la tabla.
Este comando permite modificar la ficha seleccionada de la lista en curso con un formulario.
Comentarios
Si la tabla tiene declarada alguna actualización será ejecutada.
Esta función debe utilizarse en la misma lista de la selección.
El proceso quedará paralizado mientras el formulario permanezca abierto. Una vez haya sido cerrado, el proceso continuará su ejecución.
Este comando solamente podrá ser usado en procesos ejecutados en primer plano. No es funcional el procesos ejecutados en 2º plano (multitarea) ni en tercer plano (en el servidor).
Ejemplo
Cargamos el pedido con el ID = 1 y modificamos la ficha con el formulario PEDIDO_ED.
Pedir formulario
Comando de instrucción del grupo Ficha y campos.
Origen de la instrucción: ficha de la tabla en curso.
Destino del subproceso: ninguno.
Parámetros
Identificador de formulario
Identificador de un formulario de origen de la línea del proceso.
Identificador de variable local booleana de retorno de ok
Variable local del formulario.
Funcionalidad
Visualiza el formulario dado en el parámetro y recoge en la variable local de retorno si el usuario ha aceptado (1) o cancelado (0) dicho formulario.
Comentarios
El formulario se rellena con el contenido de la ficha en curso, pudiendo el usuario modificar los datos antes de aceptar. Esta función no puede ser utilizada para dar altas, sino para realizar modificaciones.
El proceso queda paralizado mientras el formulario permanezca abierto en pantalla.
La variable local booleana de retorno de ok podrá ser tanto una declarada previamente en el proceso como una nueva.
El proceso quedará paralizado mientras el formulario permanezca abierto. Una vez haya sido cerrado, el proceso continuará su ejecución.
Este comando solamente podrá ser usado en procesos ejecutados en primer plano. No es funcional el procesos ejecutados en 2º plano (multitarea) ni en tercer plano (en el servidor).
Ejemplo
Cargamos el cliente con ID = 10 mostrando los datos con el formulario de edición CLIENTE_ED. Posteriormente mostramos un mensaje dependiendo de si el formulario es aceptado o cancelado.
Última actualización