概要
Yellowfinでは、eclipseのようなBIRT XMLレポートエディターで作成したレポートを使用することができます。Yellowfinにこれらをロードし、セキュリティやマルチキャストなどのレポート管理環境を利用することが可能です。
BIRTレポートの利点
BIRTレポートは以下のような場合に有効です:
- 請求書のような製品ごとに分類された形式のレポートを作成する場合。
- Yellowfinでは作成できない特殊なレポートレイアウトを作成する場合。
BIRTレポートの作成
- eclipseなどのツールでBIRTレポートのXMLファイルを作成します。
- レポートの初期設定で、作成方法に「BIRTレポート」を選択します。
- そのレポートを作成したデータベースを選択します。
- 「→」をクリックして次のステップに進みます。
- BIRTレポートページで、作成したレポートファイルをロードします。
- 将来の参照のため、このステージでファイルにコメントを付加することができます。
- 「レポートのオプション」でレポートのプロパティに関する設定が行えます。
- 「ファイルを選択」ボタンをクリックして目的のXMLファイルを指定してください。
- 「ここをクリックし、確認」をクリックします。
- ファイルの定義が表示されます。これらの情報はあとでレポートを編集する際に役立ちます。
- XMLファイルが画像へのリンクを含んでいる場合、この画面でその画像を別ファイルとしてロードしてください。
- 「ファイルを選択」ボタンクリックして目的の画像ファイルを指定します。画像は各々別々にロードされます。
- XMLファイルを編集、あるいは交換したい場合には、「ファイルを上書き」というチェックボックスをオンにして新しいファイルを指定します。
BIRTレポートの有効化
BIRT engineは、Yellowfinのインストールに含まれていないため、これを有効にする必要があります。
- 使用しているYellowfinに、どのバージョンのBIRTアダプターがインストールされているか確認します。
- 「Yellowfin/appserver/webapps/ROOT/WEB-INF/lib」フォルダーへ移動し、「yfbirtxxx.jar」ファイルを探します。
- バージョンは、ファイル名の桁で表示されていることに注意してください。(Yellowfin 7.3Plusには、バージョン4.3.1 のBIRTアダプターがインストールされています。それより以前のアダプターは、「development」フォルダーに格納されています。Yellowfinを以前のバージョンのBIRT engineで実行したい場合は、yfbirt431.jarをdevelopmentフォルダー内の対応するアダプターに変更してください。)
- BIRTのウェブサイト(http://download.eclipse.org/birt/downloads/ )から「BIRT Runtime(Report Engineとも言います)」をダウンロードします。ファイル名は「birt-runtime-xxx.zip」です。YellowfinのBIRTアダプター(yfbirtxxx.jar)と対応するバージョンをダウンロードしてください。例:Yellowfin 7.3Plusの場合、ダウンロードするのは「BIRT Runtime Engine 4.3.1」です。
http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/R-R1-4_3_1-201309181142/birt-runtime-4_3_1.zip - Yellowfinサーバーの任意のディレクトリで、このファイルを解凍します。これにより、「birt-runtime-xxx」というサブディレクトリが作成されます。
- 「Yellowfin/appserver/conf/catalina.properties」ファイルを編集します。「shared.loader property」の定義を探し、「BIRT Report Engine」の「lib」フォルダーにパスを追加します。
shared.loader= "C:/BIRT/birt-runtime-4_3_1/ReportEngine/lib/*.jar" オリジナルのYellowfinインストールが、バージョン4.0、またはそれ以前の場合は、以下のリンクをクリックして、追加の手順を実行します。
- Yellowfinを再起動します。起動時に、以下のようなログが出力されます。
BIRT Report Engineは、追加のメモリを必要とする可能性があることに注意をしてください。JVMメモリを追加する方法については、以下のフォーラムの投稿を参照してください。
https://community.yellowfinbi.com/knowledge-base/article/what-is-jvm-max-memory-and-why-should-i-care
BIRT Report Engineの読み込みには、かなりの時間(10分以上)を要する場合があります。