excel_create

書類 · macOS · Windows

効果: 書き込み. 状態: 条件付き提供.

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

macOS

目的

ヘッダーと任意のデータ行を持つ新しい Excel スプレッドシート（.xlsx ファイル）を作成します。JSON の数値（整数と小数）は数値として書き込まれるため、SUM() やグラフが使えます。JSON の文字列は、数値のように見えても（"007"、"1e3"、" 42"）常にテキストのままです。10 桁を超える整数値も、数量ではなく CUIT、CBU、電話番号のような識別子であるため、テキストのままです。JSON のブール値はブールセルとして書き込まれます。"=" で始まる文字列は、数式ではなくテキストとして書き込まれます。セルに数式を入れるには excel_write_cell を使ってください。

必須入力

path
headers

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

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — 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）ファイルを作成します。path に既存のファイルがある場合は、overwrite=true を指定したときにのみ置き換えられます。

必須入力

path
headers

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

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — 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"
}

ドキュメント例

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