create_column
Add a new column to a Grist table, specifying its type, label, and optional formula or choices for data entry.
Instructions
Crée une nouvelle colonne dans une table.
Prérequis: - list_tables: Pour obtenir un table_id valide
Flux de travail typique: 1. list_tables(doc_id) → obtenir table_id 2. create_column(doc_id, table_id, "col_name", "Text", "Nom") → créer la colonne 3. list_columns(doc_id, table_id) → vérifier la création
Args: doc_id: L'ID du document table_id: L'ID de la table column_id: ID de la nouvelle colonne (doit être unique dans la table) column_type: Type de données. Types supportés: - Text, Numeric, Int, Bool, Date, DateTime - Choice, ChoiceList (avec paramètre choices) - Ref:TableId, RefList:TableId (références) - Attachments label: Libellé d'affichage de la colonne (optionnel) formula: Formule Python pour colonnes calculées (optionnel) widget_options: Options d'affichage comme dict (optionnel) visible_col: colRef de la colonne à afficher pour les Ref (optionnel) untie_col_id_from_label: Dissocier l'ID du label (défaut: True) description: Description de la colonne (optionnel) choices: Liste de choix pour Choice/ChoiceList (optionnel)
Returns: Dict avec statut, message et détails de la colonne créée
Examples: # Colonne texte simple create_column(doc_id, "Table1", "name", "Text", label="Nom")
# Colonne choix
create_column(doc_id, "Table1", "status", "Choice",
choices=["Actif", "Inactif", "En attente"])
# Colonne référence
create_column(doc_id, "Table1", "owner", "Ref:Users",
label="Propriétaire", visible_col=5)
# Colonne calculée
create_column(doc_id, "Table1", "full_name", "Text",
formula="$first_name + ' ' + $last_name")Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | No | ||
| doc_id | Yes | ||
| choices | No | ||
| formula | No | ||
| table_id | Yes | ||
| column_id | Yes | ||
| column_type | No | Text | |
| description | No | ||
| visible_col | No | ||
| widget_options | No | ||
| untie_col_id_from_label | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||