Tableur

Effectue des operations CRUD sur les tableurs du workspace : lire des lignes, ecrire des donnees, supprimer ou interroger avec des filtres.

Parametres communs

Parametre	Type	Requis	Variable	Description
`operation`	choix (`read`, `write`, `delete`, `query`)	Oui	Non	Type d'operation a effectuer sur le tableur.
`spreadsheetId`	valeur dynamique	Oui	Oui	Identifiant du tableur cible. Selectionnable via le selecteur ou via une variable.
`tabId`	valeur dynamique	Non	Oui	Identifiant de l'onglet pour les tableurs lies a une source. Par defaut : premier onglet.
`outputVariable`	texte	Non	Non	Nom de la variable de sortie pour referencer les resultats dans les blocs suivants.

Les parametres marques Variable = Oui acceptent la syntaxe {{nomBloc.champ}}.

Recuperer des lignes du tableur avec filtres, tri et pagination.

Parametre	Type	Requis	Variable	Description
`filters`	liste	Non	Non	Conditions de filtrage (colonne, operateur, valeur). Operateurs : =, !=, >, <, >=, <=, contient, dans, est vide, n'est pas vide.
`columns`	liste	Non	Non	Colonnes specifiques a retourner. Vide = toutes les colonnes.
`sortBy`	texte	Non	Non	Nom de la colonne pour le tri des resultats.
`sortOrder`	choix (`asc`, `desc`)	Non	Non	Ordre de tri : croissant (A-Z, 0-9) ou decroissant (Z-A, 9-0). (Defaut: `"asc"`)
`limit`	nombre	Non	Non	Nombre maximum de lignes a retourner. (min 1)
`offset`	nombre	Non	Non	Nombre de lignes a ignorer (pagination). (Defaut: `0`, min 0)
`includeMetadata`	oui/non	Non	Non	Inclure les metadonnees des lignes (identifiant, dates de creation/modification). (Defaut: `false`)

Inserer ou mettre a jour des lignes dans le tableur.

Parametre	Type	Requis	Variable	Description
`writeMode`	choix (`insert`, `upsert`)	Non	Non	Mode d'ecriture : insert (nouvelles lignes) ou upsert (insere ou met a jour selon row_id). (Defaut: `"insert"`)
`rows`	valeur dynamique	Oui	Oui	Lignes a ecrire. Variable contenant un tableau d'objets (une cle par colonne).
`columnMapping`	liste	Non	Non	Correspondance entre champs source et colonnes du tableur (sourceField → targetColumn).
`validateTypes`	oui/non	Non	Non	Valider les types de donnees avant l'ecriture. (Defaut: `false`)
`triggerEmbedding`	oui/non	Non	Non	Declencher l'indexation RAG (embeddings) apres l'ecriture. (Defaut: `false`)

Les parametres marques Variable = Oui acceptent la syntaxe {{nomBloc.champ}}.

Supprimer des lignes du tableur par filtres ou par identifiants.

Parametre	Type	Requis	Variable	Description
`deleteMode`	choix (`by_filters`, `by_row_ids`)	Oui	Non	Mode de suppression : par conditions de filtrage ou par identifiants de ligne. (Defaut: `"by_filters"`)
`deleteFilters`	liste	Non	Non	Conditions de filtrage pour identifier les lignes a supprimer (mode by_filters).
`deleteRowIds`	valeur dynamique	Non	Oui	Variable contenant la liste des identifiants de lignes a supprimer (mode by_row_ids).
`includeDeletedIds`	oui/non	Non	Non	Inclure la liste des identifiants supprimes dans le resultat. (Defaut: `false`)

Les parametres marques Variable = Oui acceptent la syntaxe {{nomBloc.champ}}.

Executer une requete en langage naturel sur le tableur.

Parametre	Type	Requis	Variable	Description
`query`	valeur dynamique	Oui	Oui	Requete en langage naturel (ex: `Quels clients ont un CA > 10000 ?`).

Les parametres marques Variable = Oui acceptent la syntaxe {{nomBloc.champ}}.

Variable de sortie : spreadsheetResult

{
  "success": false,
  "rows": [],
  "total": 0,
  "has_more": false
}

Lire les donnees d'un tableur.

Entree :

{"operation": "read", "spreadsheetId": "sp-123"}

Sortie :

{"rows": [{"col1": "A", "col2": 42}], "count": 1}

Astuce

Operations : read, write, delete, query. Utilisez query avec des filtres pour des lectures conditionnelles.