本文へスキップ
すべてのツール

excel_read

書類 · macOS · Windows

効果: 読み取り. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

Excel スプレッドシート(.xlsx ファイル)からデータを読み取ります。最初の行を `headers`、残りのデータ行を `rows` として返します。これは excel_create の `headers`/`rows` パラメータに対応するため、読み取りから作成への往復で行 0 を手動処理する必要がありません。

必須入力

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

英語の正規技術スキーマ — macOS
{
  "properties": {
    "force_download": {
      "description": "If the file is stored in the cloud and evicted from this Mac (dataless), request the download and wait for it instead of failing. Off by default: a download can take minutes and use metered data, so it is the caller's decision.",
      "type": "boolean"
    },
    "max_rows": {
      "description": "Max DATA rows to return, not counting the header row, which always comes back as `headers` (default 100)",
      "type": "integer"
    },
    "path": {
      "description": "Absolute path to the .xlsx file",
      "type": "string"
    },
    "sheet_name": {
      "description": "Sheet name to read (optional, reads 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"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

ドキュメント例

excel_read のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{
  "path": "/Users/demo/Documents/launch-checklist.xlsx"
}

Windows

目的

Excel(.xlsx)ファイルからデータを読み取ります。シートとセルの値を返します。

必須入力

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

英語の正規技術スキーマ — Windows
{
  "properties": {
    "force_download": {
      "description": "For a cloud placeholder (OneDrive online-only) bigger than 25 MB: download it and wait up to 60 s. Smaller ones are downloaded on their own.",
      "type": "boolean"
    },
    "max_rows": {
      "description": "Maximum rows to return (default: 100)",
      "type": "number"
    },
    "path": {
      "description": "Absolute path to the .xlsx file",
      "type": "string"
    },
    "sheet_name": {
      "description": "Name of the sheet to read (default: first sheet)",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

ドキュメント例

excel_read のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{
  "path": "C:\\Users\\demo\\Documents\\launch-checklist.xlsx"
}