excel_write_cell

Dokumente · macOS · Windows

Wirkung: Schreiben. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Schreibt einen Wert in eine bestimmte Zelle einer Excel-Datei. Numerisch aussehende Wertzeichenfolgen werden nur dann als Zahlen geschrieben, wenn sie sich exakt umwandeln lassen und zurückgewandelt identisch sind; andernfalls bleiben sie Text. Ein Wert, der mit `=` beginnt, wird als Formel geschrieben (z. B. "=SUM(B2:B3)") und beim Öffnen der Datei berechnet; beginnen Sie ihn mit einem Apostroph, um ihn als Text zu belassen. Eine Formel, die über die Datei hinausgreift oder Code ausführt (WEBSERVICE, IMAGE, HYPERLINK, STOCKHISTORY, TRANSLATE, COPILOT, PY, CUBE…, CALL, REGISTER, EXEC, IMPORT…, RTD, DDE oder ein `|` bzw. ein Verweis auf eine andere Arbeitsmappe über Name, Pfad oder URL, einschließlich eines Verweises, der als Text innerhalb von INDIRECT oder ADDRESS zusammengesetzt wird), wird abgelehnt und es wird nichts geschrieben. Adressieren Sie die Zelle entweder mit `cell` in A1-Notation (z. B. "B2") oder mit `row`+`column` als 1-basierte ganze Zahlen.

Erforderliche Eingaben

path
value

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für excel_write_cell. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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

Windows