> 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/pt/acoes/workflow-concepts/workflow-steps/memory-steps/write-to-grid.md).

# Adicionar linhas no Grid

Adicione ou atualize linhas num Grid a partir do seu workflow

A etapa Adicionar linha(s) no Grid permite criar novas linhas ou atualizar linhas existentes em qualquer Grid dentro do seu fluxo de trabalho. Use esta etapa quando precisar gravar dados em um Grid diferente ou adicionar novas linhas além da linha atual em que seu fluxo de trabalho está sendo executado.

{% hint style="info" %}
Se você quiser mapear as saídas do fluxo de trabalho para colunas na mesma linha em que seu fluxo de trabalho está sendo executado, você não precisa desta etapa. Use uma etapa JSON no final do seu fluxo de trabalho e mapeie as saídas como colunas na interface do Grid.
{% endhint %}

## Como Configurar

### 1. Selecione Grid e Planilha

Escolha o Grid e a Planilha de destino onde você deseja gravar os dados. Ambos os campos suportam seleção Estática ou Dinâmica:

* **Estática**: Selecione em um menu suspenso dos Grids/Planilhas disponíveis
* **Dinâmica**: Referencie uma variável que contenha o ID do Grid ou da Planilha

### 2. Escolha um Tipo de Ação

Selecione um dos quatro tipos de ação com base nas suas necessidades:

| Tipo de ação                | Descrição                                                     |
| --------------------------- | ------------------------------------------------------------- |
| **Adicionar Linha Única**   | Criar uma nova linha a partir de um único objeto JSON         |
| **Adicionar Várias Linhas** | Criar várias novas linhas a partir de um array de objetos     |
| **Atualizar Linha Única**   | Atualizar uma linha existente usando seu `__id`               |
| **Atualizar Várias Linhas** | Atualizar várias linhas existentes usando seus `__id` valores |

### 3. Forneça a Variável de Dados

Selecione uma variável que contenha os dados da sua linha:

**Para ações de linha única**, forneça um objeto:

```json
{
  "title": "Guia Definitivo de Link Building",
  "backlinks": "150"
}
```

**Para ações de várias linhas**, forneça um array de objetos:

```json
[
  {
    "title": "Guia Definitivo de Link Building",
    "backlinks": "150"
  },
  {
    "title": "Melhores Práticas de SEO",
    "backlinks": "89"
  }
]
```

### 4. Mapeie as Chaves do Objeto para as Colunas do Grid

Use a interface de mapeamento de colunas para conectar as chaves do seu JSON às colunas existentes do Grid. Clique **Adicionar Mapeamento de Coluna** e especifique:

* **Chave**: O nome da chave do seu objeto JSON
* **Coluna**: A coluna de destino no seu Grid

<figure><img src="https://31915162-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>Mapeie cada chave do objeto para uma coluna do Grid.</p></figcaption></figure>

### 5. Defina o Comportamento em Caso de Falha

Escolha o que acontece se a etapa falhar:

* **Terminar Workflow**: Pare a execução do fluxo de trabalho
* **Continuar**: Prossiga para a próxima etapa apesar do erro

## Atualizando Linhas Existentes

Ao usar **Atualizar Linha Única** ou **Atualizar Várias Linhas**, seus dados devem incluir o `__id` campo para identificar quais linhas atualizar. Esse campo é incluído automaticamente quando você lê linhas usando a etapa Ler do Grid.

### Exemplo: Ler, Modificar e Atualizar

**Etapa 1**: Use Ler do Grid para obter linhas existentes com seus `__id` valores:

```json
[
  {
    "__id": "123",
    "title": "Rascunho de Postagem de Blog",
    "status": "Rascunho"
  },
  {
    "__id": "456",
    "title": "Guia de SEO",
    "status": "Em Revisão"
  }
]
```

**Etapa 2**: Transforme os dados em uma etapa de Código preservando o `__id`:

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

**Etapa 3**: Use Adicionar Linha(s) no Grid com **Atualizar Várias Linhas** para gravar as alterações de volta.

### Comportamento da Atualização

* Cada objeto deve incluir um `__id` que corresponda a uma linha existente
* Somente as colunas que você incluir serão atualizadas; as outras colunas permanecem inalteradas
* Linhas com `__id` valores
* que não correspondem serão ignoradas `__id` Você não precisa mapear

## na seção de mapeamento de colunas

**Quando Usar Esta Etapa**

* Use Adicionar Linha(s) no Grid quando:
* Criar novas linhas geradas a partir de uma única execução do fluxo de trabalho
* Atualizar linhas existentes em qualquer Grid

**Use uma etapa JSON em vez disso quando:**

* Mapear saídas para colunas na linha atual do Grid
* Organizar várias saídas em um formato estruturado para a mesma linha


---

# 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/pt/acoes/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.
