Skip to main content

​
Data Transform

Usa Data Transform cuando necesites reorganizar la salida existente del flujo de trabajo antes de que otro paso la lea. Data Transform no llama a un servicio externo. Es útil antes de los pasos Google Sheets, Airtable, Custom API y de los pasos posteriores de Iteration.

​
Configuración

Agrega este paso desde el grupo Utilities en Search steps….

​
Modos

​
Build Rows

Usa Build Rows para unir arreglos por índice (zip) en un arreglo de objetos. Cada campo tiene una Key y un Source Value. La clave se convierte en una propiedad del objeto. La fuente puede ser una referencia de variable completa como {{tool_names}} o {{step_3.output}}, o un valor estático. Los valores fuente de tipo arreglo se leen por índice. Los valores escalares estáticos se repiten para cada fila. Ejemplo:
Campos de Build Rows:
Salida:
Usa Mismatch Policy cuando las longitudes de los arreglos difieran:

​
Concat Arrays

Usa Concat Arrays para anexar múltiples arreglos en un arreglo más largo. Cada fuente debe resolverse a un arreglo. Si una fuente se resuelve a una cadena, objeto, número o booleano, el paso falla. Fuentes de ejemplo:
Si esos valores son ["a", "b"] y ["c"], la salida es:

​
Flatten Array

Usa Flatten Array para aplanar un arreglo en un nivel. Los elementos de arreglo anidados se expanden. Los elementos no-arreglo permanecen en su lugar. Fuente de ejemplo:
Salida:

​
Objects to Grid

Usa Objects to Grid cuando un paso anterior devuelve un arreglo de objetos y quieres escribir ese conjunto de datos en Google Sheets. Establece Source Value en el arreglo de registros, por ejemplo {{step_2.output}}. Si el paso anterior envuelve las filas en un campo (por ejemplo AI Keyword Data Search), usa ese campo, como {{step_2.output.items}}. Deja Headers en blanco para usar cada clave de objeto en el orden en que aparece. También puedes pasar un marcador que se resuelva a un arreglo de nombres de columna, o una lista separada por comas como keyword, volume, difficulty. Fuente de ejemplo:
Salida:
Pasa esos valores a un paso de Google Sheets Upsert Rows:
Las claves faltantes se convierten en celdas vacías. Los objetos o arreglos anidados dentro de un registro se pasan tal cual; las celdas de Google Sheets funcionan mejor con valores simples como texto y números.

​
Salida

Data Transform almacena su resultado en:
Para Build Rows, la salida es un arreglo de objetos. Esta forma funciona bien con pasos de integración que esperan registros o filas. Para Concat Arrays y Flatten Array, la salida es un arreglo sobre el que pueden iterar los pasos posteriores. Para Objects to Grid, la salida es un objeto con headers y rows. Úsalo con Google Sheets Upsert Rows.

​
Notas

  • Los valores fuente deben ser marcadores de posición completos como {{step_2.output}}, o valores escalares estáticos.
  • Las cadenas de plantilla mixtas como Research for {{tool_names}} no son compatibles en Data Transform V1.
  • Data Transform preserva arreglos y objetos como JSON estructurado para los pasos posteriores.
  • Data Transform es un paso de utilidad gratuito.
Consulta también: Google Sheets, Airtable, Custom API y Pruebas e iteración