Officeスクリプトでできるfor文の繰り返し処理｜基本から応用まで

「Officeスクリプトで繰り返し処理はどうやってしたらいいの？？」
このような悩みを持ったことはありませんか？

・繰り返し処理をしてみたいけど、どのようにしたらいいの？

・大量のデータに対して同じ操作を効率的に適用したい！

その場合は、Officeスクリプトの「for文」を
使用すると解決します！

この記事では、Officeスクリプトの「for文」を使用した繰り返し処理の方法について解説します。

Excelで大量のデータや複数のセルに対して同じ操作を繰り返し行いたい場合、繰り返し処理（ループ処理）を使うと非常に便利です。
Officeスクリプトの「for文」を使用することで、指定した範囲内のセルに対して繰り返し処理を適用できます。

サンプルコードを交えて、実際にどのように利用するかを具体的に学んでいきましょう。

【　この記事の概要　】

この記事を読むと「できるようになる」こと

この記事を読むことで、次のことができるようになります。

Officeスクリプト for文でできる処理例｜繰り返し処理の活用法

Officeスクリプトのfor文を活用することで、「Excel上の大量のデータ」や「複数のセルに対する処理」を効率的に自動化できます。

for文を使うことで、次のようなさまざまな処理が実現できます。

以下に、for文で行える代表的な処理内容を紹介します。

繰り返し処理で出来ること

for文を使うと、このようなExcel上での繰り返し処理が手軽にできるようになり、特定の範囲や条件に応じた自動化が実現します。

Officeスクリプトの繰り返し処理の種類をご紹介

Officeスクリプトでは、繰り返し処理を行うためのさまざまな方法が用意されています。

その中でも「for文」は、決められた回数だけ処理を繰り返す際にとても便利です。
for文を理解しておくことで、Excel上で大量のデータを簡単に操作できるようになります。

以下に、Officeスクリプトで使える繰り返し処理の種類と、その特徴をまとめました。
それぞれのループの特徴を知っておくと、シーンに合わせて最適なループを選べるようになります。

Officeスクリプトの繰り返し処理の種類

Officeスクリプトのfor文の基本構文と流れ

for文の構成と設定方法

for文の簡単な宣言例

以下は、基本のfor文を使った繰り返し処理の簡単な例です。

// A1からA10に1～10の数値を入力するfor文
function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();

  // 0から9までのカウンター変数iを使ってループを実行
  for (let i: number = 0; i < 10; i++) {
    sheet.getRange(`A${i + 1}`).setValue(i + 1);  // A1からA10に1, 2, 3...の数値を入力
  }
}

この構文を使えば、Excelシート上で簡単に繰り返し処理が実行できるようになります。

Officeスクリプトのfor文｜インクリメント・デクリメント演算子の使い方

for文では、カウンターの数値を「1」ずつ増減させるために「インクリメント演算子」(i++)や「デクリメント演算子」(i--)を使用します。

この演算子を使うことで、カウンターを効率的に操作でき、繰り返し処理を簡単に行うことができます。

インクリメント演算子 (i++)｜1ずつ増加する方法

「i++」は「インクリメント演算子」と呼ばれ、変数「i」の値を「1」ずつ増やします。

これは「i = i + 1」と同じ意味を持ち、ループ処理で頻繁に使用される便利な書き方です。

コード例

次のfor文は、カウンター「i」の値を1ずつ増加させながら、「A1」から「A10」までのセルに数値を入力します。

function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();

  // 0から9までのカウンター変数iを使ってループを実行
  for (let i: number = 0; i < 10; i++) {
    sheet.getRange(`A${i + 1}`).setValue(i + 1); // A1からA10に1, 2, 3...と順番に入力
  }
}

デクリメント演算子 (i–)｜1ずつ減少する方法

逆に、「i--」はデクリメント演算子と呼ばれ、変数「i」の値を「1」ずつ減少させます。

この演算子は、ループの逆方向（上から下へ、または右から左へ）に進む場合に役立ちます。

コード例

次のfor文は、デクリメント演算子を使って、「A10」から「A1」までのセルに10から1までの数値を入力するコードです。

function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();

  // カウンター変数iを使って逆方向にループを実行
  for (let i: number = 9; i >= 0; i--) {
    sheet.getRange(`A${i + 1}`).setValue(i + 1); // A10からA1に10, 9, 8...と順番に入力
  }
}

2ずつ増加させる場合の設定方法

カウンターを「1ずつ」ではなく、「2ずつ」増やしたい場合は、増加部分を「i += 2」にするだけで実現できます。

これは、インクリメント演算子（i++）と同じようにループ内で頻繁に使われる設定です。

コード例

「A1」から「A10」までのセルに「2ずつ」増加した数値（2, 4, 6…）を入力する「for文」の例です。

function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();

  // カウンター変数iを使って2ずつ増加させながらループを実行
  for (let i: number = 0; i < 10; i += 2) {
    sheet.getRange(`A${i / 2 + 1}`).setValue(i + 2); // A1に2, A2に4...と2ずつ増加
  }
}

このコードでは、「i += 2」を使ってカウンターが「2ずつ」増加し、セル「A1」には2、「A2」には「4」といった具合に値が入力されます。

また、他にも「i += 3」や「i += 5」など、for文の最後の増加部分は自由に設定可能です。

Officeスクリプト for文を合わせて使用したい｜break・continue・最終行までの使い方

Officeスクリプトのfor文には、ループを中断するbreakや、特定の条件で処理をスキップするcontinueといった便利な機能があり、効率的な繰り返し処理が実現できます。

また、Excelシートの「最終行」までfor文を繰り返す方法もよく使われます。

ここでは、それぞれの使い方について解説します。

breakでループを途中で終了する方法｜Officeスクリプト for文での中断処理

breakは、for文内で特定の条件が満たされたときにループを強制的に終了させる処理です。

例えば、ある条件が成立したらそれ以降の処理を行わずにループを抜けたい場合に便利です。

コード例：特定の条件でループを終了する

function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();

  // 1から10までループし、条件に応じてセルに値を入力
  for (let i: number = 1; i <= 10; i++) {
    if (i === 5) break;  // iが5のときにループを終了
    sheet.getRange(`A${i}`).setValue(i);  // A1からA4に1, 2, 3, 4が入力されます
  }
}

このコードでは、変数iが「5」になった時点でループが終了し、セル「A1」から「A4」までに数値が入力されます。

continueで特定の処理をスキップする方法｜Officeスクリプト for文のスキップ処理

continueは、for文内で特定の条件を満たした際に、そのループの処理をスキップし、次の繰り返しに進むための命令です。

指定した条件を除外したい場合に役立ちます。

コード例：特定の条件で処理をスキップ

function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();

  // 1から10までのループで、奇数の値をセルに入力
  for (let i: number = 1; i <= 10; i++) {
    if (i % 2 === 0) continue;  // 偶数の場合はスキップ
    sheet.getRange(`A${i}`).setValue(i);  // A1, A3, A5...に奇数が入力されます
  }
}

この例では、iが偶数のときにcontinueで処理をスキップし、奇数のみがセルに入力されます。

たとえば、セル「A1」に1、「A3」に3、「A5」に5が入力されるようになります。

最終行までfor文を実行する方法｜Officeスクリプト for文での範囲指定

Excelシートの「最終行」まで繰り返し処理を行いたい場合、for文にセル範囲の最終行を指定することで、シートの内容が変わっても動的に最終行まで処理を実行できます。

特に、データの位置が変更されるシートにおいては、この方法が便利です。

コード例：最終行までfor文を繰り返す

function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // 最終行の取得
  let lastRow: number = sheet.getUsedRange().getRowCount();  

  // 最終行までループし、A列に数値を入力
  for (let i: number = 1; i <= lastRow; i++) {
    sheet.getRange(`A${i}`).setValue(i);  // A列に1から最終行まで順番に数値を入力
  }
}

このコードでは、lastRowで最終行を取得し、その行までfor文で処理が繰り返されます。
これにより、Excelシートのデータ量に応じて柔軟に範囲指定が可能になります。

getUsedRange() メソッドの注意ポイント

しかし、getUsedRange() メソッドは「書式設定されたセル」や「空白スペースの入力されたセル」も「使用されているセル」として認識して最終行を取得します。

データが入力されている実際のセル範囲のみ処理したい場合は、次のカスタム関数を使用しましょう。

コード例：カスタム関数getLastDataRowを使って最終行を取得する

このgetLastDataRow関数を呼び出すことで、「書式設定されたセル」や「空白スペース」を除く、シートの最終行を取得し、for文のループ条件に組み込んで繰り返し処理を行うことができます。

function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();

  // 最終行を取得する
  let lastRow: number = getLastDataRow(sheet);

   // 最終行までループし、A列に数値を入力
  for (let i: number = 1; i <= lastRow; i++) {
    sheet.getRange(`A${i}`).setValue(i);  // A列に1から最終行まで順番に数値を入力
  }
}


// ↓ 空白スペースと書式を無視して正確に最終行を求める関数
function getLastDataRow(sheet: ExcelScript.Worksheet): number {
  let usedRange: ExcelScript.Range = sheet.getUsedRange();
  if (!usedRange) return 0;

  let startRow: number = usedRange.getRowIndex();
  let rowCount: number = usedRange.getRowCount();
  let columnCount: number = usedRange.getColumnCount();

  for (let i: number = rowCount - 1; i >= 0; i--) {
    let rowIndex: number = startRow + i;
    let range: ExcelScript.Range = sheet.getRangeByIndexes(rowIndex, 0, 1, columnCount);
    let values = range.getValues()[0];

    // 行内の各セルをチェック
    if (values.some(cell => {
      if (cell === null || cell === undefined) {
        return 0;
      }
      if (typeof cell === 'string') {
        return cell.trim() !== "";
      }
      return true; // 数値やブール値など、非文字列型はデータありと判断
    })) {
      return rowIndex + 1;
    }
  }
  return 0;
}

この最終行・最終列の取得方法について、別記事で解説を行っていますので、興味のある方はぜひご覧ください。

あわせて読みたい

Officeスクリプトで最終行・最終列を正確に取得する！getUsedRangeの限界と関数化での解決法 「Officeスクリプトで、最終行・最終列を取得するにはどうやればいいの…」そのように悩んでいませんか？ ・getUsedRange() メソッドを使用すると、　書式が設定されたセ...

Office ScriptによるExcel on the web開発入門

¥2,500 （2024/11/01 23:18時点 | Amazon調べ）

＼楽天ポイント4倍セール！／

楽天市場で探す

メルカリで探す

ポチップ

Officeスクリプトのfor文で注意すべきポイント

for文を使用する際に留意すべき点をいくつか紹介します。

カウンターの範囲設定に注意｜無限ループ防止の対策

for文では、「開始値」と「終了条件」を正しく設定することが重要です。

たとえば、終了条件が満たされない場合、ループが止まらず無限ループが発生する可能性があります。
無限ループはExcelやブラウザの動作に影響を与えるため、必ずカウンターの範囲を確認しましょう。

無限ループのコード例

for (let i: number = 0; i >= 0; i++) {
  // この条件では「i」が常に「0以上」であるため無限ループになります。
}

無限ループ防止の対策コード

// カウンターが10で終了する設定を追加
for (let i: number = 0; i < 10; i++) {
  if (i === 5) break;  // 必要に応じて break でループを抜ける
  console.log(i);  // 0から4まで出力
}

breakを使うと、特定の条件でループを強制的に終了でき、無限ループを防止することができます。

無限ループが発生した場合の強制停止方法

もしfor文の設定ミスなどで無限ループが発生してしまった場合、Officeスクリプトの処理を強制的に停止する方法を覚えておきましょう。

Officeスクリプトを実行中にブラウザやExcelが反応しなくなった場合でも、次の方法で強制停止が可能です。

配列やセル範囲のインデックス範囲に注意｜範囲外アクセスの防止対策

配列やセル範囲を扱う際には、インデックスが範囲外にならないようにすることが重要です。
存在しないセルや配列要素にアクセスしようとするとエラーが発生します。

たとえば、存在しないセルや配列の要素にアクセスするとエラーが発生します。
配列やセルの長さを確認し、範囲外のアクセスがないようにしましょう。

範囲外アクセスのコード例

let array: number[] = [1, 2, 3]; // 配列の型をnumber[]と指定

for (let i: number = 0; i <= array.length; i++) {  // 変数iにnumber型を指定
  console.log(array[i]); // 最後のループで範囲外のアクセスをし、エラーが発生します。
}

範囲外アクセス防止の対策コード

i < array.length として配列の範囲内のみにアクセス

let array = [1, 2, 3];
for (let i = 0; i < array.length; i++) {  // i < array.length として範囲内のみにアクセス
  console.log(array[i]);  // 各要素を順番に出力
}

また、特定の条件でスキップしたい場合はcontinueを使用し、無駄なアクセスを避けることができます。

continue を使用して無駄なアクセスを避ける

let array: number[] = [1, 2, 3];  // 配列にnumber[]型を指定

for (let i: number = 0; i < array.length; i++) {  // 変数iにnumber型を指定
  if (array[i] < 2) continue;  // 値が2未満の要素はスキップ
  console.log(array[i]);  // 2以上の要素のみ出力
}

Officeスクリプトのfor文の使用例をご紹介

それでは、OfficeスクリプトのFor分を使用した使用例を紹介します。

以下に紹介する使用例は、すべてコピペしてすぐに実行できるコードです。
気になる例は、ぜひご覧いただき、実際に実行してみてください。

Officeスクリプトの基礎から応用までを効率よくしっかり学習したい方には、UdemyのOfficeスクリプト講座もおすすめです。

特に自己学習で進める場合、ビデオや実践例があると理解が進みやすくなります。

【 Udemy 】Officeスクリプトのオススメ講座

使用例1: 順方向にループを行う

この例では、Officeスクリプトのfor文を使って、Excelシート上でセル範囲「A1」から「A10」までに数値を順番に入力する方法を紹介します。

for文を利用することで、範囲内の各セルに1から10までの値を効率よく設定できます。

コード例 | for文による順方向ループ

function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // セル範囲「A1:A10」を取得
  let range: ExcelScript.Range = sheet.getRange("A1:A10");

  // ループを使用して各セルに1から10までの値を入力
  for (let i: number = 0; i < 10; i++) {
    range.getCell(i, 0).setValue(i + 1);
  }
}

処理結果

コードの動作概要

このコードで使用している機能

• let (変数)
  • letは変数を宣言するためのキーワードです。
• getActiveWorksheet() (アクティブなシートの取得)
  • workbook.getActiveWorksheet()メソッドは、Excelで現在アクティブなシートを取得します。
• getCell(行, 列) (セルの取得)
  • range.getCell(i, 0)は、指定した範囲rangeの中で、i行目、0列目（A列）のセルを取得するメソッドです。
• setValue() (セルへの値の設定)
  • 取得したセルに数値を入力するためのメソッドです。

1行ずつコードを解説

総括・ポイント

このコード例では、for文を使ってExcelシート上の範囲内に繰り返し処理を行い、各セルに順番に数値を入力する手順が示されています。

for文によるループ処理を活用すると、大量のデータ操作や規則的な処理を効率的に行うことができ、Officeスクリプトの自動化がより効果的に行えるようになります。

使用例2: 逆方向にループを行う

この例では、for文を使用してセル「A10」から「A1」までのセルに数値を逆順に入力する方法を紹介します。

デクリメント演算子i--を使用することで、ループが逆方向に進み、各セルに10から1までの値が順次設定されます。

コード例 | for文による逆方向ループ

function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // セル範囲「A1:A10」を取得
  let range: ExcelScript.Range = sheet.getRange("A1:A10");

  // デクリメントを使って逆方向に値を入力
  for (let i: number = 9; i >= 0; i--) {
    range.getCell(i, 0).setValue(10 - i);
  }
}

処理結果

コードの動作概要

このコードで使用している機能

• let (変数)
  • letは変数を宣言するためのキーワードです。
• getActiveWorksheet() (アクティブなシートの取得)
  • workbook.getActiveWorksheet()メソッドは、Excelで現在アクティブなシートを取得します。
• getCell(行, 列) (セルの取得)
  • range.getCell(i, 0)は、指定範囲rangeの中で、i行目、0列目（A列）のセルを取得するメソッドです。
• setValue() (セルへの値の設定)
  • 取得したセルに数値を入力するためのメソッドです。

1行ずつコードを解説

総括・ポイント

このコードでは、for文のデクリメント演算子i--を使用して逆方向に繰り返し処理を行い、Excelシート上のセルに対して「10」から「1」までの値を入力しています。

デクリメントを使用することで、シート上の範囲を逆順に処理することが可能です。

このような処理は、データが最下行から入力されている場合や逆方向に操作が必要な場面で役立ちます。

使用例3: for文をネストして2重ループを行う

この例では、for文をネスト（入れ子）して使用し、セル「A1」から「C3」までの範囲に掛け算の結果を順次入力する方法を紹介します。

2重ループにより、行と列の両方に対して繰り返し処理を実行することで、Excelシートの2次元範囲に値を効率よく入力できます。

コード例 | ネストされたfor文による2重ループ

function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // セル範囲「A1:C3」を取得
  let range: ExcelScript.Range = sheet.getRange("A1:C3");

  // ネストされたループを使用して、2次元のセル範囲に値を入力
  for (let i: number = 0; i < 3; i++) {  // 行に対するループ
    for (let j: number = 0; j < 3; j++) {  // 列に対するループ
      range.getCell(i, j).setValue((i + 1) * (j + 1));  // iとjの値を掛け合わせてセルに入力
    }
  }
}

処理結果

コードの動作概要

このコードで使用している機能

• let (変数)
  • letは変数を宣言するためのキーワードです。
• getActiveWorksheet() (アクティブなシートの取得)
  • workbook.getActiveWorksheet()メソッドは、Excelで現在アクティブなシートを取得します。
• getCell(行, 列) (セルの取得)
  • range.getCell(i, 0)は、指定範囲rangeの中で、i行目、0列目（A列）のセルを取得するメソッドです。
• setValue() (セルへの値の設定)
  • 取得したセルに数値を入力するためのメソッドです。

1行ずつコードを解説

総括・ポイント

このコードでは、for文のネストによる2重ループを使用して、Excelシート上の2次元範囲に値を入力しています。

行方向と列方向のループを組み合わせることで、複数のセルに対する複雑な処理が簡単に実現できます。

このような2重ループは、テーブル形式のデータ入力や、複数条件での処理が必要な場合に非常に便利です。

使用例4: for文で2つずつカウントする

この例では、for文を使って、カウンターを「2つずつ」増加させながらセルに数値を入力する方法を紹介します。

カウンター変数を2ずつ増加させることで、通常の1ずつ増加するループと異なる間隔での繰り返し処理を実現できます。

コード例 | for文による2つずつカウント

function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // セル範囲「A1:A10」を取得
  let range: ExcelScript.Range = sheet.getRange("A1:A10");

  // 2つずつ増加させながらセルに値を入力
  for (let i: number = 0; i < 10; i += 2) {
    range.getCell(i, 0).setValue(i + 2);  // i + 2の値を設定
  }
}

処理結果

コードの動作概要

このコードで使用している機能

• let (変数)
  • letは変数を宣言するためのキーワードです。
• getActiveWorksheet() (アクティブなシートの取得)
  • workbook.getActiveWorksheet()メソッドは、Excelで現在アクティブなシートを取得します。
• getCell(行, 列) (セルの取得)
  • range.getCell(i, 0)は、指定範囲rangeの中で、i行目、0列目（A列）のセルを取得するメソッドです。
• setValue() (セルへの値の設定)
  • 取得したセルに数値を入力するためのメソッドです。

1行ずつコードを解説

総括・ポイント

このコードでは、for文を用いてカウンターを2ずつ増加させることで、指定範囲のセルに2つおきに値を入力しています。

i += 2の設定により、通常の1ずつのループとは異なるカウントが可能になり、一定間隔での処理やデータ配置が必要な場面で便利です。

この方法を応用することで、Excelシート上の繰り返し処理がさらに柔軟に実現できます。

使用例5: 最終行までループして処理を行う

この例では、for文を使用してExcelシート上の「最終行」まで繰り返し処理を行う方法を紹介します。

シートの最終行を取得するために、getLastDataRow関数を使用してデータが存在する最後の行を取得し、その行までfor文で処理を実行します。

コード例 | for文による最終行までのループ

function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // 最終行を取得する
  let lastRow: number = getLastDataRow(sheet);

  // 最終行までループしてA列に値を入力
  for (let i: number = 1; i < lastRow; i++) {
    sheet.getRange(`A${i}`).setValue(i);  // A列に1から最終行までの値を順に設定
  }
}


// ↓ 空白スペースと書式を無視して正確に最終行を求める関数
function getLastDataRow(sheet: ExcelScript.Worksheet): number {
  let usedRange: ExcelScript.Range = sheet.getUsedRange();
  if (!usedRange) return 0;

  let startRow: number = usedRange.getRowIndex();
  let rowCount: number = usedRange.getRowCount();
  let columnCount: number = usedRange.getColumnCount();

  for (let i: number = rowCount - 1; i >= 0; i--) {
    let rowIndex: number = startRow + i;
    let range: ExcelScript.Range = sheet.getRangeByIndexes(rowIndex, 0, 1, columnCount);
    let values = range.getValues()[0];

    // 行内の各セルをチェック
    if (values.some(cell => {
      if (cell === null || cell === undefined) {
        return 0;
      }
      if (typeof cell === 'string') {
        return cell.trim() !== "";
      }
      return true; // 数値やブール値など、非文字列型はデータありと判断
    })) {
      return rowIndex + 1;
    }
  }
  return 0;
}

処理結果

コードの動作概要

このコードで使用している機能

• let (変数)
  • letは変数を宣言するためのキーワードです。
• getActiveWorksheet() (アクティブなシートの取得)
  • workbook.getActiveWorksheet()メソッドは、Excelで現在アクティブなシートを取得します。
• getCell(行, 列) (セルの取得)
  • range.getCell(i, 0)は、指定範囲rangeの中で、i行目、0列目（A列）のセルを取得するメソッドです。
• setValue() (セルへの値の設定)
  • 取得したセルに数値を入力するためのメソッドです。
• if (条件分岐)
  • 指定した条件で処理結果を分岐させます。
• getLastDataRow() (最終行の取得)
  • 指定したシート内で最終行にデータがある行番号を取得する関数です。

1行ずつコードを解説

総括・ポイント

このコードでは、for文を用いてExcelシート上の最終行まで繰り返し処理を行い、1から最終行までの数値を順に入力しています。

最終行の取得には独立したgetLastDataRow関数を用いているため、シートのデータ量に応じて範囲を動的に指定することが可能です。

シート内のデータの最終行まで繰り返し操作が必要な場面で、効率的に対応できるスクリプト構成となっています。

使用例6: 配列を使用して要素数のみループする

この例では、Officeスクリプトのfor文を使って、配列内の要素数分だけ繰り返し処理を行い、各要素の値をExcelのセルに入力する方法を紹介します。

配列を使った繰り返し処理を活用することで、Excelの指定範囲内に配列のデータを効率よく配置できます。

コード例 | 配列の要素数分だけfor文でループ

function main(workbook: ExcelScript.Workbook) {
  // 配列を定義
  let dataArray: number[] = [10, 20, 30, 40, 50];
  
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // 配列の要素数分だけループを実行し、セルにデータを入力
  for (let i: number = 0; i < dataArray.length; i++) {
    sheet.getRange(`A${i + 1}`).setValue(dataArray[i]);
  }
}

処理結果

コードの動作概要

このコードで使用している機能

• let (変数)
  • letは変数を宣言するためのキーワードです。
• getActiveWorksheet() (アクティブなシートの取得)
  • workbook.getActiveWorksheet()メソッドは、Excelで現在アクティブなシートを取得します。
• getCell(行, 列) (セルの取得)
  • range.getCell(i, 0)は、指定範囲rangeの中で、i行目、0列目（A列）のセルを取得するメソッドです。
• setValue() (セルへの値の設定)
  • 取得したセルに数値を入力するためのメソッドです。
• 配列名.length (配列の要素数を取得)
  • 指定した配列名の要素数を取得します。

1行ずつコードを解説

総括・ポイント

このコードでは、配列の要素数に応じてfor文を使い、Excelシート上のセルに値を入力しています。dataArray.lengthを使うことで、配列の要素数だけ繰り返し処理を行うため、柔軟にデータを配置することが可能です。

また、forEachメソッドでも同様の処理が実行でき、配列要素の操作に特化した構文を活用することで、コードをさらにシンプルに記述できます。

この方法を活用すると、Excelでの配列データの操作や自動化がさらに便利になります。

使用例7: オブジェクトの要素をループしてセルに入力する

この例では、for 文の応用として、for-in 文を使用してオブジェクト内の各要素をループし、キーと値をExcelのシートに入力する方法を紹介します。

オブジェクトをループする際には、for 文よりも for-in 文が適しており、キーと値の組み合わせデータを効率よく処理できます。

この方法により、Excelの指定範囲内に構造化されたデータを自動で配置でき、データ操作がさらに便利になります。

コード例 | オブジェクトのキーと値をループして入力

function main(workbook: ExcelScript.Workbook) {
  // オブジェクトを定義
  let dataObject: { [key: string]: number } = {
    "Alice": 85,
    "Bob": 92,
    "Charlie": 78,
    "Daisy": 90,
    "Evan": 88
  };
  
  // アクティブなシートを取得
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // オブジェクトの各要素に対してループ処理を行い、キーと値をセルに入力
  let row: number = 1;  // 開始行を指定

  for (let key in dataObject) {
    sheet.getRange(`A${row}`).setValue(key);            // A列にキー（名前）を入力
    sheet.getRange(`B${row}`).setValue(dataObject[key]); // B列に値（スコア）を入力
    row++;  // 次の行に移動
  }
}

処理結果

コードの動作概要

このコードで使用している機能

• let (変数)
  • letは変数を宣言するためのキーワードです。
• getActiveWorksheet() (アクティブなシートの取得)
  • workbook.getActiveWorksheet()メソッドは、Excelで現在アクティブなシートを取得します。
• getCell(行, 列) (セルの取得)
  • range.getCell(i, 0)は、指定範囲rangeの中で、i行目、0列目（A列）のセルを取得するメソッドです。
• setValue() (セルへの値の設定)
  • 取得したセルに数値を入力するためのメソッドです。

1行ずつコードを解説

総括・ポイント

このコードでは、for-in 文を使用してオブジェクトのキーと値にアクセスし、Excelシートに効率よくデータを入力しています。

for 文と異なり、for-in 文はオブジェクトのキーに直接アクセスできるため、キーと値の組み合わせデータを扱う処理が非常に簡単に行えます。

オブジェクトをループする場合、for 文よりもfor-in 文が適しており、構造化データをExcelシートに自動化して出力する場面で特に役立ちます。

この方法を覚えておくことで、より柔軟で効率的なデータ操作が可能になります。

この記事のまとめ

この記事では、Officeスクリプトの「for文」を使ったExcelでの繰り返し処理について解説しました。

繰り返し処理を効率的に利用することで、Excelシート上での自動化が実現できます。

ポイントのおさらい

さらに学ぶために

この記事で学んだfor文の基礎をもとに、他のループ処理や条件分岐を取り入れたOfficeスクリプトでの自動化に挑戦してみましょう。

データ処理を一層効率化できるスクリプトを目指しましょう。

あわせて読みたい

サイトマップ VBAOfficeスクリプトワークシート関数 VBA 基本設定 VBAとは？ VBAの始め方 VBAのおすすめ設定 セル操作 RangeとCells CurrentRegion Offset Resize 最終行・最終列の取...