Tutor de localizador básico
Última actualización
¿Te fue útil?
Última actualización
¿Te fue útil?
Un localizador es el objeto de proyecto de aplicación que permite localizar registros haciendo uso de los índices existentes en la tabla, de acuerdo a los caracteres introducidos, y retornando la ficha seleccionada por el usuario de entre los registros encontrados. Para ello debe tener una tabla asociada de la que podrá presentar los registros.
Un localizador consta de varias partes:
Un control para seleccionar el índice de búsqueda.
Un control de edición para escribir el dato a buscar.
Una rejilla donde se mostrarán los registros encontrados y donde podremos seleccionar el deseado.
En este tutor vamos a explicar cómo se crea un localizador y dos formas distintas de invocarlo.
Se pretende poder localizar,desde la ficha de un cliente, un sector de actividad para asignárselo. Para ello, haremos uso de las siguientes tablas de vTutor:
Por un lado tenemos la tabla de Sectores de actividad (SEC_ACT_M) y por el otro la tabla de Clientes (CLT_M). Esta última contiene un enlace maestro a Sectores de actividad:
El formulario desde el cual desplegaremos este localizador se llama CLT_M_TUT_LOC y lo encontraremos en la carpeta tutores/básicos/localizador básico.
Identificador: SEC_ACT_M_LOC.
Nombre: sectores de actividad.
Tabla asociada: SEC_ACT_M.
Todos los índices: asignaremos el valor verdadero. Esto nos permitirá que el usuario pueda usar cualquier índice de la tabla de Sectores de actividad para localizar un registro.
Y ya tenemos nuestro localizador creado.
En los capítulos siguiente explicaremos dos modos de invocar a este localizador de Sectores de actividad desde una ficha de un Cliente.
Campo: en esta propiedad debemos indicar cuál es el campo enlazado a maestro que queremos usar. En este caso indicaremos el campo enlazado a la tabla de Sectores de actividad, es decir, SEC_ACT.
Objeto: en esta propiedad indicaremos el localizador que habíamos creado: SEC_ACT_M_LOC.
Cuando el usuario final pulse este botón y seleccione un registro en el localizador, el registro seleccionado será automáticamente asignado al campo SEC_ACT del cliente.
Para este ejemplo se ha usado también el formulario CLT_M_TUT_LOC que encontraremos en la misma carpeta que el tutor. Recordemos que es un formulario que está asociado a la tabla de Clientes (CLT_M) y se trata de localizar un sector de actividad para asignarlo a la ficha de un cliente. Lo que vamos a hacer es simular la funcionalidad del botón anterior: es decir, seleccionar un sector de actividad en el localizador y asignar el registro leído al campo enlazado a sectores de actividad de la ficha del cliente.
Este comando de instrucción genera un subproceso, el origen de este subproceso será la ficha seleccionada por el usuario. Si no selecciona ninguna ficha, no se ejecutará dicho subproceso. En el subproceso que genera lo que hacemos es guardar en la variable local que hemos inicializado al comienzo del manejador de evento el ID del sector de actividad seleccionado en el localizador.
Si ejecutamos este tutor tendremos que editar cualquier registro de la lista de clientes que se presenta y, en el formulario que se abre, pulsar uno u otro botón.
El localizador los encontraremos en la carpeta correspondiente a los objetos de la tabla de sectores de actividad del proyecto de aplicación de vTutor, y el objeto se llama SEC_ACT.
Para crear un localizador pulsaremos el botón de la . Le asignaremos las propiedades siguientes:
Rejilla: SEC_ACT_M_LOC. Se trata de una que se ha creado asociada a la tabla de Sectores de actividad y que está en la carpeta de los objetos específicos de este tutor. Para conocer cómo se crear una rejilla, ver el .
Para este ejemplo se ha usado el formulario CLT_M_TUT_LOC que encontraremos en la misma carpeta que el tutor. Es un formulario que está asociado a la tabla de Clientes (CLT_M) y se trata de localizar un sector de actividad para asignarlo a la ficha de un cliente. Para ello creamos en el formulario un control de tipo y le establecemos las propiedades siguientes:
Comando: localizar maestro. Este comando nos permite disparar un objeto de una tabla maestra de la actual.
Para ello creamos en el formulario un subobjeto de tipo , en que crearemos las instrucciones siguientes:
Con el comando inicializaremos una variable local en la que guardaremos el ID del sector de actividad que haya seleccionado el usuario.
Con el comando disparemos el localizador de sectores de actividad que habíamos creado.
Y, finalmente, solamente en el caso de que se haya seleccionado un registro en el localizador, con el comando asignamos el dato leído al campo enlazado a Sectores de actividad del cliente.
