Fichas
Última actualización
¿Te fue útil?
Última actualización
¿Te fue útil?
Conjunto de comandos de proceso que permite interactuar con una ficha de una y sus . Este tipo de comandos solamente estarán accesibles en aquellas líneas de proceso cuyo origen sea una ficha de una tabla.
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.
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).
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.
Verificamos si ha cambiado algún campo de la ficha en curso mostrando un mensaje durante 3 segundos.
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.
Manejador de ficha
Manejador de la ficha a crear.
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.
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.
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.
Manejador de ficha
Identificador o manejador que queremos dar a la ficha para poder referenciarla a lo largo del proceso.
Crea una copia en memoria de una ficha de la tabla en curso. Esta copia será local al proceso.
Las modificaciones que se realicen en la ficha copiada en memoria afectarán solamente a ésta, no a la ficha de origen.
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:
Creamos un nuevo pedido partiendo del pedido en curso modificando la fecha del nuevo pedido con la fecha actual del sistema.
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.
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.
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.
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.
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.
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.
Identificador de campo
Identificador de un campo de la tabla en curso enlazado a maestro.
Lee la ficha del maestro del campo enlazado seleccionado y crea un subproceso cuyo origen es la ficha del maestro leído.
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.
Leemos el pedido con ID 20 mostrando el número total de pedidos que se encuentra en la ficha del cliente.
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.
Identificador de campo
Accede a la ficha del maestro del campo enlazado seleccionado y crea un subproceso cuyo origen es la ficha del maestro editado.
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.
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.
Origen de la instrucción: cualquiera.
Destino del subproceso: ficha a editar.
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.
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.
Esta ficha en memoria será local al proceso, por lo que será destruida al finalizar el mismo.
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.
Este comando devuelve en una booleana si la ficha actual ha cambiado (1) o no (0).
Si se desea utilizar este comando en un 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.
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 o el comando 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.
Podremos procesar y/o modificar la copia generada en memoria mediante el comando des instrucción , 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 , al igual que en el caso anterior, en este comando la ficha será referenciada con el manejador declarado en su parámetro.
Entonces lo recomendable es usar el comando en lugar de hacerlo mediante el uso de este comando.
Podremos procesar la ficha generada en memoria a lo largo del proceso mediante el comando de instrucción , en el que la ficha será identificada con el manejador declarado en su parámetro.
Los contenidos iniciales de los campos de la ficha se calcularán en el donde se ejecute este comando de instrucción de proceso.
Si se quiere editar el maestro para su modificación habrá que usar el comando de instrucción .
Identificador de un campo de la tabla en curso a maestro.
Si se quiere acceder al maestro en modo de sólo lectura habrá que usar el comando de instrucción .
Comando de instrucción del grupo Ficha y campos que permite procesar una ficha local al proceso creada previamente mediante un comando o el comando .
Si queremos crear una ficha en la misma tabla a partir de la ficha generada en memoria usaremos el comando de 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 o , simplemente desplegaremos el combo box del parámetro Manejador de ficha y seleccionaremos el valor Ficha drop.
