跳到正文
所有工具

excel_create

文档 · macOS · Windows

效果: 写入. 状态: 受限可用.

“受限可用”表示工具可能取决于版本、平台、权限、账户或配置,并不表示它在所有安装中都已启用。

macOS

用途

创建一个带有表头和可选数据行的新 Excel 电子表格(.xlsx 文件)。JSON 数字(整数和小数)会写成数字,因此 SUM() 和图表可以对它们起作用;JSON 字符串始终保持为文本,即使看起来像数字("007"、"1e3" 或 " 42"),超过 10 位的整数值也是如此,因为它们是 CUIT、CBU 或电话号码之类的标识符,而不是数量。JSON 布尔值会写成布尔单元格。以 "=" 开头的字符串会写成文本,而不是公式——请使用 excel_write_cell 在单元格中放入公式。

必填输入

输入名称会严格保持工具要求的形式。下方可展开的架构中保留英文规范技术定义。

权限与确认

架构声明了明确的确认参数。请检查预览,并按此平台的契约授权实际操作。

英文规范技术架构 — 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)文件,包含表头和可选的数据行。只有在 overwrite=true 时才会替换 path 处的现有文件。

必填输入

输入名称会严格保持工具要求的形式。下方可展开的架构中保留英文规范技术定义。

权限与确认

架构声明了明确的确认参数。请检查预览,并按此平台的契约授权实际操作。

英文规范技术架构 — 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"
}

文档示例

excel_create 的文档示例。请勿执行此示例。所示参数属于虚构数据集;在实际调用前,请解析真实标识符并获得授权。

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