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.

Alta de ficha de maestro con formulario ( CLIENTES, ALTA_CLIENTE@ejemplo)
    Mensaje ( "Creado el cliente con el ID: " + #ID, Información, ,  )

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.

Pregunta ( "¿ Desea aceptar el formulario ?", ACEPTAR,  )
If ( ACEPTAR = 0 )
    Set retorno proceso = NO
    Finalizar proceso
Else
    Interfaz: aceptar

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.

If ( #CLIENTES = 0 )
    Mensaje ( "No ha especificado el cliente, cancelamos el alta del registro", Información, ,  )
    Interfaz: cancelar
Else
    Interfaz: aceptar

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.

Interfaz: guardar la ficha en alta o modificación
Cargar lista ( PEDIDOS@ejemplo ID, #ID, , ,  )
    Imprimir informe ( INFORME@ejemplo,  )

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.

Cargar lista ( PEDIDOS@ejemplo, ID, 1, , ,  )
    Seleccionar ficha por posición ( 1 )
    Modificar ficha seleccionada con formulario ( PEDIDO_ED@ejemplo,  )

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.

Cargar lista ( CLIENTES@ejemplo, ID, 10, , ,  )
    Seleccionar ficha por posición ( 1 )
    Modificar ficha seleccionada
        Pedir formulario ( CLIENTE_ED@ejemplo, RESULTADO )
        If ( RESULTADO = 0 )
            Mensaje ( "El usuario canceló el formulario", Información, ,  )
        If ( RESULTADO = 1 )
            Mensaje ( "El usuario aceptó el formulario", Información, ,  )

Última actualización