概要
こちらのガイドでは、開発者がYellowfinでサポートされているプラグインやウィジェット、高度な関数などを記述するために必要なIDEのセットアップにおける重要なヒントや手順を紹介します。
IDEの設定
開発環境をセットアップする場合は、以下の手順を参照してください。
EE開発者のためにEclipseをダウンロードし、設定します。注意：YellowfinはEclipseを推奨しますが、お好みのツールを選択してください。
インストールにバンドルされていない場合は、Tomcatプラグインをインストールします。
開発に使用するYellowfinのバージョンをインストールします。注意：生産性向上させるために、最新バージョンの使用を推奨します。
WARファイルを取得するために、Yellowfinを起動します。
プラグインプロジェクトの作成
Javaプラグインに新規プロジェクトを作成するには、以下の手順に従います。
Eclipseを起動して、新規Javaプロジェクトを作成します。
プロジェクト名を入力し、使用するYellowfinのバージョンと互換性のあるJREを選択します。
「次へ」をクリックし、「デフォルト出力フォルダー」を「<プロジェクト名>/ROOT/WEB-INF/classes」に変更します。
「完了」をクリックします。
インストールしたYellowfinインスタンスからファイルをインポートします。
プロジェクトを右クリックし、「インポート」を選択します。
「ファイル・システム」を選択し、「次へ」をクリックします。
Yellowfinインストールディレクトリ内の「appserver/webapps/ROOT」に移動します。
「ROOT」を選択し、「Open」をクリックします。
ROOT配下すべてを選択し、「拡張」項目で「Create links in workspace（ワークスペース内にリンクを作成）」チェックボックスにチェックを入れます。
「完了」をクリックします。インストールしたYellowfinからのファイルが、こちらのプロジェクトにリンクされます。
プロジェクトの構成
プロジェクトを構成するには、以下の手順に従います。
プロジェクトを右クリックし、メニューから「ビルド・パス」＞「ビルド・パスの構成」を選択します。表示される画面で「ライブラリー」をクリックします。
「JARの追加」ボタンをクリックし、検索バーに「i4」と入力します。検索結果のプラグインプロジェクトから、「i4-core.jar」と「i4-mi.jar」を選択します。
「OK」をクリックして保存し、ビルド・パスの構成ウィンドウで「適用して閉じる」をクリックします。
srcフォルダ配下に、「META-INF」という名前で新規フォルダーが作成されます。そのフォルダ配下に「services」という名前の新規フォルダーを作成します。
開発するプラグインに応じて、servicesディレクトリにプラグインインターフェイスの完全修飾名を含むファイルを作成します。利用可能なすべてのプラグインオプションについては、以下の表を参照してください。
例えば、データトランスフォーメーションを作成している場合、ファイル名は「com.hof.mi.etl.step.ETLStep」になります。
上記のインターフェイスのひとつを実装して、プラグインclassを作成します。完全修飾class名は、インターフェイスに対応するサービスファイルに追加しなくてはいけません。
そのため、今回のデータトランスフォーメーションステップの例では、「META-INF/services/com.hof.etl.step.ETLStep」に完全修飾class名を追加します。
必要に応じて、この行の下にさらにトランスフォーメーションステップを追加することができます。
Tomcatの構成
次は、Tomcatの構成をセットアップします。
「設定」アイコンをクリックし、「Tomcat」項目へ移動します。
「Tomcatホーム」を「<Yellowfinインストールディレクトリ>/appserver」に、「コンテキスト・ディレクトリー」を「 <Yellowfinインストールディレクトリ>/appserver/conf/Catalina/localhost」に設定します。
左側のメニューでTomcat項目を展開し、「拡張」をクリックします。「Tomcat classpath」にプラグインプロジェクトを追加します。
必要に応じて、（左側のメニュー「JVMの設定」から）JVM設定を調整します。ヒント：こちらを使用することでTomcatの利用可能メモリーを増加させることができます。
「適用して閉じる」をクリックします。
ツールバーのアイコンを使用して、EclipseからTomcatを起動します。
Yellowfinでプラグインを利用できるようになります。
以下の場合を除き、コードへの変更は即座に反映されます。
メソッドのシグネチャが変更された場合
classに新しいメソッド/メンバーが追加された場合
プラグインパッケージに新しいclassが追加された場合
これらの場合、変更を反映するためにはTomcatを再起動しなくてはいけません。
プラグインのパッケージ化
プラグインの作成が完了したら、すべての依存関係を含み、これをパッケージ化します。このファイルの拡張子は、Yellowfinでサポートされている特定のファイル形式でなくてはいけません。
プロジェクト名を右クリックし、「エクスポート」をクリックし、「Java」項目から「JARファイル」を選択します。
エクスポートするパッケージのみを選択そ、それ以外は選択しないでください。
プロジェクトに依存するJARがある場合は、それらすべてとプラグインJARをひとつのディレクトリに格納し、ひとつのアーカイブに圧縮して拡張子に「yfp」と付けます。
デバッグ
EclipseのTomcatプラグインは、Tomcatをデバッグモードで起動するために、簡単にデバッグをすることができます。
ブレークポイントをコードに追加し、それらがすべて有効であることを確認します。