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 uma célula específica de um arquivo do Excel. Strings de valor com aparência numérica são gravadas como números somente quando fazem a conversão de ida e volta exatamente; caso contrário, permanecem como texto. Um valor que começa com `=` é gravado como fórmula (por exemplo, "=SUM(B2:B3)") e calculado quando o arquivo é aberto; comece-o com um apóstrofo para mantê-lo como texto. Uma fórmula que acessa algo fora do arquivo ou executa código (WEBSERVICE, IMAGE, HYPERLINK, STOCKHISTORY, TRANSLATE, COPILOT, PY, CUBE…, CALL, REGISTER, EXEC, IMPORT…, RTD, DDE ou um `|`, ou uma referência a outra pasta de trabalho por nome, caminho ou URL, incluindo uma montada como texto dentro de INDIRECT ou ADDRESS) é recusada e nada é gravado. Enderece a célula com `cell` em notação A1 (por exemplo, "B2") ou com `row`+`column` como inteiros baseados em 1.

Entradas obrigatórias

path
value

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": {
    "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). Matched without case. A name that no sheet has is an error listing the available ones — it never falls back to the 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