> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/acciones/workflow-concepts/workflow-steps/memory-steps/write-to-grid.md).

# Añadir filas en Grid

Añade o actualiza filas en un Grid desde tu flujo de trabajo

El paso Add Row(s) in Grid te permite crear nuevas filas o actualizar filas existentes en cualquier Grid desde dentro de tu flujo de trabajo. Usa este paso cuando necesites escribir datos en un Grid diferente o añadir nuevas filas más allá de la fila actual en la que se está ejecutando tu flujo de trabajo.

{% hint style="info" %}
Si quieres asignar los resultados del flujo de trabajo a columnas en la misma fila en la que se está ejecutando tu flujo de trabajo, no necesitas este paso. Usa un paso JSON al final de tu flujo de trabajo y asigna los resultados como columnas en la interfaz de Grid.
{% endhint %}

## Cómo configurarlo

### 1. Selecciona Grid y hoja

Elige el Grid y la hoja de destino donde quieres escribir datos. Ambos campos admiten selección Estática o Dinámica:

* **Estática**: Selecciona desde un menú desplegable de Grids/hojas disponibles
* **Dinámica**: Haz referencia a una variable que contenga el ID del Grid o de la hoja

### 2. Elige un tipo de acción

Selecciona uno de los cuatro tipos de acción según tus necesidades:

| Tipo de acción               | Descripción                                                 |
| ---------------------------- | ----------------------------------------------------------- |
| **Añadir una sola fila**     | Crea una nueva fila a partir de un único objeto JSON        |
| **Añadir varias filas**      | Crea varias filas nuevas a partir de un array de objetos    |
| **Actualizar una sola fila** | Actualiza una fila existente usando su `__id`               |
| **Actualizar varias filas**  | Actualiza varias filas existentes usando sus `__id` valores |

### 3. Proporciona la variable de datos

Selecciona una variable que contenga los datos de tu fila:

**Para acciones de una sola fila**, proporciona un objeto:

```json
{
  "title": "Guía definitiva para la construcción de enlaces",
  "backlinks": "150"
}
```

**Para acciones de varias filas**, proporciona un array de objetos:

```json
[
  {
    "title": "Guía definitiva para la construcción de enlaces",
    "backlinks": "150"
  },
  {
    "title": "Mejores prácticas de SEO",
    "backlinks": "89"
  }
]
```

### 4. Asigna las claves del objeto a las columnas del Grid

Usa la interfaz de asignación de columnas para conectar las claves de tu JSON con las columnas existentes del Grid. Haz clic en **Añadir asignación de columna** y especifica:

* **Clave**: El nombre de la clave de tu objeto JSON
* **Columna**: La columna de destino en tu Grid

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-8675f7b424984d035a0d03220d23a9cd2c57da49%2Fadd-rows-01-column-mapping.png?alt=media" alt="Add Rows in Grid step with a Format JSON output as the list variable and its object keys mapped to the Page URL, Target Prompt, and Brief columns"><figcaption><p>Asigna cada clave del objeto a una columna del Grid.</p></figcaption></figure>

### 5. Establece el comportamiento en caso de fallo

Elige qué ocurre si el paso falla:

* **Terminar el flujo de trabajo**: Detener la ejecución del flujo de trabajo
* **Continuar**: Continuar con el siguiente paso a pesar del error

## Actualización de filas existentes

Al usar **Actualizar una sola fila** o **Actualizar varias filas**, tus datos deben incluir el `__id` campo para identificar qué filas actualizar. Este campo se incluye automáticamente cuando lees filas usando el paso Leer desde Grid.

### Ejemplo: leer, modificar y actualizar

**Paso 1**: Usa Leer desde Grid para obtener las filas existentes con sus `__id` valores:

```json
[
  {
    "__id": "123",
    "title": "Borrador de publicación de blog",
    "status": "Borrador"
  },
  {
    "__id": "456",
    "title": "Guía de SEO",
    "status": "En revisión"
  }
]
```

**Paso 2**: Transforma los datos en un paso de Code mientras conservas el `__id`:

```javascript
const rows = steps.read_grid.output;
return rows.map(row => ({
  __id: row.__id,
  status: "Publicado",
  published_date: new Date().toISOString()
}));
```

**Paso 3**: Usa Add Row(s) in Grid con **Actualizar varias filas** para escribir los cambios de vuelta.

### Comportamiento de actualización

* Cada objeto debe incluir un `__id` que coincida con una fila existente
* Solo se actualizarán las columnas que incluyas; las demás columnas permanecerán sin cambios
* Las filas con `__id` que no coincidan se omitirán
* No necesitas asignar `__id` en la sección de asignación de columnas

## Cuándo usar este paso

**Usa Add Row(s) in Grid cuando:**

* Crear nuevas filas en un Grid separado
* Añadir varias filas generadas a partir de una sola ejecución del flujo de trabajo
* Actualizar filas existentes en cualquier Grid

**Usa un paso JSON en su lugar cuando:**

* Asignar resultados a columnas en la fila actual del Grid
* Organizar múltiples resultados en un formato estructurado para la misma fila


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/es/acciones/workflow-concepts/workflow-steps/memory-steps/write-to-grid.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
