Este artículo explica de forma práctica la sentencia setocc en Uniface 10.4 y cómo usarla para navegar registros de bases de datos dentro de tus componentes. setocc es una instrucción clave para convertir un registro específico en el registro activo de trabajo, similar a seleccionar una fila en una hoja de cálculo.
Qué hace setocc
setocc establece la ocurrencia actual de una entidad, es decir indica a Uniface con qué registro se va a trabajar en ese momento.
Sintaxis básica
setocc Entidad, NumeroOcurrencia
Parámetros
Entidad nombre de la tabla o entidad en el componente, por ejemplo CUSTOMER o ORDER
NumeroOcurrencia número de la ocurrencia que se desea activar, empezando en 1 para la primera ocurrencia. Usar 0 mantiene la ocurrencia actual.
Ejemplos prácticos
Seleccionar el primer cliente
setocc CUSTOMER, 1
Ir al último registro
setocc CUSTOMER, -1
Recorrer todas las ocurrencias
$occ_num$ = 1 repeat setocc ENTRANT, $occ_num$ ; /* procesar ocurrencia */ $occ_num$ = $occ_num$ + 1 until ($occ_num$ > $totocc(ENTRANT))
Características especiales
Si se usa el asterisco como entidad se mueve la ocurrencia en todas las entidades del componente al mismo tiempo, por ejemplo setocc *, -1 lleva todas las tablas del componente a su último registro. Tras ejecutar setocc se dispara el trigger getFocus, que puede iniciar código adicional.
Valores de retorno y manejo de errores
La variable $status indica el resultado: un número positivo indica éxito y cuál es la ocurrencia activa; un número negativo indica error, y $procerror ofrece detalles. Errores comunes: -1102 entidad inválida, -1203 ocurrencia inexistente.
Casos de uso frecuentes
Validación de datos recorrer formularios y comprobar que todos los registros están completos usando setocc y $totocc
Búsqueda directa saltar a la ocurrencia deseada sin desplazarte manualmente
Procesos por lotes combinar setocc con bucles para procesar múltiples registros automáticamente
Buenas prácticas
Comprobar siempre $status después de un setocc para manejar errores
Usar nombres de variables significativos en lugar de valores crípticos como $occ_num$ cuando el código crezca
Combinar setocc con $totocc para evitar intentar acceder a ocurrencias fuera de rango
Probar con distintos volúmenes de datos para asegurar robustez en casos pequeños y grandes
En Q2BSTUDIO somos una empresa de desarrollo de software y aplicaciones a medida con experiencia en aplicaciones a medida y soluciones de inteligencia artificial para empresas. Además ofrecemos servicios en ciberseguridad, pentesting, servicios cloud aws y azure, servicios inteligencia de negocio y Power BI, agentes IA y consultoría en ia para empresas, todo orientado a crear software a medida y plataformas escalables.
Si desarrollas en Uniface y necesitas integrar capacidades avanzadas como automatización de procesos, análisis con Power BI o despliegue en la nube, en Q2BSTUDIO podemos ayudarte a diseñar soluciones seguras y adaptadas a tu negocio. Consulta nuestros servicios de cloud y migración si necesitas despliegue en plataformas gestionadas.
Conclusión: dominar setocc te dará control fino sobre la navegación de registros en tus formularios y procesos. Practica con los ejemplos mostrados y combina setocc con comprobaciones de $status y $totocc para crear aplicaciones Uniface más robustas y fiables.