Todas as ferramentas

excel_write_cell

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

Grava um valor em um cell específico em um arquivo Excel. Sequências de valores com aparência numérica são escritas como números somente quando fazem uma viagem de ida e volta exata; caso contrário, eles permanecerão como texto. Endereçar o cell com `cell` na notação A1 (por exemplo, "B2") ou com `row`+`column` como números inteiros baseados em 1.

Entradas obrigatórias

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.

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

Exemplo documental

Exemplo de documentação para excel_write_cell. 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.

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

Windows

Finalidade

Grava um valor em uma célula específica em um arquivo Excel existente.

Entradas obrigatórias

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.

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

Exemplo documental

Exemplo de documentação para excel_write_cell. 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.

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