excel_create

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

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

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

macOS

Назначение

Создаёт новую таблицу Excel (файл .xlsx) с заголовками и необязательными строками данных. Числа JSON (целые и десятичные) записываются как числа, поэтому SUM() и диаграммы с ними работают; строки JSON всегда остаются текстом, даже если выглядят как числа ("007", "1e3" или " 42"), как и целые значения длиннее 10 цифр, потому что это идентификаторы вроде CUIT, CBU или номера телефона, а не количества. Логические значения JSON записываются как логические ячейки. Строка, начинающаяся с "=", записывается как текст, а не как формула — чтобы поместить формулу в ячейку, используйте excel_write_cell.

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

path
headers

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

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

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

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

Каноническая техническая схема на английском — macOS

{
  "properties": {
    "confirm": {
      "description": "Must be true to create",
      "type": "boolean"
    },
    "headers": {
      "description": "Column headers",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "overwrite": {
      "description": "Required (with confirm) to REPLACE a file that already exists at path. Without it an existing file is never touched.",
      "type": "boolean"
    },
    "path": {
      "description": "Output path for the .xlsx file",
      "type": "string"
    },
    "rows": {
      "description": "Array of ROW ARRAYS — each row is itself an array of cell values (optional)",
      "items": {
        "description": "One row: the cell values, in column order",
        "items": {
          "type": [
            "string",
            "number",
            "boolean",
            "null"
          ]
        },
        "type": "array"
      },
      "type": "array"
    }
  },
  "required": [
    "path",
    "headers"
  ],
  "type": "object"
}

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

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

{
  "confirm": false,
  "headers": [
    "Task",
    "Owner"
  ],
  "path": "/Users/demo/Documents/launch-checklist.xlsx"
}

Windows

Назначение

Создает новый файл Excel (.xlsx) с заголовками и необязательными строками данных. Существующий файл по пути path заменяется только при overwrite=true.

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

path
headers

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

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

Каноническая техническая схема на английском — Windows

{
  "properties": {
    "confirm": {
      "description": "Must be true to create the file",
      "type": "boolean"
    },
    "headers": {
      "description": "Column headers",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "overwrite": {
      "description": "Required (true) to REPLACE a file that already exists at path. Without it an existing file is refused, never replaced.",
      "type": "boolean"
    },
    "path": {
      "description": "Absolute path for the new .xlsx file",
      "type": "string"
    },
    "rows": {
      "description": "Data rows (array of arrays)",
      "items": {
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "type": "array"
    }
  },
  "required": [
    "path",
    "headers"
  ],
  "type": "object"
}

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

{
  "confirm": false,
  "headers": [
    "Task",
    "Owner"
  ],
  "path": "C:\\Users\\demo\\Documents\\launch-checklist.xlsx"
}