Búsquedas formateadas, campos que se llenan solos

Una búsqueda formateada llena un campo de la pantalla con el resultado de una consulta. Corre sola cuando cambia otro campo, o a mano con Shift+F2 dentro del campo. Por ejemplo:

• Al elegir la serie, el comentario se llena con un texto fijo de esa serie.
• Al elegir el cliente, la referencia toma su número de proveedor.
• Al cambiar el total, un campo de usuario dice si requiere autorización.

Es lo mismo que la búsqueda formateada de SAP Business One y los eventos de controles de Nori escritorio. Las de escritorio no se pasan solas al migrar, porque usaban nombres de controles de Windows y consultas de SQL Server; se capturan de nuevo aquí.

Las configura quien tiene el permiso de búsquedas formateadas. El Administrador lo tiene.

Crear una búsqueda formateada

1. Entra a Administración › Personalización › Búsquedas formateadas y presiona Nuevo.
2. Ponle un Nombre que diga qué hace.
3. En Pantalla elige dónde aplica: Todos los documentos, un tipo de documento (por ejemplo Documento: Factura) o un catálogo (Catálogo: Artículos).
4. Abajo aparecen los Campos de la pantalla, separados como se ven: encabezado, cada pestaña, partidas y pie. En el campo que quieres llenar presiona Llenar.
5. En cada campo que debe dispararla presiona Al cambiar. Si no eliges ninguno, solo corre con Shift+F2.
6. Marca No reemplazar lo capturado si no quieres que cambie un campo que el usuario ya llenó.
7. Escribe la Consulta.
8. Revisa la frase de arriba: dice con palabras qué va a hacer, por ejemplo «En Factura, cuando el usuario cambie Serie, Nori correrá la consulta y pondrá el resultado en Comentarios».
9. En Probar escribe valores de ejemplo para los campos que lee la consulta y presiona Probar: te dice qué quedaría en el campo, sin guardar nada. Cuando el resultado es el que esperas, guarda.

Se ejecuta al cambiar es el momento en que corre sola: cada vez que el usuario cambia alguno de esos campos en la pantalla. Si lo dejas vacío, solo corre cuando el usuario presiona Shift+F2 dentro del campo que se llena.

La consulta

Es un SELECT. El primer valor de la primera fila llena el campo; si no trae filas, el campo queda vacío.

La consulta lee los campos de la pantalla con dos puntos y el nombre del campo:

SELECT 'Venta de cafetería ' || name
FROM document_series
WHERE id = :document_series_id

• Un campo de usuario udf[U_RUTA] se lee como :u_ruta.
• Un campo de las partidas se lee con line_ antes: :line_quantity, :line_item_id. Es la partida que cambió.
• Debajo de cada campo de la lista aparece cómo leerlo.
• En los documentos, :total es el total del documento.
• :user_id es el usuario que está capturando.

Solo lee: no puede cambiar datos ni ver usuarios, contraseñas o configuración, y tiene tiempo límite. Son las mismas reglas que los informes con SQL.

Nombres de los campos en los documentos

No necesitas aprenderlos: la lista Campos de la pantalla los pone por ti. Como referencia, los del encabezado:

En un catálogo el nombre es el del campo en la base (name, code, item_group_id…). Un campo de usuario siempre es udf[CODIGO].

Cómo se comporta

• Cuando un campo se llena, sus propias búsquedas también corren (hasta cinco seguidas).
• Si el campo que se llena es un buscador (cliente, vendedor…), la consulta devuelve el id y la pantalla muestra el nombre.
• En las partidas, la búsqueda corre al cambiar el campo de una partida o al agregar un artículo, y llena esa misma partida.

Si no funciona

• No pasa nada al cambiar el campo: revisa que el nombre en Se ejecuta al cambiar sea exacto y que la búsqueda esté Activa.
• Sale un mensaje de error: la consulta tiene un error; el mensaje dice cuál. Pruébala antes en Informes › Reporteador.
• Shift+F2 dice que el campo no tiene búsqueda: el Campo que se llena no coincide con el nombre del campo donde estás.
• El artículo de la partida no se llena: el artículo solo puede disparar búsquedas, no llenarse con una.