デザイナプラグイン管理

1.バージョン

2.応用シーン

ユーザが特定の機能を実現するためにプラグインを使用する場合、デザイナ内でプラグインをインストールして利用できます。

注意1：サーバにおけるプラグインのインストールについては、「サーバプラグイン管理」を参照してください。

注意2：デザイナがサーバにリモート接続している場合、サーバ側でプラグインの機能を利用するには、サーバ側とデザイナ側の両方に該当プラグインをインストールし、かつプラグインのバージョンを一致させる必要があります。これにより正常に使用可能となります。

3.機能概要

FineReportデザイナで[サーバ]-[プラグイン管理]をクリックすると、以下の画面が表示されます：

プラグイン管理：ローカルファイルでプラグインをインストール機能がサポートされています。また、インストール済みのプラグイン情報や多様なプラグイン管理操作を提供します。これには、削除、更新、無効化/有効化が含まれます。

プラグイン管理では、以下の機能がサポートされています：

1）ホットデプロイに対応しており、インストール、削除、更新、無効化、有効化の操作で再起動は不要です。

2）Licenseの設定も再起動不要で行えます。

4.利用前提

デザイナでプラグインをインストールおよび管理する際は、デザイナの[作業ディレクトリ切り替え]を行う必要があります。以下の図を参照してください：

注意: リモートサーバに接続する場合、サーバメニュー内に[プラグイン管理]オプションが表示されません。そのため、デザイナでプラグインのインストールや管理操作を行うことはできません。

弊社の営業担当者からプラグインファイルを取得し、インストールを行ってください。

本章では、「バックグラウンドシングルサインオンプラグイン」を例に、デザイナでのプラグインインストール手順を説明します。

注意1: デザイナでプラグインをインストールする際は、まず[作業ディレクトリ]をローカルディレクトリに切り替えてください。切り替えを行わない場合、サーバメニュー内に[プラグイン管理]オプションが表示されません。詳細は本文第1章第4節をご参照ください。

注意2: FineReport 11.0では、プラグインのホットデプロイがサポートされています。インストール後、再起動せずにすぐに使用できます。

注意3: プラグインが正常にインストールされると、プラグインファイルは %FR_HOME%\webapps\webroot\WEB-INF\plugins フォルダーに保存されます。

1.ローカルインストール

弊社の営業担当者からプラグインファイルを取得し、ローカルインストールの方法でプラグインをインストールします。

1）営業担当者から受け取った圧縮ファイルは、以下の図のようなります：

2）FineReport デザイナで[サーバ]-[プラグイン管理]をクリックし、[ローカルファイルからインストール]ボタンをクリックします。ダウンロード済み（または準備済み）のプラグインの.zip圧縮ファイルを選択してください。

プラグインが正常にインストールされると、インストール成功のポップアップが表示されます。[確定]をクリックします。以下の図をご参照ください：

注意: 上記で取得した圧縮ファイルを解凍せず、そのままインストールしてください。

FineReport デザイナで[サーバ]-[プラグイン管理]-をクリックすると、[プラグイン管理]ページでインストール済みのプラグイン情報がリスト形式で表示され、管理操作が可能です。

• プラグイン説明には、プラグイン名、プラグインバージョン、サポートする最も低い帳票バージョン、開発者、プラグイン機能説明などの情報が含まれます。

• プラグインの操作として、検索、更新、無効化/有効化、削除などの機能が利用できます。以下の図をご参照ください：

1.プラグインの更新

FineReport デザイナで[サーバ]-[プラグイン管理]をクリックし、[更新]ボタンをクリックします。更新が完了すると、「プラグインが更新されました」というポップアップが表示されます。[確定]をクリックします。以下の図をご参照ください：

2.プラグインの無効化/有効化

FineReport デザイナで[サーバ]-[プラグイン管理]をクリックし、[無効化/有効化]ボタンをクリックします。操作が完了すると、「XXXプラグインが無効化/有効化されました」というポップアップが表示されます。[確定]をクリックします。以下の図をご参照ください：

3.プラグインの削除

FineReport デザイナで[サーバ]-[プラグイン管理]をクリックし、[削除]ボタンをクリックします。表示されるポップアップで[OK]ボタンをクリックすると、削除が完了します。以下の図をご参照ください：

1.プラグイン機能が使用できない場合

問題の説明：

FineReportポータル（サーバ側）でプラグインをインストールした後、デザイナ側で使用できない場合があります。

原因分析：

デザイナとサーバの両方で使用されるプラグインについては、サーバ側とデザイナ側の両方にプラグインをインストールする必要があります：

1）サーバ側にプラグインがインストールされていても、デザイナ側にプラグインがインストールされていない場合、プラグインは有効になりません。この場合、ローカルに切り替えてプラグインをインストールする必要があります。

2）サーバ側とデザイナ側の両方にプラグインがインストールされている場合でも、サーバ側でのプラグインのダウンロード、削除、無効化の操作は即時反映されず、数分待つ必要があります。

3）サーバ側とデザイナ側の両方にプラグインがインストールされている場合、デザイナ側でローカルに切り替えてプラグインを無効化しても、リモート接続時のサーバ側でのプラグインの使用には影響しません。

4）サーバ側とデザイナ側の両方にプラグインがインストールされている場合、サーバ側のプラグインが有効にならない場合は、サーバ側とデザイナ側のプラグインのバージョンが一致しているか確認してください。一致していれば正常に使用できます。

2.プラグインの自動更新機能の無効化

「ダウンタイム処理」や「クラウド運用保守」などのプラグインをインストールしている場合、プロジェクトの起動時や起動後しばらくしてから、または毎晩23時に自動的にプラグインのバージョンを検出し、更新します。

スーパー管理者は「fine_conf_entity可視化設定プラグイン」を使用して、上記のプラグインの自動更新を無効にすることができます。サーバを再起動すると設定が有効になります。

注意：FineDBデータベースのテーブルフィールド値の変更方法については、「fine_conf_entity可視化設定プラグイン」を参照してください。