Tutor de tubos de ficha y de lista

Los tubos son objetos cuya finalidad es la de transferir información de un origen a un destino. Partiendo de un registro o una lista de registros de una tabla de origen, crean un registro o una lista de registros en una tabla de destino.

Un tubo de ficha tiene como entrada y como salida una ficha, es decir, partiendo de un registro de la tabla de origen crea un registro en una tabla de destino.

Un tubo de lista tiene como entrada y como salida una lista, es decir, partiendo de una lista de registros de una tabla de origen crea una lista de registros en una tabla de destino. Para mostrar el uso de los tubos de ficha y de lista en este tutor haremos uso de una única tabla. En este ejemplo veremos cómo duplicar una ficha de dicha tabla, mediante un tubo de ficha, y cómo duplicar una lista de registros de esa tabla usando un tubo de lista.Para este ejemplo vamos a usar la tabla de clientes (CLT_M) del proyecto de dato de vTutor.Los tubos de este tutor los encontraremos en la carpeta de objetos de la tabla de Clientes, que está dentro de la carpeta tablas tutores y buenas prácticas del proyecto de aplicación de vTutor.

Creación del tubo de ficha

Por medio del tubo de ficha vamos a duplicar un registro de la tabla de Clientes.El tubo de ficha ha sido creado en el proyecto de aplicación con las propiedades siguientes:Identificador: CLT_M_TO_CLT.Nombre: Tubo de ficha de cliente (duplicar)Tabla asociada: En este parámetro se ha de seleccionar la tabla de origen del tubo, que en este caso será CLT_M.Tabla destino: En este parámetro se ha de seleccionar la tabla de destino del tubo, que en este caso será también la de CLT_M. La tabla de origen y la de destino no tienen por qué ser iguales, pueden ser distintas. Es decir, a partir de un registro de una tabla, mediante un tubo podremos crear un registro en otra.Formulario confirmación de alta: En el caso de que quisiésemos usar un formulario para que el usuario valide el alta de la ficha de destino lo especificaríamos en este parámetro, en este caso lo hemos dejado vacío.Resolución de campos en destino: En este parámetro indicaremos qué valores tomarán los campos de la tabla de destino. En este tutor los hemos resuelto de la forma siguiente:

• ID: Lo hemos dejado vacío ya que este campo está definido en el proyecto de datos como auto-incrementable.

• NAME: Hemos establecido la fórmula siguiente: #NAME + ” ,copia de ficha, registro código ” +#ID

• Es decir, que como nombre, el registro que se cree tendrá el mismo nombre que el registro de origen, pero se le añadirá el texto siguiente: “, copia de ficha” seguido del ID del registro de origen.

• NIF: Lo dejamos vacío (no puede haber dos empresas distintas con un mismo NIF.

• SEC_ACT, CAT, DIR, OBS: Le asignamos los mismos campos de la tabla de origen.

• IMG, TOT_PED, OFF: Los dejaremos vacíos.

• FCH: Se trata del campo que recoge la fecha de alta del registro, así que en este caso le asignaremos la función currentDate.

• HOR: Se trata del campo que recoge la hora de alta del registro, así que en este caso le asignaremos la función currentTime.

Creación del tubo de lista

Por medio del tubo de lista vamos a duplicar una lista de la tabla de clientes en memoria.El tubo de ficha ha sido creado en el proyecto de aplicación con las propiedades siguientes:Identificador: CLT_M_TO_CLT.Nombre: Tubo de lista de clientes.Tabla asociada: En este parámetro se ha de seleccionar la tabla de origen del tubo, que en este caso será CLT_M.Tabla destino: En este parámetro se ha de seleccionar la tabla de destino del tubo, que en este caso será la de CLT_M. La tabla de origen y la de destino no tienen por qué ser iguales, pueden ser distintas. Es decir, a partir de un registro de una tabla, mediante un tubo podremos crear un registro en otra.Usar contenido inicial el campos destino: Si la tabla de destino del tubo tuviese definidos contenidos iniciales en campos, si ponemos a falso esta propiedad, no se dispararán. En este caso la hemos dejado a falso.Usar actualizaciones en destino: Si la tabla de destino del tubo tuviese declaradas actualizaciones a otras tablas, si ponemos a falso esta propiedad, no se dispararán. En este caso la hemos dejado a falso, ya que esta tabla no actualiza a ninguna tabla.Formulario de confirmación petición de datos destino: En el caso de que quisiésemos usar un formulario para que el usuario introduzca alguna información en los registros de destino, lo especificaríamos en este parámetro, en este caso lo hemos dejado vacío.Resolución de campos en destino: En este parámetro indicaremos qué valores tomarán los campos de la tabla de destino. Resolveremos los campos igual que hemos hecho en el tubo de ficha.Una vez definidos los tubos, veremos cómo podemos programar su ejecución en los puntos siguientes.

Programar la ejecución del tubo de ficha

En el formulario de modificación de la tabla de Clientes, llamado CLT_M, se ha creado el manejador de evento siguiente:1Rem ( Ejecutar tubo de ficha para duplicar el registro actual )2​3Tubo de ficha ( CLT_M_TO_CLT@velneo_vTutor_app )4Mensaje ( "Se ha creado el cliente: " + #ID + " - " + #NAME, Información, , )5Interfaz: CancelarCopied!El evento, simplemente ejecuta el tubo de ficha con el comando tubo de ficha y cancela el formulario.En este mismo formulario se ha creado un botón para disparar este manejador de evento.

Programar la ejecución del tubo de lista

En el formulario inicial del tutor, llamado TUT_TUB, se ha creado el siguiente manejador de evento, llamado TB_LIST:1Rem ( Ejecutar tubo de lista para duplicar los registros mostrados en la rejilla )2Rem ( Accedemos al contenido de la rejilla y aplicamos el tubo de lista )3​4Interfaz: Procesar ( LST, Todas )5Tubo de lista ( CLT_M_TO_CLT@velneo_vTutor_app )6Libre7​8Rem ( Volvemos a cargar la vista de datos con todos los registros )9​10Interfaz: Recalcular ( LST )Copied!El manejador de evento simplemente obtiene los registros de la rejilla de Clientes en memoria que está incrustada en el formulario, dispara el tubo de lista y refresca el contenido de la rejilla.