エクセルのためのPython (Japanese Edition), 2nd Edition

第13章 xlwings Lite を使ったカスタム 関数

この作品はAIを使って翻訳されている。ご意見、ご感想をお待ちしている：[e-mail]

カスタム関数とは、SUMやAVERAGE といった組み込み関数と同じように、Excel のセル内で使用する Python 関数のことだ。聞き覚えがあると思うかもしれないが、それは第11章ですでにカスタム関数を紹介しているからだ。違いは、それらは Windows でのみ互換性があったのに対し、xlwings Lite を使ったカスタム関数は Windows、macOS、そして Web 版の Excel でも動作する点だ。

この章では、まずシンプルな「Hello World」関数から始め、その後、データ変換のための型ヒントや、カスタム関数を整理するための名前空間の使い方など、いくつかの現代的な工夫を紹介する。その後、3つのプロジェクトに取り組んでいく。

• AI関数の作成。環境変数を使って機密性の高い資格情報を扱う方法を学ぶ

• Hugging Faceの機械学習モデルの使用：xlwings Lite（前章参照）を駆動する制限付きPython環境「Pyodide」でどこまでできるかを実演する

• Open-Meteoの気象データを使った作業。ここでは日付やプロットの扱い方を学ぶ

第11章で学んだことのほとんどはxlwings Liteのカスタム関数にも当てはまるが、xlwings Liteでは、プロットをセル内の画像として返すといった、Excelの最新機能を活用している。しかし、先走らずに、まずは基本から始めよう！

最新のカスタム関数

このセクションでは、デコレータの代わりに型ヒントを使用して、Excelの値をDataFrameやその他のPythonデータ型に変換する方法を説明する。また、エラーの処理方法や、関数を名前空間に整理する方法についても見ていく。だが、まずは基本から始めよう。おなじみのHello World関数から始めよう。

Hello World

「Hello World」関数を作成するには、新しいワークブックを作成し、Excelリボンの[ホーム]タブにあるボタンをクリックしてxlwings Liteを起動する。前章と同様に、エディタ内のデフォルトのサンプルコードをCtrl+A（Windows）またはCommand-A（macOS）で選択し、削除する。次に、以下のコードを記述する：

from xlwings import arg, func

@func
def hello(name):
    return f"Hello {name}!"

main.pyファイルのタブに緑色のチェックマークが表示されるまで待つ。これはファイルが保存されたことを示す。次に、関数をテストするためにセル A1 を選択し、次の数式を入力する =HELLO("xlwings")と入力し、Enterキーを押す。期待通り、数式は「Hello xlwings!」と評価される。

カスタム関数のトラブルシューティング

#NAME?呼び出そうとした際にHELLOエラーが発生する場合は、関数が正しく登録されていない。これは時折発生するが、xlwings Liteのトラブルシューティングドキュメントで説明されているように、Officeのキャッシュをクリアすることで通常は解決できる。それでも解決しない場合、またはアドインストアから他のアドインをインストールしている場合は、まずすべてのアドインをアンインストールしてから、再度インストールし直してほしい。 ...