VBAテンプレートの変更箇所はどこ?修正するコードの見つけ方

コラム・裏ワザ
勇者たんたん
勇者たんたん

VBAテンプレートを使いたいけど、どこを変更すればよいのか分かりません。
コードをすべて読めないと、変更できないのでしょうか?

VBAテンプレートには、ブック名やシート名、セル番地など、使用する目的に合わせて変更する箇所があります。

しかし、VBAコードに慣れていないと、どこが変更できる部分なのか判断するのは難しいでしょう。

VBAテンプレートの変更箇所は、コメントやブック名、シート名、セル番地などを目印にすると見つけやすくなります。

VBAコードを最初からすべて理解する必要はありません。

まずは、コメントやダブルクォーテーションで囲まれた文字、Range、If、For Nextなどを目印に、変更する可能性がある箇所を探しましょう。

この記事では、VBAテンプレートから変更箇所を見つける方法を解説します。

変更箇所を見つけたあとは、元ファイルを残し、1か所ずつ変更して動作を確認する方法も見ていきましょう。

今回のゴール

VBAテンプレート内のコメントやコードを目印に、目的に合わせて変更する箇所を見つけられるようになる

VBAテンプレートの変更箇所を見つける基本

VBAテンプレートを目的に合わせて変更するときも、すべてのコードを書き直す必要はありません。

まずは、次のような分かりやすい部分から探しましょう。

優先的に探す変更箇所
  • コードの説明が書かれたコメント
  • ダブルクォーテーションで囲まれた文字
  • Rangeに指定されたセル番地
  • Ifに書かれた条件
  • For Nextに書かれた繰り返し範囲
  • Excelファイルのフルパス

たとえば、次のコードには、シート名とセル番地が書かれています。

「売上一覧」シートのセルB2へ「完了」と入力する処理

Worksheets("売上一覧").Range("B2").Value = "完了"

目的に合わせて変更する可能性がある部分は、次の3つです。

  • "売上一覧":処理するシート名
  • "B2":処理するセル番地
  • "完了":セルへ入力する値

VBAテンプレートでは、コメントやダブルクォーテーションで囲まれた文字を目印にすると、変更箇所を見つけやすくなります。

ただし、ダブルクォーテーションで囲まれた部分を、すべて変更するわけではありません。

最初にコードのコメントや周辺の処理を確認し、何を表している文字なのかを判断しましょう。

コメントから変更箇所を探す

コメントとは、コードの内容を分かりやすくするための文章です。

親切なコードであれば、コメントで何をしているコードか分かるようにしてくれています。

すべてのテンプレートにコメントが書かれているとは限りません。コメントが見つからない場合は、ブック名やシート名、セル番地など、実際の業務で変更したい文字を探しましょう。

ブック名・シート名・セル番地を探す

VBAテンプレートでは、処理するExcelファイルやシート、セルをコードで指定します。

自分のExcelファイルに合わせてテンプレートを使用するには、次の3つを確認しましょう。

ブック名・シート名・セル番地の目印
  • Workbooks:ブック名
  • Worksheets:シート名
  • Range:セル番地

ブック名を探す

ブックとは、Excelファイル全体のことです。

VBAコードでは、Workbooksの後ろにブック名が書かれている場合があります。

Set wb = Workbooks("売上管理.xlsm")

wb:ブックを入れておく変数Workbooks:Excelで開いているブック"売上管理.xlsm":処理するブック名

たとえば、実際に使用するブック名が「請求管理.xlsm」の場合は、次のように変更します。

変更前
Set wb = Workbooks("売上管理.xlsm")

変更後
Set wb = Workbooks("請求管理.xlsm")

ブック名を変更するときは、末尾の「.xlsx」や「.xlsm」まで一致させましょう。

Excelで拡張子が表示されていない場合は、実際のファイル名が分かりにくいことがあります。

Excelファイルの名前や保存場所を確認する方法については、次の記事で詳しく解説しています。

シート名を探す

VBAコードでは、WorksheetsまたはSheetsの後ろにシート名が書かれている場合があります。

Set ws = Worksheets("売上一覧")

シート名:"売上一覧"

実際に処理するシート名が「請求一覧」の場合は、次のように変更します。

変更前
Set ws = Worksheets("売上一覧")

変更後
Set ws = Worksheets("請求一覧")

シート名は、Excel画面の下にあるシート見出しで確認できます。

コード内のシート名と、シート見出しに表示されている名前が一致していることを確認しましょう。

シート名に含まれる空白や記号も名前の一部です。「請求一覧」と「請求 一覧」は別のシート名として扱われます。

Rangeからセル番地を探す

VBAコードでは、Rangeを使って処理するセルやセル範囲を指定できます。

セルB2へ「完了」と入力
ws.Range("B2").Value = "完了"

"B2":処理するセル番地"完了":セルへ入力する値

処理するセルをB2からD2へ変更する場合は、次のように書き換えます。

変更前
ws.Range("B2").Value = "完了"

変更後
ws.Range("D2").Value = "完了"

複数のセルをまとめて指定している場合は、開始セルと終了セルがコロンで区切られています。

ws.Range("A2:D10").ClearContents

A2:範囲の左上D10:範囲の右下

セル番地を探すときは、Rangeの後ろにあるダブルクォーテーション内を確認しましょう。

ただし、コード内に複数のRangeがある場合は、すべてを同じセル番地へ変更するわけではありません。

Rangeの前後にあるコメントや処理内容を確認し、どのセルを表しているのか判断してください。

Ifの条件とFor Nextの繰り返し範囲を探す

VBAテンプレートでは、条件によって処理を変えたり、複数行へ同じ処理を繰り返したりすることがあります。

条件分岐と繰り返し処理の目印
  • If:条件によって処理を変える
  • For Next:指定した範囲で処理を繰り返す

テンプレートの動作を変更したいときは、Ifの条件やFor Nextの開始位置と終了位置を確認しましょう。

Ifの条件を探す

Ifは、指定した条件を満たした場合だけ処理を実行するときに使用します。

セルC2に「未処理」と入力されている場合に、セルD2へ「確認」と入力

If ws.Range("C2").Value = "未処理" Then
 ws.Range("D2").Value = "確認"
End If


"C2":確認するセル番地
"未処理":比較する値

条件は、IfからThenまでに書かれています。

たとえば、「未処理」ではなく「要確認」のデータを処理したい場合は、比較する値を変更します。

変更前
If ws.Range("C2").Value = "未処理" Then

変更後
If ws.Range("C2").Value = "要確認" Then

この変更では、確認するセル番地や条件を満たしたあとの処理は変えていません。

Ifの条件を探すときは、IfからThenまでを確認しましょう。

比較する文字は、Excelのセルに入力されている内容と一致させる必要があります。

If文や比較演算子の詳しい使い方については、次の記事で解説します。

For Nextの繰り返し範囲を探す

For Nextは、指定した回数や範囲で同じ処理を繰り返すときに使用します。

2行目から最終行まで処理を繰り返し
For i = 2 To lastRow
 ws.Range("D" & i).Value = "確認済"
Next i

i:現在処理している行番号2:処理を始める行lastRow:処理を終える最終行To:開始位置から終了位置まで

繰り返し範囲は、ForとToのある行で確認できます。

iには2、3、4というように行番号が順番に入り、lastRowまで処理が続きます。

たとえば、見出しが2行目まであり、データが3行目から始まる場合は、開始行を2から3へ変更します。

変更前
For i = 2 To lastRow

変更後
For i = 3 To lastRow

開始行を間違えると、見出しまで処理したり、最初のデータを処理できなかったりします。Excelの表でデータが始まる行を確認してから変更しましょう。

終了位置にlastRowが使われている場合は、データが入力された最後の行をコードで取得しています。

データが増減しても処理範囲を合わせやすいため、特別な理由がなければ、lastRowを固定の行番号へ変更する必要はありません。

For Nextと最終行の詳しい使い方については、次の記事で解説します。

変数へ代入されている値を探す

VBAテンプレートでは、ブック名やシート名、開始行など、変更する可能性がある内容を変数へ入れている場合があります。

たとえば、次のコードを確認しましょう。

fileName = "売上管理.xlsm"
sheetName = "売上一覧"
startRow = 2


"売上管理.xlsm":使用するブック名
"売上一覧":使用するシート名
2:処理を始める行

このコードでは、変更する可能性がある値が3つにまとめられています。

「=」を左向き矢印として読む

VBAコードで値を代入するときの=は、右側の値を左側へ渡す左向き矢印として考えると読みやすくなります。

fileName ← "売上管理.xlsm"
sheetName ← "売上一覧"
startRow ← 2

それぞれ、次のように読みます。

  • 「売上管理.xlsm」をfileNameへ渡す
  • 「売上一覧」をsheetNameへ渡す
  • 2をstartRowへ渡す

変数への代入では、右側の値が左側の変数へ入ると考えましょう。

IFで使われる=は比較演算子

Ifの条件で使用されている=は、左右の値が等しいかを確認する比較演算子です。

If status = "未処理" Then

同じ=でも、使用される場所によって役割が異なります。

  • 値を変数へ入れる場合:右側の値を左側へ渡す
  • Ifの条件で使用する場合:左右の値が等しいか確認する

詳細はこちらで解説しています。

右側の値を目的に合わせて変更する

テンプレートを変更するときは、基本的に=の右側にある値を確認します。

たとえば、処理するシートを「売上一覧」から「請求一覧」へ変更、開始行を2行目から3行目へ変更する場合は、次のように書き換えます。

変更前
sheetName = "売上一覧"
startRow = 2

変更後
sheetName = "請求一覧"
startRow = 3

変数名のsheetNameは変更せず、右側のシート名だけを変更しています。

変数名を変更すると、同じ変数を使用しているほかのコードも修正が必要になる場合があります。最初は左側の変数名を変更せず、右側の値だけを変更しましょう。

変更用の値がまとめられている場所を確認する

テンプレートによっては、変更する値がコードの最初にまとめられています。

Sub データ転記()
 'ここから設定
 fileName = "売上管理.xlsm"
 sheetName = "売上一覧"
 startRow = 2

 'ここまで設定

 '以下に実際の処理が続く

End Sub

このようなコードでは、「ここから設定」と「ここまで設定」の間を確認すれば、主な変更箇所を見つけられます。

コードの途中にあるブック名やシート名を個別に探す前に、テンプレートの上部に設定がまとめられていないか確認しましょう。

変数の宣言やデータ型、InputBoxとMsgBoxの詳しい使い方については、次の記事で解説します。

フルパス・保存先・MsgBoxの文章を探す

VBAテンプレートでは、Excelファイルを開く場所や、PDFなどを保存する場所がコードに書かれている場合があります。

また、処理が完了したときに表示する文章も、目的に合わせて変更できます。

フルパスを探す

フルパスは、ファイルの保存場所・ファイル名・拡張子をまとめた情報です。

コード内では、次のような特徴を目印に探します。

  • C:\から始まっている
  • .xlsxや.xlsmで終わっている
  • ダブルクォーテーションで囲まれている
filePathへExcelファイルのフルパスを代入filePath = "C:\Users\ユーザー名\Documents\売上管理.xlsm"

filePath:フルパスを入れておく変数ダブルクォーテーション内:使用するExcelファイルのフルパス

使用するファイルが異なる場合は、右側のフルパスを変更します。

変更前
filePath = "C:\Users\ユーザー名\Documents\売上管理.xlsm"

変更後
filePath = "C:\Users\ユーザー名\Documents\請求管理.xlsm"

フルパスを変更するときは、ファイル名だけでなく、保存場所と拡張子まで正しく指定してください。

Excelファイルのフルパスを確認する方法については、次の記事で詳しく解説しています。

保存先とファイル名を探す

VBAテンプレートでは、ExcelファイルやPDFの保存先が指定されている場合もあります。

PDFの保存先とファイル名をpdfPathへ代入
pdfPath = "C:\Users\ユーザー名\Documents\売上報告.pdf"

変更するときは、次の3つを確認しましょう。

  • 保存先のフォルダー
  • 保存するファイル名
  • .pdfなどの拡張子

たとえば、PDFの保存先を[ドキュメント]から[デスクトップ]へ変更する場合は、次のように書き換えます。

変更前
pdfPath = "C:\Users\ユーザー名\Documents\売上報告.pdf"

変更後
pdfPath = "C:\Users\ユーザー名\Desktop\売上報告.pdf"

同じ保存先に同名のファイルがあると、上書きされる可能性があります。
テストするときは、元のファイルと異なる名前を使用してください。

保存先を変更したあとは、指定したフォルダーにファイルが作成されたか確認します。

ブックの保存自動化についてはこちらをご覧ください。

MsgBoxの文章を探す

MsgBoxは、処理の結果や確認事項を画面に表示するときに使用します。

「転記が完了しました」と表示
MsgBox "転記が完了しました"

ダブルクォーテーションで囲まれた部分が、画面に表示される文章です。

処理内容を転記からPDF作成へ変更した場合は、MsgBoxの文章も変更できます。

変更前
MsgBox "転記が完了しました"

変更後
MsgBox "PDFの作成が完了しました"

MsgBoxは処理結果を知らせるための表示です。文章を変更しても、実際に実行される処理は変更されません。

そのため、メッセージだけで成功と判断せず、次のような処理結果も確認しましょう。

  • 指定したブックが開いた
  • 正しいシートへ転記された
  • 指定した保存先にファイルが作成された
  • 作成されたPDFを開けた

変更箇所は1か所ずつ修正する

VBAテンプレートの変更箇所を見つけても、一度にすべてを書き換えないようにしましょう。

複数の箇所を同時に変更すると、エラーや想定外の結果が発生したときに、どの変更が原因なのか分かりにくくなります。

マクロ修正の手順
  1. 元のExcelファイルをコピーする
  2. 変更する箇所を1つ選ぶ
  3. 変更前のコードを確認する
  4. 1か所だけ変更する
  5. マクロを実行する
  6. 変更した内容に対応する結果を確認する
  7. 問題がなければ次の箇所を変更する

テストでは、元のExcelファイルを直接使用しないでください。
コードの内容によっては、データやファイルが上書きされる可能性があります。

変更前と変更後を比較する

コードを変更するときは、どこを書き換えたのか分かるように、変更前と変更後を比較しましょう。

たとえば、処理するシートを「売上一覧」から「請求一覧」へ変更する場合は、次のようになります。

変更前
sheetName = "売上一覧"

変更後
sheetName = "請求一覧"

変更したのは、=の右側にあるシート名だけです。

左側の変数名やダブルクォーテーションなど、変更する必要がない部分はそのまま残します。

変更前と変更後を比較し、目的の部分だけが変わっていることを確認しましょう。

元ファイルを残しておくと、正常に動かなかった場合に元へ戻しやすくなります。

VBEでは、変更直後であれば[Ctrl]キーを押しながら[Z]キーを押して、直前の操作を元へ戻すこともできます。

1か所だけ変更してマクロを実行する

1か所を変更したら、次の変更へ進む前にマクロを実行します。

たとえば、シート名だけを変更した場合は、変更後のシートが処理されるか確認しましょう。

正常に動作したら、次の変更箇所へ進みます。

  1. シート名を変更して動作確認する
  2. セル番地を変更して動作確認する
  3. Ifの条件を変更して動作確認する
  4. 保存先を変更して動作確認する

このように1か所ずつ進めると、正常に動かなくなった直前の変更を原因の候補として確認できます。

変更箇所が見つからないときの確認方法

VBAコードが長い場合は、変更箇所を目で探すだけでは時間がかかります。

変更したい内容が分かっている場合は、VBEの検索機能を使用しましょう。

検索機能を使うと、ブック名やシート名、Rangeなどがコード内のどこに書かれているかを確認できます。

[Ctrl]+[F]で検索すると、変更箇所を見つけやすくなります。

検索について確認したい方はこちらをご覧ください。

何を検索すればよいか分からない場合は、次の文字を目印にしましょう。

変更したい内容検索する文字の例
ブック名売上管理.xlsm、Workbooks
シート名売上一覧、Worksheets
セル番地B2、Range
条件未処理、If
繰り返し範囲For、lastRow
フルパスC:\、.xlsm
PDFの保存先.pdf、pdfPath
表示する文章MsgBox、完了しました
見つけられない場合は無理に変更しない

検索しても変更箇所を特定できない場合は、似ているコードを推測で書き換えないようにしましょう。

マクロで自動処理しているのではなく、セルの自動書式などほかの機能を利用している可能性があります。

まとめ|コメントやコードの目印から変更箇所を探そう

VBAテンプレートを変更するときは、最初からすべてのコードを理解する必要はありません。

まずは、コメントや次のコードを目印に、変更する箇所を探しましょう。

VBA変更箇所の見つけ方
  • コメントを目印に探す
  • 検索機能を利用する

VBAテンプレートは、コメントや固有名詞、RangeやIfなどのコードを目印にすると、変更箇所を見つけやすくなります。

ただし、VBAコードの基本的な読み方を理解していると、それぞれのコードが何を表しているのか判断しやすくなり、目的の変更箇所も見つけやすくなります。

VBAを基礎から順番に学びたい場合は、次の記事を参考にしてください。

コメント

タイトルとURLをコピーしました