翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Excel
<a name="actions-excel"></a>

Excel アクションを使用すると、オートメーションで Excel ファイルの読み取り、更新、作成を行うことができます。すべての Excel アクションは、.xlsx ファイル形式と .xlsm ファイル形式の両方をサポートしています。ワークブック識別子は、複数のオペレーションにわたって参照を維持します。

**注記**  
値は .xlsm ファイルから読み取ることができますが、マクロ実行はサポートされていません。

## 新しいワークブックを作成する
<a name="create-new-workbook"></a>

空白の Excel ファイルを作成します。以降のステップでスプレッドシートを更新するために使用できるワークブック識別子を出力します。

**プロパティ:**
+ **ワークブック識別子** (出力): 今後のアクションのワークブック参照を保存する変数名 (デフォルト: `workbook_id`)

## 既存のワークブックを開く
<a name="open-existing-workbook"></a>

既存の Excel ファイルをロードします。後続のステップでスプレッドシートを更新するために使用できるワークブック識別子を返します。Excel (.xlsx) ファイルのみをサポートします。

**プロパティ:**
+ **Excel ファイル** (必須): 開く .xlsx ファイル。通常は変数に保存されます (例: `my_file`)。
+ **ワークブック識別子** (出力): ワークブックリファレンスを保存する変数名 (デフォルト: `workbook_id`)

**ファイルの要件:**
+ 有効な Excel (.xlsx) ファイルである必要があります
+ ファイルはメディアファイルオブジェクトとしてアクセス可能である必要があります

## ワークブックを保存する
<a name="save-workbook"></a>

Excel ファイルに更新を保存します。保存したワークブックのファイル名とファイルタイプを更新できます。

**プロパティ:**
+ **ファイル名** (必須): 拡張子のない保存済みファイルの名前 (「月別レポート」など)
+ **ファイルタイプ** (ドロップダウン): 出力形式 - 現在 XLSX (デフォルト: XLSX) をサポート
+ **保存済みファイル** (出力): 保存済みファイルオブジェクトを保存する変数 (デフォルト: `saved_file`)

## シートの読み取り
<a name="read-sheet"></a>

セルの範囲からデータを取得します。アクションは、出力をデータテーブル変数に保存します。

**プロパティ:**
+ **ワークブック識別子** (必須): 読み取り元のワークブック (例: `workbook_id`)
+ **シート名** (必須): ワークシートまたはタブ名 (デフォルト: "Sheet1")
+ **セル範囲** (オプション): 範囲仕様 - 複数の形式をサポートしています。
  + 開始セル: "A2" (アンカーポイントからすべてのデータを読み取ります)
  + 正確な範囲: "A1:B10"
  + 列範囲: "A:B"
  + 行範囲: "1:3"
  + 空: シート全体を読み取ります
+ **ヘッダーを含める** (チェックボックス): 有効にすると、最初の行を列ヘッダーとして扱います。無効にすると、デフォルトの命名 (Column0、Column1 など) が使用されます (デフォルト: TRUE)
+ **データテーブル** (出力): 抽出されたデータを保存する変数 (デフォルト: `excel_table`)

**計算式の処理:**
+ アクションは数式を自動的に計算し、結果をデータテーブルに保存します。

## セルの読み取り
<a name="read-cell"></a>

セルから値を取得します。ワークシートから個々のセル値を読み取るために使用されます。

**プロパティ:**
+ **ワークブック識別子** (必須): 読み取るワークブック (例: `workbook_id`)
+ **シート名** (必須): ワークシート名 (デフォルト: "Sheet1")
+ **セルリファレンス** (必須): セルの場所 (例：「A1」)
+ **セル値** (出力): セルコンテンツを保存する変数 (デフォルト: `cell_value`)

## シートへの書き込み
<a name="write-to-sheet"></a>

データテーブルをシートに出力します。ワークシートに行と列の範囲を書き込むために使用されます。

**プロパティ:**
+ **データテーブル** (必須): 書き込むデータテーブル (例: `my_table`)
+ **ワークブック識別子** (必須): ターゲットワークブック (例: `workbook_id`)
+ **シート名** (必須): ターゲットワークシート (デフォルト: "Sheet1")
+ **セルで開始** (オプション): データ配置の開始位置 (デフォルト: "A1")
+ **ヘッダーを含める** (チェックボックス): 有効にすると列ヘッダーを書き込みます (デフォルト: TRUE)

## セルへの書き込み
<a name="write-to-cell"></a>

値をセルに出力します。ワークシート内の個々のセルを更新するために使用されます。

**プロパティ:**
+ **書き込む値** (必須): セルのコンテンツ (「Order \$112345」など)
+ **ワークブック識別子** (必須): ターゲットワークブック (例: `workbook_id`)
+ **シート名** (必須): ターゲットワークシート (デフォルト: "Sheet1")
+ **セルリファレンス** (必須): ターゲットセルの場所 (「A1」など)

## 新しい行の書き込み
<a name="write-new-row"></a>

シートにデータの行を追加します。新しい行は、既存のデータの末尾に追加されます。

**プロパティ:**
+ **行値** (必須): 最初の列から始まる新しい行の値の配列 (例: ["Q1"、"Sales"、100])
+ **ワークブック識別子** (必須): ターゲットワークブック (例: `workbook_id`)
+ **シート名** (必須): ターゲットワークシート (デフォルト: "Sheet1")

**データ検証:**
+ 値を配列形式で指定する必要があります
+ 値は最初の列から順番に書き込まれます

## 新しいシートを作成する
<a name="create-new-sheet"></a>

空白のワークシートを追加します。新しいシートがワークブックの最後に追加されます。

**プロパティ:**
+ **ワークブック識別子** (必須): ターゲットワークブック (例: `workbook_id`)
+ **シート名** (必須): 新しいワークシートの名前 (「売上データ」など)

## シートのコピー
<a name="copy-sheet"></a>

ワークシートのコピーを作成します。新しいシートは同じワークブック内に作成されます。

**プロパティ:**
+ **ワークブック識別子** (必須): ターゲットワークブック (例: `workbook_id`)
+ **コピーするシート名** (必須): ソースワークシート名 (「元のシート」など)
+ **新しいシート名** (必須): 複製されたシートの名前 (「元のシート (コピー）」など)

## シートの名前変更
<a name="rename-sheet"></a>

既存のワークシートの名前を更新します。

**プロパティ:**
+ **ワークブック識別子** (必須): ターゲットワークブック (例: `workbook_id`)
+ **現在のシート名** (必須): 既存のワークシート名 (「Sheet1」など)
+ **更新されたシート名** (必須): ワークシートの新しい名前 (「Q1 データ」など)

## シートの削除
<a name="delete-sheet"></a>

ワークブックからシートを削除します。ワークブックの最後の残りのシートは削除できません。

**プロパティ:**
+ **ワークブック識別子** (必須): ターゲットワークブック (例: `workbook_id`)
+ **削除するシート名** (必須): 削除するワークシート (「Sheet1」など)

**制約**:
+ ワークブックの最後の残りのシートは削除できません

## セルの色を設定する
<a name="set-cell-color"></a>

セルの背景色を更新します。特定の範囲のセルを強調表示するために使用されます。

**プロパティ:**
+ **セルの色** (必須): RGB 16 進コード形式 (赤の場合はFF0000」など)
+ **ワークブック識別子** (必須): ターゲットワークブック (例: `workbook_id`)
+ **シート名** (必須): ターゲットワークシート (「Sheet1」など)
+ **セル範囲** (必須): フォーマットする範囲 - サポート対象:
  + 単一セル：「A1」
  + 正確な範囲: "A1:B10"
  + 列範囲：「A:B」
  + 行範囲: "1:3"

## セルの色を取得する
<a name="get-cell-color"></a>

セルの背景色を読み取ります。RGB 16 進コード形式 (赤の場合はFF0000」など) で色を出力します。

**プロパティ:**
+ **ワークブック識別子** (必須): ソースワークブック (例: `workbook_id`)
+ **シート名** (必須): ソースワークシート (「Sheet1」など)
+ **セルリファレンス** (必須): 読み取るセル (例：「A1」)
+ **セルの色** (出力): RGB 16 進コードを保存する変数 (デフォルト: `cell_color`)

## 行を非表示にする
<a name="hide-rows"></a>

シートで行を非表示にします。データはそのまま残りますが、表示されません。

**プロパティ:**
+ **ワークブック識別子** (必須): ターゲットワークブック (例: `workbook_id`)
+ **シート名** (必須): ターゲットワークシート (「Sheet1」など)
+ **行の開始** (必須): 非表示にする最初の行番号 (Excel の番号付けは 1 から始まります)
+ **行の終了** (オプション): 非表示にする最後の行番号。空の場合、開始行のみが非表示になります

**行の番号付け:**
+ Excel の行番号は 1 から始まります (0 ではありません)
+ 整数値を指定する必要があります

## 行の非表示解除
<a name="unhide-rows"></a>

非表示の行を表示します。以前に非表示になった行を表示するために使用されます。

**プロパティ:**
+ **ワークブック識別子** (必須): ターゲットワークブック (例: `workbook_id`)
+ **シート名** (必須): ターゲットワークシート (「Sheet1」など)
+ **行の開始** (必須): 非表示にする最初の行番号 (Excel の番号付けは 1 から始まります)
+ **行の終了** (オプション): 非表示にする最後の行番号。空の場合、開始行のみが表示されます

## ベストプラクティスと制限事項
<a name="excel-best-practices-limitations"></a>

### ワークブック識別子の管理
<a name="excel-workbook-identifier-management"></a>
+ ワークブック識別子を記述変数 (例: 、`report_file`) `sales_workbook`に保存する
+ 同じワークブックの複数のアクションで同じ識別子を再利用する
+ データオペレーションを実行する前に、必ずワークブックを作成または開く

### 範囲の仕様
<a name="excel-range-specifications"></a>
+ 正確なデータオペレーションに正確な範囲 (「A1:B10」) を使用する
+ 列全体を操作するときは、列範囲 (「A:B」) を使用します。
+ ヘッダーまたはサマリーオペレーションに行範囲 (「1:3」) を使用する
+ シート全体を処理するには、範囲を空のままにします

### パフォーマンスの最適化
<a name="excel-performance-optimization"></a>
+ 個々のセルではなく、可能な場合は範囲全体を読み取ります
+ 個々のセル書き込みではなくデータテーブルを使用したバッチ書き込みオペレーション
+ すべての変更が完了した場合にのみワークブックを保存する

### 制限
<a name="excel-limitation"></a>

ファイルの互換性は最新の Excel (.xlsx) 形式のみに制限されています。レガシー Excel (.xls) ファイルはサポートされていません。