Vai al contenuto
Tutti gli strumenti

excel_write_cell

Documenti · macOS · Windows

Effetto: scrittura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Scrive un valore in una cella specifica di un file Excel. Le stringhe di valore che sembrano numeri vengono scritte come numeri solo se tornano identiche dopo la conversione; altrimenti restano testo. Un valore che inizia con `=` viene scritto come formula (ad es. "=SUM(B2:B3)"), calcolata all'apertura del file; fallo iniziare con un apostrofo per mantenerlo come testo. Una formula che esce dal file o esegue codice (WEBSERVICE, IMAGE, HYPERLINK, STOCKHISTORY, TRANSLATE, COPILOT, PY, CUBE…, CALL, REGISTER, EXEC, IMPORT…, RTD, DDE o un `|`, oppure un riferimento a un'altra cartella di lavoro per nome, percorso o URL, compreso uno costruito come testo all'interno di INDIRECT o ADDRESS) viene rifiutata e non viene scritto nulla. Indirizza la cella con `cell` in notazione A1 (ad es. "B2") oppure con `row`+`column` come interi a partire da 1.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — macOS
{
  "properties": {
    "cell": {
      "description": "Cell in A1 notation, e.g. \"B2\" (alternative to row+column)",
      "type": "string"
    },
    "column": {
      "description": "Column number (1-based) — use with `row`, or use `cell` instead",
      "type": "integer"
    },
    "confirm": {
      "description": "Must be true to modify",
      "type": "boolean"
    },
    "path": {
      "description": "Path to the .xlsx file",
      "type": "string"
    },
    "row": {
      "description": "Row number (1-based) — use with `column`, or use `cell` instead",
      "type": "integer"
    },
    "sheet_name": {
      "description": "Sheet name (default: first sheet). Matched without case. A name that no sheet has is an error listing the available ones — it never falls back to the first sheet.",
      "type": "string"
    },
    "value": {
      "description": "Value to write",
      "type": "string"
    }
  },
  "required": [
    "path",
    "value"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per excel_write_cell. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

{
  "cell": "B2",
  "confirm": false,
  "path": "/Users/demo/Documents/launch-checklist.xlsx",
  "value": "Reviewed"
}

Windows

Scopo

Scrive un valore in una cella specifica in un file Excel esistente.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — Windows
{
  "properties": {
    "cell": {
      "description": "Cell reference (e.g., B2) — alternative to row+column",
      "type": "string"
    },
    "column": {
      "description": "Column number (1-based) — use with `row`, alias for `cell`. The name the cloud catalog (Mac) advertises.",
      "type": "integer"
    },
    "confirm": {
      "description": "Must be true to write",
      "type": "boolean"
    },
    "path": {
      "description": "Path to .xlsx file",
      "type": "string"
    },
    "row": {
      "description": "Row number (1-based) — use with `column`, alias for `cell`",
      "type": "integer"
    },
    "sheet_name": {
      "description": "Name of the sheet to write to (default: first sheet). The name the cloud catalog (Mac) advertises.",
      "type": "string"
    },
    "value": {
      "description": "Value to write",
      "type": "string"
    }
  },
  "required": [
    "path",
    "value"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per excel_write_cell. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

{
  "cell": "B2",
  "confirm": false,
  "path": "C:\\Users\\demo\\Documents\\launch-checklist.xlsx",
  "value": "Reviewed"
}