オープンソースでExcelレポートプログラミング
•
0 likes•2,365 views
.NETラボ勉強会2018年4月のセッション資料です。 プログラムでレポートを出力する場合がありますが、出力後に編集しやすいExcelを選択されるケースがあります。 そんなときに役に立つオープンソースの「NPOI」を使ったプログラミング方法をご紹介しました。
Recommended
More Related Content
What's hot
What's hot (20)
Similar to オープンソースでExcelレポートプログラミング
Similar to オープンソースでExcelレポートプログラミング (20)
More from Sho Okada
More from Sho Okada (16)
オープンソースでExcelレポートプログラミング
- 8. ちなみに「NPOI」は、 Javaの「Apatch POI」という オープンソースプロジェクトの .NETバージョンです。 ちなみにPOIは 「Poor Obfuscation Implementation (質の悪い難読な実装)」の略らしい
- 9. 開発要件 ライセンスはApache2.0 ▪ VS2017 VS2010 .NET Framework 4.0以降 ▪ VS2005 VS2008 .NET Framework 2.0 SP1 ▪ VS2003 .NET Framework 1.1 (version 1.2.1) ▪ Mono 依存コンポーネント ▪ SharpZipLib ←ライセンスが異なるので注意 Visual studioなら、NuGet Package Managerから入手できます。 https://www.nuget.org/packages/NPOI/ 手動ダウンロードやソースのダウンロードはこちらから https://github.com/tonyqus/npoi
- 12. 開発要件 ライセンスはApache2.0 ▪ .Net Standard 2.0以上 Linux環境での必要コンポーネント ▪ Libgdiplus NuGet Packageコマンド Install-Package DotNetCore.NPOI 手動ダウンロードやソースのダウンロードはこちらから https://github.com/dotnetcore/NPOI
- 15. Excelの前提知識 Excelの形式は2種類ある どっちも動作可能だけど可能ならxlsx形式を推奨 .xlsx拡張子 ▪ Office Open XML形式 (OOXML) フォーマット ▪ →オープンな規格で、各種XMLファイルを組み合わせてZIP圧縮されてい る。 .xls拡張子 ▪ Microsoft OLE2複合ドキュメント形式(OLE2)フォーマット ▪ →バイナリ形式で独自仕様。
- 17. 開発準備 適当なExcel（xlsxファイル）を作っておきます。 名前を「testTemplate.xlsx」にして保存し、実行ファイルの下または、任意 の場所に移動します。 NPOIとIOの「using ディレクティブ」をコードの先頭に追加します。 using NPOI.SS.UserModel; using NPOI.XSSF.UserModel; using System.IO; 準備ができたら、次のコードを張り付けて呼び出します。
- 18. サンプルコード private void CreateExcel() { { string filename = "testTemplate.xlsx"; XSSFWorkbook workbook = new XSSFWorkbook(filename); ISheet sheet1 = workbook.GetSheetAt(0); sheet1.CreateRow(0).CreateCell(0).SetCellValue("くだもの販売数"); sheet1.CreateRow(1).CreateCell(0).SetCellValue("商品名"); sheet1.GetRow(1).CreateCell(1).SetCellValue("個数"); sheet1.GetRow(1).CreateCell(2).SetCellValue("価格"); sheet1.GetRow(1).CreateCell(3).SetCellValue("消費税"); int x = 1; for (int y = 2; y <= 15; y++) { IRow row = sheet1.CreateRow(y); row.CreateCell(0).SetCellValue("りんご"); row.CreateCell(1).SetCellValue(x); row.CreateCell(2).SetCellValue(x * 10); row.CreateCell(3).SetCellValue(x * 10 * 0.08); x = x + 2; } using (var f = File.Create(@"testReport.xlsx")) { workbook.Write(f); } } } テンプレートのExcel取得とシートの取得 見出し部分の作成 データ行の書き込み Excelの書き込み
- 20. あると便利な共通関数 ▪ //既にあるかないかわからないので行を判断して取得する ▪ private IRow GetRow(ISheet sheet, int rowIndex) ▪ { ▪ if (sheet.GetRow(rowIndex) == null) { ▪ return sheet.CreateRow(rowIndex); ▪ } else { ▪ return sheet.GetRow(rowIndex); ▪ } ▪ } ▪ //既にあるかないかわからないので列を判断してセットする ▪ private void WriteCell<T>(T value,IRow row, int colIndex) { ▪ if (row.GetCell(colIndex) == null) { ▪ row.CreateCell(colIndex).SetCellValue((dynamic)value); ▪ } else { ▪ row.GetCell(colIndex).SetCellValue((dynamic)value); ▪ } ▪ }
- 21. あると便利な共通関数 //型を判定してCellの値を取得する ▪ private dynamic ReadCell(ICell cell) ▪ { ▪ switch (cell.CellType) ▪ { ▪ case CellType.String : ▪ return cell.StringCellValue; ▪ case CellType.Numeric : ▪ //日付型もこっちに入ってくる ▪ if (DateUtil.IsCellDateFormatted(cell)) { ▪ return cell.DateCellValue; ▪ } else { ▪ return cell.NumericCellValue; ▪ } ▪ case CellType.Boolean: ▪ return cell.BooleanCellValue; ▪ case CellType.Formula: ▪ return cell.CellFormula; ▪ default : ▪ return string.Empty; ▪ } ▪ }
- 22. 適用したサンプルコード private void CreateExcel() { { string filename = "testTemplate.xlsx"; ▪ XSSFWorkbook workbook = new XSSFWorkbook(filename); ▪ ISheet sheet1 = workbook.GetSheetAt(1); ▪ sheet1.CreateRow(0).CreateCell(0).SetCellValue("くだもの販売数"); ▪ GetRow(sheet1, 1).CreateCell(0).SetCellValue("商品名"); ▪ WriteCell( GetRow(sheet1, 1), 1, "個数"); ▪ WriteCell( GetRow(sheet1, 1), 2, "価格"); ▪ WriteCell( GetRow(sheet1, 1), 3, "消費税"); ▪ int x = 1; ▪ for (int y = 2; y <= 15; y++) ▪ { ▪ IRow row = GetRow(sheet1, y); ▪ WriteCell(row, 0,"みかん"); ▪ WriteCell(row, 1, x); ▪ WriteCell(row, 2, x * 12); ▪ WriteCell(row, 3, x * 12 * 0.08); ▪ x = x + 2; ▪ } ▪ using (var f = File.Create(@"testReport.xlsx")) ▪ { ▪ workbook.Write(f); ▪ } } } テンプレートのExcel取得とシートの取得 見出し部分の作成 データ行の書き込み Excelの書き込み
- 24. ちょっと複雑な帳票作成の説明コース • SQLがバリバリ得意な人Aコース • プログラムがバリバリ得意な人Bコース • Excel関数がバリバリ得意な人 Cコース ※ネ申エクセルのテンプレートを作られて しまった方もこちら
- 26. ▪Linq to SQLでデータを持ってきて、ひたすらデー タ結合をプログラム側で頑張る。 ▪やっぱりEntity Framework推奨 Bコース こちらも普通にやって作成できますので割愛
- 27. ▪Excel関数を駆使してテンプレートを充実させる。 ▪データはシンプルなものを複数シートに格納。 Cコース 今回はこちらの裏技を重点的に説明します！ ごめんなさい、結局1コースしか準備してません
- 31. Excel出力方法で楽するために考えたこと ▪ 別シートにデータが丸見えで恥ずかしい。 ▪ データいじられると困る。 //シートを非表示にする workbook.SetSheetHidden(0, SheetState.Hidden); //シートの再表示をできなくする workbook.SetSheetHidden(0, SheetState.VeryHidden); //触られたくないデータはシートにパスワード設定 sheet.ProtectSheet("password");
- 32. Excel出力方法で楽するために考えたこと ▪ 空行要らないとムチャ振りされたので、行削除する。 →結果：行削除関数が未対応だったので、セル単位で削除した。 めちゃめちゃ遅い！データが多いとすごく時間がかかる。 ▪ いっそ行も非表示で対応！ //最大行数を設定して、要らない行は非表示にする。 sheet.GroupRow([データ件数+1], sheet.LastRowNum); sheet.SetRowGroupCollapsed([データ件数+1], true);
- 33. 仕事で起こったNPOI事例 ▪ まだ入力されていないセルはnullになるので、CreateCellとGetCellを使い分けな いとエラーになる。 ▪ POIのサンプルみても一応参考にはなるが、まだ対応していない関数がたっぷり あるのでそのまま利用できない。 ▪ スタイルはコードで書くと処理が遅くて後悔する。テンプレートに用意しておく かシートコピーで使いまわすのを推奨。 ▪ ウインドウ枠の固定をすると、壊れているとExcelで修復警告が出る場合と壊れ ない場合がある。 過去のバージョンのトラブル ▪ 日本語入力してルビが入ってしまい即壊れているとExcelで修復警告が出た。 ▪ 条件付き書式のデータバーを追加したら、壊れているとExcelで修復警告が出た 。 ▪ テンプレートを2003形式から2007形式にしたらグラフでエラーが出るようにな った。
- 34. Excelレポートのメリットまとめ ▪ ファイル容量は大きくなるけど、コード量が少なくて初心者でもなんと か対応できる。 ▪ Excelレポートは関数使えるからテンプレートを修正するだけで対応でき るようになった。 ▪ Excel使いの人にはExcelのまま提供されるので喜ばれた。 （オートフィルター設定したり、自力でグラフ作成したりとか） ▪ また1段階上のExcel関数使いになれた。（気がする・・・） ▪ オープンソースなら無料だし、最悪元ソース修正でとりあえず何とかな る。（クラウド環境でも安心して導入できる）