excel_create

Documentos · macOS · Windows

Efeito: escrita. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Cria uma nova planilha do Excel (arquivo .xlsx) com cabeçalhos e linhas de dados opcionais. Os números JSON (inteiros e decimais) são gravados como números, para que SUM() e gráficos funcionem com eles; as strings JSON sempre continuam texto, mesmo quando parecem numéricas ("007", "1e3" ou " 42"), assim como os valores inteiros com mais de 10 dígitos, porque são identificadores como um CUIT, um CBU ou um número de telefone, e não quantidades. Os booleanos JSON são gravados como células booleanas. Uma string que começa com "=" é gravada como texto, não como fórmula — use excel_write_cell para colocar uma fórmula em uma célula.

Entradas obrigatórias

path
headers

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

Esquema técnico canónico em inglês — 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"
}

Exemplo documental

Exemplo de documentação para excel_create. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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

Windows