> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Transform

> Reorganiza los datos del flujo de trabajo construyendo filas, concatenando arreglos, aplanando un arreglo o convirtiendo objetos en una cuadrícula de hoja sin llamar a un servicio externo

# 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ón | Requerido | Descripción |
| - | - | - |
| Name | No | Etiqueta del paso en el lienzo del flujo de trabajo. |
| Mode | Sí | La transformación a ejecutar. Elige **Build Rows**, **Concat Arrays**, **Flatten Array**, **Objects to Grid**, **Classify Date**, **Summarize** o **Date Window**. |
| Fields | Solo Build Rows | Claves del objeto de salida y sus valores fuente. |
| Sources | Solo Concat Arrays | Valores de arreglo que se anexarán en un único arreglo. |
| Source Value | Flatten Array y Objects to Grid | Un valor de arreglo a transformar. |
| Headers | Solo Objects to Grid | Nombres de columna opcionales. Déjalo en blanco para usar cada clave de los registros. |
| Mismatch Policy | Solo Build Rows | Cómo manejar arreglos con longitudes diferentes. |
| Date Field, Status Field, Age Field, Stale After, Today | Solo Classify Date | El campo que contiene la fecha, el nombre del campo de estado que se añade, una ventana opcional de caducidad en días y la fecha con la que comparar. |
| Group By, Total Field, Count items where | Solo Summarize | Campo opcional para contar por valor, campo numérico opcional que se suma y condición opcional que se cuenta (campo, operador y valor, como en Filter). |
| Period, Days, Today | Solo Date Window | Qué periodo calcular a partir de la fecha de ejecución (semana pasada, esta semana, ayer, hoy, últimos 7 o 30 días, últimos N días, este mes, mes pasado), la N de últimos N días y la fecha desde la que contar. |

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. El paso falla si lo ejecutas sin campos o con una clave de campo vacía.

Los valores fuente de tipo arreglo se leen por índice. Los valores escalares estáticos se repiten para cada fila.

Ejemplo:

```json theme={null}
{
  "tool_names": ["Exa", "Airtable"],
  "search_contexts": ["Search context for Exa", "Search context for Airtable"]
}
```

Campos de Build Rows:

```json theme={null}
[
  { "key": "tool_name", "value": "{{tool_names}}" },
  { "key": "search_context", "value": "{{search_contexts}}" },
  { "key": "workspace", "value": "Fetch Hive" }
]
```

Salida:

```json theme={null}
[
  {
    "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ítica | Comportamiento |
| - | - |
| Pad null | Usa el arreglo más largo y rellena los valores faltantes con `null`. Es la opción predeterminada. |
| Strict fail | Hace fallar el paso si las longitudes de los arreglos no coinciden. |
| Truncate | Usa 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:

```json theme={null}
[
  { "value": "{{step_2.output}}" },
  { "value": "{{step_3.output}}" }
]
```

Si esos valores son `["a", "b"]` y `["c"]`, la salida es:

```json theme={null}
["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:

```json theme={null}
[[1, 2], 3, [4]]
```

Salida:

```json theme={null}
[1, 2, 3, 4]
```

### 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:

```json theme={null}
[
  { "keyword": "ai agents", "volume": 1200 },
  { "keyword": "workflows", "volume": 800, "difficulty": 12 }
]
```

Salida:

```json theme={null}
{
  "headers": ["keyword", "volume", "difficulty"],
  "rows": [
    ["ai agents", 1200, null],
    ["workflows", 800, 12]
  ]
}
```

Pasa esos valores a un paso de Google Sheets **Upsert Rows**:

```text theme={null}
{{STEP_IDENTIFIER.output.headers}}
{{STEP_IDENTIFIER.output.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.

### Classify Date

Usa **Classify Date** cuando necesites saber si una fecha ya pasó, por ejemplo la fecha límite de una licitación o el vencimiento de una oferta. Un modelo no es fiable al comparar fechas, así que este modo lo hace en código después de que un paso de IA extraiga el texto de la fecha.

Configura **Source Value** con el arreglo de registros, **Date Field** con el campo que contiene la fecha (por ejemplo `deadline`) y deja **Today** como `{{_current_date}}`. Cada registro vuelve con un campo de estado (por defecto `date_status`):

| Estado | Significado |
| - | - |
| open | La fecha es hoy o posterior. |
| closed | La fecha ya pasó. |
| stale | La fecha pasó hace más de **Stale After** días (solo si lo configuras). |
| unclear | La fecha falta, no se puede leer o es ambigua. |

Para ordenar o filtrar por antigüedad, configura **Age Field**: cada registro recibe además el número de días desde la fecha con ese nombre (una fecha futura da un número negativo y una fecha poco clara da `null`). Se ignora la hora o la zona horaria que siga a la fecha. Una fecha numérica cuyo día y mes son ambos 12 o menos, sin nombre de mes, como `10/12/2026`, es ambigua y devuelve **unclear** en lugar de adivinarse. `25/12/2026`, `2026-12-25` y `25 December 2026` se leen con normalidad.

### Summarize

Usa **Summarize** para contar una lista, opcionalmente sumar un campo numérico y agrupar por otro campo, de modo que un paso posterior informe números que coincidan con la lista. La salida es `{ "count": 5, "total": 17.5, "groups": [{ "value": "open", "count": 2, "total": 12 }] }`; `total` aparece solo si configuras **Total Field** y `groups` solo si configuras **Group By**. Los valores no numéricos se omiten al sumar.

Usa **Count items where** cuando un paso posterior necesite el número de elementos que cumplen una condición, o un porcentaje, por ejemplo cuántos elementos de una lista de comprobación se encuentran sobre el total. Indica un campo, un operador y un valor (por ejemplo `status` **is one of** `structured, buried`). La salida incluye entonces también `matched` (cuántos elementos cumplen la condición) y `matched_percent` (`matched` como porcentaje de `count`, redondeado a un número entero, o `0` si la lista está vacía). Haz referencia a ellos como a cualquier otra salida, por ejemplo `{{step_6.output.matched_percent}}`, de modo que los números salgan del paso y no de un paso de IA que cuenta por su cuenta.

### Date Window

Usa **Date Window** cuando un flujo programado lee un periodo como la semana pasada u hoy. Escribir las fechas como entradas queda obsoleto tras una ejecución, y un modelo no es fiable al calcular "del lunes al domingo pasados", así que este modo lo hace en código a partir de la fecha de ejecución. No necesita valor fuente.

Configura **Period** con el periodo sobre el que informas y deja **Today** como `{{_current_date}}`. Las semanas empiezan el lunes, así que **Last week** en una ejecución de lunes es del lunes al domingo anteriores. **Last 7 days** y **Last 30 days** terminan hoy; **Last N days** toma su longitud de **Days**. La salida es un objeto:

```json theme={null}
{
  "window": "last_week",
  "today": "2026-11-02",
  "start": "2026-10-26",
  "end": "2026-11-01",
  "start_at": "2026-10-26T00:00:00Z",
  "end_at": "2026-11-01T23:59:59Z",
  "days": 7,
  "label": "26 Oct to 1 Nov 2026"
}
```

Pasa `{{STEP_IDENTIFIER.output.start}}` y `{{STEP_IDENTIFIER.output.end}}` a los argumentos de fecha de un paso de integración, o `start_at` y `end_at` cuando espera una marca de tiempo completa, y `{{STEP_IDENTIFIER.output.label}}` al paso que redacta el informe.

## Salida

Data Transform almacena su resultado en:

```text theme={null}
{{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.

Para **Objects to Grid**, la salida es un objeto con `headers` y `rows`. Úsalo con Google Sheets **Upsert Rows**.

Para **Date Window**, la salida es un objeto con `start`, `end`, `start_at`, `end_at`, `days` y `label`.

## 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](https://docs.fetchhive.com/es/workflows/steps/integrations/google-sheets.md), [Airtable](https://docs.fetchhive.com/es/workflows/steps/integrations/airtable.md), [Custom API](https://docs.fetchhive.com/es/workflows/steps/utility/custom-api.md) y [Pruebas e iteración](https://docs.fetchhive.com/es/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.