メインコンテンツへスキップ

PythonにてExcelVBAマクロをバックグランドで実行する方法【Pythonソースコード公開あり】


    Excelを使用したことのある方の大半が使用したことあるであろうExcelVBAマクロ。
    そんな便利なマクロをPythonにてもっと有効に活用する方法を紹介します。

    Xでの発信や「ちょっと便利なツール」も公開しております。
    よろしければのぞいてみてください。
    👉 https://lit.link/chottobenri

    こんな人に読んでほしい

    ・PythonにてExcel操作全般を効率化したい人
    ・ExcelVBAにて大量のデータを用いた処理をする人
    ・Pythonにて何かしらの業務効率化をしたい人(そのヒントを得たい人)

    前提

    ・ExcelおよびExcelVBAが使用可能であること
    ・Pythonをインストール済であること

    まずはExcelVBAから勉強したい方は以下のサンプル集が参考になるかと思います。本記事では簡易的なマクロを使用した記事のため、もしExcelVBAについての知識ゼロでも読解可能かと思います。

    Pythonのインストール方法や基本的な構文は以下のサイトを参考にしてください。こちらも本記事では見様見真似で実践できるように記載するため、後回しでも問題ございません。ただしインストールだけは事前にお願いします。

    ・本記事では以下の簡易的なマクロを使用したサンプルコードをご紹介します。

    Sub ShowMessage()
        MsgBox "Pythonよりバックグランドでマクロ実行されています", vbInformation, "サンプル"
    End Sub

    上記は以下のメッセージボックスを表示するマクロです。

    画像

    事前準備

    ExcelVBA

    ①新規でExcelファイルを開く
    ②(未設定の方のみ)Excelに開発タブを追加する。手順は以下の記事を参照。

    ③「開発」 > 「VisualBasic」を選択

    画像

    ④上記のサンプルコードを以下の通り記入の上で「サンプルマクロ.xlsm」として保存

    画像

    Python

    ①(未インストールの場合のみ)上記前提に記載の手順を参考にPythonをインストールする。
    ②コマンドプロンプトにて以下のコマンドを実行。必要ライブラリのインストールを行う。

    ・win32com・・・Windowsのアプリケーション(Excel 、Wordなど)をPythonから操作するためのライブラリ
    ・pywinauto・・・WindowsのGUI操作をPythonにて行うライブラリ

    pip install pywin32
    pip install pywinauto

    ※それぞれの詳細については以下の記事が分かりやすいかと存じます

    事前準備はここまでです。

    サンプルコード

    ※「サンプルマクロ.xlsm」と同フォルダ配下に保存してください。

    #必要なライブラリのインポート
    import win32com.client
    from pywinauto import Application
    import os
    
    #スクリプト実行フォルダを取得
    exe_dir = os.path.dirname(os.path.abspath(file))
    
    #実行したいマクロファイルを指定(今回の例ではスクリプトと同フォルダ配下)
    excel_macro_file = os.path.join(exe_dir, 'サンプルマクロ.xlsm')
    
    #Excelを起動し、オブジェクト生成
    excel = win32com.client.DispatchEx("Excel.Application")
    excel.Visible = False  # FalseにすることでExcelを画面上に表示しないようにする
    wb = excel.Workbooks.Open(excel_macro_file)
    
    #Excelマクロを実行(Excelファイルはウィンドウ上に表示されない)
    excel.Application.Run(f"'{excel_macro_file}'!ShowMessage")
    
    #メッセージボックスのみがウィンドウに表示されるので「OK」ボタンを押下することで次の処理へ進む
    
    #実行後、ExcelファイルおよびExcelオブジェクトの削除
    wb.Save()
    wb.Close()
    excel.Quit()
    del excel

    解説

    #必要なライブラリのインポート
    import win32com.client
    from pywinauto import Application
    import os

    上記で事前インストールしたモジュール含めてインポートします。

    os・・・Pythonでファイルやディレクトリなどの操作をするためのライブラリです(当該ライブラリは標準ライブラリのためインストールは不要)

    #スクリプト実行フォルダを取得
    exe_dir = os.path.dirname(os.path.abspath(file))
    
    #実行したいマクロファイルを指定(今回の例ではスクリプトと同フォルダ配下)
    excel_macro_file = os.path.join(exe_dir, 'サンプルマクロ.xlsm')

    Pythonのスクリプト実行フォルダを取得の上で、上記で作成した「サンプルマクロ.xlsm」のファイル名を取得します。

    #Excelを起動し、オブジェクト生成
    excel = win32com.client.DispatchEx("Excel.Application")
    excel.Visible = False  # FalseにすることでExcelを画面上に表示しないようにする
    wb = excel.Workbooks.Open(excel_macro_file)

    いよいよ事前準備でインストールしたライブラリ「win32com」の登場ですね。
    まずはExcelを起動し、変数excelにオブジェクトとして格納します。
    そのあとで上記で指定した「サンプルマクロ.xlsm」をOpenします。

    #Excelマクロを実行(Excelファイルはウィンドウ上に表示されない)
    excel.Application.Run(f"'{excel_macro_file}'!ShowMessage")

    いよいよマクロの実行です。ここでもう1つのライブラリ「pywinauto」より、「Application」を使用します。
    ここで実行するのは「ShowMessage」というマクロ名となります。
    ※上記の事前準備で設定したマクロコードのSubプロシージャ名です。

    以下のメッセージボックスが表示されるかと思いますので、OKを押下してください。

    画像
    #実行後、ExcelファイルおよびExcelオブジェクトの削除
    wb.Save()
    wb.Close()
    excel.Quit()
    del excel

    最後に起動したExcelやマクロファイルを閉じます。
    ※これを忘れると1度起動したExcelがゾンビプロセスとして残存し続けてしまい、他のExcel操作に影響を与える可能性があるため必ず実行してください。

    以上、非常に簡易的なマクロが例ではありましたが、PythonよりExcelマクロの実行方法の一例でした。
    上記の簡易的なマクロの例では手動で実行するのとあまり変わらないですが、例えば大量のファイルやデータを操作することで実行時間の長いマクロに対しては非常に有効なノウハウと思います。

    次に実際に大量のファイルを操作するマクロに対してのPythonでの実装例をご紹介いたします。余力のある方はお読みいただけますと幸いです。

    文字検索くんをPythonにてバックグランドで実行してみた

    過去記事「随時更新|私が愛用しているフリーソフトのご紹介」でもご紹介した「文字検索くん」をPythonにてバックグランドで実行する方法です。

    私は仕事上、ExcelやWord形式の設計書などの調査にて文字検索くんを使用しています。大量のExcelやWordファイルから特定の文字列を検索できることは非常に便利な一方で、検索中(マクロ実行中)はその他のExcel操作ができないことに対して課題を感じておりました。

    今回はそんな私個人が感じた課題から生まれたコードをご紹介いたします。

    以下でツールとして公開もしております。よろしければご利用ください。

    ※BOOTHアカウントを持っていない方は以下から直接ダウンロードください

    事前準備

    ・文字検索くんのダウンロード。以下のサイトからダウンロード可能です。

     
     

    SSzk

     
     
    普段は都内のIT企業に勤めるエンジニア その仕事の中で培った知識を活かして 「これ、地味だけどちょっと便利かも...?」 と思えるようなノウハウを発信していきます https://lit.link/chottobenri

    あなたへのおすすめ