メインコンテンツへスキップ
Excelツールは、Excelファイル(.xlsx)を操作するための包括的な機能を提供します。配列データからの新規ファイル作成、データの読み取り、セルの更新、特定の行の取得、埋め込み画像の抽出、URLからのExcelファイルの操作が可能です。
  • EXCEL_CREATE
    • 2次元配列から新しいExcelファイルを作成し、ダウンロード用URLを返す
  • EXCEL_GET_ROWS
    • Excelシートから複数の行を2次元配列として取得(range で範囲指定も可能。例: “A1:C10”)
  • EXCEL_GET_ROW
    • range(例: “A5:C5”)で指定した1行を取得
  • EXCEL_GET_CELL_WITH_COORDINATE
    • 開始セルと終了セルで指定した範囲から、座標付きでセルの値を取得
  • EXCEL_GET_IMAGES
    • Excelファイルに埋め込まれた画像を、シート名やセル範囲の情報付きで抽出
  • EXCEL_UPDATE
    • 範囲選択を使用してExcelファイルを新しいデータで更新
  • EXCEL_UPDATE_BY_COORDINATE
    • 座標ベースの配置を使用して特定のセルを更新
認証は不要です。ExcelツールはファイルURLで直接動作します。

Excelファイルを作成する

結果として、作成されたExcelファイルのダウンロード用URLが返されます。

行・セル・画像を読み取る

EXCEL_GET_ROWS はセルの値を2次元配列として result に返し、EXCEL_GET_ROW は1行分を配列として返します。EXCEL_GET_CELL_WITH_COORDINATE は、startCell から endCell までの範囲内の各セルについて {coordinate, content} オブジェクトの配列を返します。 EXCEL_GET_IMAGES は、抽出した各画像の URL、拡張子、MIME タイプ、シート名、画像が配置されているセル範囲と、抽出した画像の総数を返します。ブックのサイズは 30 MiB まで、展開後のサイズは 256 MiB までです。これを超えるブックや破損したブックでは、画像の代わりに ExcelTooLargeError エラーが返ります。

セルを更新する

calculate_total はフロー内の前段のステップを表します。その結果の sum に計算済みの合計値が入っている想定です。

例: Excelデータ処理ワークフロー

ヒントとベストプラクティス

  • 間違ったシートで作業しないよう、常にシート名を指定する
  • 正確なセル参照にはA1、B2などの座標記法を使用する
  • 範囲を更新する際は、データ配列の次元が指定された範囲と一致することを確認する
  • 大きなデータセットの場合、タイムアウトを避けるためにデータをチャンクで処理することを検討する
  • エラーを防ぐため、Excelファイルを更新する前にデータ形式を検証する

注意事項

  • 1 回の読み取りで扱えるのは最大 1,000,000 セルです。EXCEL_GET_ROWS と EXCEL_GET_ROW の range、および EXCEL_GET_CELL_WITH_COORDINATE の startCell〜endCell の矩形に適用されます。A1:ALL1000(1,000 行 × 1,000 列)は読み取れますが、それより大きい矩形(A1:XFD1048576 のようなシート全体の範囲を含む)は、範囲と上限を示すエラーになります。範囲を狭めるか、複数ステップに分けて読み取ってください。
  • セル範囲として解釈できない range(EXCEL_GET_CELL_WITH_COORDINATE の startCell / endCell も同様。例: not-a-range)は、空の結果を返す代わりに Invalid cell range エラーになります。
  • range を省略した EXCEL_GET_ROWS は、シート自身の寸法が上限内であればそのまま読み取るため、通常のファイルでは出力は変わりません。シートが実際のセルより大きな寸法を宣言している場合は、セルが存在する矩形だけを読み取ります。セルだけで上限を超えるシートは、range を明示して読み取ってください。
  • EXCEL_GET_ROWS、EXCEL_GET_ROW、EXCEL_GET_CELL_WITH_COORDINATE、EXCEL_UPDATE、EXCEL_UPDATE_BY_COORDINATE は、解析前に .xlsx コンテナを検査し、展開するとサイズに対して極端に大きくなるファイル(エントリ数 10,000 超、1 エントリ 256 MiB 超または合計 1 GiB 超、または展開後 8 MiB を超える場合に圧縮サイズの 200 倍超)をエラーで拒否します。EXCEL_UPDATE と EXCEL_UPDATE_BY_COORDINATE はさらに、正規のワークブックでないファイル(パスワード保護・暗号化されたファイルや破損したアーカイブを含む)も拒否します。読み取り 3 ツールはこの検査を ZIP 形式の入力にのみ適用し、それ以外の形式はパーサーに委ねます。EXCEL_GET_IMAGES には上記のとおり独自の上限があります。