PDF 出力向け InterSystems IRIS の構成

Java 仮想マシン (JVM) がまだインストールされていない場合は、このツールをダウンロードしてシステムにインストールします。JVM は、このバージョンの InterSystems IRIS でサポートされる Java ランタイム環境 (JRE) および Java Developers Kit (JDK) に含まれているため、これらのツールのいずれかを使用している場合、JVM は既にインストールされています。あるいは、いずれかのサポート対象バージョンの OpenJDK をインストールして使用することもできます。

InterSystems IRIS が Java を検出できるようにするために、JAVA_HOME 環境変数を定義して、この環境変数に、Java をインストールした場所を設定する必要があります。JAVA_HOME については、Java ドキュメントを参照してください。

ユーザ特権が正しく設定されていることを確認する必要があります。PDF 出力を生成するには、ユーザは、%System_CallOut:USE 特権を持つユーザ・アカウントにログインしている必要があります。

以下の Apache FOP Web サイトの資料で説明されているように、組み込みの FOP 用にカスタム構成ファイルを作成できます。

http://xmlgraphics.apache.org/fopOpens in a new tab

カスタム構成ファイルを使用するために、InterSystems IRIS から FOP を呼び出す場合は、グローバル ^%SYS("zenreport","transformerconfig") を、この構成ファイルへのパスに設定します。FOP にフォントを追加するには、構成ファイルが重要です。まず、フォント・メトリックを作成し、これを FOP に登録する必要があります。この手順は、Apache FOP Web サイトで説明されています。

FOP 構成ファイル fop.xconf を変更すると、InterSystems IRIS は、そのファイルの上書きコピーを実行しません。InterSystems IRIS ディストリビューションに付属の FOP 構成ファイル名は fop.xconf_dist です。fop.xconf ファイルが何らかの理由で破損した場合には (パラメータ USEINSTALLEDFOP が 0 に設定されていない状態で RenderX を実行し、ファイルが削除された場合など)、fop.xconf_dist を fop.xconf にコピーすることで、InterSystems IRIS と共に配布されたものと同じ状態にファイルを戻すことができます。

XSL-FO を PDF としてレンダリングするツールをインストールします。次の 2 種類のツールが使用できます。

• Apache のオープン・ソース・プロジェクトである FOP。これは以下の Web サイトからダウンロードできます。

  http://xmlgraphics.apache.org/fopOpens in a new tab

  インストールするには、このキットからファイルを解凍します。

• RenderX の提供する XEP 製品。無料の試用版をダウンロードするか、XEP 製品を購入できます。試用版の場合、各出力ページには RenderX の透かしが残ります。詳細は、以下の Web サイトを参照してください。

  http://www.renderx.com/tools/xep.htmlOpens in a new tab

  インストール方法については、キットに付属の指示に従ってください。

• RenderX XEP と連動するように InterSystems IRIS を構成するには、%JAVA_HOME% 環境変数と %XEP_HOME% 環境変数を定義する必要があります。 %JAVA_HOME% については、Java ドキュメントで説明します。 %XEP_HOME% は、XEP をインストールした場所を指定する環境変数です。

レンダリング・ツールを起動するコマンド・ファイルのフルパス名を使用して、InterSystems IRIS を構成します。Windows または UNIX® の XEP または FOP については、手順 1 の説明に従ってツールをインストールしていると、このコマンド・ファイルがシステム上のツールのインストール・ディレクトリの下 (例えば、Windows の場合は C:\fop-0.95\fop.bat、UNIX® の場合は /fop-0.95/fop) に存在することでわかります。

この構成を実行するには、[システム管理]→[構成]→[レポート・サーバ]→[設定] に移動して、以下の変更を加えます。

• [PDF生成に使用されるパスとファイル名:] — 実行可能ファイルのパスを入力します。[参照] をクリックし、コマンド・ファイルを見つけて選択します。

• [Pdfprint の Foxit / Adobe のパス:] — このフィールドは無視してください。

• [PDF レンダリング・エンジンの構成ファイル:] — このフィールドはオプションです。[使用] または [なし] を選択します。[使用] を選択する場合は、FOP 構成ファイルのパスを入力します。FOP 構成ファイルを指定しない場合、FOP レンダリング・ツールは、組み込みの FOP に付属の構成ファイルを使用します。

  XEP レンダリング・ツールを使用している場合は、このフィールドにパスを入力しないでください。XEP レンダリング・ツールは、ここで指定されているファイルを長さ 0 に切り捨てます。[参照] をクリックし、構成ファイルを見つけて選択します。

  ツール・プロバイダの Web サイトで説明されているとおり、カスタム構成ファイルを作成できます。XEP にカスタム構成ファイルを指定するには、XEP のマニュアルに従う必要があります。

• [既定の HotJVM レンダリング・サーバ・ポート] — HotJVM レンダリング・サーバを実行しているポート番号を入力します。

• [検証する] — レンダリング・ツールが正しく構成されているかどうかをテストするには、このボタンをクリックします。

または、ターミナルを起動し、対応するグローバル・ノードを設定することもできます。例えば、レンダリング・ツールの実行可能ファイルを設定するには、以下を入力します。

Set ^%SYS("zenreport","transformerpath")="/Applications/fop-0.95/fop.bat"

同様に、構成ファイルを設定するには、^%SYS("zenreport","transformerconfig") を構成ファイルのパスに設定します。

既定の動作では、管理ポータルの [レポート設定] ページで代替レンダリング・ツールを設定していない限り、インストールされている FOP が使用されます。