cikloneはTracをベースにしたエンタープライズ向けのWebサービスです。利用しているお客様の声から開発した各種プラグインをTrac/Trac Lightningでも利用できるように trac-hacks:ExcelDownloadPlugin として公開しました。
https://trac-hacks.org/wiki/ExcelDownloadPlugin
Excelダウンロードプラグインは、Tracの強力なレポート機能と連動した
- Excel形式でチケット出力
- チケット一覧に対応した履歴出力
することが出来ます。
インストール
それでは、Windows環境で良く利用されているTracLightningをつかってインストールをしましょう。
1. xlwt ライブラリのインストール
ExcelDownloadPlugin は Excel ファイルの生成に xlwt を使っています。まずはこれをインストールします。
c:\TracLight\bin>easy_install -Z xlwt
2. ファイルのダウンロード
https://trac-hacks.org/wiki/ExcelDownloadPlugin にアクセスして、Downloadから「here」をクリックして、exceldownloadplugin-rxxxxx.zip をダウンロードします。ダウンロードしたファイルを適当なディレクトリに展開します。
ここでは、
C:\temp\exceldownloadplugin\0.12
に展開。
3. easy_install でインストール
easy_install にソースディレクトリを指定してインストールを実行します。
c:\TracLight\bin>easy_install -Z C:\temp\exceldownloadplugin\0.12 Processing 0.12 Running setup.py -q bdist_egg --dist-dir C:\temp\exceldownloadplugin\0.12\egg-dist-tmp-nduefk zip_safe flag not set; analyzing archive contents... Adding exceldownloadplugin 0.12.0.1 to easy-install.pth file Installed c:\traclight\python\lib\site-packages\exceldownloadplugin-0.12.0.1-py2.6.egg Processing dependencies for exceldownloadplugin==0.12.0.1 Finished processing dependencies for exceldownloadplugin==0.12.0.1
4. trac.ini でプラグインを有効にする
trac.ini はプロジェクト毎に設定する必要があります。有効にしたいプロジェクトの conf/trac.ini でプラグインを有効にします。
# conf/trac.ini [components] tracexceldownload.* = enabled
実際に使ってみましょう
カスタムクエリやレポートからチケット一覧を表示します。一覧表示されたページの下部に、「Excel」「Excel(履歴含む)」が表示されます。あとは、クリックしてダウンロードしてください。
Excelダウンロードプラグイン
- Excel形式(xls)によるエクスポート機能
- チケットの履歴出力
- チケット単位(1チケット)で履歴を含めたエクスポート機能
が利用可能です。
ぜひ、あなたのプロジェクトでご活用下さい。
プラグインをダウンロードさせていただきました。手順に倣ってインストールしたのですが、tracexcepdownload.ticket.*が表示されずチケットの出力を行うことができません。translation.*は有効になっています。trac.iniに直接tracexcepdownload.ticket.*=enableと書いてみたりしたのですが状況は変わりませんでした。どのような原因が考えられますでしょうか。
プラグインのバージョンは0.12.0.1、TracLightningのバージョンは3.1.3です。
ありがとうございます。
ExcelDownloadPlugin では xlwt というライブラリを使用しています。このライブラリをインストールしていない状態だと仰るような状況になるようです。上記にある「xlwt ライブラリのインストール」に手順がありますので、こちらに沿って xlwt をインストールしてリトライしてみてください。
それでも解消しないようでしたら該当プロジェクトの log/trac.log に何か出力があると思いますので、そのログファイルを確認してみてください。
迅速な回答ありがとうございます。
xlwtをインストールして trac.iniを tracexcepdownload.*=enable のみの状態に戻したところ、全てのモジュールが表示されました。EXCEL出力もできました。
お手数をおかけいたしました。非常に助かりました。
この記事の手順のおかげで無事インストールでき、Excelへの出力もできました。
TracLightningのtracへのプラグイン導入は初めてだったので
詳しく書いてあって助かりました。