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

# Zeilen in Grid hinzufügen

Zeilen in einem Grid aus Ihrem Workflow hinzufügen oder aktualisieren

Der Schritt „Zeile(n) im Grid hinzufügen“ ermöglicht es Ihnen, neue Zeilen zu erstellen oder vorhandene Zeilen in jedem Grid innerhalb Ihres Workflows zu aktualisieren. Verwenden Sie diesen Schritt, wenn Sie Daten in ein anderes Grid schreiben oder neue Zeilen über die aktuelle Zeile hinaus hinzufügen müssen, in der Ihr Workflow ausgeführt wird.

{% hint style="info" %}
Wenn Sie Workflow-Ausgaben auf Spalten in derselben Zeile abbilden möchten, in der Ihr Workflow ausgeführt wird, benötigen Sie diesen Schritt nicht. Verwenden Sie am Ende Ihres Workflows einen JSON-Schritt und ordnen Sie die Ausgaben in der Grid-Oberfläche als Spalten zu.
{% endhint %}

## So richten Sie es ein

### 1. Grid und Sheet auswählen

Wählen Sie das Ziel-Grid und das Ziel-Sheet aus, in das Sie Daten schreiben möchten. Beide Felder unterstützen statische oder dynamische Auswahl:

* **Statisch**: Aus einem Dropdown der verfügbaren Grids/Sheets auswählen
* **Dynamisch**: Auf eine Variable verweisen, die die Grid- oder Sheet-ID enthält

### 2. Einen Aktionstyp auswählen

Wählen Sie je nach Bedarf einen von vier Aktionstypen aus:

| Aktionstyp                       | Beschreibung                                               |
| -------------------------------- | ---------------------------------------------------------- |
| **Einzelne Zeile hinzufügen**    | Eine neue Zeile aus einem einzelnen JSON-Objekt erstellen  |
| **Mehrere Zeilen hinzufügen**    | Mehrere neue Zeilen aus einem Array von Objekten erstellen |
| **Einzelne Zeile aktualisieren** | Eine vorhandene Zeile mithilfe ihrer `__id`                |
| **Mehrere Zeilen aktualisieren** | Mehrere vorhandene Zeilen mithilfe ihrer `__id` Werte      |

### 3. Die Datenvariable angeben

Wählen Sie eine Variable aus, die Ihre Zeilendaten enthält:

**Bei Aktionen für einzelne Zeilen**, geben Sie ein Objekt an:

```json
{
  "title": "Ultimativer Leitfaden für Linkbuilding",
  "backlinks": "150"
}
```

**Bei Aktionen für mehrere Zeilen**, geben Sie ein Array von Objekten an:

```json
[
  {
    "title": "Ultimativer Leitfaden für Linkbuilding",
    "backlinks": "150"
  },
  {
    "title": "SEO-Best Practices",
    "backlinks": "89"
  }
]
```

### 4. Objekt-Schlüssel den Grid-Spalten zuordnen

Verwenden Sie die Spaltenzuordnungsoberfläche, um Ihre JSON-Schlüssel mit vorhandenen Grid-Spalten zu verbinden. Klicken Sie auf **Spaltenzuordnung hinzufügen** und geben Sie Folgendes an:

* **Schlüssel**: Der Schlüsselname aus Ihrem JSON-Objekt
* **Spalte**: Die Zielspalte in Ihrem Grid

<figure><img src="https://1960680173-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>Ordnen Sie jeden Objekt-Schlüssel einer Grid-Spalte zu.</p></figcaption></figure>

### 5. Fehlverhalten festlegen

Wählen Sie aus, was passiert, wenn der Schritt fehlschlägt:

* **Workflow beenden**: Den Workflowausführung stoppen
* **Weiter**: Trotz des Fehlers mit dem nächsten Schritt fortfahren

## Vorhandene Zeilen aktualisieren

Bei Verwendung von **Einzelne Zeile aktualisieren** oder **Mehrere Zeilen aktualisieren**müssen Ihre Daten das `__id` Feld enthalten, um zu identifizieren, welche Zeilen aktualisiert werden sollen. Dieses Feld wird automatisch einbezogen, wenn Sie Zeilen mit dem Schritt „Aus Grid lesen“ lesen.

### Beispiel: Lesen, Ändern und Aktualisieren

**Schritt 1**: Verwenden Sie „Aus Grid lesen“, um vorhandene Zeilen mit ihren `__id` Werten abzurufen:

```json
[
  {
    "__id": "123",
    "title": "Entwurf eines Blogbeitrags",
    "status": "Entwurf"
  },
  {
    "__id": "456",
    "title": "SEO-Leitfaden",
    "status": "In Prüfung"
  }
]
```

**Schritt 2**: Transformieren Sie die Daten in einem Code-Schritt, wobei Sie die `__id`:

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

**Schritt 3**: Verwenden Sie „Zeile(n) im Grid hinzufügen“ mit **Mehrere Zeilen aktualisieren** um die Änderungen zurückzuschreiben.

### Aktualisierungsverhalten

* Jedes Objekt muss eine `__id` enthalten, die mit einer vorhandenen Zeile übereinstimmt
* Nur die von Ihnen einbezogenen Spalten werden aktualisiert; andere Spalten bleiben unverändert
* Zeilen mit nicht übereinstimmenden `__id` Werten werden übersprungen
* Sie müssen `__id` im Bereich für die Spaltenzuordnung nicht zuordnen

## Wann Sie diesen Schritt verwenden sollten

**Verwenden Sie „Zeile(n) im Grid hinzufügen“, wenn:**

* Neue Zeilen in einem separaten Grid erstellen
* Mehrere Zeilen hinzufügen, die aus einem einzelnen Workflow-Durchlauf generiert wurden
* Vorhandene Zeilen in jedem Grid aktualisieren

**Verwenden Sie stattdessen einen JSON-Schritt, wenn:**

* Ausgaben den Spalten in der aktuellen Grid-Zeile zuordnen
* Mehrere Ausgaben in einem strukturierten Format für dieselbe Zeile organisieren


---

# 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/de/aktionen/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.
