Page History

...

概要

こちらのガイドでは、開発者がYellowfinでサポートされているプラグインやウィジェット、高度な関数などを記述するために必要なIDEのセットアップにおける重要なヒントや手順を紹介します。

IDEの設定

開発環境をセットアップする場合は、以下の手順を参照してください。

EE開発者のためにEclipseをダウンロードし、設定します。注意：YellowfinはEclipseを推奨しますが、お好みのツールを選択してください。

インストールにバンドルされていない場合は、Tomcatプラグインをインストールします。

開発に使用するYellowfinのバージョンをインストールします。注意：生産性向上させるために、最新バージョンの使用を推奨します。

WARファイルを取得するために、Yellowfinを起動します。

概要

テキストエディターやJava コマンドラインツールを使用してYellowfin プラグインを開発することは可能ですが、単純なHello Worldプラグインよりも複雑なものを開発する場合にはストレスが溜まるでしょう。こちらのガイドでは、開発者がYellowfinでサポートされているプラグインやウィジェット、高度な関数などを記述するために必要なIDEのセットアップにおける、重要なヒントや手順を紹介します。

プラグインを開発し、デバッグするためのツール

プラグインを開発し、デバッグするためには、いくつかのツールやファイルが必要です。

• 開発システム上にJava 8 JDK（またはそれ以降）のインストール
• Yellowfin インストール
• Yellowfin フォルダーに出力するプロジェクト
• META-INF/services ファイル

これらを配置し、作成するには、以下の手順を参照してください。

開発システムにJava 8 JDK（またはそれ以降）をインストール

Java 8 JDKはこちらからダウンロードできます。

https://www.oracle.com/jp/java/technologies/javase/javase-jdk8-downloads.html

開発作業向けにYellowfinをインストール

開発するYellowfin プラグインと互換性のあるYellowfinをインストールします。WAR ファイルを<Yellowfin インストールディレクトリ>/appserver/webapps/ROOT/に抽出できるように、このインストールは少なくとも1回開始する必要があります。

最新バージョンのYellowfinを使用することを推奨します。

Yellowfin フォルダーに出力するプロジェクトを作成

<Yellowfin インストールディレクトリ>/appserver/webapps/ROOT/classesにコンパイルしたクラスを出力するプロジェクトを作成しなくてはいけません。

以下の手順に従い、Eclipse内でこれを実行します。

META-INF/services ファイルの作成

META-INF/services ファイルは、Yellowfinの起動時に特定のプラグインをロードするようにYellowfinに指示するために使用できます。

1. services ディレクトリに、プラグインインターフェースの完全修飾名を持つファイルを作成します。
2. 分析関数を作成するには、com.hof.mi.interfaces.AnalyticalFunctionファイルの作成を推奨します。
3. META-INF/services フォルダーにファイルを保存します。
   
   Image Added
   
   
4. フォルダーにファイルを保存します。
   
   Image Added
   
   

これでIDEのセットアップ準備は完了です。

IDEの設定

開発環境をセットアップする場合は、以下の手順を参照してください。今回は例としてTomcatを使用しました。これはYellowfinが推奨するIDEですが、お好みのIDEを使用しても、次の手順に大まかに対応できます。

1. EE開発者のためにEclipseをダウンロードし、設定します。
2. Eclipseのインストールにバンドルされていない場合は、Tomcatプラグインをインストールします。
3. 開発に使用するYellowfinのバージョンをインストールします。注意：生産性向上のために、最新バージョンの使用を推奨します。
4. WARファイルを取得するために、Yellowfinを起動します。

プラグインプロジェクトの作成

Javaプラグインに新規プロジェクトを作成するには、以下の手順に従います。

1. Eclipseを起動して、新規Javaプロジェクトを作成します。
   1. プロジェクト名を入力し、使用するYellowfinのバージョンと互換性のあるJREを選択します。

...

1. 1. 「次へ」をクリックし、「デフォルト出力フォルダー」を「<プロジェクト名>/ROOT/WEB-INF/

...

1. 1. classes」に変更します。
      
      Image Added
      
      
   2. 「完了」をクリックします。
2. インストールしたYellowfinインスタンスからファイルをインポートします。

   プロジェクトを右クリックし、「インポート」を選択します。

   ...

   1. 1. プロジェクトを右クリックし、「インポート」を選択します。
         
         Image Added
         
         
      2. 「ファイル・システム」を選択し、「次へ」をクリックします。
         
         Image Added
         
         
      3. Yellowfinインストールディレクトリ内の「appserver/webapps/

   ...

   「ROOT」を選択し、「Open」をクリックします。

   ROOT配下すべてを選択し、「拡張」項目で「Create links in workspace（ワークスペース内にリンクを作成）」チェックボックスにチェックを入れます。

   「完了」をクリックします。インストールしたYellowfinからのファイルが、こちらのプロジェクトにリンクされます。

    

   1. 1. ROOT」に移動します。「ROOT」を選択し、「Open」をクリックします。
         
         Image Added
         
         
      2. ROOT配下のすべてを選択し、「拡張」項目で「Create links in workspace（ワークスペース内にリンクを作成）」チェックボックスにチェックを入れます。
         
         Image Added
         
         
      3. 「完了」をクリックします。インストールしたYellowfinからのファイルが、こちらのプロジェクトにリンクされます。

   ...

   
   

   
   

   プロジェクトの構成

   プロジェクトを構成するには、以下の手順に従います。

   プロジェクトを右クリックし、メニューから「ビルド・パス」＞「ビルド・パスの構成」を選択します。表示される画面で「ライブラリー」をクリックします。

   
   

   ...

   1. プロジェクトを右クリックし、メニューから「ビルド・パス」＞「ビルド・パスの構成」を選択します。表示される画面で「ライブラリー」をクリックします。
      
      Image Added
      
      
   2. 「JARの追加」ボタンをクリックし、検索バーに「i4」と入力します。検索結果のプラグインプロジェクトから、「
   1. i4-core.

   ...

   「OK」をクリックして保存し、ビルド・パスの構成ウィンドウで「適用して閉じる」をクリックします。

   srcフォルダ配下に、「META-INF」という名前で新規フォルダーが作成されます。そのフォルダ配下に「services」という名前の新規フォルダーを作成します。

   開発するプラグインに応じて、servicesディレクトリに、プラグイン

    

    

    

   1. jar」と「i4-mi.jar」を選択します。
      
      Image Added
      
      
   2. 「OK」をクリックして保存し、ビルド・パスの構成ウィンドウで「適用して閉じる」をクリックします。
   3. srcフォルダ配下に、「META-INF」という名前で新規フォルダーを作成します。そのフォルダ配下に「services」という名前の新規フォルダーを作成します。
      
      Image Added
      
      

   4. 開発するプラグインに応じて、servicesディレクトリにプラグインインターフェイスの完全修飾名を含むファイルを作成します。利用可能なすべてのプラグインオプションについては、以下の表を参照してください。

      Yellowfinプラグイン	インターフェイス	説明
      トランスフォーメーションステップ	com.hof.mi.etl.step.ETLStep	データトランスフォーメーションモジュールで使用するステップ
      高度な関数	com.hof.mi.interfaces.AnalyticalFunction	レポートで使用する高度な関数
      データの型変換	com.hof.mi.interfaces.Converter	ビューレベル、データトランスフォーメーションモジュールで行うデータ型の変換
      カスタムフォーマッター	com.hof.mi.interfaces.CustomFormatter	レポートで使用するカスタムフォーマット
      データプロファイラー	com.hof.mi.interfaces.DataSuggestionPlugin	フィールドのデータのプロファイル。実装された提案が適用可能かどうかを判断する機能が含まれています。
      サードパーティ製コネクター	com.hof.mi.thirdparty.interfaces.AbstractDataSource	外部APIデータソースとの接続を確立するコネクター
      キャンバスウィジェット	com.hof.mi.widgetcanvas.interfaces.CanvasObjectTemplate	ダッシュボード、ストーリーボード、レポートデザインモジュールのキャンバスで使用するカスタムウィジェット
      ソースプラットフォーム	com.hof.sources.SourcePlatform	JDBC、JNDI、OLAPなど、ソースタイプを定義

      
      

      1. 例えば、データトランスフォーメーションを作成している場合、ファイル名は「com.hof.mi.etl.step.ETLStep」になります。
         
         Image Added
         
         
   5. 上記のインターフェイスのひとつを実装して、プラグインclassを作成します。インターフェイスに対応するサービスファイルに、完全修飾class名を追加しなくてはいけません。
      そのため、今回のデータトランスフォーメーションステップの例では、「META-INF/services/com.hof.etl.step.ETLStep」に完全修飾class名を追加します。
      
      Image Added
      
      必要に応じて、この行の下にさらにトランスフォーメーションステップを追加することができます。

   
   

   
   

   Tomcatの構成

   次は、Tomcatの構成をセットアップします。

   
   

   1. 「設定」アイコンをクリックし、「Tomcat」項目へ移動します。
      
      Image Added
      
      
   2. 「Tomcat ホーム」を「<Yellowfinインストールディレクトリ>/appserver」に、「コンテキスト・ディレクトリー」を「 <Yellowfinインストールディレクトリ>/appserver/conf/Catalina/localhost」に設定します。
   3. 左側のメニューでTomcat項目を展開し、「拡張」をクリックします。「Tomcat classpath」にプラグインプロジェクトを追加します。
      
      Image Added
      
      
   4. 必要に応じて、（左側のメニュー「JVMの設定」から）JVM設定を調整します。ヒント：こちらを使用することで、Tomcatで利用できるメモリーを増やすことができます。
   5. 左側のメニューで「ソース・パス」を選択し、プラグインプロジェクトを追加します。
      
      Image Added
      
      
   6. 「適用して閉じる」をクリックします。
   7. ツールバーのアイコンを使用して、EclipseからTomcatを起動します。
      
      Image Added
      
      
   8. Yellowfinでプラグインを利用できるようになります。
      
      Image Added

   
   

   Tip
   以下の場合を除き、コードへの変更は即座に反映されます。 メソッドのシグネチャが変更された場合 classに新しいメソッド/メンバーが追加された場合 プラグインパッケージに新しいclassが追加された場合 これらの場合は、変更を反映するためにTomcatを再起動しなくてはいけません。

   
   

   
   

   プラグインのパッケージ化

   Styleclass
   Class topLink
   ページトップ

   プラグインの作成が完了したら、すべての依存関係を含み、これをパッケージ化します。ファイルの拡張子は、Yellowfinでサポートされている特定のファイル形式でなくてはいけません。

   
   

   
   

   1. プロジェクト名を右クリックし、「エクスポート」をクリックし、「Java」項目から「JARファイル」を選択します。
   2. エクスポートするパッケージのみを選択し、それ以外は選択しないでください。
      
      Image Added
      
      
   3. プロジェクトに依存するJARがある場合は、それらすべてとプラグインJARをひとつのディレクトリに格納し、ひとつのアーカイブに圧縮して拡張子に「yfp」と付けます。

   
   

   
   

   デバッグ

   EclipseのTomcatプラグインは、Tomcatをデバッグモードで起動するため、簡単にデバッグをすることができます。ブレークポイントをコードに追加し、それらがすべて有効であることを確認します。

   
   

   
   

   Image Added 

   
   

   horizontalrule

   Styleclass
   Class topLink
   ページトップ