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

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

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

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

ステータス 定義
厳密にサポートされる これらのファイルには、Apps Script に直接同等の API が含まれている API が含まれています。
サポート対象（回避策あり） これらのファイルには、回避策としてサポート可能な API が 1 つ以上含まれています。
詳細な調査が必要 これらのファイルには、処理を続行するために確認する必要がある API が 1 つ以上含まれています。たとえば、同等の API が存在しない場合や、Macro Converter が使用中の API を判別していない場合があります。

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

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

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

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

  • Summary: このシートには、送信されたすべてのファイルとその API の互換性の集計分析が表示されます。
  • ファイル - 互換性: このシートには、Macro Converter に送信されたすべてのファイルが、各ファイルの互換性ステータスと詳細とともに一覧表示されます。

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

また、調査が必要な API と回避策のある API というシートを使用して、API ごとにレポートを確認することもできます。

進め方を決定する

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

ステータス 推奨事項
厳密にサポートされる VBA API と同じロジックを Apps Script に複製できます。 変換を続行します。
サポート対象（回避策あり） 1 つ以上の VBA API を同等の Apps Script API に置き換えるコードを記述する必要があります。通常は変換を続行できます。

[次善策でサポート] のマークが付いている VBA API は、ファイルの変換前または変換後に手動で置換できます。事前に変更を行うことをおすすめします。
詳細な調査が必要 変換できない API が 1 つ以上あります。コード内の API の重要性によっては、ファイルを変換できない場合があります。最終評価は、元の VBA コードを理解した人が行う必要があります。

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

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