Fichas

Contenido

¿Ha cambiado la ficha?

Alta de ficha

Crear copia de ficha en memoria

Crear nueva ficha en memoria

Leer ficha de maestro

Modificar ficha de maestro

Procesar ficha en memoria

Fichas

Conjunto de comandos de proceso que permite interactuar con una ficha de una tabla y sus campos. Este tipo de comandos solamente estarán accesibles en aquellas líneas de proceso cuyo origen sea una ficha de una tabla.

¿Ha cambiado la ficha?

Comando de instrucción del grupo Ficha y campos que comprueba si ha cambiado o no cualquier campo de una ficha de una tabla.

Origen de la instrucción: ficha de la tabla en curso.

Destino del subproceso: ninguno.

Parámetros

Identificador de variable local booleana de retorno de ok

variable local de tipo booleano que recogerá si el registro ha cambiado (1) o no (0).

Funcionalidad

Este comando devuelve en una variable local booleana si la ficha actual ha cambiado (1) o no (0).

Comentarios

La variable local booleana de retorno podrá ser tanto una ya existente como una nueva.

Este comando compara el contenido que tiene el registro en memoria con contenido que tenía al abrir la ficha.

Si se trata de un alta de ficha, detectará que ha habido cambios si algún campo no está vacío.

Si se trata de una modificación, la comparación se hará con el valor que tenga esa ficha en disco.

Si se desea utilizar este comando en un evento de tabla debería ser usando en el evento previo y no en el posterior. El motivo es que en el evento posterior la ficha ya ha sido guardada en disco, por lo que el valor de la misma en memoria y el valor guardado en disco ya será el mismo.

Ejemplo

Verificamos si ha cambiado algún campo de la ficha en curso mostrando un mensaje durante 3 segundos.

¿Ha cambiado la ficha? ( CAMBIA )
If ( CAMBIA )
    Mensaje ( "El registro ha cambiado", Información, 3, "Aviso" )

Alta de ficha

Comando de instrucción del grupo Ficha y campos que crea un nuevo registro en una tabla.

Origen de la instrucción: cualquiera.

Destino del subproceso: la ficha creada.

Parámetros

Manejador de ficha

Manejador de la ficha a crear.

Funcionalidad

Este comando de instrucción añade una nueva ficha a una tabla. El contenido de la misma ha de ser establecido previamente con el comando de instrucción Crear nueva ficha en memoria o el comando Crear copia de ficha en memoria, que es donde se habrá declarado el manejador usado como parámetro. Este comando de instrucción genera un subproceso cuyo origen será la ficha generada.

Comentarios

Requerimiento fundamental es que la ficha a grabar haya sido inicializada previamente dentro del mismo proceso mediante el comando Crear nueva ficha en memoria o el comando Crear copia de ficha en memoria, que es donde se declara el manejador solicitado en el primer parámetro.

El subproceso de este comando es ejecutado una vez la ficha haya sido guardada en disco. Si por el motivo que sea la ficha no ha podido ser grabada, el subproceso no será ejecutado.

Ejemplo

Damos de alta un sector de actividad utilizando la instrucción Crear nueva ficha en memoria, asignando el valor al campo NAME de la tabla SEC_ACT_M (Sectores de actividad) dando de alta la ficha con la instrucción Alta de ficha. Posteriormente nos muestra en número del ID asignado a la ficha que hemos creado.

Crear nueva ficha en memoria ( alta.SEC_ACT_M, SEC_ACT_M@ejemplo_dat )
    Modificar campo ( NAME, "Alta de sector ejemplo" )
Alta de ficha ( alta.SEC_ACT_M )
    Mensaje ( "Se ha creado el sector de actividad con el ID: " + #ID, Información, ,  )

Crear copia de ficha en memoria

Comando de instrucción del grupo Ficha y campos que crea una copia en memoria de una ficha de la tabla en curso.

Origen de la instrucción: ficha de la tabla en curso.

Destino del subproceso: ninguno.

Parámetros

Manejador de ficha

Identificador o manejador que queremos dar a la ficha para poder referenciarla a lo largo del proceso.

Funcionalidad

Crea una copia en memoria de una ficha de la tabla en curso. Esta copia será local al proceso.

Comentarios

Las modificaciones que se realicen en la ficha copiada en memoria afectarán solamente a ésta, no a la ficha de origen.

Podremos procesar y/o modificar la copia generada en memoria mediante el comando des instrucción Procesar ficha en memoria, en el que la ficha será identificada con el manejador declarado en su parámetro.

Podremos crear una nueva ficha a partir de la copia creada en memoria mediante el comando de Alta de ficha, al igual que en el caso anterior, en este comando la ficha será referenciada con el manejador declarado en su parámetro.

A tener en cuenta sobre los campos de tipo objeto

Cuando declaramos un campo de tipo objeto, el objeto no es guardado en la tabla, sino en un fichero aparte llamado contenedor. En la tabla lo que se guarda es un enlace a ese objeto del contenedor.

Por lo tanto, si creamos una copia de ficha en memoria sin tocar los objetos, lo que haremos será copiar esas referencias al objeto, no el objeto en sí.

Por lo tanto, los dos registros (el original y el duplicado) apuntarán al mismo objeto.

Esto quiere decir que si en el registro 1 modifico la imagen, por ejemplo, también se modificará en el registro 2, pues ambos están apuntando al mismo objeto del contenedor.

Realmente lo recomendable sería hacer lo siguiente:

1) Si no se desean duplicar los objetos: antes de dar de alta la ficha, procesarla y limpiar los campos objeto:

Crear copia de ficha Procesar ficha en memoria Limpiar campo objeto Alta de ficha

2) Si se desean duplicar los objetos:

Entonces lo recomendable es usar el comando Tubo de ficha en lugar de hacerlo mediante el uso de este comando.

Ejemplo

Creamos un nuevo pedido partiendo del pedido en curso modificando la fecha del nuevo pedido con la fecha actual del sistema.

Crear copia de ficha en memoria ( copia_PED_G )
Procesar ficha en memoria ( copia_PED_G )
    Modificar campo ( FCH, currentDate() )
Alta de ficha ( copia_PED_G )
    Mensaje ( "Se ha creado el pedido ID: " + #ID, Información, ,  )

Crear nueva ficha en memoria

Comando de instrucción del grupo Ficha y campos que crea en memoria una ficha de una tabla concreta.

Origen de la instrucción: cualquiera.

Destino del subproceso: ficha de la tabla indicada en sus parámetros.

Parámetros

Manejador de ficha

Identificador o manejador que queremos dar a la ficha para poder referenciarla a lo largo del proceso.

Identificador de tabla

Identificador de la tabla en la que se desea crear la ficha en memoria.

Funcionalidad

Crea en memoria una ficha de la tabla especificada en los parámetros. Esta copia será local al proceso. Este comando genera un subproceso cuyo origen será la ficha creada. En él podremos editar su contenido.

Comentarios

Podremos procesar la ficha generada en memoria a lo largo del proceso mediante el comando de instrucción Procesar ficha en memoria, en el que la ficha será identificada con el manejador declarado en su parámetro.

Esta ficha será local al proceso, por lo que será destruida al finalizar el mismo.

Si queremos crear una ficha en la misma tabla a partir de la ficha generada en memoria usaremos el comando de Alta de ficha, al igual que en el caso anterior, en este comando la ficha será referenciada con el manejador declarado en su parámetro.

Nota

Si queremos programar un bucle para dar de alta varias fichas en la misma tabla, debemos tener en cuenta que el comando crear nueva ficha en memoria debe ser usado dentro del bucle y no fuera.

Ejemplo de bucle incorrecto:

Ejemplo de bucle correcto:

Si el comando lo usamos fuera del bucle y la tabla tiene definidas actualizaciones a otras tablas, si ejecutamos el proceso en tercer plano (en el servidor) sucede que cuando procesamos la ficha en memoria siempre estemos procesando el mismo registro en memoria y eso genera los efectos de que sólo dispare actualizaciones el primer registro generado, ya que el resto asume que son modificaciones del mismo.

Cuando lo ejecutamos en primer o 2º plano (en local) funciona correctamente, porque realmente la ficha se ha de construir en el servidor para cada alta.

Por lo tanto, para asegurarnos el correcto funcionamiento del comando en todos los planos de ejecución, siempre lo incluiremos dentro del bucle.

Los contenidos iniciales de los campos de la ficha se calcularán en el plano donde se ejecute este comando de instrucción de proceso.

Ejemplo

Damos de alta un sector de actividad utilizando la instrucción Crear nueva ficha en memoria, asignando el valor al campo NAME de la tabla SEC_ACT_M (Sectores de actividad) dando de alta la ficha con la instrucción Alta de ficha.

Crear nueva ficha en memoria ( alta.SEC_ACT_M, SEC_ACT_M@ejemplo_dat )
    Modificar campo ( NAME, "Alta de sector ejemplo" )
Alta de ficha ( alta.SEC_ACT_M )

Leer ficha de maestro

Comando de instrucción del grupo Ficha y campos que permite leer la ficha de un maestro de la ficha en curso.

Origen de la instrucción: ficha de la tabla en curso.

Destino del subproceso: ficha del maestro de la ficha de origen.

Parámetros

Identificador de campo

Identificador de un campo de la tabla en curso enlazado a maestro.

Funcionalidad

Lee la ficha del maestro del campo enlazado seleccionado y crea un subproceso cuyo origen es la ficha del maestro leído.

Comentarios

El subproceso que crea este comando solamente se ejecutará si se ha cargado un maestro. Si la ficha no tiene maestro asociado, no será ejecutado.

El subproceso generado es de sólo lectura, por lo tanto, ningún cambio que se haga en el mismo será guardado en la base de datos.

Si se quiere editar el maestro para su modificación habrá que usar el comando de instrucción Modificar ficha de maestro.

Ejemplo

Leemos el pedido con ID 20 mostrando el número total de pedidos que se encuentra en la ficha del cliente.

Cargar lista ( PED_G@velneo_vTutor_dat, ID, 20, , ,  )
    Seleccionar ficha por posición ( 1 )
    Leer ficha seleccionada
        Leer ficha de maestro ( CLT )
            Mensaje ( "Número de pedidos totales del cliente: " + #TOT_PED, Información, ,  )

Modificar ficha de maestro

Comando de instrucción del grupo Ficha y campos que permite acceder a la ficha de un maestro de la ficha en curso en modo lectura/escritura.

Origen de la instrucción: ficha de la tabla en curso.

Destino del subproceso: ficha del maestro de la ficha de origen.

Parámetros

Identificador de campo

Identificador de un campo de la tabla en curso enlazado a maestro.

Funcionalidad

Accede a la ficha del maestro del campo enlazado seleccionado y crea un subproceso cuyo origen es la ficha del maestro editado.

Comentarios

El subproceso generado es de lectura/escritura, por lo tanto, todas las modificaciones realizadas en la ficha serán guardadas en disco.

Si el subproceso no es ejecutado será indicativo de que la ficha está siendo bloqueada en modo lectura/escritura por otra tarea.

Si se quiere acceder al maestro en modo de sólo lectura habrá que usar el comando de instrucción Leer ficha de maestro.

Ejemplo

Desde la ficha en curso de un pedido modificamos el campo total de pedidos de la ficha del cliente, la última fecha y la última hora en la que se realizó el último pedido.

Rem ( Nos encontramos en el origen ficha de un pedido )
Modificar ficha de maestro ( CLT )
    Modificar campo ( TOT_PED, #TOT_PED + 1 )
    Modificar campo ( FCH, currentDate() )
    Modificar campo ( HOR, currentTime() )

Procesar ficha en memoria

Comando de instrucción del grupo Ficha y campos que permite procesar una ficha local al proceso creada previamente mediante un comando Crear nueva ficha en memoria o el comando Crear copia de ficha en memoria.

Origen de la instrucción: cualquiera.

Destino del subproceso: ficha a editar.

Parámetros

Manejador de ficha

Identificador o manejador dado a la ficha mediante la ejecución previa de los comandos Crear nueva ficha en memoria o Crear copia de ficha en memoria.

Funcionalidad

Permite procesar una ficha local al proceso creada previamente mediante los comandos Crear nueva ficha en memoria o Crear copia de ficha en memoria. Este comando genera un subproceso cuyo origen será la ficha asociada al manejador indicado en sus parámetros.

Comentarios

Esta ficha en memoria será local al proceso, por lo que será destruida al finalizar el mismo.

Si queremos crear una ficha en la misma tabla a partir de la ficha generada en memoria usaremos el comando de Alta de ficha, en este comando la ficha será referenciada con el manejador declarado en su parámetro.

Este comando de instrucción también puede ser usado en procesos que vayan a ser ejecutados como evento drop en un objeto de lista, como por ejemplo, rejilla. Permitirá conocer la ficha sobre la que se ha efectuado el drop en una acción de drag & drop. En este caso la ficha no tendrá que ser creada previamente en el proceso mediante los comandos crear nueva ficha en memoria o crear copia de ficha en memoria, simplemente desplegaremos el combo box del parámetro Manejador de ficha y seleccionaremos el valor Ficha drop.

Ejemplo

Creamos un nuevo pedido partiendo del pedido en curso modificando la fecha del nuevo pedido con la fecha actual del sistema mostrando el ID del registro creado.

Crear copia de ficha en memoria ( copia_PED_G )
Procesar ficha en memoria ( copia_PED_G )
    Modificar campo ( FCH, currentDate() )
Alta de ficha ( copia_PED_G )
    Mensaje ( "Se ha creado el pedido con el ID: " + #ID, Información, ,  )

Última actualización