Crear un transformador para mapear tus datos

Define cómo cada columna de tu archivo se convierte en el campo que espera el destino, pruébalo con datos de ejemplo y guárdalo.

Un transformador es la regla que convierte una fila de tu archivo en el registro que espera el sistema de destino. Tiene dos lados: el objeto de entrada, que es una fila de ejemplo con tus columnas, y el objeto de salida, que es la estructura que hay que enviar. Tu trabajo es unir cada campo de salida con su columna de origen.

En WeSyncro:ImportadorTransformadores

Antes de empezar#

Ten un Excel de ejemplo con los títulos en la fila 1 y una fila de datos reales en la fila 2.
Averigua qué estructura espera el destino. Si es un sistema externo, pídele a su proveedor un ejemplo del JSON que recibe.

Pasos#

Crea el transformador
Haz clic en Nuevo Transformador y completa Nombre del Transformador, que es obligatorio, y la Descripción.
Carga el objeto de entrada
En el panel Objeto de Entrada haz clic en Importar Excel y sube tu archivo de ejemplo. El sistema arma la muestra con los títulos de la fila 1 y los valores de la fila 2, y avisa "Excel importado: N campos detectados."
También puedes pegar un JSON de ejemplo en la pestaña Editor.
Define el objeto de salida
En el panel Objeto de salida, pestaña Visual, escribe en Estructura de Salida Deseada (JSON) la estructura que espera el destino. Los valores pueden quedar vacíos: lo que importa son los nombres de los campos.
Une cada campo
En la pestaña Visual de la entrada, haz clic en un campo de origen. Luego haz clic en el campo de salida que debe recibirlo. El campo de salida queda en verde y verás "Campo enlazado:" con la ruta.
Ajusta los campos que lo necesiten
Haz clic en un campo de salida sin tener un origen seleccionado para abrir el Editor Avanzado. Ahí puedes aplicar funciones, concatenar campos o fijar un valor. Revisa funciones y opciones del transformador.
Prueba
Haz clic en Previsualizar. La ventana Resultado Probable muestra el registro que se enviaría con tu fila de ejemplo.
Guarda
Haz clic en Guardar Transformador. Verás "Transformador guardado correctamente".

Cómo se ve por dentro#

Al unir campos, el sistema escribe una plantilla donde cada valor entre llaves dobles apunta a una columna de tu archivo. La puedes ver y editar en la pestaña Editor del objeto de salida.

Fila de ejemplo en el objeto de entrada:

{
  "sku": "LAP-001",
  "nombre": "Lápiz grafito HB",
  "precio_neto": "250"
}

Plantilla del objeto de salida:

{
  "codigo": "{{sku | trim}}",
  "titulo": "{{nombre | capitalize}}",
  "precio": "{{precio_neto | toInteger}}",
  "moneda": "CLP"
}

Reglas de la plantilla:

Escritura	Resultado
`{{sku}}`	El valor de la columna `sku`.
`{{sku \| trim}}`	El valor después de aplicar una función.
`{{sku \| trim \| uppercase}}`	Varias funciones, en orden de izquierda a derecha.
Texto sin llaves, como `CLP`	Un valor fijo, igual para todas las filas.
Varias etiquetas y texto en un mismo valor	Se concatenan.

El nombre dentro de las llaves debe ser idéntico al título de la columna en tu archivo, incluidas mayúsculas, tildes y espacios.

Leer la previsualización#

Resultado Probable tiene tres pestañas:

Documento: el resultado en formato legible.
JSON: el registro exacto que se enviaría al destino.
Entidades: los datos que el transformador buscó en WeSyncro, si configuraste entidades.

La previsualización se calcula en el servidor con la misma lógica que una importación real, así que lo que ves ahí es lo que se enviará.

Administrar transformadores#

El listado muestra Nombre, Descripción y Creado, con un buscador por nombre o descripción y un ícono para editar cada transformador.

Problemas frecuentes#

"El nombre es obligatorio"#

Falta el Nombre del Transformador.

"JSON de entrada no válido"#

El texto del objeto de entrada no es un JSON bien formado. Revisa comillas, comas y llaves, o vuelve a cargarlo con Importar Excel.

"Error de contexto: Un campo dentro de una lista no puede mapearse directamente a un campo de nivel superior."#

Intentaste unir un campo que está dentro de una lista con un campo de salida que está fuera de ella. Une campos de lista solo con campos de una lista en la salida.

"No se puede mapear un valor individual a una estructura de lista completa."#

Seleccionaste como destino una lista entera. Elige un campo dentro de la lista.

"Convirtiendo automáticamente a número entero (puedes cambiarlo después)"#

No es un error. Uniste un texto con un campo numérico y el sistema agregó la función de conversión a entero. Puedes cambiarla en el Editor Avanzado.

"No se pudo generar el resultado en el servidor"#

La previsualización falló. Revisa que la plantilla de salida sea un JSON válido y que las rutas existan en el objeto de entrada.