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

# Ajouter des lignes dans Grid

Ajoutez ou mettez à jour des lignes dans une Grid depuis votre workflow

L’étape Ajouter une/des ligne(s) dans Grid vous permet de créer de nouvelles lignes ou de mettre à jour des lignes existantes dans n’importe quel Grid depuis votre workflow. Utilisez cette étape lorsque vous devez écrire des données dans un autre Grid ou ajouter de nouvelles lignes au-delà de la ligne actuelle où s’exécute votre workflow.

{% hint style="info" %}
Si vous souhaitez associer les sorties du workflow aux colonnes de la même ligne où s’exécute votre workflow, vous n’avez pas besoin de cette étape. Utilisez une étape JSON à la fin de votre workflow et associez les sorties aux colonnes dans l’interface Grid.
{% endhint %}

## Comment configurer

### 1. Sélectionnez Grid et la feuille

Choisissez le Grid et la feuille cibles où vous souhaitez écrire des données. Les deux champs prennent en charge une sélection Statique ou Dynamique :

* **Statique**: Sélectionnez dans une liste déroulante des Grids/Sheets disponibles
* **Dynamique**: Référez-vous à une variable contenant l’ID du Grid ou de la feuille

### 2. Choisissez un type d’action

Sélectionnez l’un des quatre types d’action selon vos besoins :

| Type d’action                      | Description                                                                |
| ---------------------------------- | -------------------------------------------------------------------------- |
| **Ajouter une seule ligne**        | Créer une nouvelle ligne à partir d’un seul objet JSON                     |
| **Ajouter plusieurs lignes**       | Créer plusieurs nouvelles lignes à partir d’un tableau d’objets            |
| **Mettre à jour une seule ligne**  | Mettre à jour une ligne existante à l’aide de son `__id`                   |
| **Mettre à jour plusieurs lignes** | Mettre à jour plusieurs lignes existantes à l’aide de leurs `__id` valeurs |

### 3. Fournissez la variable de données

Sélectionnez une variable contenant les données de vos lignes :

**Pour les actions sur une seule ligne**, fournissez un objet :

```json
{
  "title": "Ultimate Guide to Link Building",
  "backlinks": "150"
}
```

**Pour les actions sur plusieurs lignes**, fournissez un tableau d’objets :

```json
[
  {
    "title": "Ultimate Guide to Link Building",
    "backlinks": "150"
  },
  {
    "title": "SEO Best Practices",
    "backlinks": "89"
  }
]
```

### 4. Associez les clés de l’objet aux colonnes du Grid

Utilisez l’interface de correspondance des colonnes pour relier vos clés JSON aux colonnes Grid existantes. Cliquez sur **Ajouter une correspondance de colonne** et indiquez :

* **Clé**: Le nom de la clé de votre objet JSON
* **Colonne**: La colonne cible dans votre Grid

### 5. Définissez le comportement en cas d’échec

Choisissez ce qui se passe si l’étape échoue :

* **Mettre fin au workflow**: Arrêter l’exécution du workflow
* **Continuer**: Passer à l’étape suivante malgré l’erreur

## Mise à jour des lignes existantes

Lors de l’utilisation de **Mettre à jour une seule ligne** ou **Mettre à jour plusieurs lignes**, vos données doivent inclure le `__id` champ pour identifier quelles lignes mettre à jour. Ce champ est automatiquement inclus lorsque vous lisez des lignes à l’aide de l’étape Lire depuis Grid.

### Exemple : Lire, modifier et mettre à jour

**Étape 1**: Utilisez Lire depuis Grid pour obtenir les lignes existantes avec leurs `__id` valeurs :

```json
[
  {
    "__id": "123",
    "title": "Blog Post Draft",
    "status": "Draft"
  },
  {
    "__id": "456",
    "title": "SEO Guide",
    "status": "In Review"
  }
]
```

**Étape 2**: Transformez les données dans une étape Code tout en préservant le `__id`:

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

**Étape 3**: Utilisez Ajouter une/des ligne(s) dans Grid avec **Mettre à jour plusieurs lignes** pour réécrire les modifications.

### Comportement de mise à jour

* Chaque objet doit inclure un `__id` qui correspond à une ligne existante
* Seules les colonnes que vous incluez seront mises à jour ; les autres colonnes resteront inchangées
* Les lignes dont les `__id` valeurs ne correspondent pas seront ignorées
* Vous n’avez pas besoin d’associer `__id` dans la section de correspondance des colonnes

## Quand utiliser cette étape

**Utilisez Ajouter une/des ligne(s) dans Grid lorsque :**

* Création de nouvelles lignes dans un Grid séparé
* Ajout de plusieurs lignes générées à partir d’une seule exécution du workflow
* Mise à jour des lignes existantes dans n’importe quel Grid

**Utilisez plutôt une étape JSON lorsque :**

* Association des sorties aux colonnes de la ligne Grid actuelle
* Organisation de plusieurs sorties dans un format structuré pour la même ligne


---

# 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/fr/actions/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.