-****************************************************
+========================================================
Jaxcel
+ http://sourceforge.jp/projects/jaxcel/
+========================================================
- Copyright 2014 Hanei Management Co.,Ltd.
-****************************************************
+ Copyright 2014 Hanei Management Co.,Ltd.
+ http://www.hanei.co.jp/
+========================================================
-------------------------------------------
1. Jaxcel とは
-------------------------------------------
-Jaxcelとは、Excelにテンプレート式を書くことによって、
-動的にデータを埋め込み、Excel帳票を出力するライブラリです。
+Jaxcelとは、Excelにテンプレート式を書くことによって、動的にデータを埋め込み、Excel帳票を出力するライブラリです。
-Excelファイル自体をテンプレートとして用いることが可能な為、
-レイアウトの変更等も簡単に行えます。
+Excelファイル自体をテンプレートとして用いることが可能な為、レイアウトの変更等も簡単に行えます。
-------------------------------------------
2. 主な特徴
-------------------------------------------
-・Excelファイル自体にデータ埋め込み式を記述する為、
- 専用ツールの知識や習得が不要。
-・フォントサイズや罫線等の装飾は、テンプレートとなる
- Excelファイルで設定可能。
+・Excelファイル自体にデータ埋め込み式を記述する為、専用ツールの知識や習得が不要。
+
+・フォントサイズや罫線等の装飾は、テンプレートとなるExcelファイルで設定可能。
+
・チャートやピボットテーブルをテンプレートとして設定可能。
+
・複数シートが存在するブックに対応。
+
・マクロ埋め込みブックに対応。
-・Excel97-2003ブック形式(.xls)、2007以降のブック形式
- (.xlsx .xlsm)に対応。
-・リストや配列等の繰り返し出力(foreach)、データによる
- 出力・非出力(if)の制御構文が使用可能。
+
+・Excel97-2003ブック形式(.xls)、2007以降のブック形式(.xlsx .xlsm)に対応。
+
+・リストや配列等の繰り返し出力(foreach)、データによる出力・非出力(if)の制御構文が使用可能。
+
・制御構文は行/列全体のみでなく、矩形範囲での制御が可能。
+
・制御構文毎に、制御方向(行/列)の指定が可能。
-・制御構文内では埋め込みデータ以外に、下記の繰返し生成
- (foreach句使用時)、非出力(if句使用時)が可能。
+
+・制御構文内では埋め込みデータ以外に、下記の繰返し生成(foreach句使用時)、非出力(if句使用時)が可能。
・オートシェイプや画像等のオブジェクト ※1
・テーブル ※1
・結合セル
・オートフィルタ ※2
+
・数式の参照範囲も制御構文に連動。
-・埋め込みデータの解析にはApache Commons JEXLを使用し、
- 柔軟な埋め込み式の記述が可能。
+
+・埋め込みデータの解析にはApache Commons JEXLを使用し、柔軟な埋め込み式の記述が可能。
+
※1:Excel2007以降のブック形式(.xlsx .xlsm)のみ対応。
※2:if句による出力・非出力のみ対応。
-------------------------------------------
-3. セットアップ
+3. サンプルの実行
+-------------------------------------------
+配布ファイルのsample/binディレクトリ配下のバッチファイル、シェルスクリプトファイルの実行で、
+sample/resourcesディレクトリ配下の同名のExcelテンプレートファイルと、json形式のデータ
+ファイルを使用し、sample/outputディレクトリに出力結果のExcelファイルが生成されます。
+
+※:実行環境にjava1.7以上がインストールされていること。
+
+
+-------------------------------------------
+4. Java ソースサンプル
-------------------------------------------
-配布ファイルの jaxcel-x.xx.xx.jar をクラスパスを
-含めます。
+// Jaxcelレポートメーカーオブジェクトの生成
+ReportMaker jaxcel = new ReportMaker();
+
+// パラメータとなるMapブジェクトの生成・データの投入
+HashMap<String, Object> parameter = new HashMap<>();
+
+parameter.put("data1", "Hello");
+parameter.put("data2", "Jaxcel");
+
+// テンプレートExcelファイル、パラメータ、出力結果Excelファイルを指定。
+// result.xlsxファイルが生成される。
+jaxcel.makeReport(new File("template.xlsx"), parameter, new File("result.xlsx"));
+
+※:詳細は配布ファイルのJavadocを参照願います。
-------------------------------------------
-4. 依存ライブラリ
+4. セットアップ
-------------------------------------------
-Jexcelの使用には下記のライブラリが必要となります。
+配布ファイルの jaxcel-xx.xx.xx.jar をクラスパスを含めます。
+
+また、Jexcelの使用には下記のライブラリが必要となります。
・Apache POI 3.10
・poi-3.10-FINAL-20140208.jar
・poi-ooxml-3.10-FINAL-20140208.jar
- ・ooxml-schemas-1.1.jar ※1
+ ・ooxml-schemas-1.1.jar ※
・Apache POIは下記のライブラリが必要となります。(Apache POI 3.10-FINALの場合)
・commons-codec-1.5.jar
・dom4j-1.6.1.jar
・xmlbeans-2.3.0.jar
+
+ ※:Apache POIのダウンロードに含まれるpoi-ooxml-schemas-3.10-FINAL-20140208.jarではありません。
+ poi-ooxml-schemasのフルセットとなるooxml-schemasが必要です。
+
+ http://jakarta.apache.org/poi/
+ http://repo1.maven.org/maven2/org/apache/poi/ooxml-schemas/1.1/
+
・Apache Commons JEXL 2.1.1
・commons-jexl-2.1.1.jar
+
+ http://commons.apache.org/proper/commons-jexl/
+
・Apache Commons Lang 3.3
・commons-lang3-3.3.2.jar
+ http://commons.apache.org/proper/commons-lang/
+
+
・SLF4J 1.7
・slf4j-api-1.7.7.jar
-※1:Apache POIのダウンロードに含まれるpoi-ooxml-schemas-3.10-FINAL-20140208.jarではありません。
- poi-ooxml-schemasのフルセットとなるooxml-schemasが必要です。
+ http://www.slf4j.org/
+
+
+・JSONIC 1.3
+ ・jsonic-1.3.5.jar ※
+
+ ※サンプル等で使用するコンソールツール「MakeReportTool」使用時のみ必要です。
+
+ http://jsonic.sourceforge.jp/
-------------------------------------------
5. 免責事項
-------------------------------------------
-本ソフトウェアを使用したことによる一切の損害(一次的、二次的に関わらず)に対し、
-株式会社阪栄マネージメントは責任を負いません。各自の責任においてご使用下さい。
+本ソフトウエアを利用する、もしくは利用できないことにより発生した一切の損害(一次的、二次的に関わらず)
+および第三者からなされる請求について、株式会社阪栄マネージメントは一切責任を負いません。
+各自の責任においてご使用下さい。
-------------------------------------------