Saltar al contenido principal

​
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

OpciónRequeridoDescripción
NameNoEtiqueta del paso en el lienzo del flujo de trabajo.
ModeSíLa transformación a ejecutar. Elige Build Rows, Concat Arrays o Flatten Array.
FieldsSolo Build RowsClaves del objeto de salida y sus valores fuente.
SourcesSolo Concat ArraysValores de arreglo que se anexarán en un único arreglo.
Source ValueSolo Flatten ArrayUn valor de arreglo a aplanar en un nivel.
Mismatch PolicySolo Build RowsCómo manejar arreglos con longitudes diferentes.
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: 
{
  "tool_names": ["Exa", "Airtable"],
  "search_contexts": ["Search context for Exa", "Search context for Airtable"]
}
Campos de Build Rows: 
[
  { "key": "tool_name", "value": "{{tool_names}}" },
  { "key": "search_context", "value": "{{search_contexts}}" },
  { "key": "workspace", "value": "Fetch Hive" }
]
Salida: 
[
  {
    "tool_name": "Exa",
    "search_context": "Search context for Exa",
    "workspace": "Fetch Hive"
  },
  {
    "tool_name": "Airtable",
    "search_context": "Search context for Airtable",
    "workspace": "Fetch Hive"
  }
]
Usa Mismatch Policy cuando las longitudes de los arreglos difieran:
PolíticaComportamiento
Pad nullUsa el arreglo más largo y rellena los valores faltantes con null. Es la opción predeterminada.
Strict failHace fallar el paso si las longitudes de los arreglos no coinciden.
TruncateUsa la longitud del arreglo más corto.

​
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: 
[
  { "value": "{{step_2.output}}" },
  { "value": "{{step_3.output}}" }
]
Si esos valores son ["a", "b"] y ["c"], la salida es: 
["a", "b", "c"]

​
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: 
[[1, 2], 3, [4]]
Salida: 
[1, 2, 3, 4]

​
Salida

Data Transform almacena su resultado en: 
{{STEP_IDENTIFIER.output}}
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.

​
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