Guía Avanzada de Fórmulas para Centralización Contable

Introducción

Este documento proporciona una guía técnica completa sobre el motor de fórmulas utilizado en el sistema de reportes de Centralización Contable. El objetivo es capacitar a los implementadores para construir y personalizar reportes complejos, garantizando la precisión y la integridad de los datos contables generados.

1. Conceptos Fundamentales del Motor de Fórmulas

Antes de construir fórmulas, es crucial comprender los siguientes principios:

Contexto de Operación: Fila Única

Una fórmula siempre opera dentro del contexto de una única fila de datos. Esto significa que solo puede acceder a los valores de las columnas presentes en esa misma fila. No es posible referenciar datos de filas anteriores o posteriores directamente.

Acceso a Campos y Columnas

1. Campos Disponibles (field): Se puede utilizar cualquier campo de tipo field dentro de una fórmula, siempre que la columna esté definida explícitamente en la estructura del reporte.
2. Campos No Visibles: Si necesitas un dato que no está definido como una columna visible, debes primero crear una columna de tipo Hidden (oculta). Esta columna contendrá el dato requerido y podrá ser referenciada por su código en otras fórmulas, actuando como una variable interna.

Manejo de Columnas con Códigos Duplicados

Es un escenario común tener múltiples columnas que apuntan al mismo campo (por ejemplo, una para el "Debe" y otra para el "Haber" que usan el mismo bind_field). Para evitar la sobrescritura de datos:

• La primera vez que se define una columna con un código, se invoca el dato original.
• En las definiciones posteriores de columnas con el mismo código, no se debe volver a invocar el dato. En su lugar, se debe referenciar el valor ya procesado por la primera columna.
• Advertencia: Si no se sigue esta regla, el valor de la primera columna será sobrescrito por la última definición, lo que puede llevar a la pérdida de información.

2. Métodos y Funciones Disponibles

A continuación se detalla el catálogo completo de métodos predefinidos para la construcción de fórmulas.

Métodos para Cadenas de Texto (String)

Métodos Condicionales y de Valor

Métodos Numéricos

3. Ejemplos de Fórmulas Complejas (Análisis)

Ejemplo 1: Lógica Condicional Anidada

IF(operation_type == 'debit', CONCAT(center, '-', IF(SUBSTR(center, 3, 3) == '5', CONCAT('5', SUBSTR(account, 1, LEN(account))), account)), CONCAT(balance, account))

• Análisis:
  1. Condición Principal: Si operation_type es 'debit'.
  2. Ruta Verdadera: Concatena center con un guion (-) y el resultado de una segunda condición.
  3. Condición Anidada: Revisa si el cuarto carácter de center es '5'.
     • Si es '5', concatena '5' con la cuenta contable (account).
     • Si no es '5', usa el valor de account directamente.
  4. Ruta Falsa: Si operation_type no es 'debit', concatena balance con account.

Ejemplo 2: Limpieza y Formateo de RUT

REPLACE(CONCAT('E', rut), '-', '')

• Análisis:
  1. CONCAT('E', rut): Agrega el prefijo 'E' al RUT del empleado. (Ej: "E12345678-9").
  2. REPLACE(...): Toma el resultado anterior y reemplaza el guion (-) con una cadena vacía, eliminándolo. (Ej: "E123456789").

4. Anexo: Formatos de Fecha (FORMAT_DATE)

Utiliza los siguientes especificadores de formato basados en strftime de Ruby.

5. Preguntas Frecuentes (FAQ) para Implementadores

P1: ¿Qué hago si mi fórmula no produce ningún resultado o da error? R:

1. Verifica la Sintaxis: Revisa que los nombres de los métodos, los paréntesis y las comas estén correctos.
2. Revisa los Nombres de las Columnas: Asegúrate de que los códigos de las columnas que referencias en la fórmula existan y estén escritos exactamente igual.
3. Aísla el Problema: Simplifica la fórmula. Empieza con una parte pequeña y funcional (ej: solo el código de una columna) y ve añadiendo complejidad gradualmente hasta encontrar el punto de fallo.
4. Tipos de Datos: Confirma que estás aplicando los métodos correctos al tipo de dato adecuado (ej: no usar SUBSTR en un campo numérico sin convertirlo primero).

P2: ¿Es posible realizar cálculos entre diferentes filas, como un total acumulado? R: No directamente dentro de una fórmula. El motor opera exclusivamente en el contexto de la fila actual. Los totales acumulados o cálculos inter-filas deben ser manejados por la lógica de agregación del reporte de Odoo, no por las fórmulas a nivel de línea.

P3: ¿Cómo referencio el valor de una columna que acabo de crear con otra fórmula? R: Simplemente usa el código (ID) que le asignaste a esa columna en la nueva fórmula. El motor procesa las columnas en un orden determinado, por lo que para cuando se evalúe tu nueva fórmula, el valor de la columna referenciada ya debería haber sido calculado.

P4: ¿Cuál es la diferencia principal entre CONCAT y MERGE_STR? R: MERGE_STR está diseñado para unir múltiples elementos con un separador común definido en el primer parámetro. CONCAT simplemente une las cadenas una tras otra, sin ningún separador automático entre ellas. Usa MERGE_STR para listas (ej: codigo-cuenta-centro_costo) y CONCAT para uniones directas (ej: prefijo-valor).

P5: Mi fórmula con IF no se comporta como espero. ¿Qué debo revisar? R:

1. La Condición: Asegúrate de usar == para la comparación de igualdad.
2. Valores de Texto: Las cadenas de texto deben ir entre comillas simples ('). Ejemplo: IF(tipo == 'debit', ...).
3. Valores Verdadero/Falso: Verifica que lo que has puesto en valor_si_verdadero y valor_si_falso sea correcto. Puedes poner el código de otra columna, un valor fijo, o incluso otra fórmula anidada.