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

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

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

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

ステータス 定義
完全にサポートされている これらのファイルには、Apps Script で直接対応するものが存在する API が含まれています。
回避策でサポートされている これらのファイルには、回避策でサポートできる API が少なくとも 1 つ含まれています。
詳細な調査が必要 これらのファイルには、続行方法を判断するために確認する必要がある API が少なくとも 1 つ含まれています。たとえば、対応する API が存在しない場合や、Macro Converter が使用中の API を特定できなかった場合などです。

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

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

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

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

  • 概要: このシートには、 送信されたすべてのファイルとその API の互換性に関する集計分析が表示されます。
  • ファイル - 互換性: このシートには、Macro Converter に送信されたすべてのファイルと、各ファイルの互換性ステータスと詳細が表示されます。
  • ファイル - 詳細な分析: このシートには、ファイル内の API に関する詳細情報と、各 API を正常に変換するために実行できる操作が表示されます。まず、上部のプルダウン メニューからファイルを選択します。次に、下部のプルダウン メニューからステータスを選択します。

複数のファイルの名前が同じ場合は、ファイル名の横にある一意の識別子を使用して区別します。ドライブでファイルを開き、URL で一意の識別子を探します。https://drive.google.com/file/d/<file_identifier>/view

[調査する 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に変換するをご覧ください。