Transformadores de Valor

Un transformador de valor es una función con nombre que puedes aplicar a un mapeo de campo en tu configuración de mapeo para modificar un valor antes de escribirlo en el sistema destino. Los transformadores se especifican con una clave transform y un objeto options opcional dentro de una entrada de mapeo de campo.

Los nombres de transformadores no distinguen entre mayúsculas y minúsculas. Si un transformador recibe un valor que no puede procesar (por ejemplo, una cadena no numérica pasada a toInt), la etapa de normalización o transformación falla para ese registro.

Transformadores integrados

Transformador	Tipo de entrada	Tipo de salida	Descripción
sapYesNo	Cadena "Y" o "N"	booleano	Convierte indicadores Y/N del estilo SAP a true / false. Úsalo en el bloque de normalización para campos booleanos provenientes de SAP Business One.
boolToStatus	booleano	cadena	Convierte true / false a etiquetas de texto personalizadas. Configura las etiquetas con las opciones trueValue y falseValue. Útil cuando el destino espera una cadena de estado como "ACTIVE" / "INACTIVE".
formatDecimal	decimal o cadena numérica	cadena	Formatea un número decimal a un número fijo de lugares decimales. Usa la opción decimals para establecer la precisión.
dateFormat	cadena de fecha o fecha y hora	cadena	Formatea un valor de fecha o fecha y hora usando un patrón de formato personalizado (por ejemplo, "yyyy-MM-dd"). Usa la opción format para especificar el patrón y la opción opcional timezone para convertir zonas horarias.
lookup	cualquiera	cualquiera	Mapea un valor fuente a un valor de reemplazo usando una tabla clave-valor. Usa la opción map para definir la tabla y la opción opcional default para valores no encontrados en el mapa.
toString	cualquiera	cadena	Convierte cualquier valor a su representación de cadena. Útil cuando el campo destino es de tipo cadena pero el valor fuente puede ser numérico o booleano.
toInt	cadena o decimal	entero	Convierte un valor a entero. Trunca los decimales sin redondear.
toDecimal	cadena o entero	decimal	Convierte un valor a número decimal.
toBool	cualquiera	booleano	Convierte un valor a booleano. Las cadenas no vacías y los números distintos de cero se evalúan como true; las cadenas vacías, null y 0 se evalúan como false.

Referencia de opciones de transformadores

sapYesNo

{
  "transform": "sapYesNo",
  "options": { "trueValue": "Y", "falseValue": "N" }
}

boolToStatus

{
  "transform": "boolToStatus",
  "options": { "trueValue": "ACTIVE", "falseValue": "INACTIVE" }
}

formatDecimal

{
  "transform": "formatDecimal",
  "options": { "decimals": 2 }
}

dateFormat

{
  "transform": "dateFormat",
  "options": { "format": "yyyy-MM-dd", "timezone": "UTC" }
}

lookup

{
  "transform": "lookup",
  "options": {
    "map": {
      "STANDARD": "TAX-STD",
      "EXEMPT":   "TAX-EXEMPT",
      "ZERO":     "TAX-ZERO"
    },
    "default": "TAX-STD",
    "caseInsensitive": true
  }
}

Dónde se pueden usar los transformadores

Los transformadores se pueden aplicar tanto en el bloque de normalización como en el bloque de transformación de una configuración de mapeo:

• Bloque de normalización — usa transformadores para limpiar y convertir los valores crudos del sistema fuente antes de que ingresen a la entidad canónica. Por ejemplo, usa sapYesNo para convertir un indicador "Y"/"N" a un campo booleano isActive.
• Bloque de transformación — usa transformadores para formatear los valores canónicos para el sistema destino. Por ejemplo, usa formatDecimal para asegurarte de que un campo de precio siempre tenga dos lugares decimales al enviarse a Shopify.

Transformadores personalizados

Si los transformadores integrados no cubren una necesidad de conversión específica, contacta a tu administrador de EZY Integrations. Se pueden agregar nuevos tipos de transformadores al sistema y aparecerán en esta lista una vez implementados.

Relacionado

• Configuración de Mapeo — Cómo incluir transformadores en una entrada de mapeo de campo.
• Escritores de Salida — Cómo los conectores de Archivo Plano y API Genérica escriben la salida transformada.