> 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 „Add Row(s) in Grid“ ermöglicht es dir, innerhalb deines Workflows neue Zeilen zu erstellen oder vorhandene Zeilen in einem beliebigen Grid zu aktualisieren. Verwende diesen Schritt, wenn du Daten in ein anderes Grid schreiben oder neue Zeilen über die aktuelle Zeile hinaus hinzufügen musst, in der dein Workflow ausgeführt wird. {% hint style="info" %} Wenn du Workflow-Ausgaben den Spalten in derselben Zeile zuordnen möchtest, in der dein Workflow ausgeführt wird, brauchst du diesen Schritt nicht. Verwende am Ende deines Workflows einen JSON-Schritt und ordne die Ausgaben in der Grid-Oberfläche als Spalten zu. {% endhint %} ## So richtest du es ein ### 1. Grid und Sheet auswählen Wähle das Ziel-Grid und -Sheet aus, in das du Daten schreiben möchtest. Beide Felder unterstützen statische oder dynamische Auswahl: * **Statisch**: Wähle aus einem Dropdown der verfügbaren Grids/Sheets * **Dynamisch**: Verweise auf eine Variable, die die Grid- oder Sheet-ID enthält ### 2. Aktionstyp auswählen Wähle je nach Bedarf einen von vier Aktionstypen aus: | Aktionstyp | Beschreibung | | ------------------------------------- | ------------------------------------------------------------------ | | **Eine einzelne Zeile hinzufügen** | Erstellt eine neue Zeile aus einem einzelnen JSON-Objekt | | **Mehrere Zeilen hinzufügen** | Erstellt mehrere neue Zeilen aus einem Array von Objekten | | **Eine einzelne Zeile aktualisieren** | Aktualisiere eine vorhandene Zeile mithilfe ihrer `__id` | | **Mehrere Zeilen aktualisieren** | Aktualisiere mehrere vorhandene Zeilen mithilfe ihrer `__id` Werte | ### 3. Die Datenvariable angeben Wähle eine Variable aus, die deine Zeilendaten enthält: **Bei Aktionen mit einer einzelnen Zeile**, gib ein Objekt an: ```json { "title": "Ultimativer Leitfaden zum Linkaufbau", "backlinks": "150" } ``` **Bei Aktionen mit mehreren Zeilen**, gib ein Array von Objekten an: ```json [ { "title": "Ultimativer Leitfaden zum Linkaufbau", "backlinks": "150" }, { "title": "Bewährte SEO-Praktiken", "backlinks": "89" } ] ``` ### 4. Objekt-Schlüssel den Grid-Spalten zuordnen Verwende die Zuordnungsoberfläche für Spalten, um deine JSON-Schlüssel mit vorhandenen Grid-Spalten zu verbinden. Klicke **Spaltenzuordnung hinzufügen** und gib Folgendes an: * **Schlüssel**: Der Schlüsselname aus deinem JSON-Objekt * **Spalte**: Die Zielspalte in deinem Grid ### 5. Fehlerverhalten festlegen Wähle aus, was passiert, wenn der Schritt fehlschlägt: * **Workflow beenden**: Die Ausführung des Workflows stoppen * **Weiter**: Trotz des Fehlers mit dem nächsten Schritt fortfahren ## Vorhandene Zeilen aktualisieren Wenn du **Eine einzelne Zeile aktualisieren** oder **Mehrere Zeilen aktualisieren**, müssen deine Daten das `__id` Feld enthalten, um zu identifizieren, welche Zeilen aktualisiert werden sollen. Dieses Feld wird automatisch einbezogen, wenn du Zeilen mit dem Schritt Read from Grid liest. ### Beispiel: Lesen, ändern und aktualisieren **Schritt 1**: Verwende Read from Grid, 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**: Transformiere die Daten in einem Code-Schritt und bewahre dabei das `__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**: Verwende Add Row(s) in Grid mit **Mehrere Zeilen aktualisieren** um die Änderungen zurückzuschreiben. ### Aktualisierungsverhalten * Jedes Objekt muss eine `__id` enthalten, die mit einer vorhandenen Zeile übereinstimmt * Nur die Spalten, die du angibst, werden aktualisiert; andere Spalten bleiben unverändert * Zeilen mit nicht übereinstimmenden `__id` Werten werden übersprungen * Du musst nicht zuordnen `__id` im Abschnitt zur Spaltenzuordnung ## Wann dieser Schritt verwendet werden sollte **Verwende Add Row(s) in Grid, wenn:** * du neue Zeilen in einem separaten Grid erstellst * du mehrere Zeilen hinzufügst, die aus einem einzigen Workflow-Durchlauf generiert wurden * du vorhandene Zeilen in einem beliebigen Grid aktualisierst **Verwende stattdessen einen JSON-Schritt, wenn:** * du Ausgaben den Spalten in der aktuellen Grid-Zeile zuordnest * du mehrere Ausgaben für dieselbe Zeile in einem strukturierten Format organisierst --- # 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=&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.