Localizadores

Grupo de comandos de Interfaz que permiten localizar una ficha a partir de una lista.

Localizador

Comando de instrucción del grupo Navegante y búsquedas, incluyendo los proyectos heredados.

Origen de la instrucción: cualquiera.

Destino del subproceso: ficha de la tabla origen del localizador.

Parámetros

Identificador de localizador

Identificador del objeto localizador.

Funcionalidad

Este comando permite ejecutar cualquiera de los objetos localizador, incluyendo los heredados.

Comentarios

Crea un subproceso de ficha, cuyo origen será el registro resultante de la selección del usuario, pudiendo, por ejemplo, leer o modificar la ficha seleccionada. Dicho subproceso sólo se ejecuta si el usuario ha seleccionado alguna ficha.

El proceso quedará paralizado mientras el localizador 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

Desde una ficha de pedidos, por ejemplo, tenemos la necesidad de ver los datos de un cliente.Para ello utilizamos un botón para ejecutar un manejador de eventos con las siguientes instrucciones.

Localizador ( CLIENTE_VER@ejemplo )
    Pedir formulario ( CLIENTE_FRM@ejemplo, OK )

Seleccionar ficha de la lista

Comando de instrucción del grupo Listas: ficha seleccionada que permite seleccionar una ficha de la lista en curso.

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

Destino del subproceso: ninguno.

Parámetros

Rejilla

Rejilla de la tabla en curso en la que el usuario seleccionará 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 selección (1) o que el usuario ha cancelado (0).

Funcionalidad

Seleccionar una ficha de la lista en curso mediante una rejilla de la misma tabla que el usuario mediante doble clic en una fila.

Este comando permite seleccionar una ficha que podrá ser luego manejada con los comandos de instrucción leer ficha seleccionada.

Comentarios

Este comando de instrucción debe utilizarse en la misma lista de la selección.

El proceso quedará paralizado mientras la rejilla permanezca abierta. Una vez haya sido cerrada, 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

Mostramos la lista de artículos para seleccionar un artículo y editar su ficha. Si no se ha seleccionado ningún artículo se muestra un mensaje.

Cargar lista ( ARTICULOS@ejemplo, ID, , , ,  )
    Seleccionar ficha de la lista ( ARTICULOS@ejemplo, OK )
    If ( ! OK )
        Mensaje ( "No se ha seleccionado ningún artículo", Información, ,  )