Las transformaciones de valores cambian los datos del archivo de origen antes de escribirlos en el formato final. Se aplican cuando necesitas quitar caracteres extra, normalizar SKU, crear un nombre desde varios campos, preparar el precio, rellenar un valor predeterminado o adaptar los datos a los requisitos de un sitio web, ERP, CMS, marketplace u otras aplicaciones.
Cómo ejecutar una transformación
El bloque Transformaciones está dentro de los ajustes de un valor, campo, nodo o columna concreto. Primero selecciona un valor en el snapshot o la tabla, abre sus ajustes y añade una o varias reglas.
- Abre el perfil y ve al snapshot o editor de estructura.
- Selecciona el campo de resultado: por ejemplo
sku,price,name, una columna de tabla o un campo del catálogo consolidado.
En el editor de tablas, la transformación se abre desde la columna de resultado. Haz clic en el encabezado o la celda necesaria y abre los ajustes del valor.
En el editor XML, selecciona el nodo o atributo que irá al resultado. Después del clic se abre la ventana de ajustes de ese valor.
En el editor JSON, selecciona una clave o valor en el árbol de resultado. Los ajustes se abren para el bloque JSON seleccionado.
En el catálogo consolidado, la transformación se abre desde la vinculación del campo del catálogo. Haz clic en el campo elegido, por ejemplo "Nombre [NAME]" o "SKU [SKU]", y abre los ajustes del valor.
- Abre los ajustes del valor y añade una regla en el bloque Transformaciones.
- Guarda los ajustes y revisa la vista previa en varias filas o productos.
De qué se compone una regla
Una regla se lee como una frase: qué valor comprobar, con qué condición ejecutar la acción y qué escribir como resultado. Si la condición no se cumple, el valor actual continúa sin cambios.
| Parte de la regla | Qué significa | Ejemplo |
|---|---|---|
| Valor a comprobar | Normalmente es el campo actual. En ajustes avanzados, la regla puede comprobar un nodo vecino, una columna u otro campo del producto. | {/catalog/product/stock} |
| Condición | Decide cuándo se ejecuta la regla: cualquier valor, vacío, no vacío, contiene texto, mayor que un número, etc. | mayor que 100 |
| Acción | Define qué hacer: reemplazar, limpiar, añadir texto, calcular, redondear o detener la carga del campo. | aumentar en % |
| Resultado o parámetro | Define el nuevo texto, número, porcentaje, precisión de redondeo u otro parámetro de la acción. | 12 |
Cadenas de reglas
Un campo puede contener varias reglas. Se ejecutan de arriba abajo: el resultado de la primera regla se convierte en la entrada de la siguiente. Por eso el orden importa.
Por ejemplo, suele ser mejor preparar un precio con una cadena: primero limpiar el valor de espacios extra, aplicar margen, comprobar condiciones de stock y redondear solo al final.
Qué pueden hacer las transformaciones
- limpiar texto de HTML, espacios extra, saltos de línea y caracteres de servicio;
- reemplazar fragmentos, por ejemplo quitar guiones del SKU o cambiar un nombre antiguo de categoría;
- añadir prefijo, sufijo o valor desde otro campo;
- crear un campo final desde varios valores de origen;
- convertir texto a mayúsculas o minúsculas;
- transformar números, fechas y precios;
- calcular margen, descuento, coeficiente de proveedor o precio final;
- redondear valores al final de la cadena;
- crear valores predeterminados para campos vacíos;
- detener la carga de un campo concreto cuando ya no debe aparecer en el resultado.
Todos los operadores de transformación
Una regla tiene dos grupos de operadores: el operador de condición decide cuándo se ejecuta la regla, y el operador de acción cambia el valor o el parámetro del campo. Los operadores se pueden combinar en cadenas y pueden comprobar no solo el valor actual, sino también campos vecinos de la misma fila.
Operadores de condición
| Operador | Cómo funciona |
|---|---|
| Cualquiera | La regla se ejecuta siempre y no comprueba el contenido del campo. |
| Igual / No igual | Comprueba si el valor es igual al parámetro o si es diferente. |
| Mayor que / Menor que / Mayor o igual / Menor o igual | Compara valores numéricos. |
| Contiene subcadena / No contiene subcadena | Comprueba si el valor contiene el fragmento de texto indicado. |
| Empieza por / Termina en | Comprueba el inicio o el final de la cadena. |
| Vacío / No vacío | Se ejecuta para valores vacíos o rellenados. |
| Expresión regular / No es expresión regular | Comprueba el valor con una expresión regular. Sirve para patrones de números, letras, prefijos, SKU y códigos. |
Operadores de acción
| Operador | Cómo funciona |
|---|---|
| Reemplazar por | Reemplaza por completo el valor actual por el texto, número o valor de otro campo indicado. |
| Añadir al inicio / Añadir al final | Añade texto, prefijo, sufijo o token de otro campo al inicio o al final del valor actual. |
| Convertir fecha | Convierte una fecha al formato necesario. |
| Recoger valores por ruta / Sumar valores por ruta | Se usa en el editor XML para recoger o sumar valores de nodos repetidos por la ruta indicada. |
| Reemplazar subcadena | Reemplaza un fragmento por otro. El parámetro se escribe como buscar=>reemplazar. |
| Eliminar subcadena | Elimina el fragmento indicado del valor, por ejemplo guiones, espacios o un prefijo técnico. |
| Eliminar después de / Eliminar antes de / Eliminar todo excepto | Recorta el valor respecto al fragmento encontrado: conserva la parte anterior, la posterior o solo el fragmento encontrado. Funciona con Contiene subcadena, Empieza por, Termina en y expresiones regulares. |
| Quitar espacios al inicio y final / Eliminar espacios / Colapsar espacios dobles | Quita espacios al principio y al final, elimina todos los espacios o convierte varios espacios en uno. |
| Eliminar etiquetas HTML | Elimina etiquetas HTML de descripciones y otros campos de texto. |
| Minúsculas / Mayúsculas / Primera letra en mayúscula / Cada palabra con mayúscula | Cambia mayúsculas y minúsculas. |
| Transliteración | Translitera cirílico a latín, útil para códigos, partes de URL y campos técnicos. |
| Redondear | Redondea un número con la precisión y las reglas indicadas. |
| Multiplicar / Dividir / Sumar / Restar | Ejecuta una operación matemática con un número. |
| Aumentar en % / Reducir en % | Añade o resta un porcentaje del valor actual, por ejemplo para margen o descuento. |
| No exportar campo | Limpia el resultado del campo: el valor seleccionado no aparece en la exportación final. |
| Omitir | No cambia nada y pasa el valor actual al siguiente paso de la cadena. Sirve como rama condicional. |
Expresiones regulares
Las expresiones regulares se usan en la condición Expresión regular y en los operadores de recorte. Escribe el patrón sin delimitadores /.../: el servicio lo aplica al valor automáticamente. Por defecto no se distingue entre mayúsculas y minúsculas; si activas la sensibilidad a mayúsculas, se tratarán como letras distintas.
| Tarea | Patrón | Cómo aplicarlo |
|---|---|---|
Conservar solo dígitos de SKU-123-A | \d+ | Usa Expresión regular con Eliminar todo excepto para obtener 123. Así se eliminan de forma práctica las letras y caracteres extra alrededor del número. |
Conservar solo letras de AB-123 | [A-Za-zА-Яа-яЁё]+ | Usa Expresión regular con Eliminar todo excepto para obtener AB. |
| Encontrar un valor que empieza por un prefijo temporal | ^TMP- | Usa Expresión regular para procesar solo SKU temporales. |
| Comprobar un precio decimal | \d+([.,]\d+)? | Útil antes de acciones matemáticas y redondeo. |
| Encontrar espacios extra | \s{2,} | Primero detecta esas filas con una expresión regular y luego aplica Colapsar espacios dobles. |
La base de expresiones regulares es amplia: puedes usar rangos de caracteres, clases como \d y \s, inicio de línea ^, final de línea $, grupos y repeticiones. Prueba los patrones complejos en la vista previa: si la expresión no es válida, la regla no se ejecutará.
Valores predeterminados y campos nuevos
Las transformaciones no sirven solo para valores existentes. Un campo nuevo puede recibir primero un valor base y después otras reglas pueden reemplazarlo según condiciones. Por ejemplo, Clase del producto empieza como Precio medio, y reglas posteriores pueden cambiarlo a Económico o Premium según el precio.
Transformación o condición de exportación
Una transformación cambia un valor. Una condición de exportación decide si un campo, fila, producto o elemento aparece en el resultado. Si necesitas quitar todo el producto, usa condiciones de exportación. Si solo necesitas cambiar un campo, usa una transformación de valor.
| Tarea | Qué usar |
|---|---|
| Quitar un guion del SKU y conservar el producto | Transformación de valor para el campo SKU |
| No exportar una descripción si queda vacía después de limpiar | Transformación de limpieza más condición de campo después de transformaciones |
| No exportar todo el producto cuando el precio es cero | Condición de exportación para el elemento o producto |
| Calcular precio con margen y redondeo | Cadena de reglas para el campo precio |
Cómo comprobar el resultado
- Guarda los ajustes del campo.
- Abre la vista previa o una ejecución de prueba del perfil.
- Comprueba un valor normal, un valor vacío y un ejemplo inusual del origen.
- Si hay varias reglas, deja temporalmente una sola y pruébala por separado.
- Después de cambiar el orden de las reglas, revisa de nuevo el valor final.
- No uses una limpieza demasiado agresiva sin revisar ejemplos reales: puede desaparecer una parte útil del nombre o SKU.
- Ejecuta las acciones matemáticas después de limpiar el número y deja el redondeo para el final.
- Si una regla usa otro campo, comprueba filas donde ese campo esté vacío o no exista.
- Si necesitas eliminar todo el registro, usa condiciones de exportación en lugar de reemplazar el valor por texto vacío.