Fórmulas numéricas, de fecha y condicionales

Estas fórmulas se utilizan cuando necesitas calcular valores, dar formato a números y fechas, o devolver resultados diferentes según una condición.

En la sintaxis de las fórmulas que se muestra a continuación, cualquier parámetro entre corchetes es opcional.

Cómo leer la sintaxis

Las fórmulas de Sales Layer siguen esta estructura:

NOMBRE_DE_LA_FÓRMULA(PARÁMETROS)

El nombre de la fórmula es la función que quieres aplicar. Los parámetros son los campos, valores fijos o funciones anidadas que se utilizan para devolver el resultado final.

Fórmulas condicionales

Utiliza fórmulas condicionales cuando el valor exportado o importado deba cambiar según una regla.

IF(condición, acción si es verdadero[, acción si es falso])
BOOLEAN({campo}[, texto si es verdadero, texto si es falso])
CONTAINS({campo}, "texto"[, UNCASE_SENSITIVE])
COLUMN_EXISTS("nombre de la columna")
IS_EMPTY({campo})
IS_MODIFYED_LATER("fecha")
IS_NUMBER({campo})
IS_STRING({campo})
IS_TRUE({campo})

IF devuelve un valor cuando la condición es verdadera y otro cuando es falsa.

BOOLEAN convierte un valor positivo o negativo en un valor de texto verdadero o falso.

CONTAINS comprueba si un campo contiene un texto determinado.

COLUMN_EXISTS comprueba si una columna está presente en los datos de entrada.

IS_EMPTY, IS_NUMBER, IS_STRING e IS_TRUE son fórmulas de ayuda útiles al crear condiciones.

IS_MODIFYED_LATER comprueba si el ítem se modificó después de una fecha determinada.

Los operadores de comparación disponibles en las condiciones IF son:

=, >, <, >=, <=, <>

Los operadores lógicos disponibles en las condiciones IF son:

AND, OR, NOT

Cuando combines varias comparaciones en la misma fórmula IF, utiliza paréntesis para definir claramente el alcance de cada operación. Esto ayuda a evitar errores de sintaxis.

Fórmulas matemáticas

Utiliza estas fórmulas cuando necesites calcular totales, descuentos, porcentajes o valores numéricos transformados.

MATH(fórmula)
ROUND({campo}[, número de decimales])
CONVERT_CURRENCY({precio}, USD, EUR)
CONVERT_NUM({campo}, "carácter decimal", "carácter de miles", número de decimales)
STANDARD_NUMBER({campo})
MONEY_FORMAT({precio}, 'en_US')
TO_PERCENT({campo}, valor máximo)
RANDOM(número[, número máximo])
EXTRACT_NUMBER({campo})

MATH realiza cálculos matemáticos. Admite operadores y funciones habituales como +, -, *, /, ABSOLUTE(), COSINE(), SINUS(), TANGENT(), EXPONENTIAL(), SQUARE_ROOT(), MIN(), MAX(), POWER(), LOGARITHM() y DEGREES_TO_RADIANS().

ROUND redondea un valor numérico.

CONVERT_CURRENCY convierte un valor de una moneda a otra.

CONVERT_NUM convierte un número a un formato específico de decimales y miles.

STANDARD_NUMBER convierte un número de un formato nacional al estándar común.

MONEY_FORMAT da formato a un valor según la configuración regional especificada.

TO_PERCENT convierte un número en un porcentaje basado en un valor máximo.

RANDOM devuelve un número aleatorio.

EXTRACT_NUMBER extrae un número de una cadena de texto.

Fórmulas de fecha y hora

Utiliza estas fórmulas cuando la salida del conector necesite marcas de tiempo, fechas con formato o condiciones basadas en el tiempo.

GET_CREATION_DATE(["formato"])
GET_LAST_TIME()
GET_TIME([{campo}])
TO_DATE({timestamp}[, "formato de fecha"])
TO_DATE("+1 day")
TO_GMT_DATE({campo}[, "formato de fecha", "zona horaria"])

GET_CREATION_DATE devuelve la fecha de creación del ítem y, opcionalmente, permite darle formato.

GET_LAST_TIME devuelve la fecha y hora de la última llamada en formato UNIX.

GET_TIME devuelve una fecha en formato UNIX.

TO_DATE convierte una marca de tiempo o expresión en una fecha. También puede trabajar con expresiones relativas como "+1 day".

TO_GMT_DATE convierte un valor en una fecha GMT y acepta, de forma opcional, un formato de fecha y una zona horaria.

Fórmulas anidadas

Estas fórmulas se pueden anidar cuando necesitas una lógica más avanzada. Por ejemplo, puedes colocar un cálculo MATH dentro de una fórmula IF, o utilizar funciones de ayuda como IS_EMPTY o CONTAINS dentro de la condición.

Al anidar fórmulas, mantén cada comparación lógica entre paréntesis para que la expresión sea más fácil de leer y para evitar errores de interpretación.

Casos de uso habituales

• Aplicar descuentos o recargos con MATH.

• Devolver un valor de exportación cuando un campo está completado y otro cuando está vacío.

• Convertir números sin formato en precios o porcentajes formateados.

• Comprobar si existen columnas entrantes antes de aplicar una lógica de importación.

• Transformar marcas de tiempo en fechas legibles para la exportación.

• Crear condiciones basadas en fechas para exportaciones programadas o sensibles al tiempo.

Buenas prácticas

Empieza probando la condición o el cálculo por separado antes de combinarlo con otras fórmulas. Cuando utilices IF con más de una comparación, añade siempre paréntesis alrededor de cada bloque lógico. Para exportaciones numéricas, confirma el formato exacto de decimales, miles, moneda o porcentaje que espera el canal de destino antes de elegir la fórmula. Para fórmulas de fecha, asegúrate de que el formato de salida coincide con el formato requerido por el sistema receptor.