VBA マクロに互換性があるかどうかを確認する

Visual Basic for Applications（VBA）マクロを含む Excel ファイルは、マクロで使用されるすべての API に Apps Script で直接対応するものがある場合、互換性があると見なされます。マクロが完全に互換性がない場合は、回避策を適用するか、コードを調整して Apps Script で動作するようにすることができます。

Macro Converter の互換性レポートを使用して、ファイルをそのまま自動変換できるかどうか、またはコードを調整する必要があるかどうかを判断します。

互換性レポートを生成すると、各ファイルと API に次のいずれかのステータスが適用されます。

ステータス 定義
完全にサポートされている これらのファイルには、すべて Apps Script で直接対応する API が含まれています。
回避策でサポート これらのファイルには、回避策でサポートできる API が 1 つ以上含まれています。
さらに調査が必要 これらのファイルには、確認して対処方法を判断する必要がある API が 1 つ以上含まれています。たとえば、同等の API が存在しない場合や、マクロ変換ツールで使用されている API が特定されていない場合があります。

互換性レポートを生成する

  1. パソコンで Google ドライブを開きます。
  2. 右側のパネルで、マクロ変換アドオン Macro Converter アイコン をクリックします。サイドパネルが表示されていない場合は、右下のサイドパネルを表示アイコン をクリックします。
  3. [ファイルとフォルダを追加] をクリックします。Macro Converter は Excel ファイルのみを認識します。
  4. 分析するファイルまたはフォルダを選択し、[選択] をクリックします。一度に選択するファイル数を 2,000 個未満にしてください。
  5. 互換性レポートの保存場所を変更するには、[保存先フォルダを変更] をクリックして、目的のフォルダを選択します。指定しなかった場合は、マイドライブ フォルダに保存されます。
  6. [レポートを生成] をクリックします。
  7. 分析が完了したら、[レポートを表示] をクリックします。

互換性レポートを確認する

互換性レポートの詳細を使用して、ファイル変換の進め方を決定します。レポートには次のセクションがあります。

  • 概要: このシートには、送信されたすべてのファイルとその API の互換性に関する集計分析が表示されます。
  • ファイル - 互換性: このシートには、マクロ変換ツールに送信されたすべてのファイルと、各ファイルの互換性ステータスと詳細が表示されます。

  • ファイル - 詳細な分析: このシートには、ファイル内の API の詳細と、各 API を正常に変換するために実行できるアクションが記載されています。まず、上部のプルダウン メニューからファイルを選択します。下部のプルダウン メニューからステータスを選択します。

[調査対象の API] シートと [回避策がある API] シートを使用して、API ごとにレポートを確認することもできます。

手順を決定する

各ステータスに関する推奨事項は次のとおりです。

ステータス 推奨事項
完全にサポートされている VBA API と同じロジックを Apps Script で再現できます。変換を続行します。
回避策でサポート 少なくとも 1 つの VBA API を同等の Apps Script API に置き換えるコードを記述する必要があります。通常は、変換を続行できます。

[回避策ありでサポートされている] とマークされた VBA API は、ファイルの変換前または変換後に手動で置き換えることができます。事前に変更を加えることをおすすめします。
さらに調査が必要 1 つ以上の API を変換できません。コード内での API の重要性に応じて、ファイルを変換できない場合があります。最終的な評価は、元の VBA コードを理解している人が行う必要があります。

ファイルを変換する場合は、少なくとも 1 つの VBA API を Apps Script に置き換えるコードを記述する必要があります。[調査が必要] とマークされた VBA API は、ファイルの変換前または変換後に手動で置き換えることができます。事前に変更を加えることをおすすめします。

互換性レポートを評価したら、VBA マクロを Apps Script に変換するをご覧ください。