今開いているアクティブなブックに文字を書き込みしたいんだけど、
xlwingsを使って出来ないの?
1行で簡単にできますよ!
では今回は、
「xlwingsでアクティブブックを取得する方法」
をできるだけわかりやすく解説いたします。
【著者情報】
Python歴3年。
入社2年目の春に先輩が突然トンズラし、業務を半分肩代わりするハメに…。
今までの1.5倍の仕事をこなせるはずもなく、苦しむ毎日。
業務効率化を模索中にPythonと出合う。
業務とPythonの相性が良く、2倍以上の効率化を実現。現在も効率化を進行中。
xlwingsでアクティブブックを取得するには
「books.active」を使います。まずはサンプルコードをどうぞ。
サンプルコード
ひとまず全コードを網羅します。解説は後ほど行います。
import xlwings
workbook = xlwings.books.active
workbook = xlwings.books.active
事前準備
- xlwingsのインストール
エクセルファイルを実際に操作するには、「xlwings」のインストールが必要になります。
xlwingsのインストール方法
xlwingsを初めて使用する場合は、下記コードを入力・実行して、インストールしてください。
pip install xlwings
※xlwingsを使用したことがある場合は、このインストール作業は不要です。
インストール方法詳細やインストールができない場合の対処法、
基本的な使い方などは下記記事をご参考ください。
解説
※わかりやすさを重視しております。厳密には解釈が異なる場合がありますことをご了承ください。
インポート
import xlwings
「xlwings」を使用するには「インポート」が必要です。
まずは上記一文を記述して、インポートを完了させましょう。
アクティブブックの取得
workbook = xlwings.books.active
上記一文にて、アクティブブックを取得することができます。
現在開いているブックの中でアクティブなブックを取得する指令です。
「ブックを開く」という指令ではありませんので、ご注意ください。
<テンプレ>
【 変数 = xlwings.books.active 】
左辺の「変数」について、今回はわかりやすく「workbook」という名前にしましたが、何でも構いません。
しかしながら、一部使えない名前があります。
詳細は下記記事をご参考ください。
アクティブブックの取得だけでは変化が乏しいので、
取得したアクティブブックに文字を書き込んでみましょう
import xlwings
workbook = xlwings.books.active
worksheet = workbook.sheets['Sheet3']
worksheet['A1'].value = 'utatane'
上記は以下のようなコードです。
3行目でアクティブブックを取得
4行目でブック内の「Sheet3」を取得
5行目でシート内のA1に「utatane」と書き込む
▼実行前
実行してみましょう。
文字「utatane」が書き込みされました。
うまく動作しない時
エラーが出る
‘NoneType’ object has no attribute ‘books’
エクセルブックやエクセルファイルを開いていないのに、ブックやファイルを取得しようとした場合に出るエラーです。
事前に対象のファイルを開くように指定するなど、構文を見直してみましょう。
その他のエラー
その他のエラーが出た場合は、エラー文をコピーしてNETで検索してみましょう。
空のブックが生成される・残る
作業環境によっては「空のブック(Book1)」が生成されたり、残ってしまう場合があります。
このまま作業を続けると、空のブックがどんどん増えていく可能性があるため対処が必要です。
対処法としましては、何か別のエクセルを開いたままにしておきましょう。
そうすることで、空のブックは生成されません。
作業を始める前に、適当なエクセルファイルをひとつ開いておくことをおすすめします。
最後に
xlwingsでアクティブブックを取得する方法を解説いたしました。
当ブログでは、xlwingsやopenpyxlなど、Pythonに関する情報を配信しております。
この記事がわかりやすいと感じた方は、他の記事も読んでいってください。
挫折せずにPythonを独学で学習する方法は特におすすめです。
最後までお読みいただき、ありがとうございました。がんばってください!