Fórmulas de tablas y registros relacionados

Modificado el Jue, 28 May a 5:17 P. M.

Estas fórmulas se utilizan cuando necesitas recuperar valores de registros vinculados, trabajar con tablas relacionadas o extraer, insertar, actualizar y eliminar contenido de campos de tipo tabla.

En la sintaxis de las fórmulas que se muestra a continuación, cualquier parámetro incluido 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, nombres de tabla, coordenadas, valores o funciones anidadas que se utilizan para devolver el resultado final.

Fórmulas de registros relacionados

Utiliza estas fórmulas cuando un campo almacena una referencia a otra tabla y necesitas exportar un valor legible en lugar de la referencia interna.

REPLACE_FROM_TABLE({campo}, "tabla externa", {campo vinculado}, {campo de salida}[, "valor predeterminado", CASE_SENSITIVE | UNCASE_SENSITIVE, "separador"])
GET_VARIANTS_VALUES({campo}, "campo vinculado", "campo a concatenar"[, "separador", "tabla dependiente", true|false, true|false])
TABLEGROUP("table | JSON | list", {subtabla}, "Nombre del campo 1", {campo 1}, "Nombre del campo 2", {campo 2}, ...)

REPLACE_FROM_TABLE sustituye el valor actual por otro valor de una tabla externa vinculada.

Los parámetros principales son:

{campo}, que contiene el vínculo con la otra tabla. También puedes usar {THIS} cuando la fórmula se aplica directamente sobre el campo vinculado.
"tabla externa", que es la tabla de destino donde se almacena el valor que quieres recuperar.
{campo vinculado}, que es el campo de la tabla de destino que contiene el valor referenciado.
{campo de salida}, que es el campo cuyo valor quieres exportar.

Los parámetros opcionales permiten definir un valor predeterminado, controlar la sensibilidad a mayúsculas y minúsculas, y separar correctamente varios valores. Cuando un campo puede contener varios valores vinculados, se recomienda incluir el parámetro separador.

GET_VARIANTS_VALUES recupera valores de una tabla dependiente, como Variantes, y los concatena en un solo campo.

TABLEGROUP convierte ítems de una tabla relacionada en una tabla HTML, JSON o una lista.

Fórmulas para extraer datos de campos de tipo tabla

Utiliza estas fórmulas cuando necesites leer información de un campo de tipo tabla en un conector de salida.

GET_CELL_VALUE({campo_tabla}, columna, fila, "idioma")
PRINT_TABLE_FIELD({campo}, "formato", [opciones], "lang")

GET_CELL_VALUE devuelve el valor de una celda de un campo de tipo tabla.

Sus parámetros son:

{campo_tabla}, el campo de tipo tabla que quieres leer.
columna, la columna cuyo valor quieres extraer.
fila, la fila cuyo valor quieres extraer.
"idioma", un parámetro opcional para campos de tipo tabla multidioma.

PRINT_TABLE_FIELD da formato e imprime todo el contenido de un campo de tipo tabla.

El parámetro "formato" admite estos valores:

JSON
XML
HTML

El parámetro opcional opciones se puede utilizar principalmente con JSON y XML. Los valores documentados incluyen:

FIRST_ROW_AS_COLUMN_TITLES
FIRST_COLUMN_AS_ROW_TITLES
REMOVE_COLUMS_WITH_EMPTY_COLUMN_TITLES
REMOVE_ROWS_WITH_EMPTY_ROW_TITLES

El parámetro opcional "lang" funciona como el parámetro de idioma en GET_CELL_VALUE y es relevante principalmente para campos de tipo tabla multidioma.

Fórmulas para insertar y actualizar campos de tipo tabla

Utiliza estas fórmulas cuando necesites insertar, actualizar o reemplazar completamente el contenido de una tabla mediante conectores de importación o modificaciones en bloque.

INSERT_IN_TABLE(mode, fila 1, columna 1, valor 1, fila 2, columna 2, valor 2, ...)
GET_COLUMN_VALUE("columna" | {campo})

INSERT_IN_TABLE siempre se aplica al campo actual, por lo que no necesitas incluir el propio campo como parámetro.

Admite tres modos obligatorios:

insert
update
delete

El resto de parámetros funcionan en grupos de tres: fila, columna y valor. Puedes definir tantos grupos como necesites. Si el número total de estos parámetros no es múltiplo de tres, la fórmula devolverá un error de sintaxis.

En algunos casos, el valor de fila o columna se puede dejar como comillas vacías "" para crear filas o columnas nuevas.

GET_COLUMN_VALUE se utiliza a menudo dentro de INSERT_IN_TABLE para tomar valores del CSV de entrada y colocarlos en la fila y la columna correctas del campo de tipo tabla.

Eliminar filas o columnas

REMOVE_IN_TABLE("columns", ["column1", "column2"])

REMOVE_IN_TABLE elimina una lista de filas o columnas de un campo de tipo tabla.

Utiliza "columns" al eliminar columnas por nombre. El artículo documentado también trata esta fórmula como la que se utiliza para eliminar filas o columnas de campos de tipo tabla.

Importación de varios registros

Sales Layer también documenta el uso de INSERT_IN_TABLE para importar varias filas de origen en el mismo campo de tipo tabla cuando varias líneas del CSV comparten la misma referencia de ítem.

Esto resulta especialmente útil cuando un registro de producto, variante, categoría o entidad personalizada necesita almacenar varias filas estructuradas dentro de un solo campo de tabla.

Cuando se utiliza este patrón, las filas de origen repetidas se tienen en cuenta para el campo de tipo tabla. Si también conectas filas CSV repetidas con campos que no son de tipo tabla, el valor final importado será el último que se haya leído. En esos campos que no son de tipo tabla no se acumulan valores.

Casos de uso habituales

Sustituir referencias internas por valores legibles de una tabla de entidades personalizadas vinculada.
Exportar todos los valores de variantes, como tallas o colores, en un único campo de producto.
Leer una celda exacta de un campo de tipo tabla en un conector de exportación.
Exportar un campo de tipo tabla como JSON, XML o HTML.
Completar un campo de tipo tabla a partir de filas CSV repetidas en un conector de importación genérico.
Eliminar filas o columnas obsoletas de un campo de tipo tabla.

Buenas prácticas

Al exportar datos vinculados, confirma si el campo de origen contiene un valor o varios. Si puede contener varios valores, incluye el parámetro separador en REPLACE_FROM_TABLE para evitar coincidencias incorrectas. En los campos de tipo tabla, decide primero si tu objetivo es extraer, insertar, actualizar o eliminar contenido, y después elige la fórmula correspondiente. Si utilizas INSERT_IN_TABLE con filas CSV repetidas, prueba la importación primero con una muestra pequeña para confirmar la estructura final de filas y columnas antes de ejecutar una sincronización completa.