excel_write_cell

Документы · macOS · Windows

Эффект: запись. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Записывает значение в указанную ячейку Excel. Строки, похожие на числа, становятся числами только при точном обратном преобразовании, иначе остаются текстом. Ячейка задается через `cell` в формате A1, например "B2", либо через `row`+`column` как целые числа от 1.

Обязательные входные данные

path
value

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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)",
      "type": "string"
    },
    "value": {
      "description": "Value to write",
      "type": "string"
    }
  },
  "required": [
    "path",
    "value"
  ],
  "type": "object"
}

Пример для документации

Пример документации для excel_write_cell. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

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

Windows

Назначение

Записывает значение в указанную ячейку существующего файла Excel.

Обязательные входные данные

path
value

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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"
}

Пример для документации

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